# 操作开放范围与兼容性


复制示例前，先核对操作、目标环境与凭证。下表保留当前正文基线记载的开放边界；本地命令或 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 已为你的组织启用操作；继续前核对真实权限响应与错误。开放情况不明时，向[支持](/zh/help/support)提供操作、环境、CLI 版本与脱敏错误。

## 核对客户端与目标

```sh
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 产物；源码检查本身不证明公开包已发布，也不证明已登录的服务器操作实测成功。
