DSH Plugins
返回列表
🧩

dsh-observability

admin-security 更新于 2026.08.20

在终端中运行以下命令:

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 落盘的开发者
  • 使用治理套件、需要统一诊断视图的安全审计人员