辅助调用运行时 Hilbert-beinghappy/dsh-plugin-auxiliary-runtime

Auxiliary Runtime

为 DeepSeek Harness 提供可取消的辅助模型调用、持久限额和来源清晰的用量账本。

项目概览

用量视图

运行时设计

快速开始

服务合同

验证

English · 中文

项目概览

dsh-plugin-auxiliary-runtime@0.1.1 是 DeepSeek Harness 的社区 Host 插件。它把可取消、无工具的辅助模型调用绑定到已有 Session，执行每个 Session 的用量策略，并通过官方 storageDomain 将用量写入独立账本。当前编译与元数据目标是官方 Host 0.1.1-rc.2；精确 Host 0.1.0-rc.8 仍受支持。

已发布的 0.1.1 tarball 在没有 SeekTTY、也没有 Clarify 时仍有独立价值：官方 web 上的 Typert Remote auxiliary-runtime/snapshot 与 auxiliary-runtime/cancel 可在 stock Host 0.1.1-rc.2 使用。同进程 run 仍只给其他 Host 插件。Clarify 与 SeekTTY 是可选消费者，不是安装前提。standalone T1 不会取代已发布的回滚联合基线。

Clarify 可以使用同进程 run 服务，在主 Session transcript 之外生成上下文问题、选项和持续演进的 Draft preview。SeekTTY 可以读取快照，并在能力健康时通过 /status 展示 Official、Auxiliary 和 Combined。

+----------------------+
| DeepSeek Harness |
| 已有 Session |
| 官方模型路由 |
+----------+-----------+

llm.prepareCall

v
+----------------+ +----------------------+ +----------------+
| Clarify | ----> | Auxiliary Runtime | ----> | Provider stream|
| 同进程调用 | run | 准入 / 限额 / 取消 | | usage chunks |
| Draft preview | request + reservation
signal, // 可选：调用方 AbortSignal })

run 接受三种请求模式之一：

- 静态 system / messages 与必填的四桶 reservation；
- 旧版同进程 buildRequest(preparedConfig) 与必填 reservation；
- prepareRequest({ config, context, adapterDefaults })，从同一份 prepared 元数据原子返回 { system?, messages, reservation }。

prepared 回调在 llm.prepareCall 后接收已经分离、冻结的结构数据。回调函数与产物留在进程内。getPolicy(sessionId) 和 setPolicy(sessionId, policy) 管理三个 Session 限额。

Typert Host

独立的 auxiliary-runtime Typert receiver 提供两个方法：

- auxiliary-runtime/snapshot — 只读 { official, auxiliary, combined, capability }
- auxiliary-runtime/cancel — 取消活跃调用并返回稳定状态

模型执行保留为同进程能力；HTTP 消费者可以读取用量快照和执行取消。

兼容与验证

当前编译与元数据目标是官方 DeepSeek Harness 0.1.1-rc.2，Node ^22.19.0 || >=24。精确 Host 0.1.0-rc.8 仍受支持。运行时使用以下公开 Host 服务：

- storageDomain.open / KvTable
- sessions.get 与 header.createdAt
- llm.prepareCall / prepared.stream
- sessionProjections.snapshot，只读 Official 用量
- Typert Host register，仅注册 snapshot 与 cancel

已发布回滚联合基线仍是精确 Host 0.1.0-rc.8。Auxiliary Runtime 0.1.1 已发布，并接纳精确 0.1.1-rc.2。无 SeekTTY、无 Clarify 的 stock web standalone T1 在校验和核验的 --write 跑完后记入 docs/t1-evidence/0.1.1-rc.2/；本仓库不手写该证据，也不把 0.1.1 升格为新推荐联合基线。Lane A（2026-08-21，未修改 stock 0.1.1-rc.2、隔离 DSH_HOME、真实 PTY、Auxiliary 0.1.1 + Clarify 0.2.2 + SeekTTY 1.2.1）：/doctor 0 error / 0 warning、99 plugins running；/status 健康；/clarify 路由到 Auxiliary 后无 key 返回 MISSING_CREDENTIAL 且保留 composer；Vision-Exp 可见且可选择；PNG 附件 /restart 成功恢复。丢失源文件恢复：单测保证失败文案只用 basename、覆盖两种通知顺序、绝对路径不进文案；真实 PTY hardcopy/可见区扫描只检出 ASCII basename vision-logo.png，未检出 private/tmp、/tmp、Users、Volumes。不能证明关闭无 key onboarding modal 后该 restore error 仍持续显示（Esc 也会清 notice）。Lane B（2026-08-22，未修改 stock 0.1.1-rc.2、隔离 DSH_HOME、candidate4）：已显式选择 Vision-Exp；PNG image-only 发送成功、发送即清附件并识别 logo，但纯图无问题导致模型又调用 read_image；真实 JFIF JPEG 经 SeekTTY 入队、官方 Host 正常转 PNG variant 后，无工具 OCR 成功；Clarify 经 Auxiliary 完成 6 轮动态问答、41 行完整审阅、二次确认 accept 回 composer 且不自动发送；/status 显示官方／辅助／组合用量；895 文件扫描 secret literal 为 0。这不是新的推荐组合，也不是完整联合验收。未证明 Web UI、GIF/WebP、超限拒绝、JPEG 原字节直通、PNG 完全不靠工具、本轮中断恢复、成本／缓存 A/B。Clarify 0.2.1 保持 0.2.0 的六方法 Remote、clarify.wire/1 和兼容边界。

Clarify 0.2.0 live-provider 联合验收覆盖真实模型动态澄清、多轮 Draft 演进、用户自主发送、中断恢复、用量来源和账本隐私。Clarify 0.2.1 发布后无 Key 验收重新下载并核对三包 Release 资产，在精确 0.1.0-rc.8 的 stock Profile 完成 add／boot／remove／re-add，/doctor 为 0 错误／0 警告、99 个插件运行，随后进入 running、路由到 Auxiliary，并按隔离环境预期返回 MISSING_CREDENTIAL。0.2.1 尚未重跑 live-provider 动态多轮，也没有 cache／cost A/B。

已发布回滚栈是官方 @deepseek-ai/dsh@0.1.0-rc.8、Auxiliary Runtime 0.1.0、Clarify 0.2.1 和 SeekTTY 1.2.0。

package.json#dshPlugin.testedHost 是编译钉 0.1.1-rc.2。dshPlugin.testedHosts 列出两个精确准入钉 0.1.0-rc.8 与 0.1.1-rc.2。Host 没有暴露版本值时，能力探测可以启动并报告 hostConfirmed: false；已知版本位于这两个钉之外时会被拒绝。

开发

pnpm install
pnpm test
pnpm typecheck
pnpm build
pnpm pack:check

pnpm typecheck 是官方类型门。official-contract 的运行时测试只钉住所安装包版本；该文件顶部的编译期 Assert 由 pnpm typecheck 检查。pnpm test 包含离线 T1 身份／schema 检查。真实隔离 Host 生命周期是 pnpm t1 -- --tgz --sha256sums --dsh-bin --write，不是 CI job。standalone T1 的 Host pin 权威是精确的 dsh --version 与 evidence.dshVersion。stock 0.1.1-rc.2 上插件内部版本报告为未确认（hostConfirmed=false）；这不是 host-confirmed。

发布资产是已发布的 0.1.1 tarball 与 SHA256SUMS。本次文档修正不创建新 Release。

许可

MIT