VanillaCreamer/dsh-plugin-visual-composer

README 摘要

DSH Visual Composer DeepSeek Harness 的可视化 Cordis 插件树编排器 DSH Visual Composer 是一个运行在 DeepSeek Harness Web 界面中的社区插件。它把当前 Profile 的 Cordis 插件树转换成可视化画布，让你查看插件、添加插件或 Group、拖拽 Composer 管理的节点、编辑配置覆盖，并在保存前审阅脱敏后的 YAML Diff。 [!IMPORTANT] 本项目是独立社区原型，不是 DeepSeek AI 官方插件。DeepSeek Harness 目前仍处于 Developer Preview，插件接口可能在后续 RC 版本中变化。 目录 - 为什么需要它 - 核心能力 - 兼容性与前置条件 - 安装 - 快速开始 - 界面与操作 - Cordis 编辑语义 - 保存、热更新与回滚 - 安全模型 - 架构 - 开发与测试 - 常见问题 - 已知限制 - 路线图 - 参与贡献 - 许可证 为什么需要它 DeepSeek Harness 采用“万物皆插件”的 Cordis 架构，但 Profile 的最终结构通常由 Bundle、 cordis.patch.yml 、Group 嵌套和运行时状态共同决定。只阅读 YAML 很难快速回答以下问题： - 当前实际加载了哪些插件？ - 插件位于哪个 Group 中？ - 哪些节点处于 active、failed、disabled 等状态？ - 某个插件注入或依赖了哪些 Service？ - 一次配置覆盖最终会生成怎样的 Patch？ - 修改失败后能否安全恢复？ Visual Composer 将这些信息集中到 DSH Web 的插件设置页中，同时严格遵循 Cordis Patch 的真实语义，不把插件树伪装成任意连线的工作流引擎。 核心能力 - 读取当前 DSH Web Profile 的真实 Loader 树。 - 展示嵌套 Group、插件状态、模块名、Entry ID、注入信息与配置。 - 从左侧 Palette 添加插件或 Group 草稿。 - 将 Composer 管理的绿色节点拖入 Root 或任意 Group。 - 为现有 Entry 创建 disabled 和完整 config 覆盖。 - 按 ID、模块名或 Label 过滤插件树。 - 保存前展示脱敏后的 Composer 管理块 Diff。 - 使用预览签名保证“审阅的草稿”和“实际写入的草稿”一致。 - 仅维护 cordis.patch.yml 中有明确标记的区域，保留其他文本与注释。 - 通过乐观 Revision、防并发覆盖和原子替换写入配置。 - HMR 可用时等待根 Include 事务真正提交，再报告成功。 - HMR 拒绝或超时时自动…

分类