SuperAPI AI 工具集

linkfox-onboarding

编程与开发

查看项目

更新于 10-16 00:00

技能介绍

用途:LinkFox 账号与环境的兜底引导技能,只在两种情形下介入——缺 Key/鉴权失败,以及计费不足需要充值。其它 linkfox-* 技能正常时不触发。

主要能力一:缺 Key/鉴权失败引导。触发条件为 errcode=401、错误消息含 authorized error/鉴权失败/未授权/unauthorized,或 LINKFOX_AGENT_API_KEY 与 LINKFOXAGENT_API_KEY 均为空。先执行检测命令 [ -n "$LINKFOX_AGENT_API_KEY$LINKFOXAGENT_API_KEY" ] && echo ok || echo missing,再分流:已配置但 401 时,先提示重启会话使环境变量生效,或前往 https://agent.linkfox.com/ 的「个人中心 → API 设置」复制新 key;未配置时询问用户是否已注册,可自行注册,也可提供手机号走脚本化注册(scripts/send_verify_code.py 发验证码,scripts/login_and_get_key.py 登录并取 key,channel 非 workbuddy 时传 skill)。拿到 key 后按平台配置环境变量:Windows 用 setx LINKFOX_AGENT_API_KEY "你的key";macOS/Linux 用 echo 'export LINKFOX_AGENT_API_KEY="你的key"' >> ~/.zshrc 或 ~/.bashrc 后 source 生效,配置后需重启会话。两种变量名均兼容。

主要能力二:计费不足充值。触发条件为 errcode=402(如积分余额不足)或错误消息命中余额不足、quota exceeded、套餐到期、需充值等关键字;403 不归入。流程为 scripts/list_plans.py 列套餐,按宿主类型选择(支持 AskUserQuestion/ask_user 的用结构化菜单,否则输出编号清单让用户输入序号),再选支付方式(微信/支付宝),执行 scripts/create_order.py <plan_id> <pay_method> 下单,按优先级展示 PNG(Read png_path)、pay_url 点击链接、最后 ascii_qr 兜底。可用 scripts/query_order.py <order_id> 查询支付状态,但不主动轮询。

依赖:Python 3 标准库、requests(pip install requests);二维码由内置 scripts/_qrgen.py 生成,无需 qrcode/pillow。接口契约见 references/api.md。限制:仅覆盖上述两类场景,不处理退订、发票、对账;ASCII 二维码识别受终端字体影响,建议优先 PNG 或链接。