@bryanhu/codexly 0.38.0 → 0.39.1

package/CHANGELOG.md

@@ -4,6 +4,43 @@
 
 ## [Unreleased]
 
+## [0.39.1] - 2026-10-19
+
+### 新增
+
+- Web（含移动端）与桌面端接入 Claude 引擎，可单独启用 Codex、Claude 或同时启用；仅使用 Claude 时，聊天、公共设置、Git 提交说明和定时任务不要求启动 Codex。侧栏标识任务所属引擎。
+- Claude 支持兼容 Anthropic Messages API 的连接与本机已有认证，复用原生配置；两端共用模型映射、Haiku / Sonnet / Opus 选择、思考强度、权限模式、上下文容量及自动压缩窗口设置，并在关于页展示 Claude Code 版本。
+- Claude 接入流式回复、工具审批、问答、附件、计划、子代理输出、上下文用量、MCP 交互、文件变更和命令结果；支持历史恢复、回合分叉、专用压缩、归档与永久删除。
+- 两端为 Claude 提供持久消息队列与运行中引导，支持排序、撤回、取消和立即引导；前台中断与后台任务停止分别控制，后续消息可复用存活会话并动态应用模型、思考强度和权限设置。
+- 两端统一辅助生成模型配置，自动生成任务标题；定时任务可选择执行引擎并保存对应模型与权限，全局搜索覆盖双引擎任务和历史。
+- 两端可先在输入框选择或创建 worktree 并编辑草稿，首次发送时再按所选引擎与模型创建任务，任务保留在原项目下。
+
+### 优化
+
+- 桌面安装包内置目标平台的 Codex 与 Claude 运行时，启动无需联网下载或另装 Node、Bun；按需启动已启用引擎。macOS Legacy 继续提供 Codex，不包含 Claude。
+- 两端复用服务连接面板、设置自动保存、任务投影、队列调度和可见工具计时器；历史按回合摘要与过程独立分页，减少磁盘 I/O、传输与非活动任务渲染开销。
+- WebSocket 增加半开连接检测、抖动退避和终态错误处理；快照读取、Codex 附件通知与出站写入采用有界队列及取消恢复，SQLite Worker 故障后可恢复。
+
+### 修复
+
+- 修复 Claude 会话与消息身份、后台任务终态、异常退出恢复、附件和本地命令输出持久化；保留原生权限规则、真实执行结果及会话授权范围。
+- 修复 Claude 自动续跑回复被拆散、最终答复标记和上下文统计不准的问题；恢复的终态回合不再显示虚假执行耗时。
+- 修复后台任务订阅丢失、迟到响应抢占视图、工作树任务导航、发送占位清理与心跳误断，减少短暂重连提示。
+- 修复桌面宿主管道背压及异常进程回收、Windows 存储文件原子替换，升级 ZIP 依赖。
+
+### 工程
+
+- 升级内置 Codex CLI 至 `0.163.0` 并更新共享协议基线；固定 Claude Agent SDK `0.3.300`，共用适配器与桌面独立宿主。
+- 统一真实 SDK 回归的临时目录真实路径，避免 Windows runner 的 8.3 短名造成会话索引错配和额外工作目录提示；为多轮流式输入浏览器回归预留冷启动总预算。
+- Windows 便携版改为包含主程序、Claude 宿主和运行时目录的完整 ZIP；补充跨平台构建、运行时分发、宿主通信与引擎隔离校验，保留签名和公证门禁。
+- 同步两端中英文使用与安装说明、运行时分发、模型上下文及联合发布文档，并补充 Windows、Ubuntu 验证记录。
+
+## [0.39.0] - 2026-10-19
+
+### 发布状态
+
+- 联合发布在公开前取消；修复 Windows 原生 SDK 回归的临时目录路径后，完整变更合并至 `0.39.1`，保留原标签。
+
 ## [0.38.0] - 2026-10-16
 
 ### 新增
@@ -1015,7 +1052,9 @@
 
 - 添加最小化 Tauri 权限、依赖供应链审计与 Provider 运行时完整性校验。
 
