DeepSeek Harness 插件：dsh-ultracode

DeepSeek Harness (DSH) 的核心设计理念是“一切皆插件”。在开发需要高精度推理或严格流程控制的智能体时，开发者通常希望在一个会话中强制模型使用最大推理深度，并统一应用特定的编排策略。dsh-ultracode 插件正是为此设计的：它为 DSH 添加了一个“Ultra Tier”。通过一个开关，该插件将所有模型请求强制锁定在服务模型声明的最大推理层级，并激活一套驻留的编排策略。

插件定位¶

名称: dsh-ultracode
维护者: BackMountainBird
许可证: MIT
核心价值: 单次开关，强制最大推理深度，激活编排策略。

核心功能¶

该插件主要提供以下能力：

按会话的努力层级：开启后，插件会拦截请求，将每个 Agent 请求的推理层级（effort）强制锁定为服务模型声明的最大值（默认为 auto，即自动选择最大值）。如果配置了具体值，则会直接使用该值。
编排策略：在会话激活期间，一个名为 ultra:policy 的提示词段落会注入到系统提示中。对于顶层会话，这包含工作流默认启用、对抗性验证、上下文清洗以及在提供商限制下进行“窄波”重试的策略。
UI 交互：在 Web 界面的 Composer 工具栏中会出现一个 “ULTRA” 芯片。激活时，Composer 卡片会显示彩虹边框（在减少动画偏好下为静态）。
选择器一致性：切换模式时，插件会通过公共模型 API 重新同步原生的努力层级选择器，确保显示状态与实际强制的请求状态一致。
委托感知：子代理（Delegated Children）会通过委托链继承“有效状态”。它们会获得努力层级的锁定和“工作政策”（childSection），但不会继承顶层会话的“工作流指令”。分支（Forks）则通过种子前缀继承，一旦生成即冻结。

安装¶

使用该插件前，需确保已安装 DeepSeek Harness 且版本满足要求（@deepseek-ai/dsh-* >= 0.1.0-rc.6）。

通过 npm 安装：

dsh plugin --profile <name> add dsh-ultracode

典型用法¶

安装完成后，可以通过命令或 Composer 界面切换模式：

开启模式：
在对话中输入 /ultra。此时模型将强制使用最大推理深度，并启用编排策略（例如审计依赖点）。
关闭模式：
输入 /ultra off 或再次点击 Composer 中的 ULTRA 芯片。
界面切换：
直接在 Composer 中切换 ULTRA 芯片，该操作会触发 Picker 的同步。

工作原理¶

插件通过 Harness 的事件系统进行状态管理和注入：

状态管理：状态由 Harness 拥有的 command/run 事件管理，插件本身不定义自定义会话事件。这意味着状态是持久的，且在恢复和重放时无需额外处理。
策略注入：当 Tier 激活时，ultra:policy 或 childSection 会渲染到请求中。顶层会话使用 section（包含编排策略），子会话使用 childSection（仅包含工作政策）。
请求拦截：插件使用一个前置的 agent/request waterfall 监听器来替换请求的推理层级，确保无论模型选择器如何设置，实际请求的 effort 都被锁定。
继承机制：子代理通过 parentSession 解析父会话，获取锁定值和工作政策。生成的分支（Forks）仅通过种子前缀继承，无法接收后续的层级切换。

注意事项与边界¶

依赖版本：必须使用 @deepseek-ai/dsh-* >= 0.1.0-rc.6。
继承规则：继承仅增加内容，子代理没有用户命令表面，无法通过子代理退出 Ultra Tier。
显示与真理：Picker 的同步仅为了显示一致性；请求端的 pin 才是真理。在 Ultra 模式下手动更改 Picker，下次切换时会重置，但当前请求仍保持锁定。
模式隔离：Ultra 模式不触碰 Plan Mode，两者是独立记录的状态。
提供者限制：默认策略要求模型在提供商并发限制下进行“窄波”重试，但实际的扇出能力取决于提供商本身。

总结¶

dsh-ultracode 为 DeepSeek Harness 提供了一套标准化的“深度推理 + 编排”方案。它通过插件机制在不修改核心框架的情况下，解决了开发者对单次会话推理深度和策略执行的强制控制需求。