@hjd-hitsz/claudex-web 4.1.1 → 4.1.3

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 (59) hide show
  1. package/CHANGELOG.md +34 -0
  2. package/build-info.json +4 -4
  3. package/client/dist/_baseMerge.js +1 -1
  4. package/client/dist/app.js +91 -90
  5. package/client/dist/code-highlight-style.js +48 -13
  6. package/client/dist/dagre-NK4GIZVX.js +2 -2
  7. package/client/dist/document-editor.js +101 -136
  8. package/client/dist/file-panel.js +5 -1
  9. package/client/dist/graph.js +1 -1
  10. package/client/dist/index.js +2 -2
  11. package/client/dist/index10.js +1 -1
  12. package/client/dist/index11.js +1 -1
  13. package/client/dist/index12.js +1 -1
  14. package/client/dist/index13.js +2 -2
  15. package/client/dist/index14.js +1 -1
  16. package/client/dist/index15.js +1 -1
  17. package/client/dist/index16.js +2 -2
  18. package/client/dist/index17.js +1 -1
  19. package/client/dist/index18.js +2 -2
  20. package/client/dist/index19.js +1 -1
  21. package/client/dist/index20.js +1 -1
  22. package/client/dist/index21.js +1 -1
  23. package/client/dist/index22.js +1 -1
  24. package/client/dist/index3.js +1 -1
  25. package/client/dist/index4.js +1 -1
  26. package/client/dist/index5.js +1 -1
  27. package/client/dist/index6.js +2 -2
  28. package/client/dist/index7.js +1 -1
  29. package/client/dist/index8.js +1 -1
  30. package/client/dist/index9.js +1 -1
  31. package/client/dist/isArrayLikeObject.js +1 -1
  32. package/client/dist/style.css +1 -1
  33. package/docs/architecture/backend-regressions.md +2 -1
  34. package/docs/architecture/behavior.md +16 -2
  35. package/docs/architecture.md +9 -2
  36. package/docs/cli-command-coverage.md +1 -1
  37. package/docs/deployment.md +6 -2
  38. package/docs/development.md +14 -0
  39. package/docs/images/desktop-dark.png +0 -0
  40. package/docs/images/desktop-light.png +0 -0
  41. package/docs/releases/v4.1.2.md +3 -0
  42. package/docs/releases/v4.1.3.md +8 -0
  43. package/package.json +1 -1
  44. package/packages/translation-engine/package.json +1 -1
  45. package/server/src/backends/claude/execution-session.mjs +27 -4
  46. package/server/src/backends/claude/native-provider.mjs +35 -0
  47. package/server/src/backends/claude/provider-environment.mjs +63 -11
  48. package/server/src/backends/claude/provider-transport.mjs +45 -9
  49. package/server/src/backends/claude/runtime.mjs +19 -4
  50. package/server/src/backends/claude/worker-client.mjs +2 -0
  51. package/server/src/backends/codex/adapter.mjs +9 -2
  52. package/server/src/backends/codex/requests.mjs +6 -2
  53. package/server/src/backends/codex/resume-lifecycle.mjs +38 -0
  54. package/server/src/backends/codex/subagent-model.mjs +19 -0
  55. package/server/src/backends/codex/upstream.mjs +9 -0
  56. package/server/src/backends/configuration.mjs +37 -0
  57. package/server/src/backends/manager.mjs +19 -1
  58. package/server/src/service-maintenance-worker.mjs +9 -2
  59. package/server/src/service-maintenance.mjs +22 -1
