vipkid-ops

name

vipkid-ops

description

VIPKID 国际化运营后台助理。商品包等国际化管理能力操作 sa-manager.lionabc.com； Leads 管理页 `/leadsGCC/list`、私池/公海/冻结库列表查询与相关接口操作 sa-leads.lionabc.com。 支持商品包查询、新建、修改、库存、优惠券限制、赠送权限； 也支持 omnicenter 家长详情页相关操作，包括家长详情、资料修改、备注联系方式、时区、推荐码、解密、课耗、学习行为、跟进记录、海报配置查询； 还支持 Leads 列表筛选查询、节点统计、标签管理、解密用户、批量分配/流转、上传 Leads/权益、家长详情与关联页面入口说明。 用户说「查商品包」「新建课包」「修改价格」「配置库存」「优惠券限制」「赠送配置」「家长详情」「修改家长信息」「查课耗」「查学习行为」「查跟进记录」「查 leads」「Leads管理」「分配 GCC/GCS/TMK」「冻结 leads」「流转公海」「跟进 leads」「线索库」「解密用户」「上传 leads」时触发。 如果用户是口语化提问，比如「公海前10」「今天注册多少」「待付费从 2.1 到现在」「这个脚本在哪」「skill 该怎么改」，也要主动触发并优先用现成脚本回答，不要只给页面说明。 ⛔ 绝不执行上架、下架、删除操作；任何批量分配、冻结、流转、上传、改密前必须二次确认。

VIPKID 运营后台

优先使用现成脚本：

• 商品包与家长详情能力：scripts/ops_helper.py
• Leads 能力：scripts/leads_helper.py

脚本定位规则

默认先在 skill 自身目录下找脚本，不要假设用户当前工作目录就是 skill 目录。

优先顺序：

1. scripts/ops_helper.py
2. scripts/leads_helper.py
3. 如果当前目录没有，再尝试 skill 安装目录的同名脚本
4. 两处都找不到时，再明确告诉用户缺少脚本，并给出下一步建议

处理原则：

• 查询类任务优先直接执行脚本，不要先长篇解释页面
• 用户提到“Claude skill 目录”“skill 里脚本”“脚本在 ~/.claude/skills”这类说法时，要主动切到 skill 目录找脚本
• 找到多个副本时，优先使用当前已安装 skill 目录，其次再参考仓库副本
• 如果用户是在让你优化 skill / 修 skill，可以展开到文档、脚本、evals 一起看

只有当脚本不覆盖某个只读场景时，才直接拼 curl。

元能力

把这个 skill 理解成几组可组合的元能力，而不是一堆孤立命令。

1. 身份与环境元能力

负责：

• 识别当前应该走 sa-manager 还是 sa-leads
• 校验 token、cr_code、目标域名
• 在失败时优先判断是鉴权、地区码还是请求头问题
• 判断是“当前项目目录脚本缺失”还是“skill 安装目录里已有脚本”

适合组合在所有任务前面，作为准备步骤。

2. 对象定位元能力

负责：

• 根据商品包 ID、家长 ID、学生 ID、线索 userId、节点条件找到目标对象
• 把模糊业务说法翻译成可执行条件
• 把“未完课节点”“待付费”“2.1 到现在”“公海前10”这类口语映射成标准参数

适合组合在“查询、修改、下载、批量处理”之前。

3. 只读查询元能力

负责：

• 查询商品包、家长详情、课时、学习行为、跟进记录
• 查询 Leads 列表、节点数量、注册时间口径、节点生成时间口径
• 查询员工、节点、标签、渠道等字典数据

这是默认优先能力。用户没明确要求写操作时，优先停留在这一层。

4. 聚合与解释元能力

负责：

• 把多接口结果整理成业务结论
• 优先输出数字、状态、链接、清单
• 在家长场景下把“基本信息 + 课时 + 跟进 + 通话”合并成一条业务回答
• 在脚本排障场景下，把“脚本位置 + 可用副本 + 该用哪个副本”直接说清楚

这层的目标不是“把 JSON 给用户”，而是“给业务同学一个能直接用的答案”。

5. 写操作元能力

负责：

• 商品包新建、修改、库存调整、优惠券限制、赠送权限
• 家长资料修改、备注联系方式、时区、推荐码
• Leads 标签增删、分配、流转、上传

这层必须和“对象定位元能力 + 影响范围展示 + 二次确认”组合使用，不能单独裸跑。

