Pontx Hub
使用 pontx-hub 作为访问精选 API 目录的权威接口。通过仅搜索和加载当前任务所需的产品、接口或 Schema，将 API 元数据保留在长期上下文之外。
工作流程
-
在选择 API 之前先进行搜索。支持自然语言描述、请求和响应相关的问题：
pontx-hub search "<能力描述>" --json pontx-hub search "创建任务的入参" --locale zh --json pontx-hub search "返回 dueDate 的接口" --locale zh --json必要时缩小结果类型：
pontx-hub search "<字段或模型>" --type schema --json -
查看所选稳定资源的 ID：
pontx-hub show endpoint:<API名称>/<接口路径> pontx-hub show schema:<API名称>/<Schema名称> -
对于接口，在不发送请求的情况下构建并预览精确的请求：
pontx-hub <API集合> preview <API名称> --parameter value --body '<json>' pontx-hub <API集合> preview <控制器> <API名称> --parameter value --body '<json>' -
对于 GET 或 HEAD 请求，仅当用户要求执行时才执行调用：
pontx-hub <API集合> call <API名称> --parameter value pontx-hub <API集合> call <控制器> <API名称> --parameter value -
对于 POST、PUT、PATCH 或 DELETE 请求，先展示 dry-run 结果并获取用户的明确确认。确认后，使用相同参数添加
--yes执行：pontx-hub <API集合> call <控制器> <API名称> --parameter value --body '<json>' --yes -
验证请求结构后，生成集成代码：
pontx-hub sdk <API名称>
安全性
- 绝不要将查阅、解释或预览 API 的请求视为对写入操作的批准。
- 绝不要直接将凭据打印、显示、记录或放在命令参数中。
- 从
show命令指定的环境变量中读取凭据。 - 绝不要调用任意 URL 或 Hub 目录之外的操作。
- 对于修改操作，绝不能跳过独立的
preview步骤。 - 将更改后的参数、请求体、服务器或操作视为新的请求，需要重新进行 dry-run 和确认。
- 配置凭据、诊断身份验证或执行修改操作时，请阅读 references/auth-and-safety.md。
输出
以编程方式消费 CLI 输出时，优先使用 --json。报告失败时，保留 CLI 退出码和机器可读的错误码。使用结果中的 match.mode 和 match.fields 来解释匹配来源（产品、参数、请求、响应、Schema 或属性元数据）。生成应用程序代码时，使用操作发布的 @pontx/<api-slug> 包。