From b6e58dbcc43df1124b6f161e143106552d45e88b Mon Sep 17 00:00:00 2001
From: jkooe <62494645+jkooe@users.noreply.github.com>
Date: Tue, 27 Oct 2026 00:27:17 +0800
Subject: [PATCH] =?UTF-8?q?docs(changelog):=20v2.1.0=20=E5=AE=9A=E7=A8=BF?=
 =?UTF-8?q?=20+=20=E4=BF=AE=E6=AD=A3=E5=8E=86=E5=8F=B2=E6=94=B9=E5=86=99?=
 =?UTF-8?q?=E5=90=8E=E7=9A=84=E6=82=AC=E7=A9=BA=20hash=20=E5=BC=95?=
 =?UTF-8?q?=E7=94=A8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- `## [未发布]` 中已发布的 v2.1.0 段改为 `## [2.1.0] - 2026-10-26`；
  新开 [未发布] 记录发版脚本修复与依赖漏洞清零两条。
- 历史改写（脱敏）后旧提交 hash 不再可达，文档里的引用会变成死链：
  CHANGELOG `efe4744` → `a75c5c9`；ROADMAP `efe4744`/`b09ca68`/`e864486`/`d106214`
  → `a75c5c9`/`5a2c5f9`/`68ea3cd`/`560b3c4`。全仓已无旧 hash 残留。
---
 CHANGELOG.md    | 24 +++++++++++++++++++++++-
 docs/ROADMAP.md |  6 +++---
 2 files changed, 26 insertions(+), 4 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4126646..7209534 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,7 +7,29 @@
 
 ## [未发布]
 
-> 本段为 **v2.1.0** 定稿段（版本统一见 `efe4744`）：selfupdate 代理出网、LKG 内容指针、
+### 修复 —— 发版脚本在版本号已钉在树中时卡死（`451d44a`）
+
+`scripts/release.mjs` 无条件执行 `git commit`。当版本号已经作为 `chore(release)`
+提交进树（v2.1.0 的实际流程）时，`git add -A` 后暂存区为空，`git commit` 以
+`nothing to commit` 非零退出，整个发版停在最后一步，且报错来自 git 而非发布逻辑
+（极易误判为工作区问题）。改为：暂存区为空则跳过 commit，标签与 Release 照常创建。
+
+### 安全 —— 依赖漏洞清零（`pnpm audit --audit-level=high` 由 3 high → 0）
+
+Quality Gate 的「依赖漏洞扫描（SCA）」在 `451d44a` 上为红，全部来自
+`@modelcontextprotocol/sdk` 的传递依赖与本仓 devDependency：
+
+- `zod <4.6.6`（GHSA-mrhx-c7xc-m3w5）→ 根 `pnpm-workspace.yaml` 加 overrides `^4.6.6`；
+- `body-parser <2.4.0`（GHSA-27r3-jxmh-p828）→ overrides `^2.4.0`；
+- `vite <8.3.3`（GHSA-587h-7wmj-h5pm）→ 控制台 devDependency `^8.3.5`。
+
+⚠️ pnpm 12 起 `package.json` 的 `pnpm` 字段不再被读取（设置迁移到
+`pnpm-workspace.yaml`）—— 写在那里会被**静默忽略**，与「一直红所以等于没有」
+是同一类失败形态，故覆盖项写在 workspace 文件里并注明原因。
+
+## [2.1.0] - 2026-10-26
+
+> 本段为 **v2.1.0** 定稿段（版本统一见 `a75c5c9`）：selfupdate 代理出网、LKG 内容指针、
 > 三个架构审查 P0 修复、L2 三端暴露，以及 rollback / 看门狗 / na-gui 清理 / 收口。
 
 ### 新增 —— 控制端 `nodeagent rollback`：从 LKG 回滚被控端（ARCH T03 / PRD P0-2）
diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md
index 288ea31..6e5f149 100644
--- a/docs/ROADMAP.md
+++ b/docs/ROADMAP.md
@@ -457,15 +457,15 @@ node scripts/verify.mjs --host <地址> --key <密钥> --report <报告.md>
 
 | 项 | 状态 | 落点 |
 |---|---|---|
-| 版本统一 v2.1.0 + CHANGELOG 骨架 | ✅ | `efe4744` |
+| 版本统一 v2.1.0 + CHANGELOG 骨架 | ✅ | `a75c5c9` |
 | selfupdate 代理出网（NA_PROXY→env→系统代理） | ✅ | `apps/agent/src/net/proxy.ts` |
 | LKG 内容指针（`hash_full` / `backup_glob`） | ✅ | `apps/agent/src/lkg.ts` |
 | 控制端 rollback（ARCH T03） | ✅ | `apps/cli/src/cmd/rollback.ts` |
 | 看门狗启动自动恢复（决策 R-1） | ✅ | `scripts/startup-guard.mjs` + 三端 supervisor 接入 |
-| L2 三端暴露（MCP `na_audit_l2` + 控制台 + `agent.l2`） | ✅ | `b09ca68` |
+| L2 三端暴露（MCP `na_audit_l2` + 控制台 + `agent.l2`） | ✅ | `5a2c5f9` |
 | na-gui 陈旧计划任务白名单清理 | ✅ | `scripts/lib/scheduled-tasks.mjs` + `control.ps1 cleanup` |
 | L2 e2e + 文档数字守卫 | ✅ | `tests/e2e/*`、`tests/unit/docs-numbers.test.mjs` |
-| 架构审查三 P0（validate 原型链 / 限速桶 key / describeArgs） | ✅ | `e864486`、`d106214` |
+| 架构审查三 P0（validate 原型链 / 限速桶 key / describeArgs） | ✅ | `68ea3cd`、`560b3c4` |
 
 ### 遗留（P2 登记，明确不塞进 v2.1.0）