本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-advisor

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-advisor

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 每个会话一个独立评审者：独立的模型调用观察主 transcript 并评审每个 stepped 主 turn；advisor 消息被排除在此后的 delta 之外，因此 advisor 永远不会读回自己的建议。
• 显式模型门禁：enabled 默认关闭；enabled: true 而缺少 provider + model 时绝不发起模型调用——状态报告 disabled-with-reason。未知配置键会被拒绝。
• 零工具的最小启动：评审者只是一个独立的模型调用——无 advisor tools，除了 advisory 消息之外它无法对会话做任何事。
• 不卡主循环的失败策略：失败或 quota 耗尽的 advisor 只会丢弃自己有界的 backlog——永远不会卡住或污染主循环。
• 会话级控制：/advisor on|off|status|config 按会话工作；开关是临时的 override，从不修改持久化配置。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

启用后 advisor 会替主 agent 决定下一步该做什么吗？

不会。advisor 只通过带 [advisor:{severity}] 前缀的 user-role 消息表达建议，主 agent 收到后自行权衡；advisor 不会批准或否决任何动作，也不会冒充主 agent 发命令。

advisor 模型调用失败会卡住主会话吗？

不会。每次 advisor 调用都有 60 秒超时；transient 错误 1 次重试后丢弃，连续 3 次丢会清空自身积压，quota/rate-limit 进入暂停态（需 /advisor on 手动恢复），永久错误进入 halted（需 /advisor on 重建）。主循环在任何情况下都不会被阻塞。

已经在 Settings 里勾了 enabled，为什么 advisor 还是没动静？

必须是 enabled: true 且 provider 与 model 都填了非空字符串才会真正发起模型调用；缺一个就会被显式门禁挡下，状态显示 disabled-with-reason（/advisor status 看原因）。Settings 卡片会在保存时阻止这种不合法组合。

advisor 会不会把自己发出的建议再读回去循环评审？

不会。advisor 自己注入的消息带 source.kind === 'advisor' 标记，转录增量渲染器会从下次 delta 里排除这类消息，advisor 永远读不回自己的建议。

如何在 quota 耗尽后恢复被暂停的 advisor？

在会话里发 /advisor on 即可手动恢复；被永久错误 halt 的会话，发 /advisor on 会销毁当前 runtime 并新建一个。这些切换只影响当前会话，不会改持久化配置。

配置文件改完要重启 dsh 才生效吗？

不需要。Settings 卡片、TUI /settings 屏幕或 cordis.patch.yml 的更改通过 settings namespace 的 live 源读取并实时重新应用；只改 immuneTurns / maxDeltaMessages 等数值时连在途调用都不会被打断。

卸载这个插件需要做什么？

插件是纯挂载——安装时只通过 cordis.patch.yml 插入一行 id: advisor，没有 dsh 源码补丁也没有 postinstall 脚本。卸载时把那一行从 profile 的 patch 文件里删掉，重启 dsh 即可。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.1-rc.2+
• Node: >=22.19.0（同时支持 >=24）

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则