@hjd-hitsz/claudex-web 4.1.0 → 4.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -14,6 +14,8 @@ Claude 原生思考按所属 API 消息的内容块顺序保留独立标识,
14
14
 
15
15
  网页安装与启动支持尚未安装任何原生 CLI 的环境,登录后可在设置中安装所需后端。新建 Codex 用户服务通过已有后端启动脚本运行,缺少 CLI 时由 systemd 重试;安装完成后启动原生 app-server,桥接按原连接流程恢复就绪状态。
16
16
 
17
+ CLI 一键安装以当前平台原生组件完整下载为前提,完成后安装同一清单版本并校验实际 CLI。下载失败保留已有安装及版本,提供重试。CLI 检测与安装失败在设置中显示简短提示,原始错误保留在默认收起的详情中,展开后限制高度并允许长路径换行。操作成功后清理对应错误和诊断。
18
+
17
19
  自定义供应商在列表的编辑按钮旁提供删除按钮;请求期间禁止重复操作,成功后刷新供应商及模型目录并关闭该供应商的编辑表单,失败保留列表及编辑内容并显示错误。默认供应商通过清空 API Key 停用。
18
20
 
19
21
  项目模型偏好在所属后端离线时仍可读取和保存;保存成功向所有页面广播所属后端的完整项目偏好,保存失败保留原数据并允许重试。依赖执行状态的目录创建、单文件撤销、整理核对和子代理消息读取在后端就绪后执行。整理占用期间,两端统一暂停开始轮次、补充输入、审查、历史回退和再次整理,历史与项目偏好保持可读。
@@ -50,17 +52,19 @@ Claude Code 的模型会话和后台任务由独立执行服务持有。网页
50
52
 
51
53
  图片及其他附件随所属对话在当前页面内保留,切换到其他对话再返回时恢复原附件列表;尚未首次发送的新对话同样恢复。移除附件后保持移除,首次发送创建实际对话时迁移附件草稿。一次选择多个文件时,在文件选择框重置前取得全部文件,并将每个文件的读取绑定到原草稿。异步文件读取完成后更新原草稿,发送失败保留附件供重试,发送成功仅清理已提交附件,保留等待期间新增的附件。
52
54
 
53
- 正文输入即时更新独立草稿订阅,按对话持久保存。正文编辑区保持两行固定高度,换行及长文本通过内部滚动查看;输入内容变化时,输入框及发送工具栏保持尺寸和位置稳定。普通正文和同级列表的两行文字完整显示,光标与选区由浏览器原生维护;滚动后继续输入时定位到真实编辑位置。加载期间的文本、焦点及完整选区交接给文档编辑器,对话切换后旧实例只清理自己的输入适配。Ctrl+Enter 与发送按钮走同一提交入口,Enter 保留换行;组合输入确认保持正常编辑。输入期间共享状态快照稳定,长历史和文件面板保持渲染隔离。
55
+ 正文输入即时更新独立草稿订阅,按对话持久保存。正文编辑区默认容纳两行,随正文、代码及公式的实际高度自动增高,到达可用空间上限后在内部滚动。上边缘公共手柄支持向上拖动增高、方向键调节及双击或 Home 恢复自动高度,手动高度按可用空间比例保存并跨刷新恢复;展开入口打开居中的编辑窗口,复用同一文档实例和撤销栈;底部保留放大前的正文预览、输入框轮廓、工具栏及原有尺寸,页面布局与阅读位置保持连续,背景预览通过隔离节点提供只读展示;通过关闭按钮、Esc 或收起入口返回紧凑输入,保留草稿、选区及原高度选择。编辑窗口复用公共窗口手柄,支持拖动、键盘调节、复位及尺寸偏好恢复。窄屏、缩放及附件变化重新限制高度,发送工具栏保持可见。普通正文和同级列表完整显示,光标与选区由浏览器原生维护;滚动后继续输入时定位到真实编辑位置。加载期间的文本、焦点及完整选区交接给文档编辑器,对话切换后旧实例只清理自己的输入适配。Ctrl+Enter 与发送按钮走同一提交入口,Enter 保留换行;组合输入确认保持正常编辑。输入期间共享状态快照稳定,长历史和文件面板保持渲染隔离。
54
56
 
55
- 正文使用 Markdown 富文本编辑,支持 CommonMark、GFM(表格、任务列表、删除线、自动链接及脚注)、数学公式。Mermaid 以普通代码块输入,HTML 保留源码。用户直接编辑排版后的正文及表格单元格,选区格式工具提供常用操作;持久化和发送使用 Markdown。编辑器实例及撤销栈归当前对话的输入组件所有,切换对话时销毁;异步初始化及迟到输入回调按挂载生命周期隔离。输入后立即发送读取即时草稿,文件引用和快捷命令继续使用统一入口。编辑器和运行时资源从本站加载,加载期间保留可编辑的 Markdown 文本框。
57
+ 正文使用 Markdown 富文本编辑,支持 CommonMark、GFM(表格、任务列表、删除线、自动链接及脚注)、数学公式。Mermaid 以普通代码块输入,HTML 保留源码。用户直接编辑排版后的正文及表格单元格,选区格式工具提供常用操作;持久化和发送使用 Markdown。纯文本 Markdown 粘贴直接插入原生文档节点,保留代码语言、公式及表格,选区替换和光标落点遵循粘贴位置;块后保留正文续写位置,一次撤销恢复整次粘贴。富文本副本保留其文档结构,代码内部保留字面内容。编辑器实例及撤销栈归当前对话的输入组件所有,切换对话时销毁;异步初始化及迟到输入回调按挂载生命周期隔离。输入后立即发送读取即时草稿,文件引用和快捷命令继续使用统一入口。编辑器和运行时资源从本站加载,加载期间保留可编辑的 Markdown 文本框。
56
58
 
57
59
  提交快照包含正文、附件、文件引用和全部批注。失败保留可重试内容,成功只清理与已发送快照一致的草稿;请求等待期间的新输入或批注继续保留。运行中补充使用当前轮次通道,新的轮次带上当前模型、有效思考强度、速度模式和统一执行策略。
58
60
 
