@hjd-hitsz/claudex-web 4.1.3 → 4.1.4
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/CHANGELOG.md +20 -0
- package/build-info.json +4 -4
- package/client/dist/app.js +85 -85
- package/client/dist/style.css +1 -1
- package/docs/architecture/behavior.md +12 -6
- package/docs/architecture.md +14 -4
- package/docs/deployment.md +5 -3
- package/docs/development.md +13 -3
- package/docs/releases/v4.1.4.md +7 -0
- package/package.json +1 -1
- package/packages/translation-engine/package.json +1 -1
- package/server/src/backends/claude/adapter.mjs +2 -0
- package/server/src/backends/claude/execution-session.mjs +29 -1
- package/server/src/backends/claude/provider-environment.mjs +3 -0
- package/server/src/backends/claude/provider-transport.mjs +29 -13
- package/server/src/backends/claude/runtime.mjs +15 -8
- package/server/src/backends/claude/worker-client.mjs +12 -5
- package/server/src/backends/claude/worker-server.mjs +3 -1
- package/server/src/backends/codex/adapter.mjs +9 -6
- package/server/src/backends/codex/methods.mjs +0 -1
- package/server/src/backends/configuration.mjs +6 -0
- package/server/src/backends/manager.mjs +13 -13
- package/server/src/backends/subagent-settings.mjs +14 -0
- package/server/src/service-maintenance-process.mjs +69 -0
- package/server/src/service-maintenance-worker.mjs +60 -25
- package/server/src/service-maintenance.mjs +66 -27
- package/shared/backend-activity.mjs +2 -0
- package/shared/subagent-settings.mjs +18 -0
|
@@ -34,17 +34,19 @@ CLI 一键安装以当前平台原生组件完整下载为前提,完成后安
|
|
|
34
34
|
|
|
35
35
|
输入区 `@` 提供文件、目录、技能和同后端其他会话。文件搜索对返回的全部候选按相关性排序后再截取展示数量,名称精确、前缀、连续与紧凑跳字匹配依次优先,仅父目录命中的结果靠后;文件与目录使用相同排序,同分保留原生顺序。空查询与以 `/` 结尾的目录浏览继续按目录优先、名称排序。`@` 查询包含路径分隔符时仅提供文件和目录,分隔符保持路径输入语义;独立的 `/` 查询提供快捷命令和技能。技能候选支持名称、显示名和技能目录的大小写无关模糊匹配,允许按字符顺序输入缩写与跳字;精确、前缀、连续和紧凑跳字匹配依次优先,描述关键词作为低优先级补充。Tab 将当前候选补全为可继续编辑的查询文本并保持建议打开,文件与目录补全完整路径,支持继续输入 `/` 逐级查询;Enter 或点击确认后以独立的行内引用显示,文件按扩展名区分图标,目录、技能与会话使用对应图标;菜单关闭,光标移到引用后的空格。引用节点支持两侧输入、整项删除、撤销、复制粘贴、切换与刷新草稿恢复,发送和消息编辑保持名称与目标。删除引用同时移除该项的提交数据;重复引用保留正文位置,原生元数据按目标去重。Codex 使用原生技能与 thread:// 会话引用,通过同后端只读 read_thread 工具按需读取已保存正文,Claude 技能使用原生命令,会话引用在发送时读取完整分页的用户和助手正文;读取失败保留完整草稿。代码与普通外部链接保留原语义。
|
|
36
36
|
|
|
37
|
-
|
|
37
|
+
侧栏将所有可见的活动轮次对话集中排列在置顶和项目文件夹上方,仅沿用会话行左侧的运行圆圈,省去分区标题和说明。顶部快捷入口沿用对话排序,同时保留原项目或置顶列表中的会话。成功完成且带未读绿点的会话继续保留顶部快捷入口,当前选中的顶部会话在阅读清除绿点或轮次结束后继续保留,切换会话或新建对话后再移除;其他已结束会话沿用未读状态保留顶部入口。原项目归属、置顶偏好和文件夹收放状态保持不变。活动状态沿用实时轮次事件与重连快照。
|
|
38
38
|
|
|
39
|
-
|
|
39
|
+
侧栏、搜索结果和标题菜单使用同一排序。进行中的对话置前,按发起当前轮次的消息时间倒序,其余对话按最近有效结束时间倒序。缺少对应时间时沿用创建时间,侧栏按排序依据显示时间。打开、重命名和切换保留排序时间,新一轮开始或结束立即重排。完整分页历史补齐时保留较新的实时开始或结束时间。两个后端独立读取,任一后端失败时保留已显示且符合当前归档和搜索范围的记录,其余后端继续更新;侧栏及搜索显示所属后端的实际错误并提供重试。相同查询保留此前已确认的正文匹配记录,修改查询及卸载后忽略旧请求结果。
|
|
40
40
|
|
|
41
41
|
项目按固定状态分组,固定项目始终位于未固定项目之前,空项目及仅含置顶对话的项目同样遵循此规则,“未分类”始终位于末尾。同类项目的顺序使用页面内快照,归档、恢复和实时活动保留快照;固定与取消固定立即按新状态重新分组,各组内部沿用快照顺序。手动添加或固定的项目跨刷新保存。固定文件夹默认展开,其余默认折叠,每组先显示最新五条;“查看更多”覆盖后端全部分页。“未分类”保留独立归属,新建时按首次发送流程准备工作目录,已有目录可以沿用。
|
|
42
42
|
|
|
43
43
|
侧栏对话可拖到项目文件夹或“未分类”标题,悬停高亮,保存成功后展开目标并显示对话。移入文件夹为后续轮次选用目标目录,移到未分类保留有效工作目录;运行中的轮次继续完成,后续恢复和新轮次应用迁移结果。归属保存在服务端,刷新、重新连接、归档恢复及其他页面均沿用;保存失败保留原归属、草稿及附件,并提供错误提示。置顶对话移入文件夹后取消置顶。每个网页项目对应一个文件夹,原生历史通过所属后端读取。
|
|
44
44
|
|
|
45
|
+
顶部目录菜单沿用侧栏的分组顺序,仅列出当前对话列表中有记录的文件夹和“未分类”,置顶对话计入所属分组。选中其他分组直接打开排序首位的对话。标题菜单列出当前分组的对话,进行中条目沿用侧栏的转圈图标。打开对话恢复所属草稿。两个菜单标记当前项,选择当前项关闭菜单,支持方向键、Tab 和 Esc,窄屏保留两个入口。输入区底部的文件夹入口用于浏览和选取工作目录。
|
|
46
|
+
|
|
45
47
|
主对话与子代理使用 `domain/thread-history.js` 的完整历史读取流程。仅在 `thread/items/list` 明确不受支持时回退到 `thread/turns/list` 的完整消息分页。写入被其他客户端占用时继续提供已保存历史;其他读取错误保留实际错误和重试入口。
|
|
46
48
|
|
|
47
|
-
分支通过 `thread-catalog.js`
|
|
49
|
+
分支通过 `thread-catalog.js` 的统一动作创建。并行读取所属后端的未归档与已归档家族元数据,按真实 `forkedFromId` 关系生成数字后缀,兼容旧网页后缀并保留手动标题。创建及命名确认后打开分支,历史从最近一页开始加载,侧栏随后补齐。Codex 新分支的输入状态取自原生创建结果。用户在创建期间切换对话时,分支加入列表并保留当前选择。侧栏菜单、回复操作与 `/fork` 共用流程。归档、删除和标题通知同时更新当前对话与列表,旧列表或打开响应保留通知中更新的结果。
|
|
48
50
|
|
|
49
51
|
Codex 首轮发送后,桥接使用独立连接及临时会话生成简短标题;写入前重新读取目标记录。手动改名、归档、删除及断线取消旧生成任务,生成失败可在后续打开或发送时重试。标题生成的消息和订阅与用户对话隔离。Claude Code 对话沿用其原生标题与网页保存的用户名称。
|
|
50
52
|
|
|
@@ -76,6 +78,8 @@ Markdown 输入以逐字键入后自动排版为主要交互,选区格式工
|
|
|
76
78
|
|
|
77
79
|
最近一轮的初始用户消息提供铅笔形“编辑上一条消息”入口;原消息位置切换为紧凑的 Markdown 编辑框,正文固定两行并通过内部滚动查看长内容;宽度最多为 42rem,窄屏内最多占消息区的 90%。背景、边框、阴影和聚焦边框与底部输入框共用规则,发送使用主操作配色,深色及跟随系统主题同步适配。支持取消、发送、Enter 换行与 Ctrl+Enter 提交。编辑正文、引用附件和批注由消息组件独立持有,底部草稿保持原值。运行中补充消息继续通过运行轮次发送,历史编辑针对完整轮次。
|
|
78
80
|
|
|
81
|
+
原位编辑框独立于底部输入区的高度偏好及调节手柄,打开、取消及重新打开均保持两行布局,保留 Markdown 文件引用的名称与目标。
|
|
82
|
+
|
|
79
83
|
编辑提交先读取完整分页核对最近消息及运行状态,通过 `thread/revert` 回退到原轮次之前;仅在该方法明确不支持时使用 `thread/rollback`。成功回退后清理已移除的历史、时间与差异,再提交新轮次,刷新以实际后端记录恢复。回退失败保留原历史,发送失败保留编辑框及输入,重试核对保留轮次并复用已成功的回退。取消已回退的失败编辑时读取实际历史。连接、写入检查、整理及运行状态限制提交,异步读取和回退响应按对话及打开版本隔离;回退使较早的历史分页请求失效。其他页面收到 `thread/reverted` 时重新恢复所属对话。
|
|
80
84
|
|
|
81
85
|
Claude Code 编辑及分支通过原生会话分支保存保留前缀,网页逻辑对话与保留轮次标识稳定,原生 UUID 和后台自动唤醒锚点随分支更新。保留的原生别名归属原逻辑对话,列表和删除恢复保持去重;发送失败后重试沿用已成功完成的历史回退。
|
|
@@ -157,7 +161,7 @@ Claude Code 的原生后台任务按所属会话保存任务标识、类型、
|
|
|
157
161
|
|
|
158
162
|
## 子代理与共享渲染
|
|
159
163
|
|
|
160
|
-
设置中的每个后端在同一行提供子代理模型、思考强度和保存操作。模型选项从可用目录取得并以“供应商 / 模型”展示,Codex 候选遵循模型显示偏好。已选模型被隐藏后,以状态占位保留已存配置,候选中省去其名称,恢复显示后恢复选择。强度档位随模型能力提供,选择“原生默认”清除模型覆盖,选择“默认强度”清除强度覆盖。Claude 支持跨已配置供应商选择,原生账户模型使用其解析后的实际 ID
|
|
164
|
+
设置中的每个后端在同一行提供子代理模型、思考强度和保存操作。模型选项从可用目录取得并以“供应商 / 模型”展示,Codex 候选遵循模型显示偏好。已选模型被隐藏后,以状态占位保留已存配置,候选中省去其名称,恢复显示后恢复选择。强度档位随模型能力提供,选择“原生默认”清除模型覆盖,选择“默认强度”清除强度覆盖。Claude 支持跨已配置供应商选择,原生账户模型使用其解析后的实际 ID。保存直接校验并持久化默认值,保持后端连接、原生主会话和活动任务,完成后广播配置并结束本次请求。后续原生会话配置读取使用最新值,Claude 下一轮通过原生会话级设置更新子代理默认选择,已启动子代理保留原路由及模型。保存失败保留选择并允许重试,清空后恢复原生默认;保存响应直接更新配置,模型目录与账户读取独立于保存操作。Codex 使用原生默认子代理模型,显式任务及自定义代理模型沿用原生优先级;Claude 使用原生强制子代理模型参数,原生 fork 及指定继承模型的技能继续遵循 CLI 的继承语义。模型选择、主供应商及主对话状态保持各自所有权。
|
|
161
165
|
|
|
162
166
|
Claude 子代理原生历史中,带有 `isSidechain=true` 与 `agentId` 的任务输入以侧链来源建立轮次,即使继承 SDK 入口和父轮次 `promptId`。主对话内部通知继续按其来源字段过滤,子代理任务、工具和回答完整恢复。
|
|
163
167
|
|
|
@@ -227,12 +231,14 @@ Claude Code 网络代理在设置中提供跟随服务环境、关闭和 HTTP,
|
|
|
227
231
|
|
|
228
232
|
## 网页更新与重启
|
|
229
233
|
|
|
230
|
-
设置中的“更新与重启”显示当前版本、npm 最新稳定版与检查错误。桥接启动时及每小时自动检查,网页发现更新提供设置入口。npm
|
|
234
|
+
设置中的“更新与重启”显示当前版本、npm 最新稳定版与检查错误。桥接启动时及每小时自动检查,网页发现更新提供设置入口。npm 全局安装可更新并重启,源码部署使用源码更新流程。重启服务在当前版本下同样可用。systemd 用户服务沿用原服务重启,直接启动的进程通过独立维护进程按原 Node.js、参数、目录及环境重新启动。整个网页服务进程重启,网页交互终端随之结束,原生后端继续按各自生命周期执行。独立维护任务持久记录进度,重复操作合并,安装与启动失败提供错误及重试。新包先在隔离目录安装并验证,替换后启动失败恢复原包并核对启动结果。网页重连后保留草稿和文件编辑,用户保存编辑后主动刷新页面加载新资源。
|
|
231
235
|
|
|
232
|
-
|
|
236
|
+
更新及重启请求遇到活动轮次、后台任务、排队输入、待答提问、内部命令、上下文整理或后端 CLI 安装时,结束本次操作并短暂提示用户结束任务后重试。提示五秒后关闭,用户稍后重新发起操作。切换阶段暂停网页提交,避免提交与重启竞争。重启成功后网页显示“服务已重启,请刷新网页”,用户自行刷新。
|
|
233
237
|
|
|
234
238
|
npm 更新沿用网页服务的 Node.js/npm 路径、npm 配置及网络代理与证书环境,支持 NVM 和自定义用户安装目录。独立维护单元启动失败时立即恢复网页提交,保留失败结果并允许重新执行维护操作。
|
|
235
239
|
|
|
240
|
+
发现新版时更新按钮可点击,重启按钮在空闲时可点击。部署方式与服务管理条件由服务端在操作请求中校验,失败原因显示在更新卡片内,并允许再次操作。错误、维护进度与完成提示统一放在卡片内的产品信息和操作组下方,长文本按卡片宽度换行。请求及维护任务执行期间暂时禁用按钮;版本检查确认无需更新时保留“无需更新”的禁用状态。
|
|
241
|
+
|
|
236
242
|
发现新版本后,侧栏底部显示带版本号的更新入口并标记设置按钮;侧栏收起或窄屏时,顶部显示紧凑更新入口。设置页按更新与重启、模型与服务配置、其他设置、网页登录分组。更新卡片集中显示产品身份和主操作,当前与最新版本在产品名下同行显示,产品图标、版本信息与检查更新、重启服务、更新按钮在卡片中垂直居中并同行排列,空间不足时操作组整体换行,三个按钮保持同行,复用设置页按钮的尺寸和边框,主要更新操作位于右侧,有新版时显示“更新至版本号”,无需更新时显示灰色禁用的“无需更新”,按钮数量与位置保持稳定;检查期间显示进行状态。设置卡片通过间距区分内部内容。其他设置的选项间距保持一致,状态与错误说明紧随所属选项并与选项文字对齐。原生后端的当前版本合并到标题行,正常连接以状态点显示,安装操作失败作为本次设置访问中的短暂提示,重新打开设置跳过历史安装提示,有新版时在按钮直接显示目标版本并允许更新,版本相同或本机更新时保留灰色禁用的“无需更新”按钮;未安装、停用及连接失败保留文字状态。网页主题始终跟随系统。点击更新入口直接打开设置并滚动、聚焦“更新与重启”区域。界面只显示版本、操作与必要状态,检查周期及部署实现保留在部署文档。
|
|
237
243
|
|
|
238
244
|
维护任务的持久结果用于状态核对,操作提示归属当前设置访问。首次加载、刷新及重新打开设置跳过历史完成和失败提示;当前访问发起的操作按任务开始时间确认结果并只显示一次。关闭设置清除提示并使在途请求的后续反馈失效,后台任务继续按真实状态执行。代理保存反馈五秒后消失,表单错误和实际连接、下载故障按各自当前状态提供处理入口。
|
package/docs/architecture.md
CHANGED
|
@@ -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` 同时清理实际已卸载会话的状态。
|
|
@@ -251,10 +253,12 @@ Claude 网页桥接重启或异常退出时,独立执行服务继续持有模
|
|
|
251
253
|
|
|
252
254
|
外部供应商的模型环境由 `provider-environment.mjs` 生成,主模型与 Opus、Sonnet、Haiku 三个原生别名随本轮选择一起更新。初始化与持续会话共用映射,运行时等待原生模型和设置更新完成后提交输入,设置失败按本轮错误结算并允许重试。
|
|
253
255
|
|
|
254
|
-
|
|
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 组件按正文、批注内容和目录复用解析结果,内部媒体和主题更新保持各自订阅。历史前插时,消息区根据前后滚动高度补偿阅读位置;自动跟随时继续定位到真实底部,视口快照归消息区所有并在切换时清理。
|
|
@@ -279,6 +283,8 @@ 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
|
+
|
|
282
288
|
批注编辑在 `features/annotations`,协议解析在 `domain/annotations.js`,存储和订阅在 `infrastructure/annotation-drafts.js`。选区编辑只更新草稿,统一发送由消息控制器完成。账户详情、侧栏宽度和主题分别保留自己的控件生命周期。
|
|
283
289
|
|
|
284
290
|
`ui/resize-handle.jsx` 与 `styles/resize-handles.css` 统一所有尺寸手柄的透明操作区、局部圆角标记、默认/悬停/拖动/键盘聚焦状态及全局拖动光标;横向、纵向与双向仅改变标记方向。侧栏、终端高度、终端列表、详情与各类窗口使用同一组件,尺寸规则及持久化仍由各自容器持有。`ui/resizable-textarea.jsx` 为供应商模型、命令目标、提问回答和消息批注字段提供同一手柄,保留表单字段、草稿与禁用语义,高度仅在挂载期间保留。
|
|
@@ -345,6 +351,10 @@ Codex 设置中的模型显示偏好由网页后端配置持久保存并广播
|
|
|
345
351
|
|
|
346
352
|
长历史首屏读取最近 100 条消息;首屏全部属于同一轮次且仍有历史时,后续按每页一个完整轮次恢复,减少工具密集对话的串行网络往返。首屏跨轮次时继续使用消息分页,保持短轮次对话的读取效率;两条路径均保留完整历史、轮内顺序、实时更新优先和切换隔离。
|
|
347
353
|
|
|
348
|
-
网页更新由 `service-maintenance.mjs` 持有 npm 稳定版检查缓存及维护操作,启动时和每小时读取官方注册表。认证后的 HTTP
|
|
354
|
+
网页更新由 `service-maintenance.mjs` 持有 npm 稳定版检查缓存及维护操作,启动时和每小时读取官方注册表。认证后的 HTTP 维护接口通过应用装配注入服务。独立维护任务执行 npm 下载、隔离安装、版本校验、目录替换、网页重启与 HTTPS 启动检查,任务状态原子保存在网页配置目录。失败时恢复原安装目录并核对恢复后的健康状态。源码部署提供检查与重启,npm 全局部署另提供更新。浏览器应用控制器轮询持久任务状态,页面保留编辑缓冲区,重启成功提示用户手动刷新网页加载新版本资源。部署条件由服务端在点击后的请求中校验并返回原因。
|
|
355
|
+
|
|
356
|
+
维护任务与 npm 安装方式分别管理:网页进程属于 `claudex-web.service` 时,通过独立 systemd 用户单元维护并由原服务重启;直接运行的网页由脱离原进程的维护进程完成相同操作。维护入口及 `service-maintenance-process.mjs` 复制到配置目录,替换安装后继续可用。普通进程记录原 Node.js、参数、工作目录及完整环境,SIGTERM 退出后按原入口启动;更新先安装和校验,再等待旧进程退出后替换目录。退出宽限期为 30 秒,超时后仅向身份仍匹配的网页进程发送 SIGKILL 并等待退出。进程操作按 PID、系统启动标识及进程启动时间核对归属,状态恢复核对所属维护进程,日志保存在 `maintenance/worker.log` 与 `maintenance/web.log`。原生后端继续由各自运行时持有。
|
|
357
|
+
|
|
358
|
+
CLI 安装同样属于维护占用,公共快照与只读维护快照分别携带所属后端的安装状态;网页重启及更新在安装完成后才接受新操作。桥接关闭时,尚未结束的 CLI 安装按实际结果完成,关闭后的管理器保持适配器关闭。
|
|
349
359
|
|
|
350
360
|
维护任务在权限 0600 的作业文件中保存网页服务的 npm 运行环境,包含优先使用当前 Node.js 目录的 PATH、用户配置位置、npm 配置、代理及证书设置。npm 安装子进程显式使用该环境,覆盖独立 systemd 用户单元继承的管理器环境。维护单元启动失败时立即释放网页提交门控,持久记录失败并允许重试。回归将 npm 与 systemctl 分别放入独立目录,让工作进程的 PATH 只包含 systemctl,验证环境传递、安装失败保留原包及重启失败回滚。
|
package/docs/deployment.md
CHANGED
|
@@ -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.
|
|
32
|
-
npm install -g ./claudex-web-4.1.
|
|
31
|
+
sha256sum -c claudex-web-4.1.4.tgz.sha256
|
|
32
|
+
npm install -g ./claudex-web-4.1.4.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
|
|
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` 查询。
|
package/docs/development.md
CHANGED
|
@@ -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
|
|
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
|
|
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
|
|
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
|
|
|
@@ -365,6 +371,8 @@ Ubuntu 安装指引回归在设备选择器中实际切换 Ubuntu,检查 DER
|
|
|
365
371
|
|
|
366
372
|
### 原消息编辑回归
|
|
367
373
|
|
|
374
|
+
挂载与文件引用回归在构建后执行 `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 的现有截图未展示原位编辑,图片内容保持适用。
|
|
375
|
+
|
|
368
376
|
执行 `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
377
|
|
|
370
378
|
客户端对照来自本机 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,6 +393,8 @@ Ubuntu 安装指引回归在设备选择器中实际切换 Ubuntu,检查 DER
|
|
|
385
393
|
|
|
386
394
|
双后端回退对照记录见[双后端回归审查](architecture/backend-regressions.md)。`tests/browser/backend-regressions.mjs` 使用生产构建、独立浏览器和隔离传输验证旧未分类目录、用户消息 Markdown、引用键盘打开、Claude 内部消息来源、主题、缩放与窄屏;通过 `CHROME_PATH`、`PLAYWRIGHT_MODULE` 配置浏览器工具。`tests/integration/claude-message-provenance.mjs` 通过真实 SDK 读取临时原生 JSONL,核对来源字段保留与用户轮次归属。
|
|
387
395
|
|
|
396
|
+
顶部文件夹与对话切换回归使用相同浏览器环境变量运行 `tests/browser/backend-interactions.mjs`。脚本核对分组顺序、置顶对话归属、空文件夹过滤、「未分类」、当前项与运行状态标记、进行中优先及开始与结束时间排序、切换文件夹直达首位对话、草稿恢复、键盘操作及底部工作目录选择器,并在深浅主题、桌面和窄屏的 80% 至 200% 实际页面缩放下检查两个菜单的边界。截图与结果位于 `.cache/backend-interactions/dual/`。
|
|
397
|
+
|
|
388
398
|
后端启停回归执行 `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
399
|
|
|
390
400
|
### 自定义模型显示别名回归
|
|
@@ -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))
|
package/package.json
CHANGED
|
@@ -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
|
-
|
|
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
|
|
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
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
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:
|
|
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
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
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();
|
|
@@ -11,6 +11,7 @@ import { createGoals } from "./goals.mjs";
|
|
|
11
11
|
import { modelOptions } from "./model-options.mjs";
|
|
12
12
|
import { recoverClaudeSessions } from "./recovery.mjs";
|
|
13
13
|
import { assertConversationOperation } from "../../bridge/conversation-policy.mjs";
|
|
14
|
+
import { subagentSettings } from "../../../../shared/subagent-settings.mjs";
|
|
14
15
|
|
|
15
16
|
export function createClaudeRuntime({
|
|
16
17
|
backend,
|
|
@@ -20,6 +21,7 @@ export function createClaudeRuntime({
|
|
|
20
21
|
compactions,
|
|
21
22
|
questions,
|
|
22
23
|
observeMessage,
|
|
24
|
+
readSubagentSettings = async () => subagentSettings(backend),
|
|
23
25
|
}) {
|
|
24
26
|
const running = new Map();
|
|
25
27
|
const queries = new Map();
|
|
@@ -208,18 +210,20 @@ export function createClaudeRuntime({
|
|
|
208
210
|
backend.id,
|
|
209
211
|
queued.providerId ?? session.providerId,
|
|
210
212
|
);
|
|
213
|
+
const settings = await readSubagentSettings();
|
|
214
|
+
const executionBackend = { ...backend, ...settings };
|
|
211
215
|
const subagentProvider =
|
|
212
|
-
|
|
213
|
-
? provider ||
|
|
216
|
+
settings.subagentProviderId === "@native"
|
|
217
|
+
? provider || settings.subagentEffort
|
|
214
218
|
? nativeSubagentProvider(backend)
|
|
215
219
|
: null
|
|
216
|
-
:
|
|
217
|
-
? await providers.get(backend.id,
|
|
220
|
+
: settings.subagentProviderId
|
|
221
|
+
? await providers.get(backend.id, settings.subagentProviderId)
|
|
218
222
|
: null;
|
|
219
223
|
if (
|
|
220
224
|
subagentProvider &&
|
|
221
225
|
!subagentProvider.native &&
|
|
222
|
-
!subagentProvider.models.includes(
|
|
226
|
+
!subagentProvider.models.includes(settings.subagentModel)
|
|
223
227
|
)
|
|
224
228
|
throw new Error("子代理模型已从供应商移除,请重新配置");
|
|
225
229
|
const options = modelOptions(
|
|
@@ -232,7 +236,6 @@ export function createClaudeRuntime({
|
|
|
232
236
|
(process && process.cwd !== session.cwd) ||
|
|
233
237
|
process?.nativeSessionId !== (session.nativeSessionId || threadId) ||
|
|
234
238
|
process?.providerKey !== JSON.stringify(provider) ||
|
|
235
|
-
process?.subagentProviderKey !== JSON.stringify(subagentProvider) ||
|
|
236
239
|
process?.review !== queued.review
|
|
237
240
|
) {
|
|
238
241
|
if (
|
|
@@ -248,7 +251,7 @@ export function createClaudeRuntime({
|
|
|
248
251
|
}
|
|
249
252
|
if (!process) {
|
|
250
253
|
process = await createExecutionSession({
|
|
251
|
-
backend,
|
|
254
|
+
backend: executionBackend,
|
|
252
255
|
session,
|
|
253
256
|
queued,
|
|
254
257
|
providers,
|
|
@@ -273,6 +276,7 @@ export function createClaudeRuntime({
|
|
|
273
276
|
});
|
|
274
277
|
queries.set(threadId, process);
|
|
275
278
|
} else {
|
|
279
|
+
await process.configureSubagent(executionBackend, subagentProvider);
|
|
276
280
|
await process.query.setPermissionMode(
|
|
277
281
|
queued.mode === "plan" || queued.review
|
|
278
282
|
? "plan"
|
|
@@ -286,13 +290,16 @@ export function createClaudeRuntime({
|
|
|
286
290
|
await process.query.applyFlagSettings({
|
|
287
291
|
effortLevel: queued.effort || null,
|
|
288
292
|
fastMode: options.settings.fastMode,
|
|
289
|
-
...((provider ||
|
|
293
|
+
...((provider ||
|
|
294
|
+
subagentProvider ||
|
|
295
|
+
process.subagentSettingsDirty) && {
|
|
290
296
|
env: process.settingsEnvironment(
|
|
291
297
|
model || process.model,
|
|
292
298
|
queued.effort,
|
|
293
299
|
),
|
|
294
300
|
}),
|
|
295
301
|
});
|
|
302
|
+
process.subagentSettingsDirty = false;
|
|
296
303
|
process.effort = queued.effort;
|
|
297
304
|
}
|
|
298
305
|
active.query = process.query;
|
|
@@ -8,6 +8,7 @@ import { hasBackendWork } from "../../../../shared/backend-activity.mjs";
|
|
|
8
8
|
import { launchWorker, workerLocation } from "./worker-launcher.mjs";
|
|
9
9
|
import { workerRevision } from "./worker-revision.mjs";
|
|
10
10
|
import { networkProxyEnvironment } from "../network-proxy.mjs";
|
|
11
|
+
import { executionBackend } from "../../../../shared/subagent-settings.mjs";
|
|
11
12
|
import {
|
|
12
13
|
captureNativeProcesses,
|
|
13
14
|
nativeProcessesAlive,
|
|
@@ -216,11 +217,17 @@ export function createClaudeWorkerAdapter({
|
|
|
216
217
|
initialized.revision?.entry !== options.revision.entry ||
|
|
217
218
|
initialized.revision?.hash !== options.revision.hash ||
|
|
218
219
|
(initialized.configuration &&
|
|
219
|
-
!isDeepStrictEqual(
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
220
|
+
!isDeepStrictEqual(
|
|
221
|
+
{
|
|
222
|
+
...initialized.configuration,
|
|
223
|
+
backend: executionBackend(initialized.configuration.backend),
|
|
224
|
+
},
|
|
225
|
+
{
|
|
226
|
+
backend: executionBackend(options.backend),
|
|
227
|
+
config: options.config,
|
|
228
|
+
runtimeEnv: options.runtimeEnv,
|
|
229
|
+
},
|
|
230
|
+
));
|
|
224
231
|
mayUpgrade =
|
|
225
232
|
!initialized.generation || options.generation > initialized.generation;
|
|
226
233
|
publish();
|
|
@@ -112,10 +112,12 @@ async function initialize(value) {
|
|
|
112
112
|
const temporary = `${optionsPath}.${process.pid}.tmp`;
|
|
113
113
|
await writeFile(temporary, JSON.stringify(options), { mode: 0o600 });
|
|
114
114
|
await rename(temporary, optionsPath);
|
|
115
|
-
const
|
|
115
|
+
const configuration = createBackendConfiguration(value.config);
|
|
116
|
+
const providers = createProviders(configuration);
|
|
116
117
|
adapter = createClaudeAdapter({
|
|
117
118
|
...value,
|
|
118
119
|
providers,
|
|
120
|
+
readSubagentSettings: () => configuration.readSubagentSettings("claude"),
|
|
119
121
|
send: (client, message) => client.deliver(message),
|
|
120
122
|
broadcast,
|
|
121
123
|
workspace: { handles: () => false, snapshot: () => ({}) },
|