@bryanhu/codexly 0.42.0 → 0.43.0

package/dist/web/index.html

@@ -7,7 +7,7 @@
     <meta name="theme-color" content="#181818" media="(prefers-color-scheme: dark)" />
     <link rel="icon" href="/favicon.svg?v=4" type="image/svg+xml" />
     <title>Codexly</title>
-    <script type="module" crossorigin src="/assets/index-BWaH5L2Y.js"></script>
+    <script type="module" crossorigin src="/assets/index-D3weiyhT.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/rolldown-runtime-B0Z9INg1.js">
     <link rel="modulepreload" crossorigin href="/assets/initial-deps-CqwWvUnY.js">
     <link rel="modulepreload" crossorigin href="/assets/react-runtime-CMZHB3u8.js">
@@ -16,11 +16,11 @@
     <link rel="modulepreload" crossorigin href="/assets/initial-deps-DgzPJEbl.js">
     <link rel="modulepreload" crossorigin href="/assets/initial-deps-DBOKk1z5.js">
     <link rel="modulepreload" crossorigin href="/assets/initial-deps-cK7Q2EcP.js">
-    <link rel="modulepreload" crossorigin href="/assets/initial-deps-CCdrudAz.js">
+    <link rel="modulepreload" crossorigin href="/assets/initial-deps-CAnleAzJ.js">
     <link rel="modulepreload" crossorigin href="/assets/scheduled-task-floating-ui~index~workbench-shell~document-workspace-tabs~workbench-inspecto~g83lm7j8-ClgveiMa.js">
     <link rel="modulepreload" crossorigin href="/assets/initial-deps-DFOart6r.js">
-    <link rel="modulepreload" crossorigin href="/assets/initial-deps-kUkmh9lq.js">
-    <link rel="modulepreload" crossorigin href="/assets/initial-deps-iKA5xHo-.js">
+    <link rel="modulepreload" crossorigin href="/assets/initial-deps-Cm47ZaH1.js">
+    <link rel="modulepreload" crossorigin href="/assets/initial-deps-B8N7gnPA.js">
     <link rel="stylesheet" crossorigin href="/assets/index-tlTKg_SZ.css">
   </head>
   <body>

package/docs/README.md

@@ -36,7 +36,7 @@ Codexly 支持 Codex 与 Claude，提供桌面应用、电脑 Web 和移动浏
 
 ## 问题排查
 
