v3.0.0

Changes

• feat!: 连接组重做成只读状态，删 apiKey 与 baseUrl (#34) @zlZayn
• chore(deps): 升 vitest 4.1.11 + esbuild 0.28.2（覆盖全部 dev 链 CVE） (#30) @zlZayn
• chore(deps-dev): bump source-map-js from 1.2.1 to 1.2.2 (#26) @dependabot[bot]

Features

• chore: 迁到 pnpm，并把发布链补齐成两条入口 (#33) @zlZayn

Documentation

• docs(readme): 门面重写为四个问题 + 结构对齐红线 (#31) @zlZayn

v2.3.1

变更摘要

Documentation

• docs: BACKEND-ARCHITECTURE.md → BACKEND-CONTRACTS.md (#23) @zlZayn
• docs: docs/ 文件名统一大写，拆分后端架构文档，发版正文改读草稿 (#22) @zlZayn
• docs: 加核心活文档首行标题守卫，并同步一处措辞 (#21) @zlZayn
• docs: 三份勘察/评估/审查记录移入 notes，docs 只留活文档 (#20) @zlZayn

v2.3.0

What's Changed

• feat(storage): 快照按账本保留最近 20 条，并修掉读不回来的占位账本键 by @zlZayn in #16
• ci: 引入 Release Drafter 维护草稿 Release，并同步标签约定文档 by @zlZayn in #17
• fix(storage): 补启动时的一次性清理，修首次升级卡死宿主 by @zlZayn in #18
• docs: 保留策略按「契约 + 指针」重排，并补多账号=多桶事实 by @zlZayn in #19

Full Changelog: v2.2.0...v2.3.0

---

这一版修了什么

快照只增不删（#16）。按账本保留最近 20 条，写入路径上清理。
保留是按账本的，总量 = 20 × 账本数 —— 切换账号会开新账本、各留各的 20 条，
所以数据文件里有上百条不代表没清干净，先数账本数。

首次升级会卡死宿主（#18）。#16 的清理只覆盖稳态：存量很大时（实测 9000 条 / 3.8 MB）
跟着写入节奏慢慢删要两个多小时，期间侧栏无限转圈、Agent 停止响应。
#18 补了启动时的一次性清理（带单次上限），首次读取就是瘦的。

产物一致性复核

项	值
本地 npm pack 的 sha1	d08c60055beae403ac5b08850ac1cece6c12a23f
npm 上 dist.shasum	d08c60055beae403ac5b08850ac1cece6c12a23f

逐字节相同（与发布流水线日志里的 shasum 也一致）。
integrity：sha512-jZt8YeW3/DPdUpcAr89Ra+PElnPBN1tHsnkZ4y7PeTBwb3pXm6u4jt9je+52VzjDC8kc1VFZw9pxjR+Kg/YiUQ==

一个值得记的事实

2.2.0 是上一个 latest，而保留策略（#16）与启动清理（#18）都在它之后 ——
两者都未曾发布。所以「首次升级卡死宿主」那个窗口没有用户中招过，
且本版是第一个带保留策略的版本、必然已包含启动清理 —— 这个窗口结构性不存在。
（为验证 PR 流程做过一次 main 回滚，当时撤回的 2.2.1 从未推到 npm。）

兼容性

跑在 next 线（宿主 0.2.0-rc.2）上验证：declaration 24 条声明全部罩住、
PASS engines.dsh —— >=0.2.0-rc.2、503/503 全绿。

已知代价（不夸大）

单次启动的清理时间有确定上界，但总收敛时间取决于启动频率与写入频率 ——
收敛只保证「每次都有进展」，不保证「多久到终态」。
single 布局下每次删除都要原子重写整份单元文件，文件越大每次越慢。

详见 .agents/notes/2026-10-09-snapshot-retention.md。

v2.2.0

Full Changelog: v2.1.3...v2.2.0

产物一致性复核

• 本地 npm pack 的 sha1：b7c1185ce8069c1e904acefc15db901df5580c87
• npm 上 dist.shasum：b7c1185ce8069c1e904acefc15db901df5580c87
• 结论：逐字节相同（复核口径见 AGENTS.md 的「验证快照」）

发布前确认

• check:release / typecheck / npm test 全绿；check:declaration 24/24 罩得住 next 线；release-guard 判「有产物改动，允许发版」。
• node scripts/acceptance.mjs 未跑：发布环境没有 DEEPSEEK_API_KEY，打真实上游那一段做不了。这是本次唯一没做的检查。

v2.1.3

Full Changelog: v2.1.2...v2.1.3

v2.1.2

Full Changelog: v2.1.1...v2.1.2

v2.1.1

What's Changed

• docs: 发布态同步到 2.1.0（含待办回填项） by @zlZayn in #12
• docs: 回填 npm latest = 2.1.0（产物一致性已复验） by @zlZayn in #13

Full Changelog: v2.1.0...v2.1.1

v2.1.0

What's Changed

• docs: AGENTS.md 发布态更新到 2.0.0（tag / Release / dist-tag 按现查写） by @zlZayn in #9
• docs: AGENTS.md 另两处同事实陈旧点跟上 2.0.0（L6、L77） by @zlZayn in #10
• feat(sidebar): 浮层图标接上面板深链，直达本插件配置格（宿主 rc 线起） by @zlZayn in #11

Full Changelog: v2.0.0...v2.1.0

v2.0.0

What's Changed

• refactor: replace unsafe type casts with narrowing and iteration idioms by @zlZayn in #2
• refactor: 宿主半边的「异常压行」收敛成 domain/errors 的 describeError by @zlZayn in #4
• refactor: 客户端与线上两侧的错误码收窄到闭集，去掉冗余断言 by @zlZayn in #5
• refactor: 三张阈值/分组表钉成 as const satisfies by @zlZayn in #6
• fix(scripts): acceptance 全过时不再被退出期崩溃掩成非 0 by @zlZayn in #7
• chore: release v2.0.0 by @zlZayn in #8

New Contributors

• @zlZayn made their first contribution in #2

Full Changelog: v1.1.0...v2.0.0

v2.0.0-alpha.2

Full Changelog: v1.1.0...v2.0.0-alpha.2