# Changelog

## 0.7.0 — 2026-03-24

### Highlights
- 设置页新增 `ACP 外部接入`，支持为 `Codex / OpenCode / Claude / Gemini` 分别配置独立的外部 ACP endpoint。
- Single Agent 外部 ACP 模式不再错误复用本地 LLM API 模型；当前线程会改为显示 ACP 真实返回的运行时模型。
- Codex ACP 直连链路补齐当前协议：`thread/start`/`turn/start` 与新的 `input` item 序列兼容，真实 WebSocket 任务执行已跑通。
- 本地持久化与 macOS 打包链路延续稳定化，`settings.yaml` / `tasks/*.json` / `secrets/*.secret` 的文件存储布局保持不变。

### Current Delivery Scope
- 已交付：外部 ACP endpoint 配置 UI、Codex ACP provider 选择、运行时模型归属修正。
- 已交付：Codex app-server thread/turn 协议适配与 websocket 真实链路验证。
- 已交付：macOS DMG 打包、覆盖安装到 `/Applications/XWorkmate.app` 的发布路径。

### Known Issues
- `flutter test` 全量仍有既有失败：`assistant_page_test` 2 个 pending timer、`modules_page_test` 1 个重复文案断言。
- macOS device-run 仍可能出现 `Failed to foreground app; open returned 1`，需要串行执行并结合人工检查。

### Dev
- `pubspec.yaml`: 当前版本更新为 `0.7.0+1`
- 发版分支：`release/v0.7`
- 预期 tag：`v0.7.0`

## 0.6.1 — 2026-03-22

### Highlights
- 修复本地配置持久化链路：`SecureConfigStore` 增加标准目录 fallback，`SettingsStore`/`SecretStore` 首次启动自动准备耐久目录结构。
- 持久化策略改为默认 fail-fast：当耐久路径不可解析或数据库不可打开时直接报错，避免静默内存化导致重启丢配置。
- 在显式内存回退模式下补齐“尽力回写”机制：后续写入和退出阶段会尝试同步到标准耐久目录。
- 关闭未完备账号入口：`mobile.workspace.account` 与 `desktop.navigation.account` 标记为 `experimental` 且 `enabled: false`。
- 补充回归测试覆盖“路径失败报错”和“默认支持目录 fallback 跨实例持久化”。

### Dev
- `pubspec.yaml`: 当前版本更新为 `0.6.1+1`
- 本次按用户要求直接在 `main` 分支提交，预期 tag 为 `v0.6.1`

## 0.6.0 — 2026-03-22

### Highlights
- 本地配置、Gateway 凭证和 Assistant 任务会话改为以 secure storage 管理的密钥做加密持久化，重启和覆盖安装后不再丢失。
- `单机智能体` 线程补齐本地技能自动发现和当前线程可选技能列表恢复，线程状态与模型选择继续保持隔离。
- Flutter Web assistant shell、Web Chrome 会话持久化和移动端安全控件一起补齐，多端可用性明显提升。
- Assistant composer 高度自适应、执行目标切换即时刷新、侧栏默认宽度等桌面交互问题已收敛。
- Windows / Linux parity、macOS DMG 打包和多平台构建发布流程持续补强。

### Current Delivery Scope
- 已交付：加密后的本地 settings snapshot、assistant threads 和 sealed backup 恢复链路。
- 已交付：Single Agent 线程技能自动发现、线程状态清理和重启恢复。
- 已交付：Flutter Web assistant shell、Web 持久化修复、移动端安全壳控件和桌面布局微调。
- 已交付：Windows / Linux parity 修复、多平台 build and release workflow、macOS 安装与分发产物。

### Not Yet Implemented
- `Settings external agents detail shows Codex bridge runtime states` 相关全量测试基线仍需单独收敛，不纳入本次 release 变更。
- 内置 Codex / Rust FFI 仍保持 experimental，不视为稳定默认运行模式。
- 更通用的外部 Code Agent provider 调度和可视化管理 UI 还未完成。

### Known Issues
- 远程或外部 CLI 协同仍受本机安装状态、Gateway 可达性和环境依赖影响，建议按 case 文档补一轮人工验收。
- macOS integration 测试仍可能受到宿主前台拉起行为影响，需要串行执行并结合人工检查。

### Dev
- `pubspec.yaml`: 当前版本更新为 `0.6.0+1`
- `release/v0.6` 作为本次发版分支，预期 tag 为 `v0.6`

## 0.5.0 — 2026-03-20

### Highlights
- Assistant 任务线程升级为持续会话：支持流式回复、继续追问、线程归档和重启恢复。
- 任务列表按 `单机智能体 / 本地 OpenClaw Gateway / 远程 OpenClaw Gateway` 分组，保持极简列表布局。
- Multi-Agent 协作正式升级为 `Architect / Engineer / Tester`，并可选 `ARIS` 作为最强协作框架。
- ARIS bundle 作为只读资产内嵌进 App，`skills/` 直接复用 upstream，`llm-chat` 与 `claude-review` 切到 Go core。
- `Ollama Cloud` 文案与默认地址统一，Go core 保持为包外开发态能力，不再内嵌进 `.app`。

### Current Delivery Scope
- 已交付：Single Agent streaming threads、OpenClaw 本地/远程任务线程、手动归档与持续会话恢复。
- 已交付：Multi-Agent managed runtime、ARIS framework preset、本地优先 Ollama 回退、Go core runtime 和打包分发。
- 已交付：Settings / Assistant 里的 ARIS 轻量状态展示、任务分组、Ollama Cloud 设置迁移。
- 保持 truth-first：Scheduled Tasks 仍是 `cron.list` 只读视图；Memory 仍是 `memory/sync` 同步能力，不宣传 CRUD。

### Not Yet Implemented
- 内置 Codex / Rust FFI 仍未交付，`builtIn` 只保留为 experimental placeholder，不可视为稳定运行模式。
- 泛化的外部 Code Agent provider chooser / 调度 UI 还未落地；当前以角色配置和 preset 为主。
- OpenClaw Gateway 到外部 CLI 的直连 RPC、无 UI/headless 常驻执行、远程分布式调度不在 `v0.5` 交付范围内。
- `Tasks` 与 `Memory` 相关能力仍以 truth 收口为主，没有新增伪造接口或误导性交互。

### Known Issues
- ARIS local-first 协作仍依赖本地 Ollama endpoint 可达，缺失时会退化到已配置的云端或可用 CLI。
- Gemini / Claude / Codex / OpenCode 的深度能力仍受本机安装状态约束；未安装时只保证回退链路可用。
- 外部 CLI 全链路协作仍建议按 `docs/cases/README.md` 做一轮手动验证。

### Dev
- `pubspec.yaml`: 当前版本为 `0.5.0+1`
- macOS / iOS build name 和 build number 继续由 Flutter 版本号统一驱动
