@bryanhu/codexly 0.37.1 → 0.39.1

package/CHANGELOG.md

@@ -4,6 +4,66 @@
 
 ## [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
+
+### 新增
+
+- Web（含移动端）与桌面端由应用本地仓储统一管理目录、任务、名称、置顶与归档状态；每个目录对应一个磁盘文件夹，首次启动自动迁移旧目录和任务，保留原任务链接与偏好。
+- 两端侧栏发现新版本后可直接打开更新日志并安装更新；桌面端展示下载进度，Web 端复用服务端更新流程。
+
+### 优化
+
+- 两端保留模型目录声明的原生能力、默认值与未知思考档位；未声明推理能力时隐藏思考强度菜单，避免提交虚构档位；自定义目录地址和同端点能力缓存保持有效。
+- 两端统一选择控件与键盘焦点样式；按项目语言裁剪语法高亮，减少不必要的构建内容。
+
+### 修复
+
+- 修复旧目录路径规范化异常，保留项目身份与设置；单目录选择替换旧选择，兼容历史多目录项目的迁移与任务归属。
+- 修复桌面端本地目录数据库连接未释放的问题，确保正常关闭应用与清理资源。
+
+### 工程
+
+- 移除容器构建与镜像发布流程，保留 npm 与各平台桌面安装包的联合发布。
+- 本地 Tauri 打包支持清理构建缓存；补充缓存清理、Windows 路径和原生集成测试，调整普通测试及清理超时以适应冷启动。
+- 同步 Web 与桌面端中英文功能说明、本地目录迁移及模型能力文档。
+
 ## [0.37.1] - 2026-10-15
 
 ### 修复
@@ -18,7 +78,7 @@
 
 - 为桌面端添加原生调用与权限声明的全量校验，补充会话分页、图片提交和侧栏完成状态的回归覆盖。
 - 修复 Web 浏览器测试中快照请求的拦截范围、桌面侧栏状态测试的路由环境与定位范围，放宽 Windows 测试与 CI 超时，降低环境竞争导致的失败。
-- 同步两端中英文功能说明、会话加载与性能文档及 Docker 固定版本示例。
+- 同步两端中英文功能说明、会话加载与性能文档。
 
 ## [0.37.0] - 2026-10-14
 
@@ -42,7 +102,7 @@
 
 ### 工程
 
-- 同步两端中英文功能与操作说明、共用 Git 指南和 Docker 固定版本示例；补充 Windows 本机全量验证记录，保留可信终端按键渲染 P95 为 33.7ms、尚未达到 30ms 目标的实测结果。
+- 同步两端中英文功能与操作说明、共用 Git 指南；补充 Windows 本机全量验证记录，保留可信终端按键渲染 P95 为 33.7ms、尚未达到 30ms 目标的实测结果。
 - 修复浏览器组件测试的国际化初始化与面板挂载等待、侧栏固定任务的完整列表定位、Windows 原生测试路径及资源采样中的 PID 复用判断，更新 Rust 审计工具与 CI Node.js 配置。
 
 ## [0.36.0] - 2026-10-13
@@ -72,7 +132,7 @@
 - macOS 正式发布启用 Developer ID 签名、公证、票据装订与产物验证，Modern 和 Legacy 更新清单保持独立。
 - 补充 Git 提交、独立推送、自启动、共享运行时和助手回复解析回归覆盖，记录 Windows 与 Ubuntu 本机全量验证结果。
 - 隔离桌面存储测试的临时目录，避免系统时钟精度不足导致并发用例互相清理文件。
-- 同步两端中英文说明、Git 操作指南、联合发布步骤及 Docker 固定版本示例。
+- 同步两端中英文说明、Git 操作指南和联合发布步骤。
 
 ## [0.35.0] - 2026-10-11
 
@@ -99,7 +159,7 @@
 ### 工程
 
 - 补充历史分页、跨设备同步、事件字节预算、附件异步落盘、Markdown 收尾和工作台面板回归覆盖，并同步发布包检查与桌面构建体积预算。
-- 更新两端中英文功能说明、共用长会话与性能文档及 Docker 固定版本部署示例。
+- 更新两端中英文功能说明、共用长会话与性能文档。
 
 ## [0.34.1] - 2026-10-10
 
@@ -203,7 +263,6 @@
 
 - 修复输入框更新后选区被延迟覆盖、空配置章节导致记忆设置默认值错误，以及分页读取多字节 UTF-8 文件时的边界问题。
 - 修复桌面端偏好写入失败后的退出恢复与终端关闭清理。
