# 开放平台（开发者门户）

开放平台是 ISV 与平台开发者上架应用、数据模板、知识包与素材包的门户。你可以在此创建上架条目、上传版本、提交审核并在通过后正式上架，同时管理 API 凭证与开发团队。文档、API 参考、Try it 在线调试与 Manifest 校验对未登录访客公开。

## 谁能用

开放平台根据登录状态与组织角色划分使用权限：

| 角色 / 身份 | 访问范围 | 权限说明 |
|---|---|---|
| 未登录访客 | 文档与工具 | 可浏览「快速开始」「指南」「API 参考」「工具与 SDK」「Manifest 校验」「签名密钥」「契约等级」、App Bridge 以及「平台能力」。顶栏显示「登录」按钮 |
| `isv.developer`（开发者） | 「应用」「API 凭证」「团队」 | 创建条目、修改上架信息、上传版本、提交审核、上架版本、回复用户评价。对 API 凭证仅支持只读查看 |
| `isv.admin`（管理员） | 全部功能 | 拥有开发者全部权限，外加邀请成员、调整角色、停用或重新启用成员、重发邀请或重置密码，以及创建、轮换和删除 API 凭证 |

> **注意**
>
> - 访问「应用」「API 凭证」「团队」必须登录，且账号必须属于某个开发者组织。登录后若不属于任何开发者组织，界面提示「这个账号不属于任何开发者组织」「请联系平台运营创建开发者组织并发出邀请。」。
> - 平台开发者组织的成员由运营方在身份中心按角色管理。「团队」页面提示「平台开发者组织的成员由运营方管理」；「API 凭证」页面提示「平台开发者组织的凭证由平台管理」「由运营方管理，不在这里创建或轮换。」。
> - 非管理员查看凭证时，界面提示「你只能查看」，说明创建、轮换和删除凭证需要管理员角色。
> - 开发者看不到其他 ISV 的任何条目或数据，也看不到任何租户业务数据。访问其他开发者的应用时页面提示找不到。用户评价均为匿名展示（不包含租户 ID），安装量仅显示聚合统计数字。
> - 若开发者组织被平台运营暂停，将不能新建条目、不能新建版本、不能修改上架信息、不能上架应用。

## 怎么打开

1. 在浏览器中打开开放平台地址 `https://dev.{base}/`。页面外壳标题显示为「开放平台」。
2. 首次进入时，由平台运营在[运营台](/ops/)创建开发者组织并发出邀请后，你在登录页使用验证码点击「用验证码设置密码」完成初始化。
3. 登录后通过侧栏导航进入各功能模块：
   - 「快速开始」
   - 「我的应用」分组：「应用」「API 凭证」「团队」
   - 「文档」分组：「指南」「API 参考」「工具与 SDK」
   - 「工具」分组：「Manifest 校验」「签名密钥」
   - 「参考」分组：「契约等级」、App Bridge、「平台能力」

> **提示**
>
> - 若登录失败，整页显示「无法登录」，并提供链接「回到开放平台」。
> - 登录后，运营台发布的公告横幅会展示在「应用」布局顶部。

## 界面一览

### 快速开始

用于指引开发者快速搭建应用或集成接口。

| 区域 / 模块 | 说明 |
|---|---|
| 页眉 | 显示「快速开始」。 |
| 「选择起点」 | 包含三张卡片（做应用、调 API、接 Agent 等路径），分别展示步骤、命令与预期输出（根据平台与 Agent 状态动态变化）。若无法读取平台信息，会说明命令中的令牌地址或权限范围为占位符。 |
| 「补充」 | 展示快速开始的关键补充要点。 |
| 「接下来」 | 包含三张导航卡片：「指南」「API 参考」「工具与 SDK」。 |

### 应用工作台

用于集中查看和管理本开发者组织的所有上架条目与版本进度。

