@hjd-hitsz/claudex-web 4.0.1 → 4.1.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 (54) hide show
  1. package/CHANGELOG.md +46 -0
  2. package/README.md +33 -55
  3. package/build-info.json +4 -4
  4. package/client/dist/app.js +81 -82
  5. package/client/dist/style.css +1 -1
  6. package/docs/architecture/backends.md +2 -0
  7. package/docs/architecture/behavior.md +23 -1
  8. package/docs/architecture.md +33 -4
  9. package/docs/deployment.md +34 -14
  10. package/docs/development.md +14 -3
  11. package/docs/releases/v4.1.0.md +21 -0
  12. package/docs/versioning.md +10 -0
  13. package/package.json +24 -7
  14. package/packages/translation-engine/LICENSE +674 -0
  15. package/packages/translation-engine/README.md +69 -0
  16. package/packages/translation-engine/bin/tokenizer-linux-x64 +0 -0
  17. package/packages/translation-engine/bin/translate.mjs +29 -0
  18. package/packages/translation-engine/native/build.mjs +15 -0
  19. package/packages/translation-engine/native/tokenizer.c +73 -0
  20. package/packages/translation-engine/package.json +29 -0
  21. package/packages/translation-engine/src/catalog.mjs +103 -0
  22. package/packages/translation-engine/src/cpu-runtime.mjs +90 -0
  23. package/packages/translation-engine/src/download.mjs +94 -0
  24. package/packages/translation-engine/src/index.mjs +70 -0
  25. package/packages/translation-engine/src/inference.mjs +177 -0
  26. package/packages/translation-engine/src/model-store.mjs +197 -0
  27. package/packages/translation-engine/src/tokenizer.mjs +77 -0
  28. package/packages/translation-engine/src/worker.mjs +83 -0
  29. package/scripts/install-services.mjs +5 -4
  30. package/server/src/application.mjs +40 -5
  31. package/server/src/backends/claude/catalogue.mjs +5 -3
  32. package/server/src/backends/claude/execution-session.mjs +7 -1
  33. package/server/src/backends/claude/messages.mjs +2 -1
  34. package/server/src/backends/claude/provider-environment.mjs +6 -4
  35. package/server/src/backends/claude/sessions.mjs +1 -0
  36. package/server/src/backends/claude/worker-client.mjs +13 -6
  37. package/server/src/backends/claude/worker-location.mjs +12 -0
  38. package/server/src/backends/codex/adapter.mjs +2 -0
  39. package/server/src/backends/codex/events.mjs +1 -1
  40. package/server/src/backends/codex/token-usage.mjs +140 -0
  41. package/server/src/backends/manager.mjs +87 -21
  42. package/server/src/backends/provider-presets.mjs +1 -1
  43. package/server/src/backends/providers.mjs +6 -3
  44. package/server/src/backends/storage.mjs +7 -3
  45. package/server/src/config.mjs +7 -0
  46. package/server/src/http/maintenance.mjs +28 -0
  47. package/server/src/http/router.mjs +20 -2
  48. package/server/src/server.mjs +9 -0
  49. package/server/src/service-maintenance-worker.mjs +124 -0
  50. package/server/src/service-maintenance.mjs +222 -0
  51. package/server/src/summary-translation.mjs +42 -53
  52. package/server/src/token-usage-reconciliation.mjs +105 -0
  53. package/server/src/token-usage.mjs +208 -0
  54. package/server/src/translation-service.mjs +133 -0
package/CHANGELOG.md CHANGED
@@ -12,6 +12,52 @@
12
12
 
13
13
  ### 维护
14
14
 
15
+ ## [4.1.0] - 2026-11-11
16
+
17
+ - 修复 Claude Code 子代理详情在已有消息时显示“当前没有消息”的问题。
18
+
19
+ ### 新增
20
+
21
+ - 自动检查 npm 更新,设置中支持全局安装版本的一键更新和服务重启,重启成功后提示刷新网页。
22
+
23
+ - 设置中可按需开启思考内容翻译,首次启用下载本地模型,之后可离线使用;下载时显示进度,失败可重试。
24
+
25
+ ### 改进
26
+
27
+ - 设置页将更新与重启置顶,主题自动跟随系统。
28
+
29
+ - 复选框与选项对勾统一使用蓝色,深浅主题保持一致。
30
+
31
+ - 思考消息接收完整后再翻译,等待期间保留原文,完成后可切换原文与译文。翻译前提取 Markdown 中的文字,保留代码、链接目标与公式。
32
+
33
+ - 供应商协议选项明确显示为“Message API”和“Message API (兼容)”,新增供应商与预置 DeepSeek 默认使用原生 Message API。
34
+
35
+ ### 修复
36
+
37
+ - 启动时自动补齐未归档对话缺少的 token 统计,并清理已归档对话的本地快照。
38
+
39
+ - 已有 Codex 对话首次打开时补录并保存 token 用量,分页分支按实际历史位置恢复统计。
40
+
41
+ - 创建对话分支时继承已知的来源 token 用量,并独立保存后续统计。
42
+
43
+ - 对话 token 用量按 Codex 与 Claude 各对话保存到本地,重新打开、刷新及网页服务重启后恢复显示;归档和删除时清除统计。
44
+
45
+ - 中途打开或重新连接运行中的会话时,已有思考摘要继续翻译,当前流式思考在接收完整后翻译。
46
+
47
+ - 完整思考的原译文切换按钮与摘要统一显示在标题行右侧,切换时保持展开状态。
48
+
49
+ - 后端连接恢复后及时清除先前的连接错误;Claude 后台服务连接失败时显示易理解的处理提示。
50
+
51
+ - 首次部署可先启动网页,再从设置中安装 Codex 或 Claude Code;缺少 Codex CLI 时仍可进入网页完成配置。
52
+
53
+ - Claude Code 对话切换模型后,Opus、Sonnet、Haiku 别名及新启动的子代理同步使用当前选择的模型。
54
+
55
+ ### 维护
56
+
57
+ - 默认安装和升级使用 `@hjd-hitsz/claudex-web` 作用域包名,正式版本发布后自动同步到 npm。
58
+
59
+ - 安装文档改用自动选择最新稳定版本的命令并移除 Zsh 必装要求,README 按安装、Codex 自定义模型和 Claude Code 配置重新整理。
60
+
15
61
  ## [4.0.1] - 2026-11-10
