authconv

authconv 是一个专为管理 ChatGPT 和 Codex OAuth 凭证设计的实用工具，支持在多种主流格式之间进行无损转换。它能够将来自 /api/auth/session 的响应、Codex auth.json、sub2api 导出文件或散装的 Token JSON 归一化，并渲染为 CPA、sub2api、codex2api、Codex-Manager 或 Codex CLI 所需的格式。

该工具严格遵循“本地优先”原则，所有解析、转换和导出操作均在用户设备上完成，绝不上传任何凭据数据，确保了极高的安全性与隐私保护。

核心特性

• 多格式互转：支持 CPA、sub2api、codex2api、Codex-Manager 和 Codex CLI auth.json 之间的相互转换。
• 纯本地运行：CLI 版本不发起任何网络请求；Web 版本的转换逻辑完全在浏览器端执行，零数据上传。
• 灵活的输入支持：支持拖拽或选择 JSON、JSONL、ZIP 文件及文件夹，自动识别输入格式，也可手动指定。
• 聚合与单账号模式：针对 sub2api 和 codex2api 等支持聚合的格式，提供合并输出或按账号独立输出的选项。
• 便捷的 Web 界面：提供在线访问、本地 HTML 打开及本地服务启动三种方式，支持中英文切换及系统明暗主题适配。

使用方式

1. Web 版（无需安装）

• 在线访问：https://ltxgit.github.io/authconv/
• 本地打开：直接双击项目内的 dist/index.html。
• 本地服务：运行 authconv --serve 或 node dist/cli.mjs --serve，默认监听 http://127.0.0.1:8787。

Web 版支持拖拽文件、粘贴文本、预览输出、复制内容及下载 JSON/ZIP 包，功能与 CLI 版保持一致。

2. CLI 版（命令行工具）

安装：

git clone https://github.com/ltxgit/authconv.git
cd authconv
npm ci
npm run build
npm link  # 全局链接 authconv 命令

常用命令示例：

# 基础转换：将 creds.json 转换为所有支持格式，输出到 ./output
authconv creds.json -f all -o out/

# 指定格式：转换为 CPA 格式
authconv creds.json -f cpa -o out/

# 批量处理：转换目录下所有 json/jsonl 文件
authconv accounts/ -f all -o out/

# 通配符支持：批量转换当前目录下的 json 文件
authconv *.json -f cpa

# ZIP 导入：直接处理压缩包
authconv authconv_3-accounts.zip -f cpa

# 输出为 ZIP：将多个格式的转换结果打包为一个 zip
authconv accounts/ -f all --zip -o out/

# JSONL 模式：每行一个账号的 JSON
authconv accounts/ -f cpa --jsonl

# 管道操作：从 stdin 读取并输出到 stdout
cat creds.json | authconv --stdin -f cpa --stdout | jq .

# 预览模式：查看将生成的文件列表而不实际写入
authconv creds.json -f all --dry-run

# 检查模式：仅解析并显示结果，不写文件
authconv creds.json --inspect

聚合格式控制：

# 默认聚合为一个文件
authconv accounts/ -f sub2api

# 每个账号单独输出一个文件
authconv accounts/ -f sub2api --mode sub2api=single

# 将已聚合的文件拆分为单账号文件
authconv merged.json -f sub2api --mode sub2api=single -o out/

适用场景

• 多工具链用户：需要在 CPA、sub2api、Codex CLI 等不同工具间迁移或同步凭证的用户。
• 隐私敏感型用户：希望在不依赖云端服务的情况下安全管理和转换敏感认证信息。
• 自动化工作流集成：通过 CLI 的 stdin/stdout 支持和 JSONL 输出，轻松集成到脚本或 CI/CD 流程中。

authconv 通过提供一个安全、高效且格式兼容的转换层，简化了复杂 AI 工具生态中的凭证管理难题，是开发者和管理员不可或缺的辅助工具。