开发者与市场审核

开发者与市场审核是 Raise 平台运营台的核心管理模块。平台运营人员在这里管理开发者组织、把关市场上架条目、审核待上架版本（含结构化清单），以及登记应用的契约等级并执行暂停或下线。用户评价在市场条目行内进行审核与隐藏，平台不提供独立评分页面。

谁能用

平台运营台通过平台角色控制功能访问范围。

平台权限	角色定位	可操作范围
platform.ops	平台运营人员	拥有全部管理权限。可新建与暂停开发者组织、开通登录身份、推荐或取消推荐条目、隐藏与恢复评价、开始审核、通过、驳回、撤回上架版本、注册应用、调整实测等级、暂停、恢复、下线与重新上线应用。
platform.support	平台支持人员	拥有只读查看权限。可查看开发者组织、市场条目、审核队列与应用登记的列表和详情，无法执行任何新增、修改、审核或状态变更操作。

注意

• 审核回避原则：审核人员不能审核自己创建的版本。若尝试审核自己创建的版本，系统将拒绝访问。平台开发者组织（标注「平台自身」）创建的版本除外。
• 租户隐私与可见范围：市场中的安装数量为聚合统计数字，不展示具体是哪些租户安装。市场条目的评价对运营人员显示提交评价的租户 ID；在开发者门户中，评价对开发者保持匿名。

怎么打开

在平台运营台左侧导航栏中，你可以进入以下页面：

1. 点击「平台」分组下的「开发者组织」，查看和管理开发者组织。点击组织行可进入该组织的全貌页。
2. 点击「市场」分组下的「市场」，查看市场上架条目、处理条目推荐以及管理评价。点击条目行直接跳转至该条目的应用登记全貌页。
3. 点击「市场」分组下的「审核队列」，查看待处理与已处理的版本审核任务。点击条目行进入审核详情页。工作台中的待审核事项也会直接跳转至对应的审核详情页。
4. 点击「市场」分组下的「应用登记」（页面标题显示为「应用注册」），查看和登记应用，管理契约等级与应用运行状态。点击应用行进入应用全貌页。

界面一览

开发者与市场审核包含四个主要功能区域：

功能区域	界面入口	主要内容与功能
开发者组织	导航「平台」→「开发者组织」	展示开发者组织列表，提供新建组织入口。支持查看组织全貌、版本流水线、聚合安装数、开通登录身份以及暂停或恢复组织。
市场	导航「市场」→「市场」	展示市场上架条目。支持按类型标签与发布方筛选、按名称或 ID 搜索。提供条目推荐、取消推荐以及行内评价审核对话框。点击条目行直接进入应用登记全貌。
审核队列	导航「市场」→「审核队列」	展示待处理与已处理的版本审核任务。提供等待时长统计卡片。进入审核详情页可查看自动检查结果、上架说明与人工判断项，执行通过、驳回或撤回上架。
应用注册	导航「市场」→「应用登记」	页面标题为「应用注册」。展示已登记的应用列表、托管方式、声明等级、实测等级与生效等级。支持注册新应用以及暂停、下线、重新上线应用。

开发者组织管理

• 列表区域：
  • 页眉显示「开发者组织」，拥有写权限时显示操作按钮「新建开发者组织」。
  • 表格列包含：「名称」（平台内置组织标注「平台自身」）、「联系邮箱」、「身份组织」（显示「已开通」或「未开通」）、「状态」（显示「正常」或「已暂停」）、「创建时间」。
  • 拥有写权限且非平台内置组织时，行内提供「暂停」或「恢复」操作按钮（平台自身组织不可暂停）。
  • 列表无数据时显示「还没有开发者组织」。页脚展示开发者组织总数。
