WorkBuddy AMD 免费模型接入

每天 $1（≈¥6.7）免费额度 · 8 个免费大模型 · 注册 1 分钟 · 拿到 Key 后全自动

把 AMD Radeon 免费模型 API（developer.amd.com.cn）一键接入 WorkBuddy。国内可直连、OpenAI 兼容、免费额度每日自动恢复、无需信用卡。本技能负责从「你拿到 token」之后的全部自动化步骤，并内置引导帮你拿到 token。

> 版权声明：本技能为专有软件（Proprietary）。允许在 WorkBuddy 内安装使用；禁止再分发、转售、反编译或用于衍生作品。

为什么值得装

当前可用的免费模型（2026-09-30 实测：9 个，其中 8 个可直接对话）

> 清单是动态的，不是写死的：技能每次安装/同步都直接读网关 /models 实时清单，
> 网关新增、下线或调整模型能力都会自动跟上，无需等待技能更新。
> 免费额度按账号可能不同，quota 子命令直接读网关返回的你账号真实数值，技能不做任何假设。

第一步：注册并拿到 token（你本人操作，约 1 分钟）

本技能不代注册账号，但把注册入口和取 key 的路径写得足够清楚；你走完前两步，剩下的全部自动：

拿到 token 之后，技能自动完成：

校验 token → 从网关实时发现全部可用模型 → 自动判定能力（视觉/工具/上下文）
→ 生成本地中转 → 写入 WorkBuddy 模型库 → 验证生效

> 为什么注册不能代劳：AMD 平台使用 GitHub/邮箱单点登录 + 阿里云人机验证。
> 代为注册违反平台条款，也会被技能市场上的安全审核拦截。
> 本技能的负责范围是「你拿到 token 之后的一切」，这部分是 100% 自动的。

能做什么 / 不做什么

模型库是动态的，不是写死的

技能不维护一份静态模型名单。每次运行都直接读网关 /models 接口，所以：

• 网关新增免费模型 → 重新 install 或 sync 就会出现，不需要等技能更新
• 网关调整某模型的能力（比如新增视觉支持）→ 元数据变了就会跟上

• 网关只提供 /models 时附带完整元数据，技能据此自动判定：
  | 元数据 | 映射到 WorkBuddy 条目 |
  |---|---|
  | architecture.input_modalities 含 image | supportsImages: true |
  | supported_parameters 含 tools | supportsToolCall: true |
  | context_length | maxInputTokens |
  | architecture.output_modalities 不含 text | 判定为非对话模型，自动排除 |

• 非对话模型会被自动识别并排除（例如 MinerU2.5-Pro 的 output 是 ["ocr"]，
  只能走 /v1/ocr 端点，无法当聊天模型用）。技能会把它列出来告诉你，但不会接进 chat。

> ⚠️ 技能内置一份兜底清单，仅在网关 /models 不可达时使用（并会明确提示你）。
> 它只是应急，正常情况永远以网关实时数据为准。

自动更新模型库（sync）

网关上了新模型，你不需要重装技能，也不用重新 install：

python amd_connect.py sync --key rc-你的token

sync 做四件事：

1. 拉取网关最新清单
2. 和你本地已接入的条目对比，列出新出现的模型
3. 刷新 relay 配置里的模型清单
4. 把新模型只增不改地追加进 models.json（已存在的条目一个字段都不动）

顺带会提示你哪些本地模型已不在网关清单里（可能已下架），但不会自动删除 ——
要不要清理由你决定（uninstall 后重装即可）。

让它定期自动跑

可以用系统计划任务定时执行，例如每天一次：

# Windows 计划任务（每天 09:00）
schtasks /create /tn "AMD模型库同步" /tr "python <技能目录>\scripts\amd_connect.py sync --key rc-xxx" /sc daily /st 09:00

# Linux cron / macOS launchd 同理

快速开始

cd <本技能目录>/scripts

# 1) 没 token 先看指引
python amd_connect.py guide

# 2) 校验 token 并列出可用模型
python amd_connect.py verify --key rc-你的token

