@bryanhu/codexly 0.37.0 → 0.38.0

package/CHANGELOG.md

@@ -4,6 +4,45 @@
 
 ## [Unreleased]
 
+## [0.38.0] - 2026-10-16
+
+### 新增
+
+- Web（含移动端）与桌面端由应用本地仓储统一管理目录、任务、名称、置顶与归档状态；每个目录对应一个磁盘文件夹，首次启动自动迁移旧目录和任务，保留原任务链接与偏好。
+- 两端侧栏发现新版本后可直接打开更新日志并安装更新；桌面端展示下载进度，Web 端复用服务端更新流程。
+
+### 优化
+
+- 两端保留模型目录声明的原生能力、默认值与未知思考档位；未声明推理能力时隐藏思考强度菜单，避免提交虚构档位；自定义目录地址和同端点能力缓存保持有效。
+- 两端统一选择控件与键盘焦点样式；按项目语言裁剪语法高亮，减少不必要的构建内容。
+
+### 修复
+
+- 修复旧目录路径规范化异常，保留项目身份与设置；单目录选择替换旧选择，兼容历史多目录项目的迁移与任务归属。
+- 修复桌面端本地目录数据库连接未释放的问题，确保正常关闭应用与清理资源。
+
+### 工程
+
+- 移除容器构建与镜像发布流程，保留 npm 与各平台桌面安装包的联合发布。
+- 本地 Tauri 打包支持清理构建缓存；补充缓存清理、Windows 路径和原生集成测试，调整普通测试及清理超时以适应冷启动。
+- 同步 Web 与桌面端中英文功能说明、本地目录迁移及模型能力文档。
+
+## [0.37.1] - 2026-10-15
+
+### 修复
+
+- 修复 Web（含移动端）与桌面端历史回合和执行过程共用分页造成的加载混乱；顶部仅加载更早回合，展开过程后独立读取过程条目，保留问题与最终答复的顺序，并支持继续加载和失败重试。
+- 修复两端过程区域中长内容撑开布局的问题，保持内容在当前分屏内展示。
+- 修复两端侧栏任务完成后从快捷区消失的问题；未查看的完成任务保留并排在待审批、运行任务之前，计入分组总数，实际运行数量单独统计；查看任务后清除完成提醒。
+- 修复桌面端发送图片时的协议字段不一致与提交失败反馈，恢复图片附件发送。
+- 补齐桌面端 Git 远端操作、项目文件操作、终端与任务窗口等调用所需的 Tauri 权限，避免原生调用被权限检查拦截。
+
+### 工程
+
+- 为桌面端添加原生调用与权限声明的全量校验，补充会话分页、图片提交和侧栏完成状态的回归覆盖。
+- 修复 Web 浏览器测试中快照请求的拦截范围、桌面侧栏状态测试的路由环境与定位范围，放宽 Windows 测试与 CI 超时，降低环境竞争导致的失败。
+- 同步两端中英文功能说明、会话加载与性能文档。
+
 ## [0.37.0] - 2026-10-14
 
 ### 新增
@@ -26,7 +65,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
@@ -56,7 +95,7 @@
 - macOS 正式发布启用 Developer ID 签名、公证、票据装订与产物验证，Modern 和 Legacy 更新清单保持独立。
 - 补充 Git 提交、独立推送、自启动、共享运行时和助手回复解析回归覆盖，记录 Windows 与 Ubuntu 本机全量验证结果。
 - 隔离桌面存储测试的临时目录，避免系统时钟精度不足导致并发用例互相清理文件。
-- 同步两端中英文说明、Git 操作指南、联合发布步骤及 Docker 固定版本示例。
+- 同步两端中英文说明、Git 操作指南和联合发布步骤。
 
 ## [0.35.0] - 2026-10-11
 
@@ -83,7 +122,7 @@
 ### 工程
 
 - 补充历史分页、跨设备同步、事件字节预算、附件异步落盘、Markdown 收尾和工作台面板回归覆盖，并同步发布包检查与桌面构建体积预算。
-- 更新两端中英文功能说明、共用长会话与性能文档及 Docker 固定版本部署示例。
+- 更新两端中英文功能说明、共用长会话与性能文档。
 
 ## [0.34.1] - 2026-10-10
 
@@ -187,7 +226,6 @@
 
 - 修复输入框更新后选区被延迟覆盖、空配置章节导致记忆设置默认值错误，以及分页读取多字节 UTF-8 文件时的边界问题。
 - 修复桌面端偏好写入失败后的退出恢复与终端关闭清理。