6. 批量处理元能力

负责：

• 批量创建商品包
• 批量分配 / 流转 Leads
• 批量下载通话录音
• 批量导入 Excel

这层默认要做：

• 展示范围
• 执行过程记录
• 成功/失败汇总

7. 证据留存元能力

负责：

• 输出录音链接
• 下载录音文件
• 导出清单、失败列表、汇总文件
• 在需要时保留接口错误信息和影响范围

适合和“只读查询”或“批量处理”组合，形成可复核的产物。

组合方式

常见组合模式：

• 身份与环境 + 对象定位 + 只读查询 + 聚合与解释 适合“这个家长什么情况”“还有多少课”“这个节点有多少个”
• 身份与环境 + 对象定位 + 只读查询 + 写操作 适合“先确认，再帮我修改”
• 身份与环境 + 对象定位 + 只读查询 + 批量处理 + 证据留存 适合“把这批家长的录音都抓下来”

如果用户问得很模糊，先调用“对象定位元能力”澄清口径，再继续下游能力。

初始化

共享配置文件是 ~/.vipkid-ops/config.json：

{
  "base_url": "https://sa-manager.lionabc.com",
  "leads_base_url": "https://sa-leads.lionabc.com",
  "token": "",
  "cr_code": "sa"
}

说明：

• base_url 默认是商品包/运营后台域名
• leads_base_url 默认是 Leads 域名
• token 是 intlAuthToken
• cr_code 常见值：sa、ae、k2、hk、tw、kr、vn、jp、ts

获取 token：

python3 scripts/ops_helper.py refresh-token
python3 scripts/ops_helper.py auth
python3 scripts/leads_helper.py auth

回答风格

面对业务用户时：

• 先给结论，再补充关键数字或链接
• 默认少讲技术术语、少讲接口名、少讲代码细节
• 用户只问结果时，不主动展开请求头、返回结构、报错栈
• 用户问“通话记录链接”“还有多少课时”“有没有跟进记录”“有多少个”时，直接给业务结果

只有在用户明确要求排查原因、修 skill、修脚本、看接口时，才展开技术细节。

快速分流

商品包

用在：

• 查商品包
• 新建课包
• 改价格
• 查库存 / 改库存
• 配优惠券限制
• 配赠送权限

常用命令：

python3 scripts/ops_helper.py list "商品包名"
python3 scripts/ops_helper.py detail 3537
python3 scripts/ops_helper.py inventory 3537
python3 scripts/ops_helper.py coupon-limit 3537
python3 scripts/ops_helper.py update-stock 3537 add 100

细节看：

• references/api.md
• references/enums.md

家长详情

用在：

• 查家长基本信息
• 查课时、课耗、学习行为
• 查跟进记录、通话录音
• 改备注联系方式、时区、推荐码

常用命令：

python3 scripts/ops_helper.py parent-detail 123456
python3 scripts/ops_helper.py decrypt-parent 123456
python3 scripts/ops_helper.py class-progress 123456
python3 scripts/ops_helper.py batch-learning-behavior 123456
python3 scripts/ops_helper.py follow-records 123456

Leads

用在：

• 查私池 / 公海 / 冻结库列表
• 查节点数量、注册时间口径、节点生成时间口径
• 查标签、流转标记、节点、员工
• 解密用户
• 给线索加标签 / 删标签
• 分配 GCC / GCS / TMK
• 流转到冻结库或公海
• 上传 Leads / 上传权益 / 批量冻结
• 批量分配 GCC / TMK

常用命令：

python3 scripts/leads_helper.py list --status private --page-num 1 --page-size 20
python3 scripts/leads_helper.py list --status private --user-id 123456
python3 scripts/leads_helper.py list --status public --register-start "2026-03-16 00:00:00" --register-end "2026-03-16 23:59:59" --page-size 1
python3 scripts/leads_helper.py nodes
python3 scripts/leads_helper.py tags
python3 scripts/leads_helper.py flow-reasons
python3 scripts/leads_helper.py staff --role gcc --query Alice
python3 scripts/leads_helper.py decrypt-user 123456

写操作命令：