| 区域 / 元素 | 说明 |
|---|---|
| 页眉与操作 | 显示「应用」与当前开发者组织名称，提供「创建」按钮。 |
| 「需要你处理」 | 待办事项区域：<br>• 被驳回：标题含「被驳回」，操作按钮为「去修改」<br>• 已通过：标题含「已通过审核，等你上架」，操作按钮为「去上架」<br>• 检查失败：标题含「没有通过自动检查」<br>• 空状态：没有待办时显示「没有待办」。没有条目时提示「先创建你的第一个应用或数据模板。」；有条目但无待办时提示「没有被驳回的版本，也没有等你上架的版本。」 |
| 指标概览卡片 | 包含三张统计卡片：「条目」「总安装」「在审核中」。 |
| 「版本流水线」 | 阶段流程指示：草稿 / 待审核 / 审核中 / 已通过未上架 / 已上架 / 已驳回。 |
| 「我的条目」列表 | 包含以下列：<br>• 「条目」：条目名称与标识<br>• 「类型」：条目类型（应用、数据模板、知识包、素材包）<br>• 「上架版本」：当前在市场生效的版本号，未上架时显示「未上架」<br>• 「最新版本」：最新的版本号，尚未创建版本时显示「还没有版本」<br>• 「安装」：租户安装数量，显示数字后跟「 个租户」<br>• 空状态：列表中没有条目时显示「还没有条目」 |

### 创建上架条目

点击应用工作台的「创建」按钮打开弹窗。弹窗标题显示「创建上架条目」，提示「ID 创建后不能修改。」。

| 字段 | 必填 | 说明 |
|---|---|---|
| 「类型」 | 是 | 选择条目类型：<br>• 应用：「应用：有自己的界面和能力，由你部署。」<br>• 模板：「数据模板：一组对象类型，安装后归租户修改。」<br>• 知识包：「知识包：一组文档，租户可搜索，Agent 也能用。」<br>• 素材：「素材包：一组提示词和技能。」<br>（未开放类型会标「（即将支持）」，当前四类均已开放） |
| 「名称」 | 是 | 条目名称，最长 80 个字符。占位提示「例如：康复诊所管理」 |
| 「ID」 | 是 | 唯一标识，规则为「3 到 48 位，小写字母、数字和 -，以字母开头；全平台唯一。」。保留词 admin、api、app、apps、ops、dev 等不可用。若 ID 已被占用提示「这个应用 ID 已被占用，应用 ID 全平台唯一」 |
| 「依赖的应用」 | 条件必填 | 仅在非应用类型（模板、知识包、素材）时显示，提示「租户须先安装该应用。」 |
| 「一句话介绍」 | 否 | 简短介绍，最多 200 字 |

### 条目全貌

点击具体条目后进入详情页。顶部提供返回「应用」的链接，展示条目类型徽章、当前上架版本（显示为具体版本号或「未上架」），右上角提供「新建版本」按钮。

| 标签页 | 包含内容与说明 |
|---|---|
| 「概览」 | • 统计卡片：显示安装数、启用中数量、版本数<br>• 「版本采用情况」：无安装时显示「还没有租户安装」，或提示「安装统计暂时不可用」<br>• 托管运行卡片与网关用量卡片<br>• 「上架清单」：包含五项步骤进度（写好上架信息 / 上传第一个版本 / 通过自动检查并提交审核 / 审核通过 / 上架）<br>• 「基本信息」：显示应用 ID、类型、依赖、上架版本、平台实测契约等级（如 L0–L3） |
| 「版本」 | 显示版本数量。每个版本以卡片展示版本号与状态（草稿 / 排队等待审核 / 审核中 / 已通过，待上架 / 已驳回 / 已上架 / 已撤回）。展示下一步操作短句提示与自动检查摘要。<br>• 草稿状态提供「编辑」「提交审核」<br>• 已通过状态提供「上架」<br>• 提交审核弹窗提示「提交后内容固定、不能再改；不通过时请新建版本。」<br>• 上架弹窗提示「上架后租户可安装；开启自动升级的租户会立刻升级。」（若有自动升级租户，提示信息中带升级租户数） |
| 「评价」 | • 顶部显示评分均分与星级<br>• 提示「评价匿名，可回复、不能删除；违规评价请联系平台运营隐藏。」<br>• 提供「回复」或「修改回复」操作，回复内容最多 1000 字，提交后显示「你的回复」<br>• 没有评价时显示「还没有评价」 |
| 「上架信息」 | 维护对外展示信息：<br>• 「名称」：条目名称<br>• 「分类」：所属分类<br>• 「一句话介绍」：简述<br>• 「详细介绍」：富文本说明<br>• 「截图」：每行一个 https 地址，最多 6 张，第一张作为封面图<br>• 点击「保存」后提示「上架信息已保存」 |
| 「模块」 | 当条目包含模块时展示，列出模块名称、说明与模块 ID |