# 3) 一键接入（自动发现全部可用模型 → 生成中转 → 写配置 → 校验）
python amd_connect.py install --key rc-你的token

# 4) 启动本地中转（另开一个终端，或后台常驻）
python relay.py

# 5) 查看状态
python amd_connect.py status

# 6) 以后网关上了新模型，增量更新（已接入的条目一个字段都不动）
python amd_connect.py sync --key rc-你的token

# 7) 随时查看本账号还剩多少免费额度（金额自动折算成人民币）
python amd_connect.py quota --key rc-你的token

quota 的输出形如（人民币按实时汇率折算）：

每日免费额度    : $1.0000（≈¥6.70）
本周期已用      : $0.0000（≈¥0.00）
本周期剩余      : $1.0000（≈¥6.70）
额度周期        : 每 1 天（24 小时滚动窗口，用满自动恢复）
速率限制        : 20 请求/分钟
汇率            : 1 USD = 6.7046 CNY（新浪财经 在岸人民币，实时）

今日            : 47 次请求 · 653,815 tokens · 花费 $0.0304（≈¥0.204）
近 24 小时按模型：
  DeepSeek-V4-Flash-Vision-Exp      39      653,186     $0.0300     ¥0.201

拿到 token 的两个入口（先注册，再取 key）：

1. 注册 / 登录：<https://developer.amd.com.cn/login?returnUrl=/>（GitHub 或邮箱，免费）
2. 生成 API Key：<https://developer.amd.com.cn/radeon/tokenfactory>（登录后点 Create / Generate Token）

token 形如 rc- 开头的一长串字符。刚生成时可能短暂 401（平台侧延迟），等 2-5 分钟再试。

> 也可以直接跑 python amd_connect.py guide，会把上面两步和「把 token 发到对话里」的完整流程打印出来。

在对话里怎么用（AI 执行流程）

用户把 token 发过来之后，按这个顺序执行：

cd <本技能目录>/scripts

python amd_connect.py verify  --key <token>   # 1) 先确认 token 有效，并列出可用模型与能力
python amd_connect.py install --key <token>   # 2) 写入模型库：自动发现全部可用模型 + 建中转 + 合并配置
python relay.py                               # 3) 启动本地中转（需常驻，否则模型不可用）
python amd_connect.py status                  # 4) 确认生效
python amd_connect.py quota   --key <token>   # 5) 看本账号每日免费额度与剩余（可选）

以后网关上了新模型：

python amd_connect.py sync --key <token>      # 只追加新模型，已接入条目零改动

> ⚠️ install / sync 会直接写入 models.json（命令行不带交互确认）。
> 虽然它只增不改、写入前自动备份、写后断言校验、失败回滚，但 AI 在动手前
> 仍应先向用户说明将要做什么并获得同意；uninstall 建议先加 --dry-run 预览。

各子命令说明

常用参数

为什么需要本地中转

WorkBuddy 的模型列表和选择器显示的文本就是条目 id，而 AMD 网关只认精确模型名
（带前缀一律 404）。所以本技能的做法是：

1. 条目 id 写成 Amd-<网关模型名>（如 Amd-Qwen3.8-Flash-Next），让你在列表里一眼认出是 AMD 平台；
2. 条目 URL 指向本地中转 http://127.0.0.1:<port>/v1；
3. 中转在转发前把 Amd- 前缀剥掉，再发给 AMD 网关。

中转监听在 127.0.0.1（本机回环，不出网卡），开销在毫秒级。
代价：中转进程停了，这些模型就不可用——请让它常驻（见下节）。

保持中转常驻

中转是一个普通 Python 进程，可以用你熟悉的方式常驻：

# 方式 A：后台运行（Windows）
start /b pythonw relay.py

# 方式 B：开机自启（Windows，注册表 Run 键）
#   在「运行」(Win+R) 输入 shell:startup，把下面这一行的快捷方式放进去：
#   pythonw.exe <本技能目录>\scripts\relay.py

# 方式 C：任务计划程序 / systemd（Linux）/ launchd（macOS）

健康检查：python amd_connect.py status，或直接 GET http://127.0.0.1:18733/ping。
返回 {"ok": true, "configured": true} 即为正常。