-- 修复 Docker 依赖层缺少 Workspace 包清单导致镜像构建失败的问题。
 
 ## [0.29.0] - 2026-09-29
 
@@ -244,7 +282,7 @@
 
 ### 新增
 
-- 将 Codexly Web 与 Codexly Desktop 纳入同一仓库，以同一版本标签发布 npm、GHCR 和桌面安装包；桌面端统一使用 Codexly 产品名称和 `com.codexly.desktop` 应用标识。
+- 将 Codexly Web 与 Codexly Desktop 纳入同一仓库，以同一版本标签发布 npm 和桌面安装包；桌面端统一使用 Codexly 产品名称和 `com.codexly.desktop` 应用标识。
 
 ### 修复
 
@@ -279,7 +317,6 @@
 
 ### 新增
 
-- 支持在 Docker 部署中保留宿主工作区绝对路径、挂载全局 Git 配置与 SSH 凭据，便于复用已有项目和访问远程仓库。
 - 持久化 Thread 历史附件元数据与正文，使附件在任务恢复、分叉和服务重启后仍可安全读取。
 
 ### 优化
@@ -291,17 +328,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 镜像。
-
 ### 修复
 
 - 限制项目选择只能落在配置工作区的真实路径内，阻止通过符号链接越过工作区边界。
@@ -987,7 +1015,9 @@
 
 - 添加最小化 Tauri 权限、依赖供应链审计与 Provider 运行时完整性校验。
 
