@hjd-hitsz/claudex-web 4.1.3 → 4.1.5

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 (33) hide show
  1. package/CHANGELOG.md +36 -0
  2. package/build-info.json +4 -4
  3. package/client/dist/app.js +85 -85
  4. package/client/dist/document-editor.js +4 -3
  5. package/client/dist/style.css +1 -1
  6. package/docs/architecture/backends.md +1 -1
  7. package/docs/architecture/behavior.md +24 -10
  8. package/docs/architecture.md +18 -6
  9. package/docs/deployment.md +5 -3
  10. package/docs/development.md +17 -5
  11. package/docs/releases/v4.1.4.md +7 -0
  12. package/docs/releases/v4.1.5.md +6 -0
  13. package/package.json +6 -4
  14. package/packages/translation-engine/package.json +1 -1
  15. package/server/src/backends/claude/adapter.mjs +2 -0
  16. package/server/src/backends/claude/execution-session.mjs +29 -1
  17. package/server/src/backends/claude/provider-environment.mjs +3 -0
  18. package/server/src/backends/claude/provider-transport.mjs +29 -13
  19. package/server/src/backends/claude/runtime.mjs +15 -8
  20. package/server/src/backends/claude/worker-client.mjs +12 -5
  21. package/server/src/backends/claude/worker-server.mjs +3 -1
  22. package/server/src/backends/codex/adapter.mjs +9 -6
  23. package/server/src/backends/codex/methods.mjs +0 -1
  24. package/server/src/backends/configuration.mjs +6 -0
  25. package/server/src/backends/manager.mjs +14 -14
  26. package/server/src/backends/subagent-settings.mjs +14 -0
  27. package/server/src/service-maintenance-process.mjs +69 -0
  28. package/server/src/service-maintenance-worker.mjs +60 -25
  29. package/server/src/service-maintenance.mjs +66 -27
  30. package/server/src/workspace/file-search.mjs +244 -0
  31. package/server/src/workspace/service.mjs +17 -3
  32. package/shared/backend-activity.mjs +2 -0
  33. package/shared/subagent-settings.mjs +18 -0
@@ -72,7 +72,7 @@ Claude Code 的附加能力通过后端扩展描述提供,采用显式命令
72
72
 
73
73
  ## 已实现的模块与事实来源
74
74
 
75
- - `workspace/service.mjs` 提供共用文件、目录与网页交互终端。网页手动终端统一使用 `lan/terminal/*`,在后端路由之前由工作区服务处理;node-pty 持有实际 shell 和前台进程名称,终端按绝对启动目录隔离,同目录跨模型后端保留,代理的原生命令与后台任务保持原有路径。管理器依据所属后端路由 `fuzzyFileSearch`:Codex 沿用原生 app-server,Claude Code 调用 SDK 的原生 `file_suggestions` 控制请求,复用 CLI 文件索引;查询初始化预热索引并按目录、供应商配置与对话隔离,两者使用相同输入建议和结果展示。
75
+ - `workspace/service.mjs` 提供共用文件、目录、文件搜索与网页交互终端。网页手动终端统一使用 `lan/terminal/*`,在后端路由之前由工作区服务处理;node-pty 持有实际 shell 和前台进程名称,终端按绝对启动目录隔离,同目录跨模型后端保留。输入区的 `fuzzyFileSearch` 由工作区所有者提供。本机工作区按根目录共享 FuzzySort 索引,跨主机 Codex 通过原生 app-server 搜索实际远端路径。
76
76
  - `claude/sessions.mjs` 管理网页逻辑对话与原生会话的对应关系。`history-actions.mjs` 使用 SDK 原生分支保留消息前缀,依据原生 `forkedFrom.messageUuid` 重新建立轮次、补充输入和自动唤醒消息锚点,截断使用下一轮输入的 `parentUuid` 保留已完成轮次的全部输出附件;网页对话标识保持稳定。`nativeAliases` 将保留的历史分支归入同一逻辑对话,列表和删除后的恢复避免重复导入。
77
77
  - `session-worker.mjs` 在独立工作进程中使用同一原生配置目录调用 SDK 会话 API;SDK 选择原生 `parentUuid` 链,`native-records.mjs` 通过 SDK `importSessionToStore` 加载临时内存快照,按 UUID 补回投影省略的时间、系统子类型及错误字段。原生正文和工具结果是事实来源,索引补充已确认的轮次状态、计划类型、错误分类和文件变更。
78
78
  - `worker-client.mjs` 与独立 `worker-server.mjs` 通过受限本机 IPC 协作,执行服务持有 Claude 适配器、原生进程和后台任务。systemd 环境使用独立用户 service 及 cgroup,网页桥接关闭或崩溃后仍保留任务。IPC 目录 0700、socket 0600,双方核对用户归属。源码、入口路径或运行配置变化时,忙碌服务先继续执行,完全空闲后确认停止并替换,较旧桥接保持较新执行代际。
@@ -4,7 +4,7 @@ Codex 对话恢复遇到原生明确报告的目标线程关闭中状态时,
4
4
 
5
5
  文件夹选择器默认隐藏名称以 `.` 开头的目录。“显示隐藏文件夹”由选择器持有,切换目录时保留,重新打开选择器时恢复关闭;直接输入绝对路径仍可进入隐藏目录并选择。
6
6
 
7
- 供应商模型支持可选显示别名,按供应商及模型 ID 保存到服务端配置。供应商编辑表单默认显示紧凑模型行,点击铅笔展开别名输入,清空使用原名称;供应商保存成功后更新菜单,取消编辑或保存失败时分别放弃或保留表单草稿。模型请求与历史记录继续使用原始模型 ID。
7
+ 自定义供应商编辑表单通过显示原始模型 ID 的下拉菜单选择要配置的模型,表单按模型 ID 保存未提交草稿。连接和模型设置共用左侧标签列,显示别名与紧凑的上下文容量输入相邻,整行与模型下拉框共用输入起点和右边缘。容量居中,默认填写完整数字,点击小写 k 按钮切换单位,按钮显示选中状态并提供悬停提示。单位切换按 1k 等于 1024 tokens 转换并保留有效容量,保存时提交正整数 tokens,重新编辑显示精确容量,留空使用自动容量。任一模型的容量无效时,表单标明对应模型并保留草稿。思考强度轴的档位可独立点选或通过键盘勾选。别名按供应商及模型 ID 保存,清空使用原名称;保存成功后更新聊天模型菜单,取消编辑或保存失败时分别放弃或保留表单草稿。模型请求与历史记录继续使用原始模型 ID。
8
8
 
9
9
  活动轮次的耗时从真实开始时间持续计算,历史读取中的用户及工具消息时间保留为消息事实。轮次成功、失败或中断后使用实际结束时间固定总耗时;刷新、切换和重新展开工作过程继续沿用同一开始时间。
10
10
 
@@ -18,7 +18,7 @@ Claude 原生思考按所属 API 消息的内容块顺序保留独立标识,
18
18
 
19
19
  CLI 一键安装以当前平台原生组件完整下载为前提,完成后安装同一清单版本并校验实际 CLI。下载失败保留已有安装及版本,提供重试。CLI 检测与安装失败在设置中显示简短提示,原始错误保留在默认收起的详情中,展开后限制高度并允许长路径换行。操作成功后清理对应错误和诊断。
20
20
 
21
- 自定义供应商在列表的编辑按钮旁提供删除按钮;请求期间禁止重复操作,成功后刷新供应商及模型目录并关闭该供应商的编辑表单,失败保留列表及编辑内容并显示错误。默认供应商通过清空 API Key 停用。
21
+ 供应商操作在列表行尾右对齐,自定义供应商的编辑与删除相邻。编辑表单在所属供应商下方展开,新增表单从列表末尾的添加入口展开。保存和删除进行期间暂停供应商列表操作。删除成功后刷新供应商及模型目录并关闭该供应商的编辑表单,失败保留列表及编辑内容并显示错误。默认供应商通过清空 API Key 停用。
22
22
 
23
23
  项目模型偏好在所属后端离线时仍可读取和保存;保存成功向所有页面广播所属后端的完整项目偏好,保存失败保留原数据并允许重试。依赖执行状态的目录创建、单文件撤销、整理核对和子代理消息读取在后端就绪后执行。整理占用期间,两端统一暂停开始轮次、补充输入、审查、历史回退和再次整理,历史与项目偏好保持可读。
24
24
 
@@ -32,19 +32,25 @@ CLI 一键安装以当前平台原生组件完整下载为前提,完成后安
32
32
 
33
33
  ## 对话、项目与历史
34
34
 
35
- 输入区 `@` 提供文件、目录、技能和同后端其他会话。文件搜索对返回的全部候选按相关性排序后再截取展示数量,名称精确、前缀、连续与紧凑跳字匹配依次优先,仅父目录命中的结果靠后;文件与目录使用相同排序,同分保留原生顺序。空查询与以 `/` 结尾的目录浏览继续按目录优先、名称排序。`@` 查询包含路径分隔符时仅提供文件和目录,分隔符保持路径输入语义;独立的 `/` 查询提供快捷命令和技能。技能候选支持名称、显示名和技能目录的大小写无关模糊匹配,允许按字符顺序输入缩写与跳字;精确、前缀、连续和紧凑跳字匹配依次优先,描述关键词作为低优先级补充。Tab 将当前候选补全为可继续编辑的查询文本并保持建议打开,文件与目录补全完整路径,支持继续输入 `/` 逐级查询;Enter 或点击确认后以独立的行内引用显示,文件按扩展名区分图标,目录、技能与会话使用对应图标;菜单关闭,光标移到引用后的空格。引用节点支持两侧输入、整项删除、撤销、复制粘贴、切换与刷新草稿恢复,发送和消息编辑保持名称与目标。删除引用同时移除该项的提交数据;重复引用保留正文位置,原生元数据按目标去重。Codex 使用原生技能与 thread:// 会话引用,通过同后端只读 read_thread 工具按需读取已保存正文,Claude 技能使用原生命令,会话引用在发送时读取完整分页的用户和助手正文;读取失败保留完整草稿。代码与普通外部链接保留原语义。
35
+ 输入区 `@` 提供文件、目录、技能和同后端其他会话。本机工作区的文件和目录由统一搜索提供,目录自身名称通过前缀或跳字命中时同样优先于文件。各类型优先显示可见路径,再比较路径和名称的精确度、前缀及模糊匹配质量,较浅路径优先用于区分相同名称。显式输入隐藏路径时按匹配质量排序。跨主机 Codex 从远端接收原生候选,网页提升直接命中的目录与文件并保留其余原生次序。
36
36
 
