diff --git a/docs/releases/xworkmate-changelog.md b/docs/releases/xworkmate-changelog.md
index 29845b04..6d6ffcb4 100644
--- a/docs/releases/xworkmate-changelog.md
+++ b/docs/releases/xworkmate-changelog.md
@@ -1,76 +1,228 @@
 # XWorkmate Changelog
 
-> Generated by `tool/render_release_docs.dart`
-> Source manifest: [`config/feature_flags.yaml`](../../config/feature_flags.yaml)
-> Generated at: `2026-03-24T00:32:25.947047`
+> Historical changelog normalized for `v0.1` through `v0.7`.
+> Snapshot rule: prefer release tag; if no tag exists, use the release branch snapshot.
+> Special case: `v0.3` is recorded from `release/v0.3` because no `v0.3` tag exists in git.
 
-## Git Snapshot
+## Release Sequence
 
-| 字段 | 值 |
+| Version | Date | Snapshot Ref | Branch | Version String |
+| --- | --- | --- | --- | --- |
+| `v0.7` | `2026-03-24` | `v0.7` | `release/v0.7` | `0.7.0+1` |
+| `v0.6.1` | `2026-03-22` | `v0.6.1` | `main` hotfix | `0.6.1+1` |
+| `v0.6` | `2026-03-22` | `v0.6` | `release/v0.6` | `0.6.0+1` |
+| `v0.5` | `2026-03-20` | `v0.5` | `release/v0.5` | `0.5.0+1` |
+| `v0.4` | `2026-03-15` | `v0.4` | `release/v0.4` | `0.4.0+2` |
+| `v0.3` | `2026-03-13` | `release/v0.3` | `release/v0.3` | `latest` |
+| `v0.2` | `2026-03-12` | `v0.2` | `release/v0.2` | `2026.3.11+20260311` |
+| `v0.1` | `2026-03-11` | `v0.1` | `release/v0.1` | `2026.3.11+20260311` |
+
+## Matrix Availability
+
+| Version | Feature Matrix |
 | --- | --- |
-| Branch | `release/v0.7` |
-| Head Commit | `fd402c3` |
-| Head Tags | `-` |
-| Latest Tag | `v0.6.1` |
-| Previous Tag | `v0.6` |
-| Comparison Range | `v0.6.1..HEAD` |
+| `v0.7` | `mobile 26/18/18/6`, `desktop 26/20/19/5`, `web 8/8/8/7` |
+| `v0.6.1` | `mobile 27/19/19/2`, `desktop 27/21/20/1`, `web 8/8/8/4` |
+| `v0.6` | `mobile 28/19/19/1`, `desktop 28/22/21/0`, `web 8/8/8/4` |
+| `v0.1` - `v0.5` | feature flag manifest not yet introduced |
 
-## Recent Tags
+## Per-Version Log
 
-| Tag | Date |
-| --- | --- |
-| `v0.6.1` | `2026-03-22` |
-| `v0.6` | `2026-03-22` |
-| `v0.5` | `2026-03-20` |
-| `v0.4` | `2026-03-15` |
-| `v0.2` | `2026-03-12` |
+### `v0.7` — `2026-03-24`
 
-## Commits
+**Highlights**
 