• 组织全貌页：
  • 顶部提供返回「开发者组织」链接，展示组织名称以及「正常」或「已暂停」徽章。平台内置组织额外标注「平台自身」与说明「 · 内置的开发者组织」。
  • 若未开通登录账号，界面提示「没有登录身份，开发者无法登录。」，并提供「开通登录身份」按钮。
  • 页面包含「概览」「条目」「版本动态」标签页；非平台组织额外提供「生命周期」标签页。
  • 「概览」区域包含：
    • 指标卡：「条目」（显示已上架数量）、「总安装」（说明「聚合数字，不含租户信息」）、「审核通过率」（显示审核与驳回次数，无记录时显示「还没有审核记录」）、「平均等待」（显示「不到 1 小时」、具体小时数或天数）。
    • 「版本流水线」：展示待审核、审核中、已通过未上架、已上架、已驳回流转节点。
    • 「安装分布」：展示有安装记录的应用与模板。
    • 「基本信息」：展示「开发者 ID」「联系邮箱」「登录身份」「创建时间」。
    • 「边界」提示：明确标注「这里只显示聚合数字：条目被多少租户安装，不显示是谁。」以及「开发者没有提交的草稿不会出现在这里。」。
  • 「条目」表格：包含「条目」「类型」（应用、模板、知识包、素材）、「上架版本」（未上架显示「未上架」）、「安装」（展示数字及「 个租户」）、「状态」（「正常」「已暂停」「已下线」）。无条目时提示「还没有条目」「开发者创建后出现在这里。」。
  • 「版本动态」：以时间线形式展示版本提交与流转记录。无动态时提示「还没有提交过的版本」。
  • 「生命周期」：提供暂停或恢复该开发者组织的操作。

市场与评价

• 市场列表：
  • 页眉显示「市场」。若统计服务不可用，提示「统计服务不可用，安装数暂显示 —。」。
  • 标签页提供类型筛选：「全部」、应用、模板（知识包与素材不设独立标签，直接展示在「全部」中）。
  • 筛选与搜索：提供「按发布方筛选」下拉菜单（默认选项为「全部发布方」）；搜索框占位提示「搜索名称或 ID」。
  • 列表排序：被推荐的条目排在最前面，其次按安装数降序排列，最后按条目 ID 排序。
  • 表格列：「条目」（被推荐条目展示星标，无障碍提示「推荐」）、「类型」、「发布方」（可点击跳转至对应的开发者组织全貌）、「上架版本」、「安装」、「状态」（「正常」「已暂停」「已下线」）、「更新」、行内「评价」按钮。
  • 行内推荐操作：对于已上架且状态正常的条目，提供「推荐」或「取消推荐」按钮。
  • 空状态：无条目时提示「市场里还没有条目」「审核通过的条目会出现在这里。」；搜索无匹配时提示「没有符合条件的条目」。
  • 行点击交互：点击条目行直接打开对应的应用登记全貌页，不提供独立市场条目全貌页。
• 评价对话框：
  • 点击市场行内「评价」按钮打开对话框。顶部提示「只隐藏违规评价（辱骂、广告、个人信息）；隐藏后不计入评分。」。
  • 每条评价展示星级评分、租户 ID、评价版本与评价时间；已隐藏的评价展示已隐藏徽章。
  • 运营人员在此对话框中可以看到提交评价的租户 ID。
  • 行内提供「隐藏」与「恢复」操作。无评价时提示「还没有评价。」。

审核队列与审核详情

• 审核队列：
  • 页眉显示「审核队列」。
  • 顶部指标卡：
    • 「待处理」：展示处于审核中或提示「都还没开始」的任务数。
    • 等待超过 2 天：提示「建议优先处理」或「没有超时的」。
    • 「最久等待」：展示当前排队时间最长的任务时长。
  • 标签页切换：「待处理」（包含已提交与审核中状态）与「已处理」（包含已通过、已驳回、已上架、已撤回状态）。
  • 筛选与搜索：支持按「全部类型」「应用」「模板」筛选；搜索框占位提示「搜索条目或开发者」。
  • 排序规则：「待处理」按等待时间最久优先排序；「已处理」按最近提交时间优先排序。
  • 表格列：「条目」「类型」「版本」「开发者」（无独立开发者时显示「平台」）、「状态」（待审核、审核中等；审核中显示具体审核人姓名）、「自动检查」（展示「有失败」「有提示」或「通过」）、「已等待」（待处理视图）或「提交时间」（已处理视图）。
  • 空状态：无待审版本提示「没有待审核的版本」「开发者提交版本后出现在这里。」；已处理无记录提示「还没有处理过的版本」。
