v2.8.0
BenedictKing/ccxv2.8.0May 25, 2026by github-actions[bot]
AI Summary
Introduces a significant breaking change by standardizing the desktop configuration directory path to ensure consistency across different launch methods.
Key Highlights
- Desktop config directory path changed from hash-based to fixed location
- Fixes startup inconsistency issues across Dock, Spotlight, and terminal
- Fix macOS `/private/var` symlink test issue
Breaking Changes
- Desktop configuration directory path changed from hash-based to fixed location
- Original hash subdirectory does not auto-migrate, requiring manual config copying or reconfiguration
Full Release Notes
### ⚠️ 破坏性变更
- **桌面端配置目录路径变更** - 历史版本将 dataDir 计算为 `{UserConfigDir}/ccx-desktop/{sha1(rootDir)[:10]}`,导致从 Dock、Spotlight、终端等不同方式启动时产生不同 hash 子目录,配置在不同启动方式间相互不可见。新版本统一使用 `{UserConfigDir}/ccx-desktop/`。
- **升级影响**:原 hash 子目录不会自动迁移,首次启动会进入空配置状态,需重新配置或手动从旧 hash 目录复制 `.env`、`agent-config-state/`、`.config/` 到新位置
### 🐛 修复
- **修复 macOS `/private/var` 符号链接下的测试误报** - 解决 `t.TempDir()` 与 `os.Getwd()` 因符号链接导致的字符串比较失败问题
---
**Full Changelog**: https://github.com/BenedictKing/ccx/compare/v2.7.30...v2.8.0