前言¶
在 DeepSeek Harness (DSH) 生态中，代理开发往往需要额外的判断逻辑。dsh-advisor 插件移植了 rpiv-advisor 子系统，为每个代理作用域提供了一个零参数的 advisor() 工具。它将完整的会话历史和工具清单转发给一个单独配置的评审模型，利用原始的 rpiv 系统提示词，返回计划、修正或停止信号，从而辅助主模型做出更准确的决策。
是什么¶
- 名称：dsh-advisor
- 描述：独立的 DSH 插件包，用于移植
rpiv-advisor子系统。 - 维护者：NexusAgentX
- 分类：模型推理
- 许可证：MIT
核心能力¶
- 零参数工具：作为一个工具注册在代理作用域中，无需为每个代理编写额外参数。
- 按需调用：由主模型决定何时调用
advisor()，不包含轮次观察者或自动注入机制。 - 历史转发：将完整的派生会话历史和工具清单转发给评审模型。
- 评审机制：使用原始 rpiv 系统提示词与评审模型交互。
- 结果处理：评审模型的输出（计划、修正或停止信号）作为普通工具结果返回。
- 配置灵活性：支持插件行配置、dsh Web 设置页面和
/advisor命令三种配置层级。
安装与配置¶
安装¶
使用官方提供的命令进行注册安装：
dsh plugin --profile web add dsh-advisor # <name> = your profile name
配置说明¶
插件默认处于关闭状态。启用时，必须配置 provider 和 model，否则工具将不被安装并报告禁用原因。配置项包括：
enabled：总开关，默认为false。provider：必填。评审模型的提供商路由。model：必填。评审模型的 ID。reasoningEffort：推理强度，默认为空（自动），支持minimal、low、medium、high、xhigh、max、off。systemPrompt：覆盖原始 rpiv 提示词，默认为空（使用内置）。guidance：执行器提示词覆盖，包含promptSnippet和promptGuidelines。disabledForModels：执行器黑名单，阻止特定模型看到advisor工具。
配置在三个层级上组合，后一层级会覆盖先前的配置：
1. 插件行配置：位于 cordis.patch.yml，作为基础层。
2. dsh Web 设置页面：在“插件配置”页面的 Advisor 卡片中修改，会写入 advisor 命名空间并覆盖插件行配置。
3. /advisor 命令：仅在当前会话生效，不会修改持久化配置。
使用方法¶
会话控制¶
启用插件后，可通过命令行控制会话中的行为：
/advisor：切换当前会话的 advisor 工具。/advisor on：在当前会话中启用。/advisor off：在当前会话中禁用。/advisor status：查看模型、强度、工具可见性及禁用原因。
工具调用¶
当主模型认为需要更强的判断时，它会主动调用 advisor() 工具。评审模型的返回内容是自由文本形式的计划、修正或停止信号。主模型读取该结果后继续执行，并将关键建议体现在下一条可见回复中。
注意事项¶
- 默认关闭：安装后需手动启用。
- 强制配置：启用时必须同时配置
provider和model，否则工具不可用。 - 配置校验：未知配置键会被拒绝；旧配置键
immuneTurns和maxDeltaMessages已被忽略。 - 依赖关系：依赖 peerDependencies，需确保环境满足依赖版本要求。
- 控制权：主要模型保持控制权，它决定何时调用
advisor()。 - 生态说明：该插件位于社区目录（skillhub.cn），与 DeepSeek 官方无从属关系。
