dsh-observability
在终端中运行以下命令:
dsh plugin install xingyingyuzhui/dsh-observability
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 终端中执行 dsh plugin install xingyingyuzhui/dsh-observability 完成安装,项目详情见 https://github.com/xingyingyuzhui/dsh-observability
插件介绍
当多个插件在治理套件中协同工作时,一次操作可能跨越多个模块,却缺少一条统一的时间线来还原究竟发生了什么。dsh-observability 正是为此而生:它提供一套共享的诊断日志协议(observe.mjs),让同级插件通过同一路径写入结构化记录,再将这些记录汇聚到「运行诊断」页面,按错误码或 traceId 过滤即可看到完整的操作序列。
设计上刻意做了减法。它只记录操作的终态——succeeded、rejected、failed 或 degraded——而非每一次内部函数调用。字段白名单确保敏感内容不会被写入日志:prompt 正文、memory 与 identity 内容、工具参数、token 一律不落盘。记录写入 $DSH_HOME/agent-observe/diag.jsonl,文件不可写时自动退回 stderr,不阻塞主流程。安全审计仍由 dsh-agent-gate 负责,两者职责清晰分离。
如果你正在运维 dsh 套件,需要在多插件链路中快速定位哪一步出了问题,又不想引入重型 APM 或让用户数据泄漏到日志文件里,这个轻量插件就是合适的选择。
使用场景
- 多插件链路出现故障时,按 traceId 回溯完整的操作时间线
- 审计操作终态(succeeded / rejected / failed / degraded),而非逐次函数调用
- 日志文件不可写时自动退回 stderr,不阻塞主流程
适合人员
- 运维 dsh 套件、需要在多插件协作中快速定位错误的团队
- 关注日志安全、不希望 prompt 正文或 token 落盘的开发者
- 使用治理套件、需要统一诊断视图的安全审计人员