### 新建与编辑版本

新建版本时标题为「新建版本」，提示「版本号必须比已有版本都高，如 1.0.1。保存后是草稿。」；编辑草稿时标题显示版本号，提示「版本号不能改；提交审核后内容冻结。」。

| 配置项 | 说明 |
|---|---|
| 配置正文 | 在线编辑配置文件（manifest.json 或数据模板/知识包/素材的配置 JSON），系统提供即时结构检查。 |
| 联邦版本提示 | 针对联邦类型应用，提示「联邦版本需先保存为草稿，再编辑草稿上传构建。」。 |
| 托管版本提示 | 针对托管类型应用，在配置中指定运行镜像（镜像格式为 `名称@sha256:…`），提示「托管运行时开发者看不到进程输出。」。 |
| 「版本说明」 | 填写更新日志与说明，最长 4000 个字符。 |
| 操作按钮 | 新建版本时显示「创建草稿」，编辑草稿时显示「保存草稿」。 |

### API 凭证

用于管理访问开放平台接口与命令行工具（k3）的服务账号凭证。

| 区域 / 元素 | 说明 |
|---|---|
| 页眉与操作 | 显示「API 凭证」，提供「创建凭证」按钮（达到配额上限时该按钮禁用）。 |
| 凭证列表 | 包含以下列：<br>• 名称与使用者标识（userId）<br>• 状态：显示「可用」「已停用」或「待激活」<br>• 角色：固定为开发者服务角色 |
| 行操作 | 管理员下拉菜单提供「轮换密钥」「删除」。非管理员查看时提示「你只能查看」，说明创建、轮换和删除凭证需要管理员角色。 |
| 提示与说明 | • 页脚提示「列表里没有密钥，也没有 client id：它们只在创建或轮换时显示一次。」<br>• 达到上限时提示「已经到上限，需要先删除一个不用的。」<br>• 没有凭证时显示「还没有 API 凭证」<br>• 「怎么用」：说明支持通过 k3 命令行工具登录或自行换取令牌。API 凭证是仅持有开发者权限的服务账号 |
| 创建弹窗 | 标题「创建 API 凭证」，提示「创建后密钥只显示一次。」。名称规则为「2–63 位，小写字母、数字、- 或 _，以字母开头，例如 ci-release」。 |
| 密钥展示弹窗 | 对话框不可点击外部关闭，顶部警示「密钥只显示这一次」。展示 Client ID 与 Client Secret，提供「命令行登录」「换令牌（curl）」与 CI 环境变量说明。必须勾选「我已经把密钥保存好了」才可点击「我已保存」关闭窗口。 |
| 轮换与删除 | • 轮换：旧密钥立刻失效，新密钥只显示一次<br>• 删除：提示「用它登录的 CI 和 k3 立刻失效，已签发的令牌几分钟内过期。不能撤销。」 |

### 团队

用于管理开发者组织内部的成员及其角色权限。

| 区域 / 元素 | 说明 |
|---|---|
| 顶部操作 | 提供「邀请成员」按钮。非管理员访问提示「只有管理员可以邀请成员或调整角色。」。 |
| 成员列表 | 显示姓名与邮箱。状态标记包含「你」（当前用户）、「待激活」、「已停用」。角色下拉菜单包含「开发者」「管理员」。 |
| 行操作 | 管理员可执行「重发邀请」「重置密码」「停用」「重新启用」。不能停用自己，不能移除最后一位管理员。 |
| 角色说明 | • 开发者：「创建条目、上传版本、提交审核、上架。每个成员都有。」<br>• 管理员：「另外可以邀请成员、调整角色、停用成员。」 |
| 邀请弹窗 | 输入成员邮箱，可选勾选「同时设为管理员」。提交后若当场生成验证码，提示「只显示这一次。」。 |
| 停用确认 | 确认弹窗说明「对方不能再登录；已提交的版本和上架的条目不受影响，可随时重新启用。」。 |

### API 参考与 Try it

