@bryanhu/codexly 0.26.1 → 0.28.0

package/CHANGELOG.md

@@ -4,6 +4,41 @@
 
 ## [Unreleased]
 
+## [0.28.0] - 2026-09-28
+
+### 新增
+
+- CLI 支持 `codexly <command> --help` 查看命令专属帮助，并支持 `codexly --version` 查看安装版本。
+- 在 Web 与桌面工作台展示文件编辑耗时，并在操作完成后保留耗时汇总。
+
+### 优化
+
+- 为两端应用出站请求统一设置 User-Agent，覆盖更新检查、资源下载与自定义 Provider 请求。
+- 升级桌面端 Tauri 相关依赖。
+
+### 修复
+
+- 修复自定义 Provider 的不稳定功能警告，以及个性化设置与任务标题生成的配置问题。
+- 修复归档任务搜索防抖后分页回到第一页的问题。
+
+## [0.27.1] - 2026-09-27
+
+### 新增
+
+- 支持从项目侧栏为任务创建并绑定 Git worktree，在独立工作区中继续对话。
+- 在任务检查器中整合文件预览与差异，并展示工具实时耗时及更多任务上下文。
+- 为流式回复添加渐进动画，在时间线折叠展示运行时警告。
+
+### 优化
+
+- 升级内置 Codex CLI 至 `0.157.1`，统一 Web 与桌面端的协议基线、共享 UI 及高频前端逻辑。
+- 搜索结果达到上限时停止目录扫描，缩小历史搜索分页的并发验证规模。
+
+### 修复
+
+- 修复排队消息编辑时草稿重复追加、待提交消息反馈延迟，以及提交失败后草稿丢失的问题。
+- 修复 Git worktree 路径校验、全局更新使用的 npm 路径与安装前缀，以及检查器标签后台刷新的问题。
+
 ## [0.26.1] - 2026-09-25
 
 ### 新增
@@ -437,7 +472,9 @@
 - 拆分全栈测试套件并限制 Vitest 并发，提升跨平台门禁稳定性；GitHub Release 改为严格提取对应版本的完整更新日志。
 - 将最低 Node.js 版本调整为 `22.14.0`，同步 CLI、CI、发布环境和使用文档。
 
-[Unreleased]: https://github.com/BryanHoo/Codexly/compare/v0.26.1...HEAD
+[Unreleased]: https://github.com/BryanHoo/Codexly/compare/v0.28.0...HEAD
+[0.28.0]: https://github.com/BryanHoo/Codexly/releases/tag/v0.28.0
+[0.27.1]: https://github.com/BryanHoo/Codexly/releases/tag/v0.27.1
 [0.26.1]: https://github.com/BryanHoo/Codexly/releases/tag/v0.26.1
 [0.11.2]: https://github.com/BryanHoo/Codexly/releases/tag/v0.11.2
 [0.11.1]: https://github.com/BryanHoo/Codexly/releases/tag/v0.11.1

package/README.md

@@ -5,63 +5,48 @@
 <h1 align="center">Codexly</h1>
 
 <p align="center">
-  <img src="https://img.shields.io/badge/Node.js-22-339933" alt="Node.js" />
-  <img src="https://img.shields.io/badge/React-19-149eca" alt="React" />
-  <img src="https://img.shields.io/badge/TypeScript-6.0-3178c6" alt="TypeScript" />
-  <img src="https://img.shields.io/badge/Vite-8-646cff" alt="Vite" />
-  <img src="https://img.shields.io/badge/Fastify-5-000000" alt="Fastify" />
-  <img src="https://img.shields.io/badge/OpenAI_Codex-0.156.0-412991" alt="OpenAI Codex" />
-  <a href="./LICENSE">
-    <img src="https://img.shields.io/badge/License-MIT-0f766e" alt="MIT" />
-  </a>
+  A local AI coding workspace for desktop and browser.
 </p>
 
-<p align="center">
-  A local AI coding workspace for using Codex in a browser.
-</p>
-
-The independent Codexly desktop app lives in [`desktop/`](desktop/README.en.md). Both platforms are built from this repository and shipped by one release workflow; see [releasing](docs/releasing.md).
+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.
 
 <p align="center">
-  <a href="#features">Features</a>
+  <a href="#get-codexly">Get Codexly</a>
   ·
-  <a href="#quick-start">Quick Start</a>
+  <a href="#features">Features</a>
   ·
   <a href="./README.zh-CN.md">简体中文</a>
   ·
   <a href="./LICENSE">License</a>
 </p>
 
