@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.
- package/.env.example +27 -0
- package/CHANGELOG.md +449 -0
- package/LICENSE +674 -0
- package/README.md +128 -2
- package/bin/claudex-web.mjs +129 -0
- package/build-info.json +8 -0
- package/client/dist/_baseMerge.js +1 -0
- package/client/dist/abnfDiagram-WEYOIA3C.js +1 -0
- package/client/dist/apl.js +1 -0
- package/client/dist/app.js +393 -0
- package/client/dist/apple-touch-icon.png +0 -0
- package/client/dist/arc.js +1 -0
- package/client/dist/architectureDiagram-ZHVYKT53.js +36 -0
- package/client/dist/asciiarmor.js +1 -0
- package/client/dist/asn1.js +1 -0
- package/client/dist/asterisk.js +1 -0
- package/client/dist/blockDiagram-RJAE7QA3.js +140 -0
- package/client/dist/brainfuck.js +1 -0
- package/client/dist/c4Diagram-XDPPPE54.js +38 -0
- package/client/dist/channel.js +1 -0
- package/client/dist/chunk-2E7WHVMD.js +88 -0
- package/client/dist/chunk-2Q5K7J3B.js +1 -0
- package/client/dist/chunk-4EMNKR2T.js +1 -0
- package/client/dist/chunk-55XCU76K.js +1 -0
- package/client/dist/chunk-5VM5RSS4.js +15 -0
- package/client/dist/chunk-JWPE2WC7.js +1 -0
- package/client/dist/chunk-VQ5W62QI.js +1 -0
- package/client/dist/chunk-XXDRQBXY.js +1 -0
- package/client/dist/chunk-ZCHMQSOR.js +2 -0
- package/client/dist/classDiagram-v2-4MYWR3UA.js +217 -0
- package/client/dist/clike.js +1 -0
- package/client/dist/clojure.js +1 -0
- package/client/dist/cmake.js +1 -0
- package/client/dist/cobol.js +1 -0
- package/client/dist/code-highlight-style.js +13 -0
- package/client/dist/coffeescript.js +1 -0
- package/client/dist/commonlisp.js +1 -0
- package/client/dist/cose-bilkent-JH36ORCC.js +1 -0
- package/client/dist/crystal.js +1 -0
- package/client/dist/css.js +1 -0
- package/client/dist/cynefin-EF2NZ3EQ.js +141 -0
- package/client/dist/cynefinDiagram-WF24UDRP.js +62 -0
- package/client/dist/cypher.js +1 -0
- package/client/dist/cytoscape.esm.js +321 -0
- package/client/dist/d.js +1 -0
- package/client/dist/dagre-NK4GIZVX.js +4 -0
- package/client/dist/defaultLocale.js +1 -0
- package/client/dist/diagram-CBK3MWTC.js +24 -0
- package/client/dist/diagram-I5XIIV2D.js +24 -0
- package/client/dist/diagram-ODIL2UCW.js +30 -0
- package/client/dist/diagram-PFBEJUXE.js +3 -0
- package/client/dist/diagram-RJA3I4VV.js +41 -0
- package/client/dist/diagram-TYUNFSNR.js +200 -0
- package/client/dist/diff.js +1 -0
- package/client/dist/dockerfile.js +1 -0
- package/client/dist/document-editor.js +1040 -0
- package/client/dist/dtd.js +1 -0
- package/client/dist/dylan.js +1 -0
- package/client/dist/ebnf.js +1 -0
- package/client/dist/ebnfDiagram-V4P3TTPT.js +1 -0
- package/client/dist/ecl.js +1 -0
- package/client/dist/eiffel.js +1 -0
- package/client/dist/elk-QONTBCTQ.js +27 -0
- package/client/dist/elm.js +1 -0
- package/client/dist/erDiagram-KYQIGQAA.js +99 -0
- package/client/dist/erlang.js +1 -0
- package/client/dist/factor.js +1 -0
- package/client/dist/favicon.ico +0 -0
- package/client/dist/favicon.png +0 -0
- package/client/dist/fcl.js +1 -0
- package/client/dist/file-panel.js +1 -0
- package/client/dist/flowDiagram-IUGLLWBU.js +213 -0
- package/client/dist/forth.js +1 -0
- package/client/dist/fortran.js +1 -0
- package/client/dist/ganttDiagram-R7GPNTJY.js +292 -0
- package/client/dist/gas.js +1 -0
- package/client/dist/gherkin.js +1 -0
- package/client/dist/gitGraphDiagram-PDYL7XHY.js +106 -0
- package/client/dist/graph.js +1 -0
- package/client/dist/groovy.js +1 -0
- package/client/dist/haskell.js +1 -0
- package/client/dist/haxe.js +1 -0
- package/client/dist/http.js +1 -0
- package/client/dist/idl.js +1 -0
- package/client/dist/index.html +25 -0
- package/client/dist/index.js +2 -0
- package/client/dist/index10.js +1 -0
- package/client/dist/index11.js +1 -0
- package/client/dist/index12.js +1 -0
- package/client/dist/index13.js +7 -0
- package/client/dist/index14.js +1 -0
- package/client/dist/index15.js +1 -0
- package/client/dist/index16.js +6 -0
- package/client/dist/index17.js +1 -0
- package/client/dist/index18.js +3 -0
- package/client/dist/index19.js +1 -0
- package/client/dist/index2.js +1 -0
- package/client/dist/index20.js +1 -0
- package/client/dist/index21.js +1 -0
- package/client/dist/index22.js +1 -0
- package/client/dist/index3.js +1 -0
- package/client/dist/index4.js +1 -0
- package/client/dist/index5.js +1 -0
- package/client/dist/index6.js +13 -0
- package/client/dist/index7.js +1 -0
- package/client/dist/index8.js +1 -0
- package/client/dist/index9.js +1 -0
- package/client/dist/infoDiagram-MVDRKAX5.js +2 -0
- package/client/dist/init.js +1 -0
- package/client/dist/isArrayLikeObject.js +1 -0
- package/client/dist/ishikawaDiagram-HPEHV2GE.js +70 -0
- package/client/dist/javascript.js +1 -0
- package/client/dist/journeyDiagram-BOSHW7O7.js +139 -0
- package/client/dist/julia.js +1 -0
- package/client/dist/kanban-definition-FNSA4HC5.js +89 -0
- package/client/dist/katex.js +257 -0
- package/client/dist/linear.js +1 -0
- package/client/dist/livescript.js +1 -0
- package/client/dist/lua.js +1 -0
- package/client/dist/mathematica.js +1 -0
- package/client/dist/mbox.js +1 -0
- package/client/dist/mermaid.core.js +310 -0
- package/client/dist/mindmap-definition-6OY57UG3.js +98 -0
- package/client/dist/mirc.js +1 -0
- package/client/dist/mllike.js +1 -0
- package/client/dist/modelica.js +1 -0
- package/client/dist/mscgen.js +1 -0
- package/client/dist/mumps.js +1 -0
- package/client/dist/nginx.js +1 -0
- package/client/dist/notification-worker.js +45 -0
- package/client/dist/nsis.js +1 -0
- package/client/dist/ntriples.js +1 -0
- package/client/dist/octave.js +1 -0
- package/client/dist/ordinal.js +1 -0
- package/client/dist/oz.js +1 -0
- package/client/dist/pascal.js +1 -0
- package/client/dist/pegDiagram-ECIUJNBX.js +1 -0
- package/client/dist/perl.js +1 -0
- package/client/dist/pieDiagram-GNMPY74T.js +39 -0
- package/client/dist/pig.js +1 -0
- package/client/dist/powershell.js +1 -0
- package/client/dist/properties.js +1 -0
- package/client/dist/protobuf.js +1 -0
- package/client/dist/pug.js +1 -0
- package/client/dist/puppet.js +1 -0
- package/client/dist/purify.es.js +3 -0
- package/client/dist/python.js +1 -0
- package/client/dist/q.js +1 -0
- package/client/dist/quadrantDiagram-D57K4MC3.js +7 -0
- package/client/dist/r.js +1 -0
- package/client/dist/railroadDiagram-Y72NRBL7.js +1 -0
- package/client/dist/requirementDiagram-EQYSW5RA.js +84 -0
- package/client/dist/rpm.js +1 -0
- package/client/dist/ruby.js +1 -0
- package/client/dist/sankeyDiagram-SY24JHO5.js +40 -0
- package/client/dist/sas.js +1 -0
- package/client/dist/scheme.js +1 -0
- package/client/dist/sequenceDiagram-BLEHNHQU.js +169 -0
- package/client/dist/shell.js +1 -0
- package/client/dist/sieve.js +1 -0
- package/client/dist/simple-mode.js +1 -0
- package/client/dist/sizeCapture-INFHLROL.js +1 -0
- package/client/dist/smalltalk.js +1 -0
- package/client/dist/solr.js +1 -0
- package/client/dist/sparql.js +1 -0
- package/client/dist/spreadsheet.js +1 -0
- package/client/dist/sql.js +1 -0
- package/client/dist/stateDiagram-v2-A6IESKWZ.js +291 -0
- package/client/dist/stex.js +1 -0
- package/client/dist/style.css +1 -0
- package/client/dist/stylus.js +1 -0
- package/client/dist/swift.js +1 -0
- package/client/dist/swimlanes-B3ENRKFQ.js +1 -0
- package/client/dist/swimlanesDiagram-AYQRV4AK.js +8 -0
- package/client/dist/tcl.js +1 -0
- package/client/dist/terminal-panel.js +18 -0
- package/client/dist/textile.js +1 -0
- package/client/dist/tiddlywiki.js +1 -0
- package/client/dist/tiki.js +1 -0
- package/client/dist/timeline-definition-JXYKGLGB.js +120 -0
- package/client/dist/toml.js +1 -0
- package/client/dist/troff.js +1 -0
- package/client/dist/ttcn-cfg.js +1 -0
- package/client/dist/ttcn.js +1 -0
- package/client/dist/turtle.js +1 -0
- package/client/dist/usecaseDiagram-WPOLBNNX.js +370 -0
- package/client/dist/vb.js +1 -0
- package/client/dist/vbscript.js +1 -0
- package/client/dist/velocity.js +1 -0
- package/client/dist/vennDiagram-Q3Y3IDCW.js +34 -0
- package/client/dist/verilog.js +1 -0
- package/client/dist/vhdl.js +1 -0
- package/client/dist/wardleyDiagram-IVAIDKWA.js +78 -0
- package/client/dist/webidl.js +1 -0
- package/client/dist/xquery.js +1 -0
- package/client/dist/xychartDiagram-4URNHDU4.js +7 -0
- package/client/dist/yacas.js +1 -0
- package/client/dist/z80.js +1 -0
- package/docs/architecture/backend-regressions.md +53 -0
- package/docs/architecture/backends.md +113 -0
- package/docs/architecture/behavior.md +206 -0
- package/docs/architecture.md +306 -0
- package/docs/background-tasks.md +39 -0
- package/docs/cli-command-coverage.md +60 -0
- package/docs/deployment.md +269 -0
- package/docs/development.md +385 -0
- package/docs/images/desktop-dark.png +0 -0
- package/docs/images/desktop-light.png +0 -0
- package/docs/images/mobile-sidebar.png +0 -0
- package/docs/images/mobile.png +0 -0
- package/docs/releases/v2.0.0.md +5 -0
- package/docs/releases/v2.1.0.md +6 -0
- package/docs/releases/v2.1.1.md +6 -0
- package/docs/releases/v2.1.2.md +8 -0
- package/docs/releases/v2.2.0.md +11 -0
- package/docs/releases/v2.3.0.md +12 -0
- package/docs/releases/v2.3.1.md +8 -0
- package/docs/releases/v2.4.0.md +8 -0
- package/docs/releases/v2.4.1.md +8 -0
- package/docs/releases/v2.4.2.md +8 -0
- package/docs/releases/v3.0.0.md +9 -0
- package/docs/releases/v3.1.0.md +10 -0
- package/docs/releases/v3.1.1.md +7 -0
- package/docs/releases/v4.0.0-beta.1.md +10 -0
- package/docs/releases/v4.0.0.md +20 -0
- package/docs/releases/v4.0.1.md +10 -0
- package/docs/versioning.md +119 -0
- package/package.json +70 -4
- package/scripts/install-services.mjs +134 -0
- package/scripts/restart-when-idle.mjs +125 -0
- package/scripts/start-backend.mjs +29 -0
- package/server/src/agent-messages.mjs +124 -0
- package/server/src/application.mjs +133 -0
- package/server/src/auth.mjs +328 -0
- package/server/src/backends/claude/account.mjs +171 -0
- package/server/src/backends/claude/adapter.mjs +366 -0
- package/server/src/backends/claude/agent-history.mjs +70 -0
- package/server/src/backends/claude/background-tasks.mjs +168 -0
- package/server/src/backends/claude/catalogue.mjs +266 -0
- package/server/src/backends/claude/execution-errors.mjs +44 -0
- package/server/src/backends/claude/execution-session.mjs +390 -0
- package/server/src/backends/claude/git-tool-changes.mjs +77 -0
- package/server/src/backends/claude/goals.mjs +319 -0
- package/server/src/backends/claude/history-actions.mjs +170 -0
- package/server/src/backends/claude/history.mjs +65 -0
- package/server/src/backends/claude/hooks.mjs +232 -0
- package/server/src/backends/claude/input-stream.mjs +24 -0
- package/server/src/backends/claude/messages-request.mjs +34 -0
- package/server/src/backends/claude/messages.mjs +300 -0
- package/server/src/backends/claude/model-options.mjs +18 -0
- package/server/src/backends/claude/native-commands.mjs +48 -0
- package/server/src/backends/claude/native-records.mjs +76 -0
- package/server/src/backends/claude/process-ownership.mjs +82 -0
- package/server/src/backends/claude/project-instructions.mjs +40 -0
- package/server/src/backends/claude/provider-balance.mjs +40 -0
- package/server/src/backends/claude/provider-environment.mjs +93 -0
- package/server/src/backends/claude/provider-transport.mjs +70 -0
- package/server/src/backends/claude/recovery.mjs +54 -0
- package/server/src/backends/claude/runtime.mjs +463 -0
- package/server/src/backends/claude/session-worker.mjs +32 -0
- package/server/src/backends/claude/sessions.mjs +347 -0
- package/server/src/backends/claude/token-usage.mjs +98 -0
- package/server/src/backends/claude/worker-client.mjs +344 -0
- package/server/src/backends/claude/worker-launcher.mjs +119 -0
- package/server/src/backends/claude/worker-location.mjs +31 -0
- package/server/src/backends/claude/worker-revision.mjs +45 -0
- package/server/src/backends/claude/worker-server.mjs +290 -0
- package/server/src/backends/cli-installation.mjs +140 -0
- package/server/src/backends/codex/adapter.mjs +153 -0
- package/server/src/backends/codex/compaction-recovery.mjs +78 -0
- package/server/src/backends/codex/events.mjs +125 -0
- package/server/src/backends/codex/methods.mjs +17 -0
- package/server/src/backends/codex/reference-mcp.mjs +97 -0
- package/server/src/backends/codex/reference-tools.mjs +71 -0
- package/server/src/backends/codex/requests.mjs +170 -0
- package/server/src/backends/codex/subscriptions.mjs +91 -0
- package/server/src/backends/codex/upstream.mjs +148 -0
- package/server/src/backends/configuration.mjs +122 -0
- package/server/src/backends/identity-mapping.mjs +87 -0
- package/server/src/backends/manager.mjs +412 -0
- package/server/src/backends/network-proxy.mjs +55 -0
- package/server/src/backends/provider-presets.mjs +45 -0
- package/server/src/backends/providers.mjs +132 -0
- package/server/src/backends/storage.mjs +35 -0
- package/server/src/bridge/conversation-policy.mjs +29 -0
- package/server/src/bridge/file-operations.mjs +47 -0
- package/server/src/bridge/product-methods.mjs +66 -0
- package/server/src/compaction.mjs +82 -0
- package/server/src/config.mjs +57 -0
- package/server/src/file-content.mjs +99 -0
- package/server/src/file-undo.mjs +142 -0
- package/server/src/http/router.mjs +80 -0
- package/server/src/http/static.mjs +62 -0
- package/server/src/product-config.mjs +80 -0
- package/server/src/project-models.mjs +59 -0
- package/server/src/rpc-transport.mjs +21 -0
- package/server/src/server.mjs +20 -0
- package/server/src/summary-translation.mjs +82 -0
- package/server/src/system-auth.mjs +45 -0
- package/server/src/thread-folders.mjs +76 -0
- package/server/src/thread-names.mjs +264 -0
- package/server/src/thread-projects.mjs +36 -0
- package/server/src/tls.mjs +87 -0
- package/server/src/version.mjs +55 -0
- package/server/src/web-config-migration.mjs +48 -0
- package/server/src/workspace/commands.mjs +33 -0
- package/server/src/workspace/files.mjs +44 -0
- package/server/src/workspace/service.mjs +27 -0
- package/server/src/workspace/terminals.mjs +122 -0
- package/shared/backend-activity.mjs +13 -0
- package/shared/backend-capabilities.mjs +33 -0
- package/shared/backend-identity.mjs +17 -0
- package/shared/compaction-state.mjs +49 -0
- package/shared/file-types.mjs +82 -0
- package/shared/product-contract.mjs +26 -0
- package/shared/rpc-limits.mjs +2 -0
- package/shared/terminal-workspace.mjs +26 -0
|
@@ -0,0 +1,385 @@
|
|
|
1
|
+
# 开发者指南
|
|
2
|
+
|
|
3
|
+
本文面向修改、测试和发布 Claudex Web 的开发者。安装发行包及日常使用见 [README](../README.md),运行配置和故障处理见[部署与维护](deployment.md)。实现设计见[架构说明](architecture.md),版本选择和完整发布流程见[版本管理](versioning.md)。
|
|
4
|
+
|
|
5
|
+
## 后台任务 MCP 的开发归属
|
|
6
|
+
|
|
7
|
+
后台终端任务能力按[独立项目计划](background-tasks.md)推进。`feat/mcp-background-tasks` 是早期集成原型,后续工作应从中提取通用任务服务与 MCP 接口,在独立仓库设计、验证和发布。该分支的任务守护进程、自动续跑、专用网页面板、CLI 入口和服务安装配置均排除在 Claudex Web 的合并与发布范围之外。
|
|
8
|
+
|
|
9
|
+
Claudex Web 的现有网页交互终端、后端原生后台终端 `/stop` 命令以及通用 MCP 状态与工具结果展示按各自契约维护。独立项目应能在未安装、未启动 Claudex Web 时完成任务执行与结果读取;宿主相关的完成通知及续跑适配单独验证。当前记录的是开发方向,独立仓库创建和代码迁移的实施范围另行确定。
|
|
10
|
+
|
|
11
|
+
## 本地环境与源码启动
|
|
12
|
+
|
|
13
|
+
开发环境需要 Linux、Node.js 24+、npm、OpenSSL、Linux PAM、pamtester、已登录的 Codex CLI 和 `/usr/bin/zsh`;开发 Claude Code 适配时另外安装配置中指定的 Claude Code 可执行文件。本项目使用根目录 npm workspaces 和单一 `package-lock.json` 管理前后端依赖。
|
|
14
|
+
|
|
15
|
+
克隆仓库后,在项目根目录安装依赖并创建配置:
|
|
16
|
+
|
|
17
|
+
```bash
|
|
18
|
+
git clone https://github.com/hjd-hitsz/claudex-web.git claudex-web
|
|
19
|
+
cd claudex-web
|
|
20
|
+
npm ci
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
首次配置时,执行 `cp .env.example .env` 创建配置文件;已有 `.env` 时直接使用现有配置。源码命令从项目根目录 `.env` 加载环境变量,外部环境变量优先;配置项含义见[配置说明](deployment.md#配置)。
|
|
24
|
+
|
|
25
|
+
在不同终端分别启动后端、网页桥接和前端开发服务器:
|
|
26
|
+
|
|
27
|
+
```bash
|
|
28
|
+
# 终端一:已有后端监听配置中的地址时可复用
|
|
29
|
+
npm run start:backend
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
# 终端二:网页桥接服务
|
|
34
|
+
npm start
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
```bash
|
|
38
|
+
# 终端三:前端开发服务器
|
|
39
|
+
npm run dev
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
打开 Vite 输出的 HTTPS 地址。Vite 与桥接复用证书,代理验证桥接证书;本地开发同样使用系统账户登录。开发服务器将 `/rpc`、`/healthz` 和 `/api` 代理到网页桥接端口,模型调用和工具执行按对话归属交给 Codex 或 Claude Code,摘要翻译由桥接直接调用远程翻译服务。
|
|
43
|
+
|
|
44
|
+
验证生产构建时,执行 `npm run build`,再通过网页桥接地址访问,默认 `https://127.0.0.1:8766`。生产服务直接读取 `client/dist`,前端更新后重新构建并刷新网页即可;桥接代码更新后需要重启网页服务。
|
|
45
|
+
|
|
46
|
+
## 项目结构
|
|
47
|
+
|
|
48
|
+
```text
|
|
49
|
+
bin/claudex-web.mjs 全局命令入口和用户配置加载
|
|
50
|
+
client/
|
|
51
|
+
src/app/ 页面布局、侧栏、登录和弹窗
|
|
52
|
+
src/application/ 状态容器、用例和请求生命周期
|
|
53
|
+
src/domain/ 消息、历史、排序、差异和命令规则
|
|
54
|
+
src/infrastructure/ RPC、存储、翻译和浏览器适配
|
|
55
|
+
src/features/ 按功能组织的界面与交互
|
|
56
|
+
src/ui/ 基础控件与纯展示
|
|
57
|
+
src/styles/ 有序加载的职责样式模块
|
|
58
|
+
tests/ 消息、过程分组、翻译和权限策略测试
|
|
59
|
+
vite.config.js 构建与开发代理
|
|
60
|
+
server/
|
|
61
|
+
src/config.mjs 环境配置和默认目录
|
|
62
|
+
src/server.mjs 进程启动与依赖组装
|
|
63
|
+
src/application.mjs HTTPS/WSS 应用生命周期
|
|
64
|
+
src/http/ HTTP 路由与静态资源
|
|
65
|
+
src/bridge/ 请求、事件、订阅与后端连接
|
|
66
|
+
src/backends/ 双后端配置、供应商、路由及原生适配
|
|
67
|
+
src/workspace/ 共用文件与网页终端
|
|
68
|
+
src/summary-translation.mjs TranSmart 匿名 HTTP API 与本站翻译接口
|
|
69
|
+
src/version.mjs 正式版本与 Git / 安装包构建来源
|
|
70
|
+
tests/ 配置和桥接集成测试
|
|
71
|
+
scripts/ 后端启动、组件测试、systemd 安装及发布脚本
|
|
72
|
+
shared/ 跨端纯逻辑和传输限制
|
|
73
|
+
tests/components/ 隔离环境中的实际 React 组件测试
|
|
74
|
+
tests/helpers/ 认证、桥接和输入事件等测试夹具
|
|
75
|
+
docs/architecture.md 架构与协议实现
|
|
76
|
+
docs/deployment.md 使用者部署、配置与故障处理
|
|
77
|
+
docs/versioning.md 版本管理与发布流程
|
|
78
|
+
CHANGELOG.md 未发布变更与正式版本总览
|
|
79
|
+
package-lock.json 全项目依赖锁文件
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
前端采用 React,Node.js 桥接服务负责静态资源和 WebSocket JSON-RPC 转发。组件职责、状态流转、协议和生命周期约束见[架构说明](architecture.md)。
|
|
83
|
+
|
|
84
|
+
服务图标源文件为 `client/src/assets/claudex-web.svg`。侧栏和欢迎页使用内联 SVG,浏览器标签页使用 `client/public` 中的 PNG、ICO 和触屏图标,通过本站独立路径读取。修改 SVG 后,在安装了 `gdk-pixbuf-thumbnailer` 的 Linux 环境中执行 `npm run icons:generate`,同步生成并提交兼容资源;普通构建与发行包安装直接使用这些资源。验证时同时检查浏览器实际请求的图标地址、响应类型及标签页显示,手机浏览器的验证独立于窄屏页面布局检查。
|
|
85
|
+
|
|
86
|
+
快捷命令的 CLI 对照、网页复用入口、专用能力边界及浏览器回归方法见[命令覆盖记录](cli-command-coverage.md)。
|
|
87
|
+
|
|
88
|
+
## 双后端开发与验收
|
|
89
|
+
|
|
90
|
+
双后端的统一范围由[产品契约](architecture/backends.md)定义;`shared/product-contract.mjs` 只注册工作区和对话方法的路由分组。原生能力分别接入统一用例,文件与网页终端由共用工作区服务提供。文件模糊查询按所属后端路由,Codex 保留原生 app-server 调用,Claude Code 使用原生 `file_suggestions` 控制请求及 CLI 文件索引;两端共用输入建议,回归同时核对原有 Codex 路径和 Claude 新增实现。CLI/SDK 生命周期、原生历史及参数发生变化时,同时检查首次请求、流式展示、轮次完成、刷新恢复和错误重试。Claude 执行服务通过受限本机 IPC 独立于网页桥接运行,网页关闭仅释放连接;源码与安装来源的代码身份按实际发行文件计算。
|
|
91
|
+
|
|
92
|
+
公共网页操作在 `server/src/bridge` 维护,原生适配分别位于 `server/src/backends/codex` 和 `server/src/backends/claude`。调整适配器接口时执行 `node --test server/tests/backend-product-contract.test.mjs server/tests/backend-routing.test.mjs`,核对两端的离线偏好、保存通知、失败重试、目录创建、整理写入限制、工作区所有者声明和浏览器代理释放。产品契约夹具使用真实适配器与模拟 app-server,Claude 只执行进程版本检查;真实 CLI/SDK 的执行与恢复由下述验收覆盖。架构检查同时禁止公共桥接依赖具体后端和原生适配器之间的交叉依赖。
|
|
93
|
+
|
|
94
|
+
真实 Claude Code 回归使用临时配置、原生会话和隔离 Messages 服务。执行持久化场景需要可访问的 systemd 用户管理器,以实际独立 service 和 cgroup 验证生产部署;指定本机已安装的可执行文件:
|
|
95
|
+
|
|
96
|
+
```bash
|
|
97
|
+
CLAUDE_EXECUTABLE=/absolute/path/to/claude npm run test:backends
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
该入口依次执行原生会话分支与历史、模型/插件/MCP 目录、项目指令、工具和提问、计划批准、整理、中断、持续输入、目标及后台任务等脚本,记录真实 CLI 版本和各脚本结果,日志位于 `.cache/backend-acceptance`。测试不访问用户对话,模型回应由隔离服务提供。图片验证通过真实 CLI 提交临时 PNG,检查首次供应商请求保留 base64 内容、刷新历史恢复图片地址,以及原生 Read 返回图片后在统一工具结果中的显示数据。`server/tests` 另验证身份、额度窗口与额外用量的转换;原生账户授权和在线余额的验证记录需要相应服务环境,按实际完成的项目单独报告。
|
|
101
|
+
|
|
102
|
+
`claude-runtime-restart.mjs` 使用真实 systemd transient 用户服务、临时模型会话及后台 shell,验证网页代理进程 SIGKILL 后执行服务与原生 PID 保持、后台任务继续、重连快照和忙时停止拒绝。`claude-worker-upgrade.mjs` 通过隔离源码身份与配置验证忙时待更新、空闲替换、旧桥接保留新代际及多连接行为。`server/tests/claude-worker-client.test.mjs` 以 Unix IPC 协议夹具验证多连接、提问和执行状态透传、关闭桥接及在途请求结算;`claude-worker-location.test.mjs` 核对目录、socket 权限及符号链接替代拒绝。协议夹具与真实系统服务的证据分别记录。
|
|
103
|
+
|
|
104
|
+
`claude-native-configuration.mjs` 通过真实 CLI 核对既有用户设置、多级软链接技能和原生历史读取,网页状态目录单独配置。夹具在原生设置中保留不同的供应商环境,再通过网页显式选择隔离供应商,验证首次请求到达所选服务、原配置文件保持原样。显式供应商覆盖经原生 `applyFlagSettings` 在输入前通过进程通信应用,凭据保持在受限环境和通信中。
|
|
105
|
+
|
|
106
|
+
`claude-worker-environment.mjs` 使用自签 HTTPS 模型端点,验证 Node 启动时的额外 CA 与代理配置、包含空格的路径、权限 0600 的环境文件,以及进程参数中省去代理凭据。退出后核对环境文件清理;该测试随 `test:backends` 执行。
|
|
107
|
+
|
|
108
|
+
项目指令回归通过真实运行时捕获 Messages 请求,核对祖先和当前目录的 AGENTS 指令完整送达、原生 CLAUDE 指令持续保留,以及更新、删除、空快照和读取失败后的下一轮行为。标准 Messages 传输将所需系统上下文放在顶层 `system`。原生历史回归使用临时 JSONL 和真实 SDK,核对 UUID 分支、编辑、补充消息、子代理接收记录、后台自动唤醒锚点和完整分页;历史正文与已确认的展示元数据分别验证。
|
|
109
|
+
|
|
110
|
+
Codex 的真实模型回归显式指定已配置模型和认证的目录,脚本只复制配置及认证到独立的临时 `CODEX_HOME`,项目和对话记录在临时目录中创建:
|
|
111
|
+
|
|
112
|
+
```bash
|
|
113
|
+
CODEX_VALIDATION_HOME=/absolute/path/to/configured-codex-home CODEX_EXECUTABLE=/absolute/path/to/codex npm run test:codex:live
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
`CODEX_MODEL` 可选,用于指定验收模型。`codex-native-lifecycle.mjs` 通过真实 app-server 与配置的模型执行文件写入和读取、原生文件建议、服务重启后继续同一对话、分支及原生历史读取;2026-11-06 已验证 `codex-cli 0.162.1` 的三个真实轮次。具体结果保存在 `.cache/backend-acceptance/codex-live.json`,与浏览器中的 Codex 协议夹具分别记录。
|
|
117
|
+
|
|
118
|
+
`CODEX_EXECUTABLE=/absolute/path/to/codex node tests/integration/codex-subscription-release.mjs` 使用真实 app-server、人工持久历史及实际 Codex 适配器,连续执行八组立即重新打开的操作,验证取消订阅确认与 `thread/closed` 之间的等待。此测试使用临时原生目录,模型轮次数为零;`server/tests/codex-close-lifecycle.test.mjs` 另覆盖关闭早于确认、无需关闭的状态和断线失败,HTTPS/WSS 订阅回归覆盖确认后关闭延迟到达。
|
|
119
|
+
|
|
120
|
+
完整 Codex 网页操作使用相同的隔离配置和真实 app-server:
|
|
121
|
+
|
|
122
|
+
```bash
|
|
123
|
+
CODEX_VALIDATION_HOME=/absolute/path/to/configured-codex-home CHROME_PATH=/path/to/chromium PLAYWRIGHT_MODULE=/path/to/playwright/index.mjs node tests/browser/codex-native.mjs
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
脚本通过登录表单进入临时 HTTPS 网页,实际选择模型并创建文件,验证任务完成、刷新历史、原生文件引用、文件面板,以及编辑重发后的文件和历史内容,保留独立草稿。结果与截图保存在 `.cache/backend-acceptance/codex-browser`;此入口使用真实 Codex 模型,与协议模拟器浏览器回归分别记录。
|
|
127
|
+
|
|
128
|
+
第三方安装路径的 Claude 验收单独执行:
|
|
129
|
+
|
|
130
|
+
```bash
|
|
131
|
+
CLAUDE_EXECUTABLE=/absolute/path/to/claude node tests/integration/claude-installed-worker.mjs
|
|
132
|
+
```
|
|
133
|
+
|
|
134
|
+
脚本构建网页后实际打包并安装到临时 npm prefix,从安装包加载 worker 客户端并启动独立执行服务。验证无 Git、无源码锁文件时的原生文件读取、项目技能、模型配置、真实 Write 工具落盘、历史恢复及空闲停止,模型响应由隔离 Messages 服务提供。安装日志、包文件和结果保存在 `.cache/backend-acceptance/installed-worker`。`tests/package.test.mjs` 的模拟 Codex 验证继续覆盖其已有安装场景。
|
|
135
|
+
|
|
136
|
+
生产页面的双后端回归在构建后执行:
|
|
137
|
+
|
|
138
|
+
```bash
|
|
139
|
+
npm run build
|
|
140
|
+
CLAUDE_EXECUTABLE=/absolute/path/to/claude CHROME_PATH=/path/to/chromium PLAYWRIGHT_MODULE=/path/to/playwright/index.mjs node tests/browser/dual-backends.mjs
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
浏览器脚本使用独立 HTTPS/WSS 桥接、临时系统登录夹具、Codex 协议模拟器与真实 Claude Code 配合隔离 Messages 服务,验证共享界面、模型选择、草稿、文件引用、执行状态、失败恢复、插件连接及两端归属。截图与记录位于 `.cache/dual-backend-browser`。模拟 Codex 传输、真实 Claude CLI、隔离模型响应及真实外部模型验证分别注明来源。
|
|
144
|
+
|
|
145
|
+
实际页面缩放使用 `CODEX_BROWSER_ZOOM_ONLY=1` 配合上述真实 Codex 浏览器脚本执行。脚本从 Chromium 设置调整页面缩放,核对 DPR 和 CSS 视口,覆盖桌面与 390 像素窄屏、深浅主题及 80%、100%、125%、150%、200%。验证两行输入、工具栏和模型控件位于视口内、欢迎内容可滚动,以及侧栏开关和关闭按钮;该模式断言模型轮次数为零,截图与测量值保存在 Codex 浏览器证据目录的 `browser-zoom` 中。
|
|
146
|
+
|
|
147
|
+
使用外部真实模型时,显式设置测试服务及模型:
|
|
148
|
+
|
|
149
|
+
```bash
|
|
150
|
+
CLAUDE_EXECUTABLE=/absolute/path/to/claude MODEL_BASE_URL=https://model.example MODEL_ID=your-model MODEL_API_KEY=your-key npm run test:backends:live
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
该脚本使用临时 Claude 对话验证实际生成、工具与恢复,保留独立结果;远端服务和 GPU 选择由验证环境配置,产品默认值保持通用。验证来源、请求结果和未执行的认证场景写入执行记录。
|
|
154
|
+
|
|
155
|
+
已有 Python 模块目录的只读说明验收使用独立入口:
|
|
156
|
+
|
|
157
|
+
```bash
|
|
158
|
+
CLAUDE_EXECUTABLE=/absolute/path/to/claude MODEL_BASE_URL=https://model.example MODEL_ID=your-model VALIDATION_CWD=/absolute/path/to/project VALIDATION_DIRECTORY=relative/path/to/python-package node tests/integration/claude-readonly-directory.mjs
|
|
159
|
+
```
|
|
160
|
+
|
|
161
|
+
脚本将“介绍这个文件夹里面各个文件的功能”的请求原文交给真实 Claude Code,以临时配置和原生计划模式读取指定目录。验证成功的工具响应包含实际源码 API、最终正文覆盖目录文件与公开 API、全部模型请求返回 200,以及目标文件 SHA-256 前后相同。`MODEL_API_KEY` 按服务认证要求设置,`VALIDATION_OUTPUT` 可指定证据目录,默认 `.cache/backend-acceptance/original-user-case`。证据包含 `answer.md`、工具事件、原生会话、请求响应和结果报告。该入口读取已有目录,写入仅发生在临时配置及证据目录中。
|
|
162
|
+
|
|
163
|
+
### 客户端与既有网页行为查验
|
|
164
|
+
|
|
165
|
+
2026-11-06 查验本机保存的网页客户端 `codex-lan-client 2.0.0`,目录为 `~/.local/share/codex-lan/client-source`。`src/shortcuts.jsx` 的文件建议逻辑在空查询或目录后缀时读取目录,其余查询调用 `fuzzyFileSearch` 并传入当前目录,保留 60 项及请求代次隔离;同文件的命令注册列出原有网页入口。`src/store.js` 的发送流程根据活动轮次选择 `turn/steer` 或 `turn/start`,通知分派处理 `turn/started` 与 `turn/completed`。这些代码作为既有网页交互和用户体验的查验依据,统一 18 项命令以当前仓库注册表为准。
|
|
166
|
+
|
|
167
|
+
同日查验 Codex VS Code 扩展 `openai.chatgpt 26.908.40401`,版本来自 `~/.local/share/vscode-lan/code-server-extensions/openai.chatgpt-26.908.40401-linux-x64/package.json`。`webview/assets/app-initial-1e5ee25fb4ec.js` 中的文件查询服务调用原生 fuzzy search 会话启动、更新、停止接口,并保留单次查询接口;`Nhr` 注册 `init` 命令,在提交生成前检查已有 `AGENTS.md`。`app-initial-bca4f920746a.js` 的 `P1t` 处理轮次开始并更新对话状态,整理流程调用 `thread/compact/start`;补充输入提交使用 `turn/steer`。这里记录原生客户端的交互及协议事实,Claude Code 的原生附加命令以其自身当前目录返回结果为准。
|
|
168
|
+
|
|
169
|
+
以上查验使用本机可取得的源码及已安装打包资源。保存的网页客户端、当前网页产品、Codex 客户端和 Claude Code 运行时各自注明版本与来源;提取资源保留在本机忽略目录,仓库只维护行为结论和隔离验证。
|
|
170
|
+
|
|
171
|
+
## 格式与验证
|
|
172
|
+
|
|
173
|
+
长对话切换回归先执行 `npm run build`,再运行 `CHROME_PATH=/path/to/chromium PLAYWRIGHT_MODULE=/path/to/playwright/index.mjs node tests/browser/history-performance.mjs`。脚本使用生产构建、独立浏览器和 15 轮、3,210 条记录的隔离历史(消息分页基线 33 页,优化后首屏加 15 个轮次分页),每页模拟 50 毫秒往返;记录首屏和完整恢复耗时,验证最近消息及输入先可用、自动完整分页、普通状态更新复用 Markdown、读取期间草稿与实时更新保留、历史前插时的阅读位置、目录跳转和快速切换隔离,覆盖深浅主题、80% 至 200% 缩放及窄屏。证据与构建来源保存在 `.cache/history-performance/after`。修改前的构建及来源分别保存为 `.cache/history-performance-before/dist` 和 `build-info.json`,以 `BROWSER_BEFORE=1` 记录同机对照,耗时用于比较同机行为。单元及组件回归同时验证旧接口完整轮次回退、分页失败后的可读记录与重试、实时结果优先及切换隔离。现有 README 图片展示完整加载后的界面,布局和内容继续适用。
|
|
174
|
+
|
|
175
|
+
侧栏收纳回归执行 `SIDEBAR_DENSITY=1 CHROME_PATH=/path/to/chromium node tests/browser/project-pins.mjs`,使用隔离的 Atlas/Beacon 与最近有活动的未分类对话、超过 60 条的后端分页,验证未分类始终位于末尾、固定与未固定的默认收放、每组最新五条、全部展开及收起、刷新重置、键盘操作、深浅主题、80% 至 200% 缩放和手机布局。截图与构建信息保存在 `.cache/sidebar-density-browser/after/`。旧构建及来源位于 `.cache/sidebar-density-before/`,追加 `SIDEBAR_DENSITY_BEFORE=1` 保存旧版全部展开的对照截图。
|
|
176
|
+
|
|
177
|
+
固定文件夹回归先执行 `npm run build`,再运行 `CHROME_PATH=/path/to/chromium node tests/browser/project-pins.mjs`。脚本使用生产构建、隔离浏览器与模拟 Atlas/Beacon 对话,实际点击图钉和归档按钮,验证固定后全部归档、刷新恢复、空项目新建、取消固定、草稿与同类项目顺序保留、键盘操作、深浅主题及手机布局,结果和截图写入 `.cache/project-pins-browser/after/`。旧构建及来源保存在 `.cache/project-pins-before/dist` 与 `.cache/project-pins-before/build-info.json`,通过 `BROWSER_BEFORE=1` 复现重新加载后空文件夹消失,保存对照截图。取消固定的鼠标与键盘焦点回归同时核对图钉及加号的实际透明度:鼠标移开后隐藏,Tab 聚焦时显示;固定状态仅常显图钉,加号在点击新建对话并移开鼠标后隐藏。通过 `PIN_VISIBILITY_BEFORE=1` 读取 `.cache/project-pin-visibility-before/` 保存的构建及来源,复现鼠标点击保留焦点导致按钮常显,结果保存到 `.cache/project-pins-browser/visibility-before/`。固定记录复用 `cx-projects`,已有手动项目继续保留。README 的桌面及手机侧栏图片使用当前生产构建重新生成。
|
|
178
|
+
|
|
179
|
+
项目模型偏好回归执行 `CHROME_PATH=/path/to/chromium node tests/browser/project-models.mjs`,使用生产构建、隔离的 Atlas/Beacon 项目与模拟后端,通过模型选择框和强度滑块的键盘操作验证保留强度、最近档位、项目切换、刷新恢复及实际发送参数,保存桌面深浅主题和手机截图。修改前的构建及来源分别保存在 `.cache/project-model-before/dist` 和 `.cache/project-model-before/build-info.json`,以 `BROWSER_BEFORE=1` 复现切换模型重置强度;执行证据写入 `.cache/project-model-browser/`。组件回归同时覆盖历史及迟到恢复、未分类隔离和选择目录时保留草稿附件。README 图片使用当前生产构建重新生成,并通过 Markdown HTML 浏览器回归检查加载与排版。
|
|
180
|
+
|
|
181
|
+
已有对话模型隔离回归使用 `EXISTING_MODEL=1 CHROME_PATH=/path/to/chromium node tests/browser/project-models.mjs`,以项目默认模型 C 与已有对话模型 A 的隔离数据验证打开、刷新、实际发送及从新建界面返回已有对话,并保存桌面深浅主题和手机截图。修改前将生产构建和构建来源保存到 `.cache/existing-model-before/dist` 与 `.cache/existing-model-before/build-info.json`,增加 `BROWSER_BEFORE=1` 复现覆盖;证据写入 `.cache/existing-model-browser/`。组件回归另覆盖重连初始化、恢复及迟到响应期间手动调整。README 及其他文档现有截图展示常规对话,模型选择器的外观与布局保持一致,相关图片继续适用。
|
|
182
|
+
|
|
183
|
+
同项目新建与服务端保存回归增加 `PROJECT_MODEL_SERVER=1`,从历史恢复一个不同于配置默认值的模型和强度,在尚未手动调整时点击右上角新建,断言完整保留当前选择。测试通过临时 `CLAUDEX_WEB_CONFIG_DIR` 和实际项目存储模块写入文件,清空浏览器存储后重新加载,并重新创建存储实例核对项目设置。结果写入 `.cache/project-model-server-browser/`;修改前构建与构建来源保存到 `.cache/project-model-server-before/`,配合 `BROWSER_BEFORE=1` 复现回退到配置值。服务端单元及桥接测试覆盖跨项目连续写入、重建恢复、跨连接同步、旧缓存补齐、无效输入和损坏文件保护;组件测试覆盖保存失败重试及当前选择优先。
|
|
184
|
+
|
|
185
|
+
```bash
|
|
186
|
+
npm run format
|
|
187
|
+
npm run architecture:check
|
|
188
|
+
npm test
|
|
189
|
+
npm run check
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
`format` 使用 Prettier 格式化项目。`architecture:check` 检查生产源码单文件 500 行上限、导入完整性、循环和分层依赖;`test` 包含单元测试、隔离的桥接协议测试和 React 组件测试;`check` 依次执行版本一致性、架构检查、格式检查、全部测试、生产构建和发行包安装测试。提交修改前执行 `npm run check`。
|
|
193
|
+
|
|
194
|
+
`.github/workflows/check.yml` 对分支推送和 PR 执行同一完整检查,使用只读仓库权限;同一引用有新检查时取消旧运行。发布工作流在版本标签上独立重复完整检查。
|
|
195
|
+
|
|
196
|
+
状态容器和 RPC 客户端的单元回归分别位于 `client/tests/application-state.test.js` 和 `client/tests/rpc-client.test.js`。服务应用生命周期回归位于 `server/tests/application.test.mjs`,使用临时 HTTPS 服务验证实例缓存隔离、监听失败和关闭后连接清理。组件总入口 `tests/components/client.mjs` 只组织夹具和场景,新增场景放入对应模块;桥接订阅、写入与整理分别维护测试文件并复用 `tests/helpers/bridge.mjs`。
|
|
197
|
+
|
|
198
|
+
分支标题回归先执行 `npm run build`,再运行 `CHROME_PATH=/path/to/chromium node tests/browser/fork-titles.mjs`。脚本使用隔离模拟历史和生产构建,实际点击回复分支按钮与侧栏菜单,验证兼容客户端编号、连续分支到两位数、刷新恢复、深浅主题及手机侧栏;截图和构建信息保存到 `.cache/fork-titles-browser/after`。修改前将旧 `client/dist` 与 `build-info.json` 复制到 `.cache/fork-titles-before/`,以 `BROWSER_BEFORE=1` 运行同一脚本,复现后缀逐次叠加并保存对照截图。单元与组件测试另覆盖旧后缀、手动改名、独立同名对话、60 字符截断、归档分页和筛选外编号。README 的现有演示图片未展示分支标题,相关图片继续使用既有演示内容。
|
|
199
|
+
|
|
200
|
+
测试采用模拟后端,不消耗模型额度,也不修改真实聊天。协议或生命周期变更应补充对应回归测试;真实后端验证使用临时会话或明确的测试数据。各测试目录的覆盖范围见[架构设计中的验证章节](architecture.md#7-可执行约束与验证)。
|
|
201
|
+
|
|
202
|
+
输入性能回归先执行 `npm run build`,再运行 `CHROME_PATH=/path/to/chromium node tests/browser/composer-performance.mjs`。脚本使用独立浏览器配置和模拟 WebSocket,载入 60 轮 Markdown 历史及 31 个侧栏对话,通过浏览器输入事件一次写入大段文字并连续补充,记录输入事件到下一绘制帧的耗时和 React 历史渲染次数;断言输入期间历史渲染次数为零,耗时作为同机对照记录。继续验证组合输入、Enter 换行、刷新恢复、发送失败与等待期间继续编辑,保存桌面深浅主题和窄屏截图。结果和构建来源保存在 `.cache/composer-performance/after`;修改前将 `client/dist` 与 `build-info.json` 复制到 `.cache/composer-performance-before/`,分别保存为 `dist` 与 `build-info.json`,以 `BROWSER_BEFORE=1` 运行同一脚本记录历史随输入重渲染的对照结果。`tests/components/composer-performance.mjs` 独立验证共享快照引用、渲染次数、即时发送值、持久化、草稿清理与对话切换。此修复保留界面布局,README 及其他文档引用的现有截图仍与页面一致。
|
|
203
|
+
|
|
204
|
+
批注浏览器回归先执行 `npm run build`,再运行 `CHROME_PATH=/path/to/chromium node tests/browser/annotations.mjs`。脚本复制当前生产资源,在独立浏览器配置目录中使用模拟 WebSocket 历史,验证多批注草稿、Enter 完成并返回主输入框、Shift+Enter 换行、悬浮编辑、缩放、窄屏、刷新恢复、失败重试及 Ctrl+Enter 统一提交;截图和构建来源记录默认写入 `.cache/annotations-browser`,可通过 `BROWSER_OUTPUT_DIR` 指定目录。使用 `ANNOTATION_ENTER_BEFORE=1` 对照旧构建,可复现 Enter 插入换行并保存截图。组件回归同时检查输入法组合输入和键码 229 的 Enter 保持编辑。README 图片展示任务消息、文件变更和侧栏,未包含批注浮层,图片内容保持适用。
|
|
205
|
+
|
|
206
|
+
后台恢复浏览器回归先执行 `npm run build`,再运行 `CHROME_PATH=/path/to/chromium node tests/browser/connection-recovery.mjs`。脚本使用隔离模拟 WebSocket 与真实标签切换,在桌面和手机尺寸下验证连接正常时持续更新、断线后延迟重连、后台历史补齐、工作过程展开状态、同步期间编辑草稿及向上翻阅位置。记录消息和输入框的 DOM 实例及移除事件,确认恢复期间保留已有界面,并核对页面时间来源保持一致。截图及构建路径写入 `.cache/background-recovery-browser/after`。修改前将旧 `client/dist` 复制到 `.cache/background-recovery-before/dist`,以 `BROWSER_BEFORE=1` 运行同一脚本,复现消息与输入框被移除、显示加载提示和工作过程收起,结果写入 `before` 目录。
|
|
207
|
+
|
|
208
|
+
视觉调整的浏览器检查使用生产构建与隔离的模拟历史,覆盖正文、代码块、工作过程、输入框草稿、右侧详情、设置弹窗及欢迎页。浅色、深色、跟随系统深色和窄屏分别核对文字对比度、选中状态、换行、控件位置及全宽布局。80%、100%、125%、150% 和 200% 缩放按物理窗口尺寸除以缩放倍数设置 CSS 视口,并同步设置设备像素比,检查发送按钮和底栏的可见性。修改前后采用相同数据和视口截图,图片及构建信息保存在 `.cache` 中。
|
|
209
|
+
|
|
210
|
+
账户点数展示对照本机 Codex VS Code 客户端 `26.1021.22027` 的 `webview/assets/rail-menu-cae2fdac3263.js`:`fe` 读取并校验 `credits.balance`,`It` 展示余额,`banner-suppression-f959351fdc5c.js` 的 `O` 将后端点数字段映射到 `hasCredits`、`unlimited` 和 `balance`。原生客户端界面控制连接未提供,以上打包实现及本机 app-server 的 `CreditsSnapshot` 协议定义作为数据依据。网页保留百分比圆环,在展开详情中单独显示点数;余额四舍五入至最多两位小数并省略末尾的零,另覆盖零余额、无限额、暂缺、仅点数、稀疏通知、失败保留、完整读取清除和账户切换隔离。README 当前截图展示折叠圆环,图示仍符合默认界面。
|
|
211
|
+
|
|
212
|
+
账户额度浏览器回归先执行 `npm run build`,再运行 `CHROME_PATH=/path/to/chromium node tests/browser/account-usage.mjs`。脚本注入隔离的 Pro 和 Plus 账户,核对默认圆环、账户行高度和单行重置信息,通过实际点击、Enter、空格、Esc 与外部点击验证详情收放;推进本地时钟并触发 30 秒倒计时回调,确认时间更新及后端请求数量。额度自动读取测试把 60 秒轮询缩短至 200 毫秒并按需启用,组件测试另行断言两个生产间隔。继续验证额度通知、接口失败、回到前台与设置页精简,覆盖浅色、深色、跟随系统深色、五档缩放、390px 窄屏和基础字号放大。截图及构建来源写入 `.cache/account-usage-compact-browser/after`。修改前先将旧 `client/dist` 与 `build-info.json` 复制到 `.cache/account-usage-compact-before/`,分别命名为 `dist` 与 `build-info.json`,再以 `BROWSER_BEFORE=1` 运行同一脚本,记录原有展开大卡片的对照结果。
|
|
213
|
+
|
|
214
|
+
界面发生可见变化时,同步检查 README 和其他文档引用的仓库图片,在同一提交中更新受影响的截图。README 的界面截图维护在 `docs/images/`:`desktop-light.png` 与 `desktop-dark.png` 使用相同演示数据和 1440 × 900 的桌面视口,`mobile.png` 与 `mobile-sidebar.png` 使用 390 × 844 的手机视口及 2 倍设备像素比,分别展示对话与侧栏额度。执行 `npm run build` 后运行 `CHROME_PATH=/path/to/chromium node tests/browser/readme.mjs`,脚本在独立浏览器配置中使用隔离演示项目、Plus 双窗口额度和模拟消息,实际打开文件预览、切换主题与手机侧栏,并检查默认折叠圆环及展开后的单行重置信息。生成的截图默认写入 `docs/images/`,可通过 `BROWSER_OUTPUT_DIR` 指定其他目录;展开状态的检查截图、构建来源和检查记录写入 `.cache/readme-screenshots/after`。README 通过 `picture` 随阅读环境切换桌面截图,手机截图放在可展开区域;更新后运行 Markdown HTML 浏览器回归,检查实际渲染中的图片、相对链接、折叠区域及窄屏排版。
|
|
215
|
+
|
|
216
|
+
Markdown HTML 回归先执行 `npm run build`,再运行 `CHROME_PATH=/path/to/chromium node tests/browser/markdown-html.mjs`。脚本使用当前 README、仓库内图片和隔离演示消息,通过程序实际消息区与文件面板验证 HTML 排版、折叠块、图标尺寸、本地候选图、深浅主题与系统主题、文内导航、大图预览及焦点恢复;另核对脚本过滤和窄屏布局。截图与构建来源写入 `.cache/markdown-html-browser/after`。修改前将旧 `client/dist` 和 `build-info.json` 复制到 `.cache/markdown-html-before/`,以 `BROWSER_BEFORE=1` 运行同一脚本复现消息与文件预览直接显示 HTML 文字,结果写入 `before` 目录。组件回归包含安全属性过滤、代码原文、相对路径、候选图失败与迟到读取、实际 README,以及既有的公式、Mermaid 和批注测试。
|
|
217
|
+
|
|
218
|
+
工具记录浏览器回归先执行 `npm run build`,再运行 `CHROME_PATH=/path/to/chromium node tests/browser/tool-activities.mjs`。脚本在独立浏览器配置中注入 `tests/fixtures/tool-activities.mjs` 的模拟历史,验证图片直接显示、点击放大与焦点恢复、搜索结果仅显示标题链接(缺少标题时显示网址)、搜索记录折叠与恢复、可读网页操作和工具结果,以及深浅主题、80% 至 200% 缩放与窄屏;截图和构建来源写入 `.cache/tool-activities-browser/after`。搜索结果精简的修改前对照先把 `client/dist` 与 `build-info.json` 分别复制到 `.cache/tool-activities-before/dist` 与 `.cache/tool-activities-before/build-info.json`,再用 `BROWSER_BEFORE=1` 运行同一脚本,确认搜索结果仍显示摘要及内部字段,结果写入 `before` 目录。
|
|
219
|
+
|
|
220
|
+
文件打开回归先执行 `npm run build`,再运行 `CHROME_PATH=/path/to/chromium node tests/browser/files.mjs`,本机需有支持 H.264 编码的 `ffmpeg`。脚本生成临时音视频、PDF、BMP 和二进制样本,注入隔离的模拟历史,实际点击并验证播放、进度跳转、媒体切换后的资源清理、图片与 PDF 预览、文件下载字节、文本编辑和失败重试,覆盖深浅主题与窄屏。截图、下载样本和构建来源保存在 `.cache/file-preview-browser/after`。修改前对照将旧构建及来源复制到 `.cache/file-preview-before/dist` 与 `.cache/file-preview-before/build-info.json`,以 `BROWSER_BEFORE=1` 分别记录音频的二进制提示与 PDF 被当作源码显示的结果。`server/tests/file-content.test.mjs` 覆盖 MIME、附件文件名、原始字节、Range、大文件及取消读取;桥接测试验证 HTTPS 路由,文件面板组件测试覆盖类型切换、保存保护、草稿与迟到读取隔离。
|
|
221
|
+
|
|
222
|
+
文件详情布局回归同时检查面板延伸到工作区底部、桌面输入框避让、折叠后恢复全宽,以及下载图标的位置、可访问名称和实际下载。深浅主题与 80%、100%、125%、150%、200% 缩放检查记录在 `.cache/file-layout-verified/`,其中 `pdf-chrome.png` 使用完整 Chromium 验证内置 PDF 阅读器;README 桌面截图同步更新,手机截图中的折叠布局继续适用。本次客户端对照以使用者提供的桌面截图为视觉依据;界面工具未提供可操作的客户端窗口,本机可取得的 Codex VS Code 客户端版本为 `26.1021.22027`,其资源位于扩展的 `webview/assets/`,桌面客户端布局的源码核对仍需对应安装资源。
|
|
223
|
+
|
|
224
|
+
单独验证发行包时执行:
|
|
225
|
+
|
|
226
|
+
```bash
|
|
227
|
+
npm run test:package
|
|
228
|
+
```
|
|
229
|
+
|
|
230
|
+
该测试在临时 npm prefix 中全局安装打包产物,检查命令入口、静态资源、构建来源、用户配置和服务生成。后端与服务管理命令使用模拟实现。安装优先复用 npm 缓存,缺少包元数据或依赖时访问配置的 registry,因此执行环境需要相应缓存或网络连接。
|
|
231
|
+
|
|
232
|
+
文件引用与批注展示回归先执行 `npm run build`,再运行 `CHROME_PATH=/path/to/chromium USER_CONTEXT=1 BROWSER_OUTPUT_DIR=.cache/user-message-context/after node tests/browser/annotations.mjs`。脚本使用隔离模拟历史,验证目录与文件引用、目录定位及子文件打开、批注原文收放、文件打开、原位编辑与取消、移除引用、批注修改及正文引用提交、刷新,以及深浅主题、80% 至 200% 缩放和窄屏。旧构建通过 `BROWSER_BUILD_DIR` 与 `BROWSER_BUILD_INFO` 指定,以 `BROWSER_BEFORE=1` 复现引用说明外露和编辑时批注协议进入输入框;截图与构建记录写入指定目录。目录跳转的修改前对照使用 `REFERENCE_NAVIGATION_BEFORE=1` 及旧构建,实际点击目录引用后确认面板保持折叠。单元与组件检查覆盖完整封装解析、普通文本保留、批注来源、编辑去重及失败重试,以及目录切换的未保存编辑确认、读取失败、目录与文件的迟到响应隔离。README 现有图片展示普通任务消息,未包含文件引用或批注,图片内容保持适用。
|
|
233
|
+
|
|
234
|
+
此次交互对照使用本机 Codex VS Code 客户端 `26.1021.22027` 的打包资源:`app-initial` 中的 `Ht`、`Ut` 与 `Sn` 分离上下文和用户请求;`src` 中的 `Su`、`Cu` 恢复文件引用,提交时生成文件上下文并保留正文;`comment-editor` 保留引用标签和路径,并在编辑模式转换时恢复。实际客户端界面控制连接不可用时,以这些实现作为行为证据,客户端运行界面的视觉对照另行记录。提取资源与查验记录仅保存在 `.cache/client-inspection/`。
|
|
235
|
+
|
|
236
|
+
右侧详情隔离回归先执行 `npm run build`,再运行 `CHROME_PATH=/path/to/chromium CONTEXT_RESET=1 BROWSER_OUTPUT_DIR=.cache/context-reset/after node tests/browser/annotations.mjs`。脚本以隔离 WebSocket 历史和独立浏览器配置,实际打开文件差异与变更面板并点击新建,检查默认收起、重新展开的概览、文件列表、深浅主题和手机布局。修改前的生产构建及构建信息分别保存在 `.cache/context-reset-before/dist` 与 `.cache/context-reset-before/build-info.json`,通过 `BROWSER_BEFORE=1`、`BROWSER_BUILD_DIR` 和 `BROWSER_BUILD_INFO` 指定并复现残留;截图和构建来源写入指定目录。组件回归补充文件、变更、子代理与待打开文件的清理,以及原对话未保存文件的恢复。README 及其他文档引用的现有截图展示任务对话与文件预览,本次修复的新建状态未出现在这些图片中,图片内容保持适用。
|
|
237
|
+
|
|
238
|
+
## 网页交互终端回归
|
|
239
|
+
|
|
240
|
+
网页手动终端通过独立的 `lan/terminal/*` 接口进入宿主工作区,由 node-pty 持有进程;模型后端、原生命令与后台任务分别按各自所有者维护。`node --test server/tests/web-terminals.test.mjs server/tests/backend-native-workspace-routing.test.mjs` 使用真实 PTY 和模拟后端,核对 Codex 与 Claude Code 标识均进入同一工作区、后端离线时仍可使用终端、连续创建五个、前台进程切换、单独结束及原生工作区路由。组件回归覆盖名称与图标更新、切换复用实例、启动目录隔离、面板开关与选中项恢复、后台目录退出隔离、Ctrl+D 及当前目录最后退出后的收起。`client/tests/terminal-workspace.test.js` 检查完整路径、中文目录及路径规范化,同目录切换后端和不同目录分别验证。
|
|
241
|
+
|
|
242
|
+
构建完成后运行 `PLAYWRIGHT_MODULE=/path/to/playwright/index.mjs CHROME_PATH=/path/to/chromium node tests/browser/terminal.mjs`。浏览器使用临时目录、真实 zsh 和 Python、隔离账户与模拟目录请求,验证五终端、zsh → Python → zsh、不同文件夹对话的隔离及返回恢复、同文件夹对话共用、列表拖动与键盘调宽、面板上边缘拖动调高、尺寸隐藏与刷新恢复、拖动期间卸载清理、双击复位、隐藏与刷新恢复、深浅主题、窄屏侧栏收放,以及 80%、125%、150%、200% 实际页面缩放和 DPR。测试环境需安装 zsh 与 Python。截图和构建来源写入 `.cache/terminal-appearance/after`;旧构建通过 `BROWSER_BEFORE=1 UI_BUILD_DIR=/path/to/dist UI_BUILD_INFO=/path/to/build-info.json BROWSER_OUTPUT_DIR=/path/to/before` 生成修改前对照。临时浏览器配置和 PTY 在退出时清理。
|
|
243
|
+
|
|
244
|
+
## 从源码运行后台服务
|
|
245
|
+
|
|
246
|
+
在项目根目录执行:
|
|
247
|
+
|
|
248
|
+
```bash
|
|
249
|
+
npm run build
|
|
250
|
+
npm run service:install
|
|
251
|
+
npm run service:status
|
|
252
|
+
```
|
|
253
|
+
|
|
254
|
+
安装脚本创建用户级 `claudex-web.service`,直接运行当前项目中的桥接服务。已有 `codex-app-server.service` 保留代理、环境和启动设置;缺失时创建后端服务。被覆盖的网页服务配置备份到用户状态目录下的 `claudex-web/service-backups`。
|
|
255
|
+
|
|
256
|
+
仅修改前端时重新构建并刷新网页。修改桥接后,通过以下命令等待任务与上下文整理结束再重启:
|
|
257
|
+
|
|
258
|
+
```bash
|
|
259
|
+
npm run service:restart-when-idle
|
|
260
|
+
```
|
|
261
|
+
|
|
262
|
+
确认任务与终端均已结束时,也可使用 `npm run service:restart`。终端状态和输出保存在桥接进程中,重启前应保护运行中的工作。迁移源码目录后,先重新安装服务以更新路径,再重启。
|
|
263
|
+
|
|
264
|
+
空闲判断只使用连接就绪状态、对话轮次与上下文整理占用。打开的网页终端与任务分别处理,等待程序只执行网页服务重启。日志在等待数量改变时更新,重启后检查 `/healthz` 并报告实际运行版本;自动化交付还需核对 `lan/state` 的所需接口。`server/tests/restart-when-idle.test.mjs` 在临时目录提供模拟 systemctl 与 HTTPS/WSS 服务,验证终端保持打开、任务和整理占用、等待期间新轮次、健康检查重试及重启失败,不操作真实服务。
|
|
265
|
+
|
|
266
|
+
源码部署与全局安装使用相同服务名,同一用户使用一套部署。从源码切换到全局包时,将项目 `.env` 中需要保留的配置迁移到用户配置目录,再按[发行包安装说明](deployment.md#安装发行包)更新服务。
|
|
267
|
+
|
|
268
|
+
桥接静态资源路由发生变化时,构建前端后还需重启网页服务。增加按需加载模块时,同时验证生产资源路由与发行包内的 JavaScript、CSS 分块。
|
|
269
|
+
|
|
270
|
+
## 打包与发布
|
|
271
|
+
|
|
272
|
+
项目通过 GitHub Release 分发预构建 npm 安装包。手动构建发行包时执行:
|
|
273
|
+
|
|
274
|
+
```bash
|
|
275
|
+
npm ci
|
|
276
|
+
npm run check
|
|
277
|
+
npm pack
|
|
278
|
+
```
|
|
279
|
+
|
|
280
|
+
`npm pack` 的 `prepack` 会重新构建网页并生成 `claudex-web-X.Y.Z.tgz`,其中 `X.Y.Z` 为根包版本。`package.json` 的 `files` 白名单包含命令行入口、前端构建资源、构建来源、桥接代码与运行脚本;开发源码、测试、聊天数据和实际环境配置在包外。运行依赖由目标机器上的 npm 安装。
|
|
281
|
+
|
|
282
|
+
日常开发保持包版本,有实际影响的变化先记入 [CHANGELOG.md](../CHANGELOG.md) 的“未发布”。准备发布时按批次选择版本:
|
|
283
|
+
|
|
284
|
+
```bash
|
|
285
|
+
npm run version:check
|
|
286
|
+
npm run version:prepare -- minor
|
|
287
|
+
```
|
|
288
|
+
|
|
289
|
+
`version:prepare` 同步包版本、锁文件、变更日志和 README、部署文档中的安装链接,并生成待审阅的发布说明。发布说明面向第三方使用者,只用简短条目说明新增可用能力、具体操作改善和可见问题修复,合并同一功能的相关修改并保留提交链接。回归测试、内部重构、协议适配、构建工具及发布流程维护等开发工作记入提交记录;安装、升级和使用内容统一维护在 README 或部署文档。版本确定后,检查、推送或上传失败均保留该版本并修复重试。
|
|
290
|
+
|
|
291
|
+
`.github/workflows/release.yml` 在推送版本标签后检查并准备 Release。工作流使用仓库的 `GITHUB_TOKEN` 和 `contents: write` 权限,将 npm 包与 SHA-256 文件完整上传到同版本草稿,并下载验证校验和、版本来源及临时全局安装。已配置定时发布的版本保持草稿,由独立的持久调度任务在目标时间主动触发 `.github/workflows/scheduled-release.yml`,GitHub cron 提供补偿检查;其他版本直接发布。持久任务须在实际非交互环境中验证调用与结果检查,并记录下次触发时间、失败重试和日志;具体建立与验收流程见[定时发布](versioning.md#定时发布与正文同步)。两个工作流共用发布并发组。独立发布说明保留一级标题,GitHub Release 正文仅上传变更列表;修改说明后,默认分支工作流同步已有 Release 的正文。发布前需在实际标签的 `GITHUB_REF_NAME` 环境下执行完整检查。标签、定时时间、附件验证及同版本重试步骤统一见[版本管理](versioning.md#准备和发布)。
|
|
292
|
+
|
|
293
|
+
如需改为 npm registry 分发,维护者需先取得包名发布权限并完成 npm 身份验证,再用实际版本替换以下 `X.Y.Z`:
|
|
294
|
+
|
|
295
|
+
```bash
|
|
296
|
+
npm publish ./claudex-web-X.Y.Z.tgz --access public
|
|
297
|
+
```
|
|
298
|
+
|
|
299
|
+
发布成功后,使用者可通过包名安装。选择作用域包名时,先修改根 `package.json` 的 `name` 并更新锁文件,再重新验证和打包;全局命令名仍为 `claudex-web`。
|
|
300
|
+
|
|
301
|
+
## 构建来源
|
|
302
|
+
|
|
303
|
+
版本来源的生成机制、开发构建标识和正式发布身份见[版本管理](versioning.md#正式版本与开发构建)。网页来源在构建时固定,源码桥接来源在进程启动时固定;排查更新时分别核对 `build-info.json` 和 `/healthz` 中的信息;网页“设置 → 关于”仅展示产品版本号。
|
|
304
|
+
|
|
305
|
+
子代理主代理消息回归先执行 `npm run build`,再运行 `CHROME_PATH=/path/to/chromium node tests/browser/subagent-messages.mjs`。脚本使用隔离模拟后端,实际打开子代理详情,验证初始任务的位置、发送者标注、后续消息自动补齐、刷新去重、只读行为及桌面深浅主题和手机布局。旧构建和构建信息分别保存在 `.cache/subagent-messages-before/dist` 与 `.cache/subagent-messages-before/build-info.json`,使用 `BROWSER_BEFORE=1` 复现只有子代理回复的状态;截图及来源保存在 `.cache/subagent-messages-browser/`。服务端测试使用临时 rollout,覆盖调用与接收者核对、轮次定位、其他代理隔离、未接收消息和写入中的尾行;组件测试覆盖实时补齐及切换隔离。README 与其他文档现有截图展示主对话、文件预览和账户状态,未包含子代理详情,现有图片保持适用。
|
|
306
|
+
|
|
307
|
+
加密消息回归在上述浏览器命令前增加 `BROWSER_ENCRYPTED=1`,使用临时父子 rollout 和真实桥接读取函数生成消息,检查加密状态、消息顺序、刷新、后续明文与深浅主题及手机布局。截图和构建来源写入 `.cache/subagent-encryption-browser/after/`。修复前的读取模块可保存在 `.cache/subagent-encryption-before/agent-messages.mjs`,再增加 `BROWSER_CIPHERTEXT_BEFORE=1` 复现密文长气泡,截图写入同目录的 `before/`。测试数据均为人工构造的记录;加密状态的单元回归同时覆盖结构化标记、非固定前缀、重复发送和其他发送者隔离。
|
|
308
|
+
|
|
309
|
+
等待接收的加密消息回归使用 `BROWSER_QUEUED_ENCRYPTED=1`,临时父记录包含已接收的初始任务和已发送的加密补充消息,子记录只包含初始任务,验证接收记录落盘前的状态及刷新后的持续隐藏。截图及构建来源保存在 `.cache/subagent-queued-browser/after/`。修改前将读取模块保存到 `.cache/subagent-queued-before/agent-messages.mjs`,增加 `BROWSER_CIPHERTEXT_BEFORE=1` 精准复现初始任务已隐藏、补充消息仍显示密文的状态,保存到 `before/`。`server/tests/agent-messages-queued.test.mjs` 覆盖接收前后、重复消息、带与不带填充的完整封包、普通前缀文字、引用封包的正文和无效封包;封包结构依据 [Fernet 规范](https://github.com/fernet/spec/blob/master/Spec.md)。
|
|
310
|
+
|
|
311
|
+
## 系统登录回归
|
|
312
|
+
|
|
313
|
+
### 对话完成通知回归
|
|
314
|
+
|
|
315
|
+
执行 `npm run build` 后,使用 `CHROME_PATH=/path/to/chromium PLAYWRIGHT_MODULE=/path/to/playwright/index.mjs node tests/browser/completion-notifications.mjs`。脚本使用独立浏览器上下文、模拟轮次及真实 Service Worker 和 IndexedDB,检查默认开启、手动关闭后的刷新恢复、待授权入口及主动授权、正常状态省略重复文案、后台完成、不同对话标题、跨页面原子去重、历史与刷新重连、开关同步及关闭期间的异步取消、失败与中断、存储失败、权限撤销、不支持的环境、通知消息跳转和新页面目标恢复。通知的原生显示接口保留真实调用,并记录实际调用数量,避免同一 tag 替换掩盖重复提醒。截图及构建来源保存在 `.cache/completion-notifications`,包含深浅主题、窄屏和 80%~200% 缩放。可设置 `HEADED=1` 在可用桌面或 Xvfb 中运行;系统横幅展示以浏览器及系统通知设置为准。
|
|
316
|
+
|
|
317
|
+
`client/tests/notifications.test.js` 验证应用层的授权、用户隔离、历史过滤、搜索列表外标题读取和生命周期清理,`client/tests/notification-worker.test.js` 验证点击时聚焦原窗口及窗口关闭后的打开目标。发行包回归检查 Worker 的交付清单及实际 HTTPS 路由。README 现有截图展示对话与文件界面,通知设置的新增入口通过专项截图核对。
|
|
318
|
+
|
|
319
|
+
### 登录与证书
|
|
320
|
+
|
|
321
|
+
`server/tests/auth.test.mjs` 通过临时 CLAUDEX_WEB_CONFIG_DIR、实际 TLS/WSS 服务及模拟 PAM 验证程序覆盖未登录访问、跨站请求、会话持久化、退出与过期、限流、维护连接及后台任务保护。测试凭据只用于隔离验证,不操作系统账户或真实 Codex 对话。`server/tests/tls.test.mjs` 检查证书并发生成、重复启动、权限与自定义证书;`server/tests/dev-https.test.mjs` 验证域名证书在本机 HTTPS/WSS 代理中的证书校验、Cookie 与来源转发。
|
|
322
|
+
|
|
323
|
+
浏览器回归使用 `CHROME_PATH=/path/to/chromium PLAYWRIGHT_MODULE=/path/to/playwright/index.mjs node tests/browser/auth.mjs`,在生产构建和临时模拟后端上实际填写登录表单,检查刷新、跨标签页退出、草稿恢复、过期、证书下载、设备安装指引、关于页隐藏开发标记、深浅主题及手机布局。截图及构建信息保存在 `.cache/auth-browser`。
|
|
324
|
+
|
|
325
|
+
Ubuntu 安装指引回归在设备选择器中实际切换 Ubuntu,检查 DER 到 PEM 转换、系统安装命令及 Chrome / Chromium 和 Firefox 导入说明,保存桌面深浅主题、手机与 80% 至 200% 缩放截图。README 和其他文档引用的截图展示对话与文件预览,未包含证书安装区域,现有图片保持适用。
|
|
326
|
+
|
|
327
|
+
固定项目排序回归先执行 `npm run build`,再运行 `CHROME_PATH=/path/to/chromium PLAYWRIGHT_MODULE=/path/to/playwright/index.mjs node tests/browser/project-priority.mjs`。脚本使用独立浏览器配置和模拟 WebSocket,对照钉选空项目、较早对话与未钉选项目的最新对话,实际点击固定、取消固定、展开收起及新建入口,验证立即重排、草稿保留和刷新恢复,并保存桌面深浅主题与手机侧栏截图。修改前先将生产构建及 `build-info.json` 保存为 `.cache/project-priority-before/dist` 和 `.cache/project-priority-before/build-info.json`,使用 `BROWSER_BEFORE=1` 复现原顺序;结果和截图写入 `.cache/project-priority/before` 与 `after`。README 现有截图中的唯一钉选项目已位于未钉选项前方,现有图片与此排序规则一致。
|
|
328
|
+
|
|
329
|
+
### Markdown 富文本输入回归
|
|
330
|
+
|
|
331
|
+
输入框采用直接编辑排版正文的交互,持久化与提交使用 Markdown。执行 `npm run build` 后,使用 `CHROME_PATH=/path/to/chromium PLAYWRIGHT_MODULE=/path/to/playwright/index.mjs node tests/browser/markdown-composer.mjs` 验证生产构建。脚本使用隔离模拟后端和独立浏览器上下文,检查双美元符号公式的同段渲染、单美元符号普通文本、闭合前源码、源码重入及撤销重做;同时检查延迟加载期间的文本及选区恢复、快速切换对话后的实例隔离、正文及列表两行的完整边界、点击与方向键定位、撤销重做、滚动后继续输入、原生光标、连续换行时的固定高度与位置、编辑区滚轮上下滚动、混合 Markdown 粘贴、表格直接编辑、任务复选框、公式、脚注、代码与 HTML 源码保留、草稿、发送及快捷建议,并覆盖深浅主题、80%~200% 缩放和窄屏。截图、结果和构建来源保存在 `.cache/markdown-composer`。组件回归使用文本输入适配,实际富文本行为由浏览器回归覆盖;发行包回归验证编辑器分块的安装与资源响应,浏览器回归拦截外站请求。
|
|
332
|
+
|
|
333
|
+
使用相同环境变量运行 `tests/browser/markdown-typing.mjs`,验证逐字键入、整段插入、粘贴和中文组合输入自动排版。覆盖列表内公式 `- $$x_{t+1}=x_{t}+dx$$`、标题、强调、链接、任务列表、表格分隔行及代码围栏进出,同时核对实际可见排版、表格光标和 Markdown 草稿。证据保存在 `.cache/markdown-typing/after`。
|
|
334
|
+
|
|
335
|
+
链接续写回归使用相同环境变量运行 `tests/browser/composer-links.mjs`,通过实际键盘及粘贴事件验证网址、Markdown 链接和自动链接末尾的空格及正文留在链接之外,检查链接内部编辑、撤销和实际提交内容,保存深浅主题及窄屏截图。结果及构建来源写入 `.cache/composer-links/after`;修改前使用 `BROWSER_BEFORE=1` 记录格式延续问题,证据写入 `before` 目录。README 和其他文档的现有截图展示普通任务与文件预览,未展示链接末尾续写状态,图片内容继续适用。
|
|
336
|
+
|
|
337
|
+
附件草稿回归先执行 `npm run build`,再使用相同环境变量运行 `tests/browser/attachment-drafts.mjs`。脚本在独立浏览器上下文中同时上传生成的测试 PNG 和文本文件,通过侧栏切换到已有对话,再通过新建入口返回,检查文字、图片原始尺寸、文件附件、对话隔离和移除后的状态,覆盖桌面、窄屏及深浅主题。截图和结果保存在 `.cache/attachment-drafts/after`;通过 `BROWSER_BEFORE=1` 与 `BROWSER_BUILD_DIR` 指定旧构建,复现文字保留而附件消失,保存至同目录的 `before`。组件回归另覆盖图片及文件读取期间切换、首次创建对话的草稿迁移、发送失败重试、实际发送的文件正文,以及发送成功后保留等待期间新增的附件。README 现有截图展示已发送消息和文件预览,图片内容继续适用。
|
|
338
|
+
|
|
339
|
+
客户端交互的本机实现参考为 Codex 26.1007.21434,查验来源是 `/usr/lib/chatgpt/resources/app.asar` 的 `package.json`、`webview/assets/app-initial-ed5807835d97.js`、`app-primary-f49030709665.js` 和 `app-shared-2d77298f0100.js`。已核对 ProseMirror 编辑区、Markdown 解析与输入规则,以及 `getPersistedText`、`setPromptText` 的草稿读写流程。当前 UI 工具未提供原生客户端窗口,本次查验采用可取得的打包实现。网页按直接编辑排版正文的产品要求,使用 Milkdown/ProseMirror 提供文档编辑与 Markdown 输入规则,并将输入语法范围明确为 CommonMark、GFM 和公式,Mermaid 与 HTML 保留源码。
|
|
340
|
+
|
|
341
|
+
### 原消息编辑回归
|
|
342
|
+
|
|
343
|
+
执行 `npm run build` 后,使用 `CHROME_PATH=/path/to/chromium PLAYWRIGHT_MODULE=/path/to/playwright/index.mjs node tests/browser/message-editing.mjs` 验证原地编辑。脚本使用生产构建、独立浏览器上下文与持久化的模拟历史,检查与底部输入框一致的背景、边框、阴影和聚焦反馈、主操作按钮配色、两行固定高度、紧凑宽度、长文本内部滚动及按钮位置稳定、铅笔图标、取消、Enter 换行、Ctrl+Enter 发送、文件引用、回退和发送失败重试、底部草稿隔离、刷新后的替换结果及切换对话时的迟到响应,覆盖深浅主题、80% 至 200% 缩放与窄屏。截图及构建来源保存在 `.cache/message-editing-browser/`。通过 `BROWSER_BEFORE=1`、`BROWSER_BUILD_DIR` 和 `BROWSER_BUILD_INFO` 指定隔离的旧构建及来源,复现恢复图标、回填底部输入和覆盖草稿,证据保存在 `.cache/message-editing-before-browser/`。领域与组件回归另覆盖完整轮次分页、旧接口兼容、运行状态、过期编辑、批注及附件独立性。
|
|
344
|
+
|
|
345
|
+
客户端对照来自本机 Codex VS Code 扩展 `26.1021.22027` 的 `webview/assets/user-message-d77a1f7e2581.js`:消息组件在原位置切换编辑表单,包含独立正文、取消和发送操作;`local-conversation-thread-a37d62aef644.js` 将编辑动作提交到 `src-622b307a9baf.js` 的历史编辑流程,校验最近用户消息与活动轮次,调用 `thread/revert` 或 `thread/rollback` 后启动新轮次。本机后端 `codex-cli 0.162.1` 生成的协议确认 `thread/revert` 以 `beforeTurnId` 替换持久历史,并通过 `thread/reverted` 通知其他页面。客户端界面控制连接超时,交互证据使用本机打包实现;提取资源仅保存在忽略目录。
|
|
346
|
+
|
|
347
|
+
编辑框尺寸的修改前对照可使用 `EDIT_SIZE_BEFORE=1`,并通过 `BROWSER_BUILD_DIR` 与 `BROWSER_BUILD_INFO` 指定修改前的生产构建和来源;结果保存在 `.cache/message-edit-size-before/browser/`。README 现有图片展示普通消息与文件预览,原地编辑框的尺寸变化通过专项浏览器截图核对。
|
|
348
|
+
|
|
349
|
+
编辑框样式的修改前对照使用 `EDIT_STYLE_BEFORE=1` 并指定旧构建及来源,记录实际输入区与消息编辑框的背景、聚焦和失焦边框、阴影及发送按钮配色;结果保存在 `.cache/message-edit-style-before/browser/`。当前构建同时比较浅色、深色及跟随系统深色,确认两处输入区域使用一致的视觉反馈。
|
|
350
|
+
|
|
351
|
+
### 计划模式回归
|
|
352
|
+
|
|
353
|
+
执行 `npm run build` 后,使用 `CHROME_PATH=/path/to/chromium PLAYWRIGHT_MODULE=/path/to/playwright/index.mjs node tests/browser/plans.mjs`。脚本使用生产构建和隔离历史,验证默认部分预览、点击与键盘展开收起、刷新恢复默认折叠、修改意见使用计划模式、批准以默认模式提交完整方案、失败重试、刷新及草稿保留;深浅主题覆盖 80%、100%、125%、150% 和 200% 缩放,并检查窄屏点击区域和横向溢出。截图、发送参数和构建来源保存在 `.cache/plans-browser`。`BROWSER_BEFORE=1 BROWSER_BUILD_DIR=/path/to/old/dist` 可在同一夹具中核对旧版正文折叠与缺少批准入口,证据保存在 `.cache/plans-before/browser`。领域与组件回归补充流式更新、重复点击、失败轮次、只读展示和切换对话后的迟到结果。
|
|
354
|
+
|
|
355
|
+
客户端行为核对依据为 Codex VS Code 扩展 `26.1021.22027` 的本机打包资源:`webview/assets/src-622b307a9baf.js` 中的 `item/plan/delta` 分派和计划执行状态,以及 `pending-request-item-panel-d13bffae20bf.js` 中的批准与修改处理。客户端批准选择默认模式并提交完整方案,修改意见继续使用计划模式;网页沿用这一提交语义,并依据 `plan-summary-item-content-27c95dedbba3.js` 的正文预览与展开交互,主对话调用在 `local-conversation-turn-6d79d254d102.js` 显式传入 `defaultCollapsed: true`;预览正文高度为 320 像素,底部渐隐并提供展开按钮。网页以字体相对尺寸实现同一预览高度,并在提交成功后更新模式,使失败请求保留重试状态。README 已有截图使用普通任务与文件预览,当前计划卡片的变化不影响这些图片的内容及说明。
|
|
356
|
+
|
|
357
|
+
### 后端归属图标
|
|
358
|
+
|
|
359
|
+
对话顶部和侧栏通过后端资源标识选择图标,保持纯图标展示。Codex 使用 `client/src/assets/openai.svg`,取自 [OpenAI 官方品牌资源](https://cdn.openai.com/brand/OpenAI-Logos-2025.zip)的黑色 Blossom SVG;标识归 OpenAI 所有,使用说明见[品牌指南](https://openai.com/brand/)。CSS 蒙版保持原有形状,以主题正文颜色显示。Claude Code 使用 `client/src/assets/claude.svg`,提取自 [Claude 官方网站](https://claude.com/)页首 Claude 标志中的独立图形路径,保留原始轮廓;标识归 Anthropic 所有。后端身份图标使用对应产品的官方标识。项目品牌图标仍由 `claudex-web.svg` 提供。
|
|
360
|
+
|
|
361
|
+
双后端回退对照记录见[双后端回归审查](architecture/backend-regressions.md)。`tests/browser/backend-regressions.mjs` 使用生产构建、独立浏览器和隔离传输验证旧未分类目录、用户消息 Markdown、引用键盘打开、Claude 内部消息来源、主题、缩放与窄屏;通过 `CHROME_PATH`、`PLAYWRIGHT_MODULE` 配置浏览器工具。`tests/integration/claude-message-provenance.mjs` 通过真实 SDK 读取临时原生 JSONL,核对来源字段保留与用户轮次归属。
|
|
362
|
+
|
|
363
|
+
后端启停回归执行 `npm run build` 后运行 `PLAYWRIGHT_MODULE=/path/to/playwright/index.mjs CHROME_PATH=/path/to/chromium node tests/browser/backend-toggle.mjs`。脚本在隔离传输中保留 Codex 与 Claude 对话,实际在设置中停用后端,核对所属对话立即从侧栏移除、正在查看的对话回到新对话、重新启用后恢复,并确认过程中未刷新页面;截图覆盖深浅主题与手机侧栏,保存在 `.cache/backend-toggle/after`。旧构建保存在 `.cache/backend-toggle-before/dist`,通过 `UI_BUILD_DIR` 与 `UI_BEFORE=1` 复现对话保留到刷新的状态,截图写入 `.cache/backend-toggle/before`。
|
|
364
|
+
|
|
365
|
+
### 自定义模型显示别名回归
|
|
366
|
+
|
|
367
|
+
执行 `npm run build` 后运行 `PLAYWRIGHT_MODULE=/path/to/playwright/index.mjs CHROME_PATH=/path/to/chromium node tests/browser/provider-model-aliases.mjs`。回归使用隔离供应商与长模型 ID,验证模型行展开、别名保存、重新编辑恢复、清空回退、原始请求标识及深浅主题、80% 至 200% 缩放和窄屏。截图保存在 `.cache/provider-model-aliases/dual`。服务端配置回归验证别名持久恢复、无效模型拒绝及移除模型后清理别名。
|
|
368
|
+
|
|
369
|
+
### 默认供应商回归
|
|
370
|
+
|
|
371
|
+
默认供应商统一在 `server/src/backends/provider-presets.mjs` 登记稳定标识、协议、地址与模型,凭据沿用受限的供应商配置存储。`server/tests/provider-presets.test.mjs` 使用临时配置验证空凭据停用、填写启用、持久恢复、运行时环境、清空撤销及公开响应隐藏凭据。
|
|
372
|
+
|
|
373
|
+
构建后执行 `PLAYWRIGHT_MODULE=/path/to/playwright/index.mjs CHROME_PATH=/path/to/chromium node tests/browser/provider-presets.mjs`,通过隔离传输验证默认项展示、仅提供 Key 编辑、Key 保存与清空、模型菜单同步、深浅主题、80%、100%、125%、150% 与 200% 实际浏览器页面缩放及窄屏。截图保存在 `.cache/provider-presets/dual`。缩放通过隔离扩展调用浏览器页面缩放接口,并核对实际缩放值、DPR 与视口。真实 DeepSeek 推理调用需使用显式提供的有效凭据。
|
|
374
|
+
|
|
375
|
+
默认供应商品牌图标必须在统一定义中提供 `icon` 标识,对应 SVG 位于 `client/src/assets/providers`,配置测试核对每个默认供应商的图标存在及默认项置顶顺序。DeepSeek 图标原样取自 [DeepSeek 官方品牌素材 ICON.svg](https://github.com/deepseek-ai/awesome-deepseek-integration/blob/main/docs/_logo%20svg/ICON.svg),标识归 DeepSeek 所有,使用遵循该目录的品牌素材规范。浏览器回归核对实际品牌图标加载与列表顺序。
|
|
376
|
+
|
|
377
|
+
### 窗口尺寸回归
|
|
378
|
+
|
|
379
|
+
执行 `npm run build` 后,使用 `PLAYWRIGHT_MODULE=/path/to/playwright/index.mjs CHROME_PATH=/path/to/chromium node tests/browser/surface-resize.mjs`。回归在生产构建、模拟后端和独立浏览器数据目录中验证公共弹窗、文件详情、图片预览和批注浮窗的拖动、键盘、双击复位、触控、失焦释放、关闭重开、刷新恢复及编辑内容保留;同时核对详情宽度与底部输入区避让一致。深浅主题、桌面和窄屏覆盖 80%、100%、125%、150% 与 200% 实际浏览器页面缩放,检查 DPR、窗口与关闭按钮边界。结果与截图保存在 `.cache/surface-resize/`。项目侧栏和终端保持独立的尺寸控件,分别沿用侧栏和终端回归。测试无需模型调用,浏览器进程和临时配置在结束时清理。
|
|
380
|
+
|
|
381
|
+
尺寸手柄状态由 `tests/browser/resize-handle-states.mjs` 统一验证。窗口回归和终端回归分别对侧栏、终端高度、终端列表、文件详情、弹窗、图片、批注和多行表单检查默认、悬停、键盘聚焦及指针捕获期间的实际计算样式,确认标记尺寸、透明操作区、拖动高亮与释放状态;同时执行真实拖动及键盘调整,检查字段内容和复位。终端回归继续使用隔离的真实 zsh/Python 进程。通过 `BROWSER_OUTPUT_DIR` 选择证据目录,`RESIZE_STYLE_BEFORE=1` 配合 `BROWSER_BUILD_DIR`(窗口)或 `UI_BUILD_DIR`(终端)可采集统一前构建的状态对照。
|
|
382
|
+
|
|
383
|
+
对话拖拽回归使用 `THREAD_FOLDER_DRAG=1 CHROME_PATH=/path/to/chromium node tests/browser/project-pins.mjs`,验证真实鼠标拖起、目标高亮、保存、刷新恢复、未分类及深浅主题,证据保存到 `.cache/project-pins-browser/after`。`node tests/integration/codex-folder-native.mjs` 使用隔离历史验证原生目录恢复,模型请求为零;`node tests/integration/thread-folder-native.mjs` 使用真实 Claude CLI 与本机模拟模型服务验证跨目录继续、旧正文及目标 AGENTS 指令,全部数据位于临时目录。网页项目以单个文件夹为归属边界。
|
|
384
|
+
|
|
385
|
+
批注换行边界回归在构建后执行 `ANNOTATION_WRAPPING=1 CHROME_PATH=/path/to/chromium node tests/browser/annotations.mjs`,使用隔离浏览器与模拟历史,逐字覆盖窄字符、中文长文、深浅主题及删除后收起。结果保存在 `.cache/annotations-browser/wrapping-results.json`。
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
# Codex Web v2.0.0
|
|
2
|
+
|
|
3
|
+
- 在浏览器中与 Codex 对话、编辑文件、查看代码差异、审查代码和使用终端([cd419c3](https://github.com/hjd-hitsz/codex-web/commit/cd419c303f31eb481945ea3e37bf7d765f3c05d6))。
|
|
4
|
+
- 支持命令行安装、后台运行和开机启动,升级时保留个人配置([147febd](https://github.com/hjd-hitsz/codex-web/commit/147febdc49526536ff9325a998eb5633f427d831))。
|
|
5
|
+
- 最近完成的对话与项目优先显示,任务过程可折叠,最终回答单独展示([86631b5](https://github.com/hjd-hitsz/codex-web/commit/86631b579261e986bb7db60572fb6203208890f8)、[cd419c3](https://github.com/hjd-hitsz/codex-web/commit/cd419c303f31eb481945ea3e37bf7d765f3c05d6))。
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
# Codex Web v2.1.0
|
|
2
|
+
|
|
3
|
+
- 可以从“未分类”直接新建聊天,每个聊天拥有独立文件夹,已有项目中的聊天保持原归属([8cfd1f6](https://github.com/hjd-hitsz/codex-web/commit/8cfd1f66b475f9138614b8195776cde7cc35acd8))。
|
|
4
|
+
- 任务中的提问以独立卡片显示,支持选择选项或填写回答,回复问题时保留输入框草稿和附件([1010608](https://github.com/hjd-hitsz/codex-web/commit/1010608e66bb6fa2bf733c52c60b8317f9f62bf7))。
|
|
5
|
+
- 在“设置 → 关于”查看网页和服务版本,方便确认更新是否生效([b249ec0](https://github.com/hjd-hitsz/codex-web/commit/b249ec0684457594910b0499acb4efad57f8f518))。
|
|
6
|
+
- 关闭网页后任务继续运行,完成后及时解除对话占用,方便切换到其他 Codex 客户端([b249ec0](https://github.com/hjd-hitsz/codex-web/commit/b249ec0684457594910b0499acb4efad57f8f518))。
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
# Codex Web v2.1.1
|
|
2
|
+
|
|
3
|
+
- 可以从“未分类”直接新建聊天,每个聊天拥有独立文件夹,已有项目中的聊天保持原归属([8cfd1f6](https://github.com/hjd-hitsz/codex-web/commit/8cfd1f66b475f9138614b8195776cde7cc35acd8))。
|
|
4
|
+
- 任务中的提问以独立卡片显示,支持选择选项或填写回答,回复问题时保留输入框草稿和附件([1010608](https://github.com/hjd-hitsz/codex-web/commit/1010608e66bb6fa2bf733c52c60b8317f9f62bf7))。
|
|
5
|
+
- 在“设置 → 关于”查看网页和服务版本,方便确认更新是否生效([b249ec0](https://github.com/hjd-hitsz/codex-web/commit/b249ec0684457594910b0499acb4efad57f8f518))。
|
|
6
|
+
- 关闭网页后任务继续运行,完成后及时解除对话占用,方便切换到其他 Codex 客户端([b249ec0](https://github.com/hjd-hitsz/codex-web/commit/b249ec0684457594910b0499acb4efad57f8f518))。
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
# Codex Web v2.1.2
|
|
2
|
+
|
|
3
|
+
- 可以切换标准或 Fast 速度,并通过滑块调整思考强度([f33929f](https://github.com/hjd-hitsz/codex-web/commit/f33929ff7f9b00628e6865145efd66a545c63fa1)、[f8fc681](https://github.com/hjd-hitsz/codex-web/commit/f8fc681888ca41ed4a01087ac568a51c5c225d11))。
|
|
4
|
+
- 输入框下方直接显示上下文使用量,对话列表支持一键归档和恢复([ae7a0d7](https://github.com/hjd-hitsz/codex-web/commit/ae7a0d7b522a914f5a4adf9438220ec52b9280b1)、[6e6b895](https://github.com/hjd-hitsz/codex-web/commit/6e6b8955bcc3b1725e27bce11e04ce3d9738ba31))。
|
|
5
|
+
- 消息中可直接显示流程图等图表,本地图片支持缩略图和点击放大([4b0fc69](https://github.com/hjd-hitsz/codex-web/commit/4b0fc69c92281ca32f65d4fe77bc173fee344681)、[b931204](https://github.com/hjd-hitsz/codex-web/commit/b931204a4be39e6e16624ddc190000ac717814aa))。
|
|
6
|
+
- 任务操作显示中文名称,思考摘要的标题和正文自动翻译为中文([ac5ca83](https://github.com/hjd-hitsz/codex-web/commit/ac5ca83df31e0c63f13f28b68883cb6b598601e5)、[dbf5088](https://github.com/hjd-hitsz/codex-web/commit/dbf50885c88c9102e7a0c1a4776242ff5df64ae0)、[b299030](https://github.com/hjd-hitsz/codex-web/commit/b2990306c056501d0daa5212e997eefba6e31353))。
|
|
7
|
+
- 任务过程集中在一个可折叠区域,生成期间持续显示最新进度([def4a52](https://github.com/hjd-hitsz/codex-web/commit/def4a52785f9b7469c14c55442d3ed06aaa8c386)、[3486644](https://github.com/hjd-hitsz/codex-web/commit/34866447ab3c6aa6c5c04d72409dcc200213f7be))。
|
|
8
|
+
- 修复新建聊天重复填入已发送消息、未分类聊天显示为独立文件夹的问题([bc204f6](https://github.com/hjd-hitsz/codex-web/commit/bc204f65b59961b810d6fc4f71b32805098977d2)、[a174097](https://github.com/hjd-hitsz/codex-web/commit/a174097bfb2ff03fb599d1db2009bc0ca772196c))。
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
# Codex Web v2.2.0
|
|
2
|
+
|
|
3
|
+
- 任务结束后集中显示修改过的文件,可查看每处增删、打开完整文件或撤销本轮对该文件的修改([0a6c642](https://github.com/hjd-hitsz/codex-web/commit/0a6c642d37d92d22b4fbc32ea8673f8ade2b11a2))。
|
|
4
|
+
- Markdown 文件直接显示排版预览,代码文件支持更多语言的高亮([36da5ba](https://github.com/hjd-hitsz/codex-web/commit/36da5ba7833e8cd376d8577bb6923ea5f174f8e8))。
|
|
5
|
+
- 可以选中回复文字添加批注,也能查看桌面端已有批注([141f8d1](https://github.com/hjd-hitsz/codex-web/commit/141f8d1236a808bac7248c78e544b7a9061f77eb))。
|
|
6
|
+
- 新对话自动生成简短标题,方便在历史记录中查找([a0c1030](https://github.com/hjd-hitsz/codex-web/commit/a0c1030a07f3bee2c3797ebb9dcc643071b45510))。
|
|
7
|
+
- 消息里的链接显示对应文件类型的图标,并适配深色和浅色主题([2da1fce](https://github.com/hjd-hitsz/codex-web/commit/2da1fceca983029f8d166cf7bf08150a70a45774))。
|
|
8
|
+
- 对话被其他客户端占用时仍可查看历史,并提供重试入口;空闲对话及时解除占用([6d53460](https://github.com/hjd-hitsz/codex-web/commit/6d53460968647e48693ac9280737e974a38de0d0)、[8f63168](https://github.com/hjd-hitsz/codex-web/commit/8f6316846c4bb178d6f48dbc6f8fa308af9e21a5))。
|
|
9
|
+
- 在其他客户端归档的聊天会同步从列表移除,未发送的草稿继续保留([37f0073](https://github.com/hjd-hitsz/codex-web/commit/37f0073774c2cf4342805efd2d7042fe1fa9fc50))。
|
|
10
|
+
- 归档与恢复聊天时项目位置保持稳定,全部归档后仍可从原项目新建聊天([c2170f8](https://github.com/hjd-hitsz/codex-web/commit/c2170f8226a19830019688bd98d4f3dd799b698e))。
|
|
11
|
+
- 思考强度面板和任务进度布局更紧凑([acf2621](https://github.com/hjd-hitsz/codex-web/commit/acf2621e1df496914234c9a4f8a4999150fc592b)、[fd6bfbc](https://github.com/hjd-hitsz/codex-web/commit/fd6bfbcb15842417806b14f6f816c4f4e487e27c))。
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
# Codex Web v2.3.0
|
|
2
|
+
|
|
3
|
+
- 聊天区右侧新增默认折叠的工作区卡片,集中查看文件、变更、终端和子代理;点击子代理可阅读其完整对话与工作过程,返回主对话后保留草稿和文件编辑内容([e4a440c](https://github.com/hjd-hitsz/codex-web/commit/e4a440c79b6b2db1f350594dfd96e58bcdaf788d)、[210a695](https://github.com/hjd-hitsz/codex-web/commit/210a69577bab649b35cc7d86ef0a8636ac0206fb))。
|
|
4
|
+
- 新增消息目录,可搜索提问和补充要求、点击跳转,并高亮当前阅读位置,桌面和手机均可使用([5f8e4eb](https://github.com/hjd-hitsz/codex-web/commit/5f8e4ebb82c0f79a8c411ac3a787f58571ffb358))。
|
|
5
|
+
- 打开对话后自动读取完整历史,向上滚动或拖动滚动条即可查看最早消息;修复打开对话及输入框恢复后滚动位置回跳的问题([2a169a0](https://github.com/hjd-hitsz/codex-web/commit/2a169a07af05932358137c7d6d57534dcfff8177)、[4e74db1](https://github.com/hjd-hitsz/codex-web/commit/4e74db13e9386bc7b18d933335847fd4e732d80a))。
|
|
6
|
+
- 聊天区右上角新增新建对话按钮,侧栏收起或使用手机时也能沿用当前工作目录新建对话([00d42e0](https://github.com/hjd-hitsz/codex-web/commit/00d42e00b58eaeb8780f7547572fcaf97e0e4f4b))。
|
|
7
|
+
- 工作过程显示实时已用时,任务结束后保留总耗时,重新打开历史对话也可查看([230bb10](https://github.com/hjd-hitsz/codex-web/commit/230bb10c88b1e069deee7a131b79a4e4e2558b40))。
|
|
8
|
+
- 侧栏、消息和输入框布局更紧凑,保持原有字号;输入框默认两行并随内容增高,文件或子代理详情展开时仍保留完整输入宽度([e4a440c](https://github.com/hjd-hitsz/codex-web/commit/e4a440c79b6b2db1f350594dfd96e58bcdaf788d))。
|
|
9
|
+
- 思考摘要优先显示标题译文,正文在折叠时提前翻译;修复旧对话长摘要经常翻译失败的问题,单条失败时其他摘要继续显示译文([3153af8](https://github.com/hjd-hitsz/codex-web/commit/3153af8861965dcbc250f126a5e70a3a242be2c6)、[560863f](https://github.com/hjd-hitsz/codex-web/commit/560863f8a22005f6818bb68efef2ebf221c683a8))。
|
|
10
|
+
- 修复发送较大图片导致连接中断的问题,保留原图;消息超过传输上限时显示明确提示,并保留草稿和附件供调整后重试([83bd049](https://github.com/hjd-hitsz/codex-web/commit/83bd0498b639a4e4f7a20ef248f1e135b6fc76c8))。
|
|
11
|
+
- 修复页面初始化期间新对话首条消息提交被打断的问题,切换对话和重连后保持当前选择及输入状态([83bd049](https://github.com/hjd-hitsz/codex-web/commit/83bd0498b639a4e4f7a20ef248f1e135b6fc76c8))。
|
|
12
|
+
- 待答问题显示在所属工作过程下方,提交后自动收纳,点击摘要可查看题目、选项和回答;提问卡片与已答记录的间距更紧凑([0f71951](https://github.com/hjd-hitsz/codex-web/commit/0f71951bdf455472bb2affa190e2a258b1da2117)、[74b482c](https://github.com/hjd-hitsz/codex-web/commit/74b482c238013baa3d0fb48376ac13128f3514dc))。
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
# Codex Web v2.3.1
|
|
2
|
+
|
|
3
|
+
- 新增 `/init` 项目指令生成与 `/goal` 任务目标管理;已有 `AGENTS.md` 可直接打开,任务目标支持编辑、暂停、恢复、清除及可选 token 预算([1e5fb6f](https://github.com/hjd-hitsz/codex-web/commit/1e5fb6f1716f6d7da869f22266caf6c5d19bb63a))。
|
|
4
|
+
- `/stop` 可查看并清理当前对话的后台终端;命令菜单、发送按钮和 Ctrl+Enter 统一处理命令参数,发送失败时保留输入与附件([1e5fb6f](https://github.com/hjd-hitsz/codex-web/commit/1e5fb6f1716f6d7da869f22266caf6c5d19bb63a))。
|
|
5
|
+
- 回复批注支持连续添加多条,在原文旁通过圆角浮层编辑,并随正文和附件一次发送;刷新、切换对话及发送失败时保留全部批注草稿([644b302](https://github.com/hjd-hitsz/codex-web/commit/644b3020ecf3d248c10512c880fa188acae57a85))。
|
|
6
|
+
- 整理上下文时持续显示状态与耗时,完成、失败或中断后恢复发送;修复提交后立即刷新导致提示消失,以及后台重连后整理状态持续卡住的问题([1e5fb6f](https://github.com/hjd-hitsz/codex-web/commit/1e5fb6f1716f6d7da869f22266caf6c5d19bb63a)、[c71c8b9](https://github.com/hjd-hitsz/codex-web/commit/c71c8b904060bba3eb354fe0174b0ee3867b7f12)、[573fb21](https://github.com/hjd-hitsz/codex-web/commit/573fb2133d23cc391073ca0486c6dd3ea3082a81))。
|
|
7
|
+
- 任务结束后,未作答的问题自动收入工作过程并显示“提问已结束”;展开记录可继续补充回答,保留尚未提交的选项和文字([6eac6b3](https://github.com/hjd-hitsz/codex-web/commit/6eac6b3e5923a63d520cfdc12a49d688d49858da))。
|
|
8
|
+
- 深浅主题采用更清晰的中性灰阶与中文字体,适度放大正文、输入框和侧栏文字,统一控件圆角与层次,同时保留全宽聊天布局([12a7e19](https://github.com/hjd-hitsz/codex-web/commit/12a7e1966ff3d775e42168e5e1b4fd6c242ecca7))。
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
# Codex Web v2.4.0
|
|
2
|
+
|
|
3
|
+
- 文件面板支持图片、音视频和 PDF 预览,Office 文档、压缩包等可下载原文件;修复部分文件链接打开后仅提示使用本机应用的问题,预览失败时可重试或下载([351ee89](https://github.com/hjd-hitsz/codex-web/commit/351ee8927efee988dd980e06bac27cd7d211756c))。
|
|
4
|
+
- 项目侧栏支持拖动右侧边缘调整宽度,按窗口空间和字体尺寸自适应;刷新和重新展开后保留调节比例,双击边缘恢复自动宽度。界面字号与间距随基础字号变化,放大字体时文字条目随内容增高,代码编辑器和终端同步调整字号与行高([610c382](https://github.com/hjd-hitsz/codex-web/commit/610c382424f2ba360362e6a983f9237f5df78e71))。
|
|
5
|
+
- 工作过程中的图片直接显示可放大的缩略图;网页搜索、打开页面、页内查找及其他工具结果展示操作、文字、链接和内容,并保留错误说明([2905c4b](https://github.com/hjd-hitsz/codex-web/commit/2905c4bff3047a961d1e1a1ade60151e7e3b945b))。
|
|
6
|
+
- 修复部分客户端对话无法查看历史的问题,自动读取完整消息;对话由另一端占用时仍可查看已保存的消息([79f56a8](https://github.com/hjd-hitsz/codex-web/commit/79f56a86194b87e488373e83495d4ddbcf4633a3))。
|
|
7
|
+
- 修复思考摘要折叠后重新展开时重复翻译的问题;同一标签页内切换对话和刷新页面继续复用译文,关闭标签页或浏览器后清空会话缓存([37ad429](https://github.com/hjd-hitsz/codex-web/commit/37ad4291d711261f06f35857e38ddbd438d36e0f))。
|
|
8
|
+
- 浏览器标签页、侧栏和欢迎页统一使用 Codex Web 专属图标,并修复部分手机浏览器仍显示默认地球图标的问题([d6e3872](https://github.com/hjd-hitsz/codex-web/commit/d6e3872bdb29d30641863bbed3cdffde7e77caec)、[21ba82c](https://github.com/hjd-hitsz/codex-web/commit/21ba82c3804eea77f00bcf3ffb25d6fe9fc0c16a))。
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
# Codex Web v2.4.1
|
|
2
|
+
|
|
3
|
+
- 左下角账户区以圆环和数字常显剩余额度,点击可查看各窗口详情、重置倒计时与具体时间;支持周额度和 5 小时额度,自动同步用量,并在回到前台或恢复连接后更新([3f72ab5](https://github.com/hjd-hitsz/codex-web/commit/3f72ab5f776b2213bde6541021948cade95acee7))。
|
|
4
|
+
- 侧栏对话标题支持鼠标悬停或键盘聚焦查看完整内容,长标题自动换行([5a04b1b](https://github.com/hjd-hitsz/codex-web/commit/5a04b1b0c154cdeecae6e83bab615ffec56e7790))。
|
|
5
|
+
- 工作过程中的网页搜索结果精简为标题链接列表,无标题时显示网址,方便浏览和打开结果([8f4d047](https://github.com/hjd-hitsz/codex-web/commit/8f4d0470529bfe1db2943be4ef8213ad2a55e52a))。
|
|
6
|
+
- 修复消息和文件预览中的 HTML 标签直接显示为源码的问题,支持标题、居中、折叠内容、文内导航及随主题切换的图片([bae860c](https://github.com/hjd-hitsz/codex-web/commit/bae860c3a4dcde447947f065959b46a779e9e53b))。
|
|
7
|
+
- 修复浏览器从后台返回并恢复连接时对话短暂消失的问题;恢复期间保留消息、阅读位置、工作过程展开状态和可编辑草稿,自动补齐断线期间的内容([6704793](https://github.com/hjd-hitsz/codex-web/commit/670479340b40b9b8fcc62b4076a966e3d4e5f93e))。
|
|
8
|
+
- 对话分支沿用客户端的数字编号,依次使用 `原标题 (2)`、`原标题 (3)`;连续创建分支保持标题长度受控,并兼容旧网页分支标题([417230e](https://github.com/hjd-hitsz/codex-web/commit/417230e9bc8b7d5c5afd01613f405ebb8ea7caa5))。
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
# Codex Web v2.4.2
|
|
2
|
+
|
|
3
|
+
- 按项目记住上次选择的模型和思考强度,同项目新建对话沿用当前选择,更换浏览器或清除站点数据后可恢复项目设置;切换模型时保留当前思考强度,目标模型缺少该档位时选择最接近的可用档位。([7885a6a](https://github.com/hjd-hitsz/codex-web/commit/7885a6a))
|
|
4
|
+
- 侧栏对话时间靠右显示,鼠标悬浮标题行时显示归档与更多按钮,键盘和触屏继续可用;运行中显示旋转圆圈,本页任务完成且尚未阅读时显示绿色圆点,阅读后清除,刷新或重新打开页面时清空提示。([c7e8597](https://github.com/hjd-hitsz/codex-web/commit/c7e8597))
|
|
5
|
+
- 新建或切换对话时收起右侧详情,文件与差异视图随所属对话显示,保留原对话中尚未保存的文件编辑。([1fa4488](https://github.com/hjd-hitsz/codex-web/commit/1fa4488))
|
|
6
|
+
- 侧栏按轮次开始与结束的最近活动时间排序并显示时间,修复新一轮运行时仍按上一轮结束时间排列的问题;打开或重命名对话保持活动顺序。([511f9ce](https://github.com/hjd-hitsz/codex-web/commit/511f9ce))
|
|
7
|
+
- 修复长对话中输入文字时的卡顿,改善语音输入一次写入大段文字及后续编辑的响应速度。([10612e0](https://github.com/hjd-hitsz/codex-web/commit/10612e0))
|
|
8
|
+
- 文件与目录引用以类型图标和蓝色链接显示,点击后在右侧查看文件或浏览目录;批注原文默认收起,消息、复制和编辑显示可读内容,编辑后保留引用与批注供统一重新发送。([7e2f781](https://github.com/hjd-hitsz/codex-web/commit/7e2f781))
|