-- 修复 Docker 依赖层缺少 Workspace 包清单导致镜像构建失败的问题。
 
 ## [0.29.0] - 2026-09-29
 
@@ -260,7 +319,7 @@
 
 ### 新增
 
-- 将 Codexly Web 与 Codexly Desktop 纳入同一仓库，以同一版本标签发布 npm、GHCR 和桌面安装包；桌面端统一使用 Codexly 产品名称和 `com.codexly.desktop` 应用标识。
+- 将 Codexly Web 与 Codexly Desktop 纳入同一仓库，以同一版本标签发布 npm 和桌面安装包；桌面端统一使用 Codexly 产品名称和 `com.codexly.desktop` 应用标识。
 
 ### 修复
 
@@ -295,7 +354,6 @@
 
 ### 新增
 
-- 支持在 Docker 部署中保留宿主工作区绝对路径、挂载全局 Git 配置与 SSH 凭据，便于复用已有项目和访问远程仓库。
 - 持久化 Thread 历史附件元数据与正文，使附件在任务恢复、分叉和服务重启后仍可安全读取。
 
 ### 优化
@@ -307,17 +365,8 @@
 - 放宽自定义局域网密码对 Shell 特殊字符的限制，并限制局域网客户端调用仅适用于宿主设备的操作。
 - 修复流式 Markdown 强调标记跨片段到达时可能错误渲染的问题。
 
-### 工程
-
-- 升级 Docker 构建、登录、元数据与多架构模拟相关 GitHub Actions。
-
 ## [0.23.0] - 2026-09-18
 
-### 新增
-
-- 添加生产级 Docker 镜像与可独立下载的 Docker Compose 配置，支持自定义工作区、Codex Home、端口、配对密码及会话期限。
-- 扩展发布流程，在 npm 包通过验证后同步发布带 SBOM 和 provenance 的 `linux/amd64`、`linux/arm64` GHCR 镜像。
-
 ### 修复
 
 - 限制项目选择只能落在配置工作区的真实路径内，阻止通过符号链接越过工作区边界。
@@ -1003,7 +1052,10 @@
 
 - 添加最小化 Tauri 权限、依赖供应链审计与 Provider 运行时完整性校验。
 
-[Unreleased]: https://github.com/BryanHoo/Codexly/compare/v0.37.1...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
 [0.36.0]: https://github.com/BryanHoo/Codexly/compare/v0.35.0...v0.36.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>
@@ -20,6 +20,8 @@ Codexly keeps coding tasks, conversations, project files, and Git work in one pl
   <a href="./LICENSE">License</a>
 </p>
 
+Directories and tasks are managed locally by Codexly, with one disk folder per directory. Existing data is imported on first launch; see [local directories and tasks](docs/local-catalog.md).
+
 ## Get Codexly
 
 | Edition | Best for                                                                                             | Get started                                                                                                                                                         |
@@ -27,7 +29,7 @@ Codexly keeps coding tasks, conversations, project files, and Git work in one pl
 | 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
 
@@ -35,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.
@@ -52,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, Docker deployment, 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.
 
@@ -78,8 +82,8 @@ 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`.
-Custom providers discover available models; basic reasoning levels remain selectable when model metadata omits them.
+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:
 
@@ -108,50 +112,9 @@ Repeating `enable` updates the same entry with the supplied options. Without `--
 
 Temporary `npx` installations cannot register startup. Run `codexly autostart repair --now` after moving Node/npm, and disable before uninstalling the package. Use `codexly start --no-open` to suppress the browser during a foreground launch. See the [Web startup at login guide](docs/web-autostart.md) for configuration, environment handling, Linux linger restrictions, and troubleshooting.
 
