用途:当 OpenDeploy CLI 没有对应命名命令、而用户明确要求直接调用 OpenDeploy API 时,作为安全的备用通道。正常情况应优先使用命名命令,而非原始 API。
主要能力与用法:先用 opendeploy routes list --json 查看 CLI 已封装的路由,或用 opendeploy routes search <keyword> --json 搜索。确认无命名命令后,再使用 opendeploy api get /v1/status --json,以及 opendeploy api post /v1/some-route --body payload.json --json、put、patch 等相同形式的调用。--body 可接文件路径或 - 表示标准输入,--data <json> 接内联 JSON。令牌自动取自 ~/.opendeploy/auth.json,且只发送到 dashboard.opendeploy.dev。
若直接调用该技能,先做全局 CLI 版本检查:npm list -g @opendeploydev/cli --depth=0 --json、npm view @opendeploydev/cli version --json、opendeploy preflight . --json。若全局版本落后于 npm 最新版,交由 opendeploy-setup 处理;用户跳过更新时,若已安装的全局 CLI 支持所需命令可继续。此后不要再单独运行 --version、jq 或原始 curl 插件探测。
限制:不得用 od_* 令牌执行 DELETE,删除应交给 dashboard。默认开启脱敏,环境容器可能显示键名但值被脱敏,仅在用户明确要求后才可用 --show-secrets。令牌不得回显、记录或发送到其他 URL。涉及付费、破坏性、安全敏感或会改动线上服务的请求前须先询问。执行前需校验响应结构,遇到无法识别的结构应停止。不要用原始 API 做上传或更新来源,CLI 路由支持所需的 --project-name 与 --region-id 元数据。其他具体功能、收费与平台信息暂未提供。