a2a-token-swap

tokenSwap 结算中心（纯前端）

这是一个纯前端的 React + TypeScript + AntV( @antv/g2plot) 项目，可直接部署到 GitHub 仓库 tokenSwap。项目提供 token 银行与 token 兑换能力，并支持通过 访问链接附加字符串自动解析配置。

特性

• 纯前端实现，不依赖服务端
• 使用 React + TypeScript + Ant Design + AntV
• 自动解析 URL 配置，提取：apiKey / baseUrl / 支持模型 / token 数量
• 默认以 gpt-5.5-medium 作为结算基准
• 本地持久化记录每组配置下的余额与兑换记录（localStorage）
• 兑换后用图表和表格可视化余额变化

本地运行

npm install
npm run dev

构建

npm run build
npm run preview

GitHub Pages 部署

# 使用你自己的仓库名，示例：mappedinfo/tokenSwap
npm run build

然后把 dist/ 目录发布到 GitHub Pages（可手动上传或使用 gh-pages/Workflow）。

自动发布（推荐）

本仓库已经新增了 GitHub Actions：

• 文件：.github/workflows/deploy-gh-pages.yml
• 触发：main 分支 push 或手动触发
• 流程：npm ci -> npm run build -> 同步 dist 到 gh-pages
• 默认会按仓库名 /tokenSwap/ 作为 base，如果你仓库名不同可改：
  • vite.config.ts 的 GH_PAGES_BASE_PATH / VITE_BASE_PATH
  • workflow 里的 env: GH_PAGES_BASE_PATH: /你的仓库名/

URL 自动配置约定

页面启动时会自动读取如下来源：

1. 查询参数 ?cfg=... 或 ?config=...
2. 原始查询字符串（https://.../?<payload>）
3. hash 字符串（https://.../#<payload>）

支持两种 payload：

1) Base64/URL-safe Base64 编码 JSON

{
  "profileName": "team-a",
  "apiKey": "sk-xxxx",
  "baseUrl": "https://api.openai.com/v1",
  "models": [
    { "id": "gpt-5.5-medium", "rate": 1 },
    { "id": "gpt-4o", "rate": 1.15 }
  ],
  "tokenQuota": 50000,
  "initialBalances": {
    "gpt-5.5-medium": 30000,
    "gpt-4o": 10000
  }
}

例如拼接：

https://your-domain/#eyJwcm9maWxlTmFtZSI6InRlYW0tYSIsImFwaUtleSI6InNrLXh4Iiw... 

2) 简化短串

<apiKey>|<baseUrl>|<model1:rate,model2:rate>|<totalToken>|<model1:balance,model2:balance>

示例：

aaa|https://api.openai.com/v1|gpt-5.5-medium:1,gpt-4o:1.15|50000|gpt-5.5-medium:20000

也可以粘贴到页面中的「手动解析」输入框。

说明

• 本项目不持久传输 API Key，解析行为发生在前端；但请注意 URL 上明文包含 API Key 会有安全风险，请仅用于测试与演示。

配套命令行工具（a2a）

为了实现“赠予逻辑”中的密钥交换，项目增加了一个通用 CLI：a2a（scripts/a2a.js）。

用途：

• 用对方公钥加密配置（礼物发起方）
• 对方用自己的私钥解密配置（领取方）
• 生成 RSA 公/私钥对

安装与运行

npm install
npm run a2a -- --help

典型流程

1. 生成公私钥（发送方或接收方）：

npm run a2a -- keygen --public keys/receiver_public.pem --private keys/receiver_private.pem

2. 发送方用接收方公钥加密 JSON 配置：

npm run a2a -- gift --public keys/receiver_public.pem --in token-config.json > encrypted.txt

3. 接收方用自己的私钥解密：

npm run a2a -- open --private keys/receiver_private.pem --in encrypted.txt

输出格式

• 默认输出为 Base64URL（可直接贴到 cfg=... 参数中）
• 为兼容更大体积内容，命令会按 RSA 分块加密，密文由多段 . 分隔组合

说明：该 CLI 使用 RSA + OAEP(SHA-256)，属于经典的“公钥加密、私钥解密”模型，适合用于配置/小对象共享场景。更大对象可先压缩或签名再加密。

Python 版 a2a（可发布到 PyPI）

在仓库根目录新增了 Python CLI，功能与 Node 版参数与行为对齐：

• keygen：生成 public/private RSA PEM 密钥对（SPKI + PKCS8）
• gift（alias encrypt）：用公钥加密
• open（alias decrypt）：用私钥解密
• 输出/输入使用 Base64URL，多段密文用 . 分隔

打包与本地可执行

python -m pip install build twine
python -m build
python -m pip install .

a2a --help

发布到 PyPI

python -m build
python -m twine upload dist/*

一键发布脚本（推荐）

已新增 scripts/release_py.sh，支持一键执行：版本 bump + 构建 + 上传。

./scripts/release_py.sh
./scripts/release_py.sh minor
./scripts/release_py.sh major

说明：

• 默认执行 patch 递增
• 支持参数 patch、minor、major
• 自动读取 .env 中的：
  • TWINE_USERNAME=__token__
  • TWINE_PASSWORD=<你的 PyPI token>
• 发布前会清理旧 dist/，再执行 python -m build
• 发布后会把新版本写入 pyproject.toml

示例（与 Node 行为一致）

a2a keygen --public keys/bob_public.pem --private keys/bob_private.pem

a2a gift --public keys/bob_public.pem --in token-config.json > encrypted.txt

a2a open --private keys/bob_private.pem --in encrypted.txt

小贴士：Node 版也使用同一套命令和分块 OAEP 规则，因此两端可互相加解密。