前言¶
DeepSeek Harness（DSH）采用插件化架构。在开发治理套件时，追踪各插件的执行状态对于排查问题至关重要。dsh-observability 旨在解决治理插件日志分散、难以统一查看的问题。它为 Claw suite 提供了一套共用的诊断日志方案，并在 Web 设置页面中集成了运行诊断功能，方便开发者快速定位执行流。
插件定位¶
该插件由 xingyingyuzhui 维护，属于 admin-security 类别。它不直接运行智能体，而是作为一套基础设施，供其他插件调用以记录操作终态。
核心功能¶
- 共用诊断日志：治理套件内的插件通过统一的接口记录日志。
- 可视化诊断页：在 Web 设置界面提供「运行诊断」页面。
- 时间线查询：支持按错误码或
traceId查看事件的时间线视图。
安装与启用¶
执行以下命令安装插件：
dsh plugin --profile web add github:xingyingyuzhui/dsh-observability
安装完成后重启 dsh web。启动后进入设置页面，在「审计」附近即可找到「运行诊断」入口。
典型用法¶
- 写入日志：其他治理插件通过同级目录的
../dsh-observability/observe.mjs写入日志。 - 构建客户端：修改 Client 源码后，需执行
npm run build生成客户端文件。 - 查看日志：诊断日志默认落在
$DSH_HOME/agent-observe/diag.l。若写入失败，系统会将日志回退到stderr。
适用场景与注意事项¶
- 记录粒度：插件仅记录操作终态（
succeeded/rejected/failed/degraded），不记录内部函数调用的详细过程。 - 隐私保护：日志字段采用白名单机制，不记录 prompt、memory/identity 正文、工具参数或 token 等敏感信息。
- 权限与审计：该插件以当前 DSH 进程权限运行。安全审计功能仍由
dsh-agent-gate独立处理，日志写入agent-gate/audit.l，与诊断日志分离。
总结¶
dsh-observability 为 DeepSeek Harness 的治理套件提供了标准化的诊断入口。通过统一的日志记录和可视化的时间线查看，开发者可以更高效地追踪和定位问题。该插件基于 MIT 许可证开源。