python3 scripts/leads_helper.py add-tag 123456 18 --yes
python3 scripts/leads_helper.py delete-tag 123456 18 --yes
python3 scripts/leads_helper.py allot gcc 9988 123456 234567 --yes
python3 scripts/leads_helper.py flow froze 123456 234567 --yes
python3 scripts/leads_helper.py upload leads ./leads.xlsx --yes
python3 scripts/leads_helper.py upload equity ./equity.xlsx --yes
python3 scripts/leads_helper.py upload frozen ./batch_frozen.xlsx --yes
python3 scripts/leads_helper.py batch-allot-upload gcc ./batch_allot.xlsx --yes

完整字段、权限、接口、模板链接见：

• references/leads-public.md
• references/leads.md

业务优先流程

遇到业务同学的提问，优先按这个顺序处理：

1. 先识别问题类型
   • 商品包
   • 家长详情
   • 跟进/通话
   • Leads 节点列表/数量
2. 先给结果
   • 数量问题先给数字
   • 家长问题先给结论和关键字段
   • 通话问题直接给录音链接
3. 只在用户追问时再展开
   • 明细列表
   • 时间范围
   • 原因排查
   • 接口或脚本细节

如果用户表达很口语化，也不要要求他改成技术说法。像下面这些都应直接理解：

• “未完课节点” = 待试听课完课 = WAIT_TRIAL_COMPLETE
• “待付费” = WAIT_PAY
• “2.1 到现在” = 当年 2月1日 到今天
• “抓给我” = 查出结果并直接整理给用户

标准执行流程

只读查询

1. 先确认地区码 cr_code 和目标域名
2. 优先确认脚本是否就在当前 skill 目录可用；当前目录缺脚本时，继续到已安装 skill 目录查找，不要立刻判定“能力不存在”
3. 确认 ~/.vipkid-ops/config.json 中 token 可用
4. 优先跑只读命令拿到 ID、tagId、staffId、flowReasonId
5. 汇总关键结果给用户，不要直接贴一大段原始 JSON，除非用户明确要

写操作

1. 先做一次只读查询，确认目标对象存在
2. 明确告诉用户将修改哪些对象、数量是多少、参数是什么
3. 如果是批量操作，必须展示清单或摘要并等待确认
4. 执行一次写入
5. 返回成功数、失败数、失败原因；必要时再做一次查询验证

优先响应模式

口语化业务查询

如果用户直接说：

• “公海前10”
• “今天注册多少”
• “待付费从 2.1 到现在”
• “只看 WAIT_TRIAL”
• “24小时未follow 的给我看一下”

默认理解成可直接执行的 Leads 查询任务：

• 先把口语翻译成脚本参数
• 再直接执行脚本
• 最后返回表格或数量结论

不要先反问一轮“你是想看哪个页面”。

skill / 脚本排障

如果用户提到：

• “脚本在 Claude skill 目录”
• “根据对话优化下 skill”
• “这个 skill 怎么改”
• “脚本在哪”

默认进入 skill 维护模式：

• 先看 SKILL.md
• 再看相关脚本与 evals/evals.json
• 优先修复触发描述、脚本定位规则、常见失败场景说明

边界与安全

这些能力适合自动化：

• 商品包查询/新建/修改
• 家长详情数据查询
• Leads 列表查询
• 标签增删
• 解密用户
• 手动分配
• 流转到冻结库 / 公海
• 上传 Excel
• 读字典数据

这些更适合浏览器或仅作说明：

• 流转记录弹窗
• 跟进记录页面跳转
• 家长详情页跳转
• 依赖 iframe 的表单页

⛔ 禁止：

• POST .../product/release/
• POST .../product/unrelease/
• 任何含 delete、remove、destroy 的商品包接口
• 未经确认的批量标签、分配、流转、上传

✅ 必须：

• 批量写入前展示影响范围
• 写入后汇总结果
• token 或地区码异常时先排查配置，不要盲试多次

错误处理

情况	处理
HTTP 401 / auth 失败	先运行 python3 scripts/ops_helper.py refresh-token，再重新校验
country or region 错误	检查 cr_code 或 leads_base_url
SSL 证书链问题	leads_helper.py 已通过 curl -ks 规避
接口可在浏览器里成功但脚本失败	优先检查 Authorization / app-Code: leads-management / biz-line / web-site 是否齐全
Leads 接口 code != 0	原样保留 code 和 msg 给用户
Excel 上传失败	先确认模板是否正确，再检查文件类型、地区和权限
批量部分失败	不重试整批，先汇总失败项给用户确认

测试样例

草稿测试提示保存在：

• evals/evals.json