37
- 侧栏将所有可见的活动轮次对话集中排列在置顶和项目文件夹上方,仅沿用会话行左侧的运行圆圈,省去分区标题和说明。顶部作为快捷入口按最近活动时间排序,同时保留原项目或置顶列表中的会话。成功完成且带未读绿点的会话继续保留顶部快捷入口,当前选中的顶部会话在阅读清除绿点或轮次结束后继续保留,切换会话或新建对话后再移除;其他已结束会话沿用未读状态保留顶部入口。原项目归属、置顶偏好和文件夹收放状态保持不变。活动状态沿用实时轮次事件与重连快照。
37
+ `@` 查询包含路径分隔符时仅提供文件和目录,连续匹配的层级和相邻父目录命中提高结果优先级。目录缩写可以跨越中间层,最后一段匹配候选自身名称。绝对路径和以 `./` 或 `../` 开头的路径查询从工作区内的明确位置匹配。空查询和以 `/` 结尾的查询浏览指定目录,按类型和名称排序。独立的 `/` 查询提供快捷命令和技能。技能候选支持名称、显示名和技能目录的大小写无关模糊匹配,允许按字符顺序输入缩写与跳字;精确、前缀、连续和紧凑跳字匹配依次优先,描述关键词作为低优先级补充。
38
38
 
39
- 对话列表和搜索结果以创建时间、轮次开始时间、有效结束时间中的最大值排序,显示时间沿用相同依据。打开、重命名和切换对话保留活动时间;新轮次开始和结束立即更新顺序。全分页历史补齐时保留已经收到的较新事件。两个后端独立读取,任一后端失败时保留已显示且符合当前归档和搜索范围的记录,其余后端继续更新;侧栏及搜索显示所属后端的实际错误并提供重试。相同查询保留此前已确认的正文匹配记录,修改查询及卸载后忽略旧请求结果。
39
+ Tab 将当前候选补全为可继续编辑的查询文本并保持建议打开,文件与目录补全完整路径,支持继续输入 `/` 逐级查询;Enter 或点击确认后以独立的行内引用显示,文件按扩展名区分图标,目录、技能与会话使用对应图标;菜单关闭,光标移到引用后的空格。引用节点支持两侧输入、整项删除、撤销、复制粘贴、切换与刷新草稿恢复,发送和消息编辑保持名称与目标。删除引用同时移除该项的提交数据;重复引用保留正文位置,原生元数据按目标去重。Codex 使用原生技能与 thread:// 会话引用,通过同后端只读 read_thread 工具按需读取已保存正文,Claude 技能使用原生命令,会话引用在发送时读取完整分页的用户和助手正文;读取失败保留完整草稿。代码与普通外部链接保留原语义。
40
+
41
+ 侧栏将所有可见的活动轮次对话集中排列在置顶和项目文件夹上方,仅沿用会话行左侧的运行圆圈,省去分区标题和说明。顶部快捷入口沿用对话排序,同时保留原项目或置顶列表中的会话。成功完成且带未读绿点的会话继续保留顶部快捷入口,当前选中的顶部会话在阅读清除绿点或轮次结束后继续保留,切换会话或新建对话后再移除;其他已结束会话沿用未读状态保留顶部入口。原项目归属、置顶偏好和文件夹收放状态保持不变。活动状态沿用实时轮次事件与重连快照。
42
+
43
+ 侧栏、搜索结果和标题菜单使用同一排序。进行中的对话置前,按发起当前轮次的消息时间倒序,其余对话按最近有效结束时间倒序。缺少对应时间时沿用创建时间,侧栏按排序依据显示时间。打开、重命名和切换保留排序时间,新一轮开始或结束立即重排。完整分页历史补齐时保留较新的实时开始或结束时间。两个后端独立读取,任一后端失败时保留已显示且符合当前归档和搜索范围的记录,其余后端继续更新;侧栏及搜索显示所属后端的实际错误并提供重试。相同查询保留此前已确认的正文匹配记录,修改查询及卸载后忽略旧请求结果。
40
44
 
41
45
  项目按固定状态分组,固定项目始终位于未固定项目之前,空项目及仅含置顶对话的项目同样遵循此规则,“未分类”始终位于末尾。同类项目的顺序使用页面内快照,归档、恢复和实时活动保留快照;固定与取消固定立即按新状态重新分组,各组内部沿用快照顺序。手动添加或固定的项目跨刷新保存。固定文件夹默认展开,其余默认折叠,每组先显示最新五条;“查看更多”覆盖后端全部分页。“未分类”保留独立归属,新建时按首次发送流程准备工作目录,已有目录可以沿用。
42
46
 
43
47
  侧栏对话可拖到项目文件夹或“未分类”标题,悬停高亮,保存成功后展开目标并显示对话。移入文件夹为后续轮次选用目标目录,移到未分类保留有效工作目录;运行中的轮次继续完成,后续恢复和新轮次应用迁移结果。归属保存在服务端,刷新、重新连接、归档恢复及其他页面均沿用;保存失败保留原归属、草稿及附件,并提供错误提示。置顶对话移入文件夹后取消置顶。每个网页项目对应一个文件夹,原生历史通过所属后端读取。
44
48
 
49
+ 顶部目录菜单沿用侧栏的分组顺序,仅列出当前对话列表中有记录的文件夹和“未分类”,置顶对话计入所属分组。选中其他分组直接打开排序首位的对话。标题菜单列出当前分组的对话,进行中条目沿用侧栏的转圈图标。打开对话恢复所属草稿。两个菜单标记当前项,选择当前项关闭菜单,支持方向键、Tab 和 Esc,窄屏保留两个入口。输入区底部的文件夹入口用于浏览和选取工作目录。
50
+
45
51
  主对话与子代理使用 `domain/thread-history.js` 的完整历史读取流程。仅在 `thread/items/list` 明确不受支持时回退到 `thread/turns/list` 的完整消息分页。写入被其他客户端占用时继续提供已保存历史;其他读取错误保留实际错误和重试入口。
46
52
 
47
- 分支通过 `thread-catalog.js` 的统一动作创建。读取所有未归档与已归档家族元数据,按真实 `forkedFromId` 关系生成数字后缀,兼容旧网页后缀并保留手动标题。侧栏菜单、回复操作与 `/fork` 共用流程。归档、删除和标题通知同时更新当前对话与列表,旧列表或打开响应保留通知中更新的结果。
53
+ 分支通过 `thread-catalog.js` 的统一动作创建。并行读取所属后端的未归档与已归档家族元数据,按真实 `forkedFromId` 关系生成数字后缀,兼容旧网页后缀并保留手动标题。创建及命名确认后打开分支,历史从最近一页开始加载,侧栏随后补齐。Codex 新分支的输入状态取自原生创建结果。用户在创建期间切换对话时,分支加入列表并保留当前选择。侧栏菜单、回复操作与 `/fork` 共用流程。归档、删除和标题通知同时更新当前对话与列表,旧列表或打开响应保留通知中更新的结果。
48
54
 
49
55
  Codex 首轮发送后,桥接使用独立连接及临时会话生成简短标题;写入前重新读取目标记录。手动改名、归档、删除及断线取消旧生成任务,生成失败可在后续打开或发送时重试。标题生成的消息和订阅与用户对话隔离。Claude Code 对话沿用其原生标题与网页保存的用户名称。
50
56
 
@@ -52,6 +58,8 @@ Claude Code 的模型会话和后台任务由独立执行服务持有。网页
52
58
 
53
59
  ## 输入、草稿与执行
54
60
 
61
+ 切换对话后,目标对话的输入框可编辑时自动聚焦,光标落在恢复的草稿末尾。富文本编辑器加载期间先聚焦临时文本框,加载完成时交接当前焦点和选区。连续切换时,焦点跟随最终打开的对话。
62
+
55
63
  图片及其他附件随所属对话在当前页面内保留,切换到其他对话再返回时恢复原附件列表;尚未首次发送的新对话同样恢复。移除附件后保持移除,首次发送创建实际对话时迁移附件草稿。一次选择多个文件时,在文件选择框重置前取得全部文件,并将每个文件的读取绑定到原草稿。异步文件读取完成后更新原草稿,发送失败保留附件供重试,发送成功仅清理已提交附件,保留等待期间新增的附件。
56
64
 
57
65
  正文输入即时更新独立草稿订阅,按对话持久保存。正文编辑区默认容纳两行,随正文、代码及公式的实际高度自动增高,到达可用空间上限后在内部滚动。上边缘公共手柄支持向上拖动增高、方向键调节及双击或 Home 恢复自动高度,手动高度按可用空间比例保存并跨刷新恢复;展开入口打开居中的编辑窗口,复用同一文档实例和撤销栈;底部保留放大前的正文预览、输入框轮廓、工具栏及原有尺寸,页面布局与阅读位置保持连续,背景预览通过隔离节点提供只读展示;通过关闭按钮、Esc 或收起入口返回紧凑输入,保留草稿、选区及原高度选择。编辑窗口复用公共窗口手柄,支持拖动、键盘调节、复位及尺寸偏好恢复。窄屏、缩放及附件变化重新限制高度,发送工具栏保持可见。普通正文和同级列表完整显示,光标与选区由浏览器原生维护;滚动后继续输入时定位到真实编辑位置。加载期间的文本、焦点及完整选区交接给文档编辑器,对话切换后旧实例只清理自己的输入适配。Ctrl+Enter 与发送按钮走同一提交入口,Enter 保留换行;组合输入确认保持正常编辑。输入期间共享状态快照稳定,长历史和文件面板保持渲染隔离。
@@ -74,15 +82,19 @@ Markdown 输入以逐字键入后自动排版为主要交互,选区格式工
74
82
 
75
83
  链接末尾续写时使用普通正文格式,空格及后续文字保留在链接之外;链接内部继续支持编辑显示文字。粘贴网址、Markdown 链接和草稿恢复遵循同一边界。
76
84
 
85
+ 在底部输入区或原位消息编辑框粘贴带代码编辑器语言信息的单行片段时,片段以行内代码插入当前段落,剪贴板末尾的单个换行按行结束符处理。前后正文及一次撤销的范围保持完整。多行片段保留原语言及代码围栏,粘贴网页行内代码保留其行内格式。
86
+
77
87
  最近一轮的初始用户消息提供铅笔形“编辑上一条消息”入口;原消息位置切换为紧凑的 Markdown 编辑框,正文固定两行并通过内部滚动查看长内容;宽度最多为 42rem,窄屏内最多占消息区的 90%。背景、边框、阴影和聚焦边框与底部输入框共用规则,发送使用主操作配色,深色及跟随系统主题同步适配。支持取消、发送、Enter 换行与 Ctrl+Enter 提交。编辑正文、引用附件和批注由消息组件独立持有,底部草稿保持原值。运行中补充消息继续通过运行轮次发送,历史编辑针对完整轮次。
78
88
 