安全设计（为什么可以放心用）

写入 models.json 的每一步都有护栏：

1. 只增不改 — 只追加本技能的条目，原有条目逐字段原样保留
2. 冲突保护 — 若目标 id 已被非本技能的条目占用（URL 不指向本机中转），
   拒绝覆盖并提示，绝不破坏你已有配置
3. 先备份 — 写入前复制到 workbuddy-model-backups/models.json.<时间戳>.bak
4. 原子写 — 先写 .tmp 再替换，避免中途失败留下半个文件
5. 写完即校验 — 重新读取并断言「条目数正确 + 原有条目逐字段零变化」，
   任一不符立即回滚到备份
6. token 不外传 — 只写入你本机的 relay_config.json，日志与输出一律脱敏
7. 汇率联网是只读的 — 人民币折算需要取汇率，会访问公开汇率接口
   （新浪财经 / 欧洲央行 / exchangerate-api，依次降级），只取汇率数字，
   不发送任何与你有关的信息；结果在本机缓存 6 小时。加 --no-fx 可完全禁止这项联网

常见问题

环境要求

• WorkBuddy 桌面客户端（Windows / macOS / Linux）
• Python 3.8+（仅用标准库，无需 pip 安装任何依赖）
• 可访问 developer.amd.com.cn 的网络

版本记录

v1.2.1

• quota / verify 的金额同时显示美元与人民币（如 $1.0000（≈¥6.70）），
  按模型明细表新增「折合(CNY)」列
• 汇率自动获取，三源依次降级（新浪财经在岸人民币 → 欧洲央行 → exchangerate-api），
  统一做合理区间护栏，取不到就退到本机缓存 / 内置参考值，绝不因此报错
• 汇率结果缓存 6 小时；--rate 手动指定汇率，--no-fx 完全禁止汇率联网

v1.2.0

• 新增 quota 子命令：读取网关官方用量端点，显示本账号每日免费额度、已用、剩余、
  额度周期与速率限制，以及今日 / 近 24 小时 / 累计用量和按模型明细（--json 可输出原始数据）
• verify 顺带显示额度摘要；取不到时仅提示，不影响接入结论
• guide 开头改为先讲「你会得到什么」（额度 + 8 个模型清单），再讲注册步骤
• 技能介绍（SKILL.md / README / LISTING / manifest）突出免费额度与可用模型清单
• 兜底清单补全为实测的 9 个模型（含 OCR 专用模型，会被自动排除）

v1.1.1

• guide 改为三步式指引：明确给出 AMD 官方注册/登录入口与取 key 页面，
  并写明「把 token 发到对话里，剩下全自动」的路径
• 文档新增「第一步：注册并拿到 token」与「在对话里怎么用（AI 执行流程）」两节，
  注册入口在 SKILL.md / README / LISTING 三处均已列出
• 如实标注 install / sync 为无交互确认直接写入，避免文档与代码行为不一致

v1.1.0

• 新增 sync 子命令：增量更新模型库，网关新增模型后只追加新条目，已有条目零改动；
  同时提示已下架的模型（不自动删除）
• install 改为全量自动发现：默认接入网关返回的全部可用模型，不再局限于内置名单
• 能力自动判定：直接读网关元数据得到 supportsImages / supportsToolCall / maxInputTokens，
  不再依赖名称启发式猜测
• 非对话模型自动识别并排除（如 MinerU2.5-Pro 的 output 为 ["ocr"]），
  避免接入后无法使用
• verify 输出能力表（视觉/工具/上下文），中文列宽对齐
• 超时与 429 一律视为「繁忙」而非「不可用」，避免误判导致模型被漏掉
• --port 默认改为沿用已有配置端口，避免把已生效的中转端口改掉

v1.0.0

• 首个版本：guide / verify / discover / install / status / uninstall 六个子命令
• 多上游 relay（配置驱动，支持按前缀分流路由）
• 接入流程内置全套护栏：只增不改、冲突保护、备份、原子写、写后校验与回滚
• token 与日志脱敏，跨平台配置目录自动探测