@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
@@ -0,0 +1,80 @@
1
+ import { constants } from "node:fs";
2
+ import {
3
+ chmod,
4
+ copyFile,
5
+ cp,
6
+ lstat,
7
+ mkdir,
8
+ mkdtemp,
9
+ rename,
10
+ rm,
11
+ stat,
12
+ } from "node:fs/promises";
13
+ import { homedir } from "node:os";
14
+ import { dirname, join, resolve } from "node:path";
15
+
16
+ export function productDirectories(env = process.env) {
17
+ const base = env.XDG_CONFIG_HOME || join(homedir(), ".config");
18
+ return {
19
+ configDir: resolve(env.CLAUDEX_WEB_CONFIG_DIR || join(base, "claudex-web")),
20
+ legacyConfigDir: resolve(
21
+ env.CODEX_WEB_CONFIG_DIR || join(base, "codex-web"),
22
+ ),
23
+ };
24
+ }
25
+
26
+ // 首次升级以完整目录快照迁移网页配置;原目录与已存在的新配置保持原样。
27
+ export async function migrateProductConfig({ configDir, legacyConfigDir }) {
28
+ if (!legacyConfigDir || configDir === legacyConfigDir) return;
29
+ try {
30
+ await stat(configDir);
31
+ return;
32
+ } catch (error) {
33
+ if (error.code !== "ENOENT") throw error;
34
+ }
35
+ try {
36
+ const source = await stat(legacyConfigDir);
37
+ if (!source.isDirectory()) throw new Error("旧网页配置路径必须是目录");
38
+ } catch (error) {
39
+ if (error.code === "ENOENT") return;
40
+ throw error;
41
+ }
42
+ await mkdir(dirname(configDir), { recursive: true, mode: 0o700 });
43
+ const temporary = await mkdtemp(
44
+ join(dirname(configDir), ".claudex-migrate-"),
45
+ );
46
+ const snapshot = join(temporary, "config");
47
+ try {
48
+ await cp(legacyConfigDir, snapshot, {
49
+ recursive: true,
50
+ mode: constants.COPYFILE_EXCL,
51
+ errorOnExist: true,
52
+ force: false,
53
+ filter: async (path) => !(await lstat(path)).isSocket(),
54
+ });
55
+ await chmod(snapshot, 0o700);
56
+ const oldIndex = join(
57
+ snapshot,
58
+ "backends",
59
+ "claude",
60
+ "codex-web-index.json",
61
+ );
62
+ try {
63
+ await copyFile(
64
+ oldIndex,
65
+ join(snapshot, "backends", "claude", "claudex-web-index.json"),
66
+ constants.COPYFILE_EXCL,
67
+ );
68
+ } catch (error) {
69
+ if (!["ENOENT", "EEXIST"].includes(error.code)) throw error;
70
+ }
71
+ await rm(oldIndex, { force: true });
72
+ try {
73
+ await rename(snapshot, configDir);
74
+ } catch (error) {
75
+ if (!["EEXIST", "ENOTEMPTY"].includes(error.code)) throw error;
76
+ }
77
+ } finally {
78
+ await rm(temporary, { recursive: true, force: true });
79
+ }
80
+ }
@@ -0,0 +1,59 @@
1
+ import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
2
+ import { isAbsolute, join } from "node:path";
3
+
4
+ export function createProjectModels(directory, legacyDirectory) {
5
+ const path = join(directory, "project-models.json");
6
+ let writing = Promise.resolve();
7
+ async function read() {
8
+ try {
9
+ return JSON.parse(await readFile(path, "utf8"));
10
+ } catch (error) {
11
+ if (error.code !== "ENOENT") throw error;
12
+ if (legacyDirectory && legacyDirectory !== directory) {
13
+ try {
14
+ return JSON.parse(
15
+ await readFile(
16
+ join(legacyDirectory, "project-models.json"),
17
+ "utf8",
18
+ ),
19
+ );
20
+ } catch (legacyError) {
21
+ if (legacyError.code !== "ENOENT") throw legacyError;
22
+ }
23
+ }
24
+ return {};
25
+ }
26
+ }
27
+ function set({ cwd, model, effort, ifAbsent = false }) {
28
+ if (
29
+ typeof cwd !== "string" ||
30
+ (cwd !== "" && !isAbsolute(cwd)) ||
31
+ typeof model !== "string" ||
32
+ !model ||
33
+ typeof effort !== "string"
34
+ )
35
+ return Promise.reject(new Error("项目目录、模型或思考强度无效"));
36
+ const operation = writing.then(async () => {
37
+ const projects = await read();
38
+ if (ifAbsent && Object.hasOwn(projects, cwd)) return projects;
39
+ const next = { ...projects, [cwd]: { model, effort } };
40
+ await mkdir(directory, { recursive: true, mode: 0o700 });
41
+ const temporary = path + ".tmp";
42
+ await writeFile(temporary, JSON.stringify(next, null, 2) + "\n", {
43
+ mode: 0o600,
44
+ });
45
+ await rename(temporary, path);
46
+ return next;
47
+ });
48
+ writing = operation.catch(() => {});
49
+ return operation;
50
+ }
51
+ return {
52
+ read: () => {
53
+ const operation = writing.then(read);
54
+ writing = operation.catch(() => {});
55
+ return operation;
56
+ },
57
+ set,
58
+ };
59
+ }
@@ -0,0 +1,21 @@
1
+ import WebSocket from "ws";
2
+ import { RPC_FRAME_BYTES } from "../../shared/rpc-limits.mjs";
3
+ export {
4
+ MAX_RPC_MESSAGE_BYTES,
5
+ RPC_FRAME_BYTES,
6
+ } from "../../shared/rpc-limits.mjs";
7
+
8
+ // Codex 的 WebSocket 接口分别限制单帧与完整消息的大小。
9
+ export function sendRpcText(socket, text) {
10
+ if (socket.readyState !== WebSocket.OPEN) return;
11
+ if (Buffer.byteLength(text) <= RPC_FRAME_BYTES) {
12
+ socket.send(text);
13
+ return;
14
+ }
15
+ const bytes = Buffer.from(text);
16
+ for (let offset = 0; offset < bytes.length; offset += RPC_FRAME_BYTES)
17
+ socket.send(bytes.subarray(offset, offset + RPC_FRAME_BYTES), {
18
+ binary: false,
19
+ fin: offset + RPC_FRAME_BYTES >= bytes.length,
20
+ });
21
+ }
@@ -0,0 +1,20 @@
1
+ import { readConfig } from "./config.mjs";
2
+ import { readTls } from "./tls.mjs";
3
+ import { createAuthentication } from "./auth.mjs";
4
+ import { readVersion } from "./version.mjs";
5
+ import { createWebApplication } from "./application.mjs";
6
+ import { migrateProductConfig } from "./product-config.mjs";
7
+ const config = readConfig();
8
+ await migrateProductConfig(config);
9
+ const tls = await readTls(config);
10
+ const authentication = await createAuthentication(config);
11
+ const application = createWebApplication({
12
+ config,
13
+ tls,
14
+ authentication,
15
+ version: readVersion(),
16
+ });
17
+ await application.start();
18
+ console.log(
19
+ `Claudex Web listening on https://${config.host}:${application.server.address().port}`,
20
+ );
@@ -0,0 +1,82 @@
1
+ import { randomUUID } from "node:crypto";
2
+
3
+ // TranSmart 匿名接口使用 browser 前缀的客户端标识;请求由 Node.js 直接发送。
4
+ const clientKey = `browser-claudex-web-server-${randomUUID()}`;
5
+
6
+ export async function translateWithTransmart(texts) {
7
+ const response = await fetch("https://transmart.qq.com/api/imt", {
8
+ method: "POST",
9
+ headers: { "Content-Type": "application/json" },
10
+ body: JSON.stringify({
11
+ header: {
12
+ fn: "auto_translation",
13
+ client_key: clientKey,
14
+ user: "",
15
+ session: "",
16
+ },
17
+ type: "plain",
18
+ model_category: "normal",
19
+ source: { lang: "en", text_list: texts },
20
+ target: { lang: "zh" },
21
+ }),
22
+ signal: AbortSignal.timeout(10000),
23
+ });
24
+ if (!response.ok) throw new Error("翻译服务请求失败,请重试");
25
+ const data = await response.json();
26
+ if (data.header?.ret_code !== "succ")
27
+ throw new Error("翻译服务暂不可用,请重试");
28
+ if (
29
+ !Array.isArray(data.auto_translation) ||
30
+ data.auto_translation.length !== texts.length ||
31
+ data.auto_translation.some(
32
+ (text) => typeof text !== "string" || !text.trim(),
33
+ )
34
+ )
35
+ throw new Error("翻译结果不完整");
36
+ return data.auto_translation;
37
+ }
38
+
39
+ export function createSummaryTranslationHandler(
40
+ translate = translateWithTransmart,
41
+ ) {
42
+ return async (request, response) => {
43
+ response.setHeader("Content-Type", "application/json; charset=utf-8");
44
+ response.setHeader("Cache-Control", "no-store");
45
+ if (request.method !== "POST") {
46
+ response.setHeader("Allow", "POST");
47
+ response.writeHead(405);
48
+ response.end(JSON.stringify({ error: "翻译接口使用 POST 请求" }));
49
+ return;
50
+ }
51
+ let texts;
52
+ try {
53
+ const chunks = [];
54
+ let size = 0;
55
+ for await (const chunk of request) {
56
+ size += chunk.length;
57
+ if (size <= 256 * 1024) chunks.push(chunk);
58
+ }
59
+ if (size > 256 * 1024) throw new Error("翻译文本过长,请缩短后重试");
60
+ texts = JSON.parse(Buffer.concat(chunks).toString("utf8")).texts;
61
+ if (
62
+ !Array.isArray(texts) ||
63
+ !texts.length ||
64
+ texts.length > 24 ||
65
+ texts.some((text) => typeof text !== "string" || !text.trim())
66
+ )
67
+ throw new Error("翻译请求需包含 1 到 24 条有效文本");
68
+ } catch (error) {
69
+ response.writeHead(400);
70
+ response.end(JSON.stringify({ error: "翻译请求无效:" + error.message }));
71
+ return;
72
+ }
73
+ try {
74
+ const translations = await translate(texts);
75
+ response.writeHead(200);
76
+ response.end(JSON.stringify({ translations }));
77
+ } catch {
78
+ response.writeHead(502);
79
+ response.end(JSON.stringify({ error: "翻译服务暂不可用,请重试" }));
80
+ }
81
+ };
82
+ }
@@ -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
+ }
@@ -0,0 +1,36 @@
1
+ import { mkdir, mkdtemp, readFile } from "node:fs/promises";
2
+ import { basename, dirname, join, relative } from "node:path";
3
+
4
+ export async function prepareProjectlessDirectory(root) {
5
+ await mkdir(root, { recursive: true });
6
+ return mkdtemp(join(root, "chat-"));
7
+ }
8
+
9
+ // 桌面端的无项目标记也包含外部对话,只提取有自动工作目录记录的对话。
10
+ export async function readProjectlessDirectories(codexHome) {
11
+ let state;
12
+ try {
13
+ state = JSON.parse(
14
+ await readFile(join(codexHome, ".codex-global-state.json"), "utf8"),
15
+ );
16
+ } catch {
17
+ return {};
18
+ }
19
+ if (!Array.isArray(state?.["projectless-thread-ids"])) return {};
20
+ const directories = {};
21
+ for (const id of state["projectless-thread-ids"]) {
22
+ const output = state["thread-projectless-output-directories"]?.[id];
23
+ const root = state["thread-workspace-root-hints"]?.[id];
24
+ if (
25
+ typeof output !== "string" ||
26
+ typeof root !== "string" ||
27
+ state["thread-project-assignments"]?.[id] ||
28
+ basename(output) !== "outputs"
29
+ )
30
+ continue;
31
+ const directory = dirname(output);
32
+ if (/^\d{4}-\d{2}-\d{2}[/\\][^/\\]+$/.test(relative(root, directory)))
33
+ directories[id] = directory;
34
+ }
35
+ return directories;
36
+ }