前言¶

在 DeepSeek Harness（DSH）里跑智能体时，模型往往会直接调用带副作用的工具，而「用户到底想做什么、是否已说清楚、能否执行」缺少统一入口。单靠系统提示或事后审批，难以在任务开始前形成可核对的任务简报（task brief），也难以在授权与简报版本之间保持一致。

Intent Navigator 是面向 DSH 的早期任务入口插件：在模型侧注入导航策略与 pre-step 状态，提供任务简报相关工具，并在执行前对未知或带副作用的工具做 fail-closed 门禁；授权通过后再交给 DSH 既有沙箱与审批策略。下文介绍其定位、已实现能力、安装方式与使用注意。

这是什么¶

• 名称：Intent Navigator for DeepSeek Harness（npm 包 @intent-navigator/dsh-plugin，当前版本 0.1.0）
• 维护者：Zhu755873628
• 分类：工作流（社区目录 SkillHub 归类）
• 仓库：github.com/Zhu755873628/intent-navigator-dsh
• 一句话：为 DSH 提供意图相关的任务简报工具、导航策略、pre-step 状态上下文，以及执行前授权门禁。

插件仅使用 DSH 公开扩展点（系统提示段落、agent/pre-step、工具注册、tools/pre-execute），允许调用时仍通过 next() 委托，不替代 DSH 沙箱与其它 tool policy 的最终权威。

核心功能（当前里程碑已实现）¶

README 标明以下能力已实现并测试：

1. Cordis bundle 与插件生命周期
2. 导航状态机（navigation state machine）
3. clear-task 快速通过策略（clear-task fast-pass policy）
4. 工具与状态
   - intent_status
   - intent_prepare_brief
   - intent_authorize
5. 授权与简报版本绑定：授权绑定到具体 brief revision；brief 修订后自动使授权失效
6. pre-step 导航上下文注入（pre-step navigation context injection）
7. 执行前门禁：对带副作用或未知工具，在授权前 fail-closed；授权后 pass-through 到下游 DSH 策略

尚未达到 production-ready 的部分（安装前宜心里有数）：

• 持久化 SQLite（当前 store 为进程内存）
• explicit_user_confirmation 与 DSH User Questions 回复的密码学/可验证绑定
• 完整的 intent_assess schema 与诊断持久化
• 可配置的工具分类与模式
• 自定义 Web task-brief 卡片
• 除 DSH 0.2.0-rc.2 外更广泛的兼容性测试

环境与依赖¶

• Node.js：^22.19.0 或 >=24.0.0
• DeepSeek Harness 包 train：0.2.0-rc.2（插件刻意 pin 在该已测 release train）
• @deepseek-ai/cordis：~4.0.4

DSH 仍处于 developer preview；README 要求不要将此原型作为生产、破坏性、金融、凭证或发布类操作的唯一审批边界。

安装与启用¶

官方 README 给出的本地安装流程是：先在本机构建并打 tarball，再安装到指定 profile。

1、克隆或下载源码后，在项目根目录安装依赖并构建、打包：

npm install
npm run build
npm pack

2、将生成的 tgz 安装到 DSH profile（示例为 web profile，路径须改为你机器上的绝对路径）：

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

3、安装后重启该 profile。

开发自检可用：

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

社区目录页：SkillHub - intent-navigator-dsh。目录为独立社区站点，与 DeepSeek / 幻方无官方从属关系；安装命令以 GitHub README 为准，勿凭仓库名自行拼接 dsh plugin add github:... 一类命令。

典型用法（架构层面的行为）¶

README 未给出单独的「对话示例脚本」，但说明了模型与运行时如何被引导：

1. 系统提示：通过 ctx.systemPrompt.section() 写入稳定的 navigation policy，约束任务入口行为。
2. 每步前上下文：agent/pre-step 注入可持久、对模型可见的 navigation snapshot。
3. 任务简报链路：模型可调用 intent_prepare_brief 形成 brief；用 intent_status 查看意图/导航状态；在 brief 稳定且满足策略后，通过 intent_authorize 获得与当前 brief revision 绑定的授权。
4. 工具执行：tools/pre-execute 作为保序策略门；未授权时，对 side-effecting 或 unknown 工具拒绝（fail-closed）；授权后放行，由 DSH 其它 policy 继续处理。

若 brief 被修订，先前授权会自动失效，需重新走授权，避免「旧意图 + 新操作」错配。

适用场景与注意¶

适合谁

• 在 DSH 0.2.0-rc.2 上开发工作流型智能体，希望在「动手改文件 / 调工具」之前，强制走任务简报与显式授权链路的开发者。
• 需要 pre-step 里持续可见导航状态、并与 tool pre-execute 门禁联动的场景。

务必注意

• 插件与 DSH 进程同权限运行；安装前应阅读源码与 MIT 许可证，自行评估风险。
• 存储为进程内存，重启后状态不持久；勿依赖其作为唯一安全边界。
• 星标与社区曝光不等于安全审计；破坏性操作仍应依赖 DSH 自带审批与运维规范。

结尾¶

Intent Navigator 把「意图澄清 → 任务简报 → 版本绑定授权 → 再执行工具」收拢为 DSH 插件内的一条任务入口链路，适合在工作流类 agent 里做原型验证。完整说明与 issue 见 GitHub 仓库，目录索引见 SkillHub 插件页。