编写于 2026-10-19
- 版本号与日期来自
git tag。agent-v4*是 annotated tag,日期采用 tagger 日期(+0800)。 - 提交数用
git rev-list --count统计,包含合并提交;区间起点是agent-v4.0.9。 - tag 日期只证明仓库打标时间,不证明 GitHub Release、安装脚本或包注册表在同一天可用。
- 本页只列能从提交主题与正文复核的代表项,不逐 commit 罗列。
Full Compact 之后加入历史分页与 historyWindowV1 协议,默认主动委派;WriteSandbox 与 allowedWriteDirs 被移除。
本页覆盖 agent-v4.0.9 之后至 agent-v4.1.2(2026-10-16 15:54 至 2026-10-19 16:41,+0800),共 16 个提交(git rev-list --count agent-v4.0.9..agent-v4.1.2)。主要 PR:#221、#234–#246。
日历日按首尾日期计算,含首尾两天。
本版变化
优先级按 P0 → P2 分段,段内按序排列。变化类型用图标与标题区分:新增(绿色对勾)、变更(橙色三角)、移除(红色感叹号)、修复(蓝色信息)。
P1 用户可感
新增 · #221 / 4.1.0
Full Compact 之后的 transcript 收缩与 ACP 历史分页:TUI 滚动到顶端取更早历史,SDK 增量合并分页结果;未协商 peri.historyPagination 的 ACP 客户端仍收到完整历史回放
新增 · #238 / 4.1.1
historyWindowV1 上下文协议,默认关闭,beta 键 history-window-v1;新增 open、page、seek、body 分页与 inherited 只读快照
P2 其他变更与修复
修复 · #241 / #242 / 4.1.1
历史窗口去重、内存、交付顺序与 UTF-8 边界
P0 需要行动
移除 · #234 / 4.1.0
删除 WriteSandbox 工具与 allowedWriteDirs 字段,读写约束下沉到提示词
P1 用户可感
变更 · #234 / 4.1.0
子代理工具面改为全量继承,移除读写硬限制
变更 · #239 / 4.1.1
默认主动委派;取消「2 至 3 个文件」硬门槛;explorer 改为工具级只读
P2 其他变更与修复
修复 · #240 / #235 / 4.1.1
全工具审计 F01–F14、Q01–Q08、V01–V02;工具执行证据与子 Agent 回执收口
P1 用户可感
变更 · #237 / 4.1.1
默认重试上限改为 10,并支持 goal 阻断后的恢复
新增 · #243 / 4.1.2
MCP 详情视图以表格展示工具、技能、代理与订阅
变更 · #244 / 4.1.2
后台 shell 并发上限从 5 调到 20
P2 其他变更与修复
变更 · #245 / 4.1.2
MCP 数据边界收敛,宿主改走标准协议
修复 · #236 / 4.1.0
结清 workflow 子会话并在切换前重放 incomplete close
变更 · #246 / 4.1.2
升级 ACP、rmcp 与依赖,并固定工具链
按 patch 看
4.1.0(10-17 09:39,4 个提交)
#221Full Compact 后的历史分页与 transcript 收缩;#234子代理工具面全量继承;#235工具证据与回执;#236workflow 子会话结清。
4.1.1(10-18 23:26,6 个提交)
#237重试上限与 goal 恢复;#238historyWindowV1;#239默认委派与只读explorer;#240工具审计;#241/#242历史窗口边界与复审修复。
4.1.2(10-19 16:41,6 个提交)
#243MCP 详情表;#244后台 shell 并发 5 → 20;#245MCP 数据边界;#246依赖与工具链升级。
在项目阶段中的位置
- 4.1 仍在第二段「单机服务化」;本版处理上下文所有权、子代理委派与 MCP 数据边界。
- 不把本版写成服务化完成:托管部署、跨实例接管、真实云端验收仍未进入 tag。
- 版本线到阶段的对应是归纳;根
CLAUDE.md只划分三阶段。
未完成项与证据边界
#221的提交正文自报 4 项遗留:A05 索引待裁决、peri.sessionWorkspaceV1门控待裁决、锁调用点级绕过缺口、WASM 红绿链不可独立复核。本页不据此写成已验收。- 仓库另有分支提交
5e691a2ac记录 A05 与 sessionWorkspaceV1 的后续裁决,但它不在 4.1.0 的 tag 历史里;本页不把它当作 4.1.0 的内容。 - tag 日期不是发布日;没有 GitHub Release、制品构建结果与 npm 状态。
升级注意
- 子代理读写硬限制消失,工具面全量继承;小任务也可能被拆分,是否拆分由模型按独立性、风险与验证成本判断。
- 后台 shell 并发上限 20;资源占用可能上升。
- ACP 历史分页需要客户端协商;未协商的客户端仍收到完整历史回放。
