@@ -0,0 +1,102 @@
# 基座 v0.2.0 发版记录
| 项 | 内容 |
|---|---|
| 状态 | **候选已就绪，tag 待 owner 执行 ** （高后果操作双钥匙：发布版本由 owner 亲手打 tag 并推送） |
| 发版授权 | owner 2026-10-09 会话：「越快越好，你来执行即可，我已同意」（Q3）。Agent 完成候选组合、验证与本记录；tag 创建与推送按 AGENTS.md 双钥匙规则由 owner 执行 |
| 主任务 | Dev 仓 `feature/base-v020-release` （任务卡即本次发版的主记录） |
| 规范依据 | Agent-System-RDM `docs/materials/12-基座发版核对清单.md` ； 扩展面兼容与演进 ](../proposals/2026-10-01-extension-compat-policy.md ) §5 |
## 1. 范围
v0.2.0 是第二段发版：在 v0.1.0 评估基线之上，附 experimental 兼容承诺（实验窗口内仍可破坏性调整，但须改快照并在提案记录）。
相对 v0.1.0 的公开面（`pkg/extension` ， `2.0.0-experimental` → * * `2.5.0-experimental` **）：
| 扩展 | 公开面 | 来源 |
|---|---|---|
| EXT-1 | `Handler` 、`Host` 、`Request` 、`Registry.AddCommandHandler` | Backend #66 |
| EXT-5 | `Host.ParseDocument` ；内置 xlsx/pptx 解析 | Backend #67 、#68 |
| EXT-8 | `ResourceAuthorizer` 、`Registry.RegisterResourceAuthorizer` ；工件/检索/项目流/向量/hostapi 共享读取 | Backend #105 、#107 、#109 |
| EXT-9 | `Host.KnowledgePublish` 、`Host.KnowledgeDelete` 、`Options.DisableUploadIndexing` | Backend #106 |
| EXT-11 | `SetScopedHostFactory` 、`NewScopedHost` | Backend #108 |
| EXT-12 | `Options.DisableConvCardMirror` | Backend #107 |
| 执行原语硬关闭 | `Options.DisableExecTools` ； `--disable-exec-tools` 、配置键 `disableExecTools` 、环境变量 `AGENT_SYSTEM_DISABLE_EXEC_TOOLS` | Backend #110 |
同时包含的缺陷修复与行为变化（不改公开面）：
- 命令审计按 owner 存储与查询（v0.1.0 的 `GET /api/commands/audit` 跨租户可见；Backend `e0b1c27` ，随 #105 合入）；
- DOCX 解析保留修订插入、超链接与域结果内的文字；删除/移走的原文与域代码不进正文；含修订时显式告警（Backend #110 ）；
- agent-stack N1– – – #69 – #103 ）。
**升级须知（下游） ** ：
- 多用户共享部署在执行隔离就位前，应设置 `Options.DisableExecTools = true` 。只关闭用户设置 `runtime.exec` 不够，因为任何用户都能经 `PUT /api/settings/user` 把它改回 true。
- 下游 go.mod 的 8 条 deps replace 不变（compat-policy §4）。
- 下游兼容验证：RDM PR #113 头 `d49d5c9` 的源码在 replace 指向本次 backend 候选时 `go build ./...` 与 `go test ./...` 通过（SELF，
## 2. 候选组合
| 仓 | 提交 | 依据 |
|---|---|---|
| Backend | 由 Dev 合入提交的 gitlink 决定（Backend main `f1c9cc0` 或其后） | Backend #110 合入；CI `ci / vet-and-test (push)` success |
| Core | `a253a40b8e5563119b00c4e71fb61fe0d11d6d6a` | == Dev gitlink == backend `deps/agent-system-core` （同 commit 约束） |
| Frontend | `84b73ab32848e623d0a0ab7ade552784dca8cf3c` | == Dev gitlink == Frontend main |
| UI | `76d6633736a7abb36ac1ecca42fe4e6f120d0558` | == Dev gitlink == UI main |
| Dev | 本任务 PR 合入 main 后的合入提交 | Dev CI（ `make test` + `make build` ）
最终 SHA 以 Dev 合入后 `git ls-tree <Dev 合入提交> modules/` 的实际输出为准，执行前按 §4 核对。
**UI 仓自身 CI 现状 ** ： `ci.yml` 跑在 `nightly` 运行器上，自 2026-10-04 起每次都失败于 vitest 启动（`Cannot find native binding` ，rolldown 可选依赖），与代码无关。同一 UI 提交在 Dev 组合 CI 中 `npm ci && tsc && vitest` 通过（14 文件 / 103 用例；Dev run 1369），本地 Node 26 复验同样通过。v0.2.0 以 Dev 组合 CI 为 UI 的权威验证；UI 仓 runner 修复另列后续任务。
## 3. tag 消息（五仓一致）
```
SurfaceVersion 2.5.0-experimental. Adds in-proc command handlers, the owner-scoped host handle, document parsing, resource authorization, knowledge publish/revoke, scoped host recovery, the card mirror switch and the exec hard switch.
```
## 4. owner 执行步骤
先在 Dev 主检出确认合入后的组合（只读）：
``` bash
cd /home/weichen/projects/Agent-System-Dev && git fetch origin && git checkout main && git pull --ff-only
git status --porcelain # 必须为空
DEV = $( git rev-parse origin/main) ; echo $DEV
git ls-tree $DEV modules/backend modules/core modules/frontend modules/ui
# core 同 commit：以下三行必须相同
git ls-tree $DEV modules/core | awk '{print $3}'
git -C modules/core rev-parse HEAD
git -C modules/backend/deps/agent-system-core rev-parse HEAD
```
然后子仓先、Dev 后，逐仓打 tag（`<SHA>` 用上面 `ls-tree` 打印的该仓 gitlink）：
``` bash
MSG = 'SurfaceVersion 2.5.0-experimental. Adds in-proc command handlers, the owner-scoped host handle, document parsing, resource authorization, knowledge publish/revoke, scoped host recovery, the card mirror switch and the exec hard switch.'
for m in backend core frontend ui; do
SHA = $( git ls-tree $DEV modules/$m | awk '{print $3}' )
git -C modules/$m fetch origin && git -C modules/$m tag -a v0.2.0 " $SHA " -m " $MSG " && git -C modules/$m push origin v0.2.0
done
git tag -a v0.2.0 " $DEV " -m " $MSG " && git push origin v0.2.0
```
推完核对（五处一致）：
``` bash
for m in backend core frontend ui; do
echo " $m tag= $( git -C modules/$m rev-parse v0.2.0^{ commit} ) gitlink= $( git ls-tree v0.2.0 modules/$m | awk '{print $3}' ) "
done
git ls-remote --tags origin v0.2.0
```
## 5. 发版后（Agent 可执行，tag 在位后启动）
- RDM 升钉到 v0.2.0 五仓 tag，并重定基合入 #113/ #114 （
- RDM 二进制设置 `DisableExecTools: true` （
- Releases 仓按 `scripts/build-release.sh 0.2.0` 构建制品与 manifest（另立任务，内部发布，不公开）。
## 6. 不做的事
- 不使用 `v0.2.0-experimental` 这类 tag 名；不在实验窗口发布 npm；不改 Go module path。
- RDM 仓 v0.2.0 tag 不在本次范围（RDM 升钉完成后另行评估）。