FastAI Extensions

FastAI 官方扩展仓库。当前主项目是 fastai-usage-browser，用于在 Chrome / Edge 中查询 FastAI API Key 的权益余额、按量付费余额、账户统计和 API Key 列表。

当前包含

fastai-usage-browser/

Manifest V3 浏览器扩展，支持：

• API Key 直接查询 ${API_ORIGIN}/v1/usage
• 插件专用长期登录，不复用普通网页登录 Cookie
• 查看账户维度统计
• 查看账号下的 API Key 列表，并切换指定 Key 查询用量
• 展示当前 Key 可见的多个权益
• 当 Key 的权益策略和模型组允许时，展示 pay_as_you_go
• Token 数值自动格式化为 K / M / B
• 打包生成商店可上传 zip

仓库结构

.
├── .github/
│   └── workflows/
│       └── release.yml
├── fastai-usage-browser/
│   ├── README.md
│   ├── TUTORIAL.md
│   ├── PUBLISH.md
│   ├── PRIVACY.md
│   └── ...
└── scripts/
    └── build-browser-extension.sh

快速开始

1. 本地加载扩展

Chrome：

1. 打开 chrome://extensions
2. 开启“开发者模式”
3. 点击“加载已解压的扩展程序”
4. 选择 fastai-usage-browser/

Edge：

1. 打开 edge://extensions
2. 开启“开发人员模式”
3. 点击“加载解压缩的扩展”
4. 选择 fastai-usage-browser/

2. 构建发布包

在仓库根目录执行：

./scripts/build-browser-extension.sh

构建产物：

• fastai-usage-browser/dist/
• fastai-usage-browser/release/fastai-usage-browser-v<version>.zip

3. 自动创建 GitHub Release

仓库内置了自动发布工作流：

1. 修改 fastai-usage-browser/manifest.json 中的 version
2. 提交并推送代码
3. 创建并推送同版本 tag，例如 v0.2.1
4. GitHub Actions 会自动打包并把 zip 上传到 Release

工作流会校验：

• tag 必须和 manifest.json 版本一致
• 打包脚本必须成功执行
• Release 资产名必须是 fastai-usage-browser-v<version>.zip

文档入口

• 扩展说明
• 使用教程
• 发布说明
• 隐私说明

开发约定

• 版本号只维护一处：fastai-usage-browser/manifest.json
• 不直接手工压缩工作区，统一走 ./scripts/build-browser-extension.sh
• dist/ 和 release/ 是构建产物，不作为源码编辑目录

License

本仓库使用 MIT License。