Ultracode：DeepSeek Harness 的工作流编排插件

前言¶

DeepSeek Harness（DSH）在单次对话中完成复杂任务时，往往需要拆分成多个步骤，由不同 Agent 顺序或并行执行。手动编排会话容易遗漏细节或重复请求，而直接要求 Agent 自主拆分又难以控制其复杂度和并发度。Ultracode 插件在 DSH 中提供了一套基于预设的工作流编排机制，通过主代理统筹规划、子代理执行具体步骤，并配合悬浮进度卡片和模式微光，让多 Agent 协作更可控、可追踪。

插件定位¶

Ultracode 是一个社区插件，由维护者 Srelka 开发。它为 DSH 增加了一套多 Agent 工作流预设，在 Agent 预设中选择 Ultracode 即可启用。插件不依赖 Anthropic 或 OpenAI 的代码，也不包含 Claude Code 的专有部分。核心价值在于：在保持 DSH 原生模型与思考强度选择的基础上，让 Agent 在复杂任务中自动创建工作流，简单任务则直接完成，避免用户重复确认。

核心功能¶

工作流编排¶

选择 Ultracode 预设后，Agent 会根据任务复杂度决定是否创建工作流。复杂任务会由主代理统筹规划、调整和汇总，工作流负责具体实现、整合与测试。主代理在成功派发任务后结束本轮，通过完成通知唤醒用户。对于后台运行时用户交办的简单独立事项，主代理可直接完成，不会取消原工作流；重叠写入时先交接。

JavaScript 脚本编排¶

1.3.0 版本保留了 JavaScript 脚本编排能力，支持脚本文件、启动前校验、调整后复用已完成结果和会话恢复。进程重启后，工作流历史及已完成结果会被保留，恢复时从头运行脚本并复用有效前缀，但不会恢复运行中的 JavaScript 指令位置。

悬浮进度卡片¶

工作流卡片固定悬浮在会话顶部，可拖动和折叠。收起后从会话顶部打开，保留阶段、成员和版本历史。卡片采用进度书签，阶段名称与节点对齐，默认跟随正在执行的阶段，也可手动固定查看。完整清单、成员详情、历史和长结果在独立视图中打开。

进度条微光¶

运行中的进度条有彗星微光和少量光屑，停止或完成后静止，尊重系统减少动态效果设置。进度比例按实际成员计算。

输入框模式微光¶

切换到 Ultracode 模式时，输入框顶部正中播放开场流光，短暂停顿后淡入连续呼吸微光。切回其他模式时清除，恢复已有会话不重播。

动态预设继承¶

启动时动态继承当前标准预设，仅覆盖工作流编排策略、并发和总代理预算。标准预设的修改在下次启动时继承，不支持运行中热更新。

版本链与异常处理¶

同一目标的调整会保留版本链，先结束旧执行再启动新版本。独立任务使用独立工作流。成员异常时会显示原因和后续建议，脚本正常结束但有成员未完成时，会标明“已结束，有异常”，不误报全部完成。

兼容与安装¶

插件已验证支持 DSH 版本 >=0.2.1-rc.2 <0.3.0-0。安装步骤如下：

从本仓库的 Release 下载最新发布版的 .tgz 文件。
在 DSH 的插件安装入口选择该安装包。
CLI 用户执行：

dsh plugin --profile web add ./下载的安装包.tgz

桌面端优先使用应用内插件管理入口。

安装后完全退出并重新打开 DSH，在新会话的 Agent 预设中选择 Ultracode。如果已经安装本地开发版 @local/dsh-ultracode，需先通过 DSH 插件管理卸载该开发版，再安装本包，避免同名预设冲突。卸载插件不需要删除会话；本包沿用 ultracode 预设和历史标识。

配置¶

在 DSH 的用户覆盖层设置 preset-ultracode，可以覆盖默认配置。保留完整配置的示例：

- id: preset-ultracode
  name: '@srelka/dsh-ultracode/inherit'
  config:
    basePreset: standard
    maxConcurrentAgents: 4
    defaultAgentLimit: 12
    maxTotalAgents: 40
    replacementTimeoutMs: 30000

默认并发上限为 4，默认每个工作流总代理上限为 12，可调整但不超过 40。工作代理禁止继续递归委派。

开发与测试¶

使用与目标 DSH 运行时一致的 Node.js。安装依赖后，将 ULTRACODE_TEST_RUNTIME 指向具有 node_modules 的同版本 DSH 运行时目录，执行 npm test。该变量只供测试使用，插件通过宿主 Loader 获取原生接口。

只运行无需 DSH 依赖的模型和光效控制器测试：

node --test tests/model.test.mjs tests/composer-glow.test.mjs

运行模块已经是 JavaScript，不要求用户执行构建脚本。打包使用 npm pack --ignore-scripts。

限制¶

任务拆分和结果质量取决于实际模型。工具参数格式错误在本步尚未执行工具时最多重试两次，不能保证所有模型永不输出错误。系统开启减少动态效果时只保留静态模式边缘。

适用场景¶

Ultracode 适合需要将复杂任务拆分为多个步骤、希望 Agent 自主规划并保持工作流可追踪的用户。插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。当前宿主只允许空白会话切换预设，已有对话保留原模式。

结尾¶

Ultracode 通过工作流预设、悬浮进度卡片和模式微光，让 DeepSeek Harness 中的多 Agent 协作更结构化、更易追踪。插件支持 DSH 0.2.1-rc.2 及以上版本，版本号 1.5.0，许可证 MIT。更多细节可参考插件目录页或 GitHub 仓库。