-[Unreleased]: https://github.com/BryanHoo/Codexly/compare/v0.37.0...HEAD
+[Unreleased]: https://github.com/BryanHoo/Codexly/compare/v0.38.0...HEAD
+[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
 [0.35.0]: https://github.com/BryanHoo/Codexly/compare/v0.34.1...v0.35.0

package/README.md

@@ -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                                                                                                                                                         |
@@ -36,7 +38,7 @@ Desktop packages are available for Windows 10/11 x64, Ubuntu 24.04+ x64, macOS 1
 ## Features
 
 - 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 and fetch older turns and items as needed; long code previews use shared rendering and bounded highlighting. See [conversation loading and performance](docs/conversation-performance.md).
+- 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.
 - Choose two, three, or four panes from **Split layout** in the task title bar, with auto fit, columns, rows, main-pane, or grid presets; keep the current chat and open new-task pages in the other panes. Available in desktop views.
 - Resize task panes by dragging their dividers, create tasks from the title bar, and see the model and reasoning effort while the composer is collapsed.
@@ -47,14 +49,14 @@ Desktop packages are available for Windows 10/11 x64, Ubuntu 24.04+ x64, macOS 1
 - Follow file citations, code review comments, and follow-up suggestions in assistant responses; selecting a suggestion fills the composer for further editing.
 - Choose a model, reasoning effort, Fast mode, approval policy, and file access level for each task, and configure the global [context window](docs/model-context-window.md).
 - Create projects and directories, search tasks, message history, and project files; inspect changes, work with branches and worktrees, commit selected files, commit and push, or push existing commits independently. See the [Git workflow guide](docs/git-workflow.md). Git actions require a repository at the project root; ordinary subdirectories do not use the parent repository.
-- Switch tasks from the sidebar’s **Pinned** and **Running** shortcuts, with pending approvals first; collapse previews or open the full list, even with projects collapsed.
+- Switch tasks from the sidebar’s **Pinned** and **Running** shortcuts, with unread completions first, followed by pending approvals and running tasks; unread completions remain in the group count until viewed. Collapse previews or open the full list, even with projects collapsed.
 - Identify each task's project through labels in the sidebar; collapsed projects still show unread completions, pending approvals, or running tasks.
 - 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.
 
-**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.162.0` through `@openai/codex`; external binaries supplied through `--codex-bin <path>` or `CODEXLY_CODEX_BIN` must satisfy `>=0.162.0,<0.163.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.
 
@@ -79,7 +81,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`.
-Custom providers discover available models; basic reasoning levels remain selectable when model metadata omits them.
+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 +110,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 +146,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

package/README.zh-CN.md

@@ -4,6 +4,8 @@
 
 Codexly 是本地 AI 编程工作台，提供桌面应用和 Web 版。它将编程任务、对话、项目文件与 Git 操作集中在一处。桌面版适合在本机持续工作；Web 版在本地运行，可通过浏览器从电脑或可信局域网中的移动设备访问。项目文件和 Codex 运行时始终留在运行 Codexly 的电脑上。
 
+目录和任务由 Codexly 自行管理，每个目录对应一个磁盘文件夹；旧数据首次启动时自动导入，详见[本地目录与任务](docs/local-catalog.md)。
+
 ## 获取 Codexly
 
 | 版本   | 适用场景                                           | 开始使用                                                                                                                                 |
@@ -16,7 +18,7 @@ Codexly 是本地 AI 编程工作台，提供桌面应用和 Web 版。它将编
 ## 主要功能
 
 - 实时查看任务回复、命令、审批、推理摘要和文件变更，查看文件编辑耗时与完成汇总，并用持久化队列安排后续消息。
-- 优先加载最近的会话历史，再按需读取更早的回合与条目；长代码预览共用渲染与有界高亮。详见[会话加载与性能](docs/conversation-performance.md)。
+- 优先加载最近的会话历史，顶部按需读取更早回合，展开过程后独立加载执行条目；长代码预览共用渲染与有界高亮。详见[会话加载与性能](docs/conversation-performance.md)。
 - 在 Web 桌面浏览器与桌面应用中并行打开最多四个任务，各分屏保留独立草稿与消息队列；文件和 Git 面板跟随当前聚焦任务，Web 移动端保持单任务视图。
 - 从任务标题栏的「分屏布局」选择双、三、四分屏的自适应、横排、竖排、主辅或田字布局；保留当前会话，其余分屏打开新建页。仅桌面视图提供此入口。
 - 拖动分割线调整任务分屏尺寸，从任务标题栏新建任务；收起输入框后仍可查看当前模型与思考量。
@@ -27,14 +29,14 @@ Codexly 是本地 AI 编程工作台，提供桌面应用和 Web 版。它将编
 - 使用助手回复中的文件引用、代码审查评论与后续建议；点击建议后可在输入框继续编辑。
 - 为任务选择模型、思考量、快速模式、审批策略和文件访问范围，并在全局设置中配置[上下文窗口](docs/model-context-window.md)。
 - 新建项目及目录，跨项目搜索任务、历史消息和文件；检查变更、管理分支与 worktree，选择文件后提交或提交并推送，也可独立推送已有提交；详见 [Git 操作指南](docs/git-workflow.md)。Git 操作仅作用于项目根目录对应的仓库，普通子目录不会借用父仓库。
-- 在侧栏「已固定」与「运行中」快捷区切换任务，优先处理待审批任务；可折叠预览或打开完整列表，项目收起时仍可访问。
+- 在侧栏「已固定」与「运行中」快捷区切换任务，未查看的完成任务优先于待审批与运行任务展示，并保留在分组总数中，查看后清除完成提醒；可折叠预览或打开完整列表，项目收起时仍可访问。
 - 通过侧栏任务的项目标签识别任务来源；项目收起时仍显示未读完成、等待审批或运行状态。
 - 管理 Skills、插件、MCP 服务、项目、归档任务、通知与定时工作；刷新官方插件可同步状态，并提示部分失败。
 - 在「设置 → 智能体配置 → 历史文件存储」手动请求后台压缩超过 7 天未写入的历史；Web 作用于服务端，桌面端作用于本机。共用历史目录的其他 Codex 客户端需支持压缩格式。
 
 **桌面版**提供原生项目终端、全局快捷键、独立任务窗口、托盘集成和应用私有 Codex 安装。支持 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.162.0`；使用 `--codex-bin <path>` 或 `CODEXLY_CODEX_BIN` 指定外部版本时，版本必须满足 `>=0.162.0,<0.163.0`。
 
 连接同一 Web 服务的浏览器与设备会同步项目待办和异步问答变更；断线重连或页面恢复可见时刷新状态。
 
@@ -59,7 +61,7 @@ Codexly 会自动打开浏览器。若未打开，请访问终端输出的地址
 可以在同一启动目录或同一 Codex Home 下同时运行多个 Web 实例；端口占用时自动递增。启动目录不决定应用内部配置或临时任务目录：临时任务默认使用用户主目录，显式指定 `--workspace` 时使用首个工作区。使用不同的 `--codex-home <目录>` 可隔离数据。
 
 首次启动时，使用 ChatGPT 登录，或配置兼容 Responses API 和 `GET /models` 的 OpenAI-compatible 服务。
-自定义 Provider 会发现可用模型；模型未提供思考档位时可选择基础档位。
+自定义 Provider 会发现可用模型，保留目录声明的能力与思考档位；未声明推理能力时隐藏思考强度菜单。详见[模型与思考强度](docs/model-discovery.md)。
 
 经常使用时可以全局安装：
 
@@ -94,50 +96,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 +132,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