超频工作流 Big-Smarty/dsh-ultracode

Ultracode

为 DeepSeek Harness 打造的动态工作流。

Ultracode 是一种会话模式，把每个实质性任务都变成多智能体工作流。开启一次即可：智能体先界定工作范围，编写 workflow 脚本，分阶段铺开子代理，做对抗式验证，最后汇总结果。

截图

概览区块、正在运行的工作流，以及已完成的工作流。

Ultracode beside a DeepSeek Harness session

实际会话中的 Ultracode 标签页。

A workflow running in the transcript

workflow 工具的运行卡片。

功能

- 会话模式，不是模型设置。 /ultracode [on|off|status] 只对一个会话生效。状态从命令日志中折叠得出，因此恢复、分叉和重放都能还原它。
- 工作流优先策略。 开启后，workflow 工具自带指引之后会追加一段提示词，把工作判定为实质性或琐碎，要求划分阶段并用 pipeline/parallel 铺开，隔离写入方，加入对抗式验证，并要求在报告中给出证据。
- 输入框开关。 关闭时是一枚安静的描边胶囊；开启时变成扁平的强调色底和圆点，输入框边缘还多一道细缝。没有渐变，没有图标字形。
- 工作流侧边栏。 ULTRA 徽标打开右侧栏账本：运行中和已完成的运行、带进度轨和圆点的阶段卡片、每个智能体的状态、模型、token 和实际耗时、验证标签、高扇出标记，以及子会话记录的下钻查看。
- 答案来自日志。 没有新增会话事件类型。一个投影折叠 /ultracode 命令的生命周期；另一个折叠 tool-workflow/* 记录，并关闭因轮次中断或分叉而废弃的运行。阶段保留原始标识；取消的结果与失败保持区分。
- 无需构建，没有依赖。 纯 ESM 和浏览器 JavaScript，使用宿主主题 token，提供中英文文案。

预设兼容性

Ultracode 是一种状态，不是预设。它需要预设自带 workflow 工具。

| 预设 | workflow 工具 | Ultracode 行为 |
| Standard | 有 | 完整策略、阶段、子代理、验证和账本。 |
| Creator（cordis） | 有 | 完整；Standard 的工具加上插件编写工具。 |
| PTC | 否；只有 run_code 及其 SDK | 策略被抑制。概览会报告 Workflow unavailable in this preset；不会运行工作流。PTC 可以把子代理当作 SDK 绑定来调用，但这属于代码层面的 PTC，不是受追踪的 Ultracode 工作流。 |
| Minimal | 否；持久 shell + read_image | 仅 UI。完整 persona 同样会抑制策略；概览会报告 Workflow unavailable in this preset。 |
| Custom | 取决于其组成 | 当它组合了 workflow-ptc 和 tool-workflow 时为完整模式；否则策略被抑制。 |

策略会检查 workflow 对智能体是否模型可见。概览警告能识别内置的 minimal 和 ptc 预设；自定义预设若不含 workflow，会得到被抑制的策略，但不会出现预设名称警告。

安装

需要 DeepSeek Harness，并带有 workflow 工具和 Web/Desktop 右侧边栏。已在 0.2.1-rc.2 上测试；服务相同的邻近版本应该也能用。

从 GitHub 安装

1. 在 DSH 侧边栏打开 Plugins。
2. 选择 Add plugin → Install third-party plugin。
3. 输入仓库 URL：

https://github.com/Big-Smarty/dsh-ultracode.git

本地克隆路径也可以，而且会保持检出目录链接，方便后续编辑。
4. 安装并启用该 bundle，然后刷新页面一次，让客户端那一半加载。

或者让你的 DSH 智能体从同一 URL 安装该 bundle。

本地克隆

git clone https://github.com/Big-Smarty/dsh-ultracode.git
cd dsh-ultracode
npm test

按上面的方式，通过 Plugins → Add plugin 安装克隆下来的目录。插件是链接而非复制，所以后续编辑在刷新后即可生效。

用法

| 操作 | 方式 |
| 启用会话 | /ultracode，或点击输入框里的 Ultracode 胶囊按钮 |
| 停用 | /ultracode off、输入框胶囊按钮，或面板概览里的启用控件 |
| 查看状态 | /ultracode status |
| 打开账本 | 点击会话头部的 ULTRA 徽标，或右侧边栏 → Ultracode |
| 查看某次运行 | 展开 Finished，打开某个阶段，点击某个智能体读取其子转录 |

Ultracode 按会话生效。琐碎请求——一次查询、一行编辑、单条命令——保持直接处理，并说明原因。实质性请求会转为工作流。

面板聚焦于工作流。Shell 和其他后台任务仍留在 DSH 现有的任务控制里。

故障排查

- ULTRA 徽标显示红色 ! —— 悬停查看失败原因。打开器会退回到展开右侧边栏指南。
- 更新后 Ultracode 标签页缺失或不可用 —— 硬刷新页面（Ctrl+Shift+R）。客户端插件在启动时从页面的模块图加载，所以过期的模块图可能在热重载后仍然存在。
- 徽标完全没反应 —— 检查 Settings → Plugins 是否有页面本地的客户端同步错误，然后刷新重试。

工作原理

- ultracode 投影 —— 从 command/run / command/done 折叠出的 { active, pending }。
- ultracodeRuns 投影 —— 从 tool-workflow/run-start|agent-start|agent-end|run-end 折叠出运行、阶段、成员、状态和耗时数据，并处理 turn/end，应对中断和分叉的轮次。
- ultracode:policy —— 提示词片段，顺序为 2650，排在 2600 处的工作流工具指引之后；未启用时为空。
- 客户端部分 —— 输入框胶囊、ULTRA 徽标、启用态接缝，以及右侧栏标签页类型。智能体的模型、token、时间值通过每个成员的 childId 关联到会话目录。

更多细节：docs/ARCHITECTURE.md。

开发

npm test

测试使用 Node 内置的测试运行器，覆盖立场、工作流账本、废弃运行收尾、阶段标识、取消和检查点清理。每次 push 和 pull request 都会跑 CI。

index.js Host half: projections, policy section, /ultracode command
client.js Client half: switch, badge, seam, workflow sidebar, styles
cordis.patch.yml Loads the bundle row
locale/ Plugin-inventory metadata (en, zh)
test/ Projection tests
docs/ Architecture and design notes

成本与安全

Ultracode 会刻意多花 token 和时间：每个实质性任务都要拉起多个子代理。/ultracode off 立即恢复正常执行。

插件以你的权限在进程内运行 Host 代码。只有信任来源时才安装。它不会绕过审批、沙箱策略、计划模式或工具限制。

许可证

MIT。见 LICENSE。