@hjd-hitsz/claudex-web 4.1.4 → 4.2.0

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.
Files changed (83) hide show
  1. package/.env.example +2 -0
  2. package/CHANGELOG.md +47 -0
  3. package/README.md +13 -1
  4. package/bin/auth.mjs +86 -0
  5. package/bin/claudex-web.mjs +20 -0
  6. package/bin/p2p.mjs +134 -0
  7. package/build-info.json +4 -4
  8. package/client/dist/app.js +104 -104
  9. package/client/dist/code-highlight-style.js +1 -1
  10. package/client/dist/document-editor.js +55 -54
  11. package/client/dist/file-panel.js +5 -5
  12. package/client/dist/notification-worker.js +2 -1
  13. package/client/dist/p2p-sw.js +162 -0
  14. package/client/dist/style.css +1 -1
  15. package/client/dist/terminal-panel.js +11 -11
  16. package/docs/architecture/backends.md +9 -2
  17. package/docs/architecture/behavior.md +167 -53
  18. package/docs/architecture.md +36 -337
  19. package/docs/background-tasks.md +30 -26
  20. package/docs/deployment.md +47 -6
  21. package/docs/development.md +111 -153
  22. package/docs/images/desktop-dark.png +0 -0
  23. package/docs/images/desktop-light.png +0 -0
  24. package/docs/images/mobile-sidebar.png +0 -0
  25. package/docs/images/mobile.png +0 -0
  26. package/docs/releases/v4.1.5.md +6 -0
  27. package/docs/releases/v4.2.0.md +13 -0
  28. package/docs/versioning.md +13 -3
  29. package/package.json +14 -5
  30. package/packages/background-terminal/LICENSE +674 -0
  31. package/packages/background-terminal/README.md +17 -0
  32. package/packages/background-terminal/background-jobs.mjs +457 -0
  33. package/packages/background-terminal/background-mcp.mjs +79 -0
  34. package/packages/background-terminal/background-protocol.mjs +80 -0
  35. package/packages/background-terminal/cli.mjs +14 -0
  36. package/packages/background-terminal/client.mjs +61 -0
  37. package/packages/background-terminal/codex.mjs +88 -0
  38. package/packages/background-terminal/delivery.mjs +192 -0
  39. package/packages/background-terminal/log.mjs +25 -0
  40. package/packages/background-terminal/native-watches.mjs +160 -0
  41. package/packages/background-terminal/package.json +15 -0
  42. package/packages/background-terminal/service.mjs +126 -0
  43. package/packages/translation-engine/package.json +1 -1
  44. package/server/src/application.mjs +82 -10
  45. package/server/src/auth-http.mjs +187 -0
  46. package/server/src/auth-login.mjs +144 -0
  47. package/server/src/auth-totp.mjs +233 -0
  48. package/server/src/auth.mjs +169 -220
  49. package/server/src/backends/claude/background-tasks.mjs +88 -35
  50. package/server/src/backends/claude/messages.mjs +1 -1
  51. package/server/src/backends/claude/worker-client.mjs +47 -35
  52. package/server/src/backends/claude/worker-lines.mjs +17 -0
  53. package/server/src/backends/claude/worker-server.mjs +49 -69
  54. package/server/src/backends/codex/adapter.mjs +46 -5
  55. package/server/src/backends/codex/background-service.mjs +85 -0
  56. package/server/src/backends/codex/background-task-views.mjs +87 -0
  57. package/server/src/backends/codex/background-terminals.mjs +91 -0
  58. package/server/src/backends/codex/events.mjs +11 -0
  59. package/server/src/backends/codex/methods.mjs +1 -0
  60. package/server/src/backends/codex/native-background-handoff.mjs +72 -0
  61. package/server/src/backends/codex/requests.mjs +51 -38
  62. package/server/src/backends/codex/subscriptions.mjs +34 -4
  63. package/server/src/backends/configuration.mjs +8 -0
  64. package/server/src/backends/manager.mjs +35 -33
  65. package/server/src/backends/storage.mjs +3 -14
  66. package/server/src/config.mjs +13 -0
  67. package/server/src/http/business.mjs +21 -0
  68. package/server/src/http/router.mjs +12 -25
  69. package/server/src/p2p/http.mjs +136 -0
  70. package/server/src/p2p/peers.mjs +132 -0
  71. package/server/src/p2p/service.mjs +229 -0
  72. package/server/src/p2p/storage.mjs +45 -0
  73. package/server/src/p2p/tunnel.mjs +95 -0
  74. package/server/src/p2p-http.mjs +149 -0
  75. package/server/src/p2p-peer.mjs +135 -0
  76. package/server/src/private-file.mjs +14 -0
  77. package/server/src/summary-translation.mjs +1 -1
  78. package/server/src/thread-folders.mjs +3 -13
  79. package/server/src/translation-service.mjs +3 -8
  80. package/server/src/workspace/file-search.mjs +244 -0
  81. package/server/src/workspace/service.mjs +17 -3
  82. package/shared/codex-preferences.mjs +9 -0
  83. package/shared/p2p-wire.mjs +157 -0