@@ -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`:取消订阅确认和实际关闭分别到达、顺序交换、断线清理及关闭后重新恢复。`tests/integration/codex-subscription-release.mjs` 通过真实 CLI 和适配器执行八组立即重新打开,使用人工历史,模型轮次数为零。原生响应语义见 [app-server 协议](https://github.com/openai/codex/blob/main/codex-rs/app-server/README.md)。
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。
@@ -147,7 +149,7 @@ flowchart LR
147
149
 
148
150
  本轮文件汇总合并成功完成的修改,默认最多展示五项;按对话、轮次保存实时净差异,历史采用所属轮次记录。按文件撤销由桥接重新读取真实记录,在临时目录校验补丁与源文件后写回;运行、冲突和重复请求分别受控,并广播结果。
149
151
 
150
- Markdown 文件默认预览,可切换源码并保留未保存内容。文本按文件名选择语法;媒体、PDF 和其他二进制由文件类型规则选择预览或下载,支持的流式媒体通过已认证 HTTP 路由读取。目标变化时清理播放器和对象 URL。
152
+ Markdown 文件默认使用可编辑的富文本预览,正文、表格和任务列表的修改同步到文件编辑缓冲区,保存按钮和 Ctrl+S 写入当前 Markdown。可切换源码并保留未保存内容,打开及切换视图保留原文件正文,实际编辑后序列化为 Markdown。公式沿用文件中的标准 Markdown 数学语法。代码块提供编辑与预览切换,Mermaid 继续使用公共图表展示。文本按文件名选择语法;媒体、PDF 和其他二进制由文件类型规则选择预览或下载,支持的流式媒体通过已认证 HTTP 路由读取。目标变化时清理播放器和对象 URL。
151
153
 
152
154
  Claude Code 的原生后台任务按所属会话保存任务标识、类型、进度和实际所有者,`/stop` 读取全部后台终端分页并调用原生停止接口。后台任务通知触发的原生自动唤醒按独立轮次保存,轮次绑定真实消息锚点,刷新、编辑回退与分支维持顺序。
153
155
 
@@ -155,6 +157,8 @@ Claude Code 的原生后台任务按所属会话保存任务标识、类型、
155
157
 
156
158
  ## 子代理与共享渲染
157
159
 
160
+ 设置中的每个后端在同一行提供子代理模型、思考强度和保存操作。模型选项从可用目录取得并以“供应商 / 模型”展示,Codex 候选遵循模型显示偏好。已选模型被隐藏后,以状态占位保留已存配置,候选中省去其名称,恢复显示后恢复选择。强度档位随模型能力提供,选择“原生默认”清除模型覆盖,选择“默认强度”清除强度覆盖。Claude 支持跨已配置供应商选择,原生账户模型使用其解析后的实际 ID。保存保护活动轮次与后台占用,失败保留选择,成功后广播并恢复持久配置。Codex 使用原生默认子代理模型,显式任务及自定义代理模型沿用原生优先级;Claude 使用原生强制子代理模型参数,原生 fork 及指定继承模型的技能继续遵循 CLI 的继承语义。模型选择、主供应商及主对话状态保持各自所有权。
161
+
158
162
  Claude 子代理原生历史中,带有 `isSidechain=true` 与 `agentId` 的任务输入以侧链来源建立轮次,即使继承 SDK 入口和父轮次 `promptId`。主对话内部通知继续按其来源字段过滤,子代理任务、工具和回答完整恢复。
159
163
 
160
164
  子代理按对话 ID 合并不同协议版本的活动,主对话工作过程与详情概览共用入口。只读详情复用完整历史、消息和工作过程,消息路径使用子代理的实际目录。切换代理或关闭详情清理监听并丢弃迟到结果。
@@ -163,7 +167,7 @@ Claude 子代理原生历史中,带有 `isSidechain=true` 与 `agentId` 的任
163
167
 
164
168
  消息、工具结果、子代理及文件预览共用 Markdown 和 HTML 白名单过滤。安全的标题、对齐、图片、`picture` 及折叠内容统一处理,代码保留源码。相对资源以所属对话或文件目录解析;图片失败、主题切换及迟到读取均有隔离处理。
165
169
 
166
- 图片按统一等比缩略图展示,点击可查看大图,Esc、关闭按钮和空白区域退出后恢复焦点。Mermaid 从本站按需加载,严格模式绘制,默认使用 13px 字号与紧凑节点间距,按可用宽度等比缩小,长图默认在受限高度内滚动,工具栏的四角展开图标可显示完整高度,再次点击四角收起图标恢复紧凑高度,悬停及可访问名称分别为“展开图表”和“收起图表”;消息与文件预览共用展示规则。流程图方向菜单以当前实际布局选中横向或纵向,可选择另一方向进行切换,切换时恢复默认缩放,子图内部的方向声明保持原样。缩放按钮以 25% 为一步,在 50% 至 800% 之间调整,点击百分比复位;图表聚焦后支持 `+`、`-`、`0`,Ctrl+滚轮或触控板捏合缩放。方向、缩放与展开状态归当前图表组件,流式更新与主题重绘保留选择,卸载后恢复默认。查看及复制源码始终使用消息原文。流式未完成或解析失败时保留源码,清理临时节点并隔离旧主题及旧源码结果。
170
+ Markdown 正文图片居中展示,等比预览的上限为 640 × 480 像素,窄屏按正文可用宽度缩小,HTML 指定的图片宽度继续生效。消息附件缩略图上限为 320 × 240 像素。点击图片可查看大图,Esc、关闭按钮和空白区域退出后恢复焦点。Mermaid 从本站按需加载,严格模式绘制,默认使用 13px 字号与紧凑节点间距,按可用宽度等比缩小,长图默认在受限高度内滚动,工具栏的四角展开图标可显示完整高度,再次点击四角收起图标恢复紧凑高度,悬停及可访问名称分别为“展开图表”和“收起图表”;消息与文件预览共用展示规则。流程图方向菜单以当前实际布局选中横向或纵向,可选择另一方向进行切换,切换时恢复默认缩放,子图内部的方向声明保持原样。缩放按钮以 25% 为一步,在 50% 至 800% 之间调整,点击百分比复位;图表聚焦后支持 `+`、`-`、`0`,Ctrl+滚轮或触控板捏合缩放。方向、缩放与展开状态归当前图表组件,流式更新与主题重绘保留选择,卸载后恢复默认。查看及复制源码始终使用消息原文。流式未完成或解析失败时保留源码,清理临时节点并隔离旧主题及旧源码结果。
167
171
 
168
172
  ## 账户、登录与外观
169
173
 
@@ -227,8 +231,18 @@ Claude Code 网络代理在设置中提供跟随服务环境、关闭和 HTTP,
227
231
 
228
232
  更新及重启请求遇到活动轮次、后台任务、排队输入、待答提问、内部命令或上下文整理时,结束本次操作并短暂提示用户结束任务后重试。提示五秒后关闭,用户稍后重新发起操作。切换阶段暂停网页提交,避免提交与重启竞争。重启成功后网页显示“服务已重启,请刷新网页”,用户自行刷新。
229
233
 
234
+ npm 更新沿用网页服务的 Node.js/npm 路径、npm 配置及网络代理与证书环境,支持 NVM 和自定义用户安装目录。独立维护单元启动失败时立即恢复网页提交,保留失败结果并允许重新执行维护操作。
235
+
230
236
  发现新版本后,侧栏底部显示带版本号的更新入口并标记设置按钮;侧栏收起或窄屏时,顶部显示紧凑更新入口。设置页按更新与重启、模型与服务配置、其他设置、网页登录分组。更新卡片集中显示产品身份和主操作,当前与最新版本在产品名下同行显示,产品图标、版本信息与检查更新、重启服务、更新按钮在卡片中垂直居中并同行排列,空间不足时操作组整体换行,三个按钮保持同行,复用设置页按钮的尺寸和边框,主要更新操作位于右侧,有新版时显示“更新至版本号”,无需更新时显示灰色禁用的“无需更新”,按钮数量与位置保持稳定;检查期间显示进行状态。设置卡片通过间距区分内部内容。其他设置的选项间距保持一致,状态与错误说明紧随所属选项并与选项文字对齐。原生后端的当前版本合并到标题行,正常连接以状态点显示,安装操作失败作为本次设置访问中的短暂提示,重新打开设置跳过历史安装提示,有新版时在按钮直接显示目标版本并允许更新,版本相同或本机更新时保留灰色禁用的“无需更新”按钮;未安装、停用及连接失败保留文字状态。网页主题始终跟随系统。点击更新入口直接打开设置并滚动、聚焦“更新与重启”区域。界面只显示版本、操作与必要状态,检查周期及部署实现保留在部署文档。
231
237
 
232
238
  维护任务的持久结果用于状态核对,操作提示归属当前设置访问。首次加载、刷新及重新打开设置跳过历史完成和失败提示;当前访问发起的操作按任务开始时间确认结果并只显示一次。关闭设置清除提示并使在途请求的后续反馈失效,后台任务继续按真实状态执行。代理保存反馈五秒后消失,表单错误和实际连接、下载故障按各自当前状态提供处理入口。
233
239
 
234
240
  运行与加载状态使用静态图标,任务进度与耗时按实际数据更新。等待期间省去循环旋转和呼吸动画,使稳定内容仅随进度变化重新绘制;任务完成后清除运行提示并停止对应计时。
241
+
242
+ 创建对话分支时显式传递来源对话的模型和思考强度。当前对话采用创建动作开始时的输入区选择,侧栏其他对话通过原生读取结果取得配置;分支恢复继续采用后端保存结果。回归覆盖全局默认模型与来源不同及非当前对话分支。
243
+
244
+ ### 目标交互
245
+
246
+ `/goal` 进入主输入框的目标输入状态,并切换为执行模式;退出目标输入保留正文和附件。提交目标使用 `thread/goal/set`,已有目标先显示替换确认。附件先写入受限附件目录,再将本机文件引用纳入目标。目标摘要常驻输入区上方,按原生状态展示追踪、暂停、阻塞、用量限制、预算限制及完成,提供暂停、恢复、编辑与清除操作。刷新、重连与切换对话重新读取所属目标,实时通知优先于迟到响应。
247
+
248
+ 编辑在右侧详情完成,标题与关闭入口同行,紧凑工具栏集中展示更新时间、还原图标和保存按钮,正文占满中间可用区域。Token 预算默认收起于底部辅助区域,展开后编辑。支持 Markdown、还原与 Ctrl+Enter 保存;编辑草稿按对话保存,保存失败保留内容。保存正文沿用客户端激活目标的语义。目标操作按对话串行,断线、整理及提交期间暂停写入;预算及完成判断由所属原生后端维护。
@@ -135,6 +135,7 @@ flowchart LR
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`:后端通知到应用状态的转换。消息、轮次、标题、差异与终端变化按所属对话和轮次更新。
@@ -202,7 +203,7 @@ Codex 原生适配全部位于 `backends/codex/`。`adapter.mjs` 组合原生传
202
203
 