| 模块 | 说明 |
|---|---|
| 「API 参考」 | 由平台接口规范自动生成，包含「分组」与「共享约定」（认证、错误、状态码、列表、重试、时间、版本）。窄屏下展示「接口列表」。 |
| 接口参数与 Try it | 展示接口参数表与 Try it 在线调试面板。 |
| Try it 状态提示 | • 未登录：提示「登录后可以试一试」「发送请求需要登录；上面的示例可直接复制。」<br>• 已登录：提示「这是真实调用」，说明请求会带着当前令牌发送至服务端，读写真实数据，写入和删除操作不可撤销。调用非安全方法时弹出二次确认「发送这个真实请求？」<br>• 运营与内部接口限制：若在开发者门户调用运营或内部接口，提示「这个站点调不到它」「运营接口只在运营网的监听器上提供。」或「这是内部接口，只在内部网络上提供。」，「发送请求」按钮处于禁用状态 |
| 执行结果 | 点击「发送请求」后，展示响应状态码、耗时、X-Request-Id 请求标识、响应头与响应体。 |

### Manifest 校验

用于在提交注册前验证配置文件的结构合法性。

- 界面提示「粘贴 manifest.json 做结构检查。内容不会上传。」。
- 提供「载入模板示例」按钮。
- 校验结果：结构通过显示「结构检查通过」；发现问题时显示发现的具体问题数量并提示「修复后再提交注册。」，同时可能给出契约等级调整建议。

### 其它公开页面

- **「工具与 SDK」**：提供一条命令安装 k3 命令行工具、下载表格、命令速查以及 SDK 现状。若部署环境未内置命令行工具，提示「这个部署没有内置命令行」。
- **「签名密钥」**：提供 JWKS 公钥地址（`{origin}/.well-known/k3-jwks.json`）。若平台未开启签名控制模块，提示「平台尚未启用 Draft 服务（k3-control 模块）。」。
- **「契约等级」**：展示 L0 至 L3 契约等级标准与规范要求列表。
- **App Bridge、「平台能力」与「指南」**：开发者文档页面。其中「指南」分为「基础」「开发应用」「集成」三个分组。

## 常用操作

### 从零上架一个应用

1. 打开开放平台地址 `https://dev.{base}/`，点击顶栏「登录」。首次登录时在登录页使用验证码点击「用验证码设置密码」完成初始化后登录。
2. 在左侧导航点击「我的应用」下的「应用」，点击页面右上角「创建」。
3. 在「创建上架条目」弹窗中填写条目基础信息：
   | 字段 | 必填 | 说明 |
   |---|---|---|
   | 「类型」 | 是 | 选择「应用：有自己的界面和能力，由你部署。」 |
   | 「名称」 | 是 | 应用名称，最长 80 个字符。占位提示「例如：康复诊所管理」 |
   | 「ID」 | 是 | 唯一标识，3 到 48 位，以字母开头，仅允许小写字母、数字和连字符「-」。全平台唯一，创建后不能修改。不能使用保留词 |
   | 「一句话介绍」 | 否 | 简短描述，最多 200 字 |
4. 点击「创建」。创建完成后自动进入条目全貌页。
5. 切换到「上架信息」标签，完善市场资料：
   | 字段 | 必填 | 说明 |
   |---|---|---|
   | 「名称」 | 是 | 条目对外展示名称 |
   | 「分类」 | 是 | 选择业务分类 |
   | 「一句话介绍」 | 是 | 一句话功能描述 |
   | 「详细介绍」 | 是 | 详细功能与使用说明 |
   | 「截图」 | 否 | 每行填写一个 https 图片地址，最多 6 张，第一张作为封面图 |
6. 点击「保存」，系统提示「上架信息已保存」。
7. 点击右上角「新建版本」，在弹窗中填写版本信息：
   - 输入版本号（提示「版本号必须比已有版本都高，如 1.0.1。保存后是草稿。」）。
   - 编写 manifest.json 内容，核对即时结构检查结果。
   - 填写「版本说明」（最长 4000 个字符）。
   - 点击「创建草稿」。
