@hjd-hitsz/claudex-web 4.1.5 → 4.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.env.example +2 -0
- package/CHANGELOG.md +57 -0
- package/README.md +16 -4
- package/bin/auth.mjs +86 -0
- package/bin/claudex-web.mjs +20 -0
- package/bin/p2p.mjs +134 -0
- package/build-info.json +4 -4
- package/client/dist/app.js +154 -122
- package/client/dist/code-highlight-style.js +23 -45
- package/client/dist/document-editor.js +54 -54
- package/client/dist/file-panel.js +5 -5
- package/client/dist/notification-worker.js +2 -1
- package/client/dist/p2p-sw.js +162 -0
- package/client/dist/style.css +1 -1
- package/client/dist/terminal-panel.js +11 -11
- package/docs/architecture/backends.md +11 -2
- package/docs/architecture/behavior.md +173 -59
- package/docs/architecture.md +36 -339
- package/docs/background-tasks.md +32 -26
- package/docs/deployment.md +53 -12
- package/docs/development.md +121 -149
- package/docs/images/desktop-dark.png +0 -0
- package/docs/images/desktop-light.png +0 -0
- package/docs/images/mobile-sidebar.png +0 -0
- package/docs/images/mobile.png +0 -0
- package/docs/releases/v4.2.0.md +15 -0
- package/docs/releases/v4.2.1.md +15 -0
- package/docs/versioning.md +15 -5
- package/package.json +9 -2
- package/packages/background-terminal/LICENSE +674 -0
- package/packages/background-terminal/README.md +17 -0
- package/packages/background-terminal/background-jobs.mjs +457 -0
- package/packages/background-terminal/background-mcp.mjs +79 -0
- package/packages/background-terminal/background-protocol.mjs +90 -0
- package/packages/background-terminal/cli.mjs +14 -0
- package/packages/background-terminal/client.mjs +61 -0
- package/packages/background-terminal/codex.mjs +88 -0
- package/packages/background-terminal/delivery.mjs +194 -0
- package/packages/background-terminal/log.mjs +25 -0
- package/packages/background-terminal/native-watches.mjs +160 -0
- package/packages/background-terminal/package.json +15 -0
- package/packages/background-terminal/service.mjs +126 -0
- package/packages/translation-engine/package.json +1 -1
- package/server/src/application.mjs +82 -10
- package/server/src/auth-http.mjs +187 -0
- package/server/src/auth-login.mjs +144 -0
- package/server/src/auth-totp.mjs +233 -0
- package/server/src/auth.mjs +169 -220
- package/server/src/backends/claude/background-tasks.mjs +88 -35
- package/server/src/backends/claude/messages.mjs +1 -1
- package/server/src/backends/claude/worker-client.mjs +47 -35
- package/server/src/backends/claude/worker-lines.mjs +17 -0
- package/server/src/backends/claude/worker-server.mjs +49 -69
- package/server/src/backends/codex/adapter.mjs +57 -7
- package/server/src/backends/codex/background-service.mjs +85 -0
- package/server/src/backends/codex/background-task-views.mjs +87 -0
- package/server/src/backends/codex/background-terminals.mjs +103 -0
- package/server/src/backends/codex/events.mjs +25 -1
- package/server/src/backends/codex/methods.mjs +1 -0
- package/server/src/backends/codex/native-background-handoff.mjs +72 -0
- package/server/src/backends/codex/requests.mjs +67 -38
- package/server/src/backends/codex/streaming-messages.mjs +50 -0
- package/server/src/backends/codex/subscriptions.mjs +34 -4
- package/server/src/backends/configuration.mjs +8 -0
- package/server/src/backends/manager.mjs +34 -32
- package/server/src/backends/storage.mjs +3 -14
- package/server/src/config.mjs +13 -0
- package/server/src/http/business.mjs +21 -0
- package/server/src/http/router.mjs +12 -25
- package/server/src/p2p/http.mjs +136 -0
- package/server/src/p2p/peers.mjs +132 -0
- package/server/src/p2p/service.mjs +229 -0
- package/server/src/p2p/storage.mjs +45 -0
- package/server/src/p2p/tunnel.mjs +95 -0
- package/server/src/p2p-http.mjs +149 -0
- package/server/src/p2p-peer.mjs +135 -0
- package/server/src/private-file.mjs +14 -0
- package/server/src/summary-translation.mjs +1 -1
- package/server/src/thread-folders.mjs +3 -13
- package/server/src/translation-service.mjs +3 -8
- package/shared/codex-preferences.mjs +9 -0
- package/shared/p2p-wire.mjs +157 -0
|
Binary file
|
|
Binary file
|
|
Binary file
|
package/docs/images/mobile.png
CHANGED
|
Binary file
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
# Claudex Web v4.2.0
|
|
2
|
+
|
|
3
|
+
## 新增重要功能
|
|
4
|
+
|
|
5
|
+
- **Codex 后台终端**。在「设置 → 其他设置」开启扩展后,耗时命令可以在当前轮次结束后继续运行,任务完成时自动唤醒原对话。输入框旁的任务计数可打开任务列表,查看实时输出或单独停止任务。Codex 任务支持下载完整日志,`/stop` 可管理当前对话的原生终端和扩展任务。自动续跑失败或没有返回正文时,原对话仍会显示任务结果和日志入口。([f71d8f3](https://github.com/hjd-hitsz/claudex-web/commit/f71d8f39181025bda95f134bb2b25aea6df8de94))
|
|
6
|
+
- **P2P 远程直连**。在「设置 → 连接与登录」开启 P2P 后,可生成长期授权链接,从局域网外用浏览器通过加密的 WebRTC 直连访问聊天、文件和终端。刷新、重连或在同一浏览器重新打开链接时可恢复有效登录。撤销链接会断开相关连接并使对应的登录会话失效。([b40f98a](https://github.com/hjd-hitsz/claudex-web/commit/b40f98a267f090fe7bfdda750e5b30f632b15cb1))
|
|
7
|
+
- **双重验证登录(2FA)**。从其他设备、代理入口或 P2P 登录时,默认在系统密码后验证六位动态码。同一实例的多位使用者可以分别绑定具名验证器,撤销某个验证器时会同时撤销通过它登录的会话。服务电脑上的浏览器直接访问本机 HTTPS 端口时可凭系统密码登录。缺少新版认证凭据的旧网页会话需要重新登录。([08cdb45](https://github.com/hjd-hitsz/claudex-web/commit/08cdb4576e335147546c6eb100180eebf7bfe5cf)、[a46e5e5](https://github.com/hjd-hitsz/claudex-web/commit/a46e5e5eb119422aace5b6a0488444382b80d5ca))
|
|
8
|
+
|
|
9
|
+
## 其他改进与修复
|
|
10
|
+
|
|
11
|
+
- Codex 目标可以跨轮次持续运行,自动续跑会处理已发送的中途消息。Claude Code 执行服务等待空闲更新时,设置页继续显示实际连接状态,现有对话可以继续使用。([d3a53ec](https://github.com/hjd-hitsz/claudex-web/commit/d3a53ecba1559ec3b6b0001ceb00a60702b680fb)、[d0e89fe](https://github.com/hjd-hitsz/claudex-web/commit/d0e89fed3f8dced94773562c6906f6b5d8d3d85c))
|
|
12
|
+
- 文件面板的 Markdown 预览恢复标题层级和段落间距,代码块的编辑与复制按钮并排显示,宽表格可在预览内横向滚动。不同对话打开同一路径时,各自保留未保存的编辑。([e45f912](https://github.com/hjd-hitsz/claudex-web/commit/e45f912d833e55e2394b6aa2d8fc592c55fcf4d3)、[2590ef4](https://github.com/hjd-hitsz/claudex-web/commit/2590ef4e2ab164ab3ce76f3df9d86e2148d1132e))
|
|
13
|
+
- 流式回复期间,已显示的 Markdown 链接、图片、图表和模型控件按需更新。模型选择器、`/model` 和子代理设置统一隐藏已设为不可见的模型。([2590ef4](https://github.com/hjd-hitsz/claudex-web/commit/2590ef4e2ab164ab3ce76f3df9d86e2148d1132e))
|
|
14
|
+
- 弹窗关闭后焦点回到触发入口,对话菜单支持按 Esc 关闭,桌面侧栏和移动端抽屉分别记住开合状态。窄屏放大时,更新与重启按钮保留完整文字,长模型名也能给消息输入留出两行空间。手机上的宽公式、代码块和表格在各自区域内横向滚动。([2590ef4](https://github.com/hjd-hitsz/claudex-web/commit/2590ef4e2ab164ab3ce76f3df9d86e2148d1132e)、[75cc522](https://github.com/hjd-hitsz/claudex-web/commit/75cc522b5d553193a5f327a135948df4f908e142))
|
|
15
|
+
- 「连接与登录」按账号与双重验证、局域网 HTTPS 证书、P2P 远程访问分区显示。「其他设置」的复选项采用一致的行距。([b40f98a](https://github.com/hjd-hitsz/claudex-web/commit/b40f98a267f090fe7bfdda750e5b30f632b15cb1)、[d9f93cc](https://github.com/hjd-hitsz/claudex-web/commit/d9f93cc18e8afeef25776c94e3cdae126a10178a))
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
# Claudex Web v4.2.1
|
|
2
|
+
|
|
3
|
+
- Codex 的「显示的模型」直接按 GPT 代际分行,依次勾选 Astra、Sol、Terra、Luna,缺席型号保留位置并标为不可用。([f09a5cf](https://github.com/hjd-hitsz/claudex-web/commit/f09a5cfc1b42c6ab1104a37602ff090086589f62))
|
|
4
|
+
- 工作目录选择与添加项目使用可点击的层级地址栏,可直接跳到任意上级目录,并可编辑绝对路径。([d33ba8f](https://github.com/hjd-hitsz/claudex-web/commit/d33ba8fdac3f049ea8e06bd875daadba0eef3162))
|
|
5
|
+
- 竖向窗口默认收起左侧栏,可通过顶部按钮展开。([e328ac1](https://github.com/hjd-hitsz/claudex-web/commit/e328ac123766080c0d5e915c5f42edd733154475))
|
|
6
|
+
- 设置分为通用、后端、模型服务商、连接与登录、更新与重启五页。后端启停和配置集中在后端页,供应商独立管理。切页保留未提交的编辑,手机采用顶部两列导航。([b9f62b6](https://github.com/hjd-hitsz/claudex-web/commit/b9f62b651211210b701a285bb48d512361611d7e))
|
|
7
|
+
- 主界面侧栏和设置导航统一采用蓝灰底色,当前对话和当前设置页以左侧蓝线标识。([b9f62b6](https://github.com/hjd-hitsz/claudex-web/commit/b9f62b651211210b701a285bb48d512361611d7e))
|
|
8
|
+
- 统一 Codex 与 Claude Code 标识的实际显示大小,侧栏、对话切换器、顶栏和后端设置使用相同标识。([b9f62b6](https://github.com/hjd-hitsz/claudex-web/commit/b9f62b651211210b701a285bb48d512361611d7e))
|
|
9
|
+
- 切回正在生成的 Codex 对话时立即补齐已接收的流式正文。([3e0e678](https://github.com/hjd-hitsz/claudex-web/commit/3e0e678c16be6cc9fa4a55ad39e502e6de392e8d))
|
|
10
|
+
- 后台终端续跑时的补充指令按提交顺序收入工作过程。([e8dd5ed](https://github.com/hjd-hitsz/claudex-web/commit/e8dd5edc32ff62a827d25b5fc66a6bf0fe2b31c7))
|
|
11
|
+
- 正常宽度的行内公式随正文排版,超宽公式可在窄屏内局部横向滚动。([d7e2cda](https://github.com/hjd-hitsz/claudex-web/commit/d7e2cdacd848e4d04cd409f2e7abf97e630a7991))
|
|
12
|
+
- 侧栏按页显示已归档对话的标题,点击后才读取正文,并补齐不同 Codex 模型供应商下的历史记录。([1267cda](https://github.com/hjd-hitsz/claudex-web/commit/1267cda0b5584f6180566aa49d365314429fc765))
|
|
13
|
+
- 批注原文正常显示 Markdown 和公式。选中聊天、批注原文或 Markdown 文件预览中的内容复制时,会保留 Markdown 格式。([800ded0](https://github.com/hjd-hitsz/claudex-web/commit/800ded02a41a40b9fa515c0b9c4292e161188ff4))
|
|
14
|
+
- 开启 Codex 后台终端时,模型会优先把已知耗时数分钟的下载、构建或测试直接交给后台。后续工作依赖结果时先结束本轮,任务完成后自动继续。([3ed2a9e](https://github.com/hjd-hitsz/claudex-web/commit/3ed2a9e6862e8a12ae29db0d92ca925c2f1f7c5d))
|
|
15
|
+
- 自动补丁发布错过计划触发后,可以在同一发布周期内补跑。([1400d14](https://github.com/hjd-hitsz/claudex-web/commit/1400d14dbb46a50888b2b7ea3287f634633994d5))
|
package/docs/versioning.md
CHANGED
|
@@ -39,7 +39,7 @@ v2.0.0 标签上的干净代码 2.0.0 正式发
|
|
|
39
39
|
发布提交 → 版本标签 → Release
|
|
40
40
|
```
|
|
41
41
|
|
|
42
|
-
`CHANGELOG.md`
|
|
42
|
+
`CHANGELOG.md` 是面向使用者与维护者的持续版本总览。`docs/releases/vX.Y.Z.md` 与远端 Release 正文面向第三方使用者,只列他们新增可用的能力、具体操作改善和可见问题修复。条目使用界面、操作及结果描述变化,同一功能的相关修改合并。独立 Markdown 文档保留版本一级标题,上传正文时去掉该标题。GitHub 页面在自身版本标题下显示变更列表,变更可用二级标题分组。审阅时结合实际 Release 页面检查排版。回归测试、测试覆盖率、内部重构、协议适配、构建工具和发布流程维护等开发工作记入提交记录,Release 仅保留其对使用者的具体影响。
|
|
43
43
|
|
|
44
44
|
安装、环境要求、配置、使用、升级和迁移说明统一维护在 README 或部署文档,测试报告、校验步骤、附件介绍和发布过程维护在开发或版本文档。
|
|
45
45
|
|
|
@@ -70,7 +70,17 @@ git push origin main vX.Y.Z
|
|
|
70
70
|
|
|
71
71
|
发布准备命令会拒绝倒退版本、新版本的重复标签或空的未发布内容。再次传入当前已准备的明确版本时,命令保留包版本、变更记录和已审阅的发布说明;当前版本尚未创建标签时,继续准备更高版本会报错并提示完成当前版本。`npm run version:check` 已纳入日常检查,校验三个包与锁文件;`npm run release:check` 额外校验干净标签、变更日志、发布说明与当前安装链接。发布流程接收稳定的 `vX.Y.Z` 和 `vX.Y.Z-alpha.N`、`vX.Y.Z-beta.N`、`vX.Y.Z-rc.N`,其中 N 为无前导零的非负整数。预发布必须传入完整版本号,例如 `npm run version:prepare -- 4.0.0-beta.1`;后续按 beta.2、beta.3、rc.1、正式 X.Y.Z 递增,每个版本独立检查、打包与交付。GitHub 预发布标记与版本同步,测试版使用 `--latest=false` 保留稳定版 Latest。README 与部署文档中的预发布下载区域独立更新,稳定版本入口保持可用;转正式版时更新对应入口。构建的 `channel: release` 表示干净标签构建,成熟度由包版本的预发布后缀与 GitHub Pre-release 属性表达。
|
|
72
72
|
|
|
73
|
-
|
|
73
|
+
每条用户可见变更在末尾括号内附对应提交及链接。发布重试验证覆盖同版本准备、部分附件上传、正式发布后响应中断及已发布附件保护;GitHub 操作使用模拟发布状态,真实附件在临时 npm prefix 验证安装。
|
|
74
|
+
|
|
75
|
+
## 每两天自动发布 patch
|
|
76
|
+
|
|
77
|
+
`Automatic patch releases` 在每小时第 16 分钟检查,默认分支 `main` 上包含 `CHANGELOG.md` 改动的推送也会触发检查。发布窗口从 2026 年 11 月 22 日 04:16 UTC(北京时间 12:16)起每两天开始一次,每个窗口最多准备一个自动 patch。GitHub 计划触发延迟或跳过时,窗口内任意后续检查都可补跑。每次检查以最新公开的稳定版本及其标签提交为基线,在远端 `main` 有新增提交且 CHANGELOG 未发布段含条目时准备 patch。手动发布的新稳定版在公开后立即成为基线,发布窗口仍沿用原周期。 [GitHub Actions 计划触发说明](https://docs.github.com/en/actions/reference/workflows-and-actions/events-that-trigger-workflows#schedule)
|
|
78
|
+
|
|
79
|
+
工作流沿用版本准备和检查命令,按 CHANGELOG 原文生成发布说明与提交链接。发布提交记录版本和窗口起点,再与附注标签一同原子推送;后续检查按主线发布提交识别该窗口已安排的版本。工作流使用 `GITHUB_TOKEN` 显式按标签调用 `Publish release`,沿用现有构建、GitHub 附件校验和 npm 发布。准备后遇到远端更新时,下一次检查重新取基线。标签已推送但 GitHub Release 或 npm 发布尚未完成时,后续检查继续同一版本。
|
|
80
|
+
|
|
81
|
+
Actions 的 `Run workflow` 运行只读预览,显示当前基线和跳过原因或候选版本,并验证主分支的推送连接。要求指定版本和发布时间时使用单版本定时发布。
|
|
82
|
+
|
|
83
|
+
## 单版本定时发布与正文同步
|
|
74
84
|
|
|
75
85
|
在推送版本标签前,将目标版本和含时区的 ISO 8601 时间写入 `.github/release-schedule.json`,并随发布准备提交推送到默认分支。例如:
|
|
76
86
|
|
|
@@ -93,7 +103,7 @@ GitHub cron 补偿 ─┘ ↓
|
|
|
93
103
|
|
|
94
104
|
交付定时任务时记录目标版本、含时区时间及 UTC 换算、允许延迟、实际任务名称、下次触发时间、重试策略和执行证据。用隔离任务与模拟发布状态验证到期触发、cron 缺席、提前执行、主机恢复后的补执行、重复执行和失败重试。草稿就绪、持久调度任务已建立、正式发布分别报告;公开结果以 `draft=false`、`published_at`、公开附件的 SHA-256 和临时全局安装验证为准。结果检查超过约定完成时限或连续失败时保留失败状态与日志,便于及时处理。
|
|
95
105
|
|
|
96
|
-
定时工作流需要位于默认分支。手动触发 `Publish scheduled releases` 可以重试到期发布,也会同步发布说明;手动触发继续遵守原发布时间。修改 `docs/releases`
|
|
106
|
+
定时工作流需要位于默认分支。手动触发 `Publish scheduled releases` 可以重试到期发布,也会同步发布说明;手动触发继续遵守原发布时间。修改 `docs/releases` 中的说明或发布脚本后,默认分支推送触发正文同步。同步依照日常发布的正文格式更新已有 Release,保持版本标题、标签和附件固定。
|
|
97
107
|
|
|
98
108
|
排查漏发时先核对并保存计划、工作流状态、触发记录及日志,区分缺少触发与执行失败。恢复交付时重试已有定时发布任务,继续使用原版本、标签和附件,并分别记录故障原因与恢复后的实际发布时间。
|
|
99
109
|
|
|
@@ -114,9 +124,9 @@ GitHub cron 补偿 ─┘ ↓
|
|
|
114
124
|
|
|
115
125
|
## 查看正在使用的版本
|
|
116
126
|
|
|
117
|
-
-
|
|
127
|
+
- 网页的“设置 → 更新与重启”显示产品版本号。`build-info.json` 中的网页来源在构建时固定,桥接来源在进程启动时固定。构建信息被 Git 忽略并列入发行白名单,供无 Git 的全局安装读取。
|
|
118
128
|
- `claudex-web --version` 输出便于阅读的标识;`claudex-web version --json` 输出完整的 `version`、`displayVersion`、`revision`、`dirty`、`channel` 和 `builtAt`。源码目录可用 `node bin/claudex-web.mjs version --json`。
|
|
119
|
-
-
|
|
129
|
+
- 网页同源 HTTPS 的 `/healthz` 返回 `ready` 与桥接进程的 `version` 对象。HTTP 200 / 503 继续表示后端连接就绪 / 未就绪。
|
|
120
130
|
|
|
121
131
|
前端重新构建并刷新后显示新网页标识;桥接版本随进程重启更新。全局命令查看当前磁盘安装包,健康接口查看正在运行的进程。升级排查时同时核对这两个来源。
|
|
122
132
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@hjd-hitsz/claudex-web",
|
|
3
|
-
"version": "4.1
|
|
3
|
+
"version": "4.2.1",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"description": "Codex 与 Claude Code 的浏览器工作台",
|
|
6
6
|
"license": "GPL-3.0-only",
|
|
@@ -23,6 +23,7 @@
|
|
|
23
23
|
"scripts/restart-when-idle.mjs",
|
|
24
24
|
".env.example",
|
|
25
25
|
"docs/",
|
|
26
|
+
"packages/background-terminal/",
|
|
26
27
|
"packages/translation-engine/src/",
|
|
27
28
|
"packages/translation-engine/native/",
|
|
28
29
|
"packages/translation-engine/bin/",
|
|
@@ -42,8 +43,9 @@
|
|
|
42
43
|
"prepack": "npm run build",
|
|
43
44
|
"start": "node --env-file-if-exists=.env server/src/server.mjs",
|
|
44
45
|
"start:backend": "node --env-file-if-exists=.env scripts/start-backend.mjs",
|
|
46
|
+
"auth": "node --env-file-if-exists=.env bin/claudex-web.mjs auth",
|
|
45
47
|
"test": "npm run test:unit && npm run test:components",
|
|
46
|
-
"test:unit": "node --import ./tests/helpers/test-console.mjs --test client/tests/*.test.js server/tests/*.test.mjs tests/architecture.test.mjs tests/version.test.mjs tests/release.test.mjs tests/npm-release.test.mjs tests/test-console.test.mjs packages/translation-engine/tests/*.test.mjs",
|
|
48
|
+
"test:unit": "node --import ./tests/helpers/test-console.mjs --test client/tests/*.test.js server/tests/*.test.mjs tests/architecture.test.mjs tests/version.test.mjs tests/release.test.mjs tests/auto-release.test.mjs tests/npm-release.test.mjs tests/test-console.test.mjs packages/translation-engine/tests/*.test.mjs",
|
|
47
49
|
"test:components": "node scripts/test-components.mjs",
|
|
48
50
|
"test:package": "npm run build && node --import ./tests/helpers/test-console.mjs --test tests/package.test.mjs",
|
|
49
51
|
"version:check": "node scripts/version.mjs check",
|
|
@@ -70,10 +72,12 @@
|
|
|
70
72
|
"dependencies": {
|
|
71
73
|
"@anthropic-ai/claude-agent-sdk": "0.3.318",
|
|
72
74
|
"@claudex-web/translation-engine": "file:packages/translation-engine",
|
|
75
|
+
"@opentunnel/client": "0.6.2",
|
|
73
76
|
"fflate": "0.8.2",
|
|
74
77
|
"fuzzysort": "4.0.2",
|
|
75
78
|
"ignore": "7.0.16",
|
|
76
79
|
"node-pty": "1.1.0",
|
|
80
|
+
"qrcode": "1.5.4",
|
|
77
81
|
"ws": "8.22.0"
|
|
78
82
|
},
|
|
79
83
|
"repository": {
|
|
@@ -87,5 +91,8 @@
|
|
|
87
91
|
"publishConfig": {
|
|
88
92
|
"access": "public",
|
|
89
93
|
"registry": "https://registry.npmjs.org/"
|
|
94
|
+
},
|
|
95
|
+
"optionalDependencies": {
|
|
96
|
+
"node-datachannel": "0.33.6"
|
|
90
97
|
}
|
|
91
98
|
}
|