203
204
  Codex 适配器在原生新建、恢复和分支参数中加入 `claudex_references` 只读 MCP 配置,保留原有会话配置并沿用实际后端地址,不修改原生全局配置。原生 CLI 持有 `reference-mcp.mjs` 子进程,它直接连接同一 app-server,提供带游标的 `read_thread` 用户与助手正文读取,网页断开不影响读取。引用按 `thread://` 目标提交并提示代理通过该工具读取;读取结果作为历史参考数据。单元测试覆盖配置合并、分页、后端隔离与错误,`tests/integration/codex-reference-tools.mjs` 用真实 CLI 验证 MCP 注册和调用,隔离模拟历史数据并保持模型调用为零。
204
205
 
205
- Codex 取消订阅在原生响应确认后结束本连接的释放;其他连接仍持有订阅时原生会话继续存在。后续请求只等待取消订阅响应,发送按原生恢复流程重新订阅。`thread/closed` 独立用于清理实际已卸载会话的状态。
206
+ Codex 取消订阅在原生响应确认后结束本连接的释放;其他连接仍持有订阅时原生会话继续存在。后续请求等待取消订阅响应,发送按原生恢复流程重新订阅。Codex 0.169.0 的关闭任务在响应后异步完成,`thread/resume` 在此期间返回目标线程的明确 closing 错误。原生传输通过 `resume-lifecycle.mjs` 将该恢复请求保留到对应 `thread/closed` 到达后重新发送一次,关闭事件先到时同样处理;严格核对原生错误码、完整文本和目标 ID,其他错误直接结算。网页请求及内部写入恢复共用此流程,沿用原请求的 120 秒期限,超时或断线清理等待,运行轮次只在恢复成功后提交。`thread/closed` 同时清理实际已卸载会话的状态。
206
207
 
