前言¶
在 DeepSeek Harness（DSH）里跑治理类插件时，问题往往出在「某次操作到底成功、拒绝还是降级」——若每个插件各自打日志、字段又不统一，排查只能翻 stderr 或临时加 print。DSH 社区生态按「一切皆插件」组织，目录站点与 DeepSeek / 幻方无官方从属关系；治理向能力通常还会和安全审计（例如 agent-gate 的 audit 流）分工。下面介绍维护者 xingyingyuzhui 发布的 dsh-observability（SkillHub 分类 admin-security，目录条目可能显示为 dsh-claw-observability）：为 Claw 治理套件提供结构化诊断日志和 Web 端 设置 → 运行诊断 页面，其它插件通过同级 observe.mjs 写入，本插件负责汇总展示。
这是什么¶
dsh-observability 是面向 DSH Web 配置的插件（dsh.client.platform: web），版本 0.2.0，MIT 许可证，要求 Node.js >= 20。它不做安全审计本身——审计仍由 dsh-agent-gate 写入 $DSH_HOME/agent-gate/audit.jsonl；本插件专注操作终态诊断，并支持按错误码、traceId 查看时间线。
核心功能¶
共用 observe 接口¶
其它治理插件通过同级的 ../dsh-observability/observe.mjs 写诊断。包对外导出还包括 ./observe、./codes 等（见 package.json 的 exports）。
运行诊断页¶
安装并重启 dsh web 后，在 设置 → 运行诊断（位于「审计」旁边）查看汇总与时间线。
写入规范（README 约定）¶
- 只记操作终态，不记每次内部函数调用。
- 终态取值只能是：
succeeded/rejected/failed/degraded。 - 字段白名单：不写 prompt、memory/identity 正文、工具参数、token。
- 诊断落盘路径：
$DSH_HOME/agent-observe/diag.jsonl；写入失败时退回 stderr。
安装与启用¶
官方 README 给出的安装命令如下（需 Web profile）：
dsh plugin --profile web add github:xingyingyuzhui/dsh-observability
装完后重启 dsh web，再打开设置里的运行诊断页。
若你改动了 Client 源码，在项目内执行：
npm run build
不要手改生成的 client.js；可用 npm run build:check 与 npm test 做构建校验与测试。
典型用法¶
- 安装本插件并重启 Web。
- 在其它治理插件代码中引用
observe.mjs，按上述规范记录每次操作的终态与允许字段。 - 在 设置 → 运行诊断 中按错误码或
traceId拉时间线，与安全审计页（agent-gate）对照排查。
具体调用示例以各治理插件仓库为准；本包提供的是共享存储与展示，而不是替代各插件的业务逻辑。
适用场景与注意¶
适合：已在用或计划用 DSH Claw 治理套件、需要在 Web 里统一看结构化诊断、且愿意遵守终态与白名单字段约定的开发者与运维。
注意：
- 插件以当前 dsh 进程权限运行；安装前请自行审阅 GitHub 源码 与 MIT 许可证。
- 诊断日志与 agent-gate 审计日志职责不同，不要混为一谈。
- 社区目录页：SkillHub - dsh-claw-observability；安装命令以 README 中的
github:xingyingyuzhui/dsh-observability为准。
结尾¶
dsh-observability 把治理插件的诊断收成一条 diag.jsonl 和一页运行诊断 UI，减少「各写各的、字段对不上」的排查成本。需要插件详情时可查 SkillHub 目录与 GitHub 仓库 README。
