意图导航器 Zhu755873628/intent-navigator-dsh

DeepSeek Harness 的意图导航器

DeepSeek Harness 任务入口插件的早期实现。它新增任务简报工具、导航策略、步前状态上下文，以及执行前授权闸门。

当前里程碑

已实现并通过测试：

- Cordis 打包与插件生命周期；
- 导航状态机；
- 清空任务的快速放行策略；
- intent_status；
- intent_prepare_brief；
- intent_authorize；
- 授权绑定到确切的简报修订版；
- 简报修订后自动失效授权；
- 步前导航上下文注入；
- 授权前，对有副作用或未知工具执行 fail-closed 闸门；
- 授权后放行至下游 DSH 策略。

尚未达到生产可用：

- 持久化 SQLite 存储（当前存储为进程内存）；
- 以密码学方式或可验证方式把 explicit_user_confirmation 绑定到 DSH User Questions 回复；
- 完整的 intent_assess schema 与诊断持久化；
- 可配置的工具分类与模式；
- 自定义 Web 任务简报卡片；
- 针对 DSH 0.2.0-rc.2 以上版本的兼容性测试。

环境要求

- Node.js ^22.19.0 或 >=24.0.0；
- DeepSeek Harness 包版本系列 0.2.0-rc.2；
- @deepseek-ai/cordis ~4.0.4。

DSH 目前是开发者预览版。本包有意锁定一个经过测试的发布版本系列。

开发

npm install
npm run typecheck
npm test
npm run build
npm pack --dry-run

本地安装

构建并打包：

npm install
npm run build
npm pack

然后把生成的 tarball 安装到 DSH 配置档：

dsh plugin --profile web add /absolute/path/to/intent-navigator-dsh-plugin-0.1.0.tgz

安装完成后重启该配置档。不要把此原型当作生产、破坏性、财务、凭据或发布操作的唯一审批边界。

架构

插件只使用 DSH 公开的扩展点：

- ctx.systemPrompt.section()：稳定的导航策略；
- agent/pre-step：模型可见的持久导航快照；
- ctx.tools.register()：任务简报与状态操作；
- tools/pre-execute：保持顺序的策略闸门。

放行的调用一律通过 next() 委派，因此 DSH 沙箱、审批及其他工具策略仍是最终权威。