59
61
  新对话的模型和思考强度按项目保存。已有对话打开、刷新及重连时,从后端对话读取与恢复结果取得该对话的模型和思考强度;项目默认选择仅用于新建对话,恢复请求期间的手动调整继续保留。服务端项目设置是跨浏览器恢复来源,本地缓存和待写入选择用于即时交互及失败重试;迁移只补齐服务端缺失值。同项目新建沿用当前有效选择,跨项目恢复目标选择。模型切换保持支持的强度,不支持时由领域规则选择最近的可用档位;迟到恢复保留期间的手动调整。
60
62
 
63
+ 输入区模型入口按当前选项显示完整的供应商与模型名称,宽度随内容和工具栏可用空间调整,超长名称允许换行。原生下拉选择、键盘操作和禁用状态保持一致,窄屏及页面缩放后发送与停止按钮保持可见。
64
+
61
65
  思考强度通过带离散档位圆点的胶囊滑块调整,标题旁显示当前档位,滑块下方省去重复的档位文字。输入框的紧凑入口展开独立面板,模型弹窗复用同一控件;拖动、点击轨道和方向键使用后端返回的支持档位。模型选择和速度模式分别使用各自入口。
62
66
 
63
- 执行策略统一为完全访问。快捷命令注册与参数解析集中在 `features/commands`,菜单、按钮和键盘使用同一入口。18 项网页通用命令保留统一用例,Claude Code 当前目录的原生附加命令由实际运行时目录提供。`/init` 保留并打开已有目录指令文件;`/goal` 使用实际目标接口;`/stop` 清理当前对话全部后台终端分页。Claude Code 每次提交按祖先到当前目录读取 AGENTS 项目指令,同目录优先 `AGENTS.override.md`,保留完整原文、路径与作用域;本轮快照替换此前快照,修改和删除在下一轮生效,原生 `CLAUDE.md` 持续适用。完整支持范围见[命令覆盖记录](../cli-command-coverage.md)。
67
+ 执行策略统一为完全访问。快捷命令注册与参数解析集中在 `features/commands`,菜单、按钮和键盘使用同一入口。`/` 在输入开头、空格及换行后提供命令与技能建议。中途确认网页命令时仅移除当前查询,保留前后正文及附件,执行失败恢复完整草稿;原生命令将已有正文作为参数提交,原生技能将命令放到正文前等待发送。开头命令继续读取后续参数。18 项网页通用命令保留统一用例,Claude Code 当前目录的原生附加命令由实际运行时目录提供。`/init` 保留并打开已有目录指令文件;`/goal` 使用实际目标接口;`/stop` 清理当前对话全部后台终端分页。Claude Code 每次提交按祖先到当前目录读取 AGENTS 项目指令,同目录优先 `AGENTS.override.md`,保留完整原文、路径与作用域;本轮快照替换此前快照,修改和删除在下一轮生效,原生 `CLAUDE.md` 持续适用。完整支持范围见[命令覆盖记录](../cli-command-coverage.md)。
64
68
 
65
69
  所有公式使用 `$$公式$$`,同一行及换行输入统一生成当前段落内的行内公式,光标停在公式后并可继续正文。单美元符号作为普通文本。闭合前保留可编辑源码,公式可双击或通过键盘重新编辑,修改后以 `$$` 再次闭合。粘贴、草稿恢复和发送沿用同一双美元符号语法;代码块与行内代码保留美元符号源码。
66
70
 
@@ -121,7 +125,7 @@ flowchart LR
121
125
 
122
126
  ## 消息展示与导航
123
127
 
124
- 领域层按轮次组合消息与工作过程,用户提问和中途补充保留独立消息;同轮补充同时按原始消息顺序收入工作过程,摘要行直接显示消息正文,短消息完整可读,长消息省略并可展开正文与附件,实时预览继续显示最新工作活动;工作过程默认折叠,运行时展示最新有效活动,结束后固定耗时。最终回答的复制及分支按钮位于本轮文件汇总之后,实时生成和历史恢复遵循相同顺序。
128
+ 领域层按轮次组合消息与工作过程,用户提问和中途补充保留独立消息;同轮补充同时按原始消息顺序收入工作过程,摘要行直接显示消息正文,短消息完整可读,长消息省略并可展开正文与附件,实时预览继续显示最新工作活动;工作过程默认折叠,运行时展示最新有效活动,结束后固定耗时。Codex 的 `delivery: async` 中途回复始终收入同轮过程,即使阶段为 `final_answer`;异步投递保留待答提问,回复操作只归属真实最终回答。最终回答的复制及分支按钮位于本轮文件汇总之后,实时生成和历史恢复遵循相同顺序。
125
129
 
126
130
  全部历史保持连续可滚动。打开对话和回到最新时定位到真实底部,包括消息底部留白;自动跟随期间,输入框恢复、图片、图表及容器变化继续贴底。上翻或目录跳转后保留阅读位置,切换对话清理监听和待处理帧。
127
131
 
@@ -159,7 +163,7 @@ Claude 子代理原生历史中,带有 `isSidechain=true` 与 `agentId` 的任
159
163
 
160
164
  消息、工具结果、子代理及文件预览共用 Markdown 和 HTML 白名单过滤。安全的标题、对齐、图片、`picture` 及折叠内容统一处理,代码保留源码。相对资源以所属对话或文件目录解析;图片失败、主题切换及迟到读取均有隔离处理。
161
165
 
162
- 图片按统一等比缩略图展示,点击可查看大图,Esc、关闭按钮和空白区域退出后恢复焦点。Mermaid 从本站按需加载,严格模式绘制;流式未完成或解析失败时保留源码,清理临时节点并隔离旧主题及旧源码结果。
166
+ 图片按统一等比缩略图展示,点击可查看大图,Esc、关闭按钮和空白区域退出后恢复焦点。Mermaid 从本站按需加载,严格模式绘制,默认使用 13px 字号与紧凑节点间距,按可用宽度等比缩小,长图默认在受限高度内滚动,工具栏的四角展开图标可显示完整高度,再次点击四角收起图标恢复紧凑高度,悬停及可访问名称分别为“展开图表”和“收起图表”;消息与文件预览共用展示规则。流程图方向菜单以当前实际布局选中横向或纵向,可选择另一方向进行切换,切换时恢复默认缩放,子图内部的方向声明保持原样。缩放按钮以 25% 为一步,在 50% 至 800% 之间调整,点击百分比复位;图表聚焦后支持 `+`、`-`、`0`,Ctrl+滚轮或触控板捏合缩放。方向、缩放与展开状态归当前图表组件,流式更新与主题重绘保留选择,卸载后恢复默认。查看及复制源码始终使用消息原文。流式未完成或解析失败时保留源码,清理临时节点并隔离旧主题及旧源码结果。
163
167
 