8. 切换到「版本」标签，在草稿版本卡片上点击「提交审核」。
9. 在确认弹窗中确认（弹窗提示「提交后内容固定、不能再改；不通过时请新建版本。」）。系统执行自动检查，检查全部通过后状态转为「排队等待审核」（若检查失败则保留在草稿，须修改后重新提交）。
10. 等待平台运营审核。审核人员接手后状态变为「审核中」，审核通过后状态变为「已通过，待上架」。
11. 在版本卡片上点击「上架」，在确认弹窗中确认（弹窗提示「上架后租户可安装；开启自动升级的租户会立刻升级。」）。确认后版本状态变为「已上架」，租户即可在[组织应用](/admin/apps)市场中安装。

> **注意**
>
> 若版本被运营驳回，该版本属于终态不可再修改。须点击「新建版本」填写更高的版本号，根据驳回原因修改配置后重新提交审核。

### 创建 API 凭证

1. 在左侧导航点击「我的应用」下的「API 凭证」（须具备管理员角色）。
2. 点击右上角「创建凭证」（若已达上限，该按钮处于禁用状态）。
3. 填写凭证名称：
   | 字段 | 必填 | 说明 |
   |---|---|---|
   | 「名称」 | 是 | 2–63 位，以字母开头，仅允许小写字母、数字、连字符「-」或下划线「_」，例如 `ci-release` |
4. 点击「创建」。
5. 系统弹出密钥展示窗口（提示「密钥只显示这一次」），复制记录 Client ID 与 Client Secret。
6. 勾选「我已经把密钥保存好了」复选框，点击「我已保存」关闭窗口。
7. 在开发环境或 CI 中使用凭证：通过 `k3 login` 登录，或配置环境变量 `K3_URL`、`K3_CLIENT_ID`、`K3_CLIENT_SECRET`，通过 `k3 publish --wait` 发布版本。

> **危险**
>
> 凭证密钥仅在创建或轮换时展示一次，列表不会保存密钥明文。关闭窗口前必须妥善复制保存。

### 轮换与删除 API 凭证

1. 在左侧导航点击「我的应用」下的「API 凭证」。
2. 轮换密钥：
   - 在列表中找到目标凭证，点击右侧操作菜单，选择「轮换密钥」。
   - 确认轮换后旧密钥立刻失效，窗口中展示新密钥（只显示这一次）。
   - 妥善复制保存新密钥，勾选确认后关闭窗口。
3. 删除凭证：
   - 在列表中找到目标凭证，点击右侧操作菜单，选择「删除」。
   - 弹窗提示「用它登录的 CI 和 k3 立刻失效，已签发的令牌几分钟内过期。不能撤销。」。
   - 确认后凭证被永久删除。

### 邀请团队成员与管理角色

1. 在左侧导航点击「我的应用」下的「团队」（须具备管理员角色）。
2. 点击右上角「邀请成员」。
3. 填写成员邮箱；若需要管理员权限，勾选「同时设为管理员」。
4. 点击确认发送邀请。若界面当场生成验证码，提示「只显示这一次。」，须妥善记录并告知被邀请人。
5. 调整角色：在成员列表中找到对应成员，在「角色」下拉菜单中切换「开发者」或「管理员」。

### 停用与重新启用成员

1. 在左侧导航点击「我的应用」下的「团队」。
2. 停用成员：在目标成员右侧点击「停用」，弹窗提示「对方不能再登录；已提交的版本和上架的条目不受影响，可随时重新启用。」，确认后成员状态变更为「已停用」（不能停用自己，也不能移除最后一位管理员）。
3. 重新启用：在状态为「已停用」的成员右侧点击「重新启用」，恢复该成员的操作权限。

### 校验 Manifest 配置文件

1. 在左侧导航点击「工具」下的「Manifest 校验」。
2. 在编辑区域粘贴 manifest.json 内容（也可点击「载入模板示例」载入参考配置）。
3. 查看校验结果：
   - 结构合法：显示「结构检查通过」。
   - 存在问题：显示问题数量并提示「修复后再提交注册。」，根据系统提示修正后再提交。

### 在线调试 API（Try it）