-| Hash | Date | Author | Subject |
-| --- | --- | --- | --- |
-| `fd402c3` | `2026-03-24` | Haitao Pan | Bump release version to 0.7.0 |
-| `f1a4793` | `2026-03-24` | Haitao Pan | Fix Codex ACP turn payload schema |
-| `a734d34` | `2026-03-24` | Haitao Pan | Fix single-agent ACP model ownership |
-| `9679f12` | `2026-03-23` | Haitao Pan | Restore ACP settings save/apply actions |
-| `23d8974` | `2026-03-23` | Haitao Pan | Fix secrets settings tab assertion |
-| `9a0cf2c` | `2026-03-23` | Haitao Pan | Add ACP endpoint settings tab |
-| `c7bd585` | `2026-03-23` | Haitao Pan | Isolate test persistence roots |
-| `3ce78ae` | `2026-03-23` | Haitao Pan | Update CocoaPods locks for file-backed store |
-| `299291d` | `2026-03-23` | Haitao Pan | Harden file persistence fallback state |
-| `3419f03` | `2026-03-23` | Haitao Pan | Recover deleted transient workspace paths |
-| `22ceb3b` | `2026-03-23` | Haitao Pan | Rebuild desktop persistence as file stores |
-| `c7101bf` | `2026-03-23` | Haitao Pan | Remove legacy persistence implementation |
-| `e1ea5a5` | `2026-03-23` | Haitao Pan | Fix macOS package build state reset |
-| `c9852fd` | `2026-03-23` | Haitao Pan | Rename ARIS bridge to go core |
-| `048eb0c` | `2026-03-23` | Haitao Pan | Remove legacy settings recovery path |
-| `0a520f7` | `2026-03-23` | Haitao Pan | Remove discoveredSkills runtime remnants |
-| `608b9f3` | `2026-03-23` | Haitao Pan | Clean up first-batch single-agent skills flow |
-| `89b90db` | `2026-03-23` | Haitao Pan | Add local single-agent skill discovery |
-| `beed9f9` | `2026-03-23` | Haitao Pan | Refine gateway source chip labels |
-| `92547b1` | `2026-03-23` | Haitao Pan | Isolate gateway secrets per profile slot |
-| `8d6c4a9` | `2026-03-23` | Haitao Pan | Simplify durable storage initialization |
-| `bdcc1fe` | `2026-03-23` | Haitao Pan | fix: update external agent ACP copy |
-| `89b3826` | `2026-03-23` | Haitao Pan | Refine LLM endpoint settings layout |
-| `55df3db` | `2026-03-23` | Haitao Pan | merge: external single-agent app-server for app store |
-| `7540a3a` | `2026-03-23` | Haitao Pan | refactor(appstore): use external single-agent app-server |
-| `b53b853` | `2026-03-23` | Haitao Pan | refactor: rename AI Gateway UI copy to LLM API |
-| `28b279f` | `2026-03-23` | Haitao Pan | chore(release): bump to v0.6.2 and gate account access |
-| `fbc4f55` | `2026-03-23` | Haitao Pan | fix(release): harden apple app store distribution |
-| `213ca0e` | `2026-03-23` | Haitao Pan | merge: acp mainline convergence |
-| `aad97a9` | `2026-03-23` | Haitao Pan | feat(acp): converge runtime pipeline to go acp core |
-| `d1686b7` | `2026-03-23` | Haitao Pan | feat(settings): gate vault server behind experimental flag |
-| `82a33b8` | `2026-03-23` | Haitao Pan | refactor(desktop): route assistant execution through gateway ACP |
-| `4a3369c` | `2026-03-23` | Haitao Pan | Merge branch 'codex/config-store-durable-path' |
-| `1d27b05` | `2026-03-23` | Haitao Pan | Enforce durable config paths and disable implicit memory fallback |
-| `32ef635` | `2026-03-23` | Haitao Pan | Fix codex external CLI availability detection with configured path |
-| `6368817` | `2026-03-23` | Haitao Pan | Refine single-agent thread scoped provider flow |
-| `41a32a2` | `2026-03-23` | Haitao Pan | Add local tmp cache directory |
-| `8cf26a9` | `2026-03-23` | Haitao Pan | Validate workflow and archive results |
-| `963ff9b` | `2026-03-23` | Haitao Pan | Remove task CTA noise from assistant and tasks views |
-| `ac7f932` | `2026-03-23` | Haitao Pan | Make gateway integration sections collapsible |
-| `085041e` | `2026-03-23` | Haitao Pan | Rename AI Gateway mode to Single Agent |
-| `96f2cd1` | `2026-03-23` | Haitao Pan | docs: clarify architecture baselines |
-| `7994d42` | `2026-03-23` | Haitao Pan | chore: remove CodexBar submodule |
-| `17501c9` | `2026-03-23` | Haitao Pan | fix: disable default OpenAI web cookie import |
-| `89bd492` | `2026-03-23` | Haitao Pan | Unify gateway settings actions and harden persistence tests |
+- 新增 ACP 外部接入设置页和 provider 级 endpoint 配置。
+- Single Agent 与外部 ACP 链路完成真实协议打通。
+- 持久化和打包分发路径延续收敛到文件存储布局。
+
+**FIX**
+
+- `f1a4793` Fix Codex ACP turn payload schema
+- `a734d34` Fix single-agent ACP model ownership
+- `23d8974` Fix secrets settings tab assertion
+- `32ef635` Fix codex external CLI availability detection with configured path
+- `fbc4f55` fix(release): harden apple app store distribution
+
+**Refactors**
+
+- `82a33b8` refactor(desktop): route assistant execution through gateway ACP
+- `b53b853` refactor: rename AI Gateway UI copy to LLM API
+- `7540a3a` refactor(appstore): use external single-agent app-server
+- `c7101bf` Remove legacy persistence implementation
+- `22ceb3b` Rebuild desktop persistence as file stores
+
+**Issue Notes**
+
+- 发布说明中仍保留全量 `flutter test` 的既有失败和 macOS foreground flake。
+
+### `v0.6.1` — `2026-03-22`
+
+**Highlights**
+
+- secure config / settings / secret store 的 fallback、回写和初始化逻辑进一步补齐。
+- Integrations 与 gateway profiles 被收拢到统一 settings center。
+- remote thread status fallback 修复后，线程状态回退逻辑更稳。
+
+**FIX**
+
+- `95ae875` Fix remote thread status fallback
+- `98409d1` Refine AI Gateway action buttons
+
+**Refactors**
+
+- `ffced7f` Refactor settings persistence and upgrade recovery
+- `abea2b4` Integrate gateway settings into integrations page
+- `72ecd1f` Unify legacy config pages into settings center
+- `5d49ae3` Refactor assistant page and gateway runtime integration
+- `5cab0f5` Refactor work modes and gateway profiles
+
+**Issue Notes**
+
+- 没有找到独立 hotfix issue 清单；后续 `v0.7` 区间继续处理持久化测试、外部 ACP 文案和设置交互。
+
+### `v0.6` — `2026-03-22`
+
+**Highlights**
+
+- secure-storage 加密持久化正式进入主线。
+- Single Agent 本地技能发现与线程恢复补齐。
+- Web / mobile / desktop 多端可用性与 build-and-release 链路同步增强。
+
+**FIX**
+
+- `8f655d3` Fix web chrome test isolation and session persistence
+- `10717a0` fix(runtime): encrypt local settings and assistant thread persistence
+- `09287cc` Fix assistant thread connection status
+- `50f38e8` Fix assistant composer shell height adaptation
+- `4ea4c06` Fix assistant execution target switch refresh timing
+
+**Refactors**
+
+- `7793e92` refactor: unify settings drill-in navigation
+- `0d3b9b1` refactor: align multi-agent workflow with real ollama cli
+- `c24f2ab` feat: add ui feature flag release docs pipeline
+- `77ab128` Persist assistant state and add local recovery cleanup
+
+**Issue Notes**
+
+- release notes 明确记录：外部 CLI / Gateway 依赖环境、macOS integration 串行执行问题仍在。
+
+### `v0.5` — `2026-03-20`
+
+**Highlights**
+
+- 流式 assistant 线程、任务归档与重启恢复落地。
+- 任务列表按执行目标分组。
+- Multi-Agent runtime、ARIS bundle 和 Go bridge runtime 进入可交付状态。
+
+**FIX**
+
+- `09ef2ea` Fix settings page layout and AI Gateway persistence
+- `7c98ab3` Fix AI Gateway-only assistant flow
+- `41e0632` Fix assistant model routing and task naming
+- `039ce2d` Fix AI Gateway-only UTF-8 chat flow
+- `0438dc5` Repair codex integration test baseline
+
+**Refactors**
+
+- `4f887e4` feat: add linux desktop parity scaffolding
+- `f0070c6` feat: align Windows desktop runtime with macOS parity
+- `02a0f89` feat: add shared compact mobile shell
+- `b9cdb7d` Add managed multi-agent collaboration runtime
+- `47473e0` Integrate ARIS bundle and Go bridge runtime
+- `6280e75` Stabilize ARIS packaging and Ollama Cloud settings
+
+**Issue Notes**
+
+- 发布说明明确保留：built-in Codex / Rust FFI 未交付、通用 provider 调度 UI 未完成、外部 CLI 全链路仍需人工验证。
+
+### `v0.4` — `2026-03-15`
+
+**Highlights**
+
+- Assistant 成为默认主页。
+- 任务、导航、关注入口、面包屑和动态侧板整合为统一工作台。
+- external-first Codex 路线成形。
+
+**FIX**
+
+- `430272d` fix: remove undefined _CodexBridgeCard reference to fix build
+- `04b52c3` fix: resolve Rust FFI compilation errors and simplify build
+- `9c47eef` fix: show assistant task rail on desktop
+
+**Refactors**
+
+- `e87df77` refactor(ui): modernize design system with consistent spacing and typography
+- `8199f2a` refactor: 重命名 MCP Server 为 MCP Hub
+- `f541e9e` feat(runtime): add built-in/external codex modes and external agent provider registry
+- `cacdb70` feat: expand codex bridge integration and assistant workspace
+- `2e467fa` feat: unify assistant sidebar and task list
+
+**Issue Notes**
+
+- 当时 release notes 已单列 `flutter analyze`、`flutter test` 和 macOS device-run 的既有失败。
+
+### `v0.3` — `2026-03-13`
+
+**Highlights**
+
+- AI Gateway integration 与 UI polish 完成一轮补齐。
+- paired device 状态与桌面版面密度得到收敛。
+
+**FIX**
+
+- `7ea6e0d` fix: simplify paired device status display
+- `3dfb444` fix: trim wasted desktop page bottom spacing
+
+**Refactors**
+
+- `02a2e5c` refactor: normalize desktop typography and density
+- `edd46d6` chore: unify version to v0.2 with build-date and build-id
+
+**Issue Notes**
+
+- 该版本无正式 tag，也无独立 release notes；本段基于 `v0.2..release/v0.3` 提交区间整理。
+
+### `v0.2` — `2026-03-12`
+
+**Highlights**
+
+- gateway-driven assistant baseline 完成。
+- device pairing controls、diagnostics log viewer、secure shared token handling 首次落地。
+
+**FIX**
+
+- `7a86703` fix: improve remote gateway bootstrap prefill
+- `acc3a06` fix: stabilize remote gateway pairing identity
+
+**Refactors**
+
+- 该版本仍处于早期基线期，主要新增以功能交付为主，重构记录较少。
+
+**Issue Notes**
+
+- 后续 `v0.3` 才继续补齐 AI Gateway integration polish、密度和状态展示收口。
+
+### `v0.1` — `2026-03-11`
+
+**Highlights**
+
+- 初始 Flutter workspace shell 和桌面工作区结构建立。
+- tri-state sidebar、resizable layout、语言切换、macOS App Store 准备项到位。
+
+**FIX**
+
+- `09d29f6` Fix expanded sidebar navigation layout
+- `7693de2` Reduce minimum sidebar width
+
+**Refactors**
+
+- `486e9aa` Move composer actions menu to the left
+- `af5098c` Polish workspace theme and add Makefile tasks
+- `f179a11` Simplify expanded sidebar action tiles
+- `518549b` Remove expanded sidebar header title
+
+**Issue Notes**
+
+- 后续 `v0.2` 才引入 gateway-driven assistant、诊断日志和配对能力，说明 `v0.1` 仍是 UI 与打包基线版本。
diff --git a/docs/releases/xworkmate-release-notes.md b/docs/releases/xworkmate-release-notes.md
index 73b719ae..3b09a7f8 100644
--- a/docs/releases/xworkmate-release-notes.md
+++ b/docs/releases/xworkmate-release-notes.md
@@ -1,100 +1,271 @@
 # XWorkmate Release Notes
 