89
+ 原位编辑框独立于底部输入区的高度偏好及调节手柄,打开、取消及重新打开均保持两行布局,保留 Markdown 文件引用的名称与目标。
90
+
79
91
  编辑提交先读取完整分页核对最近消息及运行状态,通过 `thread/revert` 回退到原轮次之前;仅在该方法明确不支持时使用 `thread/rollback`。成功回退后清理已移除的历史、时间与差异,再提交新轮次,刷新以实际后端记录恢复。回退失败保留原历史,发送失败保留编辑框及输入,重试核对保留轮次并复用已成功的回退。取消已回退的失败编辑时读取实际历史。连接、写入检查、整理及运行状态限制提交,异步读取和回退响应按对话及打开版本隔离;回退使较早的历史分页请求失效。其他页面收到 `thread/reverted` 时重新恢复所属对话。
80
92
 
81
93
  Claude Code 编辑及分支通过原生会话分支保存保留前缀,网页逻辑对话与保留轮次标识稳定,原生 UUID 和后台自动唤醒锚点随分支更新。保留的原生别名归属原逻辑对话,列表和删除恢复保持去重;发送失败后重试沿用已成功完成的历史回退。
82
94
 
83
95
  ## 批注、引用与提问
84
96
 
85
- 文件引用建议在两个后端保持相同操作:Codex 沿用原生 app-server 查询,Claude Code 通过原生 `file_suggestions` 查询。Claude Code 对话的 `@关键词` 使用 CLI 文件索引和匹配规则,包含文件、目录与中文名称;`@` 及以 `/` 结尾的路径沿用目录浏览。搜索读取失败时显示实际错误,用户可修改关键词重试。
97
+ 文件引用建议在两个后端保持相同操作:Codex 沿用原生 app-server 查询,Claude Code 通过原生 `file_suggestions` 查询。Claude Code 对话的 `@关键词` 使用 CLI 文件索引和匹配规则,包含文件、目录与中文名称。搜索读取失败时显示实际错误,用户可修改关键词重试。
86
98
 
87
99
  用户消息正文与助手正文共用 Markdown、GFM、公式及安全过滤渲染器,复制和编辑保留 Markdown 源码。引用仅在 Markdown 文本节点中转换,代码、链接和公式保持自身语义。
88
100
 
@@ -157,7 +169,7 @@ Claude Code 的原生后台任务按所属会话保存任务标识、类型、
157
169
 
158
170
  ## 子代理与共享渲染
159
171
 
160
- 设置中的每个后端在同一行提供子代理模型、思考强度和保存操作。模型选项从可用目录取得并以“供应商 / 模型”展示,Codex 候选遵循模型显示偏好。已选模型被隐藏后,以状态占位保留已存配置,候选中省去其名称,恢复显示后恢复选择。强度档位随模型能力提供,选择“原生默认”清除模型覆盖,选择“默认强度”清除强度覆盖。Claude 支持跨已配置供应商选择,原生账户模型使用其解析后的实际 ID。保存保护活动轮次与后台占用,失败保留选择,成功后广播并恢复持久配置。Codex 使用原生默认子代理模型,显式任务及自定义代理模型沿用原生优先级;Claude 使用原生强制子代理模型参数,原生 fork 及指定继承模型的技能继续遵循 CLI 的继承语义。模型选择、主供应商及主对话状态保持各自所有权。
172
+ 设置中的每个后端在同一行提供子代理模型、思考强度和保存操作。模型选项从可用目录取得并以“供应商 / 模型”展示,Codex 候选遵循模型显示偏好。已选模型被隐藏后,以状态占位保留已存配置,候选中省去其名称,恢复显示后恢复选择。强度档位随模型能力提供,选择“原生默认”清除模型覆盖,选择“默认强度”清除强度覆盖。Claude 支持跨已配置供应商选择,原生账户模型使用其解析后的实际 ID。保存直接校验并持久化默认值,保持后端连接、原生主会话和活动任务,完成后广播配置并结束本次请求。后续原生会话配置读取使用最新值,Claude 下一轮通过原生会话级设置更新子代理默认选择,已启动子代理保留原路由及模型。保存失败保留选择并允许重试,清空后恢复原生默认;保存响应直接更新配置,模型目录与账户读取独立于保存操作。Codex 使用原生默认子代理模型,显式任务及自定义代理模型沿用原生优先级;Claude 使用原生强制子代理模型参数,原生 fork 及指定继承模型的技能继续遵循 CLI 的继承语义。模型选择、主供应商及主对话状态保持各自所有权。
161
173
 
162
174
  Claude 子代理原生历史中,带有 `isSidechain=true` 与 `agentId` 的任务输入以侧链来源建立轮次,即使继承 SDK 入口和父轮次 `promptId`。主对话内部通知继续按其来源字段过滤,子代理任务、工具和回答完整恢复。
163
175
 
@@ -227,12 +239,14 @@ Claude Code 网络代理在设置中提供跟随服务环境、关闭和 HTTP,
227
239
 
228
240
  ## 网页更新与重启
229
241
 
230
- 设置中的“更新与重启”显示当前版本、npm 最新稳定版与检查错误。桥接启动时及每小时自动检查,网页发现更新提供设置入口。npm 全局安装可更新并重启,源码部署使用源码更新流程。重启服务在当前版本下同样可用,操作要求当前进程属于安装的 systemd 用户服务。整个网页服务进程重启,网页交互终端随之结束,原生后端继续按各自生命周期执行。独立维护任务持久记录进度,重复操作合并,安装与启动失败提供错误及重试。新包先在隔离目录安装并验证,替换后启动失败恢复原包。网页重连后保留草稿和文件编辑,用户保存编辑后主动刷新页面加载新资源。
242
+ 设置中的“更新与重启”显示当前版本、npm 最新稳定版与检查错误。桥接启动时及每小时自动检查,网页发现更新提供设置入口。npm 全局安装可更新并重启,源码部署使用源码更新流程。重启服务在当前版本下同样可用。systemd 用户服务沿用原服务重启,直接启动的进程通过独立维护进程按原 Node.js、参数、目录及环境重新启动。整个网页服务进程重启,网页交互终端随之结束,原生后端继续按各自生命周期执行。独立维护任务持久记录进度,重复操作合并,安装与启动失败提供错误及重试。新包先在隔离目录安装并验证,替换后启动失败恢复原包并核对启动结果。网页重连后保留草稿和文件编辑,用户保存编辑后主动刷新页面加载新资源。
231
243
 
232
- 更新及重启请求遇到活动轮次、后台任务、排队输入、待答提问、内部命令或上下文整理时,结束本次操作并短暂提示用户结束任务后重试。提示五秒后关闭,用户稍后重新发起操作。切换阶段暂停网页提交,避免提交与重启竞争。重启成功后网页显示“服务已重启,请刷新网页”,用户自行刷新。
244
+ 更新及重启请求遇到活动轮次、后台任务、排队输入、待答提问、内部命令、上下文整理或后端 CLI 安装时,结束本次操作并短暂提示用户结束任务后重试。提示五秒后关闭,用户稍后重新发起操作。切换阶段暂停网页提交,避免提交与重启竞争。重启成功后网页显示“服务已重启,请刷新网页”,用户自行刷新。
233
245
 
234
246
  npm 更新沿用网页服务的 Node.js/npm 路径、npm 配置及网络代理与证书环境,支持 NVM 和自定义用户安装目录。独立维护单元启动失败时立即恢复网页提交,保留失败结果并允许重新执行维护操作。
235
247
 
248
+ 发现新版时更新按钮可点击,重启按钮在空闲时可点击。部署方式与服务管理条件由服务端在操作请求中校验,失败原因显示在更新卡片内,并允许再次操作。错误、维护进度与完成提示统一放在卡片内的产品信息和操作组下方,长文本按卡片宽度换行。请求及维护任务执行期间暂时禁用按钮;版本检查确认无需更新时保留“无需更新”的禁用状态。
249
+
236
250
  发现新版本后,侧栏底部显示带版本号的更新入口并标记设置按钮;侧栏收起或窄屏时,顶部显示紧凑更新入口。设置页按更新与重启、模型与服务配置、其他设置、网页登录分组。更新卡片集中显示产品身份和主操作,当前与最新版本在产品名下同行显示,产品图标、版本信息与检查更新、重启服务、更新按钮在卡片中垂直居中并同行排列,空间不足时操作组整体换行,三个按钮保持同行,复用设置页按钮的尺寸和边框,主要更新操作位于右侧,有新版时显示“更新至版本号”,无需更新时显示灰色禁用的“无需更新”,按钮数量与位置保持稳定;检查期间显示进行状态。设置卡片通过间距区分内部内容。其他设置的选项间距保持一致,状态与错误说明紧随所属选项并与选项文字对齐。原生后端的当前版本合并到标题行,正常连接以状态点显示,安装操作失败作为本次设置访问中的短暂提示,重新打开设置跳过历史安装提示,有新版时在按钮直接显示目标版本并允许更新,版本相同或本机更新时保留灰色禁用的“无需更新”按钮;未安装、停用及连接失败保留文字状态。网页主题始终跟随系统。点击更新入口直接打开设置并滚动、聚焦“更新与重启”区域。界面只显示版本、操作与必要状态,检查周期及部署实现保留在部署文档。
237
251
 
238
252
  维护任务的持久结果用于状态核对,操作提示归属当前设置访问。首次加载、刷新及重新打开设置跳过历史完成和失败提示;当前访问发起的操作按任务开始时间确认结果并只显示一次。关闭设置清除提示并使在途请求的后续反馈失效,后台任务继续按真实状态执行。代理保存反馈五秒后消失,表单错误和实际连接、下载故障按各自当前状态提供处理入口。
@@ -127,11 +127,11 @@ flowchart LR
127
127
 
128
128
  ### 3.2 应用控制器的所有权
129
129
 
130
- - `thread-records.js`:历史活动时间、轮次修订、名称修订与已删除记录。它负责协调迟到列表和实时事件的优先级。
130
+ - `thread-records.js`:轮次开始与结束时间、轮次修订、名称修订与已删除记录。它负责协调迟到历史和实时事件的优先级。状态容器在列表或活动轮次变动时应用领域排序。
131
131
  - `thread-navigation.js`:新建、打开、历史加载、写入能力检查及实际对话创建。`opening` 修订号标识当前打开动作,连接版本共同限定读取结果的目标。
132
132
  - 附件草稿由导航控制器按对话在页面内存中保存,未首次发送的新对话使用独立草稿。切换时恢复目标附件,创建实际对话时迁移原草稿;图片读取和发送清理持有草稿对象,迟到结果继续归属原对话,成功仅移除已提交快照中的附件。
