前言¶
在 DeepSeek Harness（DSH）里跑 Agent，会话日志会越积越多：token 花在哪、工具是否死循环、审批是否拖慢节奏，单靠汇总数字往往看不出「该改什么」。常见做法是翻原始 jsonl，或凭感觉调 profile，成本高且难复现。
agent-clinic（Agent 体检诊所）面向同一类问题：只读扫描本机 Agent 会话，用可逐条复核的证据标出体验类异常，并为每条问题给出可执行处方。维护者为 GitHub 用户 1687210989，在 DSH 社区目录中归类为工作流插件；仓库采用 MIT 许可证，当前 package 版本为 0.2.0，要求 Node >= 22.15。
下面介绍它的定位、能力、安装方式与典型用法。事实以仓库 README 与 package.json 为准。
这是什么¶
一句话：本机 Agent 的「体检报告」生成器——统计之外，强调证据定位（含 session.v4.jsonl.zstd#L… 与 ./run.sh show 复核命令）和处方（YAML 片段、斜杠命令、插件安装入口或明确说明无解）。
它不做的事也在 README 中写清：不主动推送、不代你安装、不改配置、不诊断代码质量、不把对话发到外部。
核心功能¶
证据 + 处方，而非空泛建议¶
- 问题描述会落到具体会话与时间窗口，例如死循环会写明「同工具 + 同参数 + 同错误 ≥3 次」，并给出日志行号。
- 处方会读取本机真实配置，写出「当前值 → 建议值」；若当前已不弱于建议，会在「已评估但未给出的处方」中说明撤回原因。
- 从未实现或样本不足的维度会在报告中单独列出，避免与「未检测到异常」混为一谈。
22 项诊断维度（均已实现）¶
README 将指标分为 token/上下文（C 系列）、执行与工具（E/N 系列）、资产与模式（A 系列）、跨会话（K1/K2）等。节选如下：
| 类型 | 示例 ID | 含义（简述） |
|---|---|---|
| 高严重度 | C1 | 单位请求 output 超其余主会话基线 2 倍，且总量 ≥2 万 |
| 高严重度 | E1 | 同工具、同参数、同错误重复 ≥3 次（死循环） |
| 高严重度 | N2 | 命令类工具命中高风险模式（如 rm -rf、reset --hard） |
| 中严重度 | C5 | 单会话压缩 ≥3 次，并给出 DSH 实测释放 token（shadowedTokenCount） |
| 中严重度 | N3 | 审批请求 ≥5 次，分列被拒 / 结果无法识别 / 无对应决定记录 |
| 跨会话 | K1/K2 | 基于本地加盐指纹快照 ~/.agent-clinic/text-fingerprints.json（正文不落盘；可用 fingerprints --clear 或 AGENT_CLINIC_NO_FINGERPRINT_STORE=1 关闭） |
同类型问题在多会话命中时会合并为一张卡并标「N 处」，展开后仍保留各处的会话与证据。完整阈值与判定口径见仓库 docs/diagnostics.md。
处方与插件推荐¶
处方类型包括：行为建议、改 profile patch、安装/启用社区插件等；会检索插件目录并按能力标签与关键词匹配，标注来源（人工核实 / npm / GitHub），已安装插件不再推荐。
DSH 插件形态¶
安装为 DSH 插件后，侧边栏有「体检」入口和全页面板，并支持准实时角标。CLI 侧支持 scan、report、show、处方反馈（如 ./run.sh rx reject <目标 ID>）。本地冒烟自检为 345/345（README 徽章说明以 CI 徽章反映 GitHub Actions 实况）。
安装与启用¶
DSH 社区目录页：https://www.skillhub.cn/plugins/1687210989/agent-clinic
源码仓库：https://github.com/1687210989/agent-clinic
装为 DSH 插件¶
在 Harness 侧边栏打开 插件 → 添加插件，粘贴仓库地址：
https://github.com/1687210989/agent-clinic.git
装完后必须完全退出并重启 Harness——插件仅在启动时装载。
装为 Skill（可选）¶
一行命令安装，无需克隆仓库：
curl -fsSL https://raw.githubusercontent.com/1687210989/agent-clinic/main/install.sh | bash
典型用法¶
在插件目录或 Skill 安装路径下，可用仓库提供的 ./run.sh（或 npm run report 对应 node src/cli.mjs report）生成报告。
生成体检报告：
./run.sh report
报告包含扫描概览、按严重度排序的问题类（每处含结论、影响估算、置信度、证据定位与复核命令）、处方清单，以及「未检测到的维度」「尚未实现的维度」等节。复核单条证据示例：
./run.sh show "…/session.v4.jsonl.zstd#L3"
配置类处方针对的本机 patch 路径在 README 示例中为 ~/.dsh/profiles/desktop/cordis.patch.yml（工具只读，不代改）。
适用场景与注意¶
适合谁：长期在 DSH 上使用 Agent、需要系统化排查 token 浪费、工具死循环、审批摩擦、skill/MCP 闲置、跨会话重复提问等体验问题，且愿意根据证据自行改配置或行为的开发者。
权限与安全：插件以当前 DSH 进程权限只读访问本机会话与配置；安装前请阅读仓库源码与 MIT 许可证。K1/K2 涉及本地指纹快照，若不接受本地存储用户文本哈希，可关闭指纹存储。
平台范围：README 标明 DSH 会话解析、报告与插件 UI 为可用状态；WorkBuddy 平台为待实现。
生态说明：DSH 奉行「一切皆插件」；skillhub.cn 上的插件目录为社区站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
agent-clinic 把 Agent 使用分析从「一堆数字」拉到「可复核证据 + 可执行处方」，并如实标注未实现维度与样本不足情况。若你已在用 DSH，可按上文添加插件并重启 Harness，再跑 ./run.sh report 对照本机会话做一次体检。