-> Generated by `tool/render_release_docs.dart`
-> Source manifest: [`config/feature_flags.yaml`](../../config/feature_flags.yaml)
-> Generated at: `2026-03-24T00:32:25.947047`
+> Curated historical release record for `v0.1` through `v0.7`.
+> Sources: git tags / release branches, `CHANGELOG.md`, and `config/feature_flags.yaml` when present.
+> Note: `config/feature_flags.yaml` does not exist in `v0.1` through `v0.5`, so those versions do not have a first-class feature flag matrix baseline.
 
-## Git Snapshot
+## Release Ledger
 
-| 字段 | 值 |
-| --- | --- |
-| Branch | `release/v0.7` |
-| Head Commit | `fd402c3` |
-| Head Tags | `-` |
-| Latest Tag | `v0.6.1` |
-| Previous Tag | `v0.6` |
-| Comparison Range | `v0.6.1..HEAD` |
-| Commit Count | 45 |
-
-## Feature Snapshot
-
-| 平台 | Debug | Profile | Release | Suppressed |
+| Version | Date | Snapshot Ref | Branch | Matrix Source |
 | --- | --- | --- | --- | --- |
-| `mobile` | 26 | 18 | 18 | 6 |
-| `desktop` | 26 | 20 | 19 | 5 |
-| `web` | 8 | 8 | 8 | 7 |
+| `v0.7` | `2026-03-24` | `v0.7` | `release/v0.7` | `config/feature_flags.yaml` |
+| `v0.6.1` | `2026-03-22` | `v0.6.1` | `main` hotfix | `config/feature_flags.yaml` |
+| `v0.6` | `2026-03-22` | `v0.6` | `release/v0.6` | `config/feature_flags.yaml` |
+| `v0.5` | `2026-03-20` | `v0.5` | `release/v0.5` | not yet introduced |
+| `v0.4` | `2026-03-15` | `v0.4` | `release/v0.4` | not yet introduced |
+| `v0.3` | `2026-03-13` | `release/v0.3` | `release/v0.3` | not yet introduced |
+| `v0.2` | `2026-03-12` | `v0.2` | `release/v0.2` | not yet introduced |
+| `v0.1` | `2026-03-11` | `v0.1` | `release/v0.1` | not yet introduced |
 
