dsh-ultra
DeepSeek Harness 的 Ultra 模式。思想与提示词移植自 Claude Code 2.1.309 的 ultracode，机制按 DSH 重写：
不靠隐藏参数，而是 Agent 预设 + 多智能体编排协议 + reasoningEffort 覆盖 + 按需编排手册。
两种形态，二选一：
| 形态 | 入口 | 适用 |
|---|
| Agent 预设（推荐） | 设置 → Agent 预设 → 自定义 → Ultra 模式 | 新任务默认进入 Ultra |
| 普通插件 | 会话内 /ultra [on|off|status] | 临时开关 |
效果
选择 Ultra 模式（或 /ultra on）后：
- standing opt-in：每个实质性任务默认用
workflow 做多智能体编排，不再需要每轮请示；
- 推理档位拉满：请求的
reasoningEffort 覆盖为 max（DeepSeek 适配器支持 off / low / high / max）；
- 协议注入：系统提示词出现 Ultra 协议——先探查拿工作清单，按维度扇出，每个结论派 2–3 个独立验证者对抗验证（不确定默认判伪），收敛后带证据报告；默认
pipeline、不默认 barrier、任何截断必须 log()；
- 手册按需加载：
ultra_reference 工具常驻注册，第一次写 workflow 脚本前调用一次，拿到脚本 API、schema 规则、loop-until-dry / judge panel / completeness critic 模板；
- 状态可恢复：模式写在会话日志（
ultra/mode 事件）里，投影折叠出 { active }，resume / fork 后状态与徽标都会恢复；
- 徽标：Web UI 输入框上方显示
ULTRA · 编排 + max（仅开启时）。
关闭后一切恢复默认：workflow 回到“用户显式要求才使用”，effort 回到会话设置。
安装
从 npm 安装（推荐）：
cd ~/.dsh/profiles/<profile>
pnpm add dsh-ultra # 或 npm install dsh-ultra
然后把 node_modules/dsh-ultra/preset/cordis.patch.yml 的内容追加到该 profile 的
cordis.patch.yml 末尾，等热加载或重启 DSH。设置 → Agent 预设 → 自定义 → Ultra 模式。
也可以从源码安装：
git clone https://github.com/ophielel/dsh-ultra.git ~/.dsh/plugins/dsh-ultra
并在 profile 的 dependencies 里加 "dsh-ultra": "file:../../plugins/dsh-ultra"，执行 pnpm install，
其余步骤相同（改用仓库里的 preset/cordis.patch.yml）。
预设只影响之后创建的任务；已有任务保持原预设。
方式二：插件 + /ultra
同样安装包，然后把仓库/npm 包根目录的 cordis.patch.yml 追加到 profile patch：
- insert:
- id: ultra
name: dsh-ultra
config:
alwaysOn: false
reasoningEffort: max
热加载或重启后，在会话里：
/ultra 切换
/ultra on|off 开关
/ultra status 查看
不要同时安装两种形态：全局插件行和预设里的子插件会重复注册同名工具/命令。
它具体做了什么
| 部分 | 实现 |
|---|
| 提示词 | ctx.systemPrompt.section({ name: "ultra:policy", order: 9000, text })，未开启时返回空串，不占 token |
| 推理档位 | agent/request 瀑布最外层（prepend: true）改写 reasoningEffort |
| 编排手册 | ultra_reference 工具，按需返回 prompts/reference.md |
| 会话状态 | sessionProjections 注册 ultra 投影，折叠 ultra/mode 事件 |
| 开关 | /ultra 命令写 agent.session.append("ultra/mode", { active }) |
| 徽标 | client 半边读 useProjection("ultra")，挂 conversation.input.dock |
和 Claude Code ultracode 的差异
- Claude Code 靠模型白名单（支持
xhigh 才可开）+ 每次进入自动塞 ~17 KB 手册；这里靠 Agent 预设/命令 + 按需工具，避免每轮固定成本。
- 模式状态落在会话日志而不是进程内存，所以 resume / fork 可恢复。
reasoningEffort: max 由适配器解释；换成不支持 max 的模型时，把配置改成 high 或 ""（空字符串表示不覆盖）。
配置
- id: ultra
name: dsh-ultra
config:
alwaysOn: false # true = 挂载即生效，忽略 /ultra 开关（预设用）
reasoningEffort: max # off | low | high | max | ""（空字符串 = 不覆盖）
文件结构
index.js 投影、命令、prompt section、effort 覆盖、参考工具
client.js 输入框上方 ULTRA 徽标
prompts/ultra.md 每轮注入的协议（约 3.5 KB）
prompts/reference.md 按需返回的完整编排手册
cordis.patch.yml 插件行（bundle / 手动 patch 安装用）
preset/ Agent 预设 bundle（Ultra 模式卡片）
test/ultra.test.mjs 用假 ctx 覆盖开关、幂等、effort、错误分支
开发
npm test # node test/ultra.test.mjs
npm run check # node --check index.js && node --check client.js
需要 Node 20+。仓库本身没有构建步骤，DSH 直接加载 index.js / client.js。
兼容性
- DSH 0.2.x，在本机
0.2.1-rc.2 上验证；
- 服务端插件（
index.js）跨平台；客户端徽标只在 Web UI 出现；
reasoningEffort: max 需要适配器支持（DeepSeek 支持）；其他供应商请改成 high 或 ""。
License
MIT