• 审核详情页：
  • 顶部提供返回「审核队列」链接，展示条目名称与版本号徽章。
  • 状态信息：展示当前审核人正在审核，或显示「已通过」/「已驳回」及原因。
  • 标签页包含「审核」与「Manifest」（或「内容」）。
  • 「自动检查」面板：展示系统自动检查结果，检查项包括清单格式、内容、个人数据、访问策略、模块、版本号、界面地址、嵌入方式、声明等级、桥接能力、可执行内容、运行镜像/资源/大小/环境变量、备用页面、联邦入口/构建/哈希/扫描等，每项标注「通过」「提示」或「失败」。
  • 「上架描述与版本说明」：展示开发者填写的上架介绍与版本更新日志。
  • 「需要你判断的」审查清单（按条目类型展示）：
    • 应用：界面地址、嵌入方式（「iframe（沙箱）」或 Module Federation）、声明等级、模块、Bridge 能力、可起草的操作。
    • 模板：模板类别、对象类型、字段总数、加密字段、带访问策略的类型。
    • 知识包：文档数、总字数、标题、语言。
    • 素材：提示词/技能数、名称。
  • 审核动作按钮：已提交（submitted）时提供「开始审核」「驳回」「通过」；审核中（in_review）时提供「通过」「驳回」；已上架（published）时提供「撤回上架」。

应用注册与应用全貌

• 应用注册列表：
  • 侧栏导航为「应用登记」，页面标题为「应用注册」。
  • 表格列：「应用」、「托管」（显示「平台托管」或「外部」）、「声明等级」、「实测等级（可调整）」、「生效等级」（取声明等级与实测等级较低者，无实测等级显示「待验证」）、「状态」（「正常」「已暂停」「已下线」）、「更新时间」。
  • 右上角提供「注册应用」按钮。无数据时提示「还没有注册的应用」。
• 应用全貌页：
  • 顶部提供返回「全部应用」链接，展示托管说明（「平台托管」或「外部托管」），提供「打开应用」按钮。
  • 等级面板：展示声明等级、实测等级与生效等级，标注说明「租户按这个等级启用」。
  • 内容面板：展示 Manifest JSON 与用量卡（若有）。
  • 状态操作：正常状态提供「暂停」「下线」；已暂停状态提供「恢复」「下线」；已下线状态提供「重新上线」。

常用操作

新建开发者组织

1. 在左侧导航点击「平台」→「开发者组织」。
2. 点击右上角「新建开发者组织」。
3. 填写组织信息：

   字段	必填	说明
   「名称」	是	开发者组织名称，占位提示「例如：康复云科技」。未填提示「请填写名称」
   「开发者 ID」	是	开发者唯一标识，说明「3 到 48 位，小写字母、数字和 -，以字母开头。创建后不能修改。」。格式不正确或 ID 已存在时提示「该开发者 ID 已存在」
   「联系邮箱」	否	开发者联系邮箱。格式不正确时提示「联系邮箱格式不对」
   「首位开发者邮箱」	否	首位开发者的登录邮箱，说明「留空则只登记组织。」。格式不正确时提示「首位开发者邮箱格式不对」
   「没有 SMTP，直接显示验证码」	否	勾选框。未配置 SMTP 邮件服务时，勾选可直接在界面展示验证码

4. 点击「创建」。
5. 创建成功后，若生成了验证码，界面提示「开发者组织已创建」「请把验证码交给开发者」「未配置 SMTP，邮件不会发出。验证码只显示这一次。」。将该验证码交付开发者，由开发者在开发者门户登录。

为开发者组织开通登录身份

1. 在左侧导航点击「平台」→「开发者组织」，进入未开通身份的组织全貌页（界面提示「没有登录身份，开发者无法登录。」）。
2. 点击「开通登录身份」。
3. 填写身份信息：

   字段	必填	说明
   「首位开发者的邮箱」	是	填写首位开发者的邮箱地址
   「没有 SMTP，直接显示验证码」	否	勾选框。未配置 SMTP 时直接在界面展示验证码

