Repository navigation
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 个包必须整体升级。