前言¶
DeepSeek Harness (DSH) 的插件化架构允许按需扩展能力。TaskWatch 是一个针对 DSH 的早期预览插件，旨在解决智能体执行过程中意图漂移的问题。在代理自主性提高的同时，微小的修改可能演变成偏离用户原始目标的重构，TaskWatch 通过分离用户请求、模型推理、执行证据和监督反馈来防止这种情况。
插件定位¶
- 一句话定位：User-intent tracking and agent supervision for DeepSeek Harness (DSH) · 用户意图监督与受控纠偏
- 维护者：cjx12036
- 解决的核心问题：保持请求、解释、证据和反馈分离，防止推断静默转变为新的指令。
核心功能¶
TaskWatch 维护任务的三个连接视图：
- Intent（意图）：原始用户消息、显式需求以及独立版本化的模型推理。
- Evidence（证据）：绑定任务的公共对话和工具证据，包括可见的缺口、超时、截断和过时结果。
- Supervision（监督）：将证据与任务意图进行比较的评估和建议。这些内容不替换用户话语，也不扩大授权。
侧边栏可以显示当前目标、要求、权衡、使用情况和报告。其私有监督聊天仅更新 TaskWatch 自身的理解，不会向主代理发送消息或重写主任务输入。
Coach 模式：仅在获得明确同意后可用。启用项目 Coach 后，新任务的同意对话框会明确披露可能会自动引导主代理偏离执行。接受该对话框即授予监督同意和任务 Coach 同意。之前绑定的任务需要在启用项目 Coach 后单独执行“同意 Coach”操作。
安装与配置¶
TaskWatch 从 GitHub 安装到 DSH 配置文件中。使用标准 web 配置文件进行安装：
dsh plugin --profile web add github:cjx12036/TaskWatch
安装完成后，使用正常的 DSH 启动命令重启 web 配置文件，然后打开 TaskWatch 侧边栏。如果需要诊断安装，可以确认包是否存在于配置中：
dsh --profile web --dump-config
使用步骤¶
- 打开 TaskWatch 并选择 Settings。
- 选择并保存监督提供商和模型，然后明确允许监督模型调用。仅保存这些设置并不会启用项目或任务。
- 启用当前项目的监督。
- 当 DSH 询问任务决策时，为特定任务选择 Enable supervision（启用监督）。如果已启用项目 Coach，请阅读其明确的 Coach 披露后再接受；该一次披露的决策同时也为新任务授予了 Coach 同意。跳过任务不影响后续任务。
- 在侧边栏中查看报告。根据需要暂停或恢复对任务的观察。
- 如果需要 Coach，请为项目明确启用它，并根据上述描述为每个适用任务授予 Coach 同意。
注意事项¶
- 早期预览：插件在 DSH
0.1.5-rc.3上进行了安装和侧边栏 UI 流程的烟雾测试，但未验证实时运行时生成和 Coach 行为。 - 环境要求：需要 DSH web 客户端和 Node.js
>=22.23.2。 - 监督范围：仅监督通过同意流程明确绑定的任务。
- 本地存储：默认本地存储为
~/.dsh/taskwatch/ledger.sqlite。通过设置DSH_HOME可更改路径（例如DSH_HOME="$HOME/.dsh-private"）。 - 远程访问：不支持对 TaskWatch 端点的远程访问。
结语¶
TaskWatch 提供了一种机制，让用户能够更清晰地看到智能体的推理过程与执行结果是否符合原始意图。对于需要在复杂工作流中保持代理行为可控的开发者，该插件提供了一个从“观察”到“主动干预”的中间地带。