1. 在左侧导航点击「文档」下的「API 参考」。
2. 在接口列表中点击目标接口，进入操作详情页。
3. 确认已登录开发者账号（未登录时提示「登录后可以试一试」「发送请求需要登录；上面的示例可直接复制。」）。
4. 在 Try it 调试面板中填写请求参数。
5. 点击「发送请求」。若涉及写操作或删除操作，在二次确认弹窗「发送这个真实请求？」中确认。
6. 查看接口返回的 HTTP 状态码、耗时、X-Request-Id 请求标识、响应头与响应体。

> **注意**
>
> Try it 是真实调用，请求会携带你的开发者身份令牌发往服务端，读写真实数据，写入与删除操作不可撤销。运营网络与内部网络接口在此站点无法调用。

### 回复用户评价

1. 在左侧导航点击「我的应用」下的「应用」，点击目标条目进入详情页。
2. 切换到「评价」标签。
3. 查看用户提交的评分与匿名评价内容。
4. 在目标评价下方点击「回复」（若已回复过可点击「修改回复」）。
5. 输入回复内容（最多 1000 个字符），点击提交。提交后该评价下方显示「你的回复」。

## 状态说明

### 版本状态

| 状态 | 说明 | 转换操作 |
|---|---|---|
| 「草稿」 | 版本正在编辑，尚未提交；或提交时未通过自动检查 | 点击「编辑」修改内容；点击「提交审核」提交 |
| 「排队等待审核」 | 自动检查全部通过，已提交平台等待运营审核 | 等待运营人员接手审核 |
| 「审核中」 | 平台运营人员正在对该版本进行审核 | 等待审核结论 |
| 「已通过，待上架」 | 平台审核已通过，尚未在市场上架 | 点击「上架」正式发布 |
| 「已上架」 | 版本已正式上架，租户可在应用市场安装 | 平台运营可在管理端撤回 |
| 「已驳回」 | 审核未通过，属于终态，不可再修改 | 须新建更高版本号重新提交 |
| 「已撤回」 | 已上架版本被平台运营撤回下架 | 终态 |

状态流转过程：
`草稿 → 排队等待审核 → 审核中 → 已通过，待上架 → 已上架`
（提交时自动检查失败停留在「草稿」；审核未通过转为「已驳回」；已上架版本可被运营「已撤回」）

### API 凭证状态

| 状态 | 说明 |
|---|---|
| 「可用」 | 凭证处于激活可用状态，可用于接口调用与命令行工具认证 |
| 「待激活」 | 凭证已生成，等待初始化激活 |
| 「已停用」 | 凭证已被禁用，无法用于身份鉴权 |

### 团队成员状态

| 状态 | 说明 |
|---|---|
| 正常（无标记） | 成员已激活，可正常登录系统与协同开发 |
| 「待激活」 | 邀请已发出，成员尚未设置密码激活账号 |
| 「已停用」 | 成员已被管理员停用，不能再登录系统；已提交的版本不受影响 |

## 让助手帮你做

开放平台本身不是租户应用，不向工作台助手（Agent）暴露运营或开发者操作接口，门户内不提供助手对话功能。条目创建、版本上传、审核提交、凭证管理与团队维护均须在开放平台界面中手动操作（开发者构建的应用在租户端可向租户声明可起草的操作，属于租户侧功能）。

## 设置

开放平台无门户级全局设置项，各组织可在对应模块中维护以下配置：

| 模块 | 设置项 | 规则与取值 | 说明 |
|---|---|---|---|
| 上架条目 | 「上架信息」 | 名称、分类、一句话介绍（最多 200 字）、详细介绍、截图（最多 6 张 https 地址） | 决定应用在应用市场的展示资料，第一张截图作为封面图 |
| API 凭证 | 「名称」 | 2–63 位，以字母开头，仅包含小写字母、数字、-、_ | 标识服务账号用途，如 `ci-release` |
| 团队 | 「角色」 | 「开发者」「管理员」 | 决定成员在开发者组织内的管理权限 |

## 注意事项

