从 Tauri 桌面控制台重构而来的纯 Web 小工具：统一管理多台机器上的 Codex CLI 与 Claude Code，全部走 npm 安装与更新。
- 深度探测（只读）：枚举各主机 codex / claude 的全部安装实例——逐条 PATH、登录/交互双 shell 上下文、nvm/fnm/mise 等已知路径、官方包根（含 daemon 进程反推自定义 CODEX_HOME）；
--version失效时按 package.json 兜底取版本；桌面版私带 CLI 标记豁免 - 版本缓存：仅 hub 本机查外网（codex：GitHub atom → api.github → releases.openai.com 降级链；claude：GCS stable/latest 双通道），默认 6 小时间隔（可配），启动时按上次检查时间决定；代理模板（socks5h 含认证内嵌）/ GitHub 镜像 / token 可配
- 安装/切换：官方同构布局（releases/- + current 链接 + installDir 入口），sha256 校验（codex 走 SHA256SUMS 链），远程可直连则直连、否则 hub 下载后经 SSH 中转推送；installDir 必填可自定义（默认 ~/.local/bin，主机级覆盖），安装前 PATH 预检（逐上下文位置 + 遮蔽者清单 + 共享挂载警告）
- 自动更新接管：安装独立二进制时按设置写入目标机配置——codex 的
check_for_update_on_startup/[features] daemon_auto_start/ daemonupdater.autoUpdateEnabled，claude 的autoUpdatesChannel/env.DISABLE_AUTOUPDATER/ 固定版本时的minimumVersion；默认全部禁用（含 codex 启动更新提示），统一由 hub 更新 - 清理：保留 current + 最新 2 个版本，跳过运行中进程占用（远程 /proc、本机进程路径）
- PATH 修复（可选，显式触发）：远程写入「去重置顶」幂等块（
.profile+ shell rc，自动备份），本机写注册表用户 PATH（备份到 data/path-backups/） - npm 兜底：策略切到 npm 时沿用原有更新链路（rename 失败清理重试）
- 主机清单自动发现：本机（Windows / pwsh）+
~/.ssh/config中的 SSH 主机，按排除模式过滤（默认排除github.com，可在设置中追加内部主机的排除模式） - 状态检查：各主机 codex / claude 当前版本 + npm registry 最新版本，一眼看出哪台该更新
- npm 更新：
npm install -g @openai/codex@latest/@anthropic-ai/claude-code@latest- 遇到
rename ... failed（EPERM/ENOENT）时，自动删除报错涉及的 npm 全局目录并重试一次（仅限npm root -g之内的路径，防止误删） - 若因 app-server 占用文件导致失败，日志中会提示先重启 app-server
- 遇到
- 重启 app-server：结束后端
codex app-server进程；Codex desktop 重连时会自动拉起新版本，更新从而生效。按钮位于 Codex 列（与 Claude Code 无关），支持批量重启 - 批量更新：勾选多台主机批量更新，或一键更新全部有新版的主机（自动跳过已最新/未安装）；同一时刻只允许一种工具批量执行（npm 全局目录互斥）
- 主题切换：浅色（淡黄科技感）/ 深色 / 跟随系统，localStorage 持久化
- 稳定布局：表格列宽固定、版本号等宽字体占位，状态变化不引起按钮位移
- 实时日志：任务输出通过 SSE 推送到页面
- 每主机 prelude：远程命令前执行的 shell 片段（如 nvm 加载、代理开启），可在页面“编辑”中覆盖
- 模型目录（models.json）管理：集中维护各来源的模型 catalog（
data/catalogs/models.*.json），合并后一键推送到多台主机models.oai.json为内置官方 catalog，从 GitHub 源地址在线下载（可在目录页改源地址），合并时强制use_responses_lite=false（可关）- 自定义 catalog（如 kimi / glm / deepseek）在页面用 CodeMirror JSON 编辑器在线编辑、校验、格式化，保存时规范化（按 slug 排序）并留
.bak备份 - 各文件按 priority 分段管理（如 oai 0-100、glm 100-200），「重排」可按起点顺次重写编号
- 合并预览：模型总数、hash、较上次推送的新增/删除/变化、slug 冲突清单（冲突时 OAI 胜出，与
update_models_catalog.py语义一致） - 推送前自动检测目标机
config.toml的model_catalog_json：未开启或路径不一致的主机禁用推送并悬停提示原因（不强制改写配置） - 推送 = 原子写入目标路径（默认
~/.codex/models.json）+\rm -f删除models_cache.json，可选推送后重启 app-server；支持勾选多台批量推送
npm install
# 开发（API :8722 + Vite :5173 热更新）
npm run dev
# 生产（构建前端后由后端直接托管）
npm run build
npm start打开 http://127.0.0.1:8722 （开发时 http://127.0.0.1:5173）。
PM2 配置见根目录 ecosystem.config.cjs，生产部署监听 0.0.0.0:8123。
| 环节 | 本机 Windows | SSH 远程 Linux |
|---|---|---|
| 执行层 | pwsh -EncodedCommand（UTF-16LE base64） |
ssh host "echo <b64> | base64 -d | bash"，规避多层引号转义 |
| node/npm 定位 | 系统 PATH | 自动 prepend ~/.nvm/versions/node/*/bin（最高版本优先），再叠加主机 prelude |
| 版本检查 | codex --version / claude --version + npm view <pkg> version |
同上（在远程执行，尊重其网络/代理） |
若某主机 nvm 不在默认 HOME、或 npm 需要代理，可在页面「编辑」中为该主机配置 Shell prelude（远程命令前执行），例如：
export NVM_DIR=/path/to/your/nvm
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"
source <(curl -sSL https://example.com/setup_proxy.sh) >/dev/null 2>&1 || trueserver/ Express 后端（无构建步骤）
index.mjs API / SSE / 静态托管
hosts.mjs 主机清单（ssh config 解析 + 覆盖）
tools.mjs 检查 / 更新 / 重启 / catalog 推送的领域逻辑与脚本构建
catalogs.mjs 模型 catalog 存储、校验、合并、OAI 下载、优先级重排
exec.mjs 本机 pwsh 与远程 ssh 执行层（支持 stdin 传输 payload）
store.mjs data/config.json 与 state.json 持久化
tasks.mjs 任务与实时日志
src/ React 前端（主机管理 / 模型目录 两页，目录页按需加载 CodeMirror）
data/ 运行时配置与状态快照（不入库）
catalogs/ models.*.json 模型目录文件（不入库）
npm start默认只绑定127.0.0.1；PM2 生产部署（ecosystem.config.cjs）绑定0.0.0.0:8123。本工具能以你的身份在各主机执行命令，仅在受信内网使用，切勿暴露公网（详见部署文档）。- SSH 全部走
~/.ssh/config的既有配置与免密登录（BatchMode=yes），不存储任何密码。
npm run typecheck # 前端 TS 检查
node --check server/*.mjs # 后端语法检查
node scripts/ui-smoke.mjs # UI 冒烟（需要本机 Edge，npx playwright install chromium）
node scripts/ui-smoke-catalogs.mjs # 模型目录页 UI 冒烟