dsh-logbook
在终端中运行以下命令:
dsh plugin install d3vmeh/dsh-logbook
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 终端中运行 dsh plugin install d3vmeh/dsh-logbook 即可安装,源码位于 https://github.com/d3vmeh/dsh-logbook 。
插件介绍
dsh 的每个插件都通过 ctx.logger 记录日志,但框架默认只提供一个 1000 条的内存缓冲区,而这个缓冲区会静默丢弃 warn 和 debug 级别的记录。这意味着插件可以针对真实问题发出警告,开发者却既看不到实时输出,也无法事后回溯——问题就这样悄无声息地消失了。
dsh-logbook 注册了一个全量捕获的导出器,为你打开两个观察窗口:一是 stderr 实时输出,默认只透传 warn 和 error,健康会话保持安静,也可以按插件单独放宽级别;二是聊天中的 /logs 命令,维护一个 2000 条的环形缓冲,覆盖所有级别,并支持按类型过滤。它从不写入 stdout,确保 SDK 和 ACP 协议通道畅通;stderr 端还挂了错误监听,管道因下游进程退出而关闭时不会拖垮 dsh 主进程。
如果你习惯在终端里跑 dsh、不想额外开浏览器或 web 面板,又需要随时确认插件是否报过警、出过错,dsh-logbook 就是最轻量的选择——纯终端加聊天,无 web 依赖,无头环境下也能正常工作。
使用场景
- 插件抛出警告后立刻在终端确认具体内容
- 无头 CI 环境中排查插件报错却无法打开浏览器
- 会话结束后回看最近 2000 条日志定位间歇性问题
适合人员
- 日常在终端运行 dsh 脚本的开发者
- 编写 dsh 插件、需要调试日志输出的插件作者
- 在无 GUI 服务器或 CI 流水线上部署 dsh 的运维工程师