4. 点击「开通」。
5. 界面显示一次性验证码，将验证码交给开发者。该验证码只显示一次。

暂停或恢复开发者组织

1. 在「开发者组织」列表行内或组织全貌的「生命周期」标签页中点击「暂停」。
2. 弹出确认提示：暂停指定开发者组织？说明「开发者几秒内无法登录或修改应用；已上架、已安装的应用继续运行。」。
3. 确认后完成暂停，界面提示「已更新」，组织状态变更为「已暂停」。
4. 需要恢复时，在行内或「生命周期」标签页点击「恢复」。
5. 系统提示「开发者可以重新登录并继续工作。」，确认后界面提示「已更新」，组织状态恢复为「正常」。

注意

平台内置组织（标注「平台自身」）不可被暂停。

推荐与取消推荐市场条目

1. 在左侧导航点击「市场」→「市场」。
2. 在列表中找到状态为「正常」且已上架的条目。
3. 点击行内「推荐」按钮。
4. 推荐成功后，条目名称前增加星标，界面提示「已推荐」，并在「租户的市场里会排在前面」。
5. 若要取消推荐，在列表中点击该条目的「取消推荐」按钮。取消后界面提示「已取消推荐」，条目星标移除。

隐藏与恢复违规评价

1. 在「市场」列表中点击目标条目行内的「评价」按钮，打开评价对话框。
2. 浏览评价列表，查看星级、租户 ID、版本与时间。
3. 找到违规评价（如辱骂、广告、泄露个人信息），点击「隐藏」。
4. 填写隐藏信息：

   字段	必填	说明
   「隐藏的原因」	是	填写隐藏原因，至少 4 个字、最多 300 个字。该原因对评价作者可见

5. 点击确认。隐藏成功后该条评价显示已隐藏徽章，不计入评分，界面提示「已隐藏，作者会收到通知」。
6. 若需取消隐藏，在已隐藏的评价项点击「恢复」，评价重新生效并计入评分，界面提示「已恢复」。

审核待上架版本

1. 在左侧导航点击「市场」→「审核队列」，在「待处理」标签页中选择待审核版本（建议优先处理等待超过 2 天的任务）。
2. 点击版本进入审核详情页。可选点击「开始审核」，版本状态变更为审核中，并显示指定人员正在审核。
3. 查看「自动检查」中的各项结果（清单格式、个人数据、界面地址、运行配置等是否为「通过」或「提示」）。
4. 对照「需要你判断的」面板核实权限范围、嵌入方式、契约实测等内容。
5. 通过审核：
   1. 点击右上角「通过」，弹出审核清单对话框。
   2. 逐项勾选「审核清单」中的合规项（应用包含权限与桥接能力最小、界面地址与嵌入方式合理、个人数据与出网合规、名称介绍分类合规、已用 k3 contract 实测；有运行时加「托管进程的共享安全」；有联邦代码加「联邦代码已读过」）。必须全部勾选后「通过」按钮才可用。
   3. 选择「实测等级」：可选「未验证」「未通过」或 L0 到 L3 等级，也可选择「不改变」保持原等级。界面提示「不选则暂不记录，应用要等你在“应用注册”里记录后才能被启用。」。
   4. 点击「通过」。版本状态更新为已通过（approved），等待开发者在开发者门户中自行上架。
6. 驳回版本：
   1. 点击右上角「驳回」，弹出驳回对话框。
   2. 选择「常用原因」模板（如申请了用不到的能力、界面地址不合规、描述不合规、契约测试未通过、内容来源或许可不清、含个人数据或有害指令、个人数据处理不当），或在「原因」输入框中手动填写驳回理由（必填，至少 4 个字）。
   3. 点击确认。版本状态变更为已驳回（rejected），记录驳回原因。开发者修改后须提交更高的新版本重新审核。

撤回已上架版本

1. 在审核详情页打开处于已上架（published）状态的版本。
2. 点击右上角「撤回上架」。
3. 弹出确认提示：撤回指定版本？说明「市场回退到上一个已上架版本；已安装的租户继续运行它。」。
4. 确认后版本状态变更为已撤回（withdrawn）。市场自动回退至上一有效上架版本。

