dsh-advisor

English | 中文

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

一条命令即可安装（pnpm ≥ 10 需要一次构建放行步骤 —— 见安装）：

dsh plugin --profile web add github:btspoony/dsh-advisor   #  = 你的 profile 名；用 # 钉住 commit

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

安装

一条命令的 git 安装

dsh plugin --profile web add github:btspoony/dsh-advisor   #  = 你的 profile 名；用 # 钉住 commit

git 安装拉取的是源码而非构建产物，因此组合包会在安装时自行构建（prepare 自建）。pnpm ≥ 10 默认拦截 git 依赖的 prepare：第一次 add 会报 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED，pnpm 会打印出确切的包 key —— 在 profile 的 pnpm-workspace.yaml 中放行构建（onlyBuiltDependencies: [dsh-advisor]，或运行 dsh plugin --profile web approve-builds），然后重新执行 add。请把这次放行当作它本来的样子：允许该包的代码在安装时于你的机器上执行；并钉住 commit（#），这样之后的 push 无法悄悄改变实际运行的代码。

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

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）。未知配置键会被拒绝。