arkcli-plans

arkcli plans

CRITICAL — 开始前 MUST 先用 Read 工具读取 ../arkcli-shared/SKILL.md，其中包含认证闸门、配置排查与共享安全规则。 CRITICAL — 任何 plans buy / plans renew / plans personal rotate-apikey / plans team seat-assign / plans team rotate-apikey 在执行之前，务必先用 Read 工具读取对应 references/*.md，禁止盲目调用。

🔒 协议闸门（plans buy / plans renew 强制流程）

plans buy / plans renew 是计费写操作，加 --yes 才真扣款。不传 --yes 不传 --estimate 时, CLI 不下单, 而是返回:

{
  "status": "agreement_required",
  "agreements": [{"title": "...", "url": "..."}, ...],
  "next_step": "arkcli plans buy ... --yes"
}

Agent 必须严格按以下顺序执行:

1. 第一次调用必须不带 --yes — 拿到 agreements 数组
2. 逐条把每条协议的 title 和 url 展示给最终用户(不能省略,不能合并)
3. 等待用户明确表达已阅读并同意全部协议(例如"我已阅读并同意"、"OK 我同意"等清晰表态);不能用模糊回答("好"、"嗯") 默认通过
4. 确认后才能加 --yes 重跑 next_step 字段里的命令(直接复制 next_step 即可,flag 已回显完整)

违反这条流程 = 帮用户跳过法律合规步骤。这跟 frontend 购买面板的 "我已阅读并同意《...》" checkbox 等价 — 必须真人看过才能勾。

--estimate 是在线询价路径,不下单也不需要协议确认；它不是 Client Preview。用户最终走 --yes 真下单时仍需先看协议。

业务定位

arkcli plans 管理两类 ARK 套餐：

• Agent Plan（agent-plan / agent-plan-team）：智能体调用套餐，按 tier 划档（small/medium/large/max）
• Coding Plan（coding-plan / coding-plan-team）：编程辅助套餐，按 tier 划档（lite/pro）

每类套餐都有 个人版（personal）与 企业版 / 团队版（team）两种形态：

形态	资源单位	典型操作
personal	个人订阅 (subscription)	查看 / 购买 / 续费 / 轮换专属 APIKey
team	企业席位 (seat)	查看 / 购买 / 续费 / 列出席位 / 绑定子用户 / 轮换席位 APIKey

personal 一个账号下一份订阅；team 是按席位（SeatID）粒度管理，每个席位绑一个子用户。

本 skill 不含套餐用量 / 配额查询（"用了多少 / 还剩多少 / 几号刷新 / 按模型拆分"）。plans get 只回答"我持有哪些套餐 + 状态(Effective/Running)"，不回答"用了多少"。配额视图在 ../arkcli-usage/ — 详见下方"快速决策"分流表。

适用场景

• 查看当前账号下持有哪些套餐 → plans get
• 下单买套餐（含个人 / 团队）→ plans buy
• 续费已有套餐 → plans renew
• 看套餐支持的模型清单 → plans model-list
• 切换 ark-code-latest 的路由目标（Auto 智能调度或具体影子模型）→ plans model-apply
• 个人版轮换 APIKey → plans personal rotate-apikey
• 列出 / 筛选企业版席位 → plans team seat-list
• 把企业版席位绑给子用户 → plans team seat-assign
• 轮换企业版席位的 APIKey（自己 or 管理员批量）→ plans team rotate-apikey
• 查本机 AI Agent 上专属 Harness 能力装没装（只读）→ plans harness-status：按能力卡报豆包搜索 / 专业数据集 / Agent 记忆（MCP），外加全局火山引擎Supabase（CLI+Skill 装没装）。「我的 supabase / MCP 装好了吗」都走这里（Agent 记忆卡仅个人版 agent-plan；团队版报 absent 是预期、非漏装，详见其 reference）