-## Docker
-
-Download the user-facing Compose file and start the published image:
-
-```bash
-mkdir codexly && cd codexly
-curl -fsSLO https://raw.githubusercontent.com/BryanHoo/Codexly/main/compose.yaml
-curl -fsSLo .env.example https://raw.githubusercontent.com/BryanHoo/Codexly/main/.env.example
-cp .env.example .env
-docker compose pull
-docker compose up --detach
-docker compose logs --tail=50 codexly
-```
-
-Open `http://127.0.0.1:3210` and use the random pairing code printed in the logs. The default named volume preserves Codex login data and Codexly's SQLite state. On Linux and macOS, the Compose file mounts the host root at `/workspace`, so every mounted disk is available to the project picker. Set `CODEXLY_WORKSPACE` to expose only one directory and preserve its absolute path inside the container:
-
-```bash
-CODEXLY_WORKSPACE=/path/to/projects docker compose up --detach
-```
-
-When binding the host `CODEXLY_CODEX_HOME`, also set `CODEXLY_WORKSPACE` to a common parent of the existing projects. Their absolute paths then remain identical on the host and in the container.
-
-The container does not automatically inherit the host Git identity. Set `CODEXLY_GIT_CONFIG` to a global Git config file visible inside the container. With an identity-mapped Linux or macOS workspace, use the absolute path to the host `~/.gitconfig` directly. For SSH remotes, set `CODEXLY_SSH_HOME` to the absolute path of the host `~/.ssh` directory.
-
-Docker can only access host paths shared with the Docker engine. On Windows, set `CODEXLY_WORKSPACE` to a shared drive such as `C:/` and set `CODEXLY_WORKSPACE_TARGET=/workspace`. Windows and Linux container paths use different absolute path formats, so a Codex Home containing host project records cannot be reused directly. Add extra bind mounts and repeat `--workspace` in `command` when multiple drives are required.
-
-| Variable                   | Purpose                                                                |
-| -------------------------- | ---------------------------------------------------------------------- |
-| `CODEXLY_VERSION`          | Select the GHCR image tag; defaults to `latest`                        |
-| `CODEXLY_PORT`             | Set both the host and container port; defaults to `3210`               |
-| `CODEXLY_WORKSPACE`        | Restrict the workspace and preserve its absolute path; defaults to `/` |
-| `CODEXLY_WORKSPACE_TARGET` | Override the container path; use `/workspace` on Windows               |
-| `CODEXLY_GIT_CONFIG`       | Select a container-visible global Git config file                      |
-| `CODEXLY_SSH_HOME`         | Mount host SSH config, keys, and `known_hosts` read-only               |
-| `CODEXLY_CODEX_HOME`       | Bind a host Codex home instead of the managed `codexly-data` volume    |
-| `CODEXLY_LAN_PASSWORD`     | Set a strong fixed access password instead of the logged random code   |
-| `CODEXLY_ALLOWED_HOSTS`    | Allow comma-separated exact reverse proxy domains                      |
-| `CODEXLY_SESSION_TTL`      | Set a fixed session lifetime such as `12h`                             |
-
-The image entrypoint accepts all normal CLI arguments, so orchestration platforms can replace `command` when needed. See the [complete Docker Compose deployment guide](docs/docker-deployment.md) for workspace, multiple-disk, Codex Home, update, backup, and troubleshooting instructions. Run `pnpm docker:build && pnpm docker:test` in a development checkout to build and smoke-test the local image.
-
 ## Using the Web Edition
 
-Select **New task** for work that does not need a project. For repository work, add one or more host directories as ordered project roots, create a task, and submit your request with any required files, images, project references, or Skills. Archived tasks can be restored or permanently deleted from the project task list.
+Select **New task** for work that does not need a project. For repository work, add one host folder as the project directory, create a task, and submit your request with any required files, images, project references, or Skills. Archived tasks can be restored or permanently deleted from the project task list.
 
 The Changes toolbar shows the branch, push destination, and incoming/outgoing counts, with remote configuration, branch publishing, fetch, fast-forward pull, and independent push actions. The footer edits the commit message; the main button commits and **More Git actions** offers **Commit and push**. Drafts persist on the current device by project, worktree, and branch; AI generation can be undone. A failed push preserves the local commit for retry. **Publish branch** establishes upstream tracking, and history marks unpushed commits.
 
@@ -185,7 +148,7 @@ Quote passwords containing shell-special characters. LAN mode uses unencrypted H
 
 Run `codexly doctor` when startup, Codex, or local data checks fail. Use `codexly --help` for all commands, `codexly start --help` or `codexly doctor --help` for command options, and `codexly --version` for the installed version.
 
