🧩

dsh-plugin-diagnostics

admin-security 更新于 2026.10.18

在终端中运行以下命令：

dsh plugin install Kerberos255/dsh-plugin-diagnostics

将以下提示词粘贴到 DeepSeek Harness 对话框中：

在 DeepSeek Harness 中于承载插件的 profile（例如 desktop）执行 dsh plugin install Kerberos255/dsh-plugin-diagnostics 安装本插件；源码见 https://github.com/Kerberos255/dsh-plugin-diagnostics，修改插件代码后需重启主机。

插件介绍

在 DeepSeek Harness 里跑多个插件时，启动失败、工具结果异常或定时任务悄悄变了，往往只能靠猜。dsh-plugin-diagnostics 提供一套可选的 JSONL 诊断服务，在明确不采集对话正文、凭证和敏感 HTTP 内容的前提下，把受控的生命周期与错误元数据写下来，方便你对照排障。

它会记录支持插件的启动与停止、白名单内的事件名与元数据（如状态、耗时、安全错误码、已识别的工具名），以及插件通过 pluginDiagnostics.record 主动上报的错误。定时任务只会收到「有变更」的通知，不会落盘任务内容或指令。未接入诊断的插件照常工作，主机检测到服务后其他插件即可使用，无需单独控制台。

日志按日写入 DSH_HOME 下目录，单插件每日容量与保留天数都有上限；目的地不可写或已满时会静默丢弃条目，以免阻塞你的正常任务。诊断信息刻意保持稀疏，不能还原完整会话，也不能替代在真实主机上的联调测试。

适合插件作者、平台维护者，以及需要在生产环境做有限可观测、又必须守住隐私边界的团队。分享日志前请阅读 SECURITY.md，即便白名单元数据也可能暴露运行节奏。