Repository navigation
Releases
v0.2.3
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 跑全量。
v0.2.2
Note: v0.2.2 was published to npm after v0.2.3. Both versions are installable; prefer v0.2.3 (current
latest) for new installs.
v0.2.2 — 关闭 Workspace / Session 与判断式自主
0.2.2 是 patch 版本,不包含 breaking change:新增 3 个模型工具(8 → 11),让 DevLead 能
关闭(注销)Workspace、归档/恢复 Session,并把关闭授权从「必须人类逐条明确要求」放宽为
判断式自主;同时把只读调研收窄为有界可行性判断,进一步细化调研与实现随简报交给被派发
的 Session。持久记录格式、既有公开 API、engines.dsh、人类命令与 UI 均不变。
新模型工具(8 → 11)
| 工具 | 参数 | 返回(canonical JSON) |
|---|---|---|
devlead_remove_workspace |
workspace(必填:id 或已注册路径) |
{ workspace, removed }(注销前快照) |
devlead_archive_session |
session(必填)、stop_running?(默认 false) |
{ sessionId, archived: true, stopped } |
devlead_unarchive_session |
session(必填) |
{ sessionId, archived: false } |
语义沿用 DSH 自己的术语,且都不是物理删除:
- remove(注销 Workspace):只移除 Workspace 注册记录,目录、文件与所有 Session 日志都
保留;其 Session 变为未分组(仍可打开/续写)。重新注册同一目录会创建全新 Workspace,
旧 Session 不会自动归入。返回值携带注销前的 Workspace 视图(含刚变为未分组的 Session ids)。 - archive(归档 Session):Session 从侧边栏分组消失但日志保留,可用
devlead_unarchive_session恢复到原来的 Workspace 位置;重复归档是幂等 no-op(已归档时
stopped:false,不检查活动也不请求停止)。 - stop_running:带运行中工作(turn / subagent / job / schedule)的 Session 默认以新增错误码
DEVLEAD_SESSION_ACTIVE拒绝;传stop_running: true时先写归档,再通过 Host 的
workspace/session-stopproviders 请求停止(与人类点停止同一路径),不等待 settle,结果
stopped: true。 - 自我归档守卫:lead 不能归档自己(
DEVLEAD_INVALID_INPUT),避免暂停自身通知投递或取消
当前 turn;需要人类从侧边栏操作。 - 新错误码:
DEVLEAD_SESSION_ACTIVE(Host 的WorkspaceActiveSessionError映射;消息按种类
列出活动,item 最多 3 条)。
判断式自主(close authorization)
policy 与三个工具描述从硬性「必须人类显式授权」改为判断式自主:当关闭确实服务任务且属于
合理收尾时,模型可自行归档自己创建/派发且已完成的临时 Session、注销明显陈旧/重复/空置或由
自己创建的 Workspace 注册,并在人类说「整理/收尾/清理」时自行判断范围。
保留的边界:
- 不关闭人类正在使用/对话的 Session 或 Workspace;
- 不用关闭掩盖失败或跳过汇报;
- 不做无关的大范围清理;
- 归档可逆、优先使用;注销影响面更大(重新注册得到全新 Workspace),只在注册本身陈旧/重复/
空置/自己创建时自主注销; stop_running等于主动取消运行中工作,只在确实要终止时使用;- 每次自主关闭都要汇报关闭了什么、为什么、影响面(哪些 Session 变未分组、是否停止运行中
工作),并说明归档可以 unarchive。
有界可行性判断与深挖交接
Role boundary 的只读调研从「为简报与审阅读代码」改为 feasibility triage, not research:
只读到足以判定归属、给出当前行为/目标结果的高层事实、定义验证方式,即停止并派发;明确不读完
整模块、不做完整复现/根因分析、不预先设计实现。派发简报新增留给 Session 确认/细化的开放
问题,允许「带开放问题的简报」;进一步细化调研与实现属于被派发的 Session。仅在归属/安全
需要、人类明确要求、或审阅需核对具体断言时继续深读。
审计打磨
- 统一「归档 Session」与「注销 Workspace」的措辞:清理时优先归档已完成 Session、保留
Workspace 注册,避免把两个不同实体当成同一决策的两个选项。 - policy 常驻长度守卫改为直接度量导出的 base policy(以 0.2.1 的 7,896 字符为基线,上限
+10%),当前 8,581 字符(+8.7%)。 - 文档化「已归档 →
stopped:false(Host no-op)」与「removed:false(并发注销)」语义;
devlead_remove_workspace描述注明返回值含未分组 Session ids。 - 测试补充:注销后
listWorkspaces不再包含、cold persisted Session 的 unarchive、stop 归档
结果的运行时 schema 校验。
验证
pnpm verify # typecheck + 23 文件 / 620 tests + build 6 targets
node scripts/check-packages.mjs # OK (6 packages)
node scripts/stage-release.mjs --dry-run
node scripts/e2e-smoke.mjs --flow patch
node scripts/e2e-smoke.mjs --flow installed- 单元测试:23 文件 / 620 tests。
- E2E(真实 Web Host,隔离
DSH_HOME):phase 1 默认组合 27、phase 1b 冷 lead 重建 12、
phase 2 实验 worktree 22、phase 3 关闭工具与 triage policy 51;patch 与 installed 两条
加载流各 112/112。--no-worktree只跳过 phase 2,报 90/90。 - phase 3 覆盖:11 个
devlead_*工具的when条件可见性(开/关)、policy 关键口径、
archive/重复 archive/unarchive 与持久日志、DEVLEAD_SESSION_ACTIVE拒绝与stop_running
的 Host stop 派发、自我归档守卫、remove 后注册表/目录/日志/未分组/重新注册不继承旧 Session。
兼容性
- DeepSeek Harness:
>=0.2.2-rc.1 <0.3.0(engines.dsh不变)。 - Node.js:
>=24.9(仅构建与发布工具链)。 - 持久记录 / 既有公开 API / 人类命令 / UI:不变;新增 3 个模型工具与 1 个错误码。
- 升级方式:
dsh plugin --profile <p> add @yankeguo/dsh-devlead-bundle@0.2.2(或更新现有
profile),刷新 Web 页面;6 个包必须整体升级。
v0.2.1
v0.2.1 — staged 发布流水线与插件展示元数据
0.2.1 是 patch 版本,DevLead 的运行时行为不变:本版把发布流程改为 npm staged publish
(CI 只 stage、维护者人工 approve 后才公开),并为全部 6 个可发布包补齐 DSH 插件管理器 / 插件
市场使用的用户友好展示元数据(中英双语)。持久记录格式、公开 API、engines.dsh 均不变。
发布模型:CI 只 stage,人工 approve,再出 GitHub Release
旧的「CI 直接 pnpm publish -r + CI 创建 GitHub Release」模型已废弃。新流程见
发布指南:
- Stage(CI):推
v*tag(或workflow_dispatch传入已存在的release_tag重跑)
触发publish.yml。工作流先校验 tag commit == HEAD、
tag 版本与根 + 6 个包完全一致(prerelease tag 直接拒绝),再 install / typecheck / test /
build /check-packages,最后按 workspace 依赖拓扑顺序对每个包执行npm stage publish。
此时不会公开任何版本;CI 通过 OIDC 短时 token(id-token: write)逐包换取权限,
provenance 在公开仓库自动附带,不需要任何NPM_TOKENsecret。 - Approve(维护者本机):
npm login+ 交互式 2FA 后运行
node scripts/promote-release.mjs --version 0.2.1(可先--list-only/--dry-run查看)。
脚本先做只读预检(每包恰好 1 条 staged 记录、npm/gh 登录、远端 tag、release notes),
全部通过后才逐包npm stage approve;失败时打印已公开包、剩余 stage id 与reject清理提示。 - Release:全部批准后由同一脚本幂等创建/更新 GitHub Release(
--verify-tag,
notes 取自docs/releases/v0.2.1.md)。
新增/变更的发布工具:
scripts/stage-release.mjs(新):pnpm pack(改写workspace:*为精确版本)→ 断言 tarball
manifest →npm stage publish;确定性拓扑顺序(protocol → client-ui → devlead → command →
tool → bundle)、首个失败即停、job summary 输出 stage 表、临时目录自动清理;
--dry-run用--force跳过 registry「版本已存在」检查,供本地预检。scripts/promote-release.mjs(新):两阶段(只读预检 → 串行 approve),OTP 交互、
已发布幂等跳过、duplicate/missing 明确报错、失败恢复提示、幂等 GitHub Release。scripts/trusted-publishers.sh:改授--allow-stage-publish(不再--allow-publish);
旧 publish-only trust 配置需npm trust revoke后由脚本重建。publish.yml:workflow_dispatch新增release_tag输入(checkout 既有 tag,
不创建/移动/删除 tag),移除 CI 内 GitHub Release 与contents: write。- npm CLI:staged publishing 自 npm 11.15.0 提供,CI 固定并验证 11.20.0。
scripts/check-packages.mjs:新增 staged-publish 契约检查(禁止 CI 直发 / CI 建 Release /
裸npm publish,要求 stage 脚本、release_tag输入、--allow-stage-publish、根 scripts 映射)。
插件展示元数据(locale/en.json + locale/zh.json)
DSH 0.2.2-rc.1 插件管理器/插件市场通过 readPluginMeta 读取
<包名>/locale/en.json 中的 {"meta":{"title","description"}},同目录其它语言文件作为翻译,
字段缺失才回落到包名 / package.json description。本版 6 个包全部补齐(title 中英各一):
| 包 | English | 中文 |
|---|---|---|
@yankeguo/dsh-devlead-protocol |
DevLead Protocol | DevLead 协议 |
@yankeguo/dsh-devlead |
DevLead | DevLead |
@yankeguo/dsh-tool-devlead |
DevLead Tools | DevLead 工具 |
@yankeguo/dsh-command-devlead |
DevLead Command | DevLead 命令 |
@yankeguo/dsh-client-ui-devlead |
DevLead UI | DevLead 界面 |
@yankeguo/dsh-devlead-bundle |
DevLead Suite | DevLead 套件 |
- 每个包
package.json增加files: ["locale/*.json"]与
exports: { "./locale/*.json": "./locale/*.json" };bundle 保留icon.svg; client-ui既有两个 locale 文件的标题由「DevLead mode/模式」更新为「DevLead UI/界面」,
并同步src/client/locales.ts的meta.*(既有locales.spec.ts保证一致);- 新增
packages/devlead/tests/plugin-metadata.spec.ts:校验 locale 存在/合法、en+zh 字段
非空、files/exports接线、标题唯一、无营销最高级词,并通过 Nodeexports真实解析
<pkg>/locale/{en,zh}.json(与 DSH 解析路径一致); scripts/check-packages.mjs增加同样的 CI 静态校验,新增包漏配 locale 会在发布前失败。
其它
- 文档:重写 发布指南(staged 模型、trust 迁移、2FA 人工步骤、
部分失败恢复、首次 CI 运行清单、FAQ);README / README.zh 发布章节与包结构章节同步;
bundle README 的发布链接说明更新;docs/AUDIT.md历史章节注明后续发布模型变化。 - 测试:新增 plugin-metadata 22 个测试,总数为 23 文件 / 580 tests。
验证
pnpm verify # typecheck + tests + build
node scripts/check-packages.mjs # OK (6 packages)
node scripts/stage-release.mjs --dry-run # 6/6 打包 + npm 预检,不上传
node scripts/e2e-smoke.mjs --flow patch --no-worktree --no-build # 39/39
node scripts/e2e-smoke.mjs --flow installed --no-worktree --no-build # 39/39pnpm verify:typecheck 通过;23 文件 / 580 tests passed;build 6 targets。node scripts/check-packages.mjs:OK (6 packages)(含新增 locale / staged-publish 规则)。stage-release --dry-run:6 个包按拓扑顺序打包,逐个通过 npm 11.20.0 的 dry-run 预检。- E2E 冒烟:
patch与installed两条加载流各 39/39(阶段 1 = 27 + 阶段 1b = 12;
--no-worktree跳过需实验 forge bundle 的阶段 2)。 - 版本:根
package.json与 6 个可发布包统一为0.2.1,check-packages校验版本锁步。
兼容性
- DeepSeek Harness:
>=0.2.2-rc.1 <0.3.0(engines.dsh不变)。 - Node.js:
>=24.9(仅构建与发布工具链)。 - 持久记录 / 公开 API / 运行时行为:不变;仅新增插件展示元数据(插件管理器中的标题与描述
变为用户友好文案)。 - 升级方式:
dsh plugin --profile <p> add @yankeguo/dsh-devlead-bundle@0.2.1(或更新现有
profile),刷新 Web 页面;6 个包必须整体升级。
v0.2.0
v0.2.0 — 语义决策、冷 lead 恢复与 worktree 验收
0.2.0 把上一轮全量审计留下的六个"待决策"项全部按正确语义落地(minor 版本,允许 breaking),
并修复通知泵与损坏日志恢复路径上的缺陷。核心目标:一次损坏的持久记录不再永久锁死一个会话,
Host 重启后 DevLead 不再静默失聪,watch/唤醒的失败路径不留下半应用状态。
Breaking changes(升级前必读)
useWorkspace改为 live lead Agent 调用(core 与 tool 语义统一)。- 旧:
useWorkspace(path, { title?, create?, signal? }),Host 级 caller-free API;
create默认true,可以 mkdir 任意可写目录。 - 新:
useWorkspace(agent, { path, title?, create? }, signal?);要求 live lead Agent 且
DevLead 模式开启(否则DEVLEAD_AGENT_NOT_LIVE/DEVLEAD_NOT_ENABLED),
create默认false:默认绝不创建目录,缺失目录报DEVLEAD_DIRECTORY_MISSING;
只有显式create: true才允许mkdir -p。 - 迁移:直接调用 core 的宿主插件改为传 Agent;需要建目录的模型调用显式传
create: true。
- 旧:
promptSession的自动 watch 变为可补偿语义。admission/resume 失败或取消时,本次调用
新增的 watch 会被补偿移除(已有显式 watch 不受影响),不再留下"watch 了但没投递"的
半应用状态。watch: false语义不变。wakeColdSession默认改为true(冷 lead 自动 resume 投递)。配合冷 lead 索引重建:
Host 重启 / 插件重载后,hub 从持久化 projection cache(零 I/O 预筛)+ Session 日志
(精确折叠)重建 watch 索引;被 watch 会话的turn/end仍会写入持久通知并在合并窗口
结束后唤醒 lead(冷 lead 先 resume)。进程内agent/disposed不再移除索引,因此 dispose
之后仍继续观察、继续写持久通知。不希望后台自动 resume 的部署显式设置
wakeColdSession: false(此时通知进入内存队列,等人类打开 lead 时补写并投递)。DevLeadCreatedSession.isolation正式声明为必填字段(0.2.0 breaking)。
tool 的 value 层保留对旧 core 缺失该字段的防御性回退
({ requested: 'none', status: 'none' }),但混装旧 core + 新 tool 不再是被支持的发版组合;
请整体升级 6 个包(bundle 会保证版本一致)。- 损坏 fold 的恢复路径:新增人类专属
/devlead reset(丢弃该会话的全部 DevLead 持久
状态:模式、watch 集合、通知 digest、冻结失败标记),且/devlead off在 fold 冻结时也会
强制关闭并清理冻结状态。/devlead on在冻结状态下会拒绝并提示先 reset(避免隐式丢弃数据)。
旧版本的 projection 会把新 reset 记录当作未知插件记录忽略,不会崩溃,但无法执行恢复。 hasQueuedNotice不再丢弃新 batch 的唤醒:inbox 里仍有未投递 notice 时,新 batch 保持
在待投递队列,notice 被消费/取消后立刻(或最迟 1s 重检后)投递,不再出现"持久记录已写、
但永远不会再唤醒"的丢唤醒。持久 digest 仍是权威。
新特性
- 冷 lead 索引重建(cold rehydration):Host 启动/插件重载时
[Service.init]await
一个 corpus-readiness barrier(有界 2s:用可选sessionPersistence.list()的完整存储会话
集合与sessionQuery的 persisted 语料做比对;全新 Host 无存储会话时立即通过,稳定 Host
只付一次语料比对),然后执行唯一一次权威冷扫描:用sessionQuery列出持久会话,以
sessionProjectionCache的devLead值做零 I/O 预筛,再对候选会话精确折叠持久
plugin:devlead/*记录得到权威 watch 集合;损坏记录单会话 warning 一次并跳过。无分类
候选的全量日志读取有固定上限(64),避免 Host 重启扫描无界历史;没有 projection cache
的宿主仍可基于 live 会话恢复,冷会话需要该能力(默认 Web/Desktop 组合都有)。
watch 索引可重复重建(幂等),dispose/reopen 不再丢失观察;仅插件卸载期间结束的 turn
无法补发(插件重新加载时索引会从持久记录重建)。 /devlead reset:人类专属恢复命令;同时清空 summary 级devLeadMode标记。- 通知记录立即 flush:通知写入 lead 日志后主动发起 durability flush,缩短崩溃丢记录窗口。
warnedFailures每 Host 生命周期只警告一次(有界集合,不再因 dispose/reopen 重复刷屏)。- 客户端样式注入引用计数:
ensureStyleTag改为跨模块实例 refcount,HMR 新旧实例交替时
不会提前移除仍在使用的<style>。 - React 组件/hook 渲染测试:新增
react-test-renderer(devDependency,仅测试用,纯 node、
无 jsdom),覆盖两个 UI 入口的分支、a11y live region、pending/失败文案与准入 hook 的
单击/双击/卸载/reset 行为。 - 多阶段 E2E(含冷 lead 重启验收与实验组合 worktree happy path):
pnpm e2e分多个
阶段 —— 阶段 1 默认 profile 全量断言(含Worktree isolation: unavailable);阶段 1b 用
同一加载流、同一一次性 scratch home 重启,验证冷 lead 索引重建:冷 lead 从持久日志折叠
状态、冷子会话被 resume、重启后的turn/end产生新通知,D2 由此获得真实 Host 端到端证据;
阶段 2 在同一 scratch profile 中叠加@deepseek-ai/dsh-experimental-forge-bundle重启,
验证devlead_create_session({ isolation: 'worktree' })端到端:返回status: 'worktree'path/branch/baseCommit、子会话有效工作目录确实切换、Session 仍归属原 Workspace。
patch与installed两条加载流都跑完整多阶段,各 61/61(阶段 1 27 + 阶段 1b 12 +
阶段 2 22);--no-worktree跳过阶段 2(39/39,阶段 1 + 1b),仅供调试。
修复
- 冷 / 已 dispose lead 不再停止观察 watch 的会话:dispose 保留索引;Host 重启/插件重载后
索引从持久记录重建(冷 lead 默认 resume 投递)。 - promptSession 失败/取消后的半 watch。
- inbox 已有 notice 时新 batch 的丢唤醒。
- 损坏 fold 无法恢复(
/devlead off恢复 +/devlead reset)。 - 通知记录在 crash 窗口内可能未落盘。
- 命令并发(on/off、watch/unwatch 与另一个并发命令)时状态行标题与正文可能不一致。
- 单 Session 损坏日志在 dispose/reopen 后重复 warning。
验证
在本工作树(未提交状态)上的最终结果:
pnpm verify # typecheck + tests + build
pnpm test
node scripts/check-packages.mjs # OK (6 packages)
node scripts/e2e-smoke.mjs --no-build --flow patch
node scripts/e2e-smoke.mjs --no-build --flow installed- 单元测试:22 文件 / 558 tests(含 fold reset、冷 lead 重建与就绪屏障、promptSession 补偿、reset 命令、
并发标题、React 渲染、样式 refcount)。 - E2E:多阶段(默认 profile 断言 + 重启验证冷 lead 索引重建 + 叠加
@deepseek-ai/dsh-experimental-forge-bundle的 worktree happy path),patch 与 installed
两条加载流各 61/61(阶段 1 = 27、阶段 1b = 12、阶段 2 = 22;--no-worktree跳过阶段 2
时为 39/39)。 - 版本:根
package.json与 6 个可发布包均为0.2.0;check-packages校验版本锁步。
兼容性
- DeepSeek Harness:
>=0.2.2-rc.1 <0.3.0(engines.dsh不变)。 - Node.js:
>=24.9(仅构建与发布工具链)。 - 持久记录:只新增
plugin:devlead/reset;旧记录格式不变,fold 的stateVersion不变。 - 升级方式:
dsh plugin --profile <p> add @yankeguo/dsh-devlead-bundle@0.2.0(或更新现有
profile),刷新 Web 页面;6 个包必须整体升级。
v0.1.1
v0.1.1 — 审计与加固版本
一次以官方 DeepSeek Harness 0.2.2-rc.1 源码为唯一强信源的全面审计、优化与打磨。
详见 审计记录。
高严重度修复
- 修复开发 overlay 的跨运行时副本问题:
pnpm dev:patch现在会校验目标 profile,
并把本仓库注册为该 profile 的 linked root。此前用dsh --patch <绝对路径>启动时,
插件会从本仓库的 pnpmnode_modules解析@deepseek-ai/*,进程里出现第二份 DSH 运行时,
第一次写 Session 插件记录就抛
gateway/internal: Receiver must be an instance of class Session(/devlead on直接失败)。
修复后开发/E2E 与install-profile两种加载流都在真实 DSH 上通过端到端验证。
核心(@yankeguo/dsh-devlead)
- 列表/身份解析:
listSessions改为 options-onlysignal;身份解析穷尽(精确 id 快路径),
不再受maxListedSessions限制;watched-only 列表不再截断到小于 watch 集合。 - 写入:补齐协作式取消;watch 容量 / 冷会话激活预检先于副作用;
flush() === false按
「没有持久化参与者」处理,参与者异常只 warning。 - Workspace:去掉与 registry 重复的校验,错误码细分(缺目录 vs 不可用路径);
title只作用
于新注册记录。 - 严格解码:插件记录精确字段集、
Date可表示时间戳、正 turn、重复 watch id 一律拒绝 replay。 - Projection:identity 复用 +
SessionProjectionSummaryExcluded——通知摘要不再进入每个
Session summary/list payload。 - 通知泵:零延迟代际守卫、上限 1s 有界重试、同 id digest 去重、归档 lead 暂停、损坏 replay
只 warning 一次。 - 性能:列表按便宜事实排序截断后再组装视图,registry 每次扫描一次(测试用计数器固定)。
工具与命令
/devlead解析严格对齐CommandInvocation.rawInput契约;状态视图单次 projection 快照;
穷尽映射全部DEVLEAD_*错误码。devlead_create_session/devlead_prompt_session/devlead_watch_session转发
exec.signal;exec.agent缺失时返回结构化DEVLEAD_AGENT_NOT_LIVE。- 工具输出 schema 与 protocol 视图类型编译期一致,并在运行时校验 canonical value。
客户端 UI 与协议
- 两入口准入逻辑收敛为纯 gate+reducer + 薄 hook;Host 未解析到命令(
value: undefined)
不再被当作成功(新增unresolved失败)。 - a11y live region、shell menu-surface 样式、码点安全的摘要、空值感知的 digest 行。
- protocol 导出面保持不变;补充 summary 排除的类型契约测试。
工程与 CI
- 新增
scripts/e2e-smoke.mjs:隔离DSH_HOME+ 真实 DSH Web,patch / installed 两条加载流
各 25 项端到端检查。 - 新增
scripts/check-packages.mjs包不变式检查(linked-root peer 规则、module table、
别名、lockfile、CI pin)。 - 新增
.github/workflows/verify.yml(push/PR:frozen install → typecheck → test → build →
check-packages);发布工作流串行化、GitHub Release 幂等。 build.mjs清理过期内容、浏览器 externals 单一来源 + 越界导入构建期守卫;
install-profile.mjs全量预检;trusted-publishers.sh能力探测。- TypeScript 开启
noUnusedLocals/noUnusedParameters。
兼容性
- DeepSeek Harness:
>=0.2.2-rc.1 <0.3.0(engines.dsh不变) - Node.js:
>=24.9(仅构建与发布工具链) - 协议导出面保持稳定;行为变更见 AUDIT.md §7
验证
pnpm verify:typecheck + 399 个测试 / 17 文件 + 7 个构建产物pnpm check:packages:OK(6 包)pnpm e2e(patch 流)与pnpm e2e --flow installed:真实 DSH 上各 25/25
Full Changelog: v0.1.0...v0.1.1