@hjd-hitsz/claudex-web 0.0.0-stage → 4.0.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.
Files changed (317) hide show
  1. package/.env.example +27 -0
  2. package/CHANGELOG.md +449 -0
  3. package/LICENSE +674 -0
  4. package/README.md +128 -2
  5. package/bin/claudex-web.mjs +129 -0
  6. package/build-info.json +8 -0
  7. package/client/dist/_baseMerge.js +1 -0
  8. package/client/dist/abnfDiagram-WEYOIA3C.js +1 -0
  9. package/client/dist/apl.js +1 -0
  10. package/client/dist/app.js +393 -0
  11. package/client/dist/apple-touch-icon.png +0 -0
  12. package/client/dist/arc.js +1 -0
  13. package/client/dist/architectureDiagram-ZHVYKT53.js +36 -0
  14. package/client/dist/asciiarmor.js +1 -0
  15. package/client/dist/asn1.js +1 -0
  16. package/client/dist/asterisk.js +1 -0
  17. package/client/dist/blockDiagram-RJAE7QA3.js +140 -0
  18. package/client/dist/brainfuck.js +1 -0
  19. package/client/dist/c4Diagram-XDPPPE54.js +38 -0
  20. package/client/dist/channel.js +1 -0
  21. package/client/dist/chunk-2E7WHVMD.js +88 -0
  22. package/client/dist/chunk-2Q5K7J3B.js +1 -0
  23. package/client/dist/chunk-4EMNKR2T.js +1 -0
  24. package/client/dist/chunk-55XCU76K.js +1 -0
  25. package/client/dist/chunk-5VM5RSS4.js +15 -0
  26. package/client/dist/chunk-JWPE2WC7.js +1 -0
  27. package/client/dist/chunk-VQ5W62QI.js +1 -0
  28. package/client/dist/chunk-XXDRQBXY.js +1 -0
  29. package/client/dist/chunk-ZCHMQSOR.js +2 -0
  30. package/client/dist/classDiagram-v2-4MYWR3UA.js +217 -0
  31. package/client/dist/clike.js +1 -0
  32. package/client/dist/clojure.js +1 -0
  33. package/client/dist/cmake.js +1 -0
  34. package/client/dist/cobol.js +1 -0
  35. package/client/dist/code-highlight-style.js +13 -0
  36. package/client/dist/coffeescript.js +1 -0
  37. package/client/dist/commonlisp.js +1 -0
  38. package/client/dist/cose-bilkent-JH36ORCC.js +1 -0
  39. package/client/dist/crystal.js +1 -0
  40. package/client/dist/css.js +1 -0
  41. package/client/dist/cynefin-EF2NZ3EQ.js +141 -0
  42. package/client/dist/cynefinDiagram-WF24UDRP.js +62 -0
  43. package/client/dist/cypher.js +1 -0
  44. package/client/dist/cytoscape.esm.js +321 -0
  45. package/client/dist/d.js +1 -0
  46. package/client/dist/dagre-NK4GIZVX.js +4 -0
  47. package/client/dist/defaultLocale.js +1 -0
  48. package/client/dist/diagram-CBK3MWTC.js +24 -0
  49. package/client/dist/diagram-I5XIIV2D.js +24 -0
  50. package/client/dist/diagram-ODIL2UCW.js +30 -0
  51. package/client/dist/diagram-PFBEJUXE.js +3 -0
  52. package/client/dist/diagram-RJA3I4VV.js +41 -0
  53. package/client/dist/diagram-TYUNFSNR.js +200 -0
  54. package/client/dist/diff.js +1 -0
  55. package/client/dist/dockerfile.js +1 -0
  56. package/client/dist/document-editor.js +1040 -0
  57. package/client/dist/dtd.js +1 -0
  58. package/client/dist/dylan.js +1 -0
  59. package/client/dist/ebnf.js +1 -0
  60. package/client/dist/ebnfDiagram-V4P3TTPT.js +1 -0
  61. package/client/dist/ecl.js +1 -0
  62. package/client/dist/eiffel.js +1 -0
  63. package/client/dist/elk-QONTBCTQ.js +27 -0
  64. package/client/dist/elm.js +1 -0
  65. package/client/dist/erDiagram-KYQIGQAA.js +99 -0
  66. package/client/dist/erlang.js +1 -0
  67. package/client/dist/factor.js +1 -0
  68. package/client/dist/favicon.ico +0 -0
  69. package/client/dist/favicon.png +0 -0
  70. package/client/dist/fcl.js +1 -0
  71. package/client/dist/file-panel.js +1 -0
  72. package/client/dist/flowDiagram-IUGLLWBU.js +213 -0
  73. package/client/dist/forth.js +1 -0
  74. package/client/dist/fortran.js +1 -0
  75. package/client/dist/ganttDiagram-R7GPNTJY.js +292 -0
  76. package/client/dist/gas.js +1 -0
  77. package/client/dist/gherkin.js +1 -0
  78. package/client/dist/gitGraphDiagram-PDYL7XHY.js +106 -0
  79. package/client/dist/graph.js +1 -0
  80. package/client/dist/groovy.js +1 -0
  81. package/client/dist/haskell.js +1 -0
  82. package/client/dist/haxe.js +1 -0
  83. package/client/dist/http.js +1 -0
  84. package/client/dist/idl.js +1 -0
  85. package/client/dist/index.html +25 -0
  86. package/client/dist/index.js +2 -0
  87. package/client/dist/index10.js +1 -0
  88. package/client/dist/index11.js +1 -0
  89. package/client/dist/index12.js +1 -0
  90. package/client/dist/index13.js +7 -0
  91. package/client/dist/index14.js +1 -0
  92. package/client/dist/index15.js +1 -0
  93. package/client/dist/index16.js +6 -0
  94. package/client/dist/index17.js +1 -0
  95. package/client/dist/index18.js +3 -0
  96. package/client/dist/index19.js +1 -0
  97. package/client/dist/index2.js +1 -0
  98. package/client/dist/index20.js +1 -0
  99. package/client/dist/index21.js +1 -0
  100. package/client/dist/index22.js +1 -0
  101. package/client/dist/index3.js +1 -0
  102. package/client/dist/index4.js +1 -0
  103. package/client/dist/index5.js +1 -0
  104. package/client/dist/index6.js +13 -0
  105. package/client/dist/index7.js +1 -0
  106. package/client/dist/index8.js +1 -0
  107. package/client/dist/index9.js +1 -0
  108. package/client/dist/infoDiagram-MVDRKAX5.js +2 -0
  109. package/client/dist/init.js +1 -0
  110. package/client/dist/isArrayLikeObject.js +1 -0
  111. package/client/dist/ishikawaDiagram-HPEHV2GE.js +70 -0
  112. package/client/dist/javascript.js +1 -0
  113. package/client/dist/journeyDiagram-BOSHW7O7.js +139 -0
  114. package/client/dist/julia.js +1 -0
  115. package/client/dist/kanban-definition-FNSA4HC5.js +89 -0
  116. package/client/dist/katex.js +257 -0
  117. package/client/dist/linear.js +1 -0
  118. package/client/dist/livescript.js +1 -0
  119. package/client/dist/lua.js +1 -0
  120. package/client/dist/mathematica.js +1 -0
  121. package/client/dist/mbox.js +1 -0
  122. package/client/dist/mermaid.core.js +310 -0
  123. package/client/dist/mindmap-definition-6OY57UG3.js +98 -0
  124. package/client/dist/mirc.js +1 -0
  125. package/client/dist/mllike.js +1 -0
  126. package/client/dist/modelica.js +1 -0
  127. package/client/dist/mscgen.js +1 -0
  128. package/client/dist/mumps.js +1 -0
  129. package/client/dist/nginx.js +1 -0
  130. package/client/dist/notification-worker.js +45 -0
  131. package/client/dist/nsis.js +1 -0
  132. package/client/dist/ntriples.js +1 -0
  133. package/client/dist/octave.js +1 -0
  134. package/client/dist/ordinal.js +1 -0
  135. package/client/dist/oz.js +1 -0
  136. package/client/dist/pascal.js +1 -0
  137. package/client/dist/pegDiagram-ECIUJNBX.js +1 -0
  138. package/client/dist/perl.js +1 -0
  139. package/client/dist/pieDiagram-GNMPY74T.js +39 -0
  140. package/client/dist/pig.js +1 -0
  141. package/client/dist/powershell.js +1 -0
  142. package/client/dist/properties.js +1 -0
  143. package/client/dist/protobuf.js +1 -0
  144. package/client/dist/pug.js +1 -0
  145. package/client/dist/puppet.js +1 -0
  146. package/client/dist/purify.es.js +3 -0
  147. package/client/dist/python.js +1 -0
  148. package/client/dist/q.js +1 -0
  149. package/client/dist/quadrantDiagram-D57K4MC3.js +7 -0
  150. package/client/dist/r.js +1 -0
  151. package/client/dist/railroadDiagram-Y72NRBL7.js +1 -0
  152. package/client/dist/requirementDiagram-EQYSW5RA.js +84 -0
  153. package/client/dist/rpm.js +1 -0
  154. package/client/dist/ruby.js +1 -0
  155. package/client/dist/sankeyDiagram-SY24JHO5.js +40 -0
  156. package/client/dist/sas.js +1 -0
  157. package/client/dist/scheme.js +1 -0
  158. package/client/dist/sequenceDiagram-BLEHNHQU.js +169 -0
  159. package/client/dist/shell.js +1 -0
  160. package/client/dist/sieve.js +1 -0
  161. package/client/dist/simple-mode.js +1 -0
  162. package/client/dist/sizeCapture-INFHLROL.js +1 -0
  163. package/client/dist/smalltalk.js +1 -0
  164. package/client/dist/solr.js +1 -0
  165. package/client/dist/sparql.js +1 -0
  166. package/client/dist/spreadsheet.js +1 -0
  167. package/client/dist/sql.js +1 -0
  168. package/client/dist/stateDiagram-v2-A6IESKWZ.js +291 -0
  169. package/client/dist/stex.js +1 -0
  170. package/client/dist/style.css +1 -0
  171. package/client/dist/stylus.js +1 -0
  172. package/client/dist/swift.js +1 -0
  173. package/client/dist/swimlanes-B3ENRKFQ.js +1 -0
  174. package/client/dist/swimlanesDiagram-AYQRV4AK.js +8 -0
  175. package/client/dist/tcl.js +1 -0
  176. package/client/dist/terminal-panel.js +18 -0
  177. package/client/dist/textile.js +1 -0
  178. package/client/dist/tiddlywiki.js +1 -0
  179. package/client/dist/tiki.js +1 -0
  180. package/client/dist/timeline-definition-JXYKGLGB.js +120 -0
  181. package/client/dist/toml.js +1 -0
  182. package/client/dist/troff.js +1 -0
  183. package/client/dist/ttcn-cfg.js +1 -0
  184. package/client/dist/ttcn.js +1 -0
  185. package/client/dist/turtle.js +1 -0
  186. package/client/dist/usecaseDiagram-WPOLBNNX.js +370 -0
  187. package/client/dist/vb.js +1 -0
  188. package/client/dist/vbscript.js +1 -0
  189. package/client/dist/velocity.js +1 -0
  190. package/client/dist/vennDiagram-Q3Y3IDCW.js +34 -0
  191. package/client/dist/verilog.js +1 -0
  192. package/client/dist/vhdl.js +1 -0
  193. package/client/dist/wardleyDiagram-IVAIDKWA.js +78 -0
  194. package/client/dist/webidl.js +1 -0
  195. package/client/dist/xquery.js +1 -0
  196. package/client/dist/xychartDiagram-4URNHDU4.js +7 -0
  197. package/client/dist/yacas.js +1 -0
  198. package/client/dist/z80.js +1 -0
  199. package/docs/architecture/backend-regressions.md +53 -0
  200. package/docs/architecture/backends.md +113 -0
  201. package/docs/architecture/behavior.md +206 -0
  202. package/docs/architecture.md +306 -0
  203. package/docs/background-tasks.md +39 -0
  204. package/docs/cli-command-coverage.md +60 -0
  205. package/docs/deployment.md +269 -0
  206. package/docs/development.md +385 -0
  207. package/docs/images/desktop-dark.png +0 -0
  208. package/docs/images/desktop-light.png +0 -0
  209. package/docs/images/mobile-sidebar.png +0 -0
  210. package/docs/images/mobile.png +0 -0
  211. package/docs/releases/v2.0.0.md +5 -0
  212. package/docs/releases/v2.1.0.md +6 -0
  213. package/docs/releases/v2.1.1.md +6 -0
  214. package/docs/releases/v2.1.2.md +8 -0
  215. package/docs/releases/v2.2.0.md +11 -0
  216. package/docs/releases/v2.3.0.md +12 -0
  217. package/docs/releases/v2.3.1.md +8 -0
  218. package/docs/releases/v2.4.0.md +8 -0
  219. package/docs/releases/v2.4.1.md +8 -0
  220. package/docs/releases/v2.4.2.md +8 -0
  221. package/docs/releases/v3.0.0.md +9 -0
  222. package/docs/releases/v3.1.0.md +10 -0
  223. package/docs/releases/v3.1.1.md +7 -0
  224. package/docs/releases/v4.0.0-beta.1.md +10 -0
  225. package/docs/releases/v4.0.0.md +20 -0
  226. package/docs/releases/v4.0.1.md +10 -0
  227. package/docs/versioning.md +119 -0
  228. package/package.json +70 -4
  229. package/scripts/install-services.mjs +134 -0
  230. package/scripts/restart-when-idle.mjs +125 -0
  231. package/scripts/start-backend.mjs +29 -0
  232. package/server/src/agent-messages.mjs +124 -0
  233. package/server/src/application.mjs +133 -0
  234. package/server/src/auth.mjs +328 -0
  235. package/server/src/backends/claude/account.mjs +171 -0
  236. package/server/src/backends/claude/adapter.mjs +366 -0
  237. package/server/src/backends/claude/agent-history.mjs +70 -0
  238. package/server/src/backends/claude/background-tasks.mjs +168 -0
  239. package/server/src/backends/claude/catalogue.mjs +266 -0
  240. package/server/src/backends/claude/execution-errors.mjs +44 -0
  241. package/server/src/backends/claude/execution-session.mjs +390 -0
  242. package/server/src/backends/claude/git-tool-changes.mjs +77 -0
  243. package/server/src/backends/claude/goals.mjs +319 -0
  244. package/server/src/backends/claude/history-actions.mjs +170 -0
  245. package/server/src/backends/claude/history.mjs +65 -0
  246. package/server/src/backends/claude/hooks.mjs +232 -0
  247. package/server/src/backends/claude/input-stream.mjs +24 -0
  248. package/server/src/backends/claude/messages-request.mjs +34 -0
  249. package/server/src/backends/claude/messages.mjs +300 -0
  250. package/server/src/backends/claude/model-options.mjs +18 -0
  251. package/server/src/backends/claude/native-commands.mjs +48 -0
  252. package/server/src/backends/claude/native-records.mjs +76 -0
  253. package/server/src/backends/claude/process-ownership.mjs +82 -0
  254. package/server/src/backends/claude/project-instructions.mjs +40 -0
  255. package/server/src/backends/claude/provider-balance.mjs +40 -0
  256. package/server/src/backends/claude/provider-environment.mjs +93 -0
  257. package/server/src/backends/claude/provider-transport.mjs +70 -0
  258. package/server/src/backends/claude/recovery.mjs +54 -0
  259. package/server/src/backends/claude/runtime.mjs +463 -0
  260. package/server/src/backends/claude/session-worker.mjs +32 -0
  261. package/server/src/backends/claude/sessions.mjs +347 -0
  262. package/server/src/backends/claude/token-usage.mjs +98 -0
  263. package/server/src/backends/claude/worker-client.mjs +344 -0
  264. package/server/src/backends/claude/worker-launcher.mjs +119 -0
  265. package/server/src/backends/claude/worker-location.mjs +31 -0
  266. package/server/src/backends/claude/worker-revision.mjs +45 -0
  267. package/server/src/backends/claude/worker-server.mjs +290 -0
  268. package/server/src/backends/cli-installation.mjs +140 -0
  269. package/server/src/backends/codex/adapter.mjs +153 -0
  270. package/server/src/backends/codex/compaction-recovery.mjs +78 -0
  271. package/server/src/backends/codex/events.mjs +125 -0
  272. package/server/src/backends/codex/methods.mjs +17 -0
  273. package/server/src/backends/codex/reference-mcp.mjs +97 -0
  274. package/server/src/backends/codex/reference-tools.mjs +71 -0
  275. package/server/src/backends/codex/requests.mjs +170 -0
  276. package/server/src/backends/codex/subscriptions.mjs +91 -0
  277. package/server/src/backends/codex/upstream.mjs +148 -0
  278. package/server/src/backends/configuration.mjs +122 -0
  279. package/server/src/backends/identity-mapping.mjs +87 -0
  280. package/server/src/backends/manager.mjs +412 -0
  281. package/server/src/backends/network-proxy.mjs +55 -0
  282. package/server/src/backends/provider-presets.mjs +45 -0
  283. package/server/src/backends/providers.mjs +132 -0
  284. package/server/src/backends/storage.mjs +35 -0
  285. package/server/src/bridge/conversation-policy.mjs +29 -0
  286. package/server/src/bridge/file-operations.mjs +47 -0
  287. package/server/src/bridge/product-methods.mjs +66 -0
  288. package/server/src/compaction.mjs +82 -0
  289. package/server/src/config.mjs +57 -0
  290. package/server/src/file-content.mjs +99 -0
  291. package/server/src/file-undo.mjs +142 -0
  292. package/server/src/http/router.mjs +80 -0
  293. package/server/src/http/static.mjs +62 -0
  294. package/server/src/product-config.mjs +80 -0
  295. package/server/src/project-models.mjs +59 -0
  296. package/server/src/rpc-transport.mjs +21 -0
  297. package/server/src/server.mjs +20 -0
  298. package/server/src/summary-translation.mjs +82 -0
  299. package/server/src/system-auth.mjs +45 -0
  300. package/server/src/thread-folders.mjs +76 -0
  301. package/server/src/thread-names.mjs +264 -0
  302. package/server/src/thread-projects.mjs +36 -0
  303. package/server/src/tls.mjs +87 -0
  304. package/server/src/version.mjs +55 -0
  305. package/server/src/web-config-migration.mjs +48 -0
  306. package/server/src/workspace/commands.mjs +33 -0
  307. package/server/src/workspace/files.mjs +44 -0
  308. package/server/src/workspace/service.mjs +27 -0
  309. package/server/src/workspace/terminals.mjs +122 -0
  310. package/shared/backend-activity.mjs +13 -0
  311. package/shared/backend-capabilities.mjs +33 -0
  312. package/shared/backend-identity.mjs +17 -0
  313. package/shared/compaction-state.mjs +49 -0
  314. package/shared/file-types.mjs +82 -0
  315. package/shared/product-contract.mjs +26 -0
  316. package/shared/rpc-limits.mjs +2 -0
  317. package/shared/terminal-workspace.mjs +26 -0