-## Current Focus
+## Matrix Baseline
 
-- `release` 当前面向用户暴露 45 个 UI feature flags，全部来自 `stable` tier。
-- `profile` 相比 `release` 额外开放 1 个预发布条目： `desktop.assistant.multi_agent`。
-- `debug` 相比 `profile` 额外开放 14 个实验条目： `mobile.navigation.secrets`, `mobile.workspace.mcp_server`, `mobile.workspace.claw_hub`, `mobile.assistant.multi_agent`, `mobile.settings.experimental`, `mobile.settings.experimental_canvas`, `mobile.settings.experimental_bridge`, `mobile.settings.experimental_debug`, `desktop.navigation.mcp_server`, `desktop.navigation.claw_hub`, `desktop.settings.experimental`, `desktop.settings.experimental_canvas`, `desktop.settings.experimental_bridge`, `desktop.settings.experimental_debug`。
+| Version | Mobile D/P/R/S | Desktop D/P/R/S | Web D/P/R/S | Visible Flags R/P/D |
+| --- | --- | --- | --- | --- |
+| `v0.7` | `26 / 18 / 18 / 6` | `26 / 20 / 19 / 5` | `8 / 8 / 8 / 7` | `45 / 46 / 60` |
+| `v0.6.1` | `27 / 19 / 19 / 2` | `27 / 21 / 20 / 1` | `8 / 8 / 8 / 4` | `47 / 48 / 62` |
+| `v0.6` | `28 / 19 / 19 / 1` | `28 / 22 / 21 / 0` | `8 / 8 / 8 / 4` | `48 / 49 / 64` |
 
