[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-81331":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":15,"stars7d":15,"stars30d":12,"stars90d":14,"forks30d":14,"starsTrendScore":16,"compositeScore":17,"rankGlobal":9,"rankLanguage":9,"license":9,"archived":18,"fork":18,"defaultBranch":19,"hasWiki":20,"hasPages":18,"topics":21,"createdAt":9,"pushedAt":9,"updatedAt":22,"readmeContent":23,"aiSummary":24,"trendingCount":14,"starSnapshotCount":14,"syncStatus":25,"lastSyncTime":26,"discoverSource":27},81331,"CLIProxyAPI-Pro","ssfun\u002FCLIProxyAPI-Pro","ssfun","CLIProxyAPI Pro is a minimal customization-layer for CLIProxyAPI with SQLite usage service and account-inspection scheduler.",null,"TypeScript",48,6,42,0,4,12,50.14,false,"main",true,[],"2026-06-12 04:01:32","# CLIProxyAPI Pro\n\nCLIProxyAPI Pro 是对两个 upstream 项目的最小化定制层集合：\n\n- `cliproxyapi-pro-core\u002F`：基于 `router-for-me\u002FCLIProxyAPI` 的后端 Docker 构建定制。\n- `cliproxyapi-pro-management\u002F`：基于 `router-for-me\u002FCli-Proxy-API-Management-Center` 的前端管理中心定制。\n\n本项目不维护 upstream 的完整 fork，而是维护可重复应用的 patch、overlay 和构建流程。发布时会拉取 upstream 最新 release，应用本项目定制层，再生成 Pro 版本产物。\n\n## 核心特色\n\n- 持久化保存请求数据，支持导入、导出、webdav 备份\n- 账号巡检支持 Codex、Claude、Antigravity、Gemini CLI、Kimi、xAI\n- 账号巡检结果（配额和账号异常状态）支持持久化到配额管理和认证文件\n- 账号巡检支持自动化启用、禁用、删除、主动刷新令牌\n- 账号巡检针对 Antigravity 软封禁（有配额，但是无法请求）提供深度检测\n\n## 项目结构\n\n```text\n.\n├── cliproxyapi-pro-core\u002F\n│   ├── Dockerfile\n│   ├── entrypoint.sh\n│   ├── embeddedusage\u002F\n│   └── patches\u002F\n│\n├── cliproxyapi-pro-management\u002F\n│   ├── apply.sh\n│   ├── apply_customizations.py\n│   ├── monitoring-locales.json\n│   └── overlay\u002F\n│\n└── .github\u002Fworkflows\u002F\n    ├── release-core.yml\n    └── release-management.yml\n```\n\n## 子项目说明\n\n### cliproxyapi-pro-core\n\n后端定制层，用于构建 Pro Docker 镜像。\n\n主要能力：\n\n- 构建 upstream CLIProxyAPI release 的多架构 Docker 镜像。\n- 构建与 upstream 平台和打包格式一致的 Pro 二进制 release 资产。\n- 内嵌 SQLite usage service。\n- 暴露 `\u002Fv0\u002Fmanagement\u002Fusage` 系列 API，包括状态、增量事件轮询和 SSE 流。\n- 支持 usage JSONL\u002FNDJSON 导入导出，包含 usage events、模型价格、quota cache 和账号巡检调度。\n- 支持 WebDAV usage 备份恢复。\n- 支持 SQLite-backed quota cache。\n- 支持模型价格持久化。\n- 启动时强制写入必要 upstream 配置：`usage-statistics-enabled=true` 和 Pro 管理面板仓库。\n- 支持后端账号巡检调度器和执行器，巡检探测前可刷新 token。\n- 支持 Komari agent 可选启动。\n- 将 `\u002F` 跳转到 `\u002Fmanagement.html`。\n- 增强 `\u002Fhealthz` 返回信息。\n\n详见：\n\n- `cliproxyapi-pro-core\u002FREADME.md`\n- `cliproxyapi-pro-core\u002FREADME_EN.md`\n\n### cliproxyapi-pro-management\n\n前端管理中心定制层，用于生成单文件 `management.html`。\n\n主要能力：\n\n- 新增 `\u002Fmonitoring` 请求监控页面。\n- 新增 `\u002Faccount-inspection` 账号巡检页面。\n- 请求量、成功率、延迟、token 和成本统计。\n- 模型价格 SQLite 持久化。\n- quota cache SQLite 持久化。\n- 配额卡片缓存时间显示和单卡刷新。\n- 对接后端账号巡检，负责运行控制、状态轮询、结果展示和操作确认。\n- 认证文件页面可显示巡检写入的 `last_error` 健康消息。\n- 账号巡检结果表格的刷新\u002F重检操作会反馈令牌刷新结果或重检后的业务判定。\n- 账号禁用、启用、删除建议与执行。\n- 多语言文案补丁。\n- 最小化 overlay + patch 应用流程。\n\n详见：\n\n- `cliproxyapi-pro-management\u002FREADME.md`\n- `cliproxyapi-pro-management\u002FREADME_EN.md`\n\n## 界面预览\n\n\u003Cdiv align=\"center\">\n\n### 请求监控\n![请求监控](assets\u002F01.png)\n\n### 请求监控\n![请求监控全览](assets\u002F02.png)\n\n### 账号巡检\n![账号巡检全览](assets\u002F03.png)\n\n\u003C\u002Fdiv>\n\n更多预览请查看 assets 目录。\n\n## 前后端关系\n\n`cliproxyapi-pro-management` 的部分功能依赖 `cliproxyapi-pro-core` 提供的增强 management API。\n\n核心依赖接口包括：\n\n```text\n\u002Fv0\u002Fmanagement\u002Fusage\n\u002Fv0\u002Fmanagement\u002Fusage\u002Fstatus\n\u002Fv0\u002Fmanagement\u002Fusage\u002Fevents\n\u002Fv0\u002Fmanagement\u002Fusage\u002Fstream\n\u002Fv0\u002Fmanagement\u002Fusage\u002Fexport\n\u002Fv0\u002Fmanagement\u002Fusage\u002Fimport\n\u002Fv0\u002Fmanagement\u002Fusage\u002Fquota-cache\n\u002Fv0\u002Fmanagement\u002Fusage\u002Fmodel-prices\n\u002Fv0\u002Fmanagement\u002Fusage\u002Fsettings\n\u002Fv0\u002Fmanagement\u002Faccount-inspection\u002Fschedule\n\u002Fv0\u002Fmanagement\u002Faccount-inspection\u002Fstatus\n\u002Fv0\u002Fmanagement\u002Faccount-inspection\u002Flogs\n\u002Fv0\u002Fmanagement\u002Faccount-inspection\u002Frun\n\u002Fv0\u002Fmanagement\u002Faccount-inspection\u002Fpause\n\u002Fv0\u002Fmanagement\u002Faccount-inspection\u002Fresume\n\u002Fv0\u002Fmanagement\u002Faccount-inspection\u002Fstop\n\u002Fv0\u002Fmanagement\u002Faccount-inspection\u002Factions\n```\n\n账号巡检只由后端执行。管理端负责配置调度、启动和控制巡检、轮询状态\u002F进度\u002F结果，通过 WebSocket\u002FWSS 接收日志和实时状态，并确认手动操作。\n\n后端巡检时，如果认证记录本来已经进入正常刷新窗口，会在配额\u002F账号探测前尝试刷新 token。巡检刷新路径会跳过 API key 账号、未到刷新窗口的账号，以及仍受 `NextRefreshAfter` 限制的账号；disabled 账号允许刷新。刷新成功后使用刷新后的 auth 继续探测；刷新失败时保留该账号，并跳过该账号本次探测。\n\n后端启动时会强制 `usage-statistics-enabled=true` 和 `remote-management.panel-github-repository=https:\u002F\u002Fgithub.com\u002Fssfun\u002FCLIProxyAPI-Pro`，并且只在加载到的配置不一致时同步回写 `config.yaml`。\n\n如果只使用 upstream 后端，管理端中的请求监控、SQLite 持久化、模型价格和后端账号巡检等功能会显示错误或空数据。\n\n## 发布流程\n\n### 统一 Pro Release 发布\n\nWorkflow：\n\n```text\n.github\u002Fworkflows\u002Frelease-core.yml\n```\n\nRelease 版本号以 upstream core 版本为准，并追加 `-pro` 后缀。\n\n示例：\n\n```text\nv7.1.18-pro\n```\n\n流程概览：\n\n1. 检查 upstream `router-for-me\u002FCLIProxyAPI` 最新 release。\n2. 计算 Pro release tag，例如 `v7.1.18-pro`。\n3. checkout upstream core 和 upstream management 最新 release。\n4. 应用 core patch，构建并推送 Docker 镜像。\n5. 使用 GoReleaser 构建 Pro 二进制资产。\n6. 应用 management 定制层，构建单文件 `management.html`。\n7. 创建或更新当前仓库的 GitHub Release，并上传二进制、`checksums.txt` 和 `management.html`。\n8. release notes 同时包含 core upstream 和 management upstream 的版本映射与 release notes。\n9. 执行 WebDAV usage 备份、Render 部署触发、Telegram 通知和 workflow run 清理。\n\nDocker 镜像 tag 使用 Pro release tag：\n\n```text\nlatest\nv7.1.18-pro\n```\n\nDocker 构建参数中 `CLIPROXY_VERSION` 用于下载 upstream core tag，`CLIPROXY_BUILD_VERSION` 用于写入运行时版本号，因此镜像和二进制显示的版本是 `v7.1.18-pro`，但源码仍来自 upstream `v7.1.18`。\n\n二进制资产平台和压缩格式与 upstream CLIProxyAPI 保持一致，版本号使用 Pro release tag，因此资产名前缀保持为 `CLIProxyAPI`：\n\n```text\nCLIProxyAPI_7.1.18-pro_linux_amd64.tar.gz\nCLIProxyAPI_7.1.18-pro_linux_aarch64.tar.gz\nCLIProxyAPI_7.1.18-pro_darwin_amd64.tar.gz\nCLIProxyAPI_7.1.18-pro_darwin_aarch64.tar.gz\nCLIProxyAPI_7.1.18-pro_freebsd_amd64.tar.gz\nCLIProxyAPI_7.1.18-pro_freebsd_aarch64.tar.gz\nCLIProxyAPI_7.1.18-pro_windows_amd64.zip\nCLIProxyAPI_7.1.18-pro_windows_aarch64.zip\nchecksums.txt\nmanagement.html\n```\n\n归档内 README 使用本仓库的 `README.md` 和 `README_EN.md`。\n\n### Management 资产更新\n\nWorkflow：\n\n```text\n.github\u002Fworkflows\u002Frelease-management.yml\n```\n\n该 workflow 不再创建独立 release。它只负责在 management upstream 更新时重建 `management.html`，并上传覆盖到当前仓库 latest release。\n\n流程概览：\n\n1. 检查 upstream `router-for-me\u002FCli-Proxy-API-Management-Center` 最新 release。\n2. 读取当前仓库 latest release notes 中记录的 management upstream 版本。\n3. 如果 management upstream 更新，或 latest release 缺少 `management.html`，则 checkout management upstream 最新 release。\n4. 应用 `cliproxyapi-pro-management` 定制层。\n5. 执行 `npm ci` 和 `npm run build`。\n6. 将 `dist\u002Findex.html` 重命名为 `management.html`。\n7. 上传覆盖当前 latest release 中的 `management.html`。\n8. 更新 release notes 中的 management 版本映射和 release notes。\n\n这样 `remote-management.panel-github-repository=https:\u002F\u002Fgithub.com\u002Fssfun\u002FCLIProxyAPI-Pro` 仍然可以通过 GitHub `\u002Freleases\u002Flatest` 获取到最新 `management.html`。\n\n## 本地构建\n\n### 构建 core Docker 镜像\n\n已发布镜像：\n\n```bash\ndocker pull sfun\u002Fcliproxyapi-pro:latest\n```\n\n本地构建：\n\n```bash\ndocker build -t cliproxyapi-pro .\u002Fcliproxyapi-pro-core\n```\n\n指定 upstream release：\n\n```bash\ndocker build \\\n  --build-arg CLIPROXY_VERSION=v7.1.18 \\\n  --build-arg CLIPROXY_BUILD_VERSION=v7.1.18-pro \\\n  -t cliproxyapi-pro:v7.1.18-pro \\\n  .\u002Fcliproxyapi-pro-core\n```\n\n### 应用 management 定制层\n\n```bash\n.\u002Fcliproxyapi-pro-management\u002Fapply.sh \u002Fpath\u002Fto\u002FCli-Proxy-API-Management-Center\n```\n\n或：\n\n```bash\npython3 .\u002Fcliproxyapi-pro-management\u002Fapply_customizations.py \u002Fpath\u002Fto\u002FCli-Proxy-API-Management-Center\n```\n\n目标目录必须是 upstream management center checkout，并包含：\n\n- `src\u002F`\n- `package.json`\n\n应用后可在目标目录执行：\n\n```bash\nnpm install\nnpm run type-check\nnpm run build\n```\n\n## Runtime 数据目录\n\ncore 镜像默认使用：\n\n```text\n\u002FCLIProxyAPI\u002Fusage\n```\n\n该目录保存：\n\n- usage SQLite 数据库：`usage.sqlite`\n- 账号巡检调度文件：`account-inspection-schedule.json`\n- quota cache\n- model prices\n- monitoring settings\n\nUsage 导入导出会使用 NDJSON 元数据记录保存模型价格、quota cache、监控设置和账号巡检调度，因此 WebDAV 备份恢复可以随 usage events 一起恢复监控相关状态。监控日志保留会在每天服务器本地时间 02:00 自动清理，保存设置时也会立即清理一次；WebDAV 备份可单独设置保留天数，成功备份后会删除过期的 `usage-export-*.jsonl` 文件。\n\n建议在生产环境中为该目录配置持久化 volume。\n\n## 关键环境变量\n\n### Usage service\n\n```text\nUSAGE_SERVICE_ENABLED\nUSAGE_DATA_DIR\nUSAGE_DB_PATH\nUSAGE_BATCH_SIZE\nUSAGE_POLL_INTERVAL_MS\nUSAGE_QUERY_LIMIT\n```\n\n### WebDAV 恢复\n\n```text\nWEBDAV_URL\nWEBDAV_USERNAME\nWEBDAV_PASSWORD\nMANAGEMENT_PASSWORD\n```\n\n### 账号巡检\n\n```text\nACCOUNT_INSPECTION_SCHEDULE_PATH\n```\n\n### Komari agent\n\n```text\nKOMARI_SERVER\nKOMARI_SECRET\n```\n\n完整说明见 `cliproxyapi-pro-core\u002FREADME.md`。\n\n## 设计原则\n\n本项目遵循最小化定制原则：\n\n- 不复制 upstream 完整源码。\n- 尽量通过 overlay 和 patch 注入功能。\n- upstream 更新时重新应用定制层。\n- 文档、脚本和 workflow 尽量保持可验证、可重复。\n\n## 版权与鸣谢\n\n本仓库是围绕 upstream 项目的定制层和发布流程，不声明拥有 upstream 代码、名称或资源的版权。upstream 代码和产物仍保留其原始版权声明和许可证。\n\n- `router-for-me\u002FCLIProxyAPI` 使用 MIT License。其 upstream `LICENSE` 当前声明：\n  - Copyright (c) 2025-2005.9 Luis Pater\n  - Copyright (c) 2025.9-present Router-For.ME\n- `router-for-me\u002FCli-Proxy-API-Management-Center` 使用 MIT License。其 upstream `LICENSE` 当前声明：\n  - Copyright (c) 2026 Router-For.ME\n\n特别鸣谢：\n\n- [router-for-me\u002FCLIProxyAPI](https:\u002F\u002Fgithub.com\u002Frouter-for-me\u002FCLIProxyAPI) — 本项目 core 定制层所基于的 upstream 后端项目。\n- [router-for-me\u002FCli-Proxy-API-Management-Center](https:\u002F\u002Fgithub.com\u002Frouter-for-me\u002FCli-Proxy-API-Management-Center) — 本项目 management 定制层所基于的 upstream 管理 UI 项目。\n- [seakee\u002FCPA-Manager](https:\u002F\u002Fgithub.com\u002Fseakee\u002FCPA-Manager) — 重要的 CLIProxyAPI 管理与监控项目，对 Pro usage、monitoring 和账号巡检方向提供了参考。\n- 感谢 [Linux.do](https:\u002F\u002Flinux.do\u002F) 社区对项目推广与反馈的支持。\n\n## 参考文档\n\n- Core 中文文档：`cliproxyapi-pro-core\u002FREADME.md`\n- Core English README：`cliproxyapi-pro-core\u002FREADME_EN.md`\n- Management 中文文档：`cliproxyapi-pro-management\u002FREADME.md`\n- Management English README：`cliproxyapi-pro-management\u002FREADME_EN.md`\n- English project overview：`README_EN.md`\n","CLIProxyAPI Pro 是一个基于上游项目的最小化定制层，通过引入 SQLite 服务和账号巡检调度功能来增强 CLIProxyAPI 的功能。项目采用 TypeScript 编写，主要特色包括持久化保存请求数据、支持多种账号巡检（如 Codex、Claude 等）、自动化管理账号状态以及深度检测特定平台的软封禁情况。它适合需要对 API 请求进行精细化管理和监控的场景，特别是当用户希望在保持原有系统架构的同时，获得更高级别的控制能力和数据持久性时。此外，该项目通过提供详细的构建流程和定制层，使得开发者能够轻松地将这些增强特性集成到现有的 CLIProxyAPI 部署中。",2,"2026-06-11 04:04:39","CREATED_QUERY"]