Back to skills
extension
Category: OtherAPI key required

轻兔商户端

当用户想通过对话查询或修改轻兔网站后台功能时使用。覆盖门店设置、分销、会员卡/等级/积分/储值/优惠券/积分商城、微信小程序提交审核、美团点评与抖音来客授权链接、图片上传、路径生成小程序码等;团购与图片 AI 生成转用对应专用 skill。

personAuthor: user_45c191eahubcommunity

轻兔后台对话控制台

通过对话调用轻兔 OpenAPI 控制网站后台。所有调用统一走 scripts/qt_api.mjs

开始前

  1. 确认 skill 根目录存在 config.local.json(没有就提示用户照 config.local.example.jsonbase_url/app_id/app_secret)。
  2. references/auth-and-calling.md 了解鉴权、错误码、读-改-写、脱敏规范。
  3. references/feature-catalog.md 定位用户需求对应的接口。

工作流

  1. 定位接口:先查 references/feature-catalog.md;查不到或字段不清时,用其末尾「补全方法」(Apifox MCP 项目 8399922 / 路由文件 / 控制器源码)兜底。
  2. 判断读还是写:
    • 读(详情/列表/授权链接/小程序码):直接 node scripts/qt_api.mjs --path <路径> [--data 参数.json],把结果讲给用户。
    • 改设置:走读-改-写——先 xxx_setting_detail 取现值,改目标字段、其余回填,再 xxx_setting_save
    • 其它写(新增/编辑/删除/上下架/提交审核):构造 payload。
  3. 写前强确认(强制):执行任何写操作前,先向用户展示「将调用的接口路径 + 完整 payload + 相对现值的变更点」,得到明确确认后才运行脚本。删除、微信小程序提交审核等不可逆操作要单独二次确认并说明影响。
  4. 执行并汇报:运行脚本,按 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.jsonbase_url 决定,操作正式环境的写操作风险由强确认兜底。