133
133
  - 打开主对话时,轮次时间恢复与消息读取并行;历史读取的首个消息分页回调负责提前交付最近记录并启动写入能力检查,其余分页完成后统一合并。首屏记录作为读取基线,期间到达的实时修改继续优先。后台重连读取沿用完整合并,保留现有界面。
134
- - `thread-catalog.js`:完整列表、项目分组、固定、归档、删除、重命名和分支命名。拖放归属通过服务端保存,通知与响应按归属版本合并,当前对话同步有效目录及未分类状态。创建分支前读取完整家族元数据。
134
+ - `thread-catalog.js`:完整列表、项目分组、固定、归档、删除、重命名和分支命名。拖放归属通过服务端保存,通知与响应按归属版本合并,当前对话同步有效目录及未分类状态。创建分支前并行读取所属后端的已归档与未归档家族元数据。命名成功后以分支响应打开历史,完整列表随后同步。Codex 分支响应已确认写入并携带模型设置,直接用于初始化新对话。
135
135
  - `messages.js`:输入快照、附件、引用与批注合成、首次发送、运行中补充、提问回答和计划批准。计划批准按当前方案与轮次复核,复用发送用例,以默认模式提交完整计划;成功后通过状态容器更新原对话的模式,切换后的当前对话保持独立。失败保留可重试内容,成功只清理与已提交快照一致的草稿。
136
136
  - `message-editing.js`:编辑重发的后端历史核对、回退、重试与已移除轮次状态清理。原地编辑器持有正文、附件和批注,编辑会话记录已成功回退后保留的轮次,用于避免重试时重复回退;底部草稿继续由原输入流程持有。回退前使导航控制器中已有的历史读取失效,其他页面的回退通知通过对话导航恢复实际历史。
137
137
  - `models.js`:新对话的项目模型与思考强度选择、本地待保存记录、服务端同步和恢复时的选择版本。已有对话的模型与思考强度由导航控制器按后端对话读取和恢复结果取得;连接初始化只为新对话应用项目默认选择,恢复期间的手动调整按选择版本保护。
@@ -201,6 +201,8 @@ sequenceDiagram
201
201
 
202
202
  Codex 原生适配全部位于 `backends/codex/`。`adapter.mjs` 组合原生传输与公共网页操作;`upstream.mjs` 持有 app-server 握手、请求编号、超时及重连;`subscriptions.mjs` 持有原生订阅、写入恢复及空闲释放;`requests.mjs` 与 `events.mjs` 分别处理原生请求和事件;`compaction-recovery.mjs` 通过原生历史核对整理结果。Codex 的原生命令执行和标题生成沿用原有调用链。
203
203
 
204
+ Codex 目标查询直接读取原生已持久化状态,页面显示目标时省去加载写入会话。发送新轮次继续按实际订阅恢复写入。已有列表记录的顺序随实时轮次状态更新,列表全量同步在记录尚未显示或轮次结束时执行。
205
+
204
206
  Codex 适配器在原生新建、恢复和分支参数中加入 `claudex_references` 只读 MCP 配置,保留原有会话配置并沿用实际后端地址,不修改原生全局配置。原生 CLI 持有 `reference-mcp.mjs` 子进程,它直接连接同一 app-server,提供带游标的 `read_thread` 用户与助手正文读取,网页断开不影响读取。引用按 `thread://` 目标提交并提示代理通过该工具读取;读取结果作为历史参考数据。单元测试覆盖配置合并、分页、后端隔离与错误,`tests/integration/codex-reference-tools.mjs` 用真实 CLI 验证 MCP 注册和调用,隔离模拟历史数据并保持模型调用为零。
205
207
 
206
208
  Codex 取消订阅在原生响应确认后结束本连接的释放;其他连接仍持有订阅时原生会话继续存在。后续请求等待取消订阅响应,发送按原生恢复流程重新订阅。Codex 0.169.0 的关闭任务在响应后异步完成,`thread/resume` 在此期间返回目标线程的明确 closing 错误。原生传输通过 `resume-lifecycle.mjs` 将该恢复请求保留到对应 `thread/closed` 到达后重新发送一次,关闭事件先到时同样处理;严格核对原生错误码、完整文本和目标 ID,其他错误直接结算。网页请求及内部写入恢复共用此流程,沿用原请求的 120 秒期限,超时或断线清理等待,运行轮次只在恢复成功后提交。`thread/closed` 同时清理实际已卸载会话的状态。
@@ -245,16 +247,18 @@ Claude 网页桥接重启或异常退出时,独立执行服务继续持有模
245
247
 
246
248
  `goals.mjs` 与 `background-tasks.mjs` 分别拥有目标与原生后台任务状态;网页交互终端归共用工作区服务。`catalogue.mjs` 从实际目录与运行时读取模型、命令、插件、代理及 MCP。`account.mjs` 区分原生账户额度与外部供应商计费,`token-usage.mjs` 将原生用量及上下文查询转换为统一展示。列表与搜索归集后端读取错误,保留失败后端已有的同范围记录并支持重试。
247
249
 
248
- 文件引用查询按对话所属后端路由:Codex 的 `fuzzyFileSearch` 继续由原生 app-server 处理,Claude Code 由 `catalogue.mjs` 调用原生 `file_suggestions`,复用 CLI 的文件索引及建议。持续会话和目录查询会话在初始化时预热原生索引;目录、供应商配置与对话标识限定查询归属,前端统一展示文件和目录。验证同时核对已有 Codex 路径、Claude 原生结果和真实工作区的查询表现。
250
+ 文件引用查询由管理器依据工作区归属路由。Claude Code 和回环地址的 Codex 通过 `workspace/service.mjs` 调用本机搜索,其他 Codex 地址通过原生 `fuzzyFileSearch` 获取远端结果。路径、显示名称和文件类型使用统一返回结构。本机结果携带已排序标记,浏览器按服务顺序展示;远端结果继续由网页领域层调整优先级。
249
251
 
250
252
  新增供应商及预置 DeepSeek 默认使用原生 Message API,原生请求保留中途系统消息;自定义模型显式配置的能力优先于 CLI 模型目录。历史自定义供应商缺少协议字段时沿用原有兼容模式,编辑保存保留其实际协议。Message API 兼容模式使用顶层 `system` 承载系统上下文,用户正文与工具调用继续保留原始内容块和顺序。协议转换在首次请求前完成,并保留原生思考控制、结构化输出及辅助评估请求;处理规则与原生接口依据见双后端产品契约。文件变更通过工具钩子记录前后内容,撤销复用现有补丁校验。能力声明描述模型参数、外部事实和原生扩展,通用产品入口使用统一契约;原生历史跨运行时交接属于独立设计。
251
253
 
252
254
  外部供应商的模型环境由 `provider-environment.mjs` 生成,主模型与 Opus、Sonnet、Haiku 三个原生别名随本轮选择一起更新。初始化与持续会话共用映射,运行时等待原生模型和设置更新完成后提交输入,设置失败按本轮错误结算并允许重试。
253
255
 
254
- 两个后端的子代理模型由网页后端配置独立持有,保存沿用管理器的占用检查与空闲替换事务。Codex 在新建、恢复和分支中传入原生 `agents.default_subagent_model` 与 `agents.default_subagent_reasoning_effort`,保留主模型与显式任务模型的原生优先级。Claude 通过原生子代理模型环境设置选择模型,`provider-transport.mjs` 为跨供应商目标生成会话专属模型标识,只将匹配请求路由到目标供应商,并恢复真实模型 ID、目标协议与凭据。Claude 子代理默认强度通过 `CLAUDE_CODE_SUBAGENT_EFFORT` 传入。显式配置的子代理模型请求同时按所属标识设置 `output_config.effort`,使主会话环境中的强度覆盖继续只影响主请求,计数请求保留原参数。同名模型保持隔离。原生账户目标使用 `@native` 标识和模型目录解析出的真实 ID,`native-provider.mjs` 按请求读取原生认证环境或 CLI OAuth 文件,凭据只在服务端使用。持续会话每轮核对目标供应商,目标配置变化时按已有后台占用规则重建,停用或删除后明确报错。输入区模型目录同时为设置页提供“供应商 / 模型”下拉选项,Codex 通过同一 `hiddenModels` 偏好过滤候选。模型与思考强度同行展示,强度选项来自所选模型的 `supportedReasoningEfforts`,切换到不支持当前强度的模型时清除该强度选择。控件仅持有尚未保存的模型、强度及错误。
256
+ 两个后端的子代理默认值由网页配置独立持有,保存直接校验、原子写入并广播,保持后端连接、执行服务及当前轮次。前端使用保存响应更新配置,保存链路只包含这一次请求。管理器向 Codex 适配器注入配置读取入口,Claude 独立执行服务从同一配置文件读取;Codex 在原生新建、恢复和分支前读取最新值,Claude 在每轮提交前读取并通过原生会话级设置应用。子代理偏好从执行服务代码与启动配置的代际比较中排除。Codex 在新建、恢复和分支中传入原生 `agents.default_subagent_model` 与 `agents.default_subagent_reasoning_effort`,保留主模型与显式任务模型的原生优先级。Claude 通过原生子代理模型环境设置选择模型,`provider-transport.mjs` 为跨供应商目标生成会话专属模型标识,只将匹配请求路由到目标供应商,并恢复真实模型 ID、目标协议与凭据。Claude 子代理默认强度通过 `CLAUDE_CODE_SUBAGENT_EFFORT` 传入。显式配置的子代理模型请求同时按所属标识设置 `output_config.effort`,使主会话环境中的强度覆盖继续只影响主请求,计数请求保留原参数。同名模型保持隔离。原生账户目标使用 `@native` 标识和模型目录解析出的真实 ID,`native-provider.mjs` 按请求读取原生认证环境或 CLI OAuth 文件,凭据只在服务端使用。持续会话每轮核对目标供应商,子代理目标或强度变化时更新会话级设置并生成新的专属路由标识,主会话进程继续运行。旧路由随会话保留,使已启动子代理继续使用其原模型、强度和凭据;清空默认值恢复原生默认选择,停用或删除的供应商明确报错。输入区模型目录同时为设置页提供“供应商 / 模型”下拉选项,Codex 通过同一 `hiddenModels` 偏好过滤候选。模型与思考强度同行展示,强度选项来自所选模型的 `supportedReasoningEfforts`,切换到不支持当前强度的模型时清除该强度选择。控件仅持有尚未保存的模型、强度及错误。
255
257
 
256
258
  ## 5. 功能模块与共享展示
257
259
 