-[Unreleased]: https://github.com/BryanHoo/Codexly/compare/v0.38.0...HEAD
+[Unreleased]: https://github.com/BryanHoo/Codexly/compare/v0.39.1...HEAD
+[0.39.1]: https://github.com/BryanHoo/Codexly/compare/v0.38.0...v0.39.1
+[0.39.0]: https://github.com/BryanHoo/Codexly/compare/v0.38.0...v0.39.0
 [0.38.0]: https://github.com/BryanHoo/Codexly/compare/v0.37.1...v0.38.0
 [0.37.1]: https://github.com/BryanHoo/Codexly/compare/v0.37.0...v0.37.1
 [0.37.0]: https://github.com/BryanHoo/Codexly/compare/v0.36.0...v0.37.0

package/README.md

@@ -8,7 +8,7 @@
   A local AI coding workspace for desktop and browser.
 </p>
 
-Codexly keeps coding tasks, conversations, project files, and Git work in one place. Choose the desktop app for a self-contained workspace or run the Web edition locally and open it from a browser, including on a mobile device on your trusted network. Your projects and Codex runtime stay on the computer running Codexly.
+Codexly keeps coding tasks, conversations, project files, and Git work in one place. Choose the desktop app for a self-contained workspace or run the Web edition locally and open it from a browser, including on a mobile device on your trusted network. Your projects and agent runtimes stay on the computer running Codexly.
 
 <p align="center">
   <a href="#get-codexly">Get Codexly</a>
