SuperAPI AI 工具集

debug-access-token

测试与质量

查看项目

更新于 10-15 21:40

技能介绍

用途:帮助开发者排查 Meta 访问令牌为何失败,例如过期、权限范围(scopes)不对、应用不匹配或令牌无效。核心安全原则是访问令牌属于持有者凭证,绝不要求开发者把令牌或应用密钥粘贴进对话,因为内容会进入智能体上下文并传给 AI 提供方。

主要能力:先确认症状(错误码与子码,如 190/463、失败的端点、调用所用应用、期望的权限)。随后让开发者自行检查令牌,提供两种方式:一是网页版 Access Token Debugger(https://developers.facebook.com/tools/debug/accesstoken/);二是技能自带的脚本 scripts/debug_token_probe.py,通过环境变量名读取令牌与应用密钥,仅输出脱敏元数据。最后只索取脱敏后的元数据(is_valid、type、app_id、application、issued_at、expires_at、data_access_expires_at、scopes/granular_scopes 及 error 信息),并提示隐去 user_id 等身份标识。

使用方式:脚本仅需 Python 3 标准库。开发者应在一次性 shell 中运行,先以隐藏输入方式读取两个密钥(bash 用 read -rsp,zsh 用 read -rs),再 export FB_APP_ID、FB_INPUT_TOKEN、FB_APP_SECRET,然后执行 python3 <skill-dir>/scripts/debug_token_probe.py,最后 unset 相关变量。脚本路径需用绝对路径。

适用场景与限制:适用于令牌排错与权限核对。技能不会接收、回显或存储任何令牌与密钥,也不代替开发者运行命令;若令牌已被粘贴,应提示先撤销/轮换。错误码 190 为通用 OAuthException,需靠子码区分(463 过期、467 无效等)。若无法运行 debug_token,可先用网页调试器。具体收费、价格与平台支持等资料暂未提供。