260
+ 顶部文件夹和对话标题复用 `app/header-switcher.jsx` 的菜单、键盘与焦点管理。两者共享侧栏的分组及排序。选择文件夹打开排序首位的对话,选择标题打开对应对话,进行中条目共用侧栏的转圈图标。
261
+
258
262
  `features/conversation` 组合消息、工作过程、提问和目录。领域层负责按轮次分组与排序;主对话和子代理的只读详情使用相同历史读取和展示规则。计划正文由独立的 `plan-message.jsx` 展示,默认保留约 320 像素的正文预览(用字体相对单位定义),底部渐隐并提供展开入口;收放状态由卡片组件持有,流式更新保留用户选择,卸载后恢复默认折叠,领域层 `plans.js` 根据最新用户消息、计划消息与成功轮次确定批准资格;步骤进度保持独立。工作过程记录、最终回答操作以及本轮文件汇总分别渲染,保持流式过程与历史恢复的顺序一致。
259
263
 
260
264
  主对话按消息快照一次建立轮次到记录的索引,供文件汇总复用;文件汇总按记录、净差异及工作目录缓存计算。Markdown 组件按正文、批注内容和目录复用解析结果,内部媒体和主题更新保持各自订阅。历史前插时,消息区根据前后滚动高度补偿阅读位置;自动跟随时继续定位到真实底部,视口快照归消息区所有并在切换时清理。
@@ -269,7 +273,7 @@ Mermaid 的流程图主方向转换归 `domain/mermaid.js`,原始正文保持
269
273
 
270
274
  `app` 将输入框和错误提示作为底部插槽传入对话布局。对话布局统一提供消息、底部输入和右侧详情的几何边界;桌面展开详情时输入区域避让右侧面板,详情占满工作区高度。文件下载入口归文件面板工具栏,媒体预览组件负责内容展示及加载重试。
271
275
 
272
- `domain/file-suggestions.js` 负责将原生文件候选按名称与查询路径的相关性统一排序,展示数量在排序后限制;后端继续持有原生索引与查询生命周期。
276
+ `workspace/file-search.mjs` 持有本机工作区按根目录隔离的短期内存索引,并合并同目录的在途扫描。扫描应用各级 `.gitignore` 和 `.ignore`,索引条目保留原始路径和类型。符号链接目录可作为条目引用,递归扫描沿工作区中的实际目录进行,`.git` 元数据可通过目录浏览访问。FuzzySort 匹配文件名称和路径,候选按目录、可见性与名称或路径相关性排序。扫描范围与 60 项返回上限独立,索引按批搜索以让出事件循环。服务关闭时取消在途工作并释放索引。浏览器以查询代次隔离迟到响应;`domain/file-suggestions.js` 负责远端原生候选的重排。
273
277
 
274
278
  `domain/skill-suggestions.js` 拥有技能建议的模糊匹配与排序规则,`@`、`/` 和技能面板共用该规则。
275
279
 
@@ -279,6 +283,10 @@ Mermaid 的流程图主方向转换归 `domain/mermaid.js`,原始正文保持
279
283
 
280
284
  输入区的 `markdown-editor.jsx` 按当前对话异步挂载 Milkdown/ProseMirror 文档编辑器。`document-editor.js` 组装 CommonMark、GFM 和数学能力,逐事务将 Markdown 同步到既有草稿订阅;`document-input-rules.js` 处理整段输入与代码围栏的进入和退出,`document-table-input.js` 将表头及分隔行转换为可编辑表格,`document-list.js` 同步维护列表内容与任务复选框,保持连续键入的光标位置。`document-math-schema.js` 统一解析和序列化双美元符号公式,将同一行和换行写法都表示为行内数学节点;单美元符号保留普通文本。`document-math-input.js` 在编辑器输入入口保留未闭合源码,闭合后在当前段落生成公式并将光标留在公式后。`document-math-view.js` 提供行内公式展示与源码重入,草稿与提交统一保存 `$$公式$$`;Crepe 自带的单美元符号和数学块功能关闭。选中文字时展示格式工具,常规输入直接按 Markdown 语法排版。文档选区与 Markdown 源码位置的转换由 `editor-selection.js` 提供,快捷建议沿用输入适配接口。`document-clipboard.js` 直接将 Markdown 解析结果作为原生文档切片插入,按段落边界合并前后正文,并为末尾块提供正文续写位置;公式粘贴拦截限定在已打开的公式源码内。`composer.jsx` 持有输入框展开状态,展开按钮与发送操作同行;`composer-surface.jsx` 通过原生 dialog 的顶层模态窗口提供集中编辑,窗口切换保留相同文档 DOM、编辑器实例和撤销栈,沿用公共窗口尺寸偏好与手柄;放大前捕获输入区的排版与滚动位置,`composer-placeholder.jsx` 在原位置保留同尺寸只读预览,通过隔离的 Shadow DOM 复用本站样式,预览退出焦点与辅助功能树,关闭及 Esc 返回原输入位置;`editor-frame.jsx` 持有自动高度、手动高度偏好及公共手柄的拖动生命周期,按文档实际高度增高,手动偏好按工作区可用高度比例持久保存;容器、附件及视口变化重新约束高度,工具栏保持可见。`.document-editor-viewport` 是正文的纵向滚动容器,内部 ProseMirror 文档按内容自然排版;正文段落、列表及引用共用输入区字号与行高。仅导入已启用功能的组件样式,基础排版由项目样式定义。使用浏览器原生光标与选区,取消虚拟光标绘制。异步加载期间使用独立持有的文本框,初始化后接收最新草稿、焦点和完整选区;对外输入适配按实例发布与清理,卸载使异步回调失效。编辑器、语言支持、样式及公式字体由 Vite 生成本站分块或内联资源,随 `client/dist` 交付。
281
285
 
286
+ 原位消息编辑通过 `MarkdownEditor` 的 `fill` 模式挂载文档,沿用两行高度及内部滚动。底部输入区的 `EditorFrame` 独立持有高度偏好和调节手柄,按 `.composer` 容器测量可用空间;原位编辑保持自身尺寸。
287
+
288
+ 消息编辑器通过 `documentPaste` 将带语言的单行剪贴板文本转换为 ProseMirror 行内代码标记,多行剪贴板文本使用代码块节点。两种节点共用选区替换、撤销和 Markdown 序列化流程。
289
+
282
290
  批注编辑在 `features/annotations`,协议解析在 `domain/annotations.js`,存储和订阅在 `infrastructure/annotation-drafts.js`。选区编辑只更新草稿,统一发送由消息控制器完成。账户详情、侧栏宽度和主题分别保留自己的控件生命周期。
283
291
 
284
292
  `ui/resize-handle.jsx` 与 `styles/resize-handles.css` 统一所有尺寸手柄的透明操作区、局部圆角标记、默认/悬停/拖动/键盘聚焦状态及全局拖动光标;横向、纵向与双向仅改变标记方向。侧栏、终端高度、终端列表、详情与各类窗口使用同一组件,尺寸规则及持久化仍由各自容器持有。`ui/resizable-textarea.jsx` 为供应商模型、命令目标、提问回答和消息批注字段提供同一手柄,保留表单字段、草稿与禁用语义,高度仅在挂载期间保留。
@@ -345,6 +353,10 @@ Codex 设置中的模型显示偏好由网页后端配置持久保存并广播
345
353
 
346
354
  长历史首屏读取最近 100 条消息;首屏全部属于同一轮次且仍有历史时,后续按每页一个完整轮次恢复,减少工具密集对话的串行网络往返。首屏跨轮次时继续使用消息分页,保持短轮次对话的读取效率;两条路径均保留完整历史、轮内顺序、实时更新优先和切换隔离。
347
355
 
348
- 网页更新由 `service-maintenance.mjs` 持有 npm 稳定版检查缓存及维护操作,启动时和每小时读取官方注册表。认证后的 HTTP 维护接口通过应用装配注入服务。独立 systemd 用户任务执行下载、隔离安装、版本校验、目录替换、网页服务重启与 HTTPS 启动检查,任务状态原子保存在网页配置目录。失败时恢复原安装目录并重启。源码部署提供检查与服务重启,npm 全局部署另提供更新。浏览器应用控制器轮询持久任务状态,页面保留编辑缓冲区,重启成功提示用户手动刷新网页加载新版本资源。
356
+ 网页更新由 `service-maintenance.mjs` 持有 npm 稳定版检查缓存及维护操作,启动时和每小时读取官方注册表。认证后的 HTTP 维护接口通过应用装配注入服务。独立维护任务执行 npm 下载、隔离安装、版本校验、目录替换、网页重启与 HTTPS 启动检查,任务状态原子保存在网页配置目录。失败时恢复原安装目录并核对恢复后的健康状态。源码部署提供检查与重启,npm 全局部署另提供更新。浏览器应用控制器轮询持久任务状态,页面保留编辑缓冲区,重启成功提示用户手动刷新网页加载新版本资源。部署条件由服务端在点击后的请求中校验并返回原因。
357
+
358
+ 维护任务与 npm 安装方式分别管理:网页进程属于 `claudex-web.service` 时,通过独立 systemd 用户单元维护并由原服务重启;直接运行的网页由脱离原进程的维护进程完成相同操作。维护入口及 `service-maintenance-process.mjs` 复制到配置目录,替换安装后继续可用。普通进程记录原 Node.js、参数、工作目录及完整环境,SIGTERM 退出后按原入口启动;更新先安装和校验,再等待旧进程退出后替换目录。退出宽限期为 30 秒,超时后仅向身份仍匹配的网页进程发送 SIGKILL 并等待退出。进程操作按 PID、系统启动标识及进程启动时间核对归属,状态恢复核对所属维护进程,日志保存在 `maintenance/worker.log` 与 `maintenance/web.log`。原生后端继续由各自运行时持有。
359
+
360
+ CLI 安装同样属于维护占用,公共快照与只读维护快照分别携带所属后端的安装状态;网页重启及更新在安装完成后才接受新操作。桥接关闭时,尚未结束的 CLI 安装按实际结果完成,关闭后的管理器保持适配器关闭。
349
361
 
350
362
  维护任务在权限 0600 的作业文件中保存网页服务的 npm 运行环境,包含优先使用当前 Node.js 目录的 PATH、用户配置位置、npm 配置、代理及证书设置。npm 安装子进程显式使用该环境,覆盖独立 systemd 用户单元继承的管理器环境。维护单元启动失败时立即释放网页提交门控,持久记录失败并允许重试。回归将 npm 与 systemctl 分别放入独立目录,让工作进程的 PATH 只包含 systemctl,验证环境传递、安装失败保留原包及重启失败回滚。
