@ddtcorex/dsh-maestro-devkit: DeepSeek Harness 通用开发工具包

在 DeepSeek Harness（DSH）的开发流程中，除了常规的代码逻辑外，前端视图的快速迭代、样式调试以及特定组件的隔离测试往往是开发者的痛点。虽然 DSH 本身提供了核心能力，但针对视图审查、热更新和特定业务组件（如 Cordis、Govard、Skills）的开发，仍需额外的辅助手段。

@ddtcorex/dsh-maestro-devkit 旨在为开发者提供一个统一的开发工具集，解决视图审查、样式调试和组件隔离的问题。

插件简介¶

这是一个通用开发工具包，主要面向 DSH 的视图开发和调试场景。它由 ddtcorex 维护，提供了一系列前端工具，包括可视化审查、热模块替换（HMR）、样式检查器，以及对 Cordis、Govard 和 Skills 开发的支持。该工具集是隧道感知的，能够适应本地开发和通过隧道访问的场景。

核心功能¶

该插件包含以下核心模块：

1. 视图捕获（frontend_capture）
   支持多视口截图，并捕获 DOM 结构和几何信息。它对隧道环境友好，能够识别 local 或 https://tunnel.example.com 等不同的访问地址。

2. 热模块替换（frontend_hmr）
   利用 chokidar 监听文件变化，并自动分类变更类型：

   • dist hot-patch：直接热补丁。
   • build:client：客户端构建。
   • host-restart：需要重启宿主。
     在执行替换前，会通过 curl 验证目标 URL 的可用性。

3. 样式检查（frontend_inspect）
   通过客户端注册的 RPC 通道，直接从活动浏览器标签页获取真实的 getComputedStyle 结果。结果展示为内联覆盖面板，方便开发者实时调试样式。

4. 组件隔离（frontend_isolate）
   允许开发者将单个插槽（slot）隔离到沙箱环境中进行测试。通过访问带有特定查询参数的 URL 即可进入隔离模式：

    /?__devkit_sandbox=<slot>&props=<json>

在隔离模式下，支持通过 JSON 编辑器修改属性，并使用视口切换器进行观察。

5. 会话开发（devkit_session）
   直接通过 ctx.sessions 查看和检查真实会话列表，便于调试运行时状态。

6. Govard 与 Skills 支持

   • devkit_govard：提供 Govard 相关命令（仅限允许列表中的命令）。
   • devkit_skills：提供真实的文件系统列表和脚手架功能，用于 Skills 的开发。

安装与启用¶

安装该插件需要使用 DSH 的插件安装命令。

1、执行安装命令：

dsh plugin --profile web add @ddtcorex/dsh-maestro-devkit

2、安装完成后，需要重启 dsh web 进程以使插件生效。

典型用法¶

开发者通常在以下场景下使用该插件：

• 样式调试：在页面中打开开发者工具面板，查看实时计算后的样式属性。
• 组件隔离测试：针对某个特定的插槽，通过 URL 参数 /?__devkit_sandbox=slot_name&props={"key": "value"} 快速切换 props 并测试渲染结果。
• 视图审查：使用多视口捕获功能，确认不同屏幕尺寸下的布局表现。

注意事项¶

该插件目前已被标记为 Retired（已退役）。由于其 UI 和工具未能完成一个完整的、可演示的开发工作流，且存在功能重复的情况，该包不再接受新的运行时版本发布。

• 无替代品：目前没有可以直接替换此插件的工具。
• 回滚支持：现有的 0.3.2 版本工件仍然可以安装，用于回滚。
• 版本变更：在 0.2.0 版本中，devkit_cordis_inspect 和 devkit_plugin 模块已被移除。这两个模块的功能与核心 @deepseek-ai/dsh-tool-cordis 扩展重复，开发者应直接使用核心扩展提供的 cordis_inspect_list、cordis_define 等命令。

结语¶

虽然该插件已停止维护，但其提供的视图捕获、样式检查和组件隔离思路对 DSH 生态仍有参考价值。对于需要快速调试视图和组件的开发者，可以参考其实现方式，或直接使用 Chrome DevTools/CDP 等通用工具组合。

• GitHub 仓库