注册新应用

1. 在左侧导航点击「市场」→「应用登记」（页面标题「应用注册」）。
2. 点击右上角「注册应用」。
3. 填写注册信息：

   字段	必填	说明
   「托管方式」	是	选择平台托管（hosted）或外部托管（external）
   「Manifest 地址」或「粘贴 JSON」	是	输入 Manifest 的访问 URL，或直接粘贴 Manifest JSON 代码。未填写提示「请提供 Manifest 地址，或粘贴 Manifest JSON」

4. 点击确认。注册成功后，若包含身份认证配置，界面将展示生成的 OIDC Client ID。

调整应用实测等级

1. 在「应用注册」列表中找到目标应用。
2. 在「实测等级（可调整）」列下拉框中选择实测等级（未验证、未通过、L0、L1、L2、L3）。
3. 选择后系统自动更新生效等级（取声明等级与实测等级中较低者）。若实测等级为未验证，生效等级显示为「待验证」，租户端无法按契约启用该应用。

暂停、恢复、下线与重新上线应用

1. 在「应用注册」列表中点击应用进入应用全貌页。
2. 根据当前状态执行操作：
   • 暂停应用：在「正常」状态下点击「暂停」。确认提示「应用将从目录隐藏，已安装的租户不能再启用。」。确认后状态变为「已暂停」。
   • 恢复应用：在「已暂停」状态下点击「恢复」。确认提示「应用重新出现在租户目录中。」。确认后状态恢复为「正常」。
   • 下线应用：在「正常」或「已暂停」状态下点击「下线」。确认提示「应用将从所有租户的目录移除。」。确认后状态变为「已下线」。
   • 重新上线：在「已下线」状态下点击「重新上线」。确认后应用恢复上线。

状态说明

版本流转状态

版本的流转经历以下状态：

draft（草稿） → submitted（待审核） → in_review（审核中） → approved（已通过） → published（已上架） → withdrawn（已撤回）
                      ↓                     ↓
                rejected（已驳回）     rejected（已驳回）

状态标识	阶段归属	状态说明
draft（草稿）	开发者端	开发者正在编辑版本，尚未提交。不进入运营台审核队列。
submitted（待审核）	待处理	开发者已提交版本，进入审核队列。运营人员可开始审核、通过或驳回。
in_review（审核中）	待处理	运营人员已点击「开始审核」，正在进行人工核查，显示审核人姓名。可执行通过或驳回。
approved（已通过）	已处理	运营人员已勾选审核清单通过审核，并记录实测等级。等待开发者在开发者门户自行上架。
published（已上架）	已处理	开发者已执行上架，版本在租户市场中正常可见。运营人员可执行「撤回上架」。
rejected（已驳回）	已处理	审核未通过，记录驳回原因。开发者不能在此版本上修改，必须提交更高版本号的新版本。
withdrawn（已撤回）	已处理	运营人员主动撤回该版本。市场回退至上一上架版本，已安装租户继续运行旧版。

条目与应用状态

• 「正常」：应用正常运行，在目录与市场中正常展示。
• 「已暂停」：应用从租户目录中隐藏，已安装的租户不能再启用。
• 「已下线」：应用从所有租户的目录中移除。已下线应用可执行「重新上线」。

开发者组织状态

• 「正常」：组织运行正常，开发者可登录开发者门户并管理条目与版本。
• 「已暂停」：开发者几秒内无法登录开发者门户或修改应用。已上架和已安装的应用不受影响，继续正常运行。平台内置组织不可暂停。

契约等级体系

• 「声明等级」：开发者在 Manifest 中声明的契约等级。
• 「实测等级」：运营人员通过契约测试验证后记录的等级（L-1…L3，对应「未验证」「未通过」或 L0–L3）。
• 「生效等级」：系统取声明等级与实测等级中的较低者（min(声明, 实测)）。若未记录实测等级，生效等级显示为「待验证」，租户端无法按契约启用该应用。

让助手帮你做

