vinoth4v/dsh-tool-council

dsh-tool-council

一个 DeepSeek Harness 插件，它为模型提供了一个
council 工具：把一个问题一次性抛给多个模型，每个模型使用不同的提供商，将每个
答案并排返回，然后由一个独立的主席模型报告它们在哪里达成一致，以及——更有用的是——
它们究竟在哪里产生分歧。

一个模型自信的答案是单个样本。而一个 council 会把有争议的判断变成你可以据以行动的、
可见的分歧。

Council: 5/5 members answered.

google/gemini-3.6-flash (2841ms)
...
groq/openai/gpt-oss-120b (1204ms)
...

Synthesis — nvidia/minimaxai/minimax-m3
Members 1-4 recommend REST; member 5 dissents for GraphQL. The split is a
weighting judgement, not a factual dispute: ...

设计

有三个决策让输出值得一读：

- 成员位于不同的提供商以及不同的模型家族。 同一个基础模型的两个检查点会以相同的方式
失败，因此它们的一致毫无意义。多样性才是全部的信号。
- 主席不是成员之一。 它从不给自己的答案打分。
- 失败的成员会被报告，而不是被抛出。 一个挂掉的提供商绝不能拖垮整个小组——这正是
一开始要轮询多个提供商的原因。成员并发运行，因此实际耗时是最慢成员的时间，而不是总和。

安装

需要一个可用的 DeepSeek Harness 安装（npm install -g @deepseek-ai/dsh），并在
$DSH_HOME/settings.yaml 中配置了至少两条提供商路由。

把它克隆到你正在安装的目标 profile 内部，然后注册它：

mkdir -p "$HOME/.dsh/profiles/web/plugins"
git clone https://github.com/vinoth4v/dsh-tool-council \
"$HOME/.dsh/profiles/web/plugins/dsh-tool-council"
cd "$HOME/.dsh/profiles/web" && dsh plugin --profile web add ./plugins/dsh-tool-council

位置很重要。dsh plugin add 会链接该包，而 Node 在查找依赖之前会把符号链接解析到其真实
路径——因此，位于 $DSH_HOME/profiles 之外的克隆无法看到
@deepseek-ai/dsh-llm 或 @deepseek-ai/dsh-tools，并会以 ERR_MODULE_NOT_FOUND 加载失败。
将克隆放在 profiles/ 下，可以让常规的父目录向上查找抵达 harness 自身的
profiles/node_modules，其中包含这两个包。

若想把检出放在别处（一个普通的项目目录），请手动将这两个对等包链接进去——
指向你的 harness 安装位置——这样同样的向上查找就能成功：

DSHMOD="$(dirname "$(readlink -f "$(command -v dsh)")")/../lib/node_modules/@deepseek-ai/dsh/node_modules/@deepseek-ai"
mkdir -p node_modules/@deepseek-ai
ln -sfn "$DSHMOD/dsh-llm"   node_modules/@deepseek-ai/dsh-llm
ln -sfn "$DSHMOD/dsh-tools" node_modules/@deepseek-ai/dsh-tools

然后向 $DSH_HOME/profiles/web/cordis.patch.yml 添加一个条目：

- insert:
- id: council
name: dsh-tool-council
config:
members:
- provider: google
model: gemini-3.6-flash
- provider: groq
model: openai/gpt-oss-120b
- provider: nvidia
model: z-ai/glm-5.2
- provider: openrouter
model: nvidia/nemotron-3-super-120b-a12b:free
- provider: mistral
model: devstral-medium-latest
synthesis:
provider: nvidia
model: minimaxai/minimax-m3
maxTokens: 2048
timeoutMs: 120000

重启 harness。对任何其他应拥有该工具的 profile（headless、tui）重复此操作。

每个 provider 都必须是你已配置的路由，每个 model 都必须是该路由所提供的 id ——
插件不会验证成员资格，因此未知的组合会在请求时失败，并返回该 provider 自身的错误，
且该错误会针对该成员进行报告。

配置

| 字段 | 默认值 | 含义 |
|---|---|---|
| members | 3 个内置路由 | 面板。每个条目为 { provider, model, role? }。上限为 8。 |
| synthesis | google / gemini-3.6-flash | 主席路由，或设为 false 以永不进行综合。 |
| maxTokens | 2048 | 每个成员以及主席的生成上限。 |
| timeoutMs | 120000 | 每次调用的截止时间，与调用方自身的取消操作融合。 |

内置默认值的存在只是为了让插件在无配置的情况下也能加载。请将 members 设置为你
实际拥有的路由 —— 默认值指定了特定 provider，它们在你的部署中可能并不存在。

工具参数

模型通过以下参数调用 council：

- question（必填）—— 成员仅能看到此文本，而看不到周围的对话，因此它必须
是自包含的。工具描述已向模型说明了这一点；如果回答看起来缺乏上下文，原因就在于此。
- members（可选）—— 为单次调用覆盖面板。每个条目可接受一个可选的 role
（“安全审查员”、“性能质疑者”），该角色会展示给主席。
- synthesize（可选，默认 true）—— 设为 false 可在没有主席环节的情况下读取原始回答。

它返回 { question, answers[], synthesis? }，其中每个回答都带有 provider、model、ok、
elapsedMs，以及 text 或 error。当成功成员少于两个时会跳过综合 ——
因为没有什么可以与单独一个回答进行核对。

成本

每个成员一次 provider 请求，再加上主席的一次。一个五成员面板就是六次请求。工具
描述会告诉模型将其保留给重大或有争议的问题，而不是日常查询，但在按量计费的 provider 上
这一点值得留意。

与上游项目的关系

这是一个社区插件，并非 harness 的一部分。DeepSeek Harness
在现阶段不接受外部 pull request，
而是引导贡献者构建插件并将其标记为 dsh-plugin —— 这正是本插件的情况。上游项目
自己的说法是：“我们不认为官方仓库中的包天生就比社区创建的包更重要。”
许可证

MIT