16
62
 
17
63
  - 工作过程按插入位置标注运行中补充的消息,直接预览消息正文,长消息可展开查看全文和附件。
package/README.md CHANGED
@@ -6,7 +6,7 @@
6
6
 
7
7
  <p align="center">
8
8
  <strong>在浏览器中,继续你的 Codex 与 Claude Code 工作。</strong><br>
9
- 从电脑到手机和平板,随时查看对话、审阅计划并批准执行、跟进任务、掌握账户额度、阅读文件与变更。
9
+ 在电脑上部署,通过电脑、手机或平板访问同一工作环境。
10
10
  </p>
11
11
 
12
12
  <p align="center">
@@ -32,95 +32,73 @@
32
32
 
33
33
  </details>
34
34
 
35
- Claudex Web 提供 Codex 与 Claude Code 双后端:现有 ChatGPT 模型继续使用 Codex,其他供应商的模型通过 Claude Code 使用。输入区统一选择模型,Claude 对话可在空闲时切换供应商继续。配置方法见[部署指南](docs/deployment.md#claude-code-与模型配置)。
36
-
37
35
  ## 快速开始
38
36
 
39
- 稳定版 [v4.0.1](https://github.com/hjd-hitsz/claudex-web/releases/tag/v4.0.1):
37
+ 需要 Linux、Node.js 24+、npm 和 systemd。Debian / Ubuntu 安装系统依赖可执行以下命令。
40
38
 
41
39
  ```bash
42
- npm install -g @hjd-hitsz/claudex-web
40
+ sudo apt-get install openssl pamtester
43
41
  ```
44
42
 
45
- 准备一台 Linux 电脑,安装 Node.js 24+、npm、Git、OpenSSL、Linux PAM、`pamtester` 和 `/usr/bin/zsh`,并完成 Codex CLI 登录。Codex CLI 需支持 `codex app-server`,后台运行使用 systemd 用户服务。
46
-
47
- ### 1. 安装并启动
48
-
49
- 以运行代理后端的普通用户安装 Claudex Web,然后启动服务:
43
+ 以运行服务的普通用户安装,安装 npm 上的最新稳定版本。
50
44
 
51
45
  ```bash
52
46
  npm install -g @hjd-hitsz/claudex-web
53
47
  claudex-web service install
54
- claudex-web service status
55
48
  ```
56
49
 
57
- npm 全局命令所在目录需在 `PATH` 中。安装完成后,网页服务会自动启动,已有 Codex 配置继续保留。
58
-
59
- ### 2. 打开浏览器
50
+ 浏览器打开 `https://部署电脑的IP:8766`,使用该电脑上运行服务的系统用户名和密码登录。首次访问的证书配置见[证书安装指引](docs/deployment.md#证书配置)。
60
51
 
61
- - 本机访问:`https://127.0.0.1:8766`。
62
- - 同一网络的电脑、手机或平板:`https://电脑IP:8766`,将“电脑IP”替换为服务所在电脑的实际 IP,并允许防火墙访问 `8766` 端口。
52
+ 需要开机启动并在退出系统登录后继续运行时,执行 `loginctl enable-linger "$USER"`。
63
53
 
64
- 网页登录使用运行服务的系统用户名与密码,登录成功后沿用该电脑的 Codex 授权,任务以服务用户的完全访问权限执行。登录状态默认保留 30 天,刷新或重新打开浏览器会恢复有效登录。
54
+ ## 配置 Codex
65
55
 
66
- 首次访问时,浏览器可能提示证书不受信任。请按[证书安装指引](docs/deployment.md#证书配置)完成配置;登录页的“浏览器证书安装”提供证书下载和各设备的安装步骤。
56
+ 在网页“设置 → 模型与服务配置”中为 Codex 点击“一键安装”。
67
57
 
68
- 输入消息后,按 **Ctrl+Enter** 发送,**Enter** 换行。
69
-
70
- 对话完成通知默认开启。首次使用时在“设置 → 通知”允许系统通知并授权;任务成功完成后,通知显示对话标题,点击即可返回对应对话。权限被阻止或环境不支持时,设置页会显示对应状态。
71
-
72
- <details>
73
- <summary>开机启动与退出系统登录后继续运行</summary>
74
-
75
- 需要开机自动启动、退出系统登录后继续运行时,执行:
58
+ ### 使用 ChatGPT 账户
76
59
 
77
60
  ```bash
78
- loginctl enable-linger "$USER"
61
+ codex login
79
62
  ```
80
63
 
81
- 该命令可能需要管理员授权。
64
+ ### 使用自定义模型服务
82
65
 
83
- </details>
66
+ 编辑 `~/.codex/config.toml`。合并以下配置,把模型 ID 和地址替换为服务提供的值。`model` 和 `model_provider` 放在文件顶部、所有表头之前。
84
67
 
85
- 前台运行、本地安装包的安装与下载校验见[部署与维护](docs/deployment.md)。
68
+ ```toml
69
+ model = "your-model-id"
70
+ model_provider = "custom"
86
71
 
87
- ## 按需配置
88
-
89
- 执行以下命令可创建用户配置并显示其位置,已有配置会保留:
90
-
91
- ```bash
92
- claudex-web config init
72
+ [model_providers.custom]
73
+ name = "Custom"
74
+ base_url = "https://model.example/v1"
75
+ wire_api = "responses"
76
+ requires_openai_auth = true
93
77
  ```
94
78
 
95
- 通常可直接使用初始配置。需要修改时,编辑命令显示的 `.env` 文件;默认位置为 `~/.config/claudex-web/.env`,升级后保留。
96
-
97
- 常用配置项:
98
-
99
- - `HOST`:监听地址,初始为 `0.0.0.0`,允许通过电脑 IP 访问;仅本机访问可改为 `127.0.0.1`。
100
- - `PORT`:网页端口,初始为 `8766`。
101
- - `DEFAULT_CWD`:首次使用时的默认工作目录,未设置时使用当前用户的主目录。
79
+ ## 配置 Claude Code
102
80
 
103
- 修改配置前先结束当前任务和网页终端,保存后执行 `claudex-web service restart`;前台运行时重新启动网页进程。端口变更后使用新端口访问。完整配置见[部署与维护](docs/deployment.md#配置)。
81
+ 在网页“设置 → 模型与服务配置”中为 Claude Code 点击“一键安装”,然后启用该后端。
104
82
 
105
- ## 升级
83
+ ### 使用 Claude 账户
106
84
 
107
- 升级时,从目标版本的 Release 获取安装地址。当前版本的安装与服务更新命令为:
85
+ 以运行服务的同一系统用户登录,然后在网页模型菜单中选择 Claude 原生模型。
108
86
 
109
87
  ```bash
110
- npm install -g @hjd-hitsz/claudex-web
111
- claudex-web service install
112
- claudex-web service restart-when-idle
88
+ claude auth login
113
89
  ```
114
90
 
115
- 最后一个命令会等待当前任务和上下文整理结束后再重启,等待期间保持命令运行。升级后刷新网页,在“设置 → 关于”查看版本。
91
+ ### 使用自定义供应商和模型
92
+
93
+ 在网页“设置 → Claude Code”的供应商列表中添加服务。
94
+
95
+ DeepSeek 等预置供应商直接填写 API Key。
116
96
 
117
97
  ## 更多文档
118
98
 
119
- - [部署与维护](docs/deployment.md):完整配置、服务管理、回退和故障排查。
120
- - [数据保存与迁移](docs/deployment.md#数据保存与迁移):数据位置、摘要翻译与模型用量说明。
121
- - [开发者指南](docs/development.md):从源码运行、参与开发和验证修改。
122
- - [架构设计](docs/architecture.md):模块边界、状态与请求流程、代码规模约束和扩展方式。
123
- - [变更日志](CHANGELOG.md):各版本的新增功能、改进与修复。
99
+ - [部署与维护](docs/deployment.md)包含端口、证书、网络代理、服务管理、升级和故障排查。
100
+ - [开发者指南](docs/development.md)介绍源码运行与开发验证,[架构设计](docs/architecture.md)说明模块边界。
101
+ - [版本更新](https://github.com/hjd-hitsz/claudex-web/releases)与[变更日志](CHANGELOG.md)记录版本变化。
124
102
 
125
103
  ## 许可证
126
104
 
package/build-info.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
- "version": "4.0.1",
3
- "displayVersion": "4.0.1",
4
- "revision": "62fad388f6db048bd6b92a2dc2e7259af064a6dd",
2
+ "version": "4.1.0",
3
+ "displayVersion": "4.1.0",
4
+ "revision": "9d767bed9171bf65edb444e65f7ecbb16f3e82ca",
5
5
  "dirty": false,
6
6
  "channel": "release",
7
- "builtAt": "2026-11-10T04:46:06.339Z"
7
+ "builtAt": "2026-11-11T15:48:27.991Z"
8
8
  }