-## Commit Highlights
+## Version Notes
 
-### Features
+### `v0.7` — `2026-03-24`
 
-- `9a0cf2c` Add ACP endpoint settings tab
-- `89b90db` Add local single-agent skill discovery
-- `aad97a9` feat(acp): converge runtime pipeline to go acp core
-- `d1686b7` feat(settings): gate vault server behind experimental flag
-- `41a32a2` Add local tmp cache directory
+**Feature Matrix**
 
-### Fixes
+- `release` 可见 45 个 flags，`profile` 46 个，`debug` 60 个。
+- 相比 `v0.6.1`，`release` 少 2 个、`debug` 少 2 个，重点是收敛实验入口和未完备设置项。
 
-- `f1a4793` Fix Codex ACP turn payload schema
-- `a734d34` Fix single-agent ACP model ownership
-- `23d8974` Fix secrets settings tab assertion
-- `e1ea5a5` Fix macOS package build state reset
-- `bdcc1fe` fix: update external agent ACP copy
-- `fbc4f55` fix(release): harden apple app store distribution
-- `32ef635` Fix codex external CLI availability detection with configured path
-- `17501c9` fix: disable default OpenAI web cookie import
+**Highlights**
 
-### Build / Release
+- 新增 `ACP 外部接入`，为 `Codex / OpenCode / Claude / Gemini` 提供独立 endpoint 配置。
+- Single Agent 外部 ACP 模式改为显示 ACP 实际运行时模型，不再错误复用本地 LLM API 模型。
+- Codex ACP `thread/start` / `turn/start` / `input` item 协议打通，真实 WebSocket 任务链路可用。
+- 文件持久化布局稳定为 `settings.yaml`、`tasks/*.json`、`secrets/*.secret`。
 
