用途:帮助开发者排查 Meta 访问令牌为什么会失败,全程不接触原始令牌。访问令牌属于持有者凭证(bearer credential),一旦粘贴进对话就会进入智能体上下文并传输给 AI 提供方,因此该技能把“不索取、不接收、不回显令牌或应用密钥”作为安全底线。
主要能力: 一、确认症状。询问错误码与子码(如 190/463)、失败的端点或请求、调用所用应用以及令牌预期具备的权限。 二、引导开发者自行检查令牌,提供两种方式: A. 网页版 Access Token Debugger:在 https://developers.facebook.com/tools/debug/accesstoken/ 粘贴令牌并读取结果面板; B. 随附脚本 scripts/debug_token_probe.py 调用 debug_token Graph API,从环境变量读取令牌与应用密钥(只按名称引用,不读取值),仅输出脱敏元数据。脚本仅依赖 Python 3 标准库,无需安装额外包。 三、只索要脱敏元数据:is_valid、type、app_id、application、issued_at、expires_at、data_access_expires_at、scopes/granular_scopes 及 error.code/subcode/message,并要求隐去 user_id 与个人资料 ID。 四、解读元数据并给出诊断与修复建议,涵盖会话过期、令牌无效或被撤销、短期令牌过期、缺少所需权限、app_id 与调用应用不符、令牌类型与端点不匹配等常见情况。 五、在需要精确的最新步骤时,可通过 Meta Social Technologies MCP 服务器(https://mcp.facebook.com/devtools,streamable-http)的 devtools_discovery 工具(action search_docs)查询官方文档;插件安装会自带该连接,仅用 npx skills add 等仅安装技能的方式则不带该工具,此时跳过查询而不是臆造结果。
使用方式:开发者在自己的终端中设置环境变量并运行脚本,例如 bash 下用 read -rsp 提示输入令牌与应用密钥,zsh 下用 read -rs 'FB_INPUT_TOKEN?Access token: ' 形式;随后 export FB_APP_ID 与 FB_INPUT_TOKEN、FB_APP_SECRET,执行 python3 <skill-dir>/scripts/debug_token_probe.py,结束后 unset 相关变量。建议在一次性 shell 中运行,不要用启动智能体的同一个 shell,以免导出的变量被后续进程继承。脚本输出示例为不含令牌、密钥和 user_id 的 JSON,仅含校验结果与过期、权限等字段。
适用场景:Meta 相关接口调用报 OAuth 错误、令牌权限不足、换了应用或令牌类型不对、需要确认过期时间等排查工作;也可作为接入前检查令牌类型的参考(相关技能:/api-integration、/api-health)。
限制:不接收实时令牌输入,不索取应用密钥,不回显或存储令牌,也不代开发者执行读取、导出或脚本命令;因此诊断完全依赖开发者自行运行并回传的脱敏元数据。若无法运行 debug_token,可使用无需配置的网页版调试器。错误码 190 为通用 OAuthException,必须结合子码判断(463 表示过期,467 表示无效等)。安装方式、插件打包细节与 MCP 配置步骤在资料中仅作简要提示,具体安装命令与完整配置暂未提供。