dsh-plugin-log-bridge
在终端中运行以下命令:
dsh plugin install desanv01/dsh-plugin-log-bridge
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中执行 dsh plugin install desanv01/dsh-plugin-log-bridge,或通过应用的插件管理安装;源码见 https://github.com/desanv01/dsh-plugin-log-bridge。
插件介绍
DeepSeek Harness 把日志留在内存环形缓冲里,默认并不对外导出。进程若在「已就绪」之后仍失败退出——例如会话无法激活、预设挂载失败——环形缓冲会随进程一起消失,监督方往往只能知道「启动失败了」,却看不到原因;警告更糟,默认导出级别会把它们从环形缓冲里滤掉。
本插件挂接一个导出器,把每条 error 与 warn 写到 stderr(监督进程通常已在采集),并在加载前已缓冲的错误做一次回放;同时订阅 api-session/error,把从未进入 logger 的会话激活失败同样记下来。输出带 [harness-log] 前缀,堆栈在首行之下缩进;另有 60 秒内最多 100 条的限速,超限会单行说明丢弃条数。每次启动在 stdout 写一条 ready 行,便于判断桥是否已加载。各挂载步骤均包在 try 里,设计目标是诊断启动失败,而不是让桥本身拖垮启动。
适合在桌面应用、终端或由 systemd 等父进程托管 Harness 的场景:你需要在崩溃或异常退出后,从 stderr 里还原「为什么」而不是只有退出码。插件无 UI、无配置项、无模块级额外依赖,体量小,便于审计。
请注意:stderr 可能含提示词、路径、工具参数等敏感日志内容,插件不做脱敏;使用前请与对待会话日志一样谨慎。
使用场景
- Harness 在 ready 之后退出,需要从 stderr 还原会话或插件失败原因
- 由 systemd、容器或桌面壳进程托管 dsh,父进程只采集 stderr
- 启动阶段错误频发,需要限速避免 stderr 被同一条错误刷屏
适合人员
- 维护 Harness profile 与插件清单的开发者
- 打包或定制 DeepSeek Harness 桌面应用的团队
- 负责托管 Harness 进程并分析 stderr 的运维人员