dsh-advisor
定义与身份
dsh-advisor 是 DSH 的一个 AI 审阅插件,定位不是独立应用,而是挂在 DSH 主会话旁边的辅助审阅层。来源文章没有展开 DSH 的完整定义,但明确把 dsh-advisor 描述为可安装到 DSH 的 web 与 dsh-tui 两套前端中的插件。
它的核心作用是给主 AI 会话“挂第二个模型”:主 Agent 继续负责执行用户任务,副模型只在每一轮对话结束后旁观主对话,并返回一条分级建议。这个设计面向长任务、多文件代码修改、方案复核等场景,目标是减少主 Agent 在中途偏离用户要求、绕圈或沿错误方向继续推进的问题。
因此,dsh-advisor 更接近一个“第二双眼睛”或“副驾驶”,而不是替代主 Agent 的执行器。
角色职责
dsh-advisor 的职责边界很窄:
- 读取主会话在当前轮次结束后的上下文;
- 让旁观副模型判断主 Agent 的回答、计划或行动是否存在质量问题、实质风险或明显错误方向;
- 按严重程度输出一条建议;
- 将建议以带 advisor 前缀的形式返回给主流程或用户界面。
它不负责:
- 直接完成用户交给主 Agent 的任务;
- 替主 Agent 调用工具;
- 操作文件、命令行或外部资源;
- 以主 Agent 身份发布命令;
- 批准或否决主 Agent 的动作。
这种职责划分对应来源文章强调的 Advisory only AI 审阅边界:副模型只能建议,不能接管。
旁观式副模型审阅机制
dsh-advisor 使用的是一种 旁观式 AI 副模型审阅机制:主会话正常推进,副模型作为独立调用在每轮结束后查看主对话。它不插手主任务的执行过程,只在轮次边界给出审阅意见。
来源文章举例说明了它要解决的问题:AI 写代码时可能一口气改多个文件,用户没有逐步检查,半小时后才发现从第三步开始方向已经偏了。dsh-advisor 试图让这种偏差在更早的轮次被指出,例如提醒“这里跟用户的要求对不上”。
建议分级
dsh-advisor 的建议分为三档:
| 级别 | 含义 | 典型范围 |
|---|---|---|
| nit | 小毛病 | 风格、表述、质量层面的细节建议,例如某段代码可以抽成函数 |
| concern | 实质风险 | 存在较重要的问题,或有更好的方向,值得继续前先权衡 |
| blocker | 阻断级问题 | 继续推进明显有问题,例如与用户明确指令冲突、原地绕圈、根本方向错误 |
来源文章还提到不同级别的注入方式不同:nit 属于不打断式注入,会到下一轮边界才被消费;concern 和 blocker 会主动“拨一下”主 Agent,提醒其关注更严重的问题。
每条建议都会带有类似 [advisor:concern] 的前缀,明确标识自己来自 advisor,而不是伪装成主 Agent 的原生命令。
Advisory only 原则
dsh-advisor 的一个关键边界是 Advisory only,即“只提供建议”。
在这个原则下:
- 副模型不执行主任务;
- 副模型不批准主 Agent 的动作;
- 副模型不否决主 Agent 的动作;
- 副模型不以主 Agent 的口吻发号施令;
- 副模型只能提出带 advisor 前缀的建议。
这个边界的意义在于:dsh-advisor 可以指出风险,但最终流程仍由主 Agent 和用户控制。它不会变成第二个会抢控制权的 Agent。
零工具独立调用
dsh-advisor 将副模型设计为“零工具”的独立模型调用。副模型没有工具权限,不能直接操作文件、运行命令、访问外部资源或修改项目状态。
这种设计降低了副模型出错时的破坏半径:即便副模型判断错误,也只能输出一条建议,不能直接把错误行动落实到系统或代码库中。
可靠性保护
来源文章提到 dsh-advisor 为副模型调用设置了多层保护,包括:
- 发送守卫;
- 发出一条建议之后的冷却轮数 immuneTurns;
- 失败策略。
其中 immuneTurns 在来源文章中标注为默认 3,含义是发完一条建议后有若干轮冷却,避免副模型过于频繁地插入建议。
失败策略的边界也很明确:如果副模型抽风、配额耗尽、接口异常或调用失败,不会卡住主流程,也不会污染主 Agent 的执行路径。故障只影响 dsh-advisor 自己的待发队列,最多丢掉它那一小段待发内容。
换言之,主流程的可用性优先于审阅插件本身的可用性。
配置与状态检查
dsh-advisor 的配置有一个硬性门槛:provider 和 model 必须填写。只要少填一个,或字段为空,副模型就不会被调用。
这个限制的目的不是减少功能,而是避免用户在不清楚使用哪个模型的情况下产生额外模型调用费用。
常用命令包括:
/advisor status
/advisor status 用于查看 dsh-advisor 是否在运行、正在使用哪个模型、有没有丢消息,以及在未启动时显示原因。
会话级模型切换命令为:
/advisor model set <provider>/<model>
该命令只临时影响当前会话,不修改全局配置。
安装方式与前端差异
来源文章给出的安装命令分别面向 web 与 dsh-tui 两套前端:
dsh plugin --profile web add dsh-advisor
dsh plugin --profile dsh-tui add dsh-advisor
安装后还需要在插件页打开对应开关。来源文章把这个开关称为“总闸”:安装插件本身不等于已经启用,插件页开关打开后才会实际运行。
两套前端的主要差异是:web 端额外支持下一句问题预测,而 dsh-tui 没有该功能。
网页端下一句问题预测
dsh-advisor 在网页端支持下一句问题预测:每轮结束后,它会猜测用户下一句可能要问什么,并在网页输入框下方给出一条可一键采纳的提示。
用户可以通过两种方式采纳预测:
- 点击提示;
- 在输入框为空时按右箭头。
如果预测不准,该功能会安静失败,不打扰主流程。来源文章明确说明该功能是纯网页端功能,TUI 中没有。
成本、隐私与限制
dsh-advisor 会额外调用一个模型,因此会产生额外账单。它不应被理解为免费附加功能。
隐私方面,来源文章提到 README 明确说明审阅内容没有做脱敏:如果主对话里包含密钥等敏感信息,这些内容也可能随审阅上下文一起发送给副模型。因此,用户应选择自己信任的审阅模型,并避免把不应外发的信息放入主对话。
来源文章还列出了当时版本的限制:
- dsh-advisor 是从 omp 的 advisor 子系统移植而来的 MVP;
- 单个会话只能有一个副模型;
- 没有会话内面板;
- 没有成本统计;
- 长会话会按窗口截断早期上下文。
这些限制说明 dsh-advisor 的定位仍是轻量审阅插件,而不是完整的多 Agent 编排平台。
适用与不适用场景
dsh-advisor 适合以下用户或任务:
- 让 AI 跑长任务的人;
- 让 AI 修改多个文件、担心中途跑偏的人;
- 做代码审查、方案复核、需要第二双眼睛的人;
- 手上有便宜、快速模型,希望把它当审稿人使用的人;
- 对多模型协作感兴趣的人。
它不太适合:
- 只想进行简单一问一答的用户;
- 对额外 token 或模型调用费用非常敏感的用户;
- 不能接受主对话内容被发送给另一个审阅模型的场景。
来源案例:今日头条文章中的介绍
来源文章为《DSH :给 AI 配个旁观的第二大脑,每轮对话都有人帮你看一眼》,发布站点为今日头条。该文以插件体验介绍的方式说明 dsh-advisor 的工作方式、建议分级、配置门槛、安装命令、网页端预测功能和限制。
文章还提到,作者用固定种子的真随机方式从一千多款插件中抽中了 dsh-advisor;在该来源的描述中,它不是榜单前三的百万级明星工具,而是“五千量级”的小众工具。这个数据反映的是来源文章中的抽样和热度语境,不应扩大为 dsh-advisor 的通用性能指标或长期用户规模。