-- `8cf26a9` Validate workflow and archive results
+**Fixes**
 
-### Docs
+- 修复 Codex ACP turn payload schema。
+- 修复 single-agent ACP 模型归属。
+- 修复 secrets settings tab assertion 和外部 CLI 可用性检测。
+- 修复 macOS package build state reset，继续加固 App Store 分发。
 
-- `96f2cd1` docs: clarify architecture baselines
+**Refactors**
 
-### Refactors
+- assistant 执行链路切到 gateway ACP。
+- `AI Gateway` UI 文案统一收口到 `LLM API` / `Single Agent`。
+- 外部 single-agent app-server 用于 App Store 分发路径。
 
-- `7540a3a` refactor(appstore): use external single-agent app-server
-- `b53b853` refactor: rename AI Gateway UI copy to LLM API
-- `82a33b8` refactor(desktop): route assistant execution through gateway ACP
+**Known Issues**
 
-### Merges
+- `flutter test` 全量仍有既有失败：`assistant_page_test` 的 pending timer 与 `modules_page_test` 的重复文案断言。
+- macOS device-run 仍可能触发 `Failed to foreground app; open returned 1`，需要串行执行并配合人工检查。
 
-- `4a3369c` Merge branch 'codex/config-store-durable-path'
+### `v0.6.1` — `2026-03-22`
 
-### Other
+**Feature Matrix**
 
-- `fd402c3` Bump release version to 0.7.0
-- `9679f12` Restore ACP settings save/apply actions
-- `c7bd585` Isolate test persistence roots
-- `3ce78ae` Update CocoaPods locks for file-backed store
-- `299291d` Harden file persistence fallback state
-- `3419f03` Recover deleted transient workspace paths
-- `22ceb3b` Rebuild desktop persistence as file stores
-- `c7101bf` Remove legacy persistence implementation
-- `c9852fd` Rename ARIS bridge to go core
-- `048eb0c` Remove legacy settings recovery path
-- `0a520f7` Remove discoveredSkills runtime remnants
-- `608b9f3` Clean up first-batch single-agent skills flow
-- `beed9f9` Refine gateway source chip labels
-- `92547b1` Isolate gateway secrets per profile slot
-- `8d6c4a9` Simplify durable storage initialization
-- `89b3826` Refine LLM endpoint settings layout
-- `55df3db` merge: external single-agent app-server for app store
-- `28b279f` chore(release): bump to v0.6.2 and gate account access
-- `213ca0e` merge: acp mainline convergence
-- `1d27b05` Enforce durable config paths and disable implicit memory fallback
-- `6368817` Refine single-agent thread scoped provider flow
-- `963ff9b` Remove task CTA noise from assistant and tasks views
-- `ac7f932` Make gateway integration sections collapsible
-- `085041e` Rename AI Gateway mode to Single Agent
-- `7994d42` chore: remove CodexBar submodule
-- `89bd492` Unify gateway settings actions and harden persistence tests
+- `release` 可见 47 个 flags，`profile` 48 个，`debug` 62 个。
+- 相比 `v0.6`，矩阵整体略有收口，重点是把账号等未完备入口继续降级或关闭。
 
