xworkmate-app/docs/releases/xworkmate-release-notes.md

XWorkmate Release Notes

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.

Release Ledger

Version	Date	Snapshot Ref	Branch	Matrix Source
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

Matrix Baseline

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

Version Notes

v0.7 — 2026-03-24

Feature Matrix

• release 可见 45 个 flags，profile 46 个，debug 60 个。
• 相比 v0.6.1，release 少 2 个、debug 少 2 个，重点是收敛实验入口和未完备设置项。

Highlights

• 新增 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。

Fixes

• 修复 Codex ACP turn payload schema。
• 修复 single-agent ACP 模型归属。
• 修复 secrets settings tab assertion 和外部 CLI 可用性检测。
• 修复 macOS package build state reset，继续加固 App Store 分发。

Refactors

• assistant 执行链路切到 gateway ACP。
• AI Gateway UI 文案统一收口到 LLM API / Single Agent。
• 外部 single-agent app-server 用于 App Store 分发路径。

Known Issues

• flutter test 全量仍有既有失败：assistant_page_test 的 pending timer 与 modules_page_test 的重复文案断言。
• macOS device-run 仍可能触发 Failed to foreground app; open returned 1，需要串行执行并配合人工检查。

v0.6.1 — 2026-03-22

Feature Matrix

• 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 清单机制。