-Interactive startup and **Settings > About** check for new releases. Built-in updates probe the official registry and a mirror in parallel, use the first source that responds successfully, and fall back to the other source on failure. Package downloads and dependency installation reuse the selection for that update and your npm cache. New releases may appear later if the selected mirror is still synchronizing. A global installation can also be updated with:
+Interactive startup and **Settings > About** check for new releases. When the sidebar shows an update, click the version to read its release notes and install it. Built-in updates probe the official registry and a mirror in parallel, use the first source that responds successfully, and fall back to the other source on failure. Package downloads and dependency installation reuse the selection for that update and your npm cache. New releases may appear later if the selected mirror is still synchronizing. A global installation can also be updated with:
 
 ```bash
 npm install --global @bryanhu/codexly@latest
@@ -207,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,9 @@
 
 [English](README.md) | 简体中文
 
-Codexly 是本地 AI 编程工作台，提供桌面应用和 Web 版。它将编程任务、对话、项目文件与 Git 操作集中在一处。桌面版适合在本机持续工作；Web 版在本地运行，可通过浏览器从电脑或可信局域网中的移动设备访问。项目文件和 Codex 运行时始终留在运行 Codexly 的电脑上。
+Codexly 是本地 AI 编程工作台，提供桌面应用和 Web 版。它将编程任务、对话、项目文件与 Git 操作集中在一处。桌面版适合在本机持续工作；Web 版在本地运行，可通过浏览器从电脑或可信局域网中的移动设备访问。项目文件和智能体运行时始终留在运行 Codexly 的电脑上。
+
+目录和任务由 Codexly 自行管理，每个目录对应一个磁盘文件夹；旧数据首次启动时自动导入，详见[本地目录与任务](docs/local-catalog.md)。
 
 ## 获取 Codexly
 
@@ -11,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 移动端保持单任务视图。
@@ -26,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 版**在本机运行服务并由浏览器访问，支持手机等设备从可信局域网接入、Docker 部署、任务看板、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 服务的浏览器与设备会同步项目待办和异步问答变更；断线重连或页面恢复可见时刷新状态。
 
@@ -58,8 +62,8 @@ Codexly 会自动打开浏览器。若未打开，请访问终端输出的地址
 
 可以在同一启动目录或同一 Codex Home 下同时运行多个 Web 实例；端口占用时自动递增。启动目录不决定应用内部配置或临时任务目录：临时任务默认使用用户主目录，显式指定 `--workspace` 时使用首个工作区。使用不同的 `--codex-home <目录>` 可隔离数据。
 
-首次启动时，使用 ChatGPT 登录，或配置兼容 Responses API 和 `GET /models` 的 OpenAI-compatible 服务。
-自定义 Provider 会发现可用模型；模型未提供思考档位时可选择基础档位。
+首次启动时，选择启用 Codex、Claude 或两者。Codex 可使用 ChatGPT 登录，或配置兼容 Responses API 和 `GET /models` 的 OpenAI-compatible 服务；Claude 可复用本机已有认证，或填写兼容 Anthropic Messages API 的地址与密钥，不提供应用内 Claude 账号登录。仅启用 Claude 时无需配置 Codex。
+自定义 Provider 会发现可用模型，保留目录声明的能力与思考档位；未声明推理能力时隐藏思考强度菜单。详见[模型与思考强度](docs/model-discovery.md)。
 
 经常使用时可以全局安装：
 
@@ -94,50 +98,9 @@ codexly autostart disable
 
 配置位置、环境变量、Linux linger 限制和各系统故障排查见 [Web 登录自启动指南](docs/web-autostart.zh-CN.md)。
 
-## Docker 部署
-
-下载用户版 Compose 配置并启动已发布镜像：
-
-```bash
-mkdir codexly && cd codexly
-curl -fsSLO https://raw.githubusercontent.com/BryanHoo/Codexly/main/compose.yaml
-curl -fsSLo .env.example https://raw.githubusercontent.com/BryanHoo/Codexly/main/.env.example
-cp .env.example .env
-docker compose pull
-docker compose up --detach
-docker compose logs --tail=50 codexly
-```
-
-打开 `http://127.0.0.1:3210`，使用日志中的随机配对码。默认命名卷会持久化 Codex 登录数据和 Codexly SQLite 状态。在 Linux 和 macOS 上，Compose 默认把宿主根目录挂载到 `/workspace`，项目选择器可读取所有已挂载磁盘。设置 `CODEXLY_WORKSPACE` 后只暴露指定目录，并在容器中保留其绝对路径：
-
-```bash
-CODEXLY_WORKSPACE=/path/to/projects docker compose up --detach
-```
-
-绑定宿主 `CODEXLY_CODEX_HOME` 时，应同时把 `CODEXLY_WORKSPACE` 设置为已有项目的公共父目录。Codex 保存的项目绝对路径随后可在宿主和容器中保持一致。
-
-容器不会自动继承宿主 Git 身份。将 `CODEXLY_GIT_CONFIG` 设置为容器可见的全局 Git 配置文件；在 Linux 和 macOS 的同路径工作区中可直接填写宿主 `~/.gitconfig` 的绝对路径。使用 SSH 远程时，将 `CODEXLY_SSH_HOME` 设置为宿主 `~/.ssh` 的绝对路径。
-
-Docker 只能访问 Docker Engine 已共享的宿主路径。Windows 需将 `CODEXLY_WORKSPACE` 设置为已共享盘符（例如 `C:/`），并设置 `CODEXLY_WORKSPACE_TARGET=/workspace`。Windows 与 Linux 容器的绝对路径格式不同，不能直接复用包含宿主项目记录的 Codex Home；需要多个盘符时，在 Compose 中增加 bind mount，并在 `command` 中重复传入 `--workspace`。
-
-| 变量                       | 用途                                                |
-| -------------------------- | --------------------------------------------------- |
-| `CODEXLY_VERSION`          | 指定 GHCR 镜像标签，默认 `latest`                   |
-| `CODEXLY_PORT`             | 同时设置宿主与容器端口，默认 `3210`                 |
-| `CODEXLY_WORKSPACE`        | 限制工作区并在容器内保留相同绝对路径，默认 `/`      |
-| `CODEXLY_WORKSPACE_TARGET` | 覆盖容器工作区路径，Windows 使用 `/workspace`       |
-| `CODEXLY_GIT_CONFIG`       | 指定容器可见的全局 Git 配置文件                     |
-| `CODEXLY_SSH_HOME`         | 只读挂载宿主 SSH 配置、私钥和 `known_hosts`         |
-| `CODEXLY_CODEX_HOME`       | 绑定宿主 Codex Home，替代默认 `codexly-data` 命名卷 |
-| `CODEXLY_LAN_PASSWORD`     | 设置固定强密码，替代日志中生成的随机配对码          |
-| `CODEXLY_ALLOWED_HOSTS`    | 设置逗号分隔的反向代理精确域名                      |
-| `CODEXLY_SESSION_TTL`      | 设置固定会话期限，例如 `12h`                        |
-
-镜像入口支持全部 CLI 参数，编排平台可按需覆盖 `command`。工作区、多磁盘、Codex Home、更新、备份和故障排查参见[完整 Docker Compose 部署指南](docs/docker-deployment.md)。开发仓库可运行 `pnpm docker:build && pnpm docker:test` 构建并冒烟测试本地镜像。
-
 ## 使用 Web 版
 