市场管理、条目推荐、版本审核与应用登记涉及平台高风险合规操作，目前不支持通过助手（Agent）进行操作。开发者组织管理、版本审核、条目推荐以及应用的注册、暂停与下线，均须由拥有权限的运营人员在运营台界面中手动完成。

设置

开发者与市场审核功能没有独立的运营设置页面。

• 审核队列中的超时预警阈值由系统固定设置：版本等待超过 2 天标记为「建议优先处理」，等待超过 5 天进行严重超时提醒。

注意事项

• 版本不可变性：
  • 版本提交后不可在线修改。若审核被驳回，开发者必须提交更高版本号的新版本，无法修改已驳回的原版本。
  • 审核「通过」并不等同于「上架」。通过后必须由开发者在开发者门户手动点击上架。
  • 系统不允许通过上架更低版本来实现市场版本回滚。
• 撤回上架影响：
  • 运营人员执行撤回上架后，市场条目将回退至上一个已上架版本。
  • 已安装被撤回版本的租户继续运行旧版本，直到租户管理员手动升级；开启了自动升级的租户会立即跟随回退版本。
• 暂停开发者组织影响：
  • 暂停开发者组织将在几秒内限制开发者登录或修改应用。
  • 该组织名下已上架、已安装的应用不受影响，继续正常运行。
  • 标注「平台自身」的内置组织不能被暂停。
• 实测等级与租户启用：
  • 应用必须在「应用注册」中记录实测等级。若实测等级未验证，生效等级显示为「待验证」，租户将无法按契约要求启用该应用。
• 数据隐私与隔离：
  • 市场条目的安装量为聚合数字，不显示具体的租户信息。
  • 运营人员在评价对话框中可以看到提交评价的租户 ID；开发者门户中评价对开发者匿名。
  • 评价隐藏原因对评价作者可见，仅用于隐藏违规评价（辱骂、广告、个人信息）。
• 条目类型范围：
  • 市场页面的分类标签当前仅包含全部、应用与模板；知识包与素材不单独设立标签，直接展示在「全部」列表中。
• 平台审计追踪：
  • 运营人员执行的审核、推荐与状态变更操作均会自动记录在平台审计与支持日志中。

目前不支持

• 独立评分页面：评价在市场列表行内通过对话框查看与隐藏，没有独立的评分汇总页面。
• 独立市场条目全貌页：在市场列表中点击条目行直接进入「应用登记」全貌，没有独立的市场条目全貌页。
• 市场列表行内暂停或下线条目：市场列表仅支持条目的推荐与取消推荐，条目的暂停与下线须在「应用注册」全貌页中操作。
• 审核任务指派与 SLA 趋势图：审核队列不支持手动指派特定审核人员，也不提供专门的 SLA 统计图表。

常见问题

为什么审核通过后，在租户的市场里看不到新版本？

审核「通过」（approved）仅代表平台合规核查完毕，系统不会自动上架该版本。必须由开发者在开发者门户中自行点击上架操作后，版本状态变为已上架（published），租户才能在市场中看到并安装。

为什么进入审核详情时提示没有权限？

系统设有审核回避机制，审核人员不能审核自己创建的版本。若当前版本是由你自己的账号创建的，系统会拒绝打开审核页。若版本归属于标注「平台自身」的平台开发者组织，则不受此限制。

为什么应用在市场显示正常，但租户端无法按契约启用？

应用的生效等级取声明等级与实测等级中的较低者。如果审核通过时未记录实测等级，或者在「应用注册」中实测等级仍处于「待验证」状态，生效等级即为「待验证」，租户端无法启用。运营人员需要在「应用注册」列表中手动选择并记录实测等级。

撤回已上架版本后，已经安装了该版本的租户会受到什么影响？

执行「撤回上架」后，市场条目会回退到上一个已上架版本。已经安装了该版本的租户将继续运行现有版本，直到管理员手动升级；若租户开启了自动升级功能，系统会立即跟随回退至上一个版本。

暂停开发者组织会导致租户已经安装的应用停止运行吗？

不会。暂停开发者组织仅限制开发者登录开发者门户或修改应用配置（在几秒内生效）；该组织名下已经上架、已经被租户安装的应用不受影响，将继续正常运行。