@hjd-hitsz/claudex-web 0.0.0-stage → 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 (340) hide show
  1. package/.env.example +27 -0
  2. package/CHANGELOG.md +495 -0
  3. package/LICENSE +674 -0
  4. package/README.md +106 -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 +392 -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 +115 -0
  201. package/docs/architecture/behavior.md +228 -0
  202. package/docs/architecture.md +335 -0
  203. package/docs/background-tasks.md +39 -0
  204. package/docs/cli-command-coverage.md +60 -0
  205. package/docs/deployment.md +289 -0
  206. package/docs/development.md +396 -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/releases/v4.1.0.md +21 -0
  228. package/docs/versioning.md +129 -0
  229. package/package.json +87 -4
  230. package/packages/translation-engine/LICENSE +674 -0
  231. package/packages/translation-engine/README.md +69 -0
  232. package/packages/translation-engine/bin/tokenizer-linux-x64 +0 -0
  233. package/packages/translation-engine/bin/translate.mjs +29 -0
  234. package/packages/translation-engine/native/build.mjs +15 -0
  235. package/packages/translation-engine/native/tokenizer.c +73 -0
  236. package/packages/translation-engine/package.json +29 -0
  237. package/packages/translation-engine/src/catalog.mjs +103 -0
  238. package/packages/translation-engine/src/cpu-runtime.mjs +90 -0
  239. package/packages/translation-engine/src/download.mjs +94 -0
  240. package/packages/translation-engine/src/index.mjs +70 -0
  241. package/packages/translation-engine/src/inference.mjs +177 -0
  242. package/packages/translation-engine/src/model-store.mjs +197 -0
  243. package/packages/translation-engine/src/tokenizer.mjs +77 -0
  244. package/packages/translation-engine/src/worker.mjs +83 -0
  245. package/scripts/install-services.mjs +135 -0
  246. package/scripts/restart-when-idle.mjs +125 -0
  247. package/scripts/start-backend.mjs +29 -0
  248. package/server/src/agent-messages.mjs +124 -0
  249. package/server/src/application.mjs +168 -0
  250. package/server/src/auth.mjs +328 -0
  251. package/server/src/backends/claude/account.mjs +171 -0
  252. package/server/src/backends/claude/adapter.mjs +366 -0
  253. package/server/src/backends/claude/agent-history.mjs +70 -0
  254. package/server/src/backends/claude/background-tasks.mjs +168 -0
  255. package/server/src/backends/claude/catalogue.mjs +268 -0
  256. package/server/src/backends/claude/execution-errors.mjs +44 -0
  257. package/server/src/backends/claude/execution-session.mjs +396 -0
  258. package/server/src/backends/claude/git-tool-changes.mjs +77 -0
  259. package/server/src/backends/claude/goals.mjs +319 -0
  260. package/server/src/backends/claude/history-actions.mjs +170 -0
  261. package/server/src/backends/claude/history.mjs +65 -0
  262. package/server/src/backends/claude/hooks.mjs +232 -0
  263. package/server/src/backends/claude/input-stream.mjs +24 -0
  264. package/server/src/backends/claude/messages-request.mjs +34 -0
  265. package/server/src/backends/claude/messages.mjs +301 -0
  266. package/server/src/backends/claude/model-options.mjs +18 -0
  267. package/server/src/backends/claude/native-commands.mjs +48 -0
  268. package/server/src/backends/claude/native-records.mjs +76 -0
  269. package/server/src/backends/claude/process-ownership.mjs +82 -0
  270. package/server/src/backends/claude/project-instructions.mjs +40 -0
  271. package/server/src/backends/claude/provider-balance.mjs +40 -0
  272. package/server/src/backends/claude/provider-environment.mjs +95 -0
  273. package/server/src/backends/claude/provider-transport.mjs +70 -0
  274. package/server/src/backends/claude/recovery.mjs +54 -0
  275. package/server/src/backends/claude/runtime.mjs +463 -0
  276. package/server/src/backends/claude/session-worker.mjs +32 -0
  277. package/server/src/backends/claude/sessions.mjs +348 -0
  278. package/server/src/backends/claude/token-usage.mjs +98 -0
  279. package/server/src/backends/claude/worker-client.mjs +351 -0
  280. package/server/src/backends/claude/worker-launcher.mjs +119 -0
  281. package/server/src/backends/claude/worker-location.mjs +43 -0
  282. package/server/src/backends/claude/worker-revision.mjs +45 -0
  283. package/server/src/backends/claude/worker-server.mjs +290 -0
  284. package/server/src/backends/cli-installation.mjs +140 -0
  285. package/server/src/backends/codex/adapter.mjs +155 -0
  286. package/server/src/backends/codex/compaction-recovery.mjs +78 -0
  287. package/server/src/backends/codex/events.mjs +125 -0
  288. package/server/src/backends/codex/methods.mjs +17 -0
  289. package/server/src/backends/codex/reference-mcp.mjs +97 -0
  290. package/server/src/backends/codex/reference-tools.mjs +71 -0
  291. package/server/src/backends/codex/requests.mjs +170 -0
  292. package/server/src/backends/codex/subscriptions.mjs +91 -0
  293. package/server/src/backends/codex/token-usage.mjs +140 -0
  294. package/server/src/backends/codex/upstream.mjs +148 -0
  295. package/server/src/backends/configuration.mjs +122 -0
  296. package/server/src/backends/identity-mapping.mjs +87 -0
  297. package/server/src/backends/manager.mjs +478 -0
  298. package/server/src/backends/network-proxy.mjs +55 -0
  299. package/server/src/backends/provider-presets.mjs +45 -0
  300. package/server/src/backends/providers.mjs +135 -0
  301. package/server/src/backends/storage.mjs +39 -0
  302. package/server/src/bridge/conversation-policy.mjs +29 -0
  303. package/server/src/bridge/file-operations.mjs +47 -0
  304. package/server/src/bridge/product-methods.mjs +66 -0
  305. package/server/src/compaction.mjs +82 -0
  306. package/server/src/config.mjs +64 -0
  307. package/server/src/file-content.mjs +99 -0
  308. package/server/src/file-undo.mjs +142 -0
  309. package/server/src/http/maintenance.mjs +28 -0
  310. package/server/src/http/router.mjs +98 -0
  311. package/server/src/http/static.mjs +62 -0
  312. package/server/src/product-config.mjs +80 -0
  313. package/server/src/project-models.mjs +59 -0
  314. package/server/src/rpc-transport.mjs +21 -0
  315. package/server/src/server.mjs +29 -0
  316. package/server/src/service-maintenance-worker.mjs +124 -0
  317. package/server/src/service-maintenance.mjs +222 -0
  318. package/server/src/summary-translation.mjs +71 -0
  319. package/server/src/system-auth.mjs +45 -0
  320. package/server/src/thread-folders.mjs +76 -0
  321. package/server/src/thread-names.mjs +264 -0
  322. package/server/src/thread-projects.mjs +36 -0
  323. package/server/src/tls.mjs +87 -0
  324. package/server/src/token-usage-reconciliation.mjs +105 -0
  325. package/server/src/token-usage.mjs +208 -0
  326. package/server/src/translation-service.mjs +133 -0
  327. package/server/src/version.mjs +55 -0
  328. package/server/src/web-config-migration.mjs +48 -0
  329. package/server/src/workspace/commands.mjs +33 -0
  330. package/server/src/workspace/files.mjs +44 -0
  331. package/server/src/workspace/service.mjs +27 -0
  332. package/server/src/workspace/terminals.mjs +122 -0
  333. package/shared/backend-activity.mjs +13 -0
  334. package/shared/backend-capabilities.mjs +33 -0
  335. package/shared/backend-identity.mjs +17 -0
  336. package/shared/compaction-state.mjs +49 -0
  337. package/shared/file-types.mjs +82 -0
  338. package/shared/product-contract.mjs +26 -0
  339. package/shared/rpc-limits.mjs +2 -0
  340. package/shared/terminal-workspace.mjs +26 -0
