coding-tool-x 3.2.0

package/CHANGELOG.md

@@ -0,0 +1,599 @@
+# Changelog
+
+所有显著的项目变化都将被记录在此文件中。
+
+该项目遵循 [Semantic Versioning](https://semver.org/)。
+
+## [3.2.0] - 2026-03-01
+
+### Added
+- ✨ **Codex 代理管理** - agents API 及 AgentsService 新增 Codex 平台支持，覆盖 user/project 作用域
+- ✨ **会话格式转换器** - 新增 `session-converter.js`，统一 Claude/Codex/Gemini 会话为中间格式，支持跨平台转换
+- ✨ **OpenCode 网关适配层** - 新增 `opencode-gateway-adapters.js`，多平台会话转换为 OpenCode payload
+- ✨ **转换 API** - 新增 `/api/convert` 端点及前端 `GatewayConvertDrawer` 组件，支持会话格式预览与导出
+- ✨ **请求日志服务** - 新增 `request-logger.js`，通过环境变量 `CC_TOOL_LOG_REQUESTS` 控制代理请求快照记录
+- ✨ **Gemini CLI 配置同步** - config-sync-manager 新增 `~/.gemini/skills/` 目录同步支持
+- ✨ **Codex 性能 benchmark** - 新增 `benchmark-codex-loading.js` 及 `test-codex-agents.js` 脚本
+- ✨ **剪贴板工具** - 新增 `src/web/src/utils/clipboard.js` 统一剪贴板操作
+
+### Changed
+- 🔄 **统计时区修正** - Claude/Codex/Gemini/OpenCode 统计服务全部切换为北京时间（UTC+8）计算，修复跨日边界统计误差
+- 🔄 **OpenCode 代理服务器重构** - 大幅精简 `opencode-proxy-server.js`，User-Agent 更新至 `claude-cli/2.1.59`，Beta header 更新为最新标志组
+- 🔄 **配置同步支持 TOML** - config-sync-manager 及 agents-service 新增 TOML 格式解析与写入
+- 🔄 **Package name 变更** - 从 `@adversity/coding-tool-x` 改为 `coding-tool-x`
+- 🔄 **Config Templates 精简** - config-templates-service.js 重构，移除冗余逻辑
+
+### Removed
+- 🗑️ **终端模块移除** - 删除 Terminal API、PTY 管理器、TerminalPane/Tabs 组件、Terminal 视图及终端设置面板
+- 🗑️ **Rules 模块移除** - 删除 rules API、rules-service、RuleCard/RuleFormModal/RulesDrawer/RulesPanel 全套组件
+- 🗑️ **移除 PTY 依赖** - 移除 `@lydell/node-pty` 和 `@xterm/headless` 依赖，减小安装体积
+
+## [3.1.4] - 2026-02-28
+
+### Fixed
+- 🐛 **统计卡数值恒显示** - 修复切换 metric 时其他维度统计卡显示为 0 的问题，现在并发请求三个维度数据
+- 🐛 **移除 dataZoom 滑块** - 修复 90d 视图图例下方出现多余波形滑块的问题
+
+## [3.1.3] - 2026-02-28
+
+### Added
+- ✨ **用量分析页面** - 新增独立 `/analytics` 页面，支持按模型/渠道/工具类型的 Token 用量、费用、请求数趋势图表
+- ✨ **多工具数据聚合** - 分析图表合并 Claude / Codex / Gemini / OpenCode 四个工具的统计数据
+- ✨ **堆叠柱状图 & 累计趋势图** - 基于 ECharts，支持柱状图/折线图切换、全屏展示
+- ✨ **灵活时间范围** - 支持 1d/3d/7d/30d/90d 及自定义日期区间，自动选择小时/天粒度
+- ✨ **数据导出** - 支持 CSV 和 JSON 格式导出趋势数据
+
+### Changed
+- 🔄 **1天视图步长调整** - 从每2小时改为每4小时，减少数据点密度
+- 🔄 **3天视图步长调整** - 从每6小时改为每12小时，图表更清晰
+- 🔄 **X 轴日期格式精简** - 从 `2026-02-06` 改为 `02/06`，小时标签改为 `02/06 14:00`
+
+### Fixed
+- 🐛 **步长参数未传递** - 修复后端路由未解构 `step` 参数导致步长设置无效的问题
+
+## [3.1.2] - 2026-02-27
+
+### Added
+- ✨ **模型元数据覆盖 API** - 新增 `GET/POST/DELETE /api/settings/model-metadata`，支持自定义模型定价与参数限制
+- ✨ **Prompt Caching 支持** - 自动注入 `cache_control` 断点，与 OpenCode SDK 缓存策略对齐
+- ✨ **推理努力级别支持** - 支持 `reasoning_effort` 参数向 Claude/Gemini 的转换
+- ✨ **渠道允许模型列表** - 渠道新增 `allowedModels` 字段，支持显式指定可用模型
+- ✨ **Chat Completions 流式中继** - 实现标准 OpenAI `chat/completions` 流式响应转换
+- ✨ **Gemini 内置工具支持** - 支持 `googleSearch`、`codeExecution`、`urlContext` 等原生工具
+- ✨ **多媒体内容规范化** - 支持 Base64 和 URL 形式的图像、文档内容块转换
+
+### Changed
+- 🔄 **OpenCode 会话数据迁移至 SQLite** - 从文件系统 JSON 迁移到 SQLite 查询，提升性能与一致性
+- 🔄 **模型定价配置统一管理** - 从 `model-metadata.js` 动态生成定价表，消除重复维护
+- 🔄 **渠道变更自动同步代理配置** - 创建/更新/删除渠道后自动刷新 OpenCode 代理设置
+
+### Fixed
+- 🐛 **Token 统计修复** - 修复缓存 Token 重复计算，正确处理 `cacheCreation` / `cacheRead` 统计
+- 🐛 **代理流式响应压缩冲突** - 禁用上游 `accept-encoding`，防止双消费者竞争导致响应异常
+- 🐛 **Gateway 路径规范化** - 修复末尾斜杠问题，确保 `/v1/responses` 与 `/responses` 路径正确识别
+- 🐛 **环境变量冲突误报** - 修复删除配置后仍提示冲突的问题，同步清理进程中的同名变量
+- 🐛 **Shell 配置文件检查补全** - 补充 `.bash_login`、`.zshenv`、`.zlogin` 等遗漏文件检查
+- 🐛 **Chat Completions 流终止消息** - 补充最终 usage chunk，满足 `stream_options.include_usage` 规范
+
+## [3.1.1] - 2026-02-26
+
+### Added
+- ⚙️ **模型探测策略开关** - 设置中新增“优先使用 `/v1/models` 探测可用模型”控制项，默认关闭并使用默认测速模型探测。
+
+### Changed
+- 🚦 **测速稳定性增强** - `speed-test-all` 调整为串行/小并发策略，降低上游并发窗口打满导致的偶发失败。
+- 🔍 **模型列表获取策略优化** - 转换渠道模型获取改为串行探测，避免并发探测触发限流。
+
+### Fixed
+- 🐛 **OpenCode 转 Claude 请求格式修复** - 修正 `system`、`metadata` 等结构转换，兼容 Claude Code 特征校验。
+- 🐛 **`metadata.user_id` 会话一致性修复** - 同一 `session` 复用同一 `user_id`，避免请求侧与测速侧身份不一致导致拒绝。
+- 🐛 **延迟显示修复** - 修复 `latency` 为 `0ms` 时错误显示的问题，改为 `null` 语义处理。
+
+## [3.1.0] - 2026-02-04
+
+### Added
+- ✨ **OAuth 登录统一预设化** - 三种渠道统一通过预设下拉框选择 OAuth 登录
+  - Claude 渠道预设新增"Claude OAuth"选项，选择后自动显示 OAuth 认证面板
+  - Codex 渠道新增预设系统，支持"OpenAI / OpenAI OAuth / 自定义"预设
+  - Gemini 渠道新增预设系统，支持"Google AI / Google OAuth / 自定义"预设
+  - 三种渠道 UI 风格完全统一，均通过预设下拉框切换认证方式
+- ✨ **渠道自定义预设** - 所有渠道类型新增"自定义"预设选项
+  - Claude 渠道新增"自定义"预设，用户可手动填写所有字段
+  - Codex / Gemini 渠道同样支持自定义预设
+- ✨ **Codex/Gemini 预设配置文件** - 新增独立预设配置
+  - 新增 `codexPresets.js`，定义 Codex 渠道预设及分类
+  - 新增 `geminiPresets.js`，定义 Gemini 渠道预设及分类
+
+### Changed
+- 🎨 **OAuth 认证面板样式优化** - OAuth section 使用紫色渐变背景区分
+  - 认证方式 radio 按钮改为卡片式布局，选中状态高亮
+  - 选择 OAuth 预设后自动隐藏 API Key 输入框
+- 🔄 **移除 Codex/Gemini 独立认证方式 section** - 不再使用 radio-group 切换认证
+  - 改为通过预设下拉框选择，与 Claude 渠道保持一致
+  - 预设切换自动设置 `authType`，面板内容随之联动
+
+## [3.0.6] - 2026-02-03
+
+### Added
+- ✨ **Codex/Gemini 模型重定向支持** - 为 Codex 和 Gemini 渠道添加模型重定向功能
+  - Codex 渠道面板新增"模型重定向"配置部分
+  - Gemini 渠道面板新增"模型重定向"配置部分
+  - Gemini 代理服务器支持 URL 中模型名称的重定向
+  - 后端服务层支持 `modelRedirects` 字段存储
+- ✨ **Codex/Gemini 测速模型配置** - 为 Codex 和 Gemini 渠道添加测速模型配置
+  - Codex 渠道面板新增"测速模型"输入框
+  - Gemini 渠道面板新增"测速模型"输入框
+  - 后端服务层支持 `speedTestModel` 字段存储
+
+### Changed
+- 🔇 **优化模型重定向日志输出** - 减少重复日志打印
+  - 添加日志缓存机制，相同重定向规则只打印一次
+  - 渠道配置更新时自动清除缓存，触发重新打印
+  - Claude、Codex、Gemini 三个代理服务器统一使用此机制
+
+## [3.0.2] - 2026-02-01
+
+### Fixed
+- 🐛 **修复渠道类型检测错误** - 修复第三方代理 URL 路径包含 "claude" 时被误判为官方 Claude API 的问题
+  - 修改 `detectChannelType()` 函数，仅检查域名而非完整 URL 路径
+  - 修复 `https://code.newcli.com/claude/aws` 等第三方代理无法获取模型列表的问题
+  - 添加 URL 解析错误处理，增强容错性
+- 🐛 **修复 Cloudflare 检测崩溃** - 修复模型检测时引用未定义变量导致服务崩溃的问题
+  - 修正 `model-detector.js` 第 534 行变量名错误（`body` → `data`）
+  - 确保 Cloudflare 检测逻辑正常工作
+
+### Added
+- ✨ **Cloudflare 防护智能处理** - 当模型列表接口被 Cloudflare 保护时自动使用默认模型
+  - 检测到 Cloudflare 拦截时，自动返回 `claude-sonnet-4-5` 作为默认模型
+  - 前端显示友好提示信息，说明使用了默认模型
+  - 区分 Cloudflare 保护、认证失败、访问拒绝等不同错误类型
+  - 保持向后兼容，不影响其他正常工作的渠道
+- ✨ **支持手动输入模型名称** - 渠道配置表单增强
+  - 测速模型选择器改为自动完成输入框，支持手动输入
+  - 无法获取模型列表时，提供常见模型名称示例
+  - 用户可以从下拉列表选择或直接输入自定义模型名称
+  - 提升用户体验，解决第三方代理模型配置问题
+
+## [3.0.1] - 2026-02-01
+
+### Added
+- 📦 **插件导出/导入功能** - 配置导出系统新增插件支持
+  - 支持导出 Legacy 插件 (`~/.cc-tool/plugins/`)
+  - 支持导出 Native 插件 (`~/.claude/plugins/`)
+  - 完整文件快照（base64 编码）
+  - 自动过滤敏感文件（.env、credentials、keys）
+  - 支持插件导入并自动更新注册表
+  - UI 显示插件数量统计
+
+### Security
+- 🔒 **修复路径遍历漏洞** - 加强导入安全性
+  - 修复 Native 插件导入路径注入漏洞
+  - 修复 Markdown 文件路径遍历漏洞
+  - 添加 Markdown 文件白名单验证（仅允许 CLAUDE.md、AGENTS.md、GEMINI.md）
+  - 强化路径安全验证
+
+### Changed
+- 📊 **配置导出版本升级** - 从 v1.1.0 升级到 v1.2.0
+  - 新增 `plugins` 字段
+  - 保持向后兼容（v1.1.0 导出仍可导入）
+
+## [2.6.0] - 2026-01-29
+
+### Added
+- 🧩 **插件管理前端页面** - 新增 Web UI 插件管理功能
+  - 插件列表：显示已安装插件，支持启用/禁用切换、搜索过滤
+  - 插件安装：支持通过 Git URL 安装插件
+  - 插件卸载：一键卸载已安装插件
+  - 统计面板：显示总计/已启用/已禁用插件数量
+- 🔌 **插件 REST API** - 新增 `/api/plugins` 系列接口
+  - `GET /api/plugins` - 获取插件列表
+  - `POST /api/plugins/install` - 安装插件
+  - `DELETE /api/plugins/:name` - 卸载插件
+  - `PUT /api/plugins/:name/toggle` - 切换启用状态
+
+## [2.5.1] - 2026-01-27
+
+### Added
+- 📦 配置导出升级为 ZIP，包含前端 UI/终端/Prompts/安全/高级配置等全量选项
+
+### Fixed
+- 🐛 UI 配置读取保留扩展字段，避免导入后丢失自定义项
+
+## [2.5.0] - 2026-01-27
+
+### Added
+- 🔐 **安全设置面板** - 支持设置访问密码，每次进入面板需验证
+- 🧹 **安全设置重置命令** - 新增 `ctx security reset` 清除密码文件，便于恢复
+- 🧭 **系统 Shell 选择** - 设置中的终端工具新增系统 Shell 选项，Web 终端与系统选择强关联
+
+### Improved
+- 🧾 **Web 终端完整快照** - 服务端基于 headless xterm 生成全量滚动历史快照，刷新后可恢复断开前屏幕内容
+- 🪟 **终端光标与视口同步** - 快照恢复时校准光标位置，减少提示符重绘与错位
+- 📐 **终端尺寸同步稳定性** - 隐藏状态不触发 fit，避免多余 resize 导致提示符刷新
+
+### Fixed
+- 🐛 修复 Web 终端刷新/回连时提示符重复累加的问题
+
+## [2.4.2] - 2026-01-24
+
+### Fixed
+- 🐛 修复 Web 终端使用历史会话时的项目名解析错误，避免工作目录不存在导致终端创建失败
+- 🐛 修复终端路由 query 变更不触发创建的问题，避免刷新后重复创建终端
+- 🐛 修复配置模板应用中“已有项目”选择项重复显示的问题
+
+### Improved
+- 🧭 Web 终端标签页状态本地持久化 + 后端活跃终端恢复，关闭浏览器后可继续回连
+- 🧷 新建会话与“使用对话 → Web 终端”强制新开标签页，避免复用导致混淆
+- 🧱 终端视图路由保持同一组件实例，减少切页导致的终端断开
+
+## [2.4.1] - 2026-01-20
+
+### Improved
+- ⚡ **后端性能大幅优化** - 全面异步化改造与增强缓存
+  - 文件操作全异步化：将核心服务中的同步文件 I/O 替换为异步操作，消除阻塞
+  - 增强缓存管理器：引入 LRU + TTL 双重缓存机制，大幅减少文件扫描频率
+  - 流式文件读取：优化会话消息扫描，支持流式读取，显著降低内存占用和响应时间
+  - API 响应速度提升 70-99%，缓存命中时响应 < 1ms
+- 📦 **前端构建优化** - 深度优化 Vite 打包配置
+  - 实现精细化代码分割，Naive UI、Vue Vendor、图标库独立打包
+  - 增强代码压缩与 Tree Shaking，去除生产环境 console 日志
+  - 首屏资源加载体积减少 50%+，提升页面加载速度
+
+### Fixed
+- 🐛 修复 `performance-test.js` 脚本路径引用的问题
+- 🐛 修复构建过程中缺少的依赖 (`terser`)
+
+## [2.4.0] - 2026-01-18
+
+### Changed
+- 🎨 **移除内置/自定义模板区分** - 统一模板显示样式
+  - 移除所有模板卡片和预览中的"内置"/"自定义"标签
+  - 移除配置模板下拉选项中的"(内置)"后缀
+  - 简化界面，提升用户体验
+- 🔓 **允许编辑所有模板** - 增强模板管理灵活性
+  - 内置模板现在可以编辑和删除
+  - 编辑内置模板时自动保存为自定义覆盖版本
+  - 删除内置模板时添加隐藏标记，不影响自定义模板
+
+### Technical
+- 更新 `ConfigTemplateCard.vue` 移除内置标签并允许所有模板编辑删除
+- 更新 `ConfigPreviewModal.vue` 移除内置/自定义标签显示
+- 更新 `WorkspaceFormModal.vue` 简化模板选项显示
+
+---
+
+## [2.3.0] - 2025-01-15
+
+### Changed
+- 🧹 **移除 Web 终端命令设置** - 从设置抽屉中删除 "Web终端命令" 面板
+- 🧹 **移除系统维护设置** - 从设置抽屉中删除 "系统维护" 面板和旧文件扫描功能
+
+---
+
+## [2.2.0] - 2025-12-08
+
+### Added
+- 🔔 **任务完成通知** - 新增通知设置，支持系统通知（卡片/弹窗）和飞书机器人通知，跨平台支持 macOS/Windows/Linux
+- 📊 **冻结渠道显示** - 代理控制面板显示各类型冻结渠道数量
+
+### Improved
+- ⚡ **调度器优化** - 移除渠道缓存签名机制，每次直接读取最新配置
+- 🔧 **代理超时配置** - 增加代理连接和请求超时时间至 2 分钟
+- 📦 **请求体限制** - 提高请求体大小限制至 100MB
+- 🎯 **错误提示优化** - 区分渠道冻结和并发上限的错误信息
+
+### Fixed
+- 🐛 修复渠道配置变更后调度器未及时刷新的问题
+
+---
+
+## [2.1.0] - 2025-12-06
+
+### Added
+- 渠道卡片新增单渠道速度测试按钮，支持快速测试单个渠道连通性
+- 测试结果直接展示在卡片下方，包含延迟、状态码等信息
+
+### Fixed
+- 修复 Codex 渠道速度测试使用错误的 API 路径问题
+- 修复 Gemini 渠道速度测试未传递 channelType 参数问题
+- Codex 速度测试现在使用正确的 Responses API 格式（流式响应）
+- Gemini 速度测试现在使用渠道配置的模型而非硬编码模型
+
+### Changed
+- 移除代理服务器的冗余调试日志，减少控制台输出
+- 优化批量速度测试的前端超时时间
+
+## [2.0.2] - 2025-12-02
+
+### 🎉 重大更新：MCP 管理 & Prompts 管理 & Skills 技能 & 多模型预设
+
+### Added
+
+#### 🔌 MCP 服务器管理
+- 全新 MCP (Model Context Protocol) 服务器管理模块
+- 支持三种传输类型：stdio、http、sse
+- 多平台同步：Claude / Codex / Gemini 配置一键同步
+- 15+ 内置预设模板（filesystem、fetch、memory、github、puppeteer、playwright 等）
+- 已安装预设自动识别，禁用重复添加
+- 智能配置解析：支持粘贴 JSON 配置快速导入，自动修复不完整片段
+- 一键测试 MCP 服务器连接状态
+- 实时状态监控：在线/异常/测试中状态指示
+- 配置导出：支持 JSON、Claude 格式、Codex TOML 格式
+- 服务器卡片拖拽排序
+
+#### 📝 Prompts 系统提示词管理
+- 全新 Prompts 提示词预设管理模块
+- 支持创建、编辑、删除自定义提示词预设
+- 内置模板：代码审查专家、调试专家等
+- 多平台同步：一键同步到 `CLAUDE.md`、`AGENTS.md`、`GEMINI.md`
+- 支持从现有文件导入提示词
+- 激活/停用管理，灵活切换不同场景
+
+#### 🧩 Skills 技能管理
+- 全新 Claude Code Skills 技能管理模块
+- 支持从 GitHub 仓库获取技能列表（默认 anthropics/skills 官方仓库）
+- 支持添加自定义仓库源，灵活扩展技能来源
+- 技能一键安装/卸载到 `~/.claude/skills/`
+- 技能详情查看，包含描述、用法、参数说明
+- 支持搜索和筛选（全部/已安装/未安装）
+- 支持创建自定义本地技能
+
+#### 🌐 多模型预设支持
+- 渠道表单新增预设选择器，快速配置不同 AI 服务商
+- 内置预设：
+  - **Claude 官方** - Anthropic 原版 API
+  - **DeepSeek** - DeepSeek-V3.2-Exp
+  - **智谱 GLM** - glm-4.6 / glm-4.5-air
+  - **Kimi K2** - kimi-k2-thinking
+  - **MiniMax** - MiniMax-M2
+  - **通义千问** - qwen3-max
+  - **豆包 Seed** - doubao-seed-code-preview-latest
+- 选择预设后自动填充 baseUrl 和模型配置
+- 切换渠道时自动写入对应模型环境变量
+
+#### 🔗 渠道级代理配置
+- 每个渠道可单独配置代理地址（proxyUrl）
+- 支持直连模式：将代理写入 `HTTPS_PROXY`/`HTTP_PROXY` 环境变量
+- 支持代理模式：通过 `https-proxy-agent` 在代理服务器中路由请求
+
+#### ⚡ 渠道速度测试
+- 全新渠道速度测试功能
+- 支持测试所有渠道的 API 响应延迟
+- 按渠道类型筛选（Claude/Codex/Gemini）
+- 测试摘要统计（成功/失败/平均延迟）
+- 结果可视化展示，延迟分级着色
+
+#### ⚠️ 环境变量冲突检测
+- 启动时自动检测系统环境变量冲突
+- 检测 `ANTHROPIC_API_KEY`、`OPENAI_API_KEY`、`GEMINI_API_KEY` 等敏感变量
+- 检测 shell 配置文件（~/.zshrc、~/.bashrc 等）
+- 提供详细的冲突来源和清理建议
+- 支持批量选择清理或"不再提醒"
+
+### Improved
+- 🎨 **UI/UX 优化**
+  - MCP/Prompts/Skills 管理抽屉式界面，不打断主流程
+  - 卡片 hover 显示操作按钮
+  - 平台开关一键切换
+  - 统计信息实时更新
+
+### Technical
+- 🏗️ **后端架构**
+  - 新增 `mcp-service.js` MCP 服务层
+  - 新增 `prompts-service.js` 提示词服务层
+  - 新增 `skill-service.js` 技能服务层
+  - 新增 `speed-test.js` 速度测试服务
+  - 新增 `env-checker.js` 环境变量检测服务
+  - 新增 `env-manager.js` 环境变量管理服务
+  - 渠道数据结构新增 `presetId`、`modelConfig`、`proxyUrl` 字段
+
+- 🔧 **前端架构**
+  - 新增 `McpDrawer.vue` / `McpFormDrawer.vue` MCP 管理组件
+  - 新增 `PromptsDrawer.vue` / `PromptsFormDrawer.vue` 提示词管理组件
+  - 新增 `SkillsPanel.vue` / `SkillCard.vue` / `SkillDetailModal.vue` 技能管理组件
+  - 新增 `SpeedTestDrawer.vue` 速度测试组件
+  - 新增 `EnvConflictModal.vue` 环境变量冲突弹窗
+  - 新增 `claudePresets.js` 预设配置文件
+
+---
+
+## [1.6.0] - 2025-11-29
+
+### 🎉 重大更新：多渠道负载均衡架构
+
+### Added
+- 🔀 **多渠道负载均衡**
+  - 支持同时启用多个渠道，系统自动进行智能负载均衡
+  - 支持为每个渠道配置**权重**（1-100），按权重分配请求流量
+  - 支持为每个渠道配置**最大并发数**，精细控制每个渠道的负载
+  - 基于加权随机算法，高权重渠道获得更多请求
+- 🏥 **渠道健康检查与智能切换**
+  - 自动检测渠道健康状态，连续失败自动冻结问题渠道
+  - 冻结时间指数递增（1分钟 → 2分钟 → 4分钟...最大30分钟）
+  - 渠道恢复后自动解冻，无需人工干预
+  - 一键重置渠道健康状态
+- 🔗 **会话绑定模式**
+  - 支持开启/关闭会话绑定，确保同一会话的请求发送到同一渠道
+  - 避免上下文在不同渠道间切换导致的问题
+- 📊 **首页三列布局拖拽排序**
+  - Claude / Codex / Gemini 三列可自由拖拽调整顺序
+  - 布局顺序自动保存，跨设备同步
+- 🎨 **渠道卡片全新设计**
+  - 新增权重和并发数显示
+  - 新增健康状态指示器（健康/冻结/检查中）
+  - 支持直接在卡片上快速调整权重和并发设置
+  - 渠道启用/禁用状态切换
+
+### Changed
+- ⚠️ **移除"默认渠道"概念**
+  - 不再需要手动切换默认渠道
+  - 改为启用/禁用渠道，启用的渠道自动参与负载均衡
+  - 代理启动时自动使用所有启用的渠道
+- 🔄 **API 接口变更**
+  - 移除 `/channels/activate` 接口
+  - 移除 `/channels/active` 接口
+  - 新增 `/channels/enabled` 接口获取所有启用的渠道
+  - 渠道数据结构新增 `enabled`、`weight`、`maxConcurrency` 字段
+
+### Improved
+- ⚡ **性能优化**
+  - 渠道数据内存缓存，减少文件 I/O
+  - 首页数据并行加载，快速接口不被慢速接口阻塞
+  - 统计数据异步计算，不影响首屏渲染
+  - 会话列表虚拟滚动优化
+- 🏗️ **代码架构优化**
+  - 全新的调度器模块 `channel-scheduler.js`
+  - 全新的健康检查模块 `channel-health.js`
+  - 服务层代码结构重构，职责更清晰
+  - Express 路由顺序优化，避免参数路由匹配问题
+- 🎨 **UI/UX 改进**
+  - 渠道面板视觉重新设计
+  - 代理状态卡片信息更丰富
+  - 实时日志面板性能优化
+  - 整体圆角和间距微调
+
+### Fixed
+- 🐛 修复 CLI 添加 Codex/Gemini 渠道时参数不匹配的问题
+- 🐛 修复 WebSocket 状态广播时渠道数据不一致的问题
+- 🐛 修复代理启动时渠道验证逻辑
+- 🐛 修复前端 API 调用与后端接口不匹配的问题
+
+---
+
+## [1.5.5] - 2025-01-12
+
+### Improved
+- ⚡ 性能优化：首页数据加载策略改进，快速接口不再被慢速接口阻塞
+  - 前端并行加载所有数据，使用 `Promise.allSettled()` 替代 `Promise.all()`
+  - 快速接口（UI 配置、频道列表）可立即返回和渲染
+  - 慢速接口（今日统计）在后台并行加载，不影响首屏体验
+- 🔧 优化版本检查逻辑
+  - 使用 `requestIdleCallback` 延迟版本检查到浏览器空闲时
+  - 添加 npm 注册表请求缓存，TTL 为 1 小时
+  - 减少首页初始加载时间
+- 🐛 修复问题
+  - 移除版本检查的 mock 模式，恢复真实版本检测
+
+---
+
+## [1.5.4] - 2024-11-27
+
+### Improved
+- 🎨 全局圆角优化，主卡片从 12px 调整为 8px，内部小卡片 6px，按钮 4-5px，整体更现代简洁
+- ✨ 优化 Logo 和导航标签的圆角设计，提升视觉精致度
+- 📊 今日数据统计卡片样式精细调整，提升数据展示的视觉层级
+- 🔒 锁定状态界面圆角优化，锁定图标容器从 16px 改为 10px
+- 📱 列表项和标签圆角统一调整，提升整体设计一致性
+- 🎯 按钮和选择器圆角细化，从 6px 优化为 4px，更具现代感
+
+---
+
+## [1.5.3] - 2024-11-26
+
+### Added
+- 🚀 新增 `ctx daemon` 命令，支持后台运行模式（基于 PM2）
+  - `ctx daemon start` - 后台启动服务
+  - `ctx daemon stop` - 停止后台服务
+  - `ctx daemon restart` - 重启服务
+  - `ctx daemon status` - 查看运行状态
+  - `ctx daemon logs` - 查看 PM2 日志
+- 🩺 新增 `ctx doctor` 命令，系统健康诊断工具
+  - 检查 Node.js 版本兼容性
+  - 检查配置文件完整性
+  - 检查端口占用情况
+  - 检查 Claude Code 配置
+  - 检查日志目录和磁盘空间
+  - 检查进程运行状态
+- 📋 新增 `ctx logs` 命令，日志管理工具
+  - `ctx logs [type]` - 查看指定类型日志（ui/claude/codex/gemini）
+  - `ctx logs --follow` - 实时跟踪日志
+  - `ctx logs --lines N` - 显示最后 N 行
+  - `ctx logs --clear` - 清空日志文件
+- 📊 新增 `ctx stats` 命令，查看统计信息
+  - 会话数量统计
+  - Token 使用统计
+  - API 调用次数统计
+- ✨ 新增版本自动更新功能
+  - 自动检测新版本
+  - 一键更新并重启
+  - 支持查看更新日志
+
+### Improved
+- 🎨 优化 Web UI 更新提示，支持 Markdown 格式的 changelog 展示
+- 📦 改进日志管理，统一日志存储路径到 `~/.claude/logs/`
+- ⚡ 优化命令行帮助信息，新增命令自动出现在 `ct --help` 中
+
+### Fixed
+- 🐛 修复后台运行模式下端口冲突问题
+- 🐛 修复日志文件过大导致的性能问题
+
+---
+
+## [1.5.2] - 2024-11-26
+
+### Added
+- 🔒 新增类型锁定功能，可灵活关闭不需要的 AI 工具类型（Claude/Codex/Gemini），精简工作界面
+- 🔖 新增强大的收藏功能，支持收藏关键对话至顶部书签栏，一键快速定位核心对话内容
+- 🎯 新增后台运行模式，启动服务后可安全关闭终端窗口，代理服务持续运行无间断
+- ⚙️ 新增高级开机自启配置，支持系统启动时自动启动代理服务，无需手动干预
+
+### Improved
+- ⚡ 优化首页数据加载性能，引入智能缓存机制，显著提升页面加载速度
+- 📦 整合聚合 Dashboard 接口，减少多余请求，优化整体网络开销
+- 🎨 微调 UI 细节，提升整体视觉体验和交互流畅度
+
+### Fixed
+- 🐛 修复会话运行时间计算逻辑，确保时间统计准确无误
+
+---
+
+## [1.5.1] - 2024-11-20
+
+### Added
+- 📢 新增版本更新提示，及时推送最新功能和改进
+
+### Improved
+- 🎨 优化更新提示 UI，完美适配日间/暗黑主题
+
+### Fixed
+- 🐛 修复更新提示弹窗在白天主题下背景色问题
+
+---
+
+## [1.5.0] - 2024-11-15
+
+### Added
+- 🤖 新增 Gemini AI 工具完整支持
+
+### Improved
+- 🎨 全面优化整体 UI 设计和交互体验
+
+### Fixed
+- 🐛 修复代理管理页面的已知问题
+
+---
+
+## [1.4.5] - 2024-11-10
+
+### Added
+- 🔖 新增收藏功能，快速标记重要会话
+
+### Improved
+- ⚡ 性能优化和响应速度提升
+
+### Fixed
+- 🐛 修复渠道切换问题
+
+---
+
+## [1.4.0] - 2024-11-05
+
+### Added
+- 📱 新增响应式设计，支持更多终端宽度
+- 🔍 新增全局搜索功能，快速查找会话内容
+
+### Improved
+- 🎨 整体 UI 界面优化
+
+### Fixed
+- 🐛 修复若干已知问题

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.