164
168
  ## 账户、登录与外观
165
169
 
@@ -223,6 +227,8 @@ Claude Code 网络代理在设置中提供跟随服务环境、关闭和 HTTP,
223
227
 
224
228
  更新及重启请求遇到活动轮次、后台任务、排队输入、待答提问、内部命令或上下文整理时,结束本次操作并短暂提示用户结束任务后重试。提示五秒后关闭,用户稍后重新发起操作。切换阶段暂停网页提交,避免提交与重启竞争。重启成功后网页显示“服务已重启,请刷新网页”,用户自行刷新。
225
229
 
226
- 发现新版本后,侧栏底部显示带版本号的更新入口并标记设置按钮;侧栏收起或窄屏时,顶部显示紧凑更新入口。设置页按更新与重启、模型与服务配置、通知与翻译、网页登录分组。更新卡片集中显示产品身份和主操作,当前与最新版本在产品名下同行显示,检查更新、重启服务与更新按钮在卡片底部固定排成一行,复用设置页按钮的尺寸和边框,主要更新操作位于右侧,有新版时显示“更新至版本号”,无需更新时显示灰色禁用的“无需更新”,按钮数量与位置保持稳定;检查期间显示进行状态。设置卡片通过间距区分内部内容。原生后端的当前版本合并到标题行,正常连接以状态点显示,安装操作失败作为本次设置访问中的短暂提示,重新打开设置跳过历史安装提示,有新版时在按钮直接显示目标版本并允许更新,版本相同或本机更新时保留灰色禁用的“无需更新”按钮;未安装、停用及连接失败保留文字状态。网页主题始终跟随系统。点击更新入口直接打开设置并滚动、聚焦“更新与重启”区域。界面只显示版本、操作与必要状态,检查周期及部署实现保留在部署文档。
230
+ 发现新版本后,侧栏底部显示带版本号的更新入口并标记设置按钮;侧栏收起或窄屏时,顶部显示紧凑更新入口。设置页按更新与重启、模型与服务配置、其他设置、网页登录分组。更新卡片集中显示产品身份和主操作,当前与最新版本在产品名下同行显示,产品图标、版本信息与检查更新、重启服务、更新按钮在卡片中垂直居中并同行排列,空间不足时操作组整体换行,三个按钮保持同行,复用设置页按钮的尺寸和边框,主要更新操作位于右侧,有新版时显示“更新至版本号”,无需更新时显示灰色禁用的“无需更新”,按钮数量与位置保持稳定;检查期间显示进行状态。设置卡片通过间距区分内部内容。其他设置的选项间距保持一致,状态与错误说明紧随所属选项并与选项文字对齐。原生后端的当前版本合并到标题行,正常连接以状态点显示,安装操作失败作为本次设置访问中的短暂提示,重新打开设置跳过历史安装提示,有新版时在按钮直接显示目标版本并允许更新,版本相同或本机更新时保留灰色禁用的“无需更新”按钮;未安装、停用及连接失败保留文字状态。网页主题始终跟随系统。点击更新入口直接打开设置并滚动、聚焦“更新与重启”区域。界面只显示版本、操作与必要状态,检查周期及部署实现保留在部署文档。
227
231
 
228
232
  维护任务的持久结果用于状态核对,操作提示归属当前设置访问。首次加载、刷新及重新打开设置跳过历史完成和失败提示;当前访问发起的操作按任务开始时间确认结果并只显示一次。关闭设置清除提示并使在途请求的后续反馈失效,后台任务继续按真实状态执行。代理保存反馈五秒后消失,表单错误和实际连接、下载故障按各自当前状态提供处理入口。
233
+
234
+ 运行与加载状态使用静态图标,任务进度与耗时按实际数据更新。等待期间省去循环旋转和呼吸动画,使稳定内容仅随进度变化重新绘制;任务完成后清除运行提示并停止对应计时。
@@ -226,6 +226,8 @@ Claude 网页桥接重启或异常退出时,独立执行服务继续持有模
226
226
 
227
227
  `backends/manager.mjs` 持有固定的 `codex` 和 `claude` 两个适配器,汇总状态、列表与能力声明;配置写入只接受这两个标识,网页后端配置接受启停选择及 Claude Code 网络代理,原生目录与 Codex 地址从服务配置取得,旧网页程序路径及启动参数在读取时归一化。`cli-installation.mjs` 负责标准 CLI 查找、当前版本、npm 官方最新版本及固定官方包的全局安装;桥接管理器启动版本检测服务,启动时及此后每小时检测两个 CLI 并广播缓存状态,关闭时清理定时器;网页读取缓存,版本信息位于所属后端内。管理器持有安装任务并广播状态,安装前复用任务占用与独立服务原子停止边界,重复点击合并。Claude 执行服务取得实际 CLI 绝对路径,systemd 网页服务保留安装时的 PATH。Codex 适配器在专属目录中沿用原有 app-server 连接、账户和模型配置。Claude 供应商配置及按模型 ID 关联的显示别名由 `backends/providers.mjs` 保存;别名随供应商配置同步,模型目录与菜单优先使用别名,模型请求保留原始 ID。供应商通过配置存储的独立读取入口取得记录,Claude 执行服务读取供应商时只依赖自己的配置范围。Codex 地址校验由网页管理器读取后端配置时执行。凭据只在服务器使用,公开响应提供凭据是否存在。默认供应商由 `backends/provider-presets.mjs` 统一登记,和已保存配置按稳定标识合并;设置页通过 `includeDisabled` 读取全部目录,模型目录只读取启用项。默认供应商按目录顺序置于自定义项之前,定义必须包含 `icon`,对应品牌 SVG 放在 `client/src/assets/providers` 并经 Vite 打包;设置页显示品牌图标,供应商列表行展示身份、状态及操作,具体模型名称在模型菜单和编辑表单中展示。默认供应商仅接受 Key 编辑,地址、协议、模型与能力由官方目录固定;读取旧配置时保留凭据并使用当前官方参数。默认供应商以非空 Key 启用,清空后停用,运行时读取同时校验启用状态。
228
228
 
