Skip to content

Releases

v0.2.3

Choose a tag to compare

@yankeguo yankeguo released this 16 Nov 04:46

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 上(durable model/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 服务(durable team/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 启用成功、durable team/mode、显式 false 关闭。
    • DSH 0.2.2-rc.3(本机已安装运行时):patch / installed 各 130/130(含 phase 2)。
  • 所有版本均因无 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

Choose a tag to compare

@yankeguo yankeguo released this 16 Nov 04:47

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-stop providers 请求停止(与人类点停止同一路径),不等待 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

Choose a tag to compare

@yankeguo yankeguo released this 10 Nov 09:02

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」模型已废弃。新流程见
发布指南:

  1. 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_TOKEN secret。
  2. 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 清理提示。
  3. 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 接线、标题唯一、无营销最高级词,并通过 Node exports 真实解析
    <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/39
  • pnpm 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

Choose a tag to compare

@github-actions github-actions released this 09 Nov 08:55

v0.2.0 — 语义决策、冷 lead 恢复与 worktree 验收

0.2.0 把上一轮全量审计留下的六个"待决策"项全部按正确语义落地(minor 版本,允许 breaking),
并修复通知泵与损坏日志恢复路径上的缺陷。核心目标:一次损坏的持久记录不再永久锁死一个会话,
Host 重启后 DevLead 不再静默失聪,watch/唤醒的失败路径不留下半应用状态。

详见 审计记录 §10 与
设计说明。

Breaking changes(升级前必读)

  1. 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。
  2. promptSession 的自动 watch 变为可补偿语义。admission/resume 失败或取消时,本次调用
    新增的 watch 会被补偿移除(已有显式 watch 不受影响),不再留下"watch 了但没投递"的
    半应用状态。watch: false 语义不变。
  3. 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 时补写并投递)。
  4. DevLeadCreatedSession.isolation 正式声明为必填字段(0.2.0 breaking)。
    tool 的 value 层保留对旧 core 缺失该字段的防御性回退
    ({ requested: 'none', status: 'none' }),但混装旧 core + 新 tool 不再是被支持的发版组合;
    请整体升级 6 个包(bundle 会保证版本一致)。
  5. 损坏 fold 的恢复路径:新增人类专属 /devlead reset(丢弃该会话的全部 DevLead 持久
    状态:模式、watch 集合、通知 digest、冻结失败标记),且 /devlead off 在 fold 冻结时也会
    强制关闭并清理冻结状态。/devlead on 在冻结状态下会拒绝并提示先 reset(避免隐式丢弃数据)。
    旧版本的 projection 会把新 reset 记录当作未知插件记录忽略,不会崩溃,但无法执行恢复。
  6. 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

Choose a tag to compare

@github-actions github-actions released this 09 Nov 03:32

v0.1.1 — 审计与加固版本

一次以官方 DeepSeek Harness 0.2.2-rc.1 源码为唯一强信源的全面审计、优化与打磨。
详见 审计记录。

高严重度修复

  • 修复开发 overlay 的跨运行时副本问题:pnpm dev:patch 现在会校验目标 profile,
    并把本仓库注册为该 profile 的 linked root。此前用 dsh --patch <绝对路径> 启动时,
    插件会从本仓库的 pnpm node_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-only signal;身份解析穷尽(精确 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