+**Highlights**
+
+- `SecureConfigStore`、`SettingsStore`、`SecretStore` 补齐标准目录 fallback 与首次启动目录准备。
+- 持久化改为默认 fail-fast，避免数据库或路径异常时静默退回内存。
+- 显式内存 fallback 模式补齐“尽力回写”。
+- `mobile.workspace.account` 与 `desktop.navigation.account` 被关闭为 `experimental` 且 `enabled: false`。
+
+**Fixes**
+
+- 修复 remote thread status fallback。
+- 补齐路径失败报错与跨实例持久化回归覆盖。
+- 收紧 Gateway settings 的动作按钮与集成入口切换。
+
+**Refactors**
+
+- settings persistence / upgrade recovery 重构。
+- gateway settings 并入 Integrations 页。
+- 旧配置页统一并入 settings center。
+- assistant 页面、gateway runtime、work mode / profile 结构重构。
+
+**Known Issues**
+
+- 没有找到独立的 `v0.6.1` issue 列表；从后续 `v0.7` 提交可见，持久化测试基线、外部 ACP 文案和设置交互在该版本后仍继续修整。
+
+### `v0.6` — `2026-03-22`
+
+**Feature Matrix**
+
+- `release` 可见 48 个 flags，`profile` 49 个，`debug` 64 个。
+- `desktop` 在 `debug` 下暴露 28 个可见条目，是当时最完整的平台面。
+
+**Highlights**
+
+- 本地配置、Gateway 凭证与 Assistant 线程会话改为 secure-storage 驱动的加密持久化。
+- Single Agent 线程补齐本地技能自动发现与线程内可选技能恢复。
+- Flutter Web assistant shell、Web Chrome 持久化、移动端安全控件一并补齐。
+- Windows / Linux parity、多平台 build-and-release、macOS 安装分发流程完成一轮系统化增强。
+
+**Fixes**
+
+- 修复 web chrome test isolation 和会话持久化。
+- 修复 assistant thread connection status、composer shell 高度自适应、execution target 切换刷新时序。
+- 修复运行时本地 settings 与 assistant thread persistence 的加密持久化实现。
+
+**Refactors**
+
+- 新增 UI feature flag release docs pipeline。
+- settings drill-in navigation 与多智能体工作流按真实 ollama CLI 统一。
+- assistant composer shell sizing、local recovery cleanup、IA 文档一并梳理。
+
+**Known Issues**
+
+- 外部 CLI / 远程 Gateway 协同仍依赖宿主安装和网络可达性，需要按 case 文档补人工验收。
+- macOS integration 测试仍可能受到宿主前台拉起行为影响，需要串行执行。
+
+### `v0.5` — `2026-03-20`
+
+**Feature Matrix**
+
+- `config/feature_flags.yaml` 尚未进入仓库，无法回放标准化的 D/P/R/S 矩阵。
+- 该版本的“功能矩阵”主要体现在运行模式与平台面扩展，而不是 feature flag 清单。
+
+**Highlights**
+
+- Assistant 线程升级为持续会话，支持流式回复、继续追问、线程归档与重启恢复。
+- 任务列表按 `Single Agent / 本地 OpenClaw Gateway / 远程 OpenClaw Gateway` 分组。
+- Multi-Agent 协作升级为 `Architect / Engineer / Tester`，并可挂载 `ARIS`。
+- ARIS bundle 与 Go runtime 被内嵌到 App 分发链路。
+
+**Fixes**
+
+- 修复 AI Gateway-only assistant flow、模型路由、任务命名与 UTF-8 chat flow。
+- 修复 settings page layout 与 AI Gateway persistence。
+- 修复 codex integration test baseline。
+
+**Refactors**
+
+- Linux / Windows / Android parity 支线合回主线。
+- 桌面 workspace chrome、typography density、gateway dialog、theme surface 做了一整轮压缩与统一。
+- assistant execution target、task list grouping、multi-agent runtime 与 ARIS bridge 被整体重组。
+
+**Known Issues**
+
+- 内置 Codex / Rust FFI 仍未交付，仍是 placeholder。
+- 通用外部 Code Agent provider chooser / 调度 UI 尚未落地。
+- 外部 CLI 全链路协作仍建议按 `docs/cases/README.md` 做手动验证。
+
+### `v0.4` — `2026-03-15`
+
+**Feature Matrix**
+
+- `config/feature_flags.yaml` 尚未引入。
+- 该版本更适合用“桌面工作台结构矩阵”理解：Assistant 成为默认主页，任务、导航、收藏入口和面包屑完成统一。
+
+**Highlights**
+
+- Assistant 成为默认主页，首页围绕默认任务工作台展开。
+- 左侧侧板统一为 `任务 / 导航` 加关注入口，支持折叠、拖拽和动态宽度。
+- 任务列表与当前对话打通，会话默认作为任务上下文持续保留。
+- Codex 路线明确为 external-first，经由 XWorkmate 与 OpenClaw Gateway 协同。
+
+**Fixes**
+
+- 修复 undefined `_CodexBridgeCard` 构建错误。
+- 修复 Rust FFI 编译错误并简化构建。
+- 修复桌面 assistant task rail 显示。
+
+**Refactors**
+
+- 现代化 design system、统一 spacing 与 typography。
+- 左侧边栏导航结构、MCP Hub 命名、assistant focused navigation、favorites 与 breadcrumbs 整体重构。
+- built-in / external Codex modes 和 external agent provider registry 在该版本区间内成形。
+
+**Known Issues**
+
+- `flutter analyze` 仍受 `test/runtime/codex_integration_test.dart` 的既有编译问题影响。
+- `flutter test` 仍有 settings、mode switcher、Codex bridge 相关既有失败。
+- macOS device-run 集成用例仍不稳定。
+
+### `v0.3` — `2026-03-13`
+
+**Feature Matrix**
+
+- `config/feature_flags.yaml` 尚未引入。
+- 可确认的功能面来自 `v0.2..release/v0.3` 提交区间，而不是标准 feature flag 快照。
+
+**Highlights**
+
+- 补齐 AI Gateway integration 与一轮桌面 UI polish。
+- paired device 状态展示进一步简化。
+- 版本号统一为 `v0.2` marketing 体系并补 build-date / build-id。
+
+**Fixes**
+
+- 修复 paired device status display。
+- 修复桌面页面底部空白过大问题。
+
+**Refactors**
+
+- 桌面 typography 与 density 规范化。
+
+**Known Issues**
+
+- 推断：该版本尚未包含 `v0.4` 才形成的 built-in / external Codex mode、任务工作台整合与侧栏收藏体系。
+- 推断：尚未形成正式 release notes / issue 清单流程。
+
+### `v0.2` — `2026-03-12`
+
+**Feature Matrix**
+
+- `config/feature_flags.yaml` 尚未引入。
+- 该版本以 Gateway-driven assistant baseline 为中心，而非 feature flag 管理模型。
+
+**Highlights**
+
+- 完成 gateway-driven assistant baseline。
+- 新增 gateway device pairing controls。
+- 新增 runtime diagnostics log viewer。
+- 引入 secure gateway shared token handling。
+
+**Fixes**
+
+- 改善 remote gateway bootstrap prefill。
+- 稳定 remote gateway pairing identity。
+
+**Refactors**
+
+- 版本号与 build-date / build-id 体系在下一版本区间被统一，说明此版本仍处于早期打包策略磨合阶段。
+
+**Known Issues**
+
+- 推断：AI Gateway integration UI polish、设备状态精简与桌面 density 规范化仍未完成，这些能力在 `v0.3` 才落地。
+- 推断：尚未引入正式 release docs 与 feature matrix 工具链。
+
+### `v0.1` — `2026-03-11`
+
+**Feature Matrix**
+
+- `config/feature_flags.yaml` 尚未引入。
+- 该版本是桌面 workspace shell 基线，记录方式以 UI 结构和打包准备为主。
+
+**Highlights**
+
+- 建立 Flutter workspace shell 与初始桌面工作区结构。
+- 增加 assistant access controls、桌面窗口最大化与全局中英语言切换。
+- 完成 tri-state sidebar、resizable workspace layout 和一轮主题打磨。
+- 补齐 macOS App Store release workspace 与 category metadata。
+
+**Fixes**
+
+- 修复 expanded sidebar navigation layout。
+- 降低 sidebar 最小宽度并压缩 expanded sidebar 宽度。
+
+**Refactors**
+
+- composer actions menu 左移。
+- expanded sidebar footer、action tiles、header title 进行了一整轮收口简化。
+- theme 与 Makefile tasks 一并整理，形成最初的工程基线。
+
+**Known Issues**
+
+- 推断：Gateway-driven assistant、设备配对、诊断日志、secure token handling 仍未进入产品面，这些能力在 `v0.2` 才补齐。
+- 推断：尚未形成 release docs、feature flags 与版本 issue 清单机制。