启动诊断器Mide69/dsh-boot-doctor

dsh-boot-doctor

一个 DeepSeek Harness 插件。挂载一个控制台日志出口，并对那些解析成功、通过配置校验、但一直没有激活的插件发出警告。

为什么需要这个插件

DeepSeek Harness 底层的插件框架 Cordis，ctx.logger 是一直存在的。但如果没有注册任何 exporter，整棵插件树里所有的 ctx.logger.warn(...) 调用都会被静默缓存，永远不会打印出来。官方发布的 profile（headless、web）默认都没有挂载控制台 exporter。

实际后果是：一个插件可以正确安装、配置校验通过，然后就是不激活，最常见的原因是某个 inject 依赖没有满足，或者一次配置加载失败被 try/catch 吞掉了。不打印任何东西，也不报错崩溃。这个插件就是安静地失效了，从外部完全看不出来。

这个插件解决了这两半问题：

1. 在 ctx.logger 上注册一个最简单的控制台 exporter，这样所有插件已有的日志调用都会变得可见，不只是这个插件自己的。
2. 挂载几秒钟后，扫描 loader 的 entry 列表，找出所有已经解析验证过、但没有激活 fiber 的条目，为每一个卡住的条目打印一行清楚的说明。

安装

npm install dsh-boot-doctor

使用

在 profile 的 patch 里把它放在最前面，这样它会在其他插件挂载之前就开始记录日志：

- insert:
- id: boot-doctor
name: dsh-boot-doctor

dsh --profile headless --patch patch.yml "your task"

配置

| 字段 | 默认值 | 含义 |
| --- | --- | --- |
| checkDelayMs | 5000 | 挂载后等待多久开始扫描卡住的条目。 |
| logEntryInit | false | 是否也记录每个条目的挂载，而不只是那些一直没激活的。 |

- insert:
- id: boot-doctor
name: dsh-boot-doctor
config:
checkDelayMs: 8000
logEntryInit: true

这个插件不做什么

它不会修复根本的激活问题，只是让问题变得可见。它不会读取插件源码去诊断具体是哪个 inject key 缺失，因为那需要伸手进框架内部，而这个包刻意不依赖那些内部实现。它只会告诉你是哪个插件 id 和名字卡住了，让你知道该从哪里查起。

许可证

MIT