前言¶
在使用 DeepSeek Harness (DSH) 构建复杂工作流时，插件拓扑结构往往变得难以直观把控。dsh-schematic 提供了一个统一控制平面，旨在解决可视化实时布线、追踪活动以及安全自动化插件蓝图的问题。
这是什么¶
dsh-schematic 是 DeepSeek Harness 的一个插件，定位为“人类和代理人的控制平面”。它由 Mason-1011 维护。其核心价值在于让人类操作员和 Agent 操作员共享同一套控制机制：人类通过全屏可视化工作台进行操作，Agent 通过 schematic_* 原生工具进行持久化操作，两者基于同一套实时状态、验证规则和受保护的写入管道工作。
核心功能¶
该插件提供以下核心能力：
- 可视化实时布线与拓扑结构：界面即图，支持探索实时拓扑或库存、检查依赖关系、配置插件、切换条目并替换提供商。
- 活动追踪与调试：跟踪会话事件和请求旅程、安排信号、过滤噪音，并检查故障或延迟。活动遵循所有权，便于定位问题来源。
- 安全自动化插件蓝图：蓝图描述能力而非脆弱的快照。支持按能力组合、保存本地草稿、导入导出 YAML、检查漂移并安全切换整个插件组合。每个有风险的更改都会获得预览。
- 人类与 Agent 对称操作：支持英语和中文。界面与工具共享同一套计划、验证、确认门控和备份机制。
安装与启用¶
在终端中执行以下命令安装插件：
dsh plugin --profile web add dsh-schematic
安装完成后，启动 Web 服务并访问可视化界面：
dsh web
# 然后在浏览器中打开
open http://127.0.0.1:3080/schematic
典型用法¶
除了通过界面操作，Agent 也可以通过对话使用以下工具进行管理：
- 查看拓扑与能力：
schematic_plugins
- 管理蓝图：
schematic_blueprint_list
schematic_blueprint_save
schematic_blueprint_switch
schematic_blueprint_manage
- 系统组合与活动布局：
schematic_system_compose
schematic_activity_layout
适用场景与注意¶
该插件适合需要将插件拓扑结构可视化管理、通过 Agent 安全调整配置或需要统一观察运行时活动的场景。
需要注意以下几点：
1. 编辑权限：编辑功能默认关闭，可通过 config.edit.enabled=false 完全禁用。在移动端（宽度小于 768px）写入功能会自动禁用。
2. 文件写入机制：Schematic 仅在活动配置文件的 cordis.patch.yml 中写入一个明确标记的托管块，不会覆盖源文件。如果源文件在待编辑下方发生变化，写入将停止。
3. 蓝图存储：蓝图作为可读的 schema-2 YAML 存在于 ~/.dsh/schematic/blueprints/ 下。现有的 schema-1 预设会进行幂等迁移并保持为只读备份。
4. 环境要求：需要 Node.js 版本 >= 22.19。
短结尾¶
dsh-schematic 通过将“图”作为界面，为 DSH 插件系统提供了一个直观、安全且人类与 Agent 共享的控制平面。它解决了配置复杂度高、缺乏可视化反馈和操作风险大的问题。更多详情可查阅插件目录：https://www.skillhub.cn/plugins/Mason-1011/dsh-schematic 或源码仓库：https://github.com/Mason-1011/dsh-schematic。