207
208
  公共桥接通过参数取得后端能力;两个原生适配器各自依赖所属后端和公共服务。架构检查禁止公共桥接依赖具体后端、两个原生适配器互相依赖,以及 HTTP 处理器直接依赖桥接或后端实现。
208
209
 
@@ -250,18 +251,22 @@ Claude 网页桥接重启或异常退出时,独立执行服务继续持有模
250
251
 
251
252
  外部供应商的模型环境由 `provider-environment.mjs` 生成,主模型与 Opus、Sonnet、Haiku 三个原生别名随本轮选择一起更新。初始化与持续会话共用映射,运行时等待原生模型和设置更新完成后提交输入,设置失败按本轮错误结算并允许重试。
252
253
 
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`,切换到不支持当前强度的模型时清除该强度选择。控件仅持有尚未保存的模型、强度及错误。
255
+
253
256
  ## 5. 功能模块与共享展示
254
257
 
255
258
  `features/conversation` 组合消息、工作过程、提问和目录。领域层负责按轮次分组与排序;主对话和子代理的只读详情使用相同历史读取和展示规则。计划正文由独立的 `plan-message.jsx` 展示,默认保留约 320 像素的正文预览(用字体相对单位定义),底部渐隐并提供展开入口;收放状态由卡片组件持有,流式更新保留用户选择,卸载后恢复默认折叠,领域层 `plans.js` 根据最新用户消息、计划消息与成功轮次确定批准资格;步骤进度保持独立。工作过程记录、最终回答操作以及本轮文件汇总分别渲染,保持流式过程与历史恢复的顺序一致。
256
259
 
257
260
  主对话按消息快照一次建立轮次到记录的索引,供文件汇总复用;文件汇总按记录、净差异及工作目录缓存计算。Markdown 组件按正文、批注内容和目录复用解析结果,内部媒体和主题更新保持各自订阅。历史前插时,消息区根据前后滚动高度补偿阅读位置;自动跟随时继续定位到真实底部,视口快照归消息区所有并在切换时清理。
258
261
 
259
- `features/markdown` 集中提供 Markdown、HTML 白名单、图片、链接、数学公式和 Mermaid。消息、工具结果和文件预览复用同一渲染入口;文件目录由上下文传递,局部组件负责媒体加载与清理。文本安全过滤和路径解析在这里统一维护。
262
+ `features/markdown` 集中提供 Markdown、HTML 白名单、图片、链接、数学公式和 Mermaid。消息与工具结果复用同一渲染入口,文件富文本编辑器的 HTML、代码与图表节点继续复用该入口;文件目录由上下文传递,局部组件负责媒体加载与清理。文本安全过滤和路径解析在这里统一维护。
260
263
 
261
264
  Mermaid 的流程图主方向转换归 `domain/mermaid.js`,原始正文保持独立;`mermaid-block.jsx` 持有方向、缩放、展开和源码查看状态,`mermaid-diagram.jsx` 按容器宽度等比绘制并处理图内滚动、键盘及 Ctrl+滚轮缩放。尺寸观察与滚轮监听随组件卸载清理,重新绘制继续隔离旧源码和主题结果。
262
265
 
263
266
  `features/workspace` 把文件树、目录选择、文件编辑、差异、终端和对话详情拆成独立模块。编辑器与文件变更装饰分别封装;显示的删除装饰与实际保存正文分开处理。`context-panel.jsx` 组合概览和子代理详情,主对话切换统一清理选择,编辑缓冲区继续按原主对话保存。
264
267
 
268
+ `file-markdown-editor.jsx` 复用文档编辑器的文件模式提供可编辑预览,文件模式使用标准 Markdown 数学语法,输入区继续使用其双美元符号规则。`file-document-views.jsx` 按原始源码位置组合成对 HTML,持有本地图片、HTML 和代码的节点展示,复用公共安全渲染及 Mermaid 交互,节点销毁时释放展示实例。文件正文仍归文件面板持有,源码与富文本共用同一缓冲区及保存入口。
269
+
265
270
  `app` 将输入框和错误提示作为底部插槽传入对话布局。对话布局统一提供消息、底部输入和右侧详情的几何边界;桌面展开详情时输入区域避让右侧面板,详情占满工作区高度。文件下载入口归文件面板工具栏,媒体预览组件负责内容展示及加载重试。
266
271
 
267
272
  `domain/file-suggestions.js` 负责将原生文件候选按名称与查询路径的相关性统一排序,展示数量在排序后限制;后端继续持有原生索引与查询生命周期。
@@ -341,3 +346,5 @@ Codex 设置中的模型显示偏好由网页后端配置持久保存并广播
341
346
  长历史首屏读取最近 100 条消息;首屏全部属于同一轮次且仍有历史时,后续按每页一个完整轮次恢复,减少工具密集对话的串行网络往返。首屏跨轮次时继续使用消息分页,保持短轮次对话的读取效率;两条路径均保留完整历史、轮内顺序、实时更新优先和切换隔离。
342
347
 
343
348
  网页更新由 `service-maintenance.mjs` 持有 npm 稳定版检查缓存及维护操作,启动时和每小时读取官方注册表。认证后的 HTTP 维护接口通过应用装配注入服务。独立 systemd 用户任务执行下载、隔离安装、版本校验、目录替换、网页服务重启与 HTTPS 启动检查,任务状态原子保存在网页配置目录。失败时恢复原安装目录并重启。源码部署提供检查与服务重启,npm 全局部署另提供更新。浏览器应用控制器轮询持久任务状态,页面保留编辑缓冲区,重启成功提示用户手动刷新网页加载新版本资源。
349
+
350
+ 维护任务在权限 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]`:无参数或 `edit` 打开目标管理窗口;输入目标文字后设置并开始目标;`pause` 暂停、`resume` 恢复、`clear` 清除。窗口支持编辑目标与可选 token 预算,预算留空表示不限。新对话先创建实际对话,所有显式修改携带 `origin: user`,通过 `thread/goal/get`、`thread/goal/set` 和 `thread/goal/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
  ## 原有命令
@@ -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.1.tgz.sha256
32
- npm install -g ./claudex-web-4.1.1.tgz
31
+ sha256sum -c claudex-web-4.1.3.tgz.sha256
32
+ npm install -g ./claudex-web-4.1.3.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`,再按下文方法重启网页服务。
@@ -201,6 +203,8 @@ claudex-web service restart-when-idle
201
203
 