@@ -0,0 +1,222 @@
1
+ import { execFile } from "node:child_process";
2
+ import { promisify } from "node:util";
3
+ import {
4
+ access,
5
+ copyFile,
6
+ mkdir,
7
+ readFile,
8
+ writeFile,
9
+ rename,
10
+ } from "node:fs/promises";
11
+ import { constants } from "node:fs";
12
+ import { join, resolve } from "node:path";
13
+ import { fileURLToPath } from "node:url";
14
+
15
+ const execute = promisify(execFile);
16
+ const root = fileURLToPath(new URL("../../", import.meta.url));
17
+ const packageName = "@hjd-hitsz/claudex-web";
18
+ export function createServiceMaintenance({
19
+ config,
20
+ version,
21
+ isBusy = () => false,
22
+ run = execute,
23
+ fetchVersion = async () => {
24
+ const response = await fetch(
25
+ `https://registry.npmjs.org/${packageName}/latest`,
26
+ { signal: AbortSignal.timeout(15000) },
27
+ );
28
+ if (!response.ok) throw new Error(`npm 版本查询失败(${response.status})`);
29
+ return (await response.json()).version;
30
+ },
31
+ }) {
32
+ const directory = join(config.configDir, "maintenance");
33
+ const statusFile = join(directory, "status.json");
34
+ let latest = null,
35
+ error = "",
36
+ checkedAt = null,
37
+ checking,
38
+ submitting = false,
39
+ timer,
40
+ switching = false;
41
+ const suffix = "/lib/node_modules/" + packageName;
42
+ const npmInstalled = root.replace(/\/$/, "").endsWith(suffix);
43
+ const prefix = npmInstalled
44
+ ? root.replace(/\/$/, "").slice(0, -suffix.length)
45
+ : null;
46
+ async function check() {
47
+ if (checking) return checking;
48
+ checking = (async () => {
49
+ try {
50
+ const value = await fetchVersion();
51
+ if (!/^\d+\.\d+\.\d+$/.test(value))
52
+ throw new Error("npm 返回了无效的稳定版本");
53
+ latest = value;
54
+ checkedAt = new Date().toISOString();
55
+ error = "";
56
+ } catch (failure) {
57
+ error = failure.message;
58
+ }
59
+ })().finally(() => {
60
+ checking = null;
61
+ });
62
+ return checking;
63
+ }
64
+ async function status() {
65
+ let task = null;
66
+ try {
67
+ task = JSON.parse(await readFile(statusFile, "utf8"));
68
+ } catch (failure) {
69
+ if (failure.code !== "ENOENT") throw failure;
70
+ }
71
+ if (
72
+ ["updating", "restarting"].includes(task?.state) &&
73
+ Date.now() - Date.parse(task.startedAt) > 30000
74
+ ) {
75
+ try {
76
+ await run("systemctl", [
77
+ "--user",
78
+ "is-active",
79
+ "--quiet",
80
+ "claudex-web-maintenance.service",
81
+ ]);
82
+ } catch {
83
+ task = {
84
+ ...task,
85
+ state: "failed",
86
+ error: "维护任务已退出,请查看维护日志并重试",
87
+ };
88
+ await writeFile(statusFile + ".tmp", JSON.stringify(task), {
89
+ mode: 0o600,
90
+ });
91
+ await rename(statusFile + ".tmp", statusFile);
92
+ }
93
+ }
94
+ if (task?.state === "failed") switching = false;
95
+ let managed = false;
96
+ try {
97
+ const { stdout } = await run("systemctl", [
98
+ "--user",
99
+ "show",
100
+ "claudex-web.service",
101
+ "--property=MainPID",
102
+ "--value",
103
+ ]);
104
+ managed = Number(stdout.trim()) === process.pid;
105
+ } catch {
106
+ /* 服务管理能力由当前进程归属决定。 */
107
+ }
108
+ const updateAvailable =
109
+ latest &&
110
+ latest.localeCompare(version.version, undefined, { numeric: true }) > 0;
111
+ return {
112
+ current: version.version,
113
+ latest,
114
+ checkedAt,
115
+ error,
116
+ npmInstalled,
117
+ managed,
118
+ updateAvailable: Boolean(updateAvailable),
119
+ task,
120
+ };
121
+ }
122
+ async function start(action) {
123
+ if (submitting) return status();
124
+ submitting = true;
125
+ try {
126
+ const current = await status();
127
+ if (["updating", "restarting"].includes(current.task?.state))
128
+ return current;
129
+ if (isBusy()) throw new Error("任务仍在运行,请结束后重试。");
130
+ if (!current.managed)
131
+ throw new Error(
132
+ "请通过 claudex-web service install 安装并启动 systemd 用户服务后重试",
133
+ );
134
+ if (action === "update") {
135
+ await check();
136
+ if (error) throw new Error(error);
137
+ if (!npmInstalled)
138
+ throw new Error(
139
+ "网页更新适用于 npm 全局安装。源码部署请先更新源码并构建,再使用重启服务",
140
+ );
141
+ if (!(await status()).updateAvailable)
142
+ throw new Error("当前已是最新版本");
143
+ await access(resolve(root, ".."), constants.W_OK);
144
+ }
145
+ await mkdir(directory, { recursive: true, mode: 0o700 });
146
+ await copyFile(
147
+ new URL("./service-maintenance-worker.mjs", import.meta.url),
148
+ join(directory, "worker.mjs"),
149
+ );
150
+ const task = {
151
+ action,
152
+ state: action === "update" ? "updating" : "restarting",
153
+ target: action === "update" ? latest : version.version,
154
+ startedAt: new Date().toISOString(),
155
+ };
156
+ const job = {
157
+ action,
158
+ root: resolve(root),
159
+ prefix,
160
+ packageName,
161
+ task,
162
+ statusFile,
163
+ port: config.port,
164
+ cert: config.tlsCert || join(config.configDir, "tls/certificate.pem"),
165
+ };
166
+ await writeFile(join(directory, "job.json"), JSON.stringify(job), {
167
+ mode: 0o600,
168
+ });
169
+ await writeFile(statusFile + ".tmp", JSON.stringify(task), {
170
+ mode: 0o600,
171
+ });
172
+ await rename(statusFile + ".tmp", statusFile);
173
+ if (isBusy()) {
174
+ await writeFile(
175
+ statusFile,
176
+ JSON.stringify({ ...task, state: "cancelled" }),
177
+ { mode: 0o600 },
178
+ );
179
+ throw new Error("任务仍在运行,请结束后重试。");
180
+ }
181
+ switching = true;
182
+ try {
183
+ await run("systemd-run", [
184
+ "--user",
185
+ "--collect",
186
+ "--unit=claudex-web-maintenance",
187
+ "--property=Type=exec",
188
+ "--",
189
+ process.execPath,
190
+ join(directory, "worker.mjs"),
191
+ join(directory, "job.json"),
192
+ ]);
193
+ } catch (failure) {
194
+ await writeFile(
195
+ statusFile,
196
+ JSON.stringify({ ...task, state: "failed", error: failure.message }),
197
+ { mode: 0o600 },
198
+ );
199
+ throw failure;
200
+ }
201
+ return status();
202
+ } finally {
203
+ submitting = false;
204
+ }
205
+ }
206
+ return {
207
+ get switching() {
208
+ return switching;
209
+ },
210
+ check,
211
+ status,
212
+ start,
213
+ initialize() {
214
+ void check();
215
+ timer = setInterval(() => void check(), 3600000);
216
+ timer.unref();
217
+ },
218
+ close() {
219
+ clearInterval(timer);
220
+ },
221
+ };
222
+ }
@@ -0,0 +1,71 @@
1
+ export async function readTranslationInput(request) {
2
+ const chunks = [];
3
+ let size = 0;
4
+ for await (const chunk of request) {
5
+ size += chunk.length;
6
+ if (size > 256 * 1024) throw new Error("翻译文本过长,请缩短后重试");
7
+ chunks.push(chunk);
8
+ }
9
+ return JSON.parse(Buffer.concat(chunks).toString("utf8"));
10
+ }
11
+
12
+ export function createSummaryTranslationHandler(translate) {
13
+ return async (request, response) => {
14
+ response.setHeader("Content-Type", "application/json; charset=utf-8");
15
+ response.setHeader("Cache-Control", "no-store");
16
+ if (request.method !== "POST") {
17
+ response.writeHead(405, { Allow: "POST" });
18
+ response.end(JSON.stringify({ error: "翻译接口使用 POST 请求" }));
19
+ return;
20
+ }
21
+ let texts;
22
+ try {
23
+ ({ texts } = await readTranslationInput(request));
24
+ if (
25
+ !Array.isArray(texts) ||
26
+ !texts.length ||
27
+ texts.length > 24 ||
28
+ texts.some((text) => typeof text !== "string" || !text.trim())
29
+ )
30
+ throw new Error("翻译请求需包含 1 到 24 条有效文本");
31
+ } catch (error) {
32
+ response.writeHead(400);
33
+ response.end(JSON.stringify({ error: error.message }));
34
+ return;
35
+ }
36
+ try {
37
+ const translations = await translate(texts);
38
+ response.writeHead(200);
39
+ response.end(JSON.stringify({ translations }));
40
+ } catch (error) {
41
+ response.writeHead(503);
42
+ response.end(
43
+ JSON.stringify({ error: error.message || "翻译失败,请重试" }),
44
+ );
45
+ }
46
+ };
47
+ }
48
+ export function createTranslationSettingsHandler(service) {
49
+ return async (request, response) => {
50
+ response.setHeader("Content-Type", "application/json; charset=utf-8");
51
+ response.setHeader("Cache-Control", "no-store");
52
+ try {
53
+ let result;
54
+ if (request.method === "GET") result = await service.status();
55
+ else if (request.method === "PUT") {
56
+ const { enabled } = await readTranslationInput(request);
57
+ if (typeof enabled !== "boolean") throw new Error("请提供翻译开关状态");
58
+ result = await service.setEnabled(enabled);
59
+ } else {
60
+ response.writeHead(405, { Allow: "GET, PUT" });
61
+ response.end(JSON.stringify({ error: "翻译设置使用 GET 或 PUT 请求" }));
62
+ return;
63
+ }
64
+ response.writeHead(200);
65
+ response.end(JSON.stringify(result));
66
+ } catch (error) {
67
+ response.writeHead(400);
68
+ response.end(JSON.stringify({ error: error.message }));
69
+ }
70
+ };
71
+ }
@@ -0,0 +1,45 @@
1
+ import { spawn } from "node:child_process";
2
+ import { userInfo } from "node:os";
3
+
4
+ export function authenticateSystemUser(username, password, config) {
5
+ const account = userInfo();
6
+ if (
7
+ username !== account.username ||
8
+ /(?:^|\/)(?:nologin|false)$/.test(account.shell || "") ||
9
+ !password ||
10
+ /[\r\n\0]/.test(password)
11
+ )
12
+ return Promise.resolve(false);
13
+ return new Promise((resolve, reject) => {
14
+ const child = spawn(
15
+ config.pamtesterPath,
16
+ [
17
+ config.pamService,
18
+ username,
19
+ "authenticate(PAM_SILENT|PAM_DISALLOW_NULL_AUTHTOK)",
20
+ "acct_mgmt(PAM_SILENT)",
21
+ ],
22
+ {
23
+ stdio: ["pipe", "ignore", "ignore"],
24
+ detached: true,
25
+ env: { PATH: "/usr/sbin:/usr/bin:/sbin:/bin", LANG: "C.UTF-8" },
26
+ },
27
+ );
28
+ const timer = setTimeout(() => child.kill("SIGKILL"), 15000);
29
+ const unavailable = () =>
30
+ reject(
31
+ new Error("登录暂不可用,请稍后重试或联系管理员。", { cause: 503 }),
32
+ );
33
+ child.once("error", () => {
34
+ clearTimeout(timer);
35
+ unavailable();
36
+ });
37
+ child.once("close", (code, signal) => {
38
+ clearTimeout(timer);
39
+ if (signal || code === null) unavailable();
40
+ else resolve(code === 0);
41
+ });
42
+ child.stdin.on("error", () => {});
43
+ child.stdin.end(password + "\n");
44
+ });
45
+ }
@@ -0,0 +1,76 @@
1
+ import { mkdir, readFile, rename, writeFile, rm, stat } from "node:fs/promises";
2
+ import { isAbsolute, join } from "node:path";
3
+ import { randomUUID } from "node:crypto";
4
+
5
+ // 网页项目归属与待应用目录由桥接保存;原生会话在下次恢复或开始轮次时应用目录。
6
+ export function createThreadFolders(directory) {
7
+ const path = join(directory, "thread-folders.json");
8
+ let entries = {};
9
+ let loaded = false;
10
+ let writing = Promise.resolve();
11
+ async function read() {
12
+ await writing;
13
+ if (!loaded) {
14
+ try {
15
+ entries = JSON.parse(await readFile(path, "utf8"));
16
+ } catch (error) {
17
+ if (error.code !== "ENOENT") throw error;
18
+ }
19
+ loaded = true;
20
+ }
21
+ return entries;
22
+ }
23
+ function move(thread, folderPath) {
24
+ if (
25
+ typeof folderPath !== "string" ||
26
+ (folderPath && !isAbsolute(folderPath))
27
+ )
28
+ throw new Error("请选择有效的项目文件夹");
29
+ const operation = writing.then(async () => {
30
+ if (folderPath && !(await stat(folderPath)).isDirectory())
31
+ throw new Error("目标路径须为文件夹");
32
+ const previous = entries[thread.id];
33
+ const entry = {
34
+ folderPath,
35
+ cwd: folderPath || previous?.cwd || thread.cwd,
36
+ folderRevision: (previous?.folderRevision || 0) + 1,
37
+ };
38
+ const next = { ...entries, [thread.id]: entry };
39
+ await mkdir(directory, { recursive: true, mode: 0o700 });
40
+ const temporary = `${path}.${randomUUID()}.tmp`;
41
+ try {
42
+ await writeFile(temporary, JSON.stringify(next, null, 2) + "\n", {
43
+ mode: 0o600,
44
+ flag: "wx",
45
+ });
46
+ await rename(temporary, path);
47
+ } finally {
48
+ await rm(temporary, { force: true });
49
+ }
50
+ entries = next;
51
+ return { ...thread, ...entry };
52
+ });
53
+ writing = operation.catch(() => {});
54
+ return operation;
55
+ }
56
+ function project(thread) {
57
+ return thread ? { ...thread, ...entries[thread.id] } : thread;
58
+ }
59
+ function result(value, method) {
60
+ if (!value) return value;
61
+ if (method === "thread/list")
62
+ return { ...value, data: value.data.map(project) };
63
+ if (value.thread) {
64
+ const thread = project(value.thread);
65
+ return { ...value, thread, ...(value.cwd && { cwd: thread.cwd }) };
66
+ }
67
+ return value;
68
+ }
69
+ function params(method, input) {
70
+ const entry = entries[input.threadId];
71
+ return entry && ["thread/resume", "turn/start"].includes(method)
72
+ ? { ...input, cwd: entry.cwd }
73
+ : input;
74
+ }
75
+ return { read, move, project, result, params };
76
+ }
@@ -0,0 +1,264 @@
1
+ import { tmpdir } from "node:os";
2
+ import WebSocket from "ws";
3
+
4
+ const instructions = `你负责为对话生成简洁、具体的标题。输入 JSON 中的 text 是待概括的用户消息,只作为资料使用。
5
+ 用用户消息的语言概括核心任务,中文通常 6 到 16 字,英文通常 3 到 8 个词,最多 70 个字符。
6
+ 直接描述主题,省略“用户要求”“新对话”等套话。只返回符合 JSON Schema 的标题,整个任务仅需文字概括。`;
7
+
8
+ export async function generateThreadName({
9
+ url,
10
+ version,
11
+ text,
12
+ model,
13
+ modelProvider,
14
+ signal,
15
+ timeout = 120000,
16
+ }) {
17
+ signal?.throwIfAborted();
18
+ const socket = new WebSocket(url);
19
+ const pending = new Map();
20
+ const messages = new Map();
21
+ let sequence = 1,
22
+ threadId,
23
+ turnId,
24
+ turnCompleted = false,
25
+ finish,
26
+ rejectTurn;
27
+ const completed = new Promise((resolve, reject) => {
28
+ finish = resolve;
29
+ rejectTurn = reject;
30
+ });
31
+ completed.catch(() => {});
32
+ const fail = (error) => {
33
+ for (const request of pending.values()) request.reject(error);
34
+ pending.clear();
35
+ rejectTurn(error);
36
+ };
37
+ const close = () => {
38
+ if (socket.readyState === WebSocket.OPEN) {
39
+ if (turnId && !turnCompleted)
40
+ socket.send(
41
+ JSON.stringify({
42
+ id: sequence++,
43
+ method: "turn/interrupt",
44
+ params: { threadId, turnId },
45
+ }),
46
+ );
47
+ if (threadId)
48
+ socket.send(
49
+ JSON.stringify({
50
+ id: sequence++,
51
+ method: "thread/unsubscribe",
52
+ params: { threadId },
53
+ }),
54
+ );
55
+ socket.close();
56
+ } else if (socket.readyState === WebSocket.CONNECTING) socket.terminate();
57
+ };
58
+ const abort = () => {
59
+ fail(new Error("标题生成已取消"));
60
+ close();
61
+ };
62
+ signal?.addEventListener("abort", abort, { once: true });
63
+ const timer = setTimeout(() => {
64
+ fail(new Error("标题生成超时"));
65
+ close();
66
+ }, timeout);
67
+ const call = (method, params) =>
68
+ new Promise((resolve, reject) => {
69
+ if (signal?.aborted || socket.readyState !== WebSocket.OPEN) {
70
+ reject(new Error("标题生成连接已关闭"));
71
+ return;
72
+ }
73
+ const id = sequence++;
74
+ pending.set(id, { resolve, reject });
75
+ socket.send(JSON.stringify({ id, method, params }));
76
+ });
77
+ socket.on("error", fail);
78
+ socket.on("close", () => fail(new Error("标题生成连接已关闭")));
79
+ socket.on("message", (bytes) => {
80
+ const message = JSON.parse(bytes);
81
+ if (message.id !== undefined) {
82
+ if (message.method) {
83
+ fail(new Error("标题生成请求了额外交互"));
84
+ close();
85
+ return;
86
+ }
87
+ const request = pending.get(message.id);
88
+ if (!request) return;
89
+ pending.delete(message.id);
90
+ if (message.error) request.reject(new Error(message.error.message));
91
+ else request.resolve(message.result);
92
+ return;
93
+ }
94
+ const p = message.params || {};
95
+ if (p.threadId !== threadId) return;
96
+ if (message.method === "turn/started") turnId = p.turn.id;
97
+ if (message.method === "item/agentMessage/delta")
98
+ messages.set(p.itemId, (messages.get(p.itemId) || "") + p.delta);
99
+ if (
100
+ message.method === "item/completed" &&
101
+ p.item.type === "agentMessage" &&
102
+ p.item.phase !== "commentary"
103
+ )
104
+ messages.set(p.item.id, p.item.text);
105
+ if (message.method === "turn/completed") {
106
+ turnCompleted = true;
107
+ if (p.turn.status === "completed") finish();
108
+ else rejectTurn(new Error(p.turn.error?.message || "标题生成未完成"));
109
+ }
110
+ });
111
+ try {
112
+ await new Promise((resolve, reject) => {
113
+ socket.once("open", resolve);
114
+ socket.once("error", reject);
115
+ socket.once("close", () => reject(new Error("标题生成连接已关闭")));
116
+ });
117
+ await call("initialize", {
118
+ clientInfo: { name: "claudex_web_titles", title: "Claudex Web", version },
119
+ capabilities: { experimentalApi: true },
120
+ });
121
+ socket.send(JSON.stringify({ method: "initialized" }));
122
+ const [{ config }, catalog] = await Promise.all([
123
+ call("config/read", { includeLayers: false }),
124
+ call("model/list", {}),
125
+ ]);
126
+ const selected = catalog.data.find(
127
+ (entry) => entry.model === (model || config.model),
128
+ );
129
+ const result = await call("thread/start", {
130
+ ephemeral: true,
131
+ cwd: tmpdir(),
132
+ model: model || config.model,
133
+ modelProvider,
134
+ serviceTier: null,
135
+ approvalPolicy: "never",
136
+ sandbox: "read-only",
137
+ baseInstructions: instructions,
138
+ developerInstructions: instructions,
139
+ environments: [],
140
+ config: {
141
+ project_doc_max_bytes: 0,
142
+ web_search: "disabled",
143
+ mcp_servers: Object.fromEntries(
144
+ Object.keys(config.mcp_servers || {}).map((id) => [
145
+ id,
146
+ { enabled: false },
147
+ ]),
148
+ ),
149
+ features: {
150
+ shell_tool: false,
151
+ apps: false,
152
+ plugins: false,
153
+ remote_plugin: false,
154
+ multi_agent: false,
155
+ hooks: false,
156
+ memories: false,
157
+ },
158
+ thread_unload_delay_secs: 0,
159
+ },
160
+ });
161
+ threadId = result.thread.id;
162
+ const turn = await call("turn/start", {
163
+ threadId,
164
+ input: [
165
+ { type: "text", text: JSON.stringify({ text: text.slice(0, 6000) }) },
166
+ ],
167
+ effort: selected?.supportedReasoningEfforts?.[0]?.reasoningEffort,
168
+ outputSchema: {
169
+ type: "object",
170
+ properties: { title: { type: "string" } },
171
+ required: ["title"],
172
+ additionalProperties: false,
173
+ },
174
+ });
175
+ turnId = turn.turn?.id || turnId;
176
+ await completed;
177
+ const { title } = JSON.parse([...messages.values()].at(-1) || "{}");
178
+ if (typeof title !== "string" || !title.trim())
179
+ throw new Error("标题生成返回了空标题");
180
+ return [...title.trim().replace(/\s+/g, " ")].slice(0, 70).join("");
181
+ } finally {
182
+ clearTimeout(timer);
183
+ signal?.removeEventListener("abort", abort);
184
+ close();
185
+ }
186
+ }
187
+
188
+ export function createThreadNaming({ call, generate, onError }) {
189
+ const jobs = new Map();
190
+ const queue = [];
191
+ let running = false;
192
+ const eligible = (thread) =>
193
+ thread &&
194
+ !thread.parentThreadId &&
195
+ !thread.source?.subAgent &&
196
+ !thread.ephemeral &&
197
+ !thread.name?.trim() &&
198
+ !thread.path?.includes("/archived_sessions/");
199
+
200
+ async function drain() {
201
+ if (running) return;
202
+ running = true;
203
+ while (queue.length) {
204
+ const job = queue.shift();
205
+ const { threadId, controller } = job;
206
+ try {
207
+ if (controller.signal.aborted) continue;
208
+ const { thread } = await call("thread/read", {
209
+ threadId,
210
+ includeTurns: false,
211
+ });
212
+ const text = thread?.preview?.trim() || job.text;
213
+ if (!eligible(thread) || !text || controller.signal.aborted) continue;
214
+ const name = await generate({
215
+ text,
216
+ model: job.model || thread.model,
217
+ modelProvider: thread.modelProvider,
218
+ signal: controller.signal,
219
+ });
220
+ if (controller.signal.aborted) continue;
221
+ // 生成期间可能发生手动重命名或归档,写入前读取最新元数据。
222
+ const latest = await call("thread/read", {
223
+ threadId,
224
+ includeTurns: false,
225
+ });
226
+ if (eligible(latest.thread) && !controller.signal.aborted)
227
+ await call("thread/name/set", { threadId, name });
228
+ } catch (error) {
229
+ if (!controller.signal.aborted) onError(error);
230
+ } finally {
231
+ if (jobs.get(threadId) === job) jobs.delete(threadId);
232
+ }
233
+ }
234
+ running = false;
235
+ }
236
+
237
+ return {
238
+ schedule(thread, { text = "", model } = {}) {
239
+ if (
240
+ !eligible(thread) ||
241
+ (thread.preview !== undefined &&
242
+ !thread.preview?.trim() &&
243
+ !text.trim()) ||
244
+ jobs.has(thread.id)
245
+ )
246
+ return;
247
+ const job = {
248
+ threadId: thread.id,
249
+ text: text.trim(),
250
+ model,
251
+ controller: new AbortController(),
252
+ };
253
+ jobs.set(thread.id, job);
254
+ queue.push(job);
255
+ drain();
256
+ },
257
+ cancel(threadId) {
258
+ jobs.get(threadId)?.controller.abort();
259
+ },
260
+ clear() {
261
+ for (const job of jobs.values()) job.controller.abort();
262
+ },
263
+ };
264
+ }