Binary file
Binary file
@@ -0,0 +1,6 @@
1
+ # Claudex Web v4.1.5
2
+
3
+ - Claude Code 供应商的编辑表单在对应行下方展开,编辑与删除按钮并排靠右。连接和模型设置共享左侧对齐线,配置下拉菜单按原始模型 ID 列出模型。显示别名和居中的上下文容量同行,点击容量框旁的 k 可切换输入单位,思考强度可在横轴上点选。([7a7a405](https://github.com/hjd-hitsz/claudex-web/commit/7a7a40525bbeb694ec097f16e1660812b8c26b1f))
4
+ - 在本机工作区使用 `@` 时,通过短前缀或跳字找到的文件夹也会排在文件前。可以用目录缩写加文件名区分同名文件,切换 Codex 和 Claude Code 时使用相同的搜索结果。([39f76ae](https://github.com/hjd-hitsz/claudex-web/commit/39f76ae6926d18a6453f2b07986157d39f62b613))
5
+ - 切换对话后,光标自动落到消息输入框的草稿末尾,可以直接继续输入。([41c5f88](https://github.com/hjd-hitsz/claudex-web/commit/41c5f88935d3c1c4d49ee653816fdf5521d68ccf))
6
+ - 将粘贴到消息中的单行代码保留在正文里,以 Markdown 行内代码显示。多行代码继续使用带语言标记的代码块。([97972eb](https://github.com/hjd-hitsz/claudex-web/commit/97972eb78447b84bd3edbb6ec45c1b21bbe6c380))
@@ -0,0 +1,13 @@
1
+ # Claudex Web v4.2.0
2
+
3
+ - **Codex 后台终端**。在「设置 → 其他设置」开启扩展后,耗时命令可以在当前轮次结束后继续运行,任务完成时自动唤醒原对话。输入框旁的任务计数可打开任务列表,查看实时输出或单独停止任务。Codex 任务支持下载完整日志,`/stop` 可管理当前对话的原生终端和扩展任务。自动续跑失败或没有返回正文时,原对话仍会显示任务结果和日志入口。([f71d8f3](https://github.com/hjd-hitsz/claudex-web/commit/f71d8f39181025bda95f134bb2b25aea6df8de94))
4
+ - **P2P 远程直连**。在「设置 → 连接与登录」开启 P2P 后,可生成长期授权链接,从局域网外用浏览器通过加密的 WebRTC 直连访问聊天、文件和终端。刷新、重连或在同一浏览器重新打开链接时可恢复有效登录。撤销链接会断开相关连接并使对应的登录会话失效。([b40f98a](https://github.com/hjd-hitsz/claudex-web/commit/b40f98a267f090fe7bfdda750e5b30f632b15cb1))
5
+ - **双重验证登录(2FA)**。从其他设备、代理入口或 P2P 登录时,默认在系统密码后验证六位动态码。同一实例的多位使用者可以分别绑定具名验证器,撤销某个验证器时会同时撤销通过它登录的会话。服务电脑上的浏览器直接访问本机 HTTPS 端口时可凭系统密码登录。缺少新版认证凭据的旧网页会话需要重新登录。([08cdb45](https://github.com/hjd-hitsz/claudex-web/commit/08cdb4576e335147546c6eb100180eebf7bfe5cf)、[a46e5e5](https://github.com/hjd-hitsz/claudex-web/commit/a46e5e5eb119422aace5b6a0488444382b80d5ca))
6
+
7
+ ## 其他改进与修复
8
+
9
+ - Codex 目标可以跨轮次持续运行,自动续跑会处理已发送的中途消息。Claude Code 执行服务等待空闲更新时,设置页继续显示实际连接状态,现有对话可以继续使用。([d3a53ec](https://github.com/hjd-hitsz/claudex-web/commit/d3a53ecba1559ec3b6b0001ceb00a60702b680fb)、[d0e89fe](https://github.com/hjd-hitsz/claudex-web/commit/d0e89fed3f8dced94773562c6906f6b5d8d3d85c))
10
+ - 文件面板的 Markdown 预览恢复标题层级和段落间距,代码块的编辑与复制按钮并排显示,宽表格可在预览内横向滚动。不同对话打开同一路径时,各自保留未保存的编辑。([e45f912](https://github.com/hjd-hitsz/claudex-web/commit/e45f912d833e55e2394b6aa2d8fc592c55fcf4d3)、[2590ef4](https://github.com/hjd-hitsz/claudex-web/commit/2590ef4e2ab164ab3ce76f3df9d86e2148d1132e))
11
+ - 流式回复期间,已显示的 Markdown 链接、图片、图表和模型控件按需更新。模型选择器、`/model` 和子代理设置统一隐藏已设为不可见的模型。([2590ef4](https://github.com/hjd-hitsz/claudex-web/commit/2590ef4e2ab164ab3ce76f3df9d86e2148d1132e))
12
+ - 弹窗关闭后焦点回到触发入口,对话菜单支持按 Esc 关闭,桌面侧栏和移动端抽屉分别记住开合状态。窄屏放大时,更新与重启按钮保留完整文字,长模型名也能给消息输入留出两行空间。手机上的宽公式、代码块和表格在各自区域内横向滚动。([2590ef4](https://github.com/hjd-hitsz/claudex-web/commit/2590ef4e2ab164ab3ce76f3df9d86e2148d1132e)、[75cc522](https://github.com/hjd-hitsz/claudex-web/commit/75cc522b5d553193a5f327a135948df4f908e142))
13
+ - 「连接与登录」按账号与双重验证、局域网 HTTPS 证书、P2P 远程访问分区显示。「其他设置」的复选项采用一致的行距。([b40f98a](https://github.com/hjd-hitsz/claudex-web/commit/b40f98a267f090fe7bfdda750e5b30f632b15cb1)、[d9f93cc](https://github.com/hjd-hitsz/claudex-web/commit/d9f93cc18e8afeef25776c94e3cdae126a10178a))
@@ -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` 由 GitHub Actions 默认分支的计划任务触发,实际检查以 2026 年 11 月 22 日 04:16 UTC(北京时间 12:16)为起点,每两天一次。每次从 GitHub 取得最新公开的稳定版本和标签提交,对照远端 `main`。只有新增提交且 CHANGELOG 未发布段含条目时才准备 patch。手动发布的新稳定版在公开后立即成为基线,计划周期继续沿用原时间。GitHub 计划触发可能延迟或跳过,后续检查仍覆盖最新正式版以来的完整变更。 [GitHub Actions 计划触发说明](https://docs.github.com/en/actions/reference/workflows-and-actions/events-that-trigger-workflows#schedule)
78
+
79
+ 工作流沿用版本准备和检查命令,按 CHANGELOG 原文生成发布说明与提交链接,创建 `chore(release)` 提交并原子推送 `main` 和附注标签。使用工作流的 `GITHUB_TOKEN` 显式按标签调用 `Publish release`,沿用该工作流的构建、GitHub 附件校验和后续 npm 发布。准备后遇到远端更新时,由下一次检查重新取基线。标签已推送但发布未完成时,工作流识别带 `Claudex-Auto-Release` 标记的发布提交并继续同一版本。
80
+
81
+ Actions 的 `Run workflow` 运行只读预览,显示当前基线和跳过原因或候选版本,并验证主分支的推送连接。自动发布由 `schedule` 触发。要求指定版本和发布时间时使用单版本定时发布。
82
+
83
+ ## 单版本定时发布与正文同步
74
84
 
75
85
  在推送版本标签前,将目标版本和含时区的 ISO 8601 时间写入 `.github/release-schedule.json`,并随发布准备提交推送到默认分支。例如:
76
86
 
@@ -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
- - `curl http://127.0.0.1:8766/healthz` 返回 `ready` 与桥接进程的 `version` 对象。HTTP 200 / 503 继续表示后端连接就绪 / 未就绪。
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.4",
3
+ "version": "4.2.0",
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",
@@ -69,10 +71,14 @@
69
71
  },
70
72
  "dependencies": {
71
73
  "@anthropic-ai/claude-agent-sdk": "0.3.318",
72
- "node-pty": "1.1.0",
73
- "ws": "8.22.0",
74
74
  "@claudex-web/translation-engine": "file:packages/translation-engine",
75
- "fflate": "0.8.2"
75
+ "@opentunnel/client": "0.6.2",
76
+ "fflate": "0.8.2",
77
+ "fuzzysort": "4.0.2",
78
+ "ignore": "7.0.16",
79
+ "node-pty": "1.1.0",
80
+ "qrcode": "1.5.4",
81
+ "ws": "8.22.0"
76
82
  },
77
83
  "repository": {
78
84
  "type": "git",
@@ -85,5 +91,8 @@
85
91
  "publishConfig": {
86
92
  "access": "public",
87
93
  "registry": "https://registry.npmjs.org/"
94
+ },
95
+ "optionalDependencies": {
96
+ "node-datachannel": "0.33.6"
88
97
  }
89
98
  }