轻兔后台对话控制台
通过对话调用轻兔 OpenAPI 控制网站后台。所有调用统一走 scripts/qt_api.mjs。
开始前
- 确认 skill 根目录存在
config.local.json(没有就提示用户照config.local.example.json填base_url/app_id/app_secret)。 - 读
references/auth-and-calling.md了解鉴权、错误码、读-改-写、脱敏规范。 - 读
references/feature-catalog.md定位用户需求对应的接口。
工作流
- 定位接口:先查
references/feature-catalog.md;查不到或字段不清时,用其末尾「补全方法」(Apifox MCP 项目 8399922 / 路由文件 / 控制器源码)兜底。 - 判断读还是写:
- 读(详情/列表/授权链接/小程序码):直接node scripts/qt_api.mjs --path <路径> [--data 参数.json],把结果讲给用户。
- 改设置:走读-改-写——先xxx_setting_detail取现值,改目标字段、其余回填,再xxx_setting_save。
- 其它写(新增/编辑/删除/上下架/提交审核):构造 payload。 - 写前强确认(强制):执行任何写操作前,先向用户展示「将调用的接口路径 + 完整 payload + 相对现值的变更点」,得到明确确认后才运行脚本。删除、微信小程序提交审核等不可逆操作要单独二次确认并说明影响。
- 执行并汇报:运行脚本,按
code/msg判断结果;失败时对照 auth-and-calling.md 的错误码给出处置建议。汇报脱敏(不展示 app_secret/token)。
调用示例
读(授权链接):
node scripts/qt_api.mjs --path /open_api/shop/get_meituan_auth_url
读-改-写(改营地配置,先读):
node scripts/qt_api.mjs --path /open_api/admin/setting/camp_setting_detail
# 基于返回值改目标字段、回填其余,存入 save.json 后:
node scripts/qt_api.mjs --path /open_api/admin/setting/camp_setting_save --data save.json
路径生成小程序码:
echo '{"path":"pages/index/index","type":1}' | node scripts/qt_api.mjs --path /open_api/admin/tools/create_qrcode --data -
图片上传:
node scripts/qt_api.mjs --path /open_api/admin/tools/upload --file ./banner.png --field type=1
安全规则
- 写前强确认 + 读-改-写,见上。
- 凭证脱敏:回复里只说"已用 app_id xxx 连接",不展示 app_secret/token。
- 范围:只做
references/feature-catalog.md覆盖的功能;团购转qingtu-create-goodlife,图片 AI 转qingtu-generate-image。 - 环境由
config.local.json的base_url决定,操作正式环境的写操作风险由强确认兜底。
