前言¶
DeepSeek Harness（DSH）采用「一切皆插件」的 Cordis 架构。一个 DSH Web Profile 的最终结构，通常由插件、Group、cordis.patch.yml 和运行时 Loader 状态共同决定。直接阅读 YAML 时，不一定能快速回答：当前实际加载了哪些插件、插件在哪个 Group、哪些节点处于什么状态、一次配置覆盖最终会形成怎样的 Patch。
dsh-plugin-visual-composer 是一个运行在 DeepSeek Harness Web 界面中的社区插件。它把当前 Profile 的 Cordis 插件树转换为可视化画布，用于查看插件树、添加草稿、调整覆盖，并在保存前审阅脱敏后的变更。
这是什么¶
下面介绍的 dsh-plugin-visual-composer 由 VanillaCreamer 维护，许可证为 MIT。它是独立社区原型，不是 DeepSeek AI 官方插件。
已核实资料给出的版本信息为：
- 包版本：
0.1.0 - 当前验证的 DeepSeek Harness 版本：
0.1.0-rc.6 - Node.js：
^22.19.0或>=24.0.0 - 运行目标：DSH Web Profile
DeepSeek Harness 目前仍处于 Developer Preview，插件接口可能在后续 RC 版本中变化。
核心功能¶
查看当前 Profile 的真实插件树¶
插件读取当前 DSH Web Profile 的真实 Loader 树，并展示嵌套 Group、插件状态、模块名、Entry ID、注入信息与配置。也可以按 ID、模块名或 Label 过滤插件树。
添加和编排草稿节点¶
可以从左侧 Palette 添加插件或 Group 草稿，并将 Composer 管理的绿色节点拖入 Root 或任意 Group。对现有 Entry，可以创建 disabled 和完整 config 覆盖。
保存前审阅脱敏 Diff¶
保存前会展示脱敏后的 Composer 管理块 Diff。插件使用预览签名保证“审阅的草稿”和“实际写入的草稿”一致，并通过乐观 Revision、防并发覆盖和原子替换写入配置。
热更新、备份与回滚¶
HMR 可用时，插件会等待根 Include 事务真正提交后再报告成功；HMR 拒绝或超时时，会自动恢复修改前文件。插件还会自动创建轮换备份，并支持在 Web UI 中一键回滚最近备份。
敏感配置保护¶
插件会对凭据、认证字段、!!js 表达式及敏感配置进行脱敏和编辑保护。已核实资料说明，敏感配置不会直接下发到浏览器，包括 API Key、Token、Secret、Password、Authorization、Cookie、Credential、密钥、认证 URL、!!js 表达式等。
安装与启用¶
安装 Release tarball¶
从本仓库 Releases 下载 dsh-plugin-visual-composer-0.1.0.tgz，然后安装到 Web Profile：
dsh plugin --profile web add ./dsh-plugin-visual-composer-0.1.0.tgz
启动 DSH Web：
dsh --profile web
从源码构建¶
git clone https://github.com/VanillaCreamer/dsh-plugin-visual-composer.git
cd dsh-plugin-visual-composer
npm ci
npm run pack
构建后执行安装和启动：
dsh plugin --profile web add ./dsh-plugin-visual-composer-0.1.0.tgz
dsh --profile web
卸载¶
dsh plugin --profile web remove dsh-plugin-visual-composer
注意：卸载不会主动删除历史备份，也不会移除已写入的 Composer 管理块。
典型用法¶
- 打开 DSH Web。
- 进入
设置 → 插件 → Visual Composer。 - 在左侧 Palette 添加已安装模块或 Group。
- 将绿色草稿节点拖到 Root 或目标 Group。
- 选中节点后，调整禁用状态或配置覆盖。
- 预览变更，阅读脱敏后的 Diff。
- 确认并保存。
- HMR 可用时，等待事务提交成功。
如果需要安装第三方插件包，示例命令为：
dsh plugin --profile web add <包名或本地路径>
适用场景与注意¶
适合在 DSH Web 中维护当前 Profile 的 Cordis 插件树，尤其是需要查看 Group 嵌套、Entry 状态、配置覆盖、备份回滚等操作的开发者。
使用它时需要注意：
- 该插件被设计为仅限本机的高权限配置界面。
- 它会运行在 DSH 中，并可以修改当前 Profile 的插件配置；安装前应检查源码、许可证和权限边界。
- API 要求 TCP 对端为 loopback，Host 为
localhost、127.0.0.0/8或[::1]，Origin 一致，POST 携带 CSRF Token，并限制请求体大小。 - 插件仅维护
cordis.patch.yml中有明确标记的区域，保留其他文本与注释。 config覆盖是完整替换，不是深度合并；提交前需要确认完整配置。- DeepSeek Harness 目前仍处于 Developer Preview，插件接口可能在后续 RC 版本中变化。
结尾¶
dsh-plugin-visual-composer 的价值，在于把 DSH Web Profile 的 Cordis 插件树从“读 YAML”变成“查看画布、审阅 Diff、安全保存和回滚”。
已核实资料未提供可确认的社区目录页 URL，本文不将其作为有效链接。仓库地址为：
- GitHub：https://github.com/VanillaCreamer/dsh-plugin-visual-composer
