前言¶
在 DSH 里用模型改数控程序时，难点往往不在「会不会写 G-code」，而在上下文怎么对齐：工作区里散落 .nc、.gcode，对话里只有片段文件名，模型很难对准具体行。纯文本编辑器也看不出刀路是否合理。下面介绍社区客户端插件 dsh-qizhoucnc-cam（维护者 DarbeChan，实现方为成都起舟机械科技有限公司），它在 DSH 右侧提供 NC 三维刀路预览、全屏编辑，并支持把选中行引用进对话框。
这是什么¶
dsh-qizhoucnc-cam 是面向 DeepSeek Harness 的 CNC 程序（NC / G-code）可视化与编辑插件。打开 NC 文件后，右侧面板可解析并绘制三维刀路；也可进入大界面编辑器修改、保存，并把选中代码一键引用到 DSH 输入框。插件在 SkillHub 目录中归类为客户端；源码见 GitHub，package.json 版本为 1.0.0，许可证 MIT。README 注明：仅供研究学习使用，不提供商用保证。
核心功能¶
以下能力均来自仓库 README 与 package.json 描述。
NC 识别与三维刀路¶
自动识别 .nc、.cnc、.gcode，解析 G-code，在面板内用三维 SVG 投影绘制刀路（切割段与快速移动区分），带 XYZ 轴与网格。
视角与交互¶
支持俯视、前、右、后、左、仰及等轴视角一键切换；可拖拽旋转，Shift/右键平移，滚轮缩放，并重置适配。
大界面编辑器¶
点击文件行的编辑入口进入全宽 NC 预览与编辑，支持 ⌘/Ctrl+S 保存；保存后自动重新解析并刷新刀路。
引用到对话框¶
在编辑器中选中若干行，使用「引用到对话框」，可将「文件 + 行号 + 代码」写入 DSH 输入框，便于模型定位程序段。
工作区与 STEP¶
自动扫描当前会话工作区，也可通过「选择路径」手动添加文件夹；列表展示 NC 与 STEP（.step / .stp）。对 STEP 模型，可通过 FreeCAD CAM 生成 G-code 轮廓刀路。另支持在系统文件管理器中打开文件所在位置。
安装与启用¶
README 未给出 dsh plugin add github:... 一类一键命令，仅说明安装方式如下。
将插件目录作为 DSH 插件安装，可采用本地链接或打包为 bundle；启用后，界面右侧标签栏出现 QizhouCNC_CAM。
package.json 中声明对 @deepseek-ai/dsh-tools 的 peer 依赖范围为：
>=0.2.2-rc.1 <0.3.0
客户端通过 dsh.client 注入 @deepseek-ai/dsh-client-runtime 与 @deepseek-ai/dsh-client-ui-conversation，平台为 web，immediately: true。
安装前应自行查看源码与许可证；插件随当前 DSH 进程权限运行，勿在未审阅的情况下用于敏感生产环境。
典型用法¶
- 在 DSH 中安装并启用插件，确认右侧出现 QizhouCNC_CAM 标签。
- 在工作区打开或扫描含 NC 的目录，在列表中点选目标
.nc/.gcode文件，在面板中查看三维刀路并切换六视图/等轴视角。 - 需要改程序时，从列表进入大界面编辑器，修改后 Ctrl+S（macOS 为 ⌘+S）保存，观察刀路是否已刷新。
- 要与模型讨论某一段时，在编辑器选中行，点「引用到对话框」，再在 Harness 对话中继续提问。
- 若工作区含 STEP 模型且本机已配置 FreeCAD CAM，可按插件提供的流程尝试由模型生成轮廓 G-code（具体步骤以插件界面与
cam_script.py为准）。
适用场景与注意¶
适合谁：在 DSH 里做数控程序阅读、刀路目视检查、与小段 G-code 协同修改的智能体或工艺开发人员；需要把「第几行、什么指令」精确喂给模型的场景。
注意：
- 用途以 README 为准：研究学习，无商用担保。
- STEP 转刀路依赖 FreeCAD CAM，环境需自行准备。
- 问题与建议可提交 GitHub Issues，或邮件 651712988@qq.com。
DSH 生态强调「一切皆插件」；SkillHub 目录页 为社区站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-qizhoucnc-cam 把 NC 刀路三维预览、全屏编辑和「引用到对话框」收进 DSH 客户端，减少纯文本协作时的定位成本。进一步了解可访问 SkillHub 插件页 与 GitHub 仓库。