229
+ `cli-package.mjs` 从上游 npm 清单取得版本和当前平台的原生依赖,先将原生包作为必需依赖安装到临时目录,完成下载与 npm 完整性校验,再以同一固定版本执行全局安装。临时目录在成功与失败后均清理,全局安装复用校验缓存,显式包含可选依赖并启用安装脚本。版本查询和安装共同使用网页 Node.js 的 PATH。下载失败结束操作,已有全局安装继续保留。最终 CLI 版本须与安装清单一致。安装状态分别保存简短提示与原始诊断,设置页按需展开有高度限制、可换行的错误详情。
230
+
229
231
  `application/backends.js` 汇总 Codex 原生模型与 Claude 供应商模型,选择键包含后端、供应商和模型。输入区的 `model-select.jsx` 只负责呈现与调用动作。新对话依据所选模型确定运行时;已有对话继续使用所属运行时,Claude 对话空闲时可以切换供应商及模型。打开对话以其已保存的供应商和模型恢复选择。顶部与侧栏复用 `app/backend-badge.jsx` 仅显示图标,领域层按对话资源标识确定后端,当前新对话采用已选后端;显示归属与供应商名称独立。
230
232
 
231
233
  默认 Codex 对话保留原 ID,Claude 资源使用 `backend:claude:<原生 ID>`;桥接只转换协议中的资源字段,工具参数和用户正文保持原样。历史读取、原生命令和提问响应按资源归属路由,两个后端的同名原生 ID 相互隔离。
@@ -256,6 +258,8 @@ Claude 网页桥接重启或异常退出时,独立执行服务继续持有模
256
258
 
257
259
  `features/markdown` 集中提供 Markdown、HTML 白名单、图片、链接、数学公式和 Mermaid。消息、工具结果和文件预览复用同一渲染入口;文件目录由上下文传递,局部组件负责媒体加载与清理。文本安全过滤和路径解析在这里统一维护。
258
260
 
261
+ Mermaid 的流程图主方向转换归 `domain/mermaid.js`,原始正文保持独立;`mermaid-block.jsx` 持有方向、缩放、展开和源码查看状态,`mermaid-diagram.jsx` 按容器宽度等比绘制并处理图内滚动、键盘及 Ctrl+滚轮缩放。尺寸观察与滚轮监听随组件卸载清理,重新绘制继续隔离旧源码和主题结果。
262
+
259
263
  `features/workspace` 把文件树、目录选择、文件编辑、差异、终端和对话详情拆成独立模块。编辑器与文件变更装饰分别封装;显示的删除装饰与实际保存正文分开处理。`context-panel.jsx` 组合概览和子代理详情,主对话切换统一清理选择,编辑缓冲区继续按原主对话保存。
260
264
 
261
265
  `app` 将输入框和错误提示作为底部插槽传入对话布局。对话布局统一提供消息、底部输入和右侧详情的几何边界;桌面展开详情时输入区域避让右侧面板,详情占满工作区高度。文件下载入口归文件面板工具栏,媒体预览组件负责内容展示及加载重试。
@@ -268,7 +272,7 @@ Claude 网页桥接重启或异常退出时,独立执行服务继续持有模
268
272
 
269
273
  `features/composer` 管理输入交互;`features/commands/composer-commands.js` 是快捷命令的独立注册表,菜单、按钮和键盘提交走同一解析和执行入口。`domain/commands` 只负责工具命令描述的分类与解析,命令支持范围见[命令覆盖记录](cli-command-coverage.md)。
270
274
 
271
- 输入区的 `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-editor-viewport` 是正文唯一的纵向滚动容器,内部 ProseMirror 文档按内容自然排版;正文段落、列表及引用共用输入区字号与行高。仅导入已启用功能的组件样式,基础排版由项目样式定义。使用浏览器原生光标与选区,取消虚拟光标绘制。异步加载期间使用独立持有的文本框,初始化后接收最新草稿、焦点和完整选区;对外输入适配按实例发布与清理,卸载使异步回调失效。编辑器、语言支持、样式及公式字体由 Vite 生成本站分块或内联资源,随 `client/dist` 交付。
275
+ 输入区的 `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` 交付。
272
276
 
273
277
  批注编辑在 `features/annotations`,协议解析在 `domain/annotations.js`,存储和订阅在 `infrastructure/annotation-drafts.js`。选区编辑只更新草稿,统一发送由消息控制器完成。账户详情、侧栏宽度和主题分别保留自己的控件生命周期。
274
278
 
@@ -292,6 +296,8 @@ npm 分发由独立的 `npm-publish.yml` 工作流监听即时及定时 GitHub
292
296
 
293
297
  服务安装器创建网页服务时独立于原生 CLI 的安装状态。新建的 Codex 用户服务以当前 Node.js 运行 `scripts/start-backend.mjs`,显式传入网页配置目录、原生目录和连接地址;启动脚本沿用原生 app-server 参数。CLI 缺失时该服务失败后由 systemd 每 5 秒重试,网页继续提供登录、设置和 CLI 安装入口。既有 Codex 服务的保留与新服务的首次启动分别回归。
294
298
 
299
+ Codex 启动脚本将 WebSocket 连接地址转换为原生 CLI 的 `ws://主机:端口` 监听参数,保留 IPv6 方括号并显式补齐默认端口 80。连接地址的 URL 规范化与原生监听参数构造分别处理,监听入口校验协议、路径、查询参数及片段。回归精确核对命令行和服务生成入口实际提交的完整参数。
300
+
295
301
  `npm run architecture:check` 扫描 `client/src`、`server/src`、`shared`、`scripts`、`bin` 和翻译子项目中的 JavaScript、JSX、MJS 与 CSS:
296
302
 
297
303
  1. 单文件最多 **500 行**,计入注释和空行。日常按单一职责组织,接近上限时先拆分,保持格式化后的正常排版。
@@ -308,6 +314,8 @@ npm 分发由独立的 `npm-publish.yml` 工作流监听即时及定时 GitHub
308
314
  - 浏览器测试使用生产构建和隔离数据,验证真实布局、键盘、焦点、媒体、动态加载及刷新恢复。
309
315
  - 发行包测试在临时 npm prefix 安装包,验证共享模块、分块资源、无 Git 版本来源和服务配置生成。
310
316
 
