@hjd-hitsz/claudex-web 4.1.2 → 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 +42 -0
- package/build-info.json +4 -4
- package/client/dist/_baseMerge.js +1 -1
- package/client/dist/app.js +89 -88
- package/client/dist/code-highlight-style.js +48 -13
- package/client/dist/dagre-NK4GIZVX.js +2 -2
- package/client/dist/document-editor.js +101 -136
- package/client/dist/file-panel.js +5 -1
- package/client/dist/graph.js +1 -1
- package/client/dist/index.js +2 -2
- package/client/dist/index10.js +1 -1
- package/client/dist/index11.js +1 -1
- package/client/dist/index12.js +1 -1
- package/client/dist/index13.js +2 -2
- package/client/dist/index14.js +1 -1
- package/client/dist/index15.js +1 -1
- package/client/dist/index16.js +2 -2
- package/client/dist/index17.js +1 -1
- package/client/dist/index18.js +2 -2
- package/client/dist/index19.js +1 -1
- package/client/dist/index20.js +1 -1
- package/client/dist/index21.js +1 -1
- package/client/dist/index22.js +1 -1
- package/client/dist/index3.js +1 -1
- package/client/dist/index4.js +1 -1
- package/client/dist/index5.js +1 -1
- package/client/dist/index6.js +2 -2
- package/client/dist/index7.js +1 -1
- package/client/dist/index8.js +1 -1
- package/client/dist/index9.js +1 -1
- package/client/dist/isArrayLikeObject.js +1 -1
- package/client/dist/style.css +1 -1
- package/docs/architecture/backend-regressions.md +2 -1
- package/docs/architecture/behavior.md +25 -7
- package/docs/architecture.md +20 -5
- package/docs/cli-command-coverage.md +1 -1
- package/docs/deployment.md +7 -3
- package/docs/development.md +25 -1
- package/docs/images/desktop-dark.png +0 -0
- package/docs/images/desktop-light.png +0 -0
- package/docs/releases/v4.1.3.md +8 -0
- 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 +55 -4
- package/server/src/backends/claude/native-provider.mjs +35 -0
- package/server/src/backends/claude/provider-environment.mjs +66 -11
- package/server/src/backends/claude/provider-transport.mjs +61 -9
- package/server/src/backends/claude/runtime.mjs +27 -5
- package/server/src/backends/claude/worker-client.mjs +14 -5
- package/server/src/backends/claude/worker-server.mjs +3 -1
- package/server/src/backends/codex/adapter.mjs +14 -4
- package/server/src/backends/codex/methods.mjs +0 -1
- package/server/src/backends/codex/requests.mjs +6 -2
- package/server/src/backends/codex/resume-lifecycle.mjs +38 -0
- package/server/src/backends/codex/subagent-model.mjs +19 -0
- package/server/src/backends/codex/upstream.mjs +9 -0
- package/server/src/backends/configuration.mjs +43 -0
- package/server/src/backends/manager.mjs +20 -2
- 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
|
@@ -33,7 +33,8 @@
|
|
|
33
33
|
## 验证入口
|
|
34
34
|
|
|
35
35
|
- `server/tests/backend-product-contract.test.mjs`:两端实际适配器执行同一套网页操作,覆盖离线偏好、旧目录继承、保存成功通知、验证和写入失败后的重试、目录创建、整理占用及历史读取。传输为模拟 app-server,Claude 仅检查版本,原生模型执行单独验证。
|
|
36
|
-
- `server/tests/codex-close-lifecycle.test.mjs` 与 `subscriptions.test.mjs
|
|
36
|
+
- `server/tests/codex-close-lifecycle.test.mjs`、`codex-resume-lifecycle.test.mjs` 与 `subscriptions.test.mjs` 覆盖取消订阅响应、其他连接持有、关闭事件与恢复错误的两种顺序、目标隔离、一次恢复上限、并发发送、原请求超时及断线清理。源码依据为 Codex 0.169.0 的 `thread_unsubscribe_response_inner`、`thread_resume_inner` 和 `unload_thread_without_subscribers`,取消订阅响应先于异步关闭完成。`tests/integration/codex-subscription-release.mjs` 使用真实 CLI、适配器与人工历史执行八组立即重新打开,模型轮次数为零。实现见 [thread_processor.rs](https://github.com/openai/codex/blob/rust-v0.169.0/codex-rs/app-server/src/request_processors/thread_processor.rs) 与 [thread_lifecycle.rs](https://github.com/openai/codex/blob/rust-v0.169.0/codex-rs/app-server/src/request_processors/thread_lifecycle.rs)。
|
|
37
|
+
- `tests/browser/codex-resume-lifecycle.mjs` 使用生产构建、隔离 HTTPS/WSS 服务与模拟原生关闭错误,验证首次打开的检查状态、自动恢复、连续三次点击重新打开及草稿保留,保存深浅主题与窄屏截图到 `.cache/codex-resume-lifecycle`。先将修复前的 `server/src`、`shared` 和根包文件保存在 `.cache/codex-resume-before`,用 `BROWSER_BEFORE=1` 记录旧桥接首次失败及手动重试;默认使用当前桥接,浏览器通过 `PLAYWRIGHT_MODULE` 与 `CHROME_PATH` 配置。
|
|
37
38
|
- `server/tests/backend-routing.test.mjs`:工作区根据适配器所有者声明路由,浏览器关闭只通过 `releaseClient` 释放所属代理;管理器保持与原生订阅集合隔离。`tests/architecture.test.mjs` 同时核对公共桥接、原生适配器和 HTTP 的依赖边界。
|
|
38
39
|
- `client/tests/backend-connection-recovery.test.js` 与组件输入队列回归:单后端恢复、另一后端状态隔离、草稿保留及队列迟到隔离。
|
|
39
40
|
- `client/tests/thread-order.test.js`:新旧目录、来源判定、明确归属、完整分页、活动排序及迟到事件。
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
# 功能与状态契约
|
|
2
2
|
|
|
3
|
+
Codex 对话恢复遇到原生明确报告的目标线程关闭中状态时,页面继续显示检查状态并保留历史、草稿及附件;桥接在所属关闭事件到达后最多重新恢复一次,成功后自动恢复输入。其他连接继续持有原生线程时沿用正常恢复响应。恢复等待沿用原请求期限,失败、超时及断线通过原有状态和重试入口处理,发送轮次在恢复成功后执行一次。
|
|
4
|
+
|
|
3
5
|
文件夹选择器默认隐藏名称以 `.` 开头的目录。“显示隐藏文件夹”由选择器持有,切换目录时保留,重新打开选择器时恢复关闭;直接输入绝对路径仍可进入隐藏目录并选择。
|
|
4
6
|
|
|
5
7
|
供应商模型支持可选显示别名,按供应商及模型 ID 保存到服务端配置。供应商编辑表单默认显示紧凑模型行,点击铅笔展开别名输入,清空使用原名称;供应商保存成功后更新菜单,取消编辑或保存失败时分别放弃或保留表单草稿。模型请求与历史记录继续使用原始模型 ID。
|
|
@@ -32,17 +34,19 @@ CLI 一键安装以当前平台原生组件完整下载为前提,完成后安
|
|
|
32
34
|
|
|
33
35
|
输入区 `@` 提供文件、目录、技能和同后端其他会话。文件搜索对返回的全部候选按相关性排序后再截取展示数量,名称精确、前缀、连续与紧凑跳字匹配依次优先,仅父目录命中的结果靠后;文件与目录使用相同排序,同分保留原生顺序。空查询与以 `/` 结尾的目录浏览继续按目录优先、名称排序。`@` 查询包含路径分隔符时仅提供文件和目录,分隔符保持路径输入语义;独立的 `/` 查询提供快捷命令和技能。技能候选支持名称、显示名和技能目录的大小写无关模糊匹配,允许按字符顺序输入缩写与跳字;精确、前缀、连续和紧凑跳字匹配依次优先,描述关键词作为低优先级补充。Tab 将当前候选补全为可继续编辑的查询文本并保持建议打开,文件与目录补全完整路径,支持继续输入 `/` 逐级查询;Enter 或点击确认后以独立的行内引用显示,文件按扩展名区分图标,目录、技能与会话使用对应图标;菜单关闭,光标移到引用后的空格。引用节点支持两侧输入、整项删除、撤销、复制粘贴、切换与刷新草稿恢复,发送和消息编辑保持名称与目标。删除引用同时移除该项的提交数据;重复引用保留正文位置,原生元数据按目标去重。Codex 使用原生技能与 thread:// 会话引用,通过同后端只读 read_thread 工具按需读取已保存正文,Claude 技能使用原生命令,会话引用在发送时读取完整分页的用户和助手正文;读取失败保留完整草稿。代码与普通外部链接保留原语义。
|
|
34
36
|
|
|
35
|
-
|
|
37
|
+
侧栏将所有可见的活动轮次对话集中排列在置顶和项目文件夹上方,仅沿用会话行左侧的运行圆圈,省去分区标题和说明。顶部快捷入口沿用对话排序,同时保留原项目或置顶列表中的会话。成功完成且带未读绿点的会话继续保留顶部快捷入口,当前选中的顶部会话在阅读清除绿点或轮次结束后继续保留,切换会话或新建对话后再移除;其他已结束会话沿用未读状态保留顶部入口。原项目归属、置顶偏好和文件夹收放状态保持不变。活动状态沿用实时轮次事件与重连快照。
|
|
36
38
|
|
|
37
|
-
|
|
39
|
+
侧栏、搜索结果和标题菜单使用同一排序。进行中的对话置前,按发起当前轮次的消息时间倒序,其余对话按最近有效结束时间倒序。缺少对应时间时沿用创建时间,侧栏按排序依据显示时间。打开、重命名和切换保留排序时间,新一轮开始或结束立即重排。完整分页历史补齐时保留较新的实时开始或结束时间。两个后端独立读取,任一后端失败时保留已显示且符合当前归档和搜索范围的记录,其余后端继续更新;侧栏及搜索显示所属后端的实际错误并提供重试。相同查询保留此前已确认的正文匹配记录,修改查询及卸载后忽略旧请求结果。
|
|
38
40
|
|
|
39
41
|
项目按固定状态分组,固定项目始终位于未固定项目之前,空项目及仅含置顶对话的项目同样遵循此规则,“未分类”始终位于末尾。同类项目的顺序使用页面内快照,归档、恢复和实时活动保留快照;固定与取消固定立即按新状态重新分组,各组内部沿用快照顺序。手动添加或固定的项目跨刷新保存。固定文件夹默认展开,其余默认折叠,每组先显示最新五条;“查看更多”覆盖后端全部分页。“未分类”保留独立归属,新建时按首次发送流程准备工作目录,已有目录可以沿用。
|
|
40
42
|
|
|
41
43
|
侧栏对话可拖到项目文件夹或“未分类”标题,悬停高亮,保存成功后展开目标并显示对话。移入文件夹为后续轮次选用目标目录,移到未分类保留有效工作目录;运行中的轮次继续完成,后续恢复和新轮次应用迁移结果。归属保存在服务端,刷新、重新连接、归档恢复及其他页面均沿用;保存失败保留原归属、草稿及附件,并提供错误提示。置顶对话移入文件夹后取消置顶。每个网页项目对应一个文件夹,原生历史通过所属后端读取。
|
|
42
44
|
|
|
45
|
+
顶部目录菜单沿用侧栏的分组顺序,仅列出当前对话列表中有记录的文件夹和“未分类”,置顶对话计入所属分组。选中其他分组直接打开排序首位的对话。标题菜单列出当前分组的对话,进行中条目沿用侧栏的转圈图标。打开对话恢复所属草稿。两个菜单标记当前项,选择当前项关闭菜单,支持方向键、Tab 和 Esc,窄屏保留两个入口。输入区底部的文件夹入口用于浏览和选取工作目录。
|
|
46
|
+
|
|
43
47
|
主对话与子代理使用 `domain/thread-history.js` 的完整历史读取流程。仅在 `thread/items/list` 明确不受支持时回退到 `thread/turns/list` 的完整消息分页。写入被其他客户端占用时继续提供已保存历史;其他读取错误保留实际错误和重试入口。
|
|
44
48
|
|
|
45
|
-
分支通过 `thread-catalog.js`
|
|
49
|
+
分支通过 `thread-catalog.js` 的统一动作创建。并行读取所属后端的未归档与已归档家族元数据,按真实 `forkedFromId` 关系生成数字后缀,兼容旧网页后缀并保留手动标题。创建及命名确认后打开分支,历史从最近一页开始加载,侧栏随后补齐。Codex 新分支的输入状态取自原生创建结果。用户在创建期间切换对话时,分支加入列表并保留当前选择。侧栏菜单、回复操作与 `/fork` 共用流程。归档、删除和标题通知同时更新当前对话与列表,旧列表或打开响应保留通知中更新的结果。
|
|
46
50
|
|
|
47
51
|
Codex 首轮发送后,桥接使用独立连接及临时会话生成简短标题;写入前重新读取目标记录。手动改名、归档、删除及断线取消旧生成任务,生成失败可在后续打开或发送时重试。标题生成的消息和订阅与用户对话隔离。Claude Code 对话沿用其原生标题与网页保存的用户名称。
|
|
48
52
|
|
|
@@ -74,6 +78,8 @@ Markdown 输入以逐字键入后自动排版为主要交互,选区格式工
|
|
|
74
78
|
|
|
75
79
|
最近一轮的初始用户消息提供铅笔形“编辑上一条消息”入口;原消息位置切换为紧凑的 Markdown 编辑框,正文固定两行并通过内部滚动查看长内容;宽度最多为 42rem,窄屏内最多占消息区的 90%。背景、边框、阴影和聚焦边框与底部输入框共用规则,发送使用主操作配色,深色及跟随系统主题同步适配。支持取消、发送、Enter 换行与 Ctrl+Enter 提交。编辑正文、引用附件和批注由消息组件独立持有,底部草稿保持原值。运行中补充消息继续通过运行轮次发送,历史编辑针对完整轮次。
|
|
76
80
|
|
|
81
|
+
原位编辑框独立于底部输入区的高度偏好及调节手柄,打开、取消及重新打开均保持两行布局,保留 Markdown 文件引用的名称与目标。
|
|
82
|
+
|
|
77
83
|
编辑提交先读取完整分页核对最近消息及运行状态,通过 `thread/revert` 回退到原轮次之前;仅在该方法明确不支持时使用 `thread/rollback`。成功回退后清理已移除的历史、时间与差异,再提交新轮次,刷新以实际后端记录恢复。回退失败保留原历史,发送失败保留编辑框及输入,重试核对保留轮次并复用已成功的回退。取消已回退的失败编辑时读取实际历史。连接、写入检查、整理及运行状态限制提交,异步读取和回退响应按对话及打开版本隔离;回退使较早的历史分页请求失效。其他页面收到 `thread/reverted` 时重新恢复所属对话。
|
|
78
84
|
|
|
79
85
|
Claude Code 编辑及分支通过原生会话分支保存保留前缀,网页逻辑对话与保留轮次标识稳定,原生 UUID 和后台自动唤醒锚点随分支更新。保留的原生别名归属原逻辑对话,列表和删除恢复保持去重;发送失败后重试沿用已成功完成的历史回退。
|
|
@@ -147,7 +153,7 @@ flowchart LR
|
|
|
147
153
|
|
|
148
154
|
本轮文件汇总合并成功完成的修改,默认最多展示五项;按对话、轮次保存实时净差异,历史采用所属轮次记录。按文件撤销由桥接重新读取真实记录,在临时目录校验补丁与源文件后写回;运行、冲突和重复请求分别受控,并广播结果。
|
|
149
155
|
|
|
150
|
-
Markdown
|
|
156
|
+
Markdown 文件默认使用可编辑的富文本预览,正文、表格和任务列表的修改同步到文件编辑缓冲区,保存按钮和 Ctrl+S 写入当前 Markdown。可切换源码并保留未保存内容,打开及切换视图保留原文件正文,实际编辑后序列化为 Markdown。公式沿用文件中的标准 Markdown 数学语法。代码块提供编辑与预览切换,Mermaid 继续使用公共图表展示。文本按文件名选择语法;媒体、PDF 和其他二进制由文件类型规则选择预览或下载,支持的流式媒体通过已认证 HTTP 路由读取。目标变化时清理播放器和对象 URL。
|
|
151
157
|
|
|
152
158
|
Claude Code 的原生后台任务按所属会话保存任务标识、类型、进度和实际所有者,`/stop` 读取全部后台终端分页并调用原生停止接口。后台任务通知触发的原生自动唤醒按独立轮次保存,轮次绑定真实消息锚点,刷新、编辑回退与分支维持顺序。
|
|
153
159
|
|
|
@@ -155,6 +161,8 @@ Claude Code 的原生后台任务按所属会话保存任务标识、类型、
|
|
|
155
161
|
|
|
156
162
|
## 子代理与共享渲染
|
|
157
163
|
|
|
164
|
+
设置中的每个后端在同一行提供子代理模型、思考强度和保存操作。模型选项从可用目录取得并以“供应商 / 模型”展示,Codex 候选遵循模型显示偏好。已选模型被隐藏后,以状态占位保留已存配置,候选中省去其名称,恢复显示后恢复选择。强度档位随模型能力提供,选择“原生默认”清除模型覆盖,选择“默认强度”清除强度覆盖。Claude 支持跨已配置供应商选择,原生账户模型使用其解析后的实际 ID。保存直接校验并持久化默认值,保持后端连接、原生主会话和活动任务,完成后广播配置并结束本次请求。后续原生会话配置读取使用最新值,Claude 下一轮通过原生会话级设置更新子代理默认选择,已启动子代理保留原路由及模型。保存失败保留选择并允许重试,清空后恢复原生默认;保存响应直接更新配置,模型目录与账户读取独立于保存操作。Codex 使用原生默认子代理模型,显式任务及自定义代理模型沿用原生优先级;Claude 使用原生强制子代理模型参数,原生 fork 及指定继承模型的技能继续遵循 CLI 的继承语义。模型选择、主供应商及主对话状态保持各自所有权。
|
|
165
|
+
|
|
158
166
|
Claude 子代理原生历史中,带有 `isSidechain=true` 与 `agentId` 的任务输入以侧链来源建立轮次,即使继承 SDK 入口和父轮次 `promptId`。主对话内部通知继续按其来源字段过滤,子代理任务、工具和回答完整恢复。
|
|
159
167
|
|
|
160
168
|
子代理按对话 ID 合并不同协议版本的活动,主对话工作过程与详情概览共用入口。只读详情复用完整历史、消息和工作过程,消息路径使用子代理的实际目录。切换代理或关闭详情清理监听并丢弃迟到结果。
|
|
@@ -163,7 +171,7 @@ Claude 子代理原生历史中,带有 `isSidechain=true` 与 `agentId` 的任
|
|
|
163
171
|
|
|
164
172
|
消息、工具结果、子代理及文件预览共用 Markdown 和 HTML 白名单过滤。安全的标题、对齐、图片、`picture` 及折叠内容统一处理,代码保留源码。相对资源以所属对话或文件目录解析;图片失败、主题切换及迟到读取均有隔离处理。
|
|
165
173
|
|
|
166
|
-
|
|
174
|
+
Markdown 正文图片居中展示,等比预览的上限为 640 × 480 像素,窄屏按正文可用宽度缩小,HTML 指定的图片宽度继续生效。消息附件缩略图上限为 320 × 240 像素。点击图片可查看大图,Esc、关闭按钮和空白区域退出后恢复焦点。Mermaid 从本站按需加载,严格模式绘制,默认使用 13px 字号与紧凑节点间距,按可用宽度等比缩小,长图默认在受限高度内滚动,工具栏的四角展开图标可显示完整高度,再次点击四角收起图标恢复紧凑高度,悬停及可访问名称分别为“展开图表”和“收起图表”;消息与文件预览共用展示规则。流程图方向菜单以当前实际布局选中横向或纵向,可选择另一方向进行切换,切换时恢复默认缩放,子图内部的方向声明保持原样。缩放按钮以 25% 为一步,在 50% 至 800% 之间调整,点击百分比复位;图表聚焦后支持 `+`、`-`、`0`,Ctrl+滚轮或触控板捏合缩放。方向、缩放与展开状态归当前图表组件,流式更新与主题重绘保留选择,卸载后恢复默认。查看及复制源码始终使用消息原文。流式未完成或解析失败时保留源码,清理临时节点并隔离旧主题及旧源码结果。
|
|
167
175
|
|
|
168
176
|
## 账户、登录与外观
|
|
169
177
|
|
|
@@ -223,14 +231,24 @@ Claude Code 网络代理在设置中提供跟随服务环境、关闭和 HTTP,
|
|
|
223
231
|
|
|
224
232
|
## 网页更新与重启
|
|
225
233
|
|
|
226
|
-
设置中的“更新与重启”显示当前版本、npm 最新稳定版与检查错误。桥接启动时及每小时自动检查,网页发现更新提供设置入口。npm
|
|
234
|
+
设置中的“更新与重启”显示当前版本、npm 最新稳定版与检查错误。桥接启动时及每小时自动检查,网页发现更新提供设置入口。npm 全局安装可更新并重启,源码部署使用源码更新流程。重启服务在当前版本下同样可用。systemd 用户服务沿用原服务重启,直接启动的进程通过独立维护进程按原 Node.js、参数、目录及环境重新启动。整个网页服务进程重启,网页交互终端随之结束,原生后端继续按各自生命周期执行。独立维护任务持久记录进度,重复操作合并,安装与启动失败提供错误及重试。新包先在隔离目录安装并验证,替换后启动失败恢复原包并核对启动结果。网页重连后保留草稿和文件编辑,用户保存编辑后主动刷新页面加载新资源。
|
|
227
235
|
|
|
228
|
-
|
|
236
|
+
更新及重启请求遇到活动轮次、后台任务、排队输入、待答提问、内部命令、上下文整理或后端 CLI 安装时,结束本次操作并短暂提示用户结束任务后重试。提示五秒后关闭,用户稍后重新发起操作。切换阶段暂停网页提交,避免提交与重启竞争。重启成功后网页显示“服务已重启,请刷新网页”,用户自行刷新。
|
|
229
237
|
|
|
230
238
|
npm 更新沿用网页服务的 Node.js/npm 路径、npm 配置及网络代理与证书环境,支持 NVM 和自定义用户安装目录。独立维护单元启动失败时立即恢复网页提交,保留失败结果并允许重新执行维护操作。
|
|
231
239
|
|
|
240
|
+
发现新版时更新按钮可点击,重启按钮在空闲时可点击。部署方式与服务管理条件由服务端在操作请求中校验,失败原因显示在更新卡片内,并允许再次操作。错误、维护进度与完成提示统一放在卡片内的产品信息和操作组下方,长文本按卡片宽度换行。请求及维护任务执行期间暂时禁用按钮;版本检查确认无需更新时保留“无需更新”的禁用状态。
|
|
241
|
+
|
|
232
242
|
发现新版本后,侧栏底部显示带版本号的更新入口并标记设置按钮;侧栏收起或窄屏时,顶部显示紧凑更新入口。设置页按更新与重启、模型与服务配置、其他设置、网页登录分组。更新卡片集中显示产品身份和主操作,当前与最新版本在产品名下同行显示,产品图标、版本信息与检查更新、重启服务、更新按钮在卡片中垂直居中并同行排列,空间不足时操作组整体换行,三个按钮保持同行,复用设置页按钮的尺寸和边框,主要更新操作位于右侧,有新版时显示“更新至版本号”,无需更新时显示灰色禁用的“无需更新”,按钮数量与位置保持稳定;检查期间显示进行状态。设置卡片通过间距区分内部内容。其他设置的选项间距保持一致,状态与错误说明紧随所属选项并与选项文字对齐。原生后端的当前版本合并到标题行,正常连接以状态点显示,安装操作失败作为本次设置访问中的短暂提示,重新打开设置跳过历史安装提示,有新版时在按钮直接显示目标版本并允许更新,版本相同或本机更新时保留灰色禁用的“无需更新”按钮;未安装、停用及连接失败保留文字状态。网页主题始终跟随系统。点击更新入口直接打开设置并滚动、聚焦“更新与重启”区域。界面只显示版本、操作与必要状态,检查周期及部署实现保留在部署文档。
|
|
233
243
|
|
|
234
244
|
维护任务的持久结果用于状态核对,操作提示归属当前设置访问。首次加载、刷新及重新打开设置跳过历史完成和失败提示;当前访问发起的操作按任务开始时间确认结果并只显示一次。关闭设置清除提示并使在途请求的后续反馈失效,后台任务继续按真实状态执行。代理保存反馈五秒后消失,表单错误和实际连接、下载故障按各自当前状态提供处理入口。
|
|
235
245
|
|
|
236
246
|
运行与加载状态使用静态图标,任务进度与耗时按实际数据更新。等待期间省去循环旋转和呼吸动画,使稳定内容仅随进度变化重新绘制;任务完成后清除运行提示并停止对应计时。
|
|
247
|
+
|
|
248
|
+
创建对话分支时显式传递来源对话的模型和思考强度。当前对话采用创建动作开始时的输入区选择,侧栏其他对话通过原生读取结果取得配置;分支恢复继续采用后端保存结果。回归覆盖全局默认模型与来源不同及非当前对话分支。
|
|
249
|
+
|
|
250
|
+
### 目标交互
|
|
251
|
+
|
|
252
|
+
`/goal` 进入主输入框的目标输入状态,并切换为执行模式;退出目标输入保留正文和附件。提交目标使用 `thread/goal/set`,已有目标先显示替换确认。附件先写入受限附件目录,再将本机文件引用纳入目标。目标摘要常驻输入区上方,按原生状态展示追踪、暂停、阻塞、用量限制、预算限制及完成,提供暂停、恢复、编辑与清除操作。刷新、重连与切换对话重新读取所属目标,实时通知优先于迟到响应。
|
|
253
|
+
|
|
254
|
+
编辑在右侧详情完成,标题与关闭入口同行,紧凑工具栏集中展示更新时间、还原图标和保存按钮,正文占满中间可用区域。Token 预算默认收起于底部辅助区域,展开后编辑。支持 Markdown、还原与 Ctrl+Enter 保存;编辑草稿按对话保存,保存失败保留内容。保存正文沿用客户端激活目标的语义。目标操作按对话串行,断线、整理及提交期间暂停写入;预算及完成判断由所属原生后端维护。
|
package/docs/architecture.md
CHANGED
|
@@ -127,14 +127,15 @@ 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`:新对话的项目模型与思考强度选择、本地待保存记录、服务端同步和恢复时的选择版本。已有对话的模型与思考强度由导航控制器按后端对话读取和恢复结果取得;连接初始化只为新对话应用项目默认选择,恢复期间的手动调整按选择版本保护。
|
|
138
|
+
- `goals.js`:按完整对话标识持有原生目标快照、读取错误和写入占用;请求版本隔离迟到读取与保存响应,原生 `thread/goal/updated` 和 `thread/goal/cleared` 通知优先。目标输入复用主输入及附件草稿,替换已有目标先确认,成功只清理已提交内容。
|
|
138
139
|
- `account.js`:账户与额度读取、并发合并、通知版本及账户切换隔离。额度组件负责前台刷新触发和局部倒计时。
|
|
139
140
|
- `compaction.js`:手动整理、状态检查及断线恢复核对。整理占用进入共享状态后,所有发送入口采用相同限制。领域层按任务标识合并桥接记录,已结束结果只更新页面已跟踪的同一任务;状态容器在离开对话时清理其完成提示,浏览器只持久保存未结束任务。
|
|
140
141
|
- `events.js`:后端通知到应用状态的转换。消息、轮次、标题、差异与终端变化按所属对话和轮次更新。
|
|
@@ -200,9 +201,11 @@ sequenceDiagram
|
|
|
200
201
|
|
|
201
202
|
Codex 原生适配全部位于 `backends/codex/`。`adapter.mjs` 组合原生传输与公共网页操作;`upstream.mjs` 持有 app-server 握手、请求编号、超时及重连;`subscriptions.mjs` 持有原生订阅、写入恢复及空闲释放;`requests.mjs` 与 `events.mjs` 分别处理原生请求和事件;`compaction-recovery.mjs` 通过原生历史核对整理结果。Codex 的原生命令执行和标题生成沿用原有调用链。
|
|
202
203
|
|
|
204
|
+
Codex 目标查询直接读取原生已持久化状态,页面显示目标时省去加载写入会话。发送新轮次继续按实际订阅恢复写入。已有列表记录的顺序随实时轮次状态更新,列表全量同步在记录尚未显示或轮次结束时执行。
|
|
205
|
+
|
|
203
206
|
Codex 适配器在原生新建、恢复和分支参数中加入 `claudex_references` 只读 MCP 配置,保留原有会话配置并沿用实际后端地址,不修改原生全局配置。原生 CLI 持有 `reference-mcp.mjs` 子进程,它直接连接同一 app-server,提供带游标的 `read_thread` 用户与助手正文读取,网页断开不影响读取。引用按 `thread://` 目标提交并提示代理通过该工具读取;读取结果作为历史参考数据。单元测试覆盖配置合并、分页、后端隔离与错误,`tests/integration/codex-reference-tools.mjs` 用真实 CLI 验证 MCP 注册和调用,隔离模拟历史数据并保持模型调用为零。
|
|
204
207
|
|
|
205
|
-
Codex
|
|
208
|
+
Codex 取消订阅在原生响应确认后结束本连接的释放;其他连接仍持有订阅时原生会话继续存在。后续请求等待取消订阅响应,发送按原生恢复流程重新订阅。Codex 0.169.0 的关闭任务在响应后异步完成,`thread/resume` 在此期间返回目标线程的明确 closing 错误。原生传输通过 `resume-lifecycle.mjs` 将该恢复请求保留到对应 `thread/closed` 到达后重新发送一次,关闭事件先到时同样处理;严格核对原生错误码、完整文本和目标 ID,其他错误直接结算。网页请求及内部写入恢复共用此流程,沿用原请求的 120 秒期限,超时或断线清理等待,运行轮次只在恢复成功后提交。`thread/closed` 同时清理实际已卸载会话的状态。
|
|
206
209
|
|
|
207
210
|
公共桥接通过参数取得后端能力;两个原生适配器各自依赖所属后端和公共服务。架构检查禁止公共桥接依赖具体后端、两个原生适配器互相依赖,以及 HTTP 处理器直接依赖桥接或后端实现。
|
|
208
211
|
|
|
@@ -250,18 +253,24 @@ Claude 网页桥接重启或异常退出时,独立执行服务继续持有模
|
|
|
250
253
|
|
|
251
254
|
外部供应商的模型环境由 `provider-environment.mjs` 生成,主模型与 Opus、Sonnet、Haiku 三个原生别名随本轮选择一起更新。初始化与持续会话共用映射,运行时等待原生模型和设置更新完成后提交输入,设置失败按本轮错误结算并允许重试。
|
|
252
255
|
|
|
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`,切换到不支持当前强度的模型时清除该强度选择。控件仅持有尚未保存的模型、强度及错误。
|
|
257
|
+
|
|
253
258
|
## 5. 功能模块与共享展示
|
|
254
259
|
|
|
260
|
+
顶部文件夹和对话标题复用 `app/header-switcher.jsx` 的菜单、键盘与焦点管理。两者共享侧栏的分组及排序。选择文件夹打开排序首位的对话,选择标题打开对应对话,进行中条目共用侧栏的转圈图标。
|
|
261
|
+
|
|
255
262
|
`features/conversation` 组合消息、工作过程、提问和目录。领域层负责按轮次分组与排序;主对话和子代理的只读详情使用相同历史读取和展示规则。计划正文由独立的 `plan-message.jsx` 展示,默认保留约 320 像素的正文预览(用字体相对单位定义),底部渐隐并提供展开入口;收放状态由卡片组件持有,流式更新保留用户选择,卸载后恢复默认折叠,领域层 `plans.js` 根据最新用户消息、计划消息与成功轮次确定批准资格;步骤进度保持独立。工作过程记录、最终回答操作以及本轮文件汇总分别渲染,保持流式过程与历史恢复的顺序一致。
|
|
256
263
|
|
|
257
264
|
主对话按消息快照一次建立轮次到记录的索引,供文件汇总复用;文件汇总按记录、净差异及工作目录缓存计算。Markdown 组件按正文、批注内容和目录复用解析结果,内部媒体和主题更新保持各自订阅。历史前插时,消息区根据前后滚动高度补偿阅读位置;自动跟随时继续定位到真实底部,视口快照归消息区所有并在切换时清理。
|
|
258
265
|
|
|
259
|
-
`features/markdown` 集中提供 Markdown、HTML 白名单、图片、链接、数学公式和 Mermaid
|
|
266
|
+
`features/markdown` 集中提供 Markdown、HTML 白名单、图片、链接、数学公式和 Mermaid。消息与工具结果复用同一渲染入口,文件富文本编辑器的 HTML、代码与图表节点继续复用该入口;文件目录由上下文传递,局部组件负责媒体加载与清理。文本安全过滤和路径解析在这里统一维护。
|
|
260
267
|
|
|
261
268
|
Mermaid 的流程图主方向转换归 `domain/mermaid.js`,原始正文保持独立;`mermaid-block.jsx` 持有方向、缩放、展开和源码查看状态,`mermaid-diagram.jsx` 按容器宽度等比绘制并处理图内滚动、键盘及 Ctrl+滚轮缩放。尺寸观察与滚轮监听随组件卸载清理,重新绘制继续隔离旧源码和主题结果。
|
|
262
269
|
|
|
263
270
|
`features/workspace` 把文件树、目录选择、文件编辑、差异、终端和对话详情拆成独立模块。编辑器与文件变更装饰分别封装;显示的删除装饰与实际保存正文分开处理。`context-panel.jsx` 组合概览和子代理详情,主对话切换统一清理选择,编辑缓冲区继续按原主对话保存。
|
|
264
271
|
|
|
272
|
+
`file-markdown-editor.jsx` 复用文档编辑器的文件模式提供可编辑预览,文件模式使用标准 Markdown 数学语法,输入区继续使用其双美元符号规则。`file-document-views.jsx` 按原始源码位置组合成对 HTML,持有本地图片、HTML 和代码的节点展示,复用公共安全渲染及 Mermaid 交互,节点销毁时释放展示实例。文件正文仍归文件面板持有,源码与富文本共用同一缓冲区及保存入口。
|
|
273
|
+
|
|
265
274
|
`app` 将输入框和错误提示作为底部插槽传入对话布局。对话布局统一提供消息、底部输入和右侧详情的几何边界;桌面展开详情时输入区域避让右侧面板,详情占满工作区高度。文件下载入口归文件面板工具栏,媒体预览组件负责内容展示及加载重试。
|
|
266
275
|
|
|
267
276
|
`domain/file-suggestions.js` 负责将原生文件候选按名称与查询路径的相关性统一排序,展示数量在排序后限制;后端继续持有原生索引与查询生命周期。
|
|
@@ -274,6 +283,8 @@ Mermaid 的流程图主方向转换归 `domain/mermaid.js`,原始正文保持
|
|
|
274
283
|
|
|
275
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` 交付。
|
|
276
285
|
|
|
286
|
+
原位消息编辑通过 `MarkdownEditor` 的 `fill` 模式挂载文档,沿用两行高度及内部滚动。底部输入区的 `EditorFrame` 独立持有高度偏好和调节手柄,按 `.composer` 容器测量可用空间;原位编辑保持自身尺寸。
|
|
287
|
+
|
|
277
288
|
批注编辑在 `features/annotations`,协议解析在 `domain/annotations.js`,存储和订阅在 `infrastructure/annotation-drafts.js`。选区编辑只更新草稿,统一发送由消息控制器完成。账户详情、侧栏宽度和主题分别保留自己的控件生命周期。
|
|
278
289
|
|
|
279
290
|
`ui/resize-handle.jsx` 与 `styles/resize-handles.css` 统一所有尺寸手柄的透明操作区、局部圆角标记、默认/悬停/拖动/键盘聚焦状态及全局拖动光标;横向、纵向与双向仅改变标记方向。侧栏、终端高度、终端列表、详情与各类窗口使用同一组件,尺寸规则及持久化仍由各自容器持有。`ui/resizable-textarea.jsx` 为供应商模型、命令目标、提问回答和消息批注字段提供同一手柄,保留表单字段、草稿与禁用语义,高度仅在挂载期间保留。
|
|
@@ -340,6 +351,10 @@ Codex 设置中的模型显示偏好由网页后端配置持久保存并广播
|
|
|
340
351
|
|
|
341
352
|
长历史首屏读取最近 100 条消息;首屏全部属于同一轮次且仍有历史时,后续按每页一个完整轮次恢复,减少工具密集对话的串行网络往返。首屏跨轮次时继续使用消息分页,保持短轮次对话的读取效率;两条路径均保留完整历史、轮内顺序、实时更新优先和切换隔离。
|
|
342
353
|
|
|
343
|
-
网页更新由 `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 安装按实际结果完成,关闭后的管理器保持适配器关闭。
|
|
344
359
|
|
|
345
360
|
维护任务在权限 0600 的作业文件中保存网页服务的 npm 运行环境,包含优先使用当前 Node.js 目录的 PATH、用户配置位置、npm 配置、代理及证书设置。npm 安装子进程显式使用该环境,覆盖独立 systemd 用户单元继承的管理器环境。维护单元启动失败时立即释放网页提交门控,持久记录失败并允许重试。回归将 npm 与 systemctl 分别放入独立目录,让工作进程的 PATH 只包含 systemctl,验证环境传递、安装失败保留原包及重启失败回滚。
|
|
@@ -7,7 +7,7 @@
|
|
|
7
7
|
## 新增能力
|
|
8
8
|
|
|
9
9
|
- `/init`:检查当前实际工作目录。已有 `AGENTS.md` 时保留并打开;缺少时通过正常轮次要求模型阅读项目、生成贡献指南,并在写入前再次检查已有文件。生成任务沿用当前模型、思考强度与速度,消息附件保持在输入框中。Claude Code 每次提交实时读取当前目录及所有祖先的 `AGENTS.override.md` 或 `AGENTS.md`,同目录优先 override,保留完整正文、文件路径和目录作用域;本轮快照替换旧快照,更新和删除从下一轮生效,原生 `CLAUDE.md` 继续适用。
|
|
10
|
-
- `/goal [目标 | edit | pause | resume | clear]
|
|
10
|
+
- `/goal [目标 | edit | pause | resume | clear]`:无参数进入主输入框的目标输入状态,`edit` 打开侧边编辑器;输入目标文字后设置并开始目标;`pause` 暂停、`resume` 恢复、`clear` 清除。侧边编辑器支持 Markdown、还原、草稿恢复与可选 token 预算,预算留空表示不限。目标摘要常驻输入区上方并随原生通知更新;替换已有目标先确认。新对话在提交目标时创建实际对话,所有显式修改携带 `origin: user`,通过 `thread/goal/get`、`thread/goal/set` 和 `thread/goal/clear` 完成。
|
|
11
11
|
- `/stop`:打开当前对话的后台终端列表,完整读取 `thread/backgroundTerminals/list` 分页,显示命令、目录与进程标识;点击“停止全部后台终端”调用 `thread/backgroundTerminals/clean`。聊天区原有停止按钮继续中断当前任务轮次。
|
|
12
12
|
|
|
13
13
|
## 原有命令
|
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
|
|
|
@@ -137,6 +137,8 @@ Claude Code 的对话、配置和原生账户状态继续保存在本机 CLI 原
|
|
|
137
137
|
|
|
138
138
|
## 配置
|
|
139
139
|
|
|
140
|
+
在“设置 → 模型与服务配置”中,分别在两个后端的同一行选择子代理模型及思考强度,强度档位随所选模型提供。Codex 子代理候选遵循“显示的模型”偏好。Claude Code 的选项按“供应商 / 模型”排列,可以为子代理选择其他供应商;保存前等待所属后端空闲。选择“原生默认”恢复原生子代理模型规则。
|
|
141
|
+
|
|
140
142
|
全局命令从 `~/.config/claudex-web/.env` 读取配置;设置 `XDG_CONFIG_HOME` 时使用其下的 `claudex-web` 目录,设置 `CLAUDEX_WEB_CONFIG_DIR` 时优先使用该目录。外部环境变量优先于 `.env`。执行 `claudex-web config init` 可创建配置并显示路径,已有配置和 npm 升级后的配置均会保留。
|
|
141
143
|
|
|
142
144
|
systemd 服务会记录安装时的配置目录,后续启动继续使用该目录。更换配置目录时,用新的 `CLAUDEX_WEB_CONFIG_DIR` 执行 `claudex-web service install`,再按下文方法重启网页服务。
|
|
@@ -286,6 +288,8 @@ Claude Code 的网络代理使用服务器可访问的代理地址和端口,
|
|
|
286
288
|
|
|
287
289
|
## 网页更新与重启
|
|
288
290
|
|
|
289
|
-
在设置的“更新与重启”查看当前版本和最新稳定版。服务启动时及每小时自动检查,也可点击“检查更新”。通过 npm
|
|
291
|
+
在设置的“更新与重启”查看当前版本和最新稳定版。服务启动时及每小时自动检查,也可点击“检查更新”。通过 npm 全局安装的部署,发现新版后可点击“更新至版本号”完成更新和重启,服务账户须具有安装目录写权限。新版本先在隔离目录完成安装与校验,启动失败会恢复原安装。源码部署先更新源码并构建,再点击“重启服务”。有新版时更新按钮可点击,部署或权限检查失败会在操作后显示原因。
|
|
292
|
+
|
|
293
|
+
通过 systemd 用户服务运行时,维护任务由独立用户单元执行;通过 `claudex-web start`、`npm start` 或 Node.js 直接启动时,由独立维护进程完成更新,并按原 Node.js、启动参数、工作目录和环境重新启动网页。原网页退出后,维护和新网页进程继续运行,日志保存在网页配置目录的 `maintenance/worker.log` 和 `maintenance/web.log`。后端 CLI 正在安装或更新时,网页更新与重启会提示等待当前任务结束。
|
|
290
294
|
|
|
291
295
|
“重启服务”随时可用于重新启动整个网页服务进程,执行期间连接短暂中断,网页自动重连。网页交互终端会结束,请先保存文件编辑。原生后端由其独立服务管理。更新完成后保存编辑并手动刷新网页加载新版界面。维护进度保存在网页配置目录的 `maintenance/status.json`,执行日志可通过 `journalctl --user -u claudex-web-maintenance` 查询。
|
package/docs/development.md
CHANGED
|
@@ -92,10 +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
|
|
|
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 的现有界面截图展示文字、代码和文件列表,检查后继续使用。
|
|
100
|
+
|
|
97
101
|
## 双后端开发与验收
|
|
98
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
|
+
|
|
99
105
|
双后端的统一范围由[产品契约](architecture/backends.md)定义;`shared/product-contract.mjs` 只注册工作区和对话方法的路由分组。原生能力分别接入统一用例,文件与网页终端由共用工作区服务提供。文件模糊查询按所属后端路由,Codex 保留原生 app-server 调用,Claude Code 使用原生 `file_suggestions` 控制请求及 CLI 文件索引;两端共用输入建议,回归同时核对原有 Codex 路径和 Claude 新增实现。CLI/SDK 生命周期、原生历史及参数发生变化时,同时检查首次请求、流式展示、轮次完成、刷新恢复和错误重试。Claude 执行服务通过受限本机 IPC 独立于网页桥接运行,网页关闭仅释放连接;源码与安装来源的代码身份按实际发行文件计算。
|
|
100
106
|
|
|
101
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 的执行与恢复由下述验收覆盖。架构检查同时禁止公共桥接依赖具体后端和原生适配器之间的交叉依赖。
|
|
@@ -177,10 +183,18 @@ CLAUDE_EXECUTABLE=/absolute/path/to/claude MODEL_BASE_URL=https://model.example
|
|
|
177
183
|
|
|
178
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 的原生附加命令以其自身当前目录返回结果为准。
|
|
179
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
|
+
|
|
180
188
|
以上查验使用本机可取得的源码及已安装打包资源。保存的网页客户端、当前网页产品、Codex 客户端和 Claude Code 运行时各自注明版本与来源;提取资源保留在本机忽略目录,仓库只维护行为结论和隔离验证。
|
|
181
189
|
|
|
182
190
|
## 格式与验证
|
|
183
191
|
|
|
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` 使用临时文件与模拟端点验证。
|
|
193
|
+
|
|
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 引用的现有图片展示对话及文件面板,本项设置变化未影响其画面。
|
|
195
|
+
|
|
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`。
|
|
197
|
+
|
|
184
198
|
模型名称布局回归在构建后执行 `PLAYWRIGHT_MODULE=/path/to/playwright/index.mjs CHROME_PATH=/path/to/chromium node tests/browser/model-select.mjs`。脚本使用隔离模型目录及模拟后端,在桌面、平板竖屏和手机窄屏核对完整名称、键盘选择、两行输入、发送与停止按钮、深浅主题及 80%~200% 实际页面缩放;结束后恢复缩放并清理浏览器配置。截图与测量记录保存在 `.cache/model-select/after`。修复前将构建复制到 `.cache/model-select/before/dist`,设置 `BROWSER_BEFORE=1` 可复现固定宽度截断。
|
|
185
199
|
|
|
186
200
|
长对话切换回归先执行 `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 图片展示完整加载后的界面,布局和内容继续适用。
|
|
@@ -208,7 +222,7 @@ npm run check
|
|
|
208
222
|
|
|
209
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`。
|
|
210
224
|
|
|
211
|
-
分支标题回归先执行 `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 的现有演示图片未展示分支标题,相关图片继续使用既有演示内容。
|
|
212
226
|
|
|
213
227
|
测试采用模拟后端,不消耗模型额度,也不修改真实聊天。协议或生命周期变更应补充对应回归测试;真实后端验证使用临时会话或明确的测试数据。各测试目录的覆盖范围见[架构设计中的验证章节](architecture.md#7-可执行约束与验证)。
|
|
214
228
|
|
|
@@ -357,6 +371,8 @@ Ubuntu 安装指引回归在设备选择器中实际切换 Ubuntu,检查 DER
|
|
|
357
371
|
|
|
358
372
|
### 原消息编辑回归
|
|
359
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
|
+
|
|
360
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/`。领域与组件回归另覆盖完整轮次分页、旧接口兼容、运行状态、过期编辑、批注及附件独立性。
|
|
361
377
|
|
|
362
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` 通知其他页面。客户端界面控制连接超时,交互证据使用本机打包实现;提取资源仅保存在忽略目录。
|
|
@@ -377,6 +393,8 @@ Ubuntu 安装指引回归在设备选择器中实际切换 Ubuntu,检查 DER
|
|
|
377
393
|
|
|
378
394
|
双后端回退对照记录见[双后端回归审查](architecture/backend-regressions.md)。`tests/browser/backend-regressions.mjs` 使用生产构建、独立浏览器和隔离传输验证旧未分类目录、用户消息 Markdown、引用键盘打开、Claude 内部消息来源、主题、缩放与窄屏;通过 `CHROME_PATH`、`PLAYWRIGHT_MODULE` 配置浏览器工具。`tests/integration/claude-message-provenance.mjs` 通过真实 SDK 读取临时原生 JSONL,核对来源字段保留与用户轮次归属。
|
|
379
395
|
|
|
396
|
+
顶部文件夹与对话切换回归使用相同浏览器环境变量运行 `tests/browser/backend-interactions.mjs`。脚本核对分组顺序、置顶对话归属、空文件夹过滤、「未分类」、当前项与运行状态标记、进行中优先及开始与结束时间排序、切换文件夹直达首位对话、草稿恢复、键盘操作及底部工作目录选择器,并在深浅主题、桌面和窄屏的 80% 至 200% 实际页面缩放下检查两个菜单的边界。截图与结果位于 `.cache/backend-interactions/dual/`。
|
|
397
|
+
|
|
380
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`。
|
|
381
399
|
|
|
382
400
|
### 自定义模型显示别名回归
|
|
@@ -410,3 +428,9 @@ Ubuntu 安装指引回归在设备选择器中实际切换 Ubuntu,检查 DER
|
|
|
410
428
|
异步回复收纳回归在构建后执行 `PLAYWRIGHT_MODULE=/path/to/playwright/index.mjs CHROME_PATH=/path/to/chromium node tests/browser/async-replies.mjs`。夹具保留真实 Codex 消息的 `delivery: async` 与 `phase: final_answer` 组合,检查中途回复在折叠时隐藏、展开后完整可读、连续补充保留一个工作过程及原展开状态、流式投递、最终回答操作与草稿;刷新、深浅主题、桌面与窄屏、80% 至 200% 实际页面缩放采用相同断言。截图及结果保存在 `.cache/async-replies/after`。`BROWSER_BEFORE=1 BROWSER_BUILD_DIR=/path/to/previous/dist` 使用旧构建复现外露;`CONVERSATION_NATIVE_FILE=/path/to/turn.json` 可重放只读导出的真实轮次,原生记录保存在 Git 忽略目录且不调用模型。测试结束恢复缩放并清理独立浏览器配置。README 图片展示普通已完成任务,现有图片继续适用。
|
|
411
429
|
|
|
412
430
|
运行状态渲染回归使用 `PLAYWRIGHT_MODULE=/path/to/playwright/index.mjs CHROME_PATH=/path/to/chromium node tests/browser/status-rendering.mjs`,通过隔离后端和生产构建验证运行、展开、完成、草稿保留及计时更新,并记录 3.1 秒稳定内容期间的绘制帧数与活动动画。证据写入 `.cache/status-rendering/after`。旧构建放入 `.cache/status-rendering/before/dist`,设置 `BROWSER_BEFORE=1` 复现循环动画引起的逐帧绘制。该回归关闭 GPU,验证浏览器绘制调度;实际 GPU 占用另通过桌面静置采样核对。
|
|
431
|
+
|
|
432
|
+
### 目标交互回归
|
|
433
|
+
|
|
434
|
+
本机客户端对照为 Codex 26.1007.21434 的 `/usr/lib/chatgpt/resources/app.asar`:`app-primary-f49030709665.js` 包含目标输入指示、常驻摘要、替换确认及操作;`thread-goal-side-panel-content-3f8ca4dc6e07.js` 包含侧边 Markdown 编辑、还原、保存与更新时间,`toolbar-row-123131d0eebd.js` 确认更新时间与操作同排的紧凑布局;`app-initial-ed5807835d97.js` 包含原生目标设置、状态更新及清除调用。客户端窗口控制超时,行为依据来自上述可取得的打包实现。提取资源保存在忽略目录 `.cache/goal-client`。
|
|
435
|
+
|
|
436
|
+
构建后运行 `CHROME_PATH=/path/to/chromium BROWSER_OUTPUT_DIR=.cache/goal-browser node tests/browser/commands.mjs`,使用生产构建及隔离模拟对话核对目标创建、暂停、恢复、侧边编辑、预算、深浅主题、窄屏及 80%~200% 实际浏览器缩放;通过 Chromium 设置页调整页面缩放并核对 DPR。目标控制器测试覆盖通知与迟到请求、重复提交、失败重试和替换确认。`node --import ./tests/helpers/test-console.mjs tests/integration/codex-native-goals.mjs` 使用临时原生目录验证真实 Codex 的暂停目标创建、读取、编辑、清除与通知,模型调用为零;Claude 原生执行验证使用同样预加载入口运行 `tests/integration/claude-native-goals.mjs`,接入本机模拟模型服务,核对原生目标评估及预算生命周期。README 现有图片展示普通对话及文件预览,目标专项截图单独保存在上述目录。右侧目标面板采用单行标题、紧凑工具栏与独立滚动正文,预算默认收起,展开后验证输入与保存。面板调整前的桌面及手机对照图保存在 `.cache/goal-panel-before`。
|
|
Binary file
|
|
Binary file
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
# Claudex Web v4.1.3
|
|
2
|
+
|
|
3
|
+
- 设置中可为 Codex 与 Claude Code 分别选择子代理模型和思考强度,并在同一行保存。Codex 候选遵循“显示的模型”偏好,Claude Code 支持为子代理选择其他供应商的模型。([3b71464](https://github.com/hjd-hitsz/claudex-web/commit/3b71464bdec72fa8449057d47810a69fd92e88db))
|
|
4
|
+
- `/goal` 支持直接在输入框描述目标,持续查看状态并暂停、恢复或清除。侧边编辑支持 Markdown、预算和草稿恢复,替换目标前可确认。([7490ea9](https://github.com/hjd-hitsz/claudex-web/commit/7490ea92bc076ffbcb6307a168025d73141d8ad6))
|
|
5
|
+
- 正文图片居中显示,并增大预览尺寸,便于阅读图表细节,窄屏按可用宽度等比缩小。([573c07b](https://github.com/hjd-hitsz/claudex-web/commit/573c07b725dd648075f9646bcc23d2d4456f1a88))
|
|
6
|
+
- Markdown 文件预览支持直接编辑正文、表格及任务列表,并可保存或切换源码继续编辑。([123b6db](https://github.com/hjd-hitsz/claudex-web/commit/123b6db764fd974c6cd045a6481c8cbea37afa3d))
|
|
7
|
+
- 创建对话分支时继承来源对话的模型和思考强度。([1f698b6](https://github.com/hjd-hitsz/claudex-web/commit/1f698b61b956b99ec6da0f609e266a95804c8065))
|
|
8
|
+
- 修复首次打开 Codex 对话时出现连接错误、需要手动重试的问题,恢复期间保留历史、输入草稿及附件。([a62f4a6](https://github.com/hjd-hitsz/claudex-web/commit/a62f4a68afbab9c5d3ee294288ddb4bb2a4da7ab))
|
|
@@ -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,
|
|
@@ -7,8 +7,12 @@ import { createTokenUsage } from "./token-usage.mjs";
|
|
|
7
7
|
import { modelOptions } from "./model-options.mjs";
|
|
8
8
|
import { captureNativeProcesses } from "./process-ownership.mjs";
|
|
9
9
|
import { createNativeCommands } from "./native-commands.mjs";
|
|
10
|
-
import {
|
|
10
|
+
import {
|
|
11
|
+
providerSettingsEnvironment,
|
|
12
|
+
subagentModelEnvironment,
|
|
13
|
+
} from "./provider-environment.mjs";
|
|
11
14
|
import { networkProxyEnvironment } from "../network-proxy.mjs";
|
|
15
|
+
import { subagentSettings } from "../../../../shared/subagent-settings.mjs";
|
|
12
16
|
import {
|
|
13
17
|
createProviderTransport,
|
|
14
18
|
providerRuntimeEnvironment,
|
|
@@ -19,6 +23,7 @@ export async function createExecutionSession({
|
|
|
19
23
|
session,
|
|
20
24
|
queued,
|
|
21
25
|
providers,
|
|
26
|
+
subagentProvider,
|
|
22
27
|
save,
|
|
23
28
|
emit,
|
|
24
29
|
broadcast,
|
|
@@ -45,7 +50,20 @@ export async function createExecutionSession({
|
|
|
45
50
|
);
|
|
46
51
|
const model = queued.model || session.model || provider?.models[0];
|
|
47
52
|
const options = modelOptions(provider, model, queued);
|
|
48
|
-
const
|
|
53
|
+
const subagentTarget =
|
|
54
|
+
subagentProvider ||
|
|
55
|
+
(backend.subagentEffort && backend.subagentModel ? provider : null);
|
|
56
|
+
let proxy =
|
|
57
|
+
provider || subagentTarget
|
|
58
|
+
? await createProviderTransport(
|
|
59
|
+
provider,
|
|
60
|
+
subagentTarget && {
|
|
61
|
+
provider: subagentTarget,
|
|
62
|
+
model: backend.subagentModel,
|
|
63
|
+
effort: backend.subagentEffort,
|
|
64
|
+
},
|
|
65
|
+
)
|
|
66
|
+
: null;
|
|
49
67
|
const input = createInputStream();
|
|
50
68
|
const commands = createNativeCommands(
|
|
51
69
|
input,
|
|
@@ -62,11 +80,41 @@ export async function createExecutionSession({
|
|
|
62
80
|
query: null,
|
|
63
81
|
providerId: provider?.id ?? queued.providerId ?? session.providerId,
|
|
64
82
|
providerKey: JSON.stringify(provider),
|
|
83
|
+
subagentProviderKey: JSON.stringify(subagentProvider),
|
|
84
|
+
subagentSettingsKey: JSON.stringify(subagentSettings(backend)),
|
|
65
85
|
model,
|
|
66
86
|
cwd: session.cwd,
|
|
67
87
|
modelTokens: session.modelTokens || 0,
|
|
68
88
|
lastTurnId: queued.id,
|
|
69
89
|
lastActivityAt: Date.now(),
|
|
90
|
+
settingsEnvironment: (model, effort) =>
|
|
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
|
+
},
|
|
70
118
|
};
|
|
71
119
|
const current = () => (process.retired ? null : getCurrent());
|
|
72
120
|
const context = () => ({
|
|
@@ -98,7 +146,10 @@ export async function createExecutionSession({
|
|
|
98
146
|
...options,
|
|
99
147
|
settings: {
|
|
100
148
|
...options.settings,
|
|
101
|
-
env:
|
|
149
|
+
env: {
|
|
150
|
+
...networkProxyEnvironment(backend.proxy),
|
|
151
|
+
...subagentModelEnvironment(backend, proxy),
|
|
152
|
+
},
|
|
102
153
|
},
|
|
103
154
|
extraArgs: { "thinking-display": "summarized" },
|
|
104
155
|
allowDangerouslySkipPermissions: true,
|
|
@@ -166,7 +217,7 @@ export async function createExecutionSession({
|
|
|
166
217
|
process.query.close();
|
|
167
218
|
proxy?.close();
|
|
168
219
|
};
|
|
169
|
-
if (provider) {
|
|
220
|
+
if (provider || proxy) {
|
|
170
221
|
try {
|
|
171
222
|
await process.query.applyFlagSettings({
|
|
172
223
|
env: providerSettingsEnvironment(provider, backend, {
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import { readFile } from "node:fs/promises";
|
|
2
|
+
import { join } from "node:path";
|
|
3
|
+
|
|
4
|
+
// 原生账户作为子代理目标时,每次请求读取 CLI 当前保存的认证。
|
|
5
|
+
export async function nativeProviderHeaders(backend) {
|
|
6
|
+
const env = process.env;
|
|
7
|
+
if (env.ANTHROPIC_AUTH_TOKEN)
|
|
8
|
+
return { authorization: `Bearer ${env.ANTHROPIC_AUTH_TOKEN}` };
|
|
9
|
+
if (env.ANTHROPIC_API_KEY) return { "x-api-key": env.ANTHROPIC_API_KEY };
|
|
10
|
+
let token = env.CLAUDE_CODE_OAUTH_TOKEN;
|
|
11
|
+
if (!token) {
|
|
12
|
+
try {
|
|
13
|
+
const credentials = JSON.parse(
|
|
14
|
+
await readFile(join(backend.dataDir, ".credentials.json"), "utf8"),
|
|
15
|
+
);
|
|
16
|
+
token = credentials.claudeAiOauth?.accessToken;
|
|
17
|
+
} catch (error) {
|
|
18
|
+
if (error.code !== "ENOENT") throw error;
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
if (!token) throw new Error("Claude 原生账户认证不可用");
|
|
22
|
+
return {
|
|
23
|
+
authorization: `Bearer ${token}`,
|
|
24
|
+
"anthropic-beta": "oauth-2025-04-20",
|
|
25
|
+
};
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
export const nativeSubagentProvider = (backend) => ({
|
|
29
|
+
id: "@native",
|
|
30
|
+
native: true,
|
|
31
|
+
dataDir: backend.dataDir,
|
|
32
|
+
baseUrl: process.env.ANTHROPIC_BASE_URL || "https://api.anthropic.com",
|
|
33
|
+
protocol: "anthropic",
|
|
34
|
+
modelCapabilities: {},
|
|
35
|
+
});
|