-## Preview
+## Get Codexly
+
+| Edition | Best for                                                                                             | Get started                                                                                                                                                         |
+| ------- | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 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. The packages are not OS code-signed; review the [installation instructions](desktop/docs/installation.en.md) before opening a download. The desktop app installs and verifies its own private Codex runtime on first launch.
+
+## Web Preview
 
 ![Codexly preview](docs/images/codexly-preview.png)
 
 ## Features
 
-- Run project or temporary Codex tasks and follow responses, commands, and file changes in real time
-- Review persistent runtime warnings and expand their full context in the task inspector
-- Keep follow-up work in a persistent task queue, and edit queued messages and attachments before they run
-- Track active work on a task board, maintain project to-dos, and schedule persistent one-time or recurring tasks
-- Attach files and images from the current device or deployment host, reference project files with `@`, answer MCP input requests, and ask or dismiss asynchronous questions while a task runs
-- Choose the model, reasoning effort, Fast mode, approval behavior, and file access level for each task
-- Manage installed Skills, official Plugins, MCP servers, and compatible third-party Skills from ClawHub in one extension center
-- Organize ordered multi-root projects, archive project or temporary tasks, and permanently delete tasks when needed
-- Search tasks, conversation history, and project files globally, then jump to a matching message or preview a file
-- View Mermaid diagrams in AI responses
-- Inspect, preview, rename, and delete project files; review diffs; manage branches and worktrees; and commit or push changes
-- Fork a task from an AI response and continue it in a new Git worktree
-- Add animated workspace pets with separate task activity bubbles and custom PNG or WebP sprite manifests
-- Manage a collection of custom workspace backgrounds, or use Bing daily images, with automatic foreground colors, overlay opacity, and blur
-- Access the workspace and download task files from another device on a trusted local network
+- 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.
+- Choose a model, reasoning effort, Fast mode, approval policy, and file access level for each task.
+- Search tasks, message history, and project files; inspect changes, work with branches and worktrees, and commit or push selected files.
+- Manage Skills, plugins, MCP services, projects, archived tasks, notifications, and scheduled work.
 
-## Requirements
+**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. See the [desktop guide](desktop/README.en.md) for its full feature set and update behavior.
 
-- Node.js >=22.14.0
-- Chrome/Chromium 116+, Firefox 124+, or Safari 17.4+
+**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.157.1` through `@openai/codex`; external binaries supplied through `--codex-bin <path>` or `CODEXLY_CODEX_BIN` must satisfy `>=0.157.1,<0.158.0`.
 
-Codexly includes Codex CLI `0.156.0` through `@openai/codex`; a separate installation is not required. External binaries supplied through `--codex-bin <path>` or `CODEXLY_CODEX_BIN` must satisfy `>=0.156.0,<0.157.0`.
+## Start the Web Edition
 
-## Quick Start
+Requires Node.js >=24.0.0 and Chrome/Chromium 116+, Firefox 124+, or Safari 17.4+.
 
 Run the latest version without installing it:
 
@@ -71,6 +56,8 @@ npx --package @bryanhu/codexly@latest codexly start
 
 Codexly opens the browser automatically. If it does not, use the address printed in the terminal; the default is `http://127.0.0.1:3210`. Keep the terminal running and press `Ctrl+C` to stop.
 
+Run `codexly --version` to check the installed version, or `codexly <command> --help` for command-specific options.
+
 Only one Codexly instance can use a data directory. The instance lock is released automatically on exit or crash. Use different `--codex-home <directory>` values for independent instances.
 
 On first launch, sign in with ChatGPT or configure an OpenAI-compatible service that supports the Responses API and `GET /models`.
@@ -126,7 +113,7 @@ Docker can only access host paths shared with the Docker engine. On Windows, set
 
 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.
 
-## Usage
+## 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.
 
@@ -134,7 +121,7 @@ Task controls set the model, reasoning, Fast mode, approval, and file access beh
 
 Scheduled tasks with an unknown outcome pause further runs. Inspect the linked conversation before deleting and recreating the schedule. Tasks marked as finishing cleanup retry cleanup automatically without another launch.
 
-## Local Network Access
+## Web Local Network Access
 
 Start trusted LAN access with:
 
