前言¶
DeepSeek Harness (DSH) 通过插件扩展功能。在长会话场景下，模型可能会出现思考打转、回答复读，或者上下文质量明显下降。当需要将任务切换到新会话时，除了关注 token 消耗，更需要关注内容的退化程度。dsh-attention-health 插件从本地会话日志中检测退化信号，并在必要时建议交接，生成不依赖模型调用的交接文档。
这是什么¶
这是一个运行在 DSH 上的插件，主要解决长会话中的退化检测与任务交接问题。它不调用外部模型，完全基于本地日志进行规则判断。
核心功能分为三点：
1. 实时思考守卫：在生成过程中检测思考内容的复读或空转，命中时立即中止当前生成。
2. 会话健康自检：从日志推断会话的退化风险，给出健康评分和上下文占用情况。
3. 交接文档生成：机械生成交接用的 Markdown 文档，不使用模型总结，确保交接材料在模型不可靠时依然可靠。
安装与启用¶
安装插件需要使用 DSH 的 profile 参数。请确保 Node 版本满足要求（>= 22.19）。
dsh plugin --profile web add -w dsh-attention-health
注意事项：
* 命令中的 -w 参数不可省略，否则会报错。
* 安装完成后必须重启 DSH，插件行不会热加载。
* 如果 profile 的 pnpm 主版本与插件不一致，可能会报错。
典型用法¶
安装完成后，可以通过命令行工具对本地会话进行操作。
查看当前会话的健康状态：
node handoff.mjs --health
查看指定会话的健康状态（支持 ID 前缀）：
node handoff.mjs d346d3e8 --health
生成交接文档到文件：
node handoff.mjs -o HANDOFF.md
列出所有会话：
node handoff.mjs --list
生成交接文档并附带统计信息：
node handoff.mjs --stats -o HANDOFF.md
核心功能说明¶
1. 实时思考守卫¶
这是插件唯一会主动干预的能力。它会在生成过程中逐帧检测思考内容的复读或空转。一旦检测到疑似退化信号，守卫会立即中止本轮生成，不会提示“仅警告”或“关闭守卫”。这意味着如果误判了正常推理，用户无法通过设置关闭守卫，只能修改配置或卸载插件。
2. 会话健康自检¶
插件读取本地会话日志，计算上下文规模和有效占用。它会输出健康评分（例如 50 / 100），并指出思考异常（如打转、重复）的具体次数和现象。该功能完全离线运行，不联网也不额外调用模型。
3. 交接文档生成¶
这是插件的核心价值所在。它不调用模型来生成文档，而是从会话日志中机械提取结构化信息。生成的文档包含会话标识、当前目标、用户请求主线、各轮进度、涉及的文件、待办事项以及遇到的错误等章节。
注意事项与边界¶
- 误判处理：由于守卫命中即中止且无降级开关，如果发生误判（例如正常推理被判定为空转），只能通过修改配置或卸载插件来修正。
- 离线运行：插件只读本地会话日志，不联网，不额外发起模型请求。
- 生效时机：修改配置或安装后，必须重启 DSH 才能生效。
- 环境要求：仅支持 Node.js 版本 >= 22.19。
总结¶
dsh-attention-health 提供了一套本地化的解决方案，用于监控 DSH 长会话的质量退化。它通过立即中止退化生成和提供零模型的交接材料，帮助开发者在模型不可靠时安全地切换上下文。更多细节与源码可参考 GitHub 仓库。
