用途：用版本控制的 TypeScript 管理 Kelviq 定价目录。Kelviq CLI（@kelviq/cli）把目录维护为类型化的 kelviq.config.ts 文件，并与实际环境同步：拉取、在分支中编辑、预览 diff、应用，以及把测试过的沙箱目录推广到生产。
安装与登录：
npm install -g @kelviq/cli kelviq login # 粘贴沙箱密钥（默认） kelviq login --prod # 粘贴生产密钥，用于 promote/push --prod
kelviq env 显示当前配置的环境，但不做实时校验。CLI 直接对 API 编辑和同步配置文件，不经过 MCP；kelviq: MCP 工具在此仅用于把已推送配置与沙箱比对，以及读取文档（docs_search/docs_read，无需密钥）。若这些工具尚未可用，参见 kelviq 技能的 Setup 部分获取 .mcp.json 片段。
何时用 CLI 而非仪表盘或 MCP：批量或重复的定价变更、先审后应用的工作流、git 中的版本历史，以及把已在沙箱测试过的目录推广到生产。一次性套餐或单个价格，用仪表盘更简单。
工作循环：
- kelviq pull 拉取线上目录到 kelviq.config.ts（--prod 拉生产，默认拉沙箱）。
- 在分支中编辑 kelviq.config.ts。它是类型化 TypeScript：product、feature、plan 构建器，通过稳定的标识符 slug 交叉引用，绝不使用 UUID；UUID 解析由 CLI 在同步时完成。
- kelviq push --dry-run 输出人类可读的 diff，零写入，务必先读。
- 确认无误后运行 kelviq push，交互式提示确认；仅在非交互场景（如 CI）且人工已审阅 dry-run diff 时才传 --yes。
- 验证结果：在 KELVIQ_ENV=sandbox 下，kelviq: MCP 工具可校验推送配置在沙箱中实际产生的结果。
- kelviq promote --dry-run 然后 kelviq promote，以 push 同样的方式把沙箱对账进生产，不涉及本地配置文件。
注意：新 plan 以草稿落地，除非传 --publish 否则保持未发布；价格变更会整体替换 plan 的价目表，而非逐条修补。配置中的 taxCode、feature type、priceType、reset 等字段是开放枚举：CLI 不认识的取值会原样通过，由服务器在 push 时校验，不要因为取值陌生就拒绝。
智能体指引：dry-run 可自行运行并把 diff 展示给人类，这是只读且安全的；实际变更（不带 --dry-run 的 push 或 promote，含 --yes）需要人类对该具体变更明确批准。不要自行把 dry-run 直接串接到无人值守的 --yes 应用——每次都要让人先看到 diff。
建议先读文档：kelviq:docs_read 读取 cli/overview（工作流）、cli/kelviq-config（配置文件格式）、cli/commands（完整参数参考）、cli/environments（沙箱与生产定位及密钥）。回答 schema 或 flag 问题前先读，不要凭记忆列举配置格式。