核心功能
zerodha-kite-cli-router 是一款专为印度最大券商 Zerodha 设计的 CLI 命令路由技能,核心能力是将用户的自然语言查询(如"买入 10 股 RELIANCE"或"查看我的保证金")精准转换为可执行的 zerodha 命令。
覆盖场景
- 市场数据:实时行情、LTP、OHLC、历史 K 线
- 订单全生命周期:下单、改单、撤单、平仓、订单簿查询
- 持仓与资产:股票持仓、持仓转换、共同基金(MF)、SIP 管理
- 风险管理:保证金查询、订单保证金预估、费用计算
- 智能订单:GTT(Good Till Trigger)单腿/双腿触发订单
- 认证流程:多轮交互式登录,支持 request token 和 callback 两种模式
显著优点
1. 约束完备:每个命令附带详细的参数校验规则(数值范围、互斥条件、必填项),从源头防止无效指令
2. 状态记忆:登录流程支持跨消息持久化已收集的认证字段,减少重复询问
3. 同义词映射:内置丰富的业务术语映射(如"buy"→order place --txn BUY),降低用户学习成本
4. 安全优先:明确要求 API 凭证和 token 分离管理,不硬编码敏感信息
潜在局限
- 地域限制:仅支持印度 Zerodha Kite 平台,无法用于其他券商或国际市场
- 依赖外部 CLI:需先安装第三方开源 CLI 工具(GitHub: jatinbansal1998/zerodha-kite-cli),非官方出品
- 无实时回显:仅生成命令字符串,不直接执行或返回市场数据
- MF 功能较新:共同基金相关命令的稳定性可能低于股票交易模块
适合人群
- 使用 Zerodha 的量化交易者、算法交易员
- 熟悉终端操作、偏好 CLI 工作流的投资人
- 需要将自然语言指令集成到自动化交易系统的开发者
常规风险提示
- API 密钥安全:
api_key和api_secret属于敏感凭证,应存储于配置文件而非对话中 - 交易执行风险:技能仅生成命令,实际执行后果由用户承担,建议先用
--json模式验证 - 令牌有效期:access token 每日需刷新,refresh token 需妥善保管
- 非官方工具:底层 CLI 为社区开源项目,非 Zerodha 官方维护,存在维护中断风险
- 印度市场特有风险:需遵守 SEBI 规定,注意 MTF(Margin Trading Facility)等产品合规性