Repository navigation
v0.2.3 — 派发模型选择、Host 模型目录与 Agent Teams 判断
0.2.3 是 patch 版本,不包含 breaking change:devlead_create_session 新增创建时的模型选择
(provider + model,可选 reasoning_effort)与 agent_teams;新增只读
devlead_list_models(模型工具 11 → 12),让 lead 在 pin 之前查询真实可用路线;默认行为保持
继承 Host 默认模型,且从不会改写 profile 默认模型。持久记录格式、既有公开 API、
engines.dsh(仍为 >=0.2.2-rc.1 <0.3.0)、人类命令与 UI 均不变。
模型选择与推理强度
devlead_create_session 新增:
| 参数 | 说明 |
|---|---|
provider |
可选;与 model 成对出现 |
model |
可选;与 provider 成对出现 |
reasoning_effort |
可选;只能与成对模型一起使用,省略时继承模型默认 effort |
口径:
- 默认继承 Host 默认模型;只有人类明确要求,或简报确实需要成本/能力路由、可复现性时才
指定。需要 pin 时先调用devlead_list_models,不要猜 provider/model/effort。 - 创建前按与 Session controller
selectModel相同的口径校验(provider 已注册、model 在当前
可用列表、ctx.llm.resolveCallConfig接受 route/effort);失败报
DEVLEAD_MODEL_UNAVAILABLE且不创建 Session。 - 创建后通过
agent.model.select记录在子 Session 上(durablemodel/selection事件),
不走会改写 profile 默认模型的sessionController.selectModel/
agentDefaultModel.saveSelection;profile 默认模型前后不变。 - 两者都是 creation-time only;
devlead_prompt_session不会重新指定。
devlead_list_models(11 → 12)
只读工具,返回精简的 Host 模型目录:
{
"default": { "provider": "provider-a", "model": "model-a", "reasoningEffort": "medium" },
"routableProviders": ["provider-a"],
"providers": [{
"id": "provider-a",
"name": "Provider A",
"models": [{
"id": "model-a",
"name": "Model A",
"reasoning": {
"efforts": [{ "id": "low", "name": "Low" }],
"defaultEffort": "low"
}
}]
}],
"failures": [{ "id": "provider-b", "name": "Provider B", "message": "catalog lookup failed" }]
}省略 model description/badge 等展示字段以控制 token;provider 目录失败会如实出现在
failures 中。工具描述明确「大多数 dispatch 应省略模型参数、继承默认;需要 pin 时先查目录」。
Host 未组合 sessionController 或目录读取失败时报 DEVLEAD_SESSION_UNAVAILABLE。
Agent Teams:显式 opt-in + lead 自主判断
agent_teams: true启用,false显式关闭,省略则不动 Host 默认。- 默认建议:简单线性任务省略;复杂、多步、可并行、适合子代理协作的任务,lead 可自主决定启用,
并在汇报中说明是否开启及原因。人类明确要求开/关时照做。 - 启用通过可选
ctx.agentTeams服务(durableteam/mode),没有静态 import;Host 未组合该
服务时,true在创建前报DEVLEAD_TEAM_UNAVAILABLE且不创建 Session,false/省略正常。
DSH 0.2.2-rc.1 – rc.3 兼容
| 能力 | 0.2.2-rc.1 | 0.2.2-rc.2 | 0.2.2-rc.3 | 说明 |
|---|---|---|---|---|
既有工具 / /devlead / UI |
支持 | 支持 | 支持 | 基础插件面 |
模型选择 + reasoning_effort |
支持 | 支持 | 支持 | Session 级;不改 profile 默认 |
devlead_list_models |
支持 | 支持 | 支持 | sessionController.modelCatalog() rc.1 已有 |
agent_teams: true |
不支持 → DEVLEAD_TEAM_UNAVAILABLE,不创建 Session |
支持* | 支持* | *Host 需组合 agent-team;dsh-base rc.2+ 默认包含 |
依据:@deepseek-ai/dsh-agent-team 仅从 0.2.2-rc.2 起发布,rc.1 的 dsh-base 没有对应组合
行;rc.2 与 rc.3 的 agent-team 实现相同(isEnabled(agent)、
setEnabled(agent, enabled, signal?)、durable team/mode)。rc.1 上 agent_teams: true 的
错误文案会说明该能力自 rc.2 起提供/默认组合,并建议省略该参数继续 dispatch;不要重试或阻塞。
验证
pnpm verify # typecheck + 23 文件 / 650 tests + build 6 targets
node scripts/check-packages.mjs # OK (6 packages)
node scripts/stage-release.mjs --dry-run- 单元测试:23 文件 / 650 tests。
- E2E(真实 Web Host,隔离
DSH_HOME):- DSH
0.2.2-rc.1(npm 临时安装 CLI):patch / installed 各 108/108(--no-worktree,
阶段 1 + 1b + 3);Team 成功检查改为预期不可用断言(DEVLEAD_TEAM_UNAVAILABLE、无 Session、
文案含 rc.2)。 - DSH
0.2.2-rc.2(npm 临时安装 CLI):patch / installed 各 108/108(--no-worktree);
Team 启用成功、durableteam/mode、显式 false 关闭。 - DSH
0.2.2-rc.3(本机已安装运行时):patch / installed 各 130/130(含 phase 2)。
- DSH
- 所有版本均因无 provider 凭据有 3 条正向模型 pin 检查 SKIP(如实报告,不伪造);
devlead_list_models
与模型不可用负路径在三个版本均通过。
已知限制
- 真实 Host 的模型正向 pin 需要 provider 凭据;隔离 E2E 使用无凭据环境,因此该 3 条检查为 SKIP,
成功路径由单元测试覆盖。 - rc.1/rc.2 的兼容 E2E 使用
--no-worktree(phase 2 实验组合不属于该矩阵);rc.3 跑全量。