-不依赖项目时，直接选择“新建任务”。处理仓库时，先添加一个或多个运行端目录作为有序的项目根，再创建任务，并按需附加文件、图片、项目引用或 Skills 后提交需求。归档的任务可以从项目任务列表中恢复或永久删除。
+不依赖项目时，直接选择“新建任务”。处理仓库时，先添加一个运行端文件夹作为项目目录，再创建任务，并按需附加文件、图片、项目引用或 Skills 后提交需求。归档的任务可以从项目任务列表中恢复或永久删除。
 
 Git 变更面板顶部显示分支、推送目标及待同步数量，提供远端配置、发布分支、获取更新、仅快进拉取与独立推送。底部编辑提交信息，主按钮执行「提交」，「更多 Git 操作」提供「提交并推送」。草稿按项目、worktree 和分支保存在当前设备；AI 生成可撤销，推送失败会保留本地提交并可单独重试。首次推送可通过「发布分支」建立上游，历史中可查看未推送标记。
 
@@ -171,7 +134,7 @@ codexly start --lan
 
 启动、Codex 或本地数据检查失败时运行 `codexly doctor`。使用 `codexly --help` 查看完整命令，`codexly start --help` 或 `codexly doctor --help` 查看对应选项，`codexly --version` 查看版本。
 
-交互式启动和“设置 > 关于”会检查新版本。内置更新会并行探测官方源和镜像源，优先使用最先成功响应的源，失败后切换另一个源；同一次更新的包下载和依赖安装复用选源结果及用户的 npm 缓存。若选中的镜像仍在同步，新版本可能稍晚显示。全局安装也可以通过以下命令更新：
+交互式启动和“设置 > 关于”会检查新版本。侧栏出现更新提示后，点击版本号即可查看更新日志并安装更新。内置更新会并行探测官方源和镜像源，优先使用最先成功响应的源，失败后切换另一个源；同一次更新的包下载和依赖安装复用选源结果及用户的 npm 缓存。若选中的镜像仍在同步，新版本可能稍晚显示。全局安装也可以通过以下命令更新：
 
 ```bash
 npm install --global @bryanhu/codexly@latest
@@ -189,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)。