前言¶
在 DeepSeek Harness（DSH）里做稍大的任务时，常见做法是手动拆步骤、反复让主会话调用 workflow 工具或子智能体。步骤多了，进度散落在 transcript 里，resume、fork 之后也不容易还原「当前是不是按工作流在执行」。
Ultracode 是面向 DSH 的第三方插件，由 Big-Smarty 维护，在 SkillHub 插件目录 归类为「工作流」。它把「实质性任务默认走多阶段 workflow」做成可按会话开关的 session mode，并在 Composer 与右侧栏提供状态与台账，而不是改模型或 preset 本身。
这是什么¶
Ultracode 是 DeepSeek Harness 的一种 session mode：武装（arm）一次后，智能体会把实质性工作归类为多智能体 workflow——划定范围、编写 workflow 脚本、分阶段 fan-out 子智能体、对抗式校验并汇总结果；琐碎请求仍可直接处理并说明原因。
插件无构建步骤、无额外依赖，Host 侧为 ESM，客户端为浏览器 JavaScript，使用宿主主题 token，文案支持英文与中文。许可证为 MIT（见仓库 LICENSE）；package.json 中版本为 1.1.0。
核心功能¶
Session 模式与命令¶
- 通过
/ultracode [on|off|status]或 Composer 上的 Ultracode 药丸开关控制当前会话；姿态从命令日志折叠，resume、fork、replay 可恢复。 - 武装后，
ultracode:policy在 order2650注入提示段（位于workflow工具指引 order2600之后），要求分阶段、pipeline/parallel扇出、隔离写操作、对抗式验证，并在报告中附证据；未武装时该段为空。
Composer 开关与侧栏台账¶
- Composer switch：关闭时为安静边框药丸；武装后为扁平强调色与圆点，Composer 边缘有一条细缝；无渐变、无图标字形。
- Workflow sidebar：会话头
ULTRA徽标或右侧栏 Ultracode 打开台账：进行中与已结束的 run、带进度轨与点的阶段卡片、各 agent 状态、模型、token 与墙钟时间、验证标签、高扇出标记，以及子 transcript 下钻。
与日志投影，无新事件类型¶
ultracode投影：从command/run/command/done折叠{ active, pending }。ultracodeRuns投影：从tool-workflow/run-start|agent-start|agent-end|run-end等折叠 run/phase/member 与计时；turn/end处理中断或 fork 导致的 abandoned run。阶段保持原始身份；取消与失败区分。
Shell 等后台任务仍在 DSH 既有 jobs 控件中；侧栏聚焦 workflow。
与 Preset 的兼容¶
Ultracode 是姿态，不是 preset；依赖 preset 是否向模型暴露 workflow 工具：
| Preset | workflow 工具 |
Ultracode 行为 |
|---|---|---|
| Standard | 有 | 完整策略、阶段、子智能体、验证与台账 |
Creator (cordis) |
有 | 同上，并含插件 authoring 工具 |
| PTC | 无（仅 run_code 及 SDK） |
策略抑制；概览显示 Workflow unavailable in this preset |
| Minimal | 无（持久 shell + read_image） |
仅 UI；完整 persona 亦抑制策略，概览同上 |
| Custom | 视组合而定 | 若包含 workflow-ptc 与 tool-workflow 则完整；否则抑制策略 |
安装与启用¶
依赖：DSH 具备 workflow 工具，以及 Web/Desktop 右侧栏。README 写明在 0.2.1-rc.2 上测试；相近且服务一致的版本通常可用。
从 GitHub 安装（官方步骤）：
- 在 DSH 侧栏打开 Plugins。
- 选择 Add plugin → Install third-party plugin。
- 填写仓库 URL：
https://github.com/Big-Smarty/dsh-ultracode.git
本地 clone 路径亦可，且会保持与检出目录的链接以便改代码。
4. 安装并启用 bundle 后，刷新页面一次，以便客户端半部加载。
也可让 DSH 智能体从同一 URL 安装该 bundle。社区目录页为 SkillHub：dsh-ultracode；源码与说明见 GitHub：Big-Smarty/dsh-ultracode。
典型用法¶
| 操作 | 方式 |
|---|---|
| 武装会话 | /ultracode，或点击 Composer 中的 Ultracode 药丸 |
| 解除武装 | /ultracode off、Composer 药丸，或面板概览中的 arm 控件 |
| 查看状态 | /ultracode status |
| 打开台账 | 点击会话头 ULTRA 徽标，或右侧栏 → Ultracode |
| 查看某次 run | 展开 Finished，打开阶段，点击 agent 阅读其子 transcript |
武装后，查找、单行编辑、单条命令等琐碎请求保持直连；实质性请求会走 workflow。
适用场景与注意¶
适合：已在 Standard 或 Creator 等带 workflow 的 preset 上工作，希望默认把大任务拆成可追踪的多阶段子智能体流程，并需要在 UI 里看 run 进度与验证结果的场景。
不适合或受限：PTC、Minimal 等无 workflow 的 preset 下策略被抑制，无法产生 Ultracode 追踪的 workflow run（PTC 仍可通过 SDK 调子智能体，但不属于台账中的 Ultracode workflow）。
成本与安全：Ultracode 会刻意消耗更多 token 与时间（每个实质性任务可能启动多个子智能体）；/ultracode off 可立即回到常规范式。插件 Host 代码与你的 DSH 进程同权限、进程内运行；不绕过审批、沙箱、plan mode 或工具限制。安装前请阅读源码并确认信任维护者与 MIT 许可。
排错（摘自 README）：
ULTRA徽标出现红色!：悬停查看失败原因；打开器会回退到展开右侧栏引导。- 更新后 Ultracode 标签缺失：硬刷新（
Ctrl+Shift+R）；客户端插件在页面启动时从模块图加载，热重载可能残留旧图。 - 徽标无响应：在 Settings → Plugins 查看 page-local client sync 错误，刷新后重试。
结尾¶
dsh-ultracode 把「实质性任务 → 动态多智能体 workflow」固化成可开关的会话姿态，并用 Composer 与右侧台账把 run 状态投影到现有日志上，无需新增 session 事件类型。若你使用带 workflow 的 DSH preset，可从目录页或 GitHub 按上述 URL 安装，武装后用大一点的任务试一轮台账与阶段下钻是否符合预期。
- 目录页：https://www.skillhub.cn/plugins/Big-Smarty/dsh-ultracode
- GitHub：https://github.com/Big-Smarty/dsh-ultracode