@@ -29,7 +29,7 @@ Directories and tasks are managed locally by Codexly, with one disk folder per d
 | Desktop | A native workspace with an integrated terminal, task window, system notifications, and tray controls | [Download for Windows, Ubuntu, or macOS](https://github.com/BryanHoo/Codexly/releases) and follow the [desktop installation guide](desktop/docs/installation.en.md) |
 | Web     | A local browser workspace accessible from your computer or another device on a trusted LAN           | Install Node.js 24+ and [start the Web edition](#start-the-web-edition)                                                                                             |
 
-Desktop packages are available for Windows 10/11 x64, Ubuntu 24.04+ x64, macOS 14.5+ (Apple Silicon or Intel), and a separate Legacy build for macOS 12.4+ Intel. See the [installation instructions](desktop/docs/installation.en.md) for setup steps and system prompts on each platform. The desktop app installs and verifies its own private Codex runtime on first launch.
+Desktop packages are available for Windows 10/11 x64, Ubuntu 24.04+ x64, macOS 14.5+ (Apple Silicon or Intel), and a separate Legacy build for macOS 12.4+ Intel. See the [installation instructions](desktop/docs/installation.en.md) for setup steps and system prompts on each platform. Desktop packages include the target platform’s Codex and Claude runtimes, with no separate Node or Bun installation or first-launch runtime download. macOS Legacy provides Codex only.
 
 ## Web Preview
 
@@ -37,6 +37,8 @@ Desktop packages are available for Windows 10/11 x64, Ubuntu 24.04+ x64, macOS 1
 
 ## Features
 
+- Choose Codex or Claude for each task and enable either engine independently, with shared chat, tool approvals, attachments, plans, subagents, message queues, and scheduled tasks. Claude also supports live steering, session forks, and compaction. See [agent engines and connections](docs/agent-engines.md).
+
 - Follow task responses, commands, approvals, reasoning summaries, and file changes as they arrive, with file edit timing and completion summaries; keep follow-up messages in a persistent queue.
 - Load recent conversation history first, fetch older turns from the top, and load execution details independently when expanding a process; long code previews use shared rendering and bounded highlighting. See [conversation loading and performance](docs/conversation-performance.md).
 - Open up to four task panes in desktop browsers and the desktop app, each with its own draft and message queue. File and Git panels follow the focused task; mobile Web keeps a single-task view.
@@ -54,9 +56,9 @@ Desktop packages are available for Windows 10/11 x64, Ubuntu 24.04+ x64, macOS 1
 - Manage Skills, plugins, MCP services, projects, archived tasks, notifications, and scheduled work. Refresh official plugins to synchronize their state and report partial failures.
 - Request background compression of history files untouched for over 7 days under Settings → Agent → History storage. Web compresses server history; desktop compresses local history. Other Codex clients sharing that directory must support compressed history.
 
-**Desktop** adds a native project terminal, global shortcuts, a separate task window, tray integration, and an app-private Codex installation. It supports Windows, Ubuntu, and macOS, with an option in general settings to launch at system login. See the [desktop guide](desktop/README.en.md) for its full feature set and update behavior.
+**Desktop** adds a native project terminal, global shortcuts, a separate task window, tray integration, and bundled agent runtimes. It supports Windows, Ubuntu, and macOS, with an option in general settings to launch at system login. See the [desktop guide](desktop/README.en.md) for its full feature set and update behavior.
 
-**Web** runs a local server and opens in your browser. It supports trusted LAN access from phones and other devices, task boards, Mermaid diagrams, and customizable workspace backgrounds. The Web edition includes Codex CLI `0.162.0` through `@openai/codex`; external binaries supplied through `--codex-bin <path>` or `CODEXLY_CODEX_BIN` must satisfy `>=0.162.0,<0.163.0`.
+**Web** runs a local server and opens in your browser. It supports trusted LAN access from phones and other devices, task boards, Mermaid diagrams, and customizable workspace backgrounds. The Web edition includes Codex CLI `0.163.0` through `@openai/codex`; external binaries supplied through `--codex-bin <path>` or `CODEXLY_CODEX_BIN` must satisfy `>=0.163.0,<0.164.0`.
 
 Browsers and devices connected to the same Web server synchronize project todos and asynchronous questions. Reconnecting or returning to a visible page refreshes their state.
 
@@ -80,7 +82,7 @@ Run `codexly --version` to check the installed version, or `codexly <command> --
 
 Multiple Web instances can run from the same launch directory and share the same Codex Home; occupied ports are skipped automatically. The launch directory does not determine internal configuration or the temporary task directory. Temporary tasks use the user's home directory by default, or the first explicit `--workspace` root. Use different `--codex-home <directory>` values to isolate data.
 
-On first launch, sign in with ChatGPT or configure an OpenAI-compatible service that supports the Responses API and `GET /models`.
+On first launch, enable Codex, Claude, or both. For Codex, sign in with ChatGPT or configure an OpenAI-compatible service supporting the Responses API and `GET /models`. Claude can reuse existing local credentials or connect to an Anthropic Messages-compatible API using its URL and key; the app does not offer Claude account login. Claude-only setups do not require Codex configuration.
 Custom providers discover available models and preserve declared capabilities and reasoning levels. The reasoning menu stays hidden when the catalog declares no reasoning support. See [models and reasoning effort](docs/model-discovery.md).
 
 For regular use, install Codexly globally:
@@ -168,3 +170,7 @@ Thanks to the [LinuxDO](https://linux.do/) community for their support
 ## License
 
 [MIT](LICENSE)
+
+### Claude Agent
+
+New conversations can select Codex or Claude Agent (Claude Code). Configure the Claude API, defaults, permissions and tool rules in Settings. Existing conversations keep their engine; Claude account login is not supported. See the [engine guide](docs/agent-engines.md) for architecture, platform requirements and capability boundaries.

package/README.zh-CN.md

@@ -2,7 +2,7 @@
 
 [English](README.md) | 简体中文
 
-Codexly 是本地 AI 编程工作台，提供桌面应用和 Web 版。它将编程任务、对话、项目文件与 Git 操作集中在一处。桌面版适合在本机持续工作；Web 版在本地运行，可通过浏览器从电脑或可信局域网中的移动设备访问。项目文件和 Codex 运行时始终留在运行 Codexly 的电脑上。
+Codexly 是本地 AI 编程工作台，提供桌面应用和 Web 版。它将编程任务、对话、项目文件与 Git 操作集中在一处。桌面版适合在本机持续工作；Web 版在本地运行，可通过浏览器从电脑或可信局域网中的移动设备访问。项目文件和智能体运行时始终留在运行 Codexly 的电脑上。
 
 目录和任务由 Codexly 自行管理，每个目录对应一个磁盘文件夹；旧数据首次启动时自动导入，详见[本地目录与任务](docs/local-catalog.md)。
 
@@ -13,10 +13,12 @@ Codexly 是本地 AI 编程工作台，提供桌面应用和 Web 版。它将编
 | 桌面版 | 原生工作台、集成终端、独立任务窗口、系统通知与托盘 | [下载 Windows、Ubuntu 或 macOS 安装包](https://github.com/BryanHoo/Codexly/releases)，按[桌面安装指南](desktop/docs/installation.md)安装 |
 | Web 版 | 本机浏览器工作台，或从可信局域网内的其他设备访问   | 安装 Node.js 24+，按[Web 版启动步骤](#启动-web-版)运行                                                                                   |
 
-桌面安装包支持 Windows 10/11 x64、Ubuntu 24.04+ x64、macOS 14.5+（Apple Silicon / Intel），并提供 macOS 12.4+ Intel 的 Legacy 版本。安装步骤与各平台的系统提示见[安装指南](desktop/docs/installation.md)。桌面版首次启动会自动安装并校验应用私有的 Codex 运行时。
+桌面安装包支持 Windows 10/11 x64、Ubuntu 24.04+ x64、macOS 14.5+（Apple Silicon / Intel），并提供 macOS 12.4+ Intel 的 Legacy 版本。安装步骤与各平台的系统提示见[安装指南](desktop/docs/installation.md)。桌面安装包已内置目标平台的 Codex 与 Claude 运行时，无需另装 Node、Bun 或首次启动下载；macOS Legacy 仅提供 Codex。
 
 ## 主要功能
 
+- 选择 Codex 或 Claude 处理任务，可单独启用任一引擎；共用聊天、工具审批、附件、任务计划、子代理、消息队列和定时任务。Claude 还支持运行中引导、会话分叉与压缩，详见[智能体引擎与连接](docs/agent-engines.md)。
+
 - 实时查看任务回复、命令、审批、推理摘要和文件变更，查看文件编辑耗时与完成汇总，并用持久化队列安排后续消息。
 - 优先加载最近的会话历史，顶部按需读取更早回合，展开过程后独立加载执行条目；长代码预览共用渲染与有界高亮。详见[会话加载与性能](docs/conversation-performance.md)。
 - 在 Web 桌面浏览器与桌面应用中并行打开最多四个任务，各分屏保留独立草稿与消息队列；文件和 Git 面板跟随当前聚焦任务，Web 移动端保持单任务视图。
@@ -28,15 +30,15 @@ Codexly 是本地 AI 编程工作台，提供桌面应用和 Web 版。它将编
 - 查看 Markdown 回复中嵌入的任务本地图片，并打开图片预览。
 - 使用助手回复中的文件引用、代码审查评论与后续建议；点击建议后可在输入框继续编辑。
 - 为任务选择模型、思考量、快速模式、审批策略和文件访问范围，并在全局设置中配置[上下文窗口](docs/model-context-window.md)。
-- 新建项目及目录，跨项目搜索任务、历史消息和文件；检查变更、管理分支与 worktree，选择文件后提交或提交并推送，也可独立推送已有提交；详见 [Git 操作指南](docs/git-workflow.md)。Git 操作仅作用于项目根目录对应的仓库，普通子目录不会借用父仓库。
+- 新建项目及目录，跨项目搜索任务、历史消息和文件；检查变更、管理分支与 worktree，选择文件后提交或提交并推送，也可独立推送已有提交；详见 [Git 操作指南](docs/git-workflow.md)。Git 操作仅作用于项目根目录对应的仓库，普通子目录不会借用父仓库。 Web（含移动端）与桌面端均可在输入框底部分支菜单创建、选择 worktree；新工作树统一存放在主项目的 `.worktree/` 下。发送消息时再使用输入框中的 Claude / Codex、模型等配置创建任务，任务仍归属原项目。
 - 在侧栏「已固定」与「运行中」快捷区切换任务，未查看的完成任务优先于待审批与运行任务展示，并保留在分组总数中，查看后清除完成提醒；可折叠预览或打开完整列表，项目收起时仍可访问。
 - 通过侧栏任务的项目标签识别任务来源；项目收起时仍显示未读完成、等待审批或运行状态。
 - 管理 Skills、插件、MCP 服务、项目、归档任务、通知与定时工作；刷新官方插件可同步状态，并提示部分失败。
 - 在「设置 → 智能体配置 → 历史文件存储」手动请求后台压缩超过 7 天未写入的历史；Web 作用于服务端，桌面端作用于本机。共用历史目录的其他 Codex 客户端需支持压缩格式。
 
-**桌面版**提供原生项目终端、全局快捷键、独立任务窗口、托盘集成和应用私有 Codex 安装。支持 Windows、Ubuntu 和 macOS；在通用设置中可启用登录系统后自动启动。完整功能与更新方式见[桌面版指南](desktop/README.md)。
+**桌面版**提供原生项目终端、全局快捷键、独立任务窗口、托盘集成和随包内置的智能体运行时。支持 Windows、Ubuntu 和 macOS；在通用设置中可启用登录系统后自动启动。完整功能与更新方式见[桌面版指南](desktop/README.md)。
 
-**Web 版**在本机运行服务并由浏览器访问，支持手机等设备从可信局域网接入、任务看板、Mermaid 图表和自定义工作台背景。Web 版通过 `@openai/codex` 自带 Codex CLI `0.162.0`；使用 `--codex-bin <path>` 或 `CODEXLY_CODEX_BIN` 指定外部版本时，版本必须满足 `>=0.162.0,<0.163.0`。
+**Web 版**在本机运行服务并由浏览器访问，支持手机等设备从可信局域网接入、任务看板、Mermaid 图表和自定义工作台背景。Web 版通过 `@openai/codex` 自带 Codex CLI `0.163.0`；使用 `--codex-bin <path>` 或 `CODEXLY_CODEX_BIN` 指定外部版本时，版本必须满足 `>=0.163.0,<0.164.0`。
 
 连接同一 Web 服务的浏览器与设备会同步项目待办和异步问答变更；断线重连或页面恢复可见时刷新状态。
 
@@ -60,7 +62,7 @@ Codexly 会自动打开浏览器。若未打开，请访问终端输出的地址
 
 可以在同一启动目录或同一 Codex Home 下同时运行多个 Web 实例；端口占用时自动递增。启动目录不决定应用内部配置或临时任务目录：临时任务默认使用用户主目录，显式指定 `--workspace` 时使用首个工作区。使用不同的 `--codex-home <目录>` 可隔离数据。
 
-首次启动时，使用 ChatGPT 登录，或配置兼容 Responses API 和 `GET /models` 的 OpenAI-compatible 服务。
+首次启动时，选择启用 Codex、Claude 或两者。Codex 可使用 ChatGPT 登录，或配置兼容 Responses API 和 `GET /models` 的 OpenAI-compatible 服务；Claude 可复用本机已有认证，或填写兼容 Anthropic Messages API 的地址与密钥，不提供应用内 Claude 账号登录。仅启用 Claude 时无需配置 Codex。
 自定义 Provider 会发现可用模型，保留目录声明的能力与思考档位；未声明推理能力时隐藏思考强度菜单。详见[模型与思考强度](docs/model-discovery.md)。
 
 经常使用时可以全局安装：
@@ -150,3 +152,7 @@ npm install --global @bryanhu/codexly@latest
 ## 许可证
 
 [MIT](LICENSE)
+
+### Claude Agent
+
+新聊天可选择 Codex 或 Claude Agent（Claude Code）。在设置页配置 Claude API、默认模型、权限和工具规则；历史聊天不能切换引擎，不提供 Claude 官方账号登录。架构、平台要求和能力边界见[双引擎说明](docs/agent-engines.md)。