-Web、移动浏览器和桌面均可在「设置 → 关于」导出诊断材料：Web 下载 JSON，桌面导出 ZIP。Web 服务默认不向终端持续输出运行日志，启动错误仍可在终端查看，按需运行 `codexly doctor`。先确认出错的使用端和智能体，再按[常见问题](faq.md)排查；[Web 诊断](web.md#排查问题)与[桌面诊断日志](../desktop/docs/diagnostics.md)提供进一步说明。
+Web、移动浏览器和桌面均可在「设置 → 关于」导出整合诊断 ZIP，默认纳入可用的 Codex 原生诊断；原生诊断不可用时仍保留应用诊断，并在清单中说明。Web 服务默认不向终端持续输出运行日志，启动错误仍可在终端查看，按需运行 `codexly doctor`。先确认出错的使用端和智能体，再按[常见问题](faq.md)排查；[Web 诊断](web.md#排查问题)与[诊断日志指南](../desktop/docs/diagnostics.md)提供内容检查和进一步分析方法。
 
 [问题反馈](https://github.com/BryanHoo/Codexly/issues) · [安全漏洞私密报告](../SECURITY.md) · [更新日志](../CHANGELOG.md)
 
@@ -46,6 +46,7 @@ Web、移动浏览器和桌面均可在「设置 → 关于」导出诊断材料
 - [桌面源码开发](../desktop/docs/development.md) · [English](../desktop/docs/development.en.md)。
 - [三端与双引擎能力参考](../desktop/docs/codexly-capability-matrix.md)。
 - [桌面运行时分发](../desktop/docs/provider-runtime-management.md)。
+- [Codex 0.164.0 升级评估](codex-0.164.0-upgrade.md)：官方源码差异、两端适配与验证边界。
 - [联合发布](releasing.md)。
 
 `codex-*-upgrade.md`、带日期的测试报告、架构调研及迁移记录保留当时的背景和验证结果，不作为当前安装或能力说明。当前行为以使用指南、能力参考与对应版本的更新日志为准。

package/docs/conversation-performance.md

@@ -26,6 +26,10 @@ The cache retains at most 12 inactive task snapshots within an estimated 48 MiB
 
 Both editions continue committing received task events while the page or WebView is hidden, preventing background state from stalling on animation-frame scheduling. Idle tasks do not retain periodic event-flush timers.
 
+Codex 0.164 及以上版本使用线程级 `thread_unload_delay_secs`：普通会话在没有订阅且空闲后保留 300 秒热缓存，标题与提交说明生成等短命线程在退订且空闲后立即卸载（0 秒）。两端沿用既有退订流程，运行回合、正在提交或排队的消息、后台终端仍会阻止退订；重新打开任务会恢复订阅，已保存的会话历史保留在磁盘。该策略不改写用户的全局配置，也不增加应用轮询或周期定时器。
+
+Codex 0.164 and later use per-thread `thread_unload_delay_secs`: ordinary conversations keep a 300-second warm cache once unsubscribed and idle, while short-lived title and commit-message helpers unload immediately after becoming unsubscribed and idle (0 seconds). Both editions retain the existing unsubscribe guards for running turns, in-flight or queued submissions, and background terminals. Reopening a task restores its subscription; saved conversation history remains on disk. This policy does not rewrite global user configuration or add application polling or periodic timers.
+
 两端仅在助手的完整问题消息到达时记录待回答提醒并更新任务活动，复用现有通知偏好与事件连接；普通消息与流式 Token 不触发通知或额外轮询。待回答状态允许任务继续运行，进入任务只确认通知已读，回答成功或显式关闭后才解除对应问题的等待；其他问题与审批继续保留。
 
 Both editions record an input notification and update task activity when a complete assistant question arrives, reusing existing notification preferences and event connections. Ordinary messages and streamed tokens add no notifications or polling. Tasks can keep running while awaiting answers. Opening a task marks its notifications read; successfully answering or explicitly dismissing a question clears that question's waiting state while preserving other questions and approvals.

package/docs/faq.md

@@ -56,8 +56,16 @@ Windows 便携版必须关闭应用并用新版 ZIP 的完整解压目录替换
 
 移除桌面应用或 npm 包不会自动删除项目，也不会清空共享的 `~/.codexly`。删除应用数据会影响同机其他 Codexly 使用端。清理前先备份并停用 Web 登录自启动；系统日志与缓存位置见[桌面安装指南](../desktop/docs/installation.md)。
 
+## Codex 启动失败，如何检查配置？
+
+在终端运行 `codexly doctor`，也可以指定 `--codex-bin /path/to/codex` 和 `--codex-home /path/to/home`。检查顺序为 Node.js、Codex 版本、Codex 配置、应用 SQLite；配置失败会提前停止，并显示上游返回的错误原因、文件位置和详情。文件行列沿用 Codex 返回的从 1 开始的位置，可直接在编辑器中定位。
+
+配置检查使用 Codex 0.164.0 的 `app-server --print-startup-config`，成功时显示版本和配置要求；可定位 TOML 错误及组织策略加载或认证问题。它不初始化线程存储、执行环境或插件，但加载组织策略可能访问网络。单次检查最多等待 10 秒，每条输出管道最多接收 1 MiB；通过检查不代表模型调用、数据库或插件连接一定成功。
+
+正常启动不额外预检。Web 和桌面仅在 Codex 握手失败、清理失败进程后补充一次诊断：有结构化配置错误时附加定位，其他情况保留原始启动原因；桌面详细信息进入已有诊断日志，可在「设置 → 关于」导出。按提示修正配置或重新登录后重试；诊断不会自动改写配置、注销账号或删除数据。`doctor` 的后续 SQLite 检查仍会打开应用数据库，`--codex-home` 不改变其 `~/.codexly` 存储位置。
+
 ## 怎样反馈问题？
 
-请提供应用版本、系统及架构、桌面 / 电脑 Web / 移动浏览器、Codex / Claude、复现步骤与脱敏错误。两端均可在「设置 → 关于」导出诊断材料：Web 与移动浏览器下载 JSON，桌面导出 ZIP。Web 终端只保留启动提示和错误，不再持续输出运行日志；必要时运行 `codexly doctor`。详见 [Web 诊断](web.md#排查问题)和[桌面诊断指南](../desktop/docs/diagnostics.md)。原始诊断文件留在本地，仅提交必要的脱敏片段。
+请提供应用版本、系统及架构、桌面 / 电脑 Web / 移动浏览器、Codex / Claude、复现步骤与脱敏错误。各端均可在「设置 → 关于」导出整合诊断 ZIP，默认尝试收集 Codex 原生诊断，不会自动上传；原生不可用时仍导出应用诊断，并在 `manifest.json` 中注明。Web 终端只保留启动提示和错误，不再持续输出运行日志；必要时运行 `codexly doctor`。详见 [Web 诊断](web.md#排查问题)和[诊断指南](../desktop/docs/diagnostics.md)。原生诊断保留上游内容，不适用应用日志的字段脱敏规则；分享前检查整个 ZIP，仅提交必要的脱敏片段。
 
 普通问题提交到 [Issues](https://github.com/BryanHoo/Codexly/issues)；漏洞请按[安全策略](../SECURITY.md)私密报告。

package/docs/global-search.md

@@ -35,7 +35,7 @@ Claude 官方文档公开会话列举与消息读取，未给出与 Codex 等价
 
 ## 官方依据
 
-- [Codex App Server](https://developers.openai.com/codex/app-server)：结合固定的 0.163.0 协议与 `.local/project-paths.json` 指向的官方本地源码验证接口。
+- [Codex App Server](https://developers.openai.com/codex/app-server)：结合固定的 0.164.0 协议与 `.local/project-paths.json` 指向的官方本地源码验证接口。
 - [Claude 会话文档](https://code.claude.com/docs/en/agent-sdk/sessions)：会话列举、消息读取与持久化；本项目 SDK 固定为 0.3.300。
 - [node-ignore](https://github.com/kaelzhang/node-ignore)：使用 Git ignore 语义处理项目忽略规则。
 - [TanStack Query 请求取消](https://tanstack.com/query/latest/docs/framework/react/guides/query-cancellation)：查询函数消费 `AbortSignal`。

package/docs/usage.en.md

@@ -6,11 +6,15 @@ This guide covers desktop, computer browsers, and mobile browsers. Files, Git op
 
 ## Projects and tasks
 
+Open a sidebar task’s **More actions → Export conversation** to save JSON with task information, all historical turns, messages, execution items, and attachment metadata. Earlier history is fetched automatically. Web and mobile browsers download to the current device; the desktop app opens a native save dialog. Attachment binaries are excluded, and exports are limited to 64 MiB. Running tasks include content available while reading; the file is intended for inspection and processing and cannot be imported to restore a conversation.
+
 Add a disk folder as a project, or create a temporary task without project context. Git tools require a repository at the project root; ordinary subdirectories do not borrow a parent repository.
 
 Pin, archive, restore, or permanently delete tasks. Sidebar shortcuts help you move between projects and show unread completions, pending approvals, and running tasks. Use the task board to review work centrally. Search can find projects, tasks, messages, and files; some entry points depend on the enabled engine.
 
-Switch the sidebar between projects and a timeline grouped by Today, Yesterday, the last seven days, and Earlier. Groups can be collapsed. The task board and extensions are in the sidebar header, with schedules in the icon area; settings, notifications, and help are at the bottom. The notification center separates unread and read alerts and supports marking all as read. Opening a task marks its notifications as read. Asynchronous questions notify you and mark the task as awaiting an answer; answering or closing the question restores its status.
+In the archive list, choose all archived tasks, tasks last updated more than 1, 3, 6, or 12 months ago, or tasks updated before a custom date. The cutoff uses midnight in your device's local calendar and excludes the cutoff date itself; the confirmation shows the exact date. Cleanup covers all archived tasks regardless of the current search. Check the scope and export conversations as needed before permanent deletion.
+
+Switch the sidebar between projects and a timeline grouped by Today, Yesterday, the last seven days, and Earlier. Groups can be collapsed. The task board and extensions are in the sidebar header, with schedules in the icon area; settings, notifications, and help are at the bottom. The notification center separates unread and read alerts and supports marking all as read, or deleting all read notifications from the Read tab. Deleting notifications keeps the tasks. Opening a task marks its notifications as read. Asynchronous questions notify you and mark the task as awaiting an answer; answering or closing the question restores its status.
 
 ## Conversations and queues
 

package/docs/usage.md

@@ -10,7 +10,11 @@
 
 侧栏可置顶任务、查看运行状态、归档历史，并从归档列表恢复或永久删除任务。「已固定」和「运行中」快捷区方便跨项目切换；未查看的完成任务、待审批和运行状态会显示提醒。任务看板提供集中查看任务的入口。
 
-侧栏支持项目与时间线视图切换；时间线按今天、昨天、近 7 天与更早分组，可折叠分组。任务看板与扩展位于侧栏头部，定时任务位于图标区；底部提供设置、通知与帮助入口。通知中心区分未读和已读，可全部标为已读；进入任务时自动将该任务的通知标为已读。异步问题到来时通知并标记待回答，回答或关闭后恢复任务状态。
+在归档列表选择清理范围，可删除全部归档任务、最后更新于 1/3/6/12 个月前的任务，或自定义日期之前的任务。截止点按当前设备本地日期零点计算，不包含截止日期当天；确认窗口会显示具体日期。清理覆盖全部归档任务，不受当前搜索结果限制，永久删除前请核对范围并按需导出对话。
+
+打开侧栏任务的「更多操作 → 导出对话记录」，可保存 JSON 文件，包含任务信息、全部历史回合、消息、执行条目和附件元数据；无需先在界面加载更早历史。Web 与移动浏览器下载到当前设备，桌面端弹出原生保存窗口。附件二进制不包含在文件中，单次导出上限为 64 MiB；运行中的任务仅导出读取时已收到的内容。此文件用于查阅与处理，不提供导入恢复。
+
+侧栏支持项目与时间线视图切换；时间线按今天、昨天、近 7 天与更早分组，可折叠分组。任务看板与扩展位于侧栏头部，定时任务位于图标区；底部提供设置、通知与帮助入口。通知中心区分未读和已读，可全部标为已读，也可在已读页删除全部已读通知；删除通知不会删除任务。进入任务时自动将该任务的通知标为已读。异步问题到来时通知并标记待回答，回答或关闭后恢复任务状态。
 
 使用搜索查找项目、任务、历史消息和文件；部分搜索入口依赖已启用引擎的能力，详见[搜索参考](global-search.md)。
 

package/docs/web.en.md

@@ -60,7 +60,7 @@ After global installation, use these with `codexly start`. For temporary use, pr
 
 Quote shell-special characters in passwords. Run `codexly start --help` for complete help.
 
-The bundled Codex CLI is `0.163.0`. External executables supplied through `--codex-bin` or `CODEXLY_CODEX_BIN` must satisfy `>=0.163.0,<0.164.0`. Claude uses the package's pinned SDK dependency and does not require an external Codex executable.
+The bundled Codex CLI is `0.164.0`. External executables supplied through `--codex-bin` or `CODEXLY_CODEX_BIN` must satisfy `>=0.164.0,<0.165.0`. Claude uses the package's pinned SDK dependency and does not require an external Codex executable.
 
 Multiple instances skip occupied ports. The launch directory does not determine application storage. Temporary tasks default to the user's home directory or the first explicit `--workspace` root. Separate `--codex-home` directories isolate Codex data only, not the shared Codexly application directory.
 
@@ -112,7 +112,9 @@ Skip the first command if startup was never configured. Uninstalling preserves p
 
 ## Troubleshooting
 
-The server no longer continuously writes runtime logs to the terminal by default. In a computer or mobile browser, export diagnostics from **Settings → About** to download a JSON file with app and engine versions, browser information, recent browser errors, and server logs. These buffers are held in memory: restarting the server or refreshing the browser clears its respective buffer, so export soon after a problem. Server logs retain at most 2 MiB / 2,000 entries; browser errors retain at most 100 entries. Sensitive fields are filtered, but review the file before sharing.
+The server no longer continuously writes runtime logs to the terminal by default. In a computer or mobile browser, export diagnostics from **Settings → About** to download one integrated ZIP. Its `application.json` contains app and engine versions, browser information, recent browser errors, and server logs. Available native Codex diagnostics are included as `codex/diagnostics.zip` through `feedback/save` by default, without uploading feedback. App diagnostics remain available if native collection fails; `manifest.json` reports `codexDiagnostics.status` as `included` or `unavailable`. Native diagnostics do not use the app log field filters, so review the entire ZIP before sharing.
+
+App log buffers are held in memory: restarting the server or refreshing the browser clears its respective buffer, so export soon after a problem. Server logs retain at most 2 MiB / 2,000 entries; browser errors retain at most 100 entries. Downloads are bound to the current paired session, can be claimed once, and expire after five minutes. Export again after expiration or failure. See the [diagnostic guide (中文)](../desktop/docs/diagnostics.md) for contents and analysis.
 
 Check terminal errors, the actual URL and port, Node.js version, and network first:
 

package/docs/web.md

@@ -60,7 +60,7 @@ npx --package @bryanhu/codexly@latest codexly start --lan
 
 含 Shell 特殊字符的密码需要正确加引号。用 `codexly start --help` 查看完整帮助。
 
-当前内置 Codex CLI `0.163.0`；`--codex-bin` 或 `CODEXLY_CODEX_BIN` 指定的外部版本须满足 `>=0.163.0,<0.164.0`。Claude 使用 npm 包固定的 SDK 依赖，无需配置外部 Codex 才能使用。
+当前内置 Codex CLI `0.164.0`；`--codex-bin` 或 `CODEXLY_CODEX_BIN` 指定的外部版本须满足 `>=0.164.0,<0.165.0`。Claude 使用 npm 包固定的 SDK 依赖，无需配置外部 Codex 才能使用。
 
 多实例启动会跳过占用端口。启动目录不决定应用数据目录；临时任务默认使用用户主目录，或第一个显式 `--workspace` 根目录。`--codex-home` 只隔离 Codex 自身的数据，不隔离共享的 Codexly 应用目录。
 
@@ -112,7 +112,9 @@ npm uninstall --global @bryanhu/codexly
 
 ## 排查问题
 
-服务默认不向终端持续输出运行日志。在电脑或手机浏览器的「设置 → 关于」选择导出诊断日志，下载包含应用和引擎版本、浏览器环境、最近浏览器异常及服务端日志的 JSON。日志保存在内存中，服务端重启或浏览器刷新后分别清空，建议出现问题后尽快导出。服务端最多保留 2 MiB / 2,000 条日志，浏览器最多保留 100 条异常；导出会过滤敏感字段，但分享前仍需检查内容。
+服务默认不向终端持续输出运行日志。在电脑或手机浏览器的「设置 → 关于」选择导出诊断日志，直接下载一个整合 ZIP。其中 `application.json` 包含应用和引擎版本、浏览器环境、最近浏览器异常及服务端日志；默认通过 `feedback/save` 将可用的 Codex 原生诊断纳入 `codex/diagnostics.zip`，不会自动上传。原生不可用时仍保留应用诊断，`manifest.json` 的 `codexDiagnostics.status` 会标明 `included` 或 `unavailable`。原生诊断不适用应用日志的字段脱敏规则，分享前请检查整个 ZIP。
+
+应用日志保存在内存中，服务端重启或浏览器刷新后分别清空，建议出现问题后尽快导出。服务端最多保留 2 MiB / 2,000 条日志，浏览器最多保留 100 条异常。下载标识绑定当前配对会话，仅可领取一次，5 分钟后失效；过期或失败时重新导出。内容与排查方法见[诊断指南](../desktop/docs/diagnostics.md)。
 
 查看启动终端错误，确认实际地址、端口、Node.js 版本和网络，再运行：
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bryanhu/codexly",
-  "version": "0.42.0",
+  "version": "0.43.0",
   "description": "支持 Codex 与 Claude 的本地 AI 编程工作台，覆盖桌面、Web 与移动浏览器",
   "type": "module",
   "author": "BryanHu",
@@ -63,7 +63,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@openai/codex": "0.163.0",
+    "@openai/codex": "0.164.0",
     "better-sqlite3": "13.0.3",
     "@anthropic-ai/claude-agent-sdk": "0.3.300"
   },