317
+ 单元与发行包测试的控制台日志由 `tests/helpers/test-console.mjs` 在模块加载前统一送入 stderr,Node.js 从独立文本流生成日志事件,stdout 保持二进制测试事件传输。该隔离由公共 npm 测试入口持有,回归覆盖 Unicode 日志、并发输出及真实失败退出状态。
318
+
311
319
  浏览器回归按功能风险选择,命令及依赖见[开发者指南](development.md#格式与验证)。修改界面布局或渲染时,在实际消息区和文件面板验证深浅主题、窄屏及规定缩放;修改认证和桥接时使用真实的隔离 HTTPS/WSS 连接。
312
320
 
313
321
  ## 8. 扩展流程与设计取舍
@@ -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.0.tgz.sha256
32
- npm install -g ./claudex-web-4.1.0.tgz
31
+ sha256sum -c claudex-web-4.1.1.tgz.sha256
32
+ npm install -g ./claudex-web-4.1.1.tgz
33
33
  claudex-web service install
34
34
  ```
35
35
 
@@ -88,6 +88,12 @@ package-lock.json 全项目依赖锁文件
88
88
 
89
89
  快捷命令的 CLI 对照、网页复用入口、专用能力边界及浏览器回归方法见[命令覆盖记录](cli-command-coverage.md)。
90
90
 
91
+ CLI 安装回归使用 `server/tests/cli-package.test.mjs` 验证原生平台包选择、下载失败保留旧安装、重试顺序、npm 成功后 CLI 失效及版本不一致。构建后以 `PLAYWRIGHT_MODULE=/path/to/playwright/index.mjs CHROME_PATH=/path/to/chromium node tests/browser/cli-installation.mjs` 检查设置中的简短提示、诊断展开和安装重试,覆盖深浅主题、窄屏及 80% 至 200% 实际浏览器缩放。截图和构建来源保存在 `.cache/cli-installation/after`。设置 `BROWSER_BEFORE=1` 使用 `.cache/cli-installation-before` 的构建复现原始堆栈撑宽窗口。README 图片展示聊天、文件与侧栏,安装错误通过专项截图核对。
92
+
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
+
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
+
91
97
  ## 双后端开发与验收
92
98
 
93
99
  双后端的统一范围由[产品契约](architecture/backends.md)定义;`shared/product-contract.mjs` 只注册工作区和对话方法的路由分组。原生能力分别接入统一用例,文件与网页终端由共用工作区服务提供。文件模糊查询按所属后端路由,Codex 保留原生 app-server 调用,Claude Code 使用原生 `file_suggestions` 控制请求及 CLI 文件索引;两端共用输入建议,回归同时核对原有 Codex 路径和 Claude 新增实现。CLI/SDK 生命周期、原生历史及参数发生变化时,同时检查首次请求、流式展示、轮次完成、刷新恢复和错误重试。Claude 执行服务通过受限本机 IPC 独立于网页桥接运行,网页关闭仅释放连接;源码与安装来源的代码身份按实际发行文件计算。
@@ -175,6 +181,8 @@ CLAUDE_EXECUTABLE=/absolute/path/to/claude MODEL_BASE_URL=https://model.example
175
181
 
176
182
  ## 格式与验证
177
183
 
184
+ 模型名称布局回归在构建后执行 `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
+
178
186
  长对话切换回归先执行 `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 图片展示完整加载后的界面,布局和内容继续适用。
179
187
 
180
188
  侧栏收纳回归执行 `SIDEBAR_DENSITY=1 CHROME_PATH=/path/to/chromium node tests/browser/project-pins.mjs`,使用隔离的 Atlas/Beacon 与最近有活动的未分类对话、超过 60 条的后端分页,验证未分类始终位于末尾、固定与未固定的默认收放、每组最新五条、全部展开及收起、刷新重置、键盘操作、深浅主题、80% 至 200% 缩放和手机布局。截图与构建信息保存在 `.cache/sidebar-density-browser/after/`。旧构建及来源位于 `.cache/sidebar-density-before/`,追加 `SIDEBAR_DENSITY_BEFORE=1` 保存旧版全部展开的对照截图。
@@ -240,6 +248,10 @@ npm run test:package
240
248
 
241
249
  右侧详情隔离回归先执行 `npm run build`,再运行 `CHROME_PATH=/path/to/chromium CONTEXT_RESET=1 BROWSER_OUTPUT_DIR=.cache/context-reset/after node tests/browser/annotations.mjs`。脚本以隔离 WebSocket 历史和独立浏览器配置,实际打开文件差异与变更面板并点击新建,检查默认收起、重新展开的概览、文件列表、深浅主题和手机布局。修改前的生产构建及构建信息分别保存在 `.cache/context-reset-before/dist` 与 `.cache/context-reset-before/build-info.json`,通过 `BROWSER_BEFORE=1`、`BROWSER_BUILD_DIR` 和 `BROWSER_BUILD_INFO` 指定并复现残留;截图和构建来源写入指定目录。组件回归补充文件、变更、子代理与待打开文件的清理,以及原对话未保存文件的恢复。README 及其他文档引用的现有截图展示任务对话与文件预览,本次修复的新建状态未出现在这些图片中,图片内容保持适用。
242
250
 
251
+ ## Mermaid 图表回归
252
+
253
+ Mermaid 回归先执行 `npm run build`,再运行 `PLAYWRIGHT_MODULE=/path/to/playwright/index.mjs CHROME_PATH=/path/to/chromium node tests/browser/mermaid.mjs`。使用隔离的后端历史与文件正文,在真实消息区和 Markdown 文件预览中绘制长流程图、短流程图及中文时序图;核对紧凑字号、长图展开与收起、完整高度、方向切换、原始源码保留,以及按钮、键盘和 Ctrl+滚轮缩放与复位。深浅主题、390px 窄屏及 80% 至 200% 的实际浏览器缩放均检查页面边界。截图、尺寸记录及构建来源保存在 `.cache/mermaid-size-browser/after`。修改前的构建与来源复制到 `.cache/mermaid-size-before/dist` 和 `build-info.json` 后,使用 `BROWSER_BEFORE=1` 记录对照。
254
+
243
255
  ## 网页交互终端回归
244
256
 
245
257
  网页手动终端通过独立的 `lan/terminal/*` 接口进入宿主工作区,由 node-pty 持有进程;模型后端、原生命令与后台任务分别按各自所有者维护。`node --test server/tests/web-terminals.test.mjs server/tests/backend-native-workspace-routing.test.mjs` 使用真实 PTY 和模拟后端,核对 Codex 与 Claude Code 标识均进入同一工作区、后端离线时仍可使用终端、连续创建五个、前台进程切换、单独结束及原生工作区路由。组件回归覆盖名称与图标更新、切换复用实例、启动目录隔离、面板开关与选中项恢复、后台目录退出隔离、Ctrl+D 及当前目录最后退出后的收起。`client/tests/terminal-workspace.test.js` 检查完整路径、中文目录及路径规范化,同目录切换后端和不同目录分别验证。
@@ -333,7 +345,7 @@ Ubuntu 安装指引回归在设备选择器中实际切换 Ubuntu,检查 DER
333
345
 
334
346
  ### Markdown 富文本输入回归
335
347
 
336
- 输入框采用直接编辑排版正文的交互,持久化与提交使用 Markdown。执行 `npm run build` 后,使用 `CHROME_PATH=/path/to/chromium PLAYWRIGHT_MODULE=/path/to/playwright/index.mjs node tests/browser/markdown-composer.mjs` 验证生产构建。脚本使用隔离模拟后端和独立浏览器上下文,检查双美元符号公式的同段渲染、单美元符号普通文本、闭合前源码、源码重入及撤销重做;同时检查延迟加载期间的文本及选区恢复、快速切换对话后的实例隔离、正文及列表两行的完整边界、点击与方向键定位、撤销重做、滚动后继续输入、原生光标、连续换行时的固定高度与位置、编辑区滚轮上下滚动、混合 Markdown 粘贴、表格直接编辑、任务复选框、公式、脚注、代码与 HTML 源码保留、草稿、发送及快捷建议,并覆盖深浅主题、80%~200% 缩放和窄屏。截图、结果和构建来源保存在 `.cache/markdown-composer`。组件回归使用文本输入适配,实际富文本行为由浏览器回归覆盖;发行包回归验证编辑器分块的安装与资源响应,浏览器回归拦截外站请求。
348
+ 输入框采用直接编辑排版正文的交互,持久化与提交使用 Markdown。执行 `npm run build` 后,使用 `CHROME_PATH=/path/to/chromium PLAYWRIGHT_MODULE=/path/to/playwright/index.mjs node tests/browser/markdown-composer.mjs` 验证生产构建。脚本使用隔离模拟后端和独立浏览器上下文,检查双美元符号公式的同段渲染、单美元符号普通文本、闭合前源码、源码重入及撤销重做;同时检查延迟加载期间的文本及选区恢复、快速切换对话后的实例隔离、正文及列表的完整边界、点击与方向键定位、撤销重做、滚动后继续输入、原生光标、连续换行自动增高及可用空间边界、混合块在正文中间粘贴及选区替换后的顺序、光标与整次撤销、代码续写、公共手柄拖动及展开收起、放大时底部输入区的轮廓与尺寸保留、只读预览与编辑器节点隔离、编辑区滚轮上下滚动、混合 Markdown 粘贴、表格直接编辑、任务复选框、公式、脚注、代码与 HTML 源码保留、草稿、发送及快捷建议,并覆盖深浅主题、80%~200% 缩放和窄屏。截图、结果和构建来源保存在 `.cache/markdown-composer`。组件回归使用文本输入适配,实际富文本行为由浏览器回归覆盖;发行包回归验证编辑器分块的安装与资源响应,浏览器回归拦截外站请求。
337
349
 
338
350
  使用相同环境变量运行 `tests/browser/markdown-typing.mjs`,验证逐字键入、整段插入、粘贴和中文组合输入自动排版。覆盖列表内公式 `- $$x_{t+1}=x_{t}+dx$$`、标题、强调、链接、任务列表、表格分隔行及代码围栏进出,同时核对实际可见排版、表格光标和 Markdown 草稿。证据保存在 `.cache/markdown-typing/after`。
339
351
 
@@ -394,3 +406,7 @@ Ubuntu 安装指引回归在设备选择器中实际切换 Ubuntu,检查 DER
394
406
  中途进入运行中会话的回归执行 `TRANSLATION_TEST_MODEL_DIR=/path/to/installed/models PLAYWRIGHT_MODULE=/path/to/playwright/index.mjs CHROME_PATH=/path/to/chromium node tests/browser/translation-active-history.mjs`。脚本使用生产构建、临时配置与隔离历史,保留原生历史摘要缺少状态字段的结构,实际调用本地 CPU 引擎,验证旧摘要翻译、当前摘要等待完成、原译文切换、刷新缓存、深浅主题、窄屏及 80% 至 200% 实际页面缩放。证据保存在 `.cache/translation-active-history/after`。修复前先将 `client/dist` 和 `build-info.json` 分别复制到 `.cache/translation-active-history/before/dist` 和 `build-info.json`,再加 `BROWSER_BEFORE=1` 运行,记录旧摘要零翻译请求及对照截图。测试恢复页面缩放并清理临时配置与浏览器;README 演示图展示已结束对话,沿用现有截图。
395
407
 
396
408
  构建后执行 `TRANSLATION_TEST_MODEL_DIR=/path/to/installed/models PLAYWRIGHT_MODULE=/path/to/playwright/index.mjs CHROME_PATH=/path/to/chromium node tests/browser/thinking-translation.mjs`。脚本使用独立浏览器、临时配置和模拟对话,实际调用本地 CPU 引擎,验证默认关闭、完整消息触发、等待原文、Markdown 文字提取、原译文切换及关闭恢复原文,覆盖深浅主题、桌面与窄屏、80% 至 200% 实际浏览器缩放。已安装模型目录由运行者提供,截图和结果保存在 `.cache/thinking-translation/`,测试结束后清理浏览器与临时配置。
409
+
410
+ 异步回复收纳回归在构建后执行 `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
+
412
+ 运行状态渲染回归使用 `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 占用另通过桌面静置采样核对。
Binary file
Binary file
Binary file
@@ -0,0 +1,19 @@
1
+ # Claudex Web v4.1.1
2
+
3
+ - 消息输入区随正文、代码和公式自动增高,支持拖动调高及独立窗口编辑长内容,放大时保留底部预览和页面位置。正文中间粘贴保留代码格式、前后文字及整次撤销。([d57d1be](https://github.com/hjd-hitsz/claudex-web/commit/d57d1be))
4
+
5
+ - Mermaid 图表支持横向与纵向切换、完整高度展开与收起,以及按钮、键盘和 Ctrl+滚轮缩放与复位。默认字号和节点间距更紧凑,长图高度与正文比例更协调。([d342926](https://github.com/hjd-hitsz/claudex-web/commit/d342926))
6
+
7
+ - 输入正文中途在空格或换行后使用 `/` 可查看命令与技能建议,选择命令时保留前后正文和附件,执行失败后恢复草稿。([dbc8074](https://github.com/hjd-hitsz/claudex-web/commit/dbc8074))
8
+
9
+ - 输入区模型名称随当前选项自适应宽度,竖屏保留完整名称,超长名称在窄屏内换行。([dd20ea9](https://github.com/hjd-hitsz/claudex-web/commit/dd20ea9))
10
+
11
+ - 设置中的版本信息与操作按钮同行排列,减少纵向留白。“通知与翻译”更名为“其他设置”,选项间距统一,状态说明贴近对应选项。([5acc2ff](https://github.com/hjd-hitsz/claudex-web/commit/5acc2ff))
12
+
13
+ - CLI 一键安装先下载校验当前平台组件,再安装并核对版本。下载失败保留已有 CLI,错误详情可展开查看,窄屏长路径完整换行。修复新建 Codex 后端服务时因监听地址末尾斜杠导致启动失败的问题。([bef8fb8](https://github.com/hjd-hitsz/claudex-web/commit/bef8fb8))
14
+
15
+ - 执行过程中的异步中途回复与同轮补充统一收纳到工作过程中,保持聊天区最终回答的展示顺序。([f7cd966](https://github.com/hjd-hitsz/claudex-web/commit/f7cd966))
16
+
17
+ - 运行与加载提示采用静态状态图标,减少持续等待时的绘制开销,同时保留进度、计时和完成反馈。([9150d3c](https://github.com/hjd-hitsz/claudex-web/commit/9150d3c))
18
+
19
+ - 收起侧栏后,键盘焦点返回页头展开按钮,方便继续操作。([de71ba2](https://github.com/hjd-hitsz/claudex-web/commit/de71ba2))
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@hjd-hitsz/claudex-web",
3
- "version": "4.1.0",
3
+ "version": "4.1.1",
4
4
  "type": "module",
5
5
  "description": "Codex 与 Claude Code 的浏览器工作台",
6
6
  "license": "GPL-3.0-only",
@@ -43,9 +43,9 @@
43
43
  "start": "node --env-file-if-exists=.env server/src/server.mjs",
44
44
  "start:backend": "node --env-file-if-exists=.env scripts/start-backend.mjs",
45
45
  "test": "npm run test:unit && npm run test:components",
46
- "test:unit": "node --test client/tests/*.test.js server/tests/*.test.mjs tests/architecture.test.mjs tests/version.test.mjs tests/release.test.mjs tests/npm-release.test.mjs packages/translation-engine/tests/*.test.mjs",
46
+ "test:unit": "node --import ./tests/helpers/test-console.mjs --test client/tests/*.test.js server/tests/*.test.mjs tests/architecture.test.mjs tests/version.test.mjs tests/release.test.mjs tests/npm-release.test.mjs tests/test-console.test.mjs packages/translation-engine/tests/*.test.mjs",
47
47
  "test:components": "node scripts/test-components.mjs",
48
- "test:package": "npm run build && node --test tests/package.test.mjs",
48
+ "test:package": "npm run build && node --import ./tests/helpers/test-console.mjs --test tests/package.test.mjs",
49
49
  "version:check": "node scripts/version.mjs check",
50
50
  "version:prepare": "node scripts/version.mjs prepare",
51
51
  "release:check": "node scripts/version.mjs release",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@claudex-web/translation-engine",
3
- "version": "4.1.0",
3
+ "version": "4.1.1",
4
4
  "type": "module",
5
5
  "license": "GPL-3.0-only",
6
6
  "description": "独立的本地英译中引擎与按需模型管理",
@@ -6,6 +6,12 @@ const config = readConfig();
6
6
  const { backends } = await createBackendConfiguration(config).read();
7
7
  const backend = backends.find((b) => b.id === "codex" && b.enabled);
8
8
  if (!backend) throw new Error("Codex 后端未启用");
9
+ const url = new URL(backend.url);
10
+ if (url.protocol !== "ws:" || url.pathname !== "/" || url.search || url.hash)
11
+ throw new Error(
12
+ "Codex 本机监听地址须使用 ws://主机:端口,且不含路径、查询参数或片段",
13
+ );
14
+ const listenUrl = `ws://${url.hostname}:${url.port || 80}`;
9
15
  const child = spawn(
10
16
  backend.executable || "codex",
11
17
  [
@@ -14,7 +20,7 @@ const child = spawn(
14
20
  "thread_unload_delay_secs=0",
15
21
  "app-server",
16
22
  "--listen",
17
- backend.url,
23
+ listenUrl,
18
24
  ],
19
25
  { stdio: "inherit", env: { ...process.env, CODEX_HOME: backend.dataDir } },
20
26
  );
@@ -4,6 +4,11 @@ import { constants } from "node:fs";
4
4
  import { dirname, delimiter, join } from "node:path";
5
5
  import { homedir } from "node:os";
6
6
  import { promisify } from "node:util";
7
+ import {
8
+ cliEnvironment,
9
+ cliFailure,
10
+ installCliPackage,
11
+ } from "./cli-package.mjs";
7
12
 
8
13
  const execute = promisify(execFile);
9
14
  const packages = {
@@ -64,6 +69,7 @@ export function createCliInstallation({
64
69
  const executable = await locate(id);
65
70
  const { stdout } = await run(executable, ["--version"], {
66
71
  timeout: 10000,
72
+ env: cliEnvironment(),
67
73
  });
68
74
  const version = stdout.match(/\b\d+\.\d+\.\d+(?:-[\w.-]+)?\b/)?.[0];
69
75
  if (!version) throw new Error("无法识别 CLI 版本:" + stdout.trim());
@@ -76,7 +82,16 @@ export function createCliInstallation({
76
82
  installed: local.status === "fulfilled",
77
83
  ...(local.status === "fulfilled"
78
84
  ? local.value
79
- : { currentVersion: "", error: local.reason.message }),
85
+ : {
86
+ currentVersion: "",
87
+ executable: null,
88
+ error: `${id === "codex" ? "Codex" : "Claude Code"} CLI 无法运行,可点击一键安装修复。`,
89
+ errorDetails:
90
+ local.reason.details ||
91
+ local.reason.stderr ||
92
+ local.reason.message,
93
+ }),
94
+ ...(local.status === "fulfilled" && { errorDetails: "" }),
80
95
  ...(latest.status === "fulfilled"
81
96
  ? { latestVersion: latest.value }
82
97
  : { latestError: latest.reason.message }),
@@ -88,23 +103,23 @@ export function createCliInstallation({
88
103
  }
89
104
  async function install(id) {
90
105
  if (!packages[id]) throw new Error("未知后端");
91
- patch(id, { installing: true, installError: "" });
106
+ patch(id, { installing: true, installError: "", installErrorDetails: "" });
92
107
  try {
93
- const npm = join(dirname(process.execPath), "npm");
94
- await run(npm, ["install", "--global", `${packages[id]}@latest`], {
95
- timeout: 300000,
96
- maxBuffer: 4 * 1024 * 1024,
97
- env: {
98
- ...process.env,
99
- PATH: `${dirname(process.execPath)}${delimiter}${process.env.PATH || ""}`,
100
- },
101
- });
108
+ const version = await installCliPackage(id, packages[id], run);
102
109
  if (pending.has(id)) await pending.get(id);
103
110
  await refresh(id);
104
- if (!state(id).installed) throw new Error(state(id).error);
111
+ if (!state(id).installed)
112
+ throw cliFailure("安装后的 CLI 校验失败,可查看错误详情并重新安装。", {
113
+ details: state(id).errorDetails,
114
+ });
115
+ if (state(id).currentVersion !== version)
116
+ throw cliFailure("安装后的 CLI 版本不一致,可查看错误详情并重试。", {
117
+ details: `期望版本 ${version},实际版本 ${state(id).currentVersion}。`,
118
+ });
105
119
  } catch (error) {
106
120
  patch(id, {
107
- installError: `npm 安装失败:${error.stderr?.trim() || error.message}`,
121
+ installError: error.message,
122
+ installErrorDetails: error.details || error.stderr || error.message,
108
123
  });
109
124
  throw error;
110
125
  } finally {
@@ -0,0 +1,116 @@
1
+ import { delimiter, dirname, join } from "node:path";
2
+ import { mkdtemp, rm } from "node:fs/promises";
3
+ import { tmpdir } from "node:os";
4
+
5
+ export function cliEnvironment() {
6
+ return {
7
+ ...process.env,
8
+ PATH: `${dirname(process.execPath)}${delimiter}${process.env.PATH || ""}`,
9
+ };
10
+ }
11
+
12
+ export function cliFailure(message, cause) {
13
+ const error = new Error(message, { cause });
14
+ error.details =
15
+ cause.details ||
16
+ [cause.stderr, cause.stdout, cause.message]
17
+ .filter(Boolean)
18
+ .map((value) => String(value).trim())
19
+ .join("\n");
20
+ return error;
21
+ }
22
+
23
+ export function nativeCliDependency(
24
+ id,
25
+ manifest,
26
+ platform = process.platform,
27
+ arch = process.arch,
28
+ libc,
29
+ ) {
30
+ const dependencies = manifest.optionalDependencies || {};
31
+ if (!Object.keys(dependencies).length) return null;
32
+ const prefix = id === "codex" ? "@openai/codex" : "@anthropic-ai/claude-code";
33
+ const suffix =
34
+ id === "claude" &&
35
+ platform === "linux" &&
36
+ (libc
37
+ ? libc === "musl"
38
+ : !process.report.getReport().header.glibcVersionRuntime)
39
+ ? "-musl"
40
+ : "";
41
+ const name = `${prefix}-${platform}-${arch}${suffix}`;
42
+ if (!dependencies[name])
43
+ throw new Error(`安装包未提供 ${platform}/${arch} 的原生组件。`);
44
+ return `${name}@${dependencies[name]}`;
45
+ }
46
+
47
+ export async function installCliPackage(id, packageName, run) {
48
+ const name = id === "codex" ? "Codex" : "Claude Code";
49
+ const npm = join(dirname(process.execPath), "npm");
50
+ const options = {
51
+ timeout: 20 * 60 * 1000,
52
+ maxBuffer: 4 * 1024 * 1024,
53
+ env: cliEnvironment(),
54
+ };
55
+ let manifest;
56
+ try {
57
+ const { stdout } = await run(
58
+ npm,
59
+ ["view", `${packageName}@latest`, "--json"],
60
+ options,
61
+ );
62
+ manifest = JSON.parse(stdout);
63
+ if (typeof manifest.version !== "string")
64
+ throw new Error("npm 安装信息缺少版本号。");
65
+ } catch (error) {
66
+ throw cliFailure(
67
+ `读取 ${name} 安装信息失败,请查看错误详情后重试。`,
68
+ error,
69
+ );
70
+ }
71
+ const native = nativeCliDependency(id, manifest);
72
+ if (native) {
73
+ const directory = await mkdtemp(join(tmpdir(), "claudex-cli-native-"));
74
+ try {
75
+ // 平台二进制虽由上游声明为 optional,完整下载是 CLI 可用的前提。
76
+ await run(
77
+ npm,
78
+ [
79
+ "install",
80
+ "--prefix",
81
+ directory,
82
+ "--no-save",
83
+ "--package-lock=false",
84
+ "--ignore-scripts",
85
+ "--no-audit",
86
+ "--no-fund",
87
+ native,
88
+ ],
89
+ options,
90
+ );
91
+ } catch (error) {
92
+ throw cliFailure(
93
+ `${name} 原生组件下载失败,请检查服务器网络或代理后重试。`,
94
+ error,
95
+ );
96
+ } finally {
97
+ await rm(directory, { recursive: true, force: true });
98
+ }
99
+ }
100
+ try {
101
+ await run(
102
+ npm,
103
+ [
104
+ "install",
105
+ "--global",
106
+ "--include=optional",
107
+ "--ignore-scripts=false",
108
+ `${packageName}@${manifest.version}`,
109
+ ],
110
+ options,
111
+ );
112
+ } catch (error) {
113
+ throw cliFailure(`${name} 安装失败,请查看错误详情后重试。`, error);
114
+ }
115
+ return manifest.version;
116
+ }