前言¶

DeepSeek Harness（DSH）的插件生态强调「一切皆插件」。开发者在使用 Visual X-Space（VX）时，常遇到 CAD 文件导入后弹窗要求授权、技能清单难以维护、工厂资产与对话上下文脱节等问题。dsh-vx-workbench 是一个客户端插件，通过签名匹配修复 CAD 导入路径、维护一份自更新的技能账本，并管理工厂布局资产，让智能体在与 VX 交互时拥有更稳定、可预测的环境。

插件定位¶

• 名称：dsh-vx-workbench
• 维护者：L050110
• 分类：客户端插件
• 核心价值：将 Visual X-Space 转为「一键式」工作台，修复 CAD 授权弹窗、自动维护技能清单、列出工厂布局资产

功能概览¶

CAD 导入兼容性修复¶

VX 在导入 FBX / STEP / STL 等格式时，会在内部调用一个授权检查点。不同版本 VX 的代码位置可能变化，传统硬编码偏移量的修复方式不通用。本插件通过比对 DLL 中的机器码签名（约 15 字节）定位该检查点，将条件跳转改为无条件跳过，并保存原始字节以备恢复。修复后重新加载 DLL，验证写入的字节，确保修复成功。

安装后，VX 的导入路径修复由插件完成；若签名不匹配或出现多次，插件会报错并停止，不会静默失败。

工厂资产面板¶

插件在配置的交付目录下扫描 .vcmx 布局文件，列出其大小、修改时间，并提供「揭示」按钮。当前版本尚未提供参数化的工厂线生成器，该功能列在路线图中。

自维护技能账本¶

插件每 5 分钟扫描以下目录下的 SKILL.md 文件：
- 工作区 skills/
- 工作区 .dsh/skills
- ~/.dsh/profiles/*/skills
- ~/.dsh/skills
- DSH 自带的技能目录

指纹计算方式为 sha256(SKILL.md 字节 + 同目录下其他文件的形状)，因此修改内容或新增引用文件都会被计入变更。插件会重写 docs/skills.md，并记录新增、修改、删除的技能。通过 POST /vxwb {"action":"skills-broadcast","maxAgeHours":168}，可将变更摘要推送到已打开的对话中。

技能增长与隔离¶

插件将「工作台技能」（.vcmx、CAD、桥接操作）与全局技能分离。工作台技能列表单独维护；全局技能会被列出但不会混入工作台。会话可通过 POST /vxwb {"action":"skill-add",…} 新增工作台技能；损坏的技能不会被删除，而是移至 vx-workbench/trash/skills/ 以便恢复。全局无关技能可通过 {"action":"skill-ignore","all":true} 隐藏。

安装与启用¶

插件要求：
- 操作系统：Windows（兼容层需要与 Windows 安装的 CAD 交互）
- DSH：>= 0.2.1-rc.2
- Visual X-Space：4.8（其他版本会被检测，但不盲目修补）

安装命令：

dsh plugin --profile web add dsh-vx-workbench

安装完成后重启 profile，刷新页面，侧边栏会出现「VX 工作台」入口。如果面板未出现，重新启用插件包并刷新页面。

配置¶

插件不硬编码路径，所有路径通过环境变量配置，未配置时会显示「未配置」而非猜测。

在 DSH 运行环境中设置这些变量，然后重启 profile。

权限与隐私¶

插件声明了以下能力：

• fs-read：读取 CAD 装配以定位决策点；扫描技能根目录下的 SKILL.md
• fs-write：写入技能账本 docs/skills.md、vx-workbench/{skills,status,ov-skills}.json、log.jsonl、DLL 备份副本
• shell：执行 reg query、tasklist，以及点击按钮时调用 powershell -File install.ps1 / restore.ps1
• network：可选的本地回环 MCP 调用（${baseUrl}/mcp），仅用于访问本地 OpenViking 服务器

插件不会写入项目源码，不会上传任何数据，也不会启动 CAD 进程。

数据存储¶

所有数据位于工作区的 vx-workbench/ 目录：

vx-workbench/status.json      当前快照（每次面板轮询时写入）
vx-workbench/skills.json      技能目录 + 最后变更集
vx-workbench/log.jsonl        追加式操作日志
vx-workbench/requests.jsonl   发送给哪些对话的请求记录
vx-workbench/ov-skills.json   OpenViking 目录快照（可选）
plugins/vx-workbench/docs/skills.md   技能账本本身

无遥测，无分析，无远程调用（仅可选的本地 OpenViking 探测）。

常见问题¶

• 面板显示「此版本未适配」：签名不匹配当前构建。运行 node lib/patch.mjs scan <dll> 并将 SHA256 提交 issue。
• CAD 修复后仍拒绝导入：启用面板中的「load-chain fix」，然后重启 VX。
• 面板为空或「未就绪」：主机端未加载。重新启用插件包并刷新页面。
• 技能账本显示 0 个技能：未找到任何 SKILL.md，或在非 Electron 主机上 VX_DSH_ROOT 配置错误。
• 广播未生效：会话会读取队列消息，检查 vx-workbench/log.jsonl 中的投递行。

路线图¶

已完成：
- 基于签名的兼容性修复（含备份 / 恢复 / 读回验证）
- 自维护技能账本 + 对话广播
- OpenViking 目录摄入（直连 + 快照）

规划中：
- 参数化工厂生成器（生产线 / 工位 / 节拍 / 机器人 / AGV）
- 模拟运行后的周期时间和瓶颈报告
- 按需下载模板资产，而非打包在安装包中

适用场景¶

适合在 Windows 环境下使用 Visual X-Space 4.8，且依赖 DXF/FBX/STEP/STL 导入、需要维护大量技能清单、希望将工厂资产与对话上下文绑定的 DSH 开发者。

注意事项¶

• 插件以当前 DSH 进程的权限运行，安装前应检查源码与许可证。
• CAD 导入修复会影响 VX 的 DLL，请备份后再操作。
• 技能账本指纹包含目录内所有文件的形状，频繁更改目录结构可能导致误报。

结语¶

dsh-vx-workbench 通过签名匹配修复 CAD 导入路径，将 Visual X-Space 从授权弹窗的干扰中解放出来；自维护的技能账本让智能体不再需要猜测技能名称；工厂资产面板则将布局文件与对话上下文对齐。它没有把所有功能都塞进一个面板，而是分模块实现，便于后续扩展。

目录页：https://www.skillhub.cn/plugins/L050110/dsh-vx-workbench
GitHub：https://github.com/L050110/dsh-vx-workbench