GoodVision CLI
GoodVision CLI 让 Codex 在终端中发现并调用 GoodVision 的公开 API。先找到能力、理解参数、预览请求,再执行已获准的模型、客户经营、订阅和订单操作,结果可直接交给代码或脚本处理。
产品名为 GoodVision CLI,命令为 goodvision(简写 gv),包名 @goodvision/cli。与 @goodvision/ui 使用同一 @goodvision npm scope 和维护团队;CLI 与 SDK 已通过 npm 提供,也支持源码构建。
快速开始
- 安装 CLI:从 npm 安装公开包,或使用源码构建。
- 配置身份:固定应用与环境,按操作选择用户身份或应用服务身份。
- 发现能力、预览请求,完成第一次 API 调用。
bash
goodvision api products
goodvision api search user context
goodvision schema resolveCustomerUserContext使用场景
| 任务 | 可以这样告诉 Codex | 使用能力 |
|---|---|---|
| 首次接入应用 | 找到用户空间 API,读取所需 Scope,用我的 sandbox 配置预览首次请求。 | 能力发现、Schema、请求预览 |
| 接入模型 | 查看模型 API,生成按当前授权上下文查询可用模型和用量的代码。 | Token API、SDK 类型 |
| 客户经营 | 找到公司、线索和报价操作,先列出必需的领域引用和请求预览,再执行修改。 | 客户经营 API、产品策略、幂等 |
| 事件自动化 | 生成事件接收项目,持久保存已订阅事件,幂等处理完成后再确认。 | 事件 SDK、SSE、Webhook 模板 |
能力地图
业务能力地图按业务域列出已登记的公开能力、产品 ID 和接入指引。Agent 能力概述说明凭据、交互、执行三层及其组合路径。
文档导航
| 目标 | 独立指南 |
|---|---|
| 安装和第一个任务 | 快速开始 |
| 选择身份和检查凭据 | 认证与配置 |
| 同时管理多个应用 | 多应用与 Profile |
| API 发现、预览和执行 | 发现与调用 API |
| 事件调试与确认 | 接收与确认事件 |
| 命令和机器可读文档 | 命令参考 |
| 错误与恢复 | 常见问题 |
| 在应用代码中调用 | TypeScript SDK |
| 创建接入项目 | 接入模板 |
目录登记、凭据获取和业务授权分别核验。扫码创建应用、终端 OAuth 登录/登出和聊天 Channel SDK 尚未提供。