复制示例前,先核对操作、目标环境与凭证。下表保留当前正文基线记载的开放边界;本地命令或 OpenAPI 条目不能证明服务器已有更新部署。
| 操作 | 本基线记载的正式环境边界 | 凭证与客户端条件 |
|---|---|---|
| 交付记录重放 | 需要已授权订阅与可交付记录;计价订阅只能重放已取得的记录。 | 带 Data 授权的组织 Key;HTTP 客户端或列出 campaign records pull 的 CLI。 |
| 活动读取、编写与上线 | 核对目标权限及逐项操作条件;上线需要人确认。 | 对应 Campaign 授权;浏览器 CLI 会话不能提出或执行上线提案。 |
| 验收检查试跑 | API Key 路径尚未部署;使用已登录的 editor/owner 路径。 | 当前 CLI 列出该命令,并满足活动角色与组织成员条件;检查仍可能调用模型或智能体。 |
| 输入数据集列表 | API Key 路径尚未部署;使用已登录路径。 | 当前 CLI 列出该命令,范围为组织内符合条件的数据集。 |
| 读取提交 | submission:read Key 路径尚未开放;使用已登录路径。 | 查看原始提交与 Data 交付授权是两件事。 |
| Academy 编写与文件读取 | Key 路径尚未开放;按已登录终端路径操作。 | 每个动作仍检查自身角色与范围。 |
| 持久化审核样本接口 | 开发中,未部署到正式环境;按组织启用的 trial/sample 操作还需满足各自启用条件。 | Schema 中存在接口不等于已有访问权。 |
| 本地 MCP | 当前 CLI 须列出 mcp serve,由客户端启动本地进程。 | 继承实际 CLI 操作的目标、凭证和权限;不提供托管 MCP 地址。 |
staging 使用 staging 地址与该环境签发的凭证。上面的正式边界不证明 staging 已为你的组织启用操作;继续前核对真实权限响应与错误。开放情况不明时,向支持提供操作、环境、CLI 版本与脱敏错误。
核对客户端与目标
hbd --version
hbd --help --json
hbd config profiles list --json这些命令只检查本地。选择目标 profile 与凭证后,再运行 hbd auth whoami --json 和 hbd capabilities --json 核对服务器身份与授权。本地帮助或 capability 名称本身不能证明具体接口已经部署。
公开安装渠道是 humanbased@beta,本版文档面向 0.1.0-beta.3,尚待核对该版本已发布的产物;获准从源码构建时使用独立 workspace 包 @humanbased/cli。两者版本号不能互换。上述操作尚无可信的逐项最低 CLI 版本记录;自动化前须检查本地命令清单并确认目标支持。
文档变化与产品发布
网站文档号只标识内容基线,不代表平台发布、API 部署或 CLI 兼容保证。API 路径表示契约系列,不证明其中所有操作已经部署。接入测试应保存 CLI 版本、API 地址与脱敏执行证据。
本轮调整入门顺序、拆出 CLI 操作指南、前置开放边界并新增离线示例,不公告新的产品开放。原 /api/cli/ 小节链接继续保留为新指南入口。历史文档可从版本选择器读取,使用旧步骤前须核对适用性。
CLI 参考表和示例面向 humanbased@0.1.0-beta.3。尚待核对已发布的 npm 产物;源码检查本身不证明公开包已发布,也不证明已登录的服务器操作实测成功。