@@ -154,9 +141,9 @@ The terminal prints the LAN address and a random access password. Common options
 
 Quote passwords containing shell-special characters. LAN mode uses unencrypted HTTP, so use it only on a trusted network and never expose it directly to the internet. Restarting Codexly invalidates the password and all sessions.
 
-## Diagnostics and Updates
+## Web Diagnostics and Updates
 
-Run `codexly doctor` when startup, Codex, or local data checks fail. Run `codexly --help` for the current command and option reference.
+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 try the China mirror first for version checks, package downloads, and dependency installation, falling back to the official registry on failure and reusing your npm cache. New releases may appear later while the mirror synchronizes. A global installation can also be updated with:
 
@@ -172,6 +159,7 @@ If an older Linux release was installed into a system directory with `sudo npm i
 - [Contributing guide](CONTRIBUTING.md)
 - [Security policy](SECURITY.md)
 - [Changelog](CHANGELOG.md)
+- [Desktop changelog](desktop/CHANGELOG.md)
 
 ## Community
 

package/README.zh-CN.md

@@ -2,36 +2,31 @@
 
 [English](README.md) | 简体中文
 
-Codexly 是一个在浏览器中使用 Codex 的本地 AI 编程工作台。它按项目组织任务，实时展示 Codex 的执行过程，并提供文件、代码审查和 Git 工具；项目文件系统始终由运行端电脑提供。
+Codexly 是本地 AI 编程工作台，提供桌面应用和 Web 版。它将编程任务、对话、项目文件与 Git 操作集中在一处。桌面版适合在本机持续工作；Web 版在本地运行，可通过浏览器从电脑或可信局域网中的移动设备访问。项目文件和 Codex 运行时始终留在运行 Codexly 的电脑上。
 
-Codexly 桌面客户端位于 [`desktop/`](desktop/README.md)。两端独立开发、独立构建，共用本仓库的版本标签与发布流水线；发布说明见[联合发布指南](docs/releasing.md)。
+## 获取 Codexly
+
+| 版本   | 适用场景                                           | 开始使用                                                                                                                                 |
+| ------ | -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
+| 桌面版 | 原生工作台、集成终端、独立任务窗口、系统通知与托盘 | [下载 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 运行时。
 
 ## 主要功能
 
-- 运行项目任务或临时任务，实时查看回复、命令和文件变更
-- 在任务检查器中查看持久化的运行时警告，并展开完整上下文
-- 使用持久化任务队列安排后续工作，并在执行前编辑排队消息和附件
-- 使用任务看板跟踪进行中的工作、维护项目待办，并创建持久化的一次性或周期定时任务
-- 从当前设备或部署主机添加文件与图片、使用 `@` 引用项目文件、回答 MCP 补充输入请求，并在任务执行期间发起或关闭异步问题
-- 为每个任务选择模型、思考量、快速模式、审批方式和文件访问范围
-- 在扩展中心统一管理已安装 Skills、官方 Plugins、MCP Servers，以及来自 ClawHub 的兼容第三方 Skills
-- 组织有序的多根项目、归档项目或临时任务，并按需永久删除任务
-- 全局搜索任务、历史消息和项目文件，并定位匹配消息或预览文件
-- 在 AI 回复中查看 Mermaid 图表
-- 查看、预览、重命名和删除项目文件，审查差异，管理分支与 worktree，并提交或推送变更
-- 从 AI 回复处分叉任务，在新的 Git worktree 中继续工作
-- 添加工作台宠物动画，用独立气泡区分任务活动，并支持自定义 PNG 或 WebP 精灵图清单
-- 管理自定义工作台背景图片集合，或使用 Bing 每日壁纸，并自动适配前景色、浮层遮罩与背景模糊
-- 从可信局域网中的其他设备访问工作台并下载任务文件
+- 实时查看任务回复、命令、审批、推理摘要和文件变更，查看文件编辑耗时与完成汇总，并用持久化队列安排后续消息。
+- 为任务选择模型、思考量、快速模式、审批策略和文件访问范围。
+- 跨项目搜索任务、历史消息和文件；检查变更、管理分支与 worktree，并选择文件提交或推送。
+- 管理 Skills、插件、MCP 服务、项目、归档任务、通知与定时工作。
 
-## 环境要求
+**桌面版**提供原生项目终端、全局快捷键、独立任务窗口、托盘集成和应用私有 Codex 安装。支持 Windows、Ubuntu 和 macOS；完整功能与更新方式见[桌面版指南](desktop/README.md)。
 
-- Node.js >=22.14.0
-- Chrome/Chromium 116+、Firefox 124+ 或 Safari 17.4+
+**Web 版**在本机运行服务并由浏览器访问，支持手机等设备从可信局域网接入、Docker 部署、任务看板、Mermaid 图表和自定义工作台背景。Web 版通过 `@openai/codex` 自带 Codex CLI `0.157.1`；使用 `--codex-bin <path>` 或 `CODEXLY_CODEX_BIN` 指定外部版本时，版本必须满足 `>=0.157.1,<0.158.0`。
 
-Codexly 通过 `@openai/codex` 自带 Codex CLI `0.156.0`，无需单独安装。通过 `--codex-bin <path>` 或 `CODEXLY_CODEX_BIN` 指定的外部版本必须满足 `>=0.156.0,<0.157.0`。
+## 启动 Web 版
 
-## 快速开始
+需要 Node.js >=24.0.0，以及 Chrome/Chromium 116+、Firefox 124+ 或 Safari 17.4+。
 
 无需安装，直接运行最新版本：
 
@@ -41,6 +36,8 @@ npx --package @bryanhu/codexly@latest codexly start
 
 Codexly 会自动打开浏览器。若未打开，请访问终端输出的地址；默认地址为 `http://127.0.0.1:3210`。使用期间需保持终端运行，按 `Ctrl+C` 停止。
 