202
204
  最后一个命令等待网页服务观察到的任务和上下文整理结束后自动重启,等待期间保持命令运行。Claude Code 独立执行服务继续保留后台任务,代码及配置更新在该服务完全空闲后完成。打开或隐藏的网页终端不会阻塞更新,等待程序只重启网页服务。切换 Node.js 版本或 npm prefix 后,也需重新安装服务并重启,以更新服务中的安装路径。
203
205
 
206
+ 4.1.0、4.1.1 的网页更新若报 `spawn npm ENOENT`,在安装程序的服务账户下执行上述终端升级命令,安装 4.1.2 或后续版本并完成服务重启。新版本的网页更新任务会沿用服务的 Node.js/npm 路径及网络环境。
207
+
204
208
  日志显示实际等待的任务与上下文整理数量;执行重启后继续检查 `/healthz`,连接就绪时报告实际运行版本,重启或健康检查失败时保留失败状态。
205
209
 
206
210
  升级后刷新网页,在“设置 → 关于”核对产品版本。`claudex-web version --json` 查看当前磁盘安装包,`/healthz` 中的 `version` 查看实际运行的服务,便于确认重启是否生效。
@@ -94,6 +94,8 @@ CLI 安装回归使用 `server/tests/cli-package.test.mjs` 验证原生平台包
94
94
 
95
95
  构建后执行 `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
96
 
97
+ 正文图片布局回归先执行 `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
+
97
99
  ## 双后端开发与验收
98
100
 
99
101
  双后端的统一范围由[产品契约](architecture/backends.md)定义;`shared/product-contract.mjs` 只注册工作区和对话方法的路由分组。原生能力分别接入统一用例,文件与网页终端由共用工作区服务提供。文件模糊查询按所属后端路由,Codex 保留原生 app-server 调用,Claude Code 使用原生 `file_suggestions` 控制请求及 CLI 文件索引;两端共用输入建议,回归同时核对原有 Codex 路径和 Claude 新增实现。CLI/SDK 生命周期、原生历史及参数发生变化时,同时检查首次请求、流式展示、轮次完成、刷新恢复和错误重试。Claude 执行服务通过受限本机 IPC 独立于网页桥接运行,网页关闭仅释放连接;源码与安装来源的代码身份按实际发行文件计算。