@@ -28,8 +28,8 @@ curl --cacert "${CLAUDEX_WEB_CONFIG_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/claud
28
28
  从[目标版本 Release](https://github.com/hjd-hitsz/claudex-web/releases) 下载 `.tgz` 和同名 `.sha256` 文件,将两者放在同一目录,然后执行以下命令。
29
29
 
30
30
  ```bash
31
- sha256sum -c claudex-web-4.1.3.tgz.sha256
32
- npm install -g ./claudex-web-4.1.3.tgz
31
+ sha256sum -c claudex-web-4.1.5.tgz.sha256
32
+ npm install -g ./claudex-web-4.1.5.tgz
33
33
  claudex-web service install
34
34
  ```
35
35
 
@@ -288,6 +288,8 @@ Claude Code 的网络代理使用服务器可访问的代理地址和端口,
288
288
 
289
289
  ## 网页更新与重启
290
290
 
291
- 在设置的“更新与重启”查看当前版本和最新稳定版。服务启动时及每小时自动检查,也可点击“检查更新”。通过 npm 全局安装并执行 `claudex-web service install` 的部署,发现新版后可点击“更新至版本号”完成更新和重启,服务账户须具有安装目录写权限。新版本先在隔离目录完成安装与校验,启动失败会恢复原安装。源码部署先更新源码并构建,再点击“重启服务”。
291
+ 在设置的“更新与重启”查看当前版本和最新稳定版。服务启动时及每小时自动检查,也可点击“检查更新”。通过 npm 全局安装的部署,发现新版后可点击“更新至版本号”完成更新和重启,服务账户须具有安装目录写权限。新版本先在隔离目录完成安装与校验,启动失败会恢复原安装。源码部署先更新源码并构建,再点击“重启服务”。有新版时更新按钮可点击,部署或权限检查失败会在操作后显示原因。
292
+
293
+ 通过 systemd 用户服务运行时,维护任务由独立用户单元执行;通过 `claudex-web start`、`npm start` 或 Node.js 直接启动时,由独立维护进程完成更新,并按原 Node.js、启动参数、工作目录和环境重新启动网页。原网页退出后,维护和新网页进程继续运行,日志保存在网页配置目录的 `maintenance/worker.log` 和 `maintenance/web.log`。后端 CLI 正在安装或更新时,网页更新与重启会提示等待当前任务结束。
292
294
 
293
295
  “重启服务”随时可用于重新启动整个网页服务进程,执行期间连接短暂中断,网页自动重连。网页交互终端会结束,请先保存文件编辑。原生后端由其独立服务管理。更新完成后保存编辑并手动刷新网页加载新版界面。维护进度保存在网页配置目录的 `maintenance/status.json`,执行日志可通过 `journalctl --user -u claudex-web-maintenance` 查询。
@@ -92,12 +92,16 @@ CLI 安装回归使用 `server/tests/cli-package.test.mjs` 验证原生平台包
92
92
 
93
93
  单元和发行包测试通过 `--import ./tests/helpers/test-console.mjs` 预加载测试专用 `Console`,将控制台日志统一送入 stderr。Node.js 将该文本流独立转换为测试日志事件,stdout 专供二进制测试事件,避免旧版测试运行器混读 Unicode 日志导致反序列化错误。模块加载、测试执行和清理阶段均使用同一入口,直接运行单个测试时同样携带此参数。`tests/test-console.test.mjs` 连续十次启动两个并行测试进程,核对中文、emoji、多参数、对象和调用栈日志完整保留,并核对真实断言失败仍返回非零退出状态。上游问题见 [nodejs/node#65934](https://github.com/nodejs/node/issues/65934)。
94
94
 
95
+ 桥接测试中,首个就绪快照及单次请求响应通过匹配后即移除的监听器读取,后续状态广播使用独立等待与断言。`node --import ./tests/helpers/test-console.mjs --test server/tests/bridge.test.mjs` 覆盖提问回答后的重连、新提问存在时旧提问重复结束触发的状态广播,以及数字请求 ID 的结束通知;固定事件顺序验证初始快照断言仅执行一次。推送后按提交 SHA 核对 GitHub Actions 的完整工作流结果,分别保留本地与远端检查记录。
96
+
95
97
  构建后执行 `PLAYWRIGHT_MODULE=/path/to/playwright/index.mjs CHROME_PATH=/path/to/chromium node tests/browser/slash-commands.mjs`,使用隔离浏览器与模拟后端验证输入开头及正文中途的斜杠建议、Tab 补全、确认、光标中间替换、正文保留、撤销重做、失败恢复、技能及原生命令,并检查深浅主题、桌面及窄屏、80% 至 200% 实际页面缩放与侧栏开关。脚本核对 DPR 和视口,结束时恢复缩放并清理独立浏览器目录。截图与构建来源保存在 `.cache/slash-commands/after`。修复前将 `client/dist` 与 `build-info.json` 复制到 `.cache/slash-commands/before`,以 `BROWSER_BEFORE=1` 运行可复现中途缺少菜单。README 图片展示普通消息与文件预览,现有图片继续适用。
96
98
 
97
99
  正文图片布局回归先执行 `npm run build`,再运行 `PLAYWRIGHT_MODULE=/path/to/playwright/index.mjs CHROME_PATH=/path/to/chromium node tests/browser/message-images.mjs`。脚本使用仓库截图与隔离消息、模拟后端和独立浏览器配置,验证消息及文件预览中的图片居中、640 × 480 像素上限、等比缩小、HTML 指定宽度、链接图片、`picture`、大图预览及关闭后的焦点恢复,覆盖深浅主题、窄屏和 80% 至 200% 实际页面缩放。结束时恢复缩放并清理浏览器配置,截图、尺寸测量与构建来源保存在 `.cache/message-images/after`。修改前将生产构建和构建来源保存到 `.cache/message-images/before/dist` 与 `build-info.json`,以 `BROWSER_BEFORE=1` 复现 320 像素预览。README 的现有界面截图展示文字、代码和文件列表,检查后继续使用。
98
100
 
99
101
  ## 双后端开发与验收
100
102
 
103
+ 网页维护回归使用 `node --import ./tests/helpers/test-console.mjs --test server/tests/service-maintenance*.test.mjs`,覆盖 systemd 命令夹具、真实 HTTPS 普通进程的 HTTP 重启、npm 安装失败、启动失败回滚、进程身份与退出期限。构建后运行 `CHROME_PATH=/path/to/chromium PLAYWRIGHT_MODULE=/path/to/playwright/index.mjs node tests/browser/service-maintenance.mjs`,验证更新与重启按钮的点击、错误反馈、重试、进行状态、深浅主题、窄屏和 80% 至 200% 实际页面缩放。截图及构建来源保存在 `.cache/service-maintenance/after`;修改前的构建放在 `.cache/service-maintenance/before/dist`,设置 `BROWSER_BEFORE=1` 复现原禁用状态。README 图片展示对话及文件面板,本次维护操作变化通过专项截图核对。
104
+
101
105
  双后端的统一范围由[产品契约](architecture/backends.md)定义;`shared/product-contract.mjs` 只注册工作区和对话方法的路由分组。原生能力分别接入统一用例,文件与网页终端由共用工作区服务提供。文件模糊查询按所属后端路由,Codex 保留原生 app-server 调用,Claude Code 使用原生 `file_suggestions` 控制请求及 CLI 文件索引;两端共用输入建议,回归同时核对原有 Codex 路径和 Claude 新增实现。CLI/SDK 生命周期、原生历史及参数发生变化时,同时检查首次请求、流式展示、轮次完成、刷新恢复和错误重试。Claude 执行服务通过受限本机 IPC 独立于网页桥接运行,网页关闭仅释放连接;源码与安装来源的代码身份按实际发行文件计算。
102
106
 
103
107
  公共网页操作在 `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 的执行与恢复由下述验收覆盖。架构检查同时禁止公共桥接依赖具体后端和原生适配器之间的交叉依赖。
@@ -179,13 +183,15 @@ CLAUDE_EXECUTABLE=/absolute/path/to/claude MODEL_BASE_URL=https://model.example
179
183
 
180
184
  同日查验 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 的原生附加命令以其自身当前目录返回结果为准。
181
185
 
186
+ 2026-11-17 对照本机保留的 Codex VS Code `26.1021.22027` 打包资源:`src-622b307a9baf.js` 的 `Pv` 返回默认模型配置服务,`writeModel` 直接提交 `config/batchWrite`,服务档位写入同样使用该请求并设置 `reloadUserConfig: true`。本机桌面包版本为 `26.1007.21434`,可用资源中未定位到子代理专用设置控件,当前工具环境未提供可操作的客户端窗口。网页子代理设置的生效行为分别通过真实 Codex `0.169.0`、Claude CLI 与隔离模型服务验证;客户端资源仅用于核对偏好保存的请求边界。
187
+
182
188
  以上查验使用本机可取得的源码及已安装打包资源。保存的网页客户端、当前网页产品、Codex 客户端和 Claude Code 运行时各自注明版本与来源;提取资源保留在本机忽略目录,仓库只维护行为结论和隔离验证。
183
189
 
184
190
  ## 格式与验证
185
191
 
186
- 子代理模型回归以 `node --import ./tests/helpers/test-console.mjs tests/integration/subagent-models.mjs` 运行真实 Claude CLI 与本机模拟 Messages 服务,覆盖连续轮次、general-purpose 与 Explore、同供应商不同模型、跨供应商同名模型、原生 API Key 与外部供应商的双向路由,以及停用后的失败与恢复。`tests/integration/codex-subagent-models.mjs` 使用真实 Codex app-server 与模拟 Responses 服务,核对未显式指定模型及强度的原生子代理实际使用网页配置。Claude 回归同时检查主代理低强度、子代理高强度在连续轮次中的实际请求。两项均使用临时原生目录,模型流量只发往本机夹具。原生 OAuth 文件更新和凭据隔离另由 `server/tests/subagent-models.test.mjs` 使用临时文件与模拟端点验证。
192
+ 子代理模型回归以 `node --import ./tests/helpers/test-console.mjs tests/integration/subagent-models.mjs` 运行真实 Claude CLI 与本机模拟 Messages 服务,覆盖连续轮次、general-purpose 与 Explore、同供应商不同模型、跨供应商同名模型、原生 API Key 与外部供应商的双向路由,以及停用后的失败与恢复。`tests/integration/codex-subagent-models.mjs` 使用真实 Codex app-server 与模拟 Responses 服务,核对未显式指定模型及强度的原生子代理实际使用网页配置。Claude 回归同时检查主代理低强度、子代理高强度到低强度及模型变化在连续轮次中的实际请求,并验证清空后恢复默认。`node tests/integration/claude-subagent-settings-save.mjs` 经过真实管理器、独立执行服务和原生 CLI 完成保存、IPC 重连及连续轮次,核对执行服务与原生主会话 PID 保持、实际请求的新模型和强度以及清空行为;所有原生验证使用临时配置,模型流量只发往本机夹具。原生 OAuth 文件更新和凭据隔离另由 `server/tests/subagent-models.test.mjs` 使用临时文件与模拟端点验证。
187
193
 
188
- 构建后使用 `PLAYWRIGHT_MODULE=/path/to/playwright/index.mjs CHROME_PATH=/path/to/chromium node tests/browser/subagent-models.mjs` 验证两后端同行展示的“供应商 / 模型”及思考强度选择、Codex 隐藏模型过滤与恢复、独立保存、忙碌失败保留、重试、刷新恢复与清空,覆盖深浅主题、桌面与窄屏、80% 至 200% 实际浏览器缩放和侧栏收放。证据保存在 `.cache/subagent-models/browser`。README 引用的现有图片展示对话及文件面板,本项设置变化未影响其画面。
194
+ 构建后使用 `PLAYWRIGHT_MODULE=/path/to/playwright/index.mjs CHROME_PATH=/path/to/chromium node tests/browser/subagent-models.mjs` 验证两后端同行展示的“供应商 / 模型”及思考强度选择、Codex 隐藏模型过滤与恢复、独立保存、写入失败保留、重试、刷新恢复与清空,覆盖深浅主题、桌面与窄屏、80% 至 200% 实际浏览器缩放和侧栏收放。保存性能回归阻塞模型、账户及后端目录读取,验证一次保存请求即可结束并保留当前主模型和草稿;结果记录完整按钮等待耗时。`client/tests/backend-settings-save.test.js` 与 `server/tests/codex-subagent-settings.test.mjs` 分别检查前端请求边界及真实 Codex 适配器的最新配置读取,配置事务和 IPC 回归覆盖运行任务、写入失败与重连时进程保持。`tests/integration/subagent-models.mjs` 使用真实 Claude CLI 与隔离模型服务验证连续轮次更新模型、强度及清空默认值,并核对主会话实例保持。证据保存在 `.cache/subagent-models/browser`。README 引用的现有图片展示对话及文件面板,本项设置变化未影响其画面。
189
195
 
190
196
  文件预览编辑回归在构建后运行 `PLAYWRIGHT_MODULE=/path/to/playwright/index.mjs CHROME_PATH=/path/to/chromium node tests/browser/file-editing.mjs`。脚本使用生产构建、真实 Chromium 编辑器及隔离文件协议夹具,核对直接输入、撤销、表格、任务列表、代码、数学语法、相对图片、Mermaid、源码切换、保存与失败重试,并覆盖深浅主题、桌面与窄屏的 80%、100%、125%、150% 和 200% 实际页面缩放。截图与结果位于 `.cache/file-editing/after`,浏览器关闭 GPU,测试结束清理独立配置。旧构建通过 `BROWSER_BUILD_DIR` 指定,设置 `FILE_EDITING_BEFORE=1` 后复现只读预览并将对照截图保存到 `.cache/file-editing/before`。
191
197
 
@@ -216,7 +222,7 @@ npm run check
216
222
 
217
223
  状态容器和 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`。
218
224
 
219
- 分支标题回归先执行 `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 的现有演示图片未展示分支标题,相关图片继续使用既有演示内容。
225
+ 分支标题回归先执行 `npm run build`,再运行 `CHROME_PATH=/path/to/chromium node tests/browser/fork-titles.mjs`。脚本使用隔离模拟历史和生产构建,实际点击回复分支按钮与侧栏菜单,验证兼容客户端编号、连续分支到两位数、刷新恢复、深浅主题及手机侧栏,同时核对 Codex 创建后直接分页读取历史。截图和构建信息保存到 `.cache/fork-titles-browser/after`。修改前将旧 `client/dist` 与 `build-info.json` 复制到 `.cache/fork-titles-before/`,以 `BROWSER_BEFORE=1` 运行同一脚本,复现后缀逐次叠加并保存对照截图。单元与组件测试另覆盖旧后缀、手动改名、独立同名对话、60 字符截断、归档分页和筛选外编号。README 的现有演示图片未展示分支标题,相关图片继续使用既有演示内容。
220
226
 
221
227
  测试采用模拟后端,不消耗模型额度,也不修改真实聊天。协议或生命周期变更应补充对应回归测试;真实后端验证使用临时会话或明确的测试数据。各测试目录的覆盖范围见[架构设计中的验证章节](architecture.md#7-可执行约束与验证)。
222
228
 
@@ -357,6 +363,8 @@ Ubuntu 安装指引回归在设备选择器中实际切换 Ubuntu,检查 DER
357
363
 
358
364
  使用相同环境变量运行 `tests/browser/markdown-typing.mjs`,验证逐字键入、整段插入、粘贴和中文组合输入自动排版。覆盖列表内公式 `- $$x_{t+1}=x_{t}+dx$$`、标题、强调、链接、任务列表、表格分隔行及代码围栏进出,同时核对实际可见排版、表格光标和 Markdown 草稿。证据保存在 `.cache/markdown-typing/after`。
359
365
 
366
+ `markdown-composer.mjs` 的剪贴板回归覆盖代码编辑器语言信息、单行代码在段落中插入和续写、一次撤销、网页行内代码及多行带语言围栏。检查编辑区域的原生节点、Markdown 草稿和提交内容,并保存行内粘贴截图。
367
+
360
368
  链接续写回归使用相同环境变量运行 `tests/browser/composer-links.mjs`,通过实际键盘及粘贴事件验证网址、Markdown 链接和自动链接末尾的空格及正文留在链接之外,检查链接内部编辑、撤销和实际提交内容,保存深浅主题及窄屏截图。结果及构建来源写入 `.cache/composer-links/after`;修改前使用 `BROWSER_BEFORE=1` 记录格式延续问题,证据写入 `before` 目录。README 和其他文档的现有截图展示普通任务与文件预览,未展示链接末尾续写状态,图片内容继续适用。
361
369
 
362
370
  附件草稿回归先执行 `npm run build`,再使用相同环境变量运行 `tests/browser/attachment-drafts.mjs`。脚本在独立浏览器上下文中同时上传生成的测试 PNG 和文本文件,通过侧栏切换到已有对话,再通过新建入口返回,检查文字、图片原始尺寸、文件附件、对话隔离和移除后的状态,覆盖桌面、窄屏及深浅主题。截图和结果保存在 `.cache/attachment-drafts/after`;通过 `BROWSER_BEFORE=1` 与 `BROWSER_BUILD_DIR` 指定旧构建,复现文字保留而附件消失,保存至同目录的 `before`。组件回归另覆盖图片及文件读取期间切换、首次创建对话的草稿迁移、发送失败重试、实际发送的文件正文,以及发送成功后保留等待期间新增的附件。README 现有截图展示已发送消息和文件预览,图片内容继续适用。
@@ -365,6 +373,8 @@ Ubuntu 安装指引回归在设备选择器中实际切换 Ubuntu,检查 DER
365
373
 
366
374
  ### 原消息编辑回归
367
375
 
376
+ 挂载与文件引用回归在构建后执行 `CHROME_PATH=/path/to/chromium PLAYWRIGHT_MODULE=/path/to/playwright/index.mjs node tests/browser/message-editing-mount.mjs`。脚本使用仅含 Markdown 文件引用的单条用户消息、隔离模拟历史及真实 Chromium 编辑器,验证点击编辑、取消重开、引用保留、长正文内部滚动、底部草稿和高度偏好隔离、Ctrl+Enter 提交及刷新后再次编辑。通过 Chromium 设置执行桌面与窄屏、深浅主题及 80%、100%、125%、150%、200% 实际页面缩放,并核对 DPR 和视口。证据位于 `.cache/message-editing-mount/after`;修改前将 `client/dist` 和 `build-info.json` 保存到 `.cache/message-editing-mount/before`,设置 `EDIT_MOUNT_BEFORE=1` 复现点击后整页报错。此回归直接挂载实际文档编辑器,组件测试中的文本框替身继续验证编辑用例。README 的现有截图未展示原位编辑,图片内容保持适用。
377
+
368
378
  执行 `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/`。领域与组件回归另覆盖完整轮次分页、旧接口兼容、运行状态、过期编辑、批注及附件独立性。
369
379
 
370
380
  客户端对照来自本机 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` 通知其他页面。客户端界面控制连接超时,交互证据使用本机打包实现;提取资源仅保存在忽略目录。
@@ -385,11 +395,13 @@ Ubuntu 安装指引回归在设备选择器中实际切换 Ubuntu,检查 DER
385
395
 
386
396
  双后端回退对照记录见[双后端回归审查](architecture/backend-regressions.md)。`tests/browser/backend-regressions.mjs` 使用生产构建、独立浏览器和隔离传输验证旧未分类目录、用户消息 Markdown、引用键盘打开、Claude 内部消息来源、主题、缩放与窄屏;通过 `CHROME_PATH`、`PLAYWRIGHT_MODULE` 配置浏览器工具。`tests/integration/claude-message-provenance.mjs` 通过真实 SDK 读取临时原生 JSONL,核对来源字段保留与用户轮次归属。
387
397
 
398
+ 顶部文件夹与对话切换回归使用相同浏览器环境变量运行 `tests/browser/backend-interactions.mjs`。脚本核对分组顺序、置顶对话归属、空文件夹过滤、「未分类」、当前项与运行状态标记、进行中优先及开始与结束时间排序、切换文件夹直达首位对话、草稿恢复、键盘操作及底部工作目录选择器,并在深浅主题、桌面和窄屏的 80% 至 200% 实际页面缩放下检查两个菜单的边界。截图与结果位于 `.cache/backend-interactions/dual/`。
399
+
388
400
  后端启停回归执行 `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`。
389
401
 
390
- ### 自定义模型显示别名回归
402
+ ### 自定义供应商模型参数回归
391
403
 
392
- 执行 `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`。服务端配置回归验证别名持久恢复、无效模型拒绝及移除模型后清理别名。
404
+ 执行 `npm run build` 后运行 `PLAYWRIGHT_MODULE=/path/to/playwright/index.mjs CHROME_PATH=/path/to/chromium node tests/browser/provider-model-aliases.mjs`。回归使用含十个模型的隔离供应商,验证行尾操作、连接字段的标签和控件同行及清除入口位置、凭据保留与替换及清除、模型下拉切换、显示别名和上下文容量的标签及输入框四项同行、思考强度点选和键盘勾选、草稿隔离、失败重试及重新编辑恢复。布局检查覆盖深浅主题、桌面及窄屏的 80% 至 200% 实际浏览器缩放。截图保存在 `.cache/provider-model-aliases/dual`。服务端配置回归验证别名持久恢复、无效模型拒绝及移除模型后清理别名。
393
405
 
394
406
  ### 默认供应商回归
395
407
 
@@ -0,0 +1,7 @@
1
+ # Claudex Web v4.1.4
2
+
3
+ - 点击顶部文件夹名可直达目标分组的首位对话,点击对话标题可在当前组内切换。进行中的对话按消息发送时间优先排列,已结束的对话按完成时间排列。([a5207cd](https://github.com/hjd-hitsz/claudex-web/commit/a5207cd042b7a0bd26e3539a647197db47ba246a)、[e63ff5e](https://github.com/hjd-hitsz/claudex-web/commit/e63ff5ec2c7979d8922f3ad1958da8b59333c3f7))
4
+ - 修复点击“编辑上一条消息”后页面报错的问题。可在消息原位编辑并重新发送,保留文件引用和底部草稿。([9ed2efb](https://github.com/hjd-hitsz/claudex-web/commit/9ed2efb1741f7c69697d12490eab0d4f254caf1e))
5
+ - 缩短创建对话分支后打开新对话的等待时间,并加快 Codex 对话打开历史和发送消息的操作。([271ab68](https://github.com/hjd-hitsz/claudex-web/commit/271ab6808a8c75b58581b2afdbb6d01d2ba3a370))
6
+ - 保存子代理模型和思考强度时更快返回,正在执行的任务继续运行。([568a623](https://github.com/hjd-hitsz/claudex-web/commit/568a6235cf5de5d26f9fd885de588582821f7642))
7
+ - 直接启动的 npm 安装可在网页设置中更新和重启。更新失败时恢复原安装,设置页显示失败原因并提供重试入口。([bdcbaef](https://github.com/hjd-hitsz/claudex-web/commit/bdcbaef55bcb3b3de9c9cec4711b91914bf6b45d))
@@ -0,0 +1,6 @@
1
+ # Claudex Web v4.1.5
2
+
3
+ - Claude Code 供应商的编辑表单在对应行下方展开,编辑与删除按钮并排靠右。连接和模型设置共享左侧对齐线,配置下拉菜单按原始模型 ID 列出模型。显示别名和居中的上下文容量同行,点击容量框旁的 k 可切换输入单位,思考强度可在横轴上点选。([7a7a405](https://github.com/hjd-hitsz/claudex-web/commit/7a7a40525bbeb694ec097f16e1660812b8c26b1f))
4
+ - 在本机工作区使用 `@` 时,通过短前缀或跳字找到的文件夹也会排在文件前。可以用目录缩写加文件名区分同名文件,切换 Codex 和 Claude Code 时使用相同的搜索结果。([39f76ae](https://github.com/hjd-hitsz/claudex-web/commit/39f76ae6926d18a6453f2b07986157d39f62b613))
5
+ - 切换对话后,光标自动落到消息输入框的草稿末尾,可以直接继续输入。([41c5f88](https://github.com/hjd-hitsz/claudex-web/commit/41c5f88935d3c1c4d49ee653816fdf5521d68ccf))
6
+ - 将粘贴到消息中的单行代码保留在正文里,以 Markdown 行内代码显示。多行代码继续使用带语言标记的代码块。([97972eb](https://github.com/hjd-hitsz/claudex-web/commit/97972eb78447b84bd3edbb6ec45c1b21bbe6c380))
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@hjd-hitsz/claudex-web",
3
- "version": "4.1.3",
3
+ "version": "4.1.5",
4
4
  "type": "module",
5
5
  "description": "Codex 与 Claude Code 的浏览器工作台",
6
6
  "license": "GPL-3.0-only",
@@ -69,10 +69,12 @@
69
69
  },
70
70
  "dependencies": {
71
71
  "@anthropic-ai/claude-agent-sdk": "0.3.318",
72
- "node-pty": "1.1.0",
73
- "ws": "8.22.0",
74
72
  "@claudex-web/translation-engine": "file:packages/translation-engine",
75
- "fflate": "0.8.2"
73
+ "fflate": "0.8.2",
74
+ "fuzzysort": "4.0.2",
75
+ "ignore": "7.0.16",
76
+ "node-pty": "1.1.0",
77
+ "ws": "8.22.0"
76
78
  },
77
79
  "repository": {
78
80
  "type": "git",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@claudex-web/translation-engine",
3
- "version": "4.1.3",
3
+ "version": "4.1.5",
4
4
  "type": "module",
5
5
  "license": "GPL-3.0-only",
6
6
  "description": "独立的本地英译中引擎与按需模型管理",
@@ -19,6 +19,7 @@ export function createClaudeAdapter({
19
19
  broadcast,
20
20
  providers,
21
21
  workspace: sharedWorkspace,
22
+ readSubagentSettings,
22
23
  }) {
23
24
  const storage = createStorage(
24
25
  join(backend.stateDir, "claudex-web-index.json"),
@@ -37,6 +38,7 @@ export function createClaudeAdapter({
37
38
  broadcast,
38
39
  compactions,
39
40
  questions,
41
+ readSubagentSettings,
40
42
  });
41
43
  const catalogue = createClaudeCatalogue({
42
44
  backend,
@@ -12,6 +12,7 @@ import {
12
12
  subagentModelEnvironment,
13
13
  } from "./provider-environment.mjs";
14
14
  import { networkProxyEnvironment } from "../network-proxy.mjs";
15
+ import { subagentSettings } from "../../../../shared/subagent-settings.mjs";
15
16
  import {
16
17
  createProviderTransport,
17
18
  providerRuntimeEnvironment,
@@ -52,7 +53,7 @@ export async function createExecutionSession({
52
53
  const subagentTarget =
53
54
  subagentProvider ||
54
55
  (backend.subagentEffort && backend.subagentModel ? provider : null);
55
- const proxy =
56
+ let proxy =
56
57
  provider || subagentTarget
57
58
  ? await createProviderTransport(
58
59
  provider,
@@ -80,6 +81,7 @@ export async function createExecutionSession({
80
81
  providerId: provider?.id ?? queued.providerId ?? session.providerId,
81
82
  providerKey: JSON.stringify(provider),
82
83
  subagentProviderKey: JSON.stringify(subagentProvider),
84
+ subagentSettingsKey: JSON.stringify(subagentSettings(backend)),
83
85
  model,
84
86
  cwd: session.cwd,
85
87
  modelTokens: session.modelTokens || 0,
@@ -87,6 +89,32 @@ export async function createExecutionSession({
87
89
  lastActivityAt: Date.now(),
88
90
  settingsEnvironment: (model, effort) =>
89
91
  providerSettingsEnvironment(provider, backend, { proxy, model, effort }),
92
+ async configureSubagent(nextBackend, targetProvider) {
93
+ const settingsKey = JSON.stringify(subagentSettings(nextBackend));
94
+ const providerKey = JSON.stringify(targetProvider);
95
+ if (
96
+ settingsKey === process.subagentSettingsKey &&
97
+ providerKey === process.subagentProviderKey
98
+ )
99
+ return false;
100
+ const target =
101
+ targetProvider ||
102
+ (nextBackend.subagentEffort && nextBackend.subagentModel
103
+ ? provider
104
+ : null);
105
+ const route = target && {
106
+ provider: target,
107
+ model: nextBackend.subagentModel,
108
+ effort: nextBackend.subagentEffort,
109
+ };
110
+ if (proxy) proxy.setSubagent(route);
111
+ else if (route) proxy = await createProviderTransport(provider, route);
112
+ backend = nextBackend;
113
+ process.subagentProviderKey = providerKey;
114
+ process.subagentSettingsKey = settingsKey;
115
+ process.subagentSettingsDirty = true;
116
+ return true;
117
+ },
90
118
  };
91
119
  const current = () => (process.retired ? null : getCurrent());
92
120
  const context = () => ({
@@ -128,6 +128,9 @@ export function providerRuntimeEnvironment(
128
128
  export function providerSettingsEnvironment(provider, backend, options) {
129
129
  const env = providerRuntimeEnvironment(provider, backend, options);
130
130
  return {
131
+ CLAUDE_CODE_SUBAGENT_MODEL: "",
132
+ CLAUDE_CODE_SUBAGENT_MODEL_FORCE: "",
133
+ CLAUDE_CODE_SUBAGENT_EFFORT: "",
131
134
  ...(provider && { ANTHROPIC_AUTH_TOKEN: "" }),
132
135
  ...networkProxyEnvironment(backend.proxy),
133
136
  ...Object.fromEntries(
@@ -8,7 +8,17 @@ import { nativeProviderHeaders } from "./native-provider.mjs";
8
8
 
9
9
  export async function createProviderTransport(provider, subagent) {
10
10
  const token = randomUUID();
11
- const subagentModel = subagent ? `claudex-subagent-${randomUUID()}` : null;
11
+ const targets = new Map();
12
+ let subagentModel;
13
+ let targetKey;
14
+ function setSubagent(target) {
15
+ const key = JSON.stringify(target);
16
+ if (key === targetKey) return;
17
+ targetKey = key;
18
+ subagentModel = target ? `claudex-subagent-${randomUUID()}` : null;
19
+ if (target) targets.set(subagentModel, target);
20
+ }
21
+ setSubagent(subagent);
12
22
  const nativeBaseUrl =
13
23
  process.env.ANTHROPIC_BASE_URL || "https://api.anthropic.com";
14
24
  const server = http.createServer(async (request, response) => {
@@ -29,13 +39,14 @@ export async function createProviderTransport(provider, subagent) {
29
39
  let selected = provider;
30
40
  if (body) {
31
41
  let input = JSON.parse(body);
32
- if (subagent && input.model === subagentModel) {
33
- selected = subagent.provider;
34
- input = { ...input, model: subagent.model };
35
- if (subagent.effort && !request.url.includes("/count_tokens"))
42
+ const target = targets.get(input.model);
43
+ if (target) {
44
+ selected = target.provider;
45
+ input = { ...input, model: target.model };
46
+ if (target.effort && !request.url.includes("/count_tokens"))
36
47
  input.output_config = {
37
48
  ...input.output_config,
38
- effort: subagent.effort,
49
+ effort: target.effort,
39
50
  };
40
51
  }
41
52
  if (selected && (selected.protocol || "messages") === "messages")
@@ -91,13 +102,18 @@ export async function createProviderTransport(provider, subagent) {
91
102
  return {
92
103
  url: `http://127.0.0.1:${server.address().port}`,
93
104
  token,
94
- subagentModel,
95
- modelCapabilities: subagent
96
- ? {
97
- [subagentModel]:
98
- subagent.provider.modelCapabilities?.[subagent.model] || {},
99
- }
100
- : {},
105
+ setSubagent,
106
+ get subagentModel() {
107
+ return subagentModel;
108
+ },
109
+ get modelCapabilities() {
110
+ return Object.fromEntries(
111
+ [...targets].map(([model, target]) => [
112
+ model,
113
+ target.provider.modelCapabilities?.[target.model] || {},
114
+ ]),
115
+ );
116
+ },
101
117
  close() {
102
118
  server.close();
103
119
  server.closeAllConnections();