+运行 `codexly --version` 查看安装版本，或使用 `codexly <command> --help` 查看命令专属选项。
+
 同一数据目录只能运行一个 Codexly 实例，重复启动会被拒绝；进程退出或崩溃后自动释放锁。需要独立实例时使用不同的 `--codex-home <目录>`。
 
 首次启动时，使用 ChatGPT 登录，或配置兼容 Responses API 和 `GET /models` 的 OpenAI-compatible 服务。
@@ -96,7 +93,7 @@ Docker 只能访问 Docker Engine 已共享的宿主路径。Windows 需将 `COD
 
 镜像入口支持全部 CLI 参数，编排平台可按需覆盖 `command`。工作区、多磁盘、Codex Home、更新、备份和故障排查参见[完整 Docker Compose 部署指南](docs/docker-deployment.md)。开发仓库可运行 `pnpm docker:build && pnpm docker:test` 构建并冒烟测试本地镜像。
 
-## 使用方式
+## 使用 Web 版
 
 不依赖项目时，直接选择“新建任务”。处理仓库时，先添加一个或多个运行端目录作为有序的项目根，再创建任务，并按需附加文件、图片、项目引用或 Skills 后提交需求。归档的任务可以从项目任务列表中恢复或永久删除。
 
@@ -104,7 +101,7 @@ Docker 只能访问 Docker Engine 已共享的宿主路径。Windows 需将 `COD
 
 定时任务显示“结果未知”时会暂停后续运行，请先查看关联对话；确认后可删除该计划并重新创建。“已启动，正在收尾”会自动重试清理，无需再次运行。
 
-## 局域网访问
+## Web 局域网访问
 
 在可信局域网中启动：
 
@@ -124,9 +121,9 @@ codexly start --lan
 
 密码含 Shell 特殊字符时请使用引号。局域网模式使用未加密 HTTP，只能用于可信网络，禁止直接暴露到互联网。重启 Codexly 会使密码和全部会话失效。
 
-## 诊断与更新
+## Web 诊断与更新
 
-启动、Codex 或本地数据检查失败时运行 `codexly doctor`。使用 `codexly --help` 查看当前命令和选项。
+启动、Codex 或本地数据检查失败时运行 `codexly doctor`。使用 `codexly --help` 查看完整命令，`codexly start --help` 或 `codexly doctor --help` 查看对应选项，`codexly --version` 查看版本。
 
 交互式启动和“设置 > 关于”会检查新版本。内置更新的版本查询、包下载和依赖安装优先使用国内镜像，失败后回退官方源；下载和安装复用用户的 npm 缓存。镜像同步期间可能稍晚显示新版本。全局安装也可以通过以下命令更新：
 
@@ -142,6 +139,7 @@ npm install --global @bryanhu/codexly@latest --registry=https://registry.npmmirr
 - [贡献指南](CONTRIBUTING.md)
 - [安全策略](SECURITY.md)
 - [版本记录](CHANGELOG.md)
+- [桌面版更新日志](desktop/CHANGELOG.md)
 
 ## 许可证