- **应用 ID 规则与全平台唯一**：应用 ID 全平台唯一，长度为 3 到 48 位，以字母开头，仅允许小写字母、数字和连字符「-」。创建后不可修改，且不可使用 admin、api、app、apps、ops、dev 等系统保留词。
- **版本号单调递增与内容冻结**：新建版本的版本号必须高于已有所有版本（如 1.0.1）。一旦点击「提交审核」，版本内容即刻冻结不可修改。
- **驳回版本不可修改**：版本被驳回后属于终态，不能在原版本上修改或重新提交，必须新建一个更高版本号的版本重新提交。
- **审核通过不等于上架**：审核通过后的状态为「已通过，待上架」，必须由开发者在版本卡片上手动点击「上架」并确认后，租户方可在[组织应用](/admin/apps)市场中安装。
- **不可靠低版本回滚**：无法通过上架更低版本号的方式进行版本回滚。
- **上架联动自动升级**：上架新版本后，所有在组织中开启了自动升级的租户会立刻自动升级到新版本。
- **密钥只显示一次与轮换即时失效**：API 凭证的 Client ID 与 Client Secret 仅在创建或轮换时展示一次，列表不会保存密钥明文。轮换会使旧密钥立刻失效；删除凭证会导致使用它的 CI 与命令行工具立刻失效，已签发令牌数分钟内过期，且删除不可撤销。
- **凭证权限范围**：API 凭证是仅持有开发者权限（`isv.developer`）的服务账号，不能用于管理组织成员或执行管理员写操作；创建、轮换与删除凭证需要管理员角色（`isv.admin`）。
- **评价不可删除**：用户评价匿名展示（不包含租户 ID），开发者可回复或修改回复（最多 1000 字），但不能自行删除评价；如遇违规评价须联系平台运营处理隐藏。
- **严格数据隔离**：开发者无法查看其他 ISV 的任何数据，也无法查看任何租户的业务数据与身份信息；安装量仅显示聚合统计数字；访问其他开发者的应用时页面提示找不到。
- **组织暂停限制**：若开发者组织被平台运营暂停，将无法新建条目、无法新建版本、无法修改上架信息、无法上架应用。
- **特殊构建类型限制**：
  - 联邦版本须先在控制台保存为草稿，再编辑草稿上传构建。
  - 托管运行镜像须指定带校验码的镜像名称（`名称@sha256:…`），且托管运行时开发者无法查看进程输出。
- **Try it 真实调用风险**：Try it 调试会携带当前登录者的真实令牌向平台发起实际请求，读写真实数据，写入与删除操作不可撤销；运营网与内部网络接口在开放平台站点无法调用。

## 目前不支持

- 开发者收入与结算页面（当前无收入、结算与分账管理功能）。
- 在开放平台直接调试运营接口与内部接口（运营接口仅在运营网络提供，内部接口仅在内部网络提供，开放平台禁止发送调试请求）。

## 常见问题

#### 审核通过后，租户可以直接在应用市场安装了吗？
不能。审核通过后的状态为「已通过，待上架」，此时市场中尚不提供该版本安装。必须由开发者在版本卡片上手动点击「上架」并在弹窗中确认后，版本状态变为「已上架」，租户方可在[组织应用](/admin/apps)市场中看到并安装；开启了自动升级的租户会在此刻自动升级。

#### 版本被运营审核驳回后，可以直接修改原版本再次提交吗？
不能。版本一旦提交审核，配置内容即刻冻结；审核被驳回属于终态。你需要点击右上角「新建版本」，输入比已有版本更高的版本号（例如原版本为 1.0.0，新建 1.0.1），根据驳回原因修改配置内容后重新提交审核。

#### API 凭证创建后忘记保存 Client Secret，还能再次查看吗？
不能。API 凭证的密钥在创建和轮换时仅展示一次，列表中不会保存或显示密钥明文。如果遗失，需要管理员在凭证列表中点击「轮换密钥」，旧密钥会立刻失效并重新生成一套新的 Client ID 与 Client Secret，请在弹出窗口中妥善复制并保存。

#### 登录后提示「这个账号不属于任何开发者组织」该如何处理？
开放平台的应用工作台、API 凭证与团队管理功能仅对加入了开发者组织的账号开放。出现此提示说明你的账号尚未加入任何开发者组织，请联系平台运营在[运营台](/ops/)中创建开发者组织并向你发出邀请。

#### 在 API 参考中使用 Try it 发送请求是模拟测试吗？
不是。Try it 是真实调用，会携带你当前登录账号的真实令牌向平台接口发起网络请求，读取和修改真实数据。涉及写入和删除的操作无法撤销，请谨慎操作。