@@ -181,6 +183,12 @@ CLAUDE_EXECUTABLE=/absolute/path/to/claude MODEL_BASE_URL=https://model.example
181
183
 
182
184
  ## 格式与验证
183
185
 
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` 使用临时文件与模拟端点验证。
187
+
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 引用的现有图片展示对话及文件面板,本项设置变化未影响其画面。
189
+
190
+ 文件预览编辑回归在构建后运行 `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
+
184
192
  模型名称布局回归在构建后执行 `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
193
 
186
194
  长对话切换回归先执行 `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 图片展示完整加载后的界面,布局和内容继续适用。
@@ -410,3 +418,9 @@ Ubuntu 安装指引回归在设备选择器中实际切换 Ubuntu,检查 DER
410
418
  异步回复收纳回归在构建后执行 `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
419
 
412
420
  运行状态渲染回归使用 `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 占用另通过桌面静置采样核对。
421
+
422
+ ### 目标交互回归
423
+
424
+ 本机客户端对照为 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`。
425
+
426
+ 构建后运行 `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,3 @@
1
+ # Claudex Web v4.1.2
2
+
3
+ - 修复 npm 全局安装在 NVM 等用户环境中点击“更新至版本号”后更新失败的问题。更新或重启任务启动失败后,可立即继续发送消息并重新尝试操作。([de57e2e](https://github.com/hjd-hitsz/claudex-web/commit/de57e2e))
@@ -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))
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@hjd-hitsz/claudex-web",
3
- "version": "4.1.1",
3
+ "version": "4.1.3",
4
4
  "type": "module",
5
5
  "description": "Codex 与 Claude Code 的浏览器工作台",
6
6
  "license": "GPL-3.0-only",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@claudex-web/translation-engine",
3
- "version": "4.1.1",
3
+ "version": "4.1.3",
4
4
  "type": "module",
5
5
  "license": "GPL-3.0-only",
6
6
  "description": "独立的本地英译中引擎与按需模型管理",
@@ -7,7 +7,10 @@ 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 { providerSettingsEnvironment } from "./provider-environment.mjs";
10
+ import {
11
+ providerSettingsEnvironment,
12
+ subagentModelEnvironment,
13
+ } from "./provider-environment.mjs";
11
14
  import { networkProxyEnvironment } from "../network-proxy.mjs";
