dsh-advisor

English | 中文

一个移植 omp「advisor」子系统的独立 dsh 插件组合包：一个按会话运行的评审模型，观察主会话 transcript，用显式配置的模型（provider 与 model 均为必填）评审每个已完成的 stepped turn，并把按严重度排序的建议（nit / concern / blocker）注入回会话 —— 不污染主循环，也不递归地评审自己。

一条命令即可安装：

dsh plugin --profile web add dsh-advisor   #  = 你的 profile 名

仅作建议。 advisor 从不批准或否决主 agent 的动作，也绝不会像主 agent 那样发出命令。每条送达的消息都是自我描述的 advisory 内容；一个行为异常的评审者会被端到端约束（emission guard、immuneTurns 冷却、failure policy），因此它永远不会卡住或污染主循环。

安装

一条命令的 registry 安装

dsh plugin --profile web add dsh-advisor   #  = 你的 profile 名

registry 安装拉取的是已发布的 tarball，其中自带构建产物（lib/ + cordis.patch.yml），因此不会运行 prepare 构建，也无需构建放行。运行时依赖（@deepseek-ai/cordis、@deepseek-ai/schemastery 与 @deepseek-ai/dsh-* peers）声明为 peerDependencies，由 dsh 安装的扁平 profile module fallback 解析——无需额外安装步骤。需要可复现安装时用 dsh-advisor@0.1.0 钉住精确版本。

本地目录安装（推荐用于开发 / 验证）

pnpm install                    # 构建组合包（prepare 自建）
dsh plugin --profile web add .  #  = 你的 profile 名

验证

dsh --profile web --dump-config   # 显示带 advisor 配置行的 "# == dsh-advisor" 层
dsh --profile web

tarball 安装与卸载见 docs/install.zh.md。

配置

advisor 默认关闭。启用后，provider 与 model 为必填：enabled: true 而缺少两者之一是一个硬门禁 —— advisor 不会发起任何模型调用，并报告带原因的禁用状态（disabled-with-reason）。未知配置键会被拒绝。

配置在三个配置面之间合成（后一层覆盖前一层；各处使用同一组键）：

1. 插件行 config —— $DSH_HOME/profiles/web/cordis.patch.yml（见下）。这是合成 base。
2. —— Advisor （id ，渲染在三张上游卡片 bash / agent-loop / web-search 之后），含 enabled 开关、只列出系统内已配置 provider 及其模型的 provider/model 选择框与可选字段。保存写入 settings namespace，覆盖插件行 config 而无需改动它。保存后新会话立即生效，无需重启（运行时 live 读取合成值）。需要当前版本的 dsh web 构建（其 web shell 声明了 卡片 slot 并能加载 声明包）。卡片通过读写该命名空间（ + ，由宿主的 typertGateway claims——与 dsh 内建 服务同一机制），该通道：进程内写入（）没有 exposed-namespace 检查。无需也不施加任何宿主补丁。