用途:该技能用于对接 ALAPI 的完整 OpenAPI 接口目录,避免每次手工解析 schema。它打包了原始 OpenAPI 源、生成的端点目录、鉴权指南和可复用的请求脚本。
主要能力:内置 references/intent-router.md 用于把用户请求映射到最可能的端点;references/api-catalog.md 提供逐端点说明与请求 schema;references/openapi-source.json 为 OpenAPI 事实来源;scripts/alapi_request.py 用于发送带鉴权的真实请求;scripts/generate_references.py 可在 OpenAPI 源变化后重新生成参考文档。
使用方式:先确认 ALAPI_TOKEN 是否可用,可运行 printenv ALAPI_TOKEN。若缺失,提示用户到 https://apifox.com/apihub/ 申请或管理 token,并请其回传;收到后按当前 shell 持久化(zsh 追加到 ~/.zshrc,bash 追加到 ~/.bashrc),并在当前会话 export,避免在日志中回显。鉴权使用请求头 token: $ALAPI_TOKEN,基础地址为 https://v3.alapi.cn,所有端点均为 POST,请求体为 application/json。先用 intent-router 定位端点,再只打开对应目录条目,调用时使用 alapi_request.py。可用 rg '^### /api/' references/api-catalog.md 快速跳转路径。
回答规范:明确所选端点路径、说明匹配原因、列出必需 JSON 字段、说明鉴权依赖 ALAPI_TOKEN,并概述响应而非直接倾倒原始 JSON,除非用户要求完整载荷。
限制:不要为真实请求编造或复用占位 token;OpenAPI 源变更时需替换 references/openapi-source.json 并重跑生成脚本。具体接口清单、计费与配额等资料暂未提供。