12
15
  import {
13
16
  createProviderTransport,
@@ -19,6 +22,7 @@ export async function createExecutionSession({
19
22
  session,
20
23
  queued,
21
24
  providers,
25
+ subagentProvider,
22
26
  save,
23
27
  emit,
24
28
  broadcast,
@@ -45,7 +49,20 @@ export async function createExecutionSession({
45
49
  );
46
50
  const model = queued.model || session.model || provider?.models[0];
47
51
  const options = modelOptions(provider, model, queued);
48
- const proxy = provider ? await createProviderTransport(provider) : null;
52
+ const subagentTarget =
53
+ subagentProvider ||
54
+ (backend.subagentEffort && backend.subagentModel ? provider : null);
55
+ const proxy =
56
+ provider || subagentTarget
57
+ ? await createProviderTransport(
58
+ provider,
59
+ subagentTarget && {
60
+ provider: subagentTarget,
61
+ model: backend.subagentModel,
62
+ effort: backend.subagentEffort,
63
+ },
64
+ )
65
+ : null;
49
66
  const input = createInputStream();
50
67
  const commands = createNativeCommands(
51
68
  input,
@@ -62,11 +79,14 @@ export async function createExecutionSession({
62
79
  query: null,
63
80
  providerId: provider?.id ?? queued.providerId ?? session.providerId,
64
81
  providerKey: JSON.stringify(provider),
82
+ subagentProviderKey: JSON.stringify(subagentProvider),
65
83
  model,
66
84
  cwd: session.cwd,
67
85
  modelTokens: session.modelTokens || 0,
68
86
  lastTurnId: queued.id,
69
87
  lastActivityAt: Date.now(),
88
+ settingsEnvironment: (model, effort) =>
89
+ providerSettingsEnvironment(provider, backend, { proxy, model, effort }),
70
90
  };
71
91
  const current = () => (process.retired ? null : getCurrent());
72
92
  const context = () => ({
@@ -98,7 +118,10 @@ export async function createExecutionSession({
98
118
  ...options,
99
119
  settings: {
100
120
  ...options.settings,
101
- env: networkProxyEnvironment(backend.proxy),
121
+ env: {
122
+ ...networkProxyEnvironment(backend.proxy),
123
+ ...subagentModelEnvironment(backend, proxy),
124
+ },
102
125
  },
103
126
  extraArgs: { "thinking-display": "summarized" },
104
127
  allowDangerouslySkipPermissions: true,
@@ -166,7 +189,7 @@ export async function createExecutionSession({
166
189
  process.query.close();
167
190
  proxy?.close();
168
191
  };
169
- if (provider) {
192
+ if (provider || proxy) {
170
193
  try {
171
194
  await process.query.applyFlagSettings({
172
195
  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
+ });
@@ -2,18 +2,33 @@ import { homedir } from "node:os";
2
2
  import { join, resolve } from "node:path";
3
3
  import { networkProxyEnvironment } from "../network-proxy.mjs";
4
4
 
5
+ export function subagentModelEnvironment(backend, proxy) {
6
+ return {
7
+ ...(backend.subagentModel && {
8
+ CLAUDE_CODE_SUBAGENT_MODEL: proxy?.subagentModel || backend.subagentModel,
9
+ CLAUDE_CODE_SUBAGENT_MODEL_FORCE: "1",
10
+ }),
11
+ ...(backend.subagentEffort && {
12
+ CLAUDE_CODE_SUBAGENT_EFFORT: backend.subagentEffort,
13
+ }),
14
+ };
15
+ }
16
+
5
17
  export function claudeRuntimeEnvironment(backend) {
6
- const env = { ...process.env, ...networkProxyEnvironment(backend.proxy) };
18
+ const env = {
19
+ ...process.env,
20
+ ...networkProxyEnvironment(backend.proxy),
21
+ ...subagentModelEnvironment(backend),
22
+ };
7
23
  const original = resolve(env.CLAUDE_CONFIG_DIR || join(homedir(), ".claude"));
8
24
  if (resolve(backend.dataDir) !== original)
9
25
  env.CLAUDE_CONFIG_DIR = backend.dataDir;
10
26
  return env;
11
27
  }
12
28
 
13
- export function providerModelEnvironment(provider, model, effort) {
14
- const selectedModel = model || provider.models[0];
15
- const rules = Object.entries(provider.modelCapabilities || {}).flatMap(
16
- ([name, metadata]) => {
29
+ function modelCapabilityRules(metadataByModel) {
30
+ return Object.entries(metadataByModel)
31
+ .flatMap(([name, metadata]) => {
17
32
  const capabilities = [];
18
33
  if (typeof metadata.supportsAdaptiveThinking === "boolean")
19
34
  capabilities.push(
@@ -31,14 +46,20 @@ export function providerModelEnvironment(provider, model, effort) {
31
46
  );
32
47
  }
33
48
  return capabilities.length ? [`${name}=${capabilities.join(",")}`] : [];
34
- },
35
- );
49
+ })
50
+ .join(";");
51
+ }
52
+
53
+ export function providerModelEnvironment(provider, model, effort) {
54
+ const selectedModel = model || provider.models[0];
36
55
  return {
37
56
  ANTHROPIC_MODEL: selectedModel,
38
57
  ANTHROPIC_DEFAULT_OPUS_MODEL: selectedModel,
39
58
  ANTHROPIC_DEFAULT_SONNET_MODEL: selectedModel,
40
59
  ANTHROPIC_DEFAULT_HAIKU_MODEL: selectedModel,
41
- CLAUDE_CODE_MODEL_CAPABILITIES: rules.join(";"),
60
+ CLAUDE_CODE_MODEL_CAPABILITIES: modelCapabilityRules(
61
+ provider.modelCapabilities || {},
62
+ ),
42
63
  CLAUDE_CODE_MAX_CONTEXT_TOKENS: String(
43
64
  provider.modelCapabilities?.[selectedModel]?.contextWindow || "",
44
65
  ),
@@ -55,7 +76,26 @@ export function providerRuntimeEnvironment(
55
76
  ) {
56
77
  const env = claudeRuntimeEnvironment(backend);
57
78
  delete env.CLAUDECODE;
58
- if (!provider) return env;
79
+ if (proxy) {
80
+ env.ANTHROPIC_BASE_URL = proxy.url;
81
+ env.ANTHROPIC_CUSTOM_HEADERS = [
82
+ env.ANTHROPIC_CUSTOM_HEADERS,
83
+ `x-claudex-proxy-token: ${proxy.token}`,
84
+ ]
85
+ .filter(Boolean)
86
+ .join("\n");
87
+ Object.assign(env, subagentModelEnvironment(backend, proxy));
88
+ }
89
+ if (!provider) {
90
+ if (proxy?.subagentModel)
91
+ env.CLAUDE_CODE_MODEL_CAPABILITIES = [
92
+ env.CLAUDE_CODE_MODEL_CAPABILITIES,
93
+ modelCapabilityRules(proxy.modelCapabilities),
94
+ ]
95
+ .filter(Boolean)
96
+ .join(";");
97
+ return env;
98
+ }
59
99
  for (const key of [
60
100
  "ANTHROPIC_AUTH_TOKEN",
61
101
  "ANTHROPIC_API_KEY",
@@ -67,7 +107,17 @@ export function providerRuntimeEnvironment(
67
107
  delete env[key];
68
108
  Object.assign(
69
109
  env,
70
- providerModelEnvironment(provider, model || provider.models[0], effort),
110
+ providerModelEnvironment(
111
+ {
112
+ ...provider,
113
+ modelCapabilities: {
114
+ ...provider.modelCapabilities,
115
+ ...proxy?.modelCapabilities,
116
+ },
117
+ },
118
+ model || provider.models[0],
119
+ effort,
120
+ ),
71
121
  );
72
122
  env.ANTHROPIC_BASE_URL = proxy?.url || provider.baseUrl;
73
123
  env.ANTHROPIC_API_KEY = proxy?.token || provider.apiKey;
@@ -78,12 +128,14 @@ export function providerRuntimeEnvironment(
78
128
  export function providerSettingsEnvironment(provider, backend, options) {
79
129
  const env = providerRuntimeEnvironment(provider, backend, options);
80
130
  return {
81
- ANTHROPIC_AUTH_TOKEN: "",
131
+ ...(provider && { ANTHROPIC_AUTH_TOKEN: "" }),
82
132
  ...networkProxyEnvironment(backend.proxy),
83
133
  ...Object.fromEntries(
84
134
  Object.entries(env).filter(
85
135
  ([key]) =>
86
136
  key.startsWith("ANTHROPIC_") ||
137
+ key.startsWith("CLAUDE_CODE_SUBAGENT_MODEL") ||
138
+ key === "CLAUDE_CODE_SUBAGENT_EFFORT" ||
87
139
  [
88
140
  "CLAUDE_CODE_MODEL_CAPABILITIES",
89
141
  "CLAUDE_CODE_MAX_CONTEXT_TOKENS",
@@ -4,11 +4,16 @@ import http from "node:http";
4
4
  import { randomUUID } from "node:crypto";
5
5
  import { Readable } from "node:stream";
6
6
  import { pipeline } from "node:stream/promises";
7
+ import { nativeProviderHeaders } from "./native-provider.mjs";
7
8
 
8
- export async function createProviderTransport(provider) {
9
+ export async function createProviderTransport(provider, subagent) {
9
10
  const token = randomUUID();
11
+ const subagentModel = subagent ? `claudex-subagent-${randomUUID()}` : null;
12
+ const nativeBaseUrl =
13
+ process.env.ANTHROPIC_BASE_URL || "https://api.anthropic.com";
10
14
  const server = http.createServer(async (request, response) => {
11
15
  if (
16
+ request.headers["x-claudex-proxy-token"] !== token &&
12
17
  request.headers["x-api-key"] !== token &&
13
18
  request.headers.authorization !== `Bearer ${token}`
14
19
  ) {
@@ -21,13 +26,35 @@ export async function createProviderTransport(provider) {
21
26
  body += chunk;
22
27
  if (body.length > 64 * 1024 * 1024) throw new Error("请求过大");
23
28
  }
24
- if (body && (provider.protocol || "messages") === "messages")
25
- body = JSON.stringify(messagesRequest(JSON.parse(body)));
26
- const headers = {
27
- ...request.headers,
28
- "x-api-key": provider.apiKey,
29
- authorization: `Bearer ${provider.apiKey}`,
30
- };
29
+ let selected = provider;
30
+ if (body) {
31
+ 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"))
36
+ input.output_config = {
37
+ ...input.output_config,
38
+ effort: subagent.effort,
39
+ };
40
+ }
41
+ if (selected && (selected.protocol || "messages") === "messages")
42
+ input = messagesRequest(input);
43
+ body = JSON.stringify(input);
44
+ }
45
+ const headers = { ...request.headers };
46
+ if (selected) {
47
+ delete headers["x-api-key"];
48
+ delete headers.authorization;
49
+ delete headers["anthropic-organization-id"];
50
+ if (selected.native)
51
+ Object.assign(headers, await nativeProviderHeaders(selected));
52
+ else {
53
+ headers["x-api-key"] = selected.apiKey;
54
+ headers.authorization = `Bearer ${selected.apiKey}`;
55
+ }
56
+ }
57
+ delete headers["x-claudex-proxy-token"];
31
58
  delete headers.host;
32
59
  delete headers["content-length"];
33
60
  delete headers.connection;
@@ -35,7 +62,9 @@ export async function createProviderTransport(provider) {
35
62
  response.on("close", () => {
36
63
  if (!response.writableEnded) abort.abort();
37
64
  });
38
- const target = new URL(provider.baseUrl + request.url);
65
+ const target = new URL(
66
+ (selected?.baseUrl || nativeBaseUrl) + request.url,
67
+ );
39
68
  const options = {
40
69
  method: request.method,
41
70
  headers,
@@ -62,6 +91,13 @@ export async function createProviderTransport(provider) {
62
91
  return {
63
92
  url: `http://127.0.0.1:${server.address().port}`,
64
93
  token,
94
+ subagentModel,
95
+ modelCapabilities: subagent
96
+ ? {
97
+ [subagentModel]:
98
+ subagent.provider.modelCapabilities?.[subagent.model] || {},
99
+ }
100
+ : {},
65
101
  close() {
66
102
  server.close();
67
103
  server.closeAllConnections();