用途:本技能用于在本地安全地引导用户配置和校验蝉镜(Chanjing)的 AK/SK 与 Token,避免在对话中暴露密钥。当用户需要配置或获取蝉镜密钥、或在调用蝉镜 API 前发现凭证缺失/失效时使用。它是本地凭证引导工具,不是跨技能的运行时依赖。
主要能力:检查本地 AK/SK 是否存在;缺失时打开登录页并提示用户本地配置;检查 Token 是否存在且未过期,必要时调用接口刷新并写回;提供状态查看与获取有效 Token 的脚本。
使用方式:运行依赖 python3 及 scripts/chanjing_config.py、scripts/open_login_page.py、scripts/chanjing_get_token.py 等脚本。常用命令:clawhub run chanjing-credentials-guard;python skills/chanjing-credentials-guard/scripts/chanjing_config.py --status;设置 AK/SK:python scripts/chanjing_config.py --ak <your_app_id> --sk <your_secret_key>;打开登录页:python skills/chanjing-credentials-guard/scripts/open_login_page.py;获取 Token:python skills/chanjing-credentials-guard/scripts/chanjing_get_token.py。凭证存储于 ~/.chanjing/credentials.json(目录可由 CHANJING_OPENAPI_CREDENTIALS_DIR 覆盖,兼容 CHANJING_CONFIG_DIR),格式含 app_id、secret_key、access_token、expire_in(Unix 时间戳)。Token 有效期约 24 小时,建议提前 5 分钟刷新。
适用场景:用户明确要求生成/获取蝉镜密钥或配置 AK/SK;调用蝉镜 API 前凭证缺失或无效需恢复本地配置。
限制与安全边界:仅处理本地凭证引导,不需要安装钩子或系统级权限,不应自动执行无关技能,不接受通过聊天内容传入 AK/SK。若用户仍在对话中分享密钥,应提醒轮换密钥并继续仅用本地命令流程。Token 接口为 POST https://open-api.chanjing.cc/open/v1/access_token,成功 code 为 0,否则表示 AK/SK 无效或请求失败。其它蝉镜技能可复用同一本地配置路径与格式,但应保留各自的运行时鉴权逻辑。