package/README.md CHANGED
@@ -1,3 +1,129 @@
1
- # Temporary Holding Version
1
+ <p align="center">
2
+ <img src="client/src/assets/claudex-web.svg" width="88" height="88" alt="Claudex Web 图标">
3
+ </p>
2
4
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
5
+ <h1 align="center">Claudex Web</h1>
6
+
7
+ <p align="center">
8
+ <strong>在浏览器中,继续你的 Codex 与 Claude Code 工作。</strong><br>
9
+ 从电脑到手机和平板,随时查看对话、审阅计划并批准执行、跟进任务、掌握账户额度、阅读文件与变更。
10
+ </p>
11
+
12
+ <p align="center">
13
+ <a href="#快速开始">快速开始</a> ·
14
+ <a href="docs/deployment.md">部署指南</a> ·
15
+ <a href="https://github.com/hjd-hitsz/claudex-web/releases">版本更新</a>
16
+ </p>
17
+
18
+ <picture>
19
+ <source media="(prefers-color-scheme: dark)" srcset="docs/images/desktop-dark.png">
20
+ <img src="docs/images/desktop-light.png" alt="Claudex Web 桌面界面:项目列表、账户额度圆环、任务对话、文件变更汇总与 Markdown 文件预览" width="1440">
21
+ </picture>
22
+
23
+ <p align="center"><sub>桌面界面 · 演示数据</sub></p>
24
+
25
+ <details>
26
+ <summary>查看手机界面</summary>
27
+
28
+ <p align="center">
29
+ <img src="docs/images/mobile.png" alt="Claudex Web 手机界面:任务对话、文件变更汇总与消息输入框" width="320">
30
+ <img src="docs/images/mobile-sidebar.png" alt="Claudex Web 手机侧栏:项目对话列表与账户额度圆环" width="320">
31
+ </p>
32
+
33
+ </details>
34
+
35
+ Claudex Web 提供 Codex 与 Claude Code 双后端:现有 ChatGPT 模型继续使用 Codex,其他供应商的模型通过 Claude Code 使用。输入区统一选择模型,Claude 对话可在空闲时切换供应商继续。配置方法见[部署指南](docs/deployment.md#claude-code-与模型配置)。
36
+
37
+ ## 快速开始
38
+
39
+ 稳定版 [v4.0.1](https://github.com/hjd-hitsz/claudex-web/releases/tag/v4.0.1):
40
+
41
+ ```bash
42
+ npm install -g @hjd-hitsz/claudex-web
43
+ ```
44
+
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,然后启动服务:
50
+
51
+ ```bash
52
+ npm install -g @hjd-hitsz/claudex-web
53
+ claudex-web service install
54
+ claudex-web service status
55
+ ```
56
+
57
+ npm 全局命令所在目录需在 `PATH` 中。安装完成后,网页服务会自动启动,已有 Codex 配置继续保留。
58
+
59
+ ### 2. 打开浏览器
60
+
61
+ - 本机访问:`https://127.0.0.1:8766`。
62
+ - 同一网络的电脑、手机或平板:`https://电脑IP:8766`,将“电脑IP”替换为服务所在电脑的实际 IP,并允许防火墙访问 `8766` 端口。
63
+
64
+ 网页登录使用运行服务的系统用户名与密码,登录成功后沿用该电脑的 Codex 授权,任务以服务用户的完全访问权限执行。登录状态默认保留 30 天,刷新或重新打开浏览器会恢复有效登录。
65
+
66
+ 首次访问时,浏览器可能提示证书不受信任。请按[证书安装指引](docs/deployment.md#证书配置)完成配置;登录页的“浏览器证书安装”提供证书下载和各设备的安装步骤。
67
+
68
+ 输入消息后,按 **Ctrl+Enter** 发送,**Enter** 换行。
69
+
70
+ 对话完成通知默认开启。首次使用时在“设置 → 通知”允许系统通知并授权;任务成功完成后,通知显示对话标题,点击即可返回对应对话。权限被阻止或环境不支持时,设置页会显示对应状态。
71
+
72
+ <details>
73
+ <summary>开机启动与退出系统登录后继续运行</summary>
74
+
75
+ 需要开机自动启动、退出系统登录后继续运行时,执行:
76
+
77
+ ```bash
78
+ loginctl enable-linger "$USER"
79
+ ```
80
+
81
+ 该命令可能需要管理员授权。
82
+
83
+ </details>
84
+
85
+ 前台运行、本地安装包的安装与下载校验见[部署与维护](docs/deployment.md)。
86
+
87
+ ## 按需配置
88
+
89
+ 执行以下命令可创建用户配置并显示其位置,已有配置会保留:
90
+
91
+ ```bash
92
+ claudex-web config init
93
+ ```
94
+
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`:首次使用时的默认工作目录,未设置时使用当前用户的主目录。
102
+
103
+ 修改配置前先结束当前任务和网页终端,保存后执行 `claudex-web service restart`;前台运行时重新启动网页进程。端口变更后使用新端口访问。完整配置见[部署与维护](docs/deployment.md#配置)。
104
+
105
+ ## 升级
106
+
107
+ 升级时,从目标版本的 Release 获取安装地址。当前版本的安装与服务更新命令为:
108
+
109
+ ```bash
110
+ npm install -g @hjd-hitsz/claudex-web
111
+ claudex-web service install
112
+ claudex-web service restart-when-idle
113
+ ```
114
+
115
+ 最后一个命令会等待当前任务和上下文整理结束后再重启,等待期间保持命令运行。升级后刷新网页,在“设置 → 关于”查看版本。
116
+
117
+ ## 更多文档
118
+
119
+ - [部署与维护](docs/deployment.md):完整配置、服务管理、回退和故障排查。
120
+ - [数据保存与迁移](docs/deployment.md#数据保存与迁移):数据位置、摘要翻译与模型用量说明。
121
+ - [开发者指南](docs/development.md):从源码运行、参与开发和验证修改。
122
+ - [架构设计](docs/architecture.md):模块边界、状态与请求流程、代码规模约束和扩展方式。
123
+ - [变更日志](CHANGELOG.md):各版本的新增功能、改进与修复。
124
+
125
+ ## 许可证
126
+
127
+ Copyright (C) 2026 Claudex Web contributors.
128
+
129
+ Claudex Web 采用 [GNU General Public License v3.0](LICENSE)(SPDX:`GPL-3.0-only`)发布。你可以按 GNU GPL 第 3 版的条款使用、复制、修改和分发本项目。担保与责任限制见许可证正文,第三方依赖沿用各自的许可证。
@@ -0,0 +1,129 @@
1
+ #!/usr/bin/env node
2
+ // Claudex Web 命令入口,配置与运行时数据独立于 npm 安装目录。
3
+ import { execFileSync } from "node:child_process";
4
+ import { constants } from "node:fs";
5
+ import { copyFile, mkdir } from "node:fs/promises";
6
+ import { join } from "node:path";
7
+ import { loadEnvFile } from "node:process";
8
+ import { fileURLToPath } from "node:url";
9
+ import { readConfig } from "../server/src/config.mjs";
10
+ import { readVersion } from "../server/src/version.mjs";
11
+
12
+ import {
13
+ productDirectories,
14
+ migrateProductConfig,
15
+ } from "../server/src/product-config.mjs";
16
+
17
+ const root = fileURLToPath(new URL("../", import.meta.url));
18
+ const directories = productDirectories();
19
+ const { configDir } = directories;
20
+ const args = process.argv.slice(2);
21
+ const command = args.join(" ") || "start";
22
+
23
+ async function main() {
24
+ if (["--help", "-h", "help"].includes(command)) {
25
+ console.log(`Claudex Web — Codex 与 Claude Code 的浏览器客户端
26
+
27
+ 用法:claudex-web [命令]
28
+ start 前台启动网页服务(默认命令)
29
+ backend 前台启动 Codex app-server
30
+ config init 创建用户配置,保留已有配置
31
+ service install 安装并启动 Linux systemd 用户服务
32
+ service status 查看网页与后端服务状态
33
+ service start 启动网页服务及其 Codex 后端
34
+ service stop 停止网页服务
35
+ service restart 重启网页服务
36
+ service restart-when-idle 等待任务与上下文整理结束后重启网页服务
37
+ --version 显示版本与开发构建标识
38
+ version --json 显示完整版本、提交和构建信息
39
+
40
+ 配置目录:${configDir}
41
+ 可用 CLAUDEX_WEB_CONFIG_DIR 指定配置目录。
42
+ 安装 npm 包后执行 claudex-web service install 可启用后台访问。`);
43
+ return;
44
+ }
45
+ if (["--version", "-v"].includes(command)) {
46
+ console.log(readVersion().displayVersion);
47
+ return;
48
+ }
49
+ if (command === "version --json") {
50
+ console.log(JSON.stringify(readVersion(), null, 2));
51
+ return;
52
+ }
53
+ if (
54
+ ![
55
+ "start",
56
+ "backend",
57
+ "config init",
58
+ "service install",
59
+ "service status",
60
+ "service start",
61
+ "service stop",
62
+ "service restart",
63
+ "service restart-when-idle",
64
+ ].includes(command)
65
+ )
66
+ throw new Error(`未知命令:${command}。使用 claudex-web --help 查看用法。`);
67
+ if (command.startsWith("service ") && process.platform !== "linux")
68
+ throw new Error("后台服务管理需要 Linux 和 systemd 用户服务。");
69
+
70
+ await migrateProductConfig(directories);
71
+ await mkdir(configDir, { recursive: true, mode: 0o700 });
72
+ if (["config init", "service install"].includes(command)) {
73
+ try {
74
+ await copyFile(
75
+ join(root, ".env.example"),
76
+ join(configDir, ".env"),
77
+ constants.COPYFILE_EXCL,
78
+ );
79
+ } catch (error) {
80
+ if (error.code !== "EEXIST") throw error;
81
+ }
82
+ }
83
+ process.env.CLAUDEX_WEB_CONFIG_DIR = configDir;
84
+ process.chdir(configDir);
85
+ try {
86
+ loadEnvFile(join(configDir, ".env"));
87
+ } catch (error) {
88
+ if (error.code !== "ENOENT") throw error;
89
+ }
90
+ switch (command) {
91
+ case "config init":
92
+ console.log(`用户配置:${join(configDir, ".env")}`);
93
+ break;
94
+ case "start":
95
+ await import("../server/src/server.mjs");
96
+ break;
97
+ case "backend":
98
+ await import("../scripts/start-backend.mjs");
99
+ break;
100
+ case "service install": {
101
+ const { installServices } =
102
+ await import("../scripts/install-services.mjs");
103
+ await installServices({ configDir, cli: true });
104
+ console.log('开机运行用户服务:loginctl enable-linger "$USER"');
105
+ const config = readConfig();
106
+ console.log(
107
+ `HTTPS 健康检查:https://127.0.0.1:${config.port}/healthz;证书:${config.tlsCert || join(config.configDir, "tls", "certificate.pem")}`,
108
+ );
109
+ break;
110
+ }
111
+ case "service restart-when-idle":
112
+ await import("../scripts/restart-when-idle.mjs");
113
+ break;
114
+ default: {
115
+ const action = args[1];
116
+ const units = ["claudex-web.service"];
117
+ if (action === "status")
118
+ units.push("codex-app-server.service", "--no-pager");
119
+ execFileSync("systemctl", ["--user", action, ...units], {
120
+ stdio: "inherit",
121
+ });
122
+ }
123
+ }
124
+ }
125
+
126
+ main().catch((error) => {
127
+ console.error(error.message);
128
+ process.exitCode = typeof error.status === "number" ? error.status || 1 : 1;
129
+ });
@@ -0,0 +1,8 @@
1
+ {
2
+ "version": "4.0.1",
3
+ "displayVersion": "4.0.1",
4
+ "revision": "62fad388f6db048bd6b92a2dc2e7259af064a6dd",
5
+ "dirty": false,
6
+ "channel": "release",
7
+ "builtAt": "2026-11-10T04:46:06.339Z"
8
+ }
@@ -0,0 +1 @@
1
+ import{i as U,a as l,d as P,e as O,b as S,c as E,f as F,g as $,h as K,o as q,j as G,k as D,r as H,U as b,l as R,m as W,n as w,p as J,q as x,s as Q,t as V,S as X}from"./isArrayLikeObject.js";var Y=/\s/;function Z(r){for(var n=r.length;n--&&Y.test(r.charAt(n)););return n}var z=/^\s+/;function j(r){return r&&r.slice(0,Z(r)+1).replace(z,"")}var I=NaN,k=/^[-+]0x[0-9a-f]+$/i,rr=/^0b[01]+$/i,nr=/^0o[0-7]+$/i,er=parseInt;function Sr(r){if(typeof r=="number")return r;if(U(r))return I;if(l(r)){var n=typeof r.valueOf=="function"?r.valueOf():r;r=l(n)?n+"":n}if(typeof r!="string")return r===0?r:+r;r=j(r);var e=rr.test(r);return e||nr.test(r)?er(r.slice(2),e?2:8):k.test(r)?I:+r}var A=Object.create,tr=(function(){function r(){}return function(n){if(!l(n))return{};if(A)return A(n);r.prototype=n;var e=new r;return r.prototype=void 0,e}})();function ir(r,n){var e=-1,t=r.length;for(n||(n=Array(t));++e<t;)n[e]=r[e];return n}function h(r,n,e){n=="__proto__"&&P?P(r,n,{configurable:!0,enumerable:!0,value:e,writable:!0}):r[n]=e}var fr=Object.prototype,ar=fr.hasOwnProperty;function sr(r,n,e){var t=r[n];(!(ar.call(r,n)&&O(t,e))||e===void 0&&!(n in r))&&h(r,n,e)}function or(r,n,e,t){var s=!e;e||(e={});for(var a=-1,o=n.length;++a<o;){var i=n[a],f=void 0;f===void 0&&(f=r[i]),s?h(e,i,f):sr(e,i,f)}return e}function ur(r,n,e){if(!l(e))return!1;var t=typeof n;return(t=="number"?S(e)&&E(n,e.length):t=="string"&&n in e)?O(e[n],r):!1}function $r(r){return F(function(n,e){var t=-1,s=e.length,a=s>1?e[s-1]:void 0,o=s>2?e[2]:void 0;for(a=r.length>3&&typeof a=="function"?(s--,a):void 0,o&&ur(e[0],e[1],o)&&(a=s<3?void 0:a,s=1),n=Object(n);++t<s;){var i=e[t];i&&r(n,i,t,a)}return n})}function lr(r){var n=[];if(r!=null)for(var e in Object(r))n.push(e);return n}var cr=Object.prototype,pr=cr.hasOwnProperty;function dr(r){if(!l(r))return lr(r);var n=$(r),e=[];for(var t in r)t=="constructor"&&(n||!pr.call(r,t))||e.push(t);return e}function L(r){return S(r)?K(r,!0):dr(r)}var B=q(Object.getPrototypeOf,Object),gr="[object Object]",vr=Function.prototype,Or=Object.prototype,M=vr.toString,hr=Or.hasOwnProperty,mr=M.call(Object);function yr(r){if(!G(r)||D(r)!=gr)return!1;var n=B(r);if(n===null)return!0;var e=hr.call(n,"constructor")&&n.constructor;return typeof e=="function"&&e instanceof e&&M.call(e)==mr}var N=typeof exports=="object"&&exports&&!exports.nodeType&&exports,T=N&&typeof module=="object"&&module&&!module.nodeType&&module,Pr=T&&T.exports===N,_=Pr?H.Buffer:void 0,C=_?_.allocUnsafe:void 0;function br(r,n){if(n)return r.slice();var e=r.length,t=C?C(e):new r.constructor(e);return r.copy(t),t}function wr(r){var n=new r.constructor(r.byteLength);return new b(n).set(new b(r)),n}function xr(r,n){var e=n?wr(r.buffer):r.buffer;return new r.constructor(e,r.byteOffset,r.length)}function Ir(r){return typeof r.constructor=="function"&&!$(r)?tr(B(r)):{}}function g(r,n,e){(e!==void 0&&!O(r[n],e)||e===void 0&&!(n in r))&&h(r,n,e)}function v(r,n){if(!(n==="constructor"&&typeof r[n]=="function")&&n!="__proto__")return r[n]}function Ar(r){return or(r,L(r))}function Tr(r,n,e,t,s,a,o){var i=v(r,e),f=v(n,e),m=o.get(f);if(m){g(r,e,m);return}var u=a?a(i,f,e+"",r,n,o):void 0,c=u===void 0;if(c){var p=w(f),d=!p&&R(f),y=!p&&!d&&W(f);u=f,p||d||y?w(i)?u=i:J(i)?u=ir(i):d?(c=!1,u=br(f,!0)):y?(c=!1,u=xr(f,!0)):u=[]:yr(f)||x(f)?(u=i,x(i)?u=Ar(i):(!l(i)||Q(i))&&(u=Ir(f))):c=!1}c&&(o.set(f,u),s(u,f,t,a,o),o.delete(f)),g(r,e,u)}function _r(r,n,e,t,s){r!==n&&V(n,function(a,o){if(s||(s=new X),l(a))Tr(r,n,o,e,_r,t,s);else{var i=t?t(v(r,o),a,o+"",r,n,s):void 0;i===void 0&&(i=a),g(r,o,i)}},L)}export{xr as a,br as b,wr as c,sr as d,ur as e,h as f,$r as g,_r as h,Ir as i,L as k,Sr as t};
@@ -0,0 +1 @@
1
+ import{g as p,r as u,d as a}from"./chunk-2E7WHVMD.js";import{p as f}from"./chunk-JWPE2WC7.js";import{_ as n,l as o}from"./mermaid.core.js";import{M as c,b as d}from"./cynefin-EF2NZ3EQ.js";import"./app.js";import"./purify.es.js";var v=d().RailroadAbnf.parser.LangiumParser,i=n(e=>{const r=e.alternatives.map(g);return r.length===1?r[0]:{type:"choice",alternatives:r}},"transformAlternation"),g=n(e=>{const r=e.elements.map(y);return r.length===1?r[0]:{type:"sequence",elements:r}},"transformConcatenation"),b=n(e=>{if(e.includes("*")){const[t,s]=e.split("*"),l=t?parseInt(t,10):0,m=s?parseInt(s,10):1/0;return{min:l,max:m}}const r=parseInt(e,10);return{min:r,max:r}},"parseRepeat"),y=n(e=>{const r=A(e.primary);if(!e.repeat)return r;const{min:t,max:s}=b(e.repeat);return t===0&&s===1?{type:"optional",element:r}:{type:"repetition",element:r,min:t,max:s}},"transformElement"),A=n(e=>{switch(e.$type){case"AbnfStringLiteral":return{type:"terminal",value:e.value};case"AbnfNumVal":return{type:"terminal",value:e.value};case"AbnfRuleName":return{type:"nonterminal",name:e.name};case"AbnfGroup":return i(e.element);case"AbnfOptionalGroup":return{type:"optional",element:i(e.element)};default:throw new Error(`Unsupported ABNF primary node: ${e.$type}`)}},"transformPrimary"),P=n(e=>({name:e.name,definition:i(e.definition)}),"transformRule"),h=n(e=>{f(e,a),e.title&&a.setTitle(e.title),e.rules.map(r=>a.addRule(P(r)))},"populateDb"),R={parse:n(e=>{a.clear(),o.debug("[ABNF Parser] Starting Langium parse");const r=v.parse(e);if(r.lexerErrors.length>0||r.parserErrors.length>0)throw new c(r);const t=r.value;o.debug("[ABNF Parser] Parsed rules:",t.rules.length),h(t),o.debug("[ABNF Parser] Parse complete")},"parse"),parser:{yy:a}},F={parser:R,db:a,renderer:u,styles:p};export{F as diagram};
@@ -0,0 +1 @@
1
+ var l={"+":["conjugate","add"],"−":["negate","subtract"],"×":["signOf","multiply"],"÷":["reciprocal","divide"],"⌈":["ceiling","greaterOf"],"⌊":["floor","lesserOf"],"∣":["absolute","residue"],"⍳":["indexGenerate","indexOf"],"?":["roll","deal"],"⋆":["exponentiate","toThePowerOf"],"⍟":["naturalLog","logToTheBase"],"○":["piTimes","circularFuncs"],"!":["factorial","binomial"],"⌹":["matrixInverse","matrixDivide"],"<":[null,"lessThan"],"≤":[null,"lessThanOrEqual"],"=":[null,"equals"],">":[null,"greaterThan"],"≥":[null,"greaterThanOrEqual"],"≠":[null,"notEqual"],"≡":["depth","match"],"≢":[null,"notMatch"],"∈":["enlist","membership"],"⍷":[null,"find"],"∪":["unique","union"],"∩":[null,"intersection"],"∼":["not","without"],"∨":[null,"or"],"∧":[null,"and"],"⍱":[null,"nor"],"⍲":[null,"nand"],"⍴":["shapeOf","reshape"],",":["ravel","catenate"],"⍪":[null,"firstAxisCatenate"],"⌽":["reverse","rotate"],"⊖":["axis1Reverse","axis1Rotate"],"⍉":["transpose",null],"↑":["first","take"],"↓":[null,"drop"],"⊂":["enclose","partitionWithAxis"],"⊃":["diclose","pick"],"⌷":[null,"index"],"⍋":["gradeUp",null],"⍒":["gradeDown",null],"⊤":["encode",null],"⊥":["decode",null],"⍕":["format","formatByExample"],"⍎":["execute",null],"⊣":["stop","left"],"⊢":["pass","right"]},t=/[\.\/⌿⍀¨⍣]/,a=/⍬/,i=/[\+−×÷⌈⌊∣⍳\?⋆⍟○!⌹<≤=>≥≠≡≢∈⍷∪∩∼∨∧⍱⍲⍴,⍪⌽⊖⍉↑↓⊂⊃⌷⍋⍒⊤⊥⍕⍎⊣⊢]/,u=/←/,o=/[⍝#].*$/,s=function(r){var n;return n=!1,function(e){return n=e,e===r?n==="\\":!0}};const f={name:"apl",startState:function(){return{prev:!1,func:!1,op:!1,string:!1,escape:!1}},token:function(r,n){var e;return r.eatSpace()?null:(e=r.next(),e==='"'||e==="'"?(r.eatWhile(s(e)),r.next(),n.prev=!0,"string"):/[\[{\(]/.test(e)?(n.prev=!1,null):/[\]}\)]/.test(e)?(n.prev=!0,null):a.test(e)?(n.prev=!1,"atom"):/[¯\d]/.test(e)?(n.func?(n.func=!1,n.prev=!1):n.prev=!0,r.eatWhile(/[\w\.]/),"number"):t.test(e)||u.test(e)?"operator":i.test(e)?(n.func=!0,n.prev=!1,l[e]?"variableName.function.standard":"variableName.function"):o.test(e)?(r.skipToEnd(),"comment"):e==="∘"&&r.peek()==="."?(r.next(),"variableName.function"):(r.eatWhile(/[\w\$_]/),n.prev=!0,"keyword"))}};export{f as apl};