ZHYC 快速开发平台开发文档

平台概览

ZHYC 快速开发平台是一套企业级低代码快速开发底座，服务于后台管理系统、行业 SaaS 平台、 业务中台、移动办公和第三方系统集成。平台不是单一管理端模板，而是由核心平台、认证中心、 开放 API 网关、后台管理端、移动端和代码生成能力组成的一体化框架。

初学者阅读路线

首期核心能力

低代码组件详细使用说明

在线演示

如果只是想先体验框架功能，可以直接访问公开演示环境。演示环境覆盖后台管理、系统管理、低代码中心、工作流中心、开放平台、 AI 能力中心、全文检索和安全防护中心等核心入口。

总体架构

平台采用“核心平台模块化单体 + 独立认证中心 + 独立开放 API 网关”的首期架构。 这种形态可以保持业务开发效率，同时为统一认证和开放接口流量保留安全边界。

新手理解架构的四条线

技术基线

工作流组件详细使用说明

开发环境

开发环境的目标不是“能启动一次”，而是让后端、认证中心、前端、数据库和脚本都使用同一套版本基线。 初学者先把环境固定下来，再开始排查业务问题，否则很容易把版本问题误判成代码问题。

新手环境准备顺序

.
├── db/
├── docs/
├── zhyc-base-server/
├── zhyc-base-vue/
└── zhyc-base-uniapp/

环境变量样例

本地环境变量样例位于 docs/release/phase1.env.example。

rtk cp docs/release/phase1.env.example docs/release/phase1.env.local
# 按本机 MySQL、认证中心密钥和本机地址修改 docs/release/phase1.env.local

快速启动

首次启动按“数据库 → 种子数据 → 认证中心 → 核心平台 → 前端”的顺序执行。不要先启动前端再补数据库， 否则页面会因为认证、菜单、权限或数据缺失反复跳转或报空数据。

启动顺序和失败判断

1. 初始化数据库

rtk node zhyc-base-server/scripts/phase1-db-initializer.mjs --env-file docs/release/phase1.env.local --plan
rtk node zhyc-base-server/scripts/phase1-db-initializer.mjs --env-file docs/release/phase1.env.local --check
rtk node zhyc-base-server/scripts/phase1-db-initializer.mjs --env-file docs/release/phase1.env.local --emit-mysql

2. 生成系统基础种子数据

rtk node zhyc-base-server/scripts/phase1-seed-initializer.mjs --env-file docs/release/phase1.env.local --plan
rtk node zhyc-base-server/scripts/phase1-seed-initializer.mjs --env-file docs/release/phase1.env.local --materialize --output /tmp/zhyc-system-seed.local.sql

3. 启动认证中心

rtk env JAVA_HOME=<JDK21_HOME> \
  '/Applications/IntelliJ IDEA.app/Contents/plugins/maven/lib/maven3/bin/mvn' \
  -f zhyc-base-server/pom.xml -pl zhyc-auth-server spring-boot:run

4. 启动核心平台

rtk node zhyc-base-server/scripts/run-platform-local.mjs --env-file docs/release/phase1.env.local

5. 启动后台管理端

rtk npm --prefix zhyc-base-vue install
rtk npm --prefix zhyc-base-vue run dev

新手实战：供应商分类模块

本节用“供应商分类”作为练习业务。它足够简单，可以覆盖数据库、后端接口、前端列表表单、权限菜单、低代码建模和验证； 又不会一开始引入复杂审批、附件、开放 API 等额外难度。初学者可以按本节顺序做一遍，再迁移到真实业务模块。

实战目标

字段设计样例

权限编码样例

后端接口清单

低代码建模配置

验收清单

• 使用有权限账号可以完成查询、新增、编辑、删除、启用、停用。
• 使用无新增权限账号看不到新增按钮，直接调用新增接口返回权限拒绝。
• 同一租户内重复分类编码保存失败，不同租户可以使用相同编码。
• 删除一级分类时，如果存在子分类或供应商引用，接口返回业务错误。
• 表格空数据、加载中、保存中、接口失败都有可见状态。
• 后端测试、前端类型检查、页面手工验收结果写入交付说明。

工程结构

看工程结构时先分清“运行入口”和“业务模块”。运行入口负责把模块组装起来，业务模块只负责自己的领域能力。 初学者开发新业务时，不要把代码直接塞进启动模块，应先判断归属模块或新建独立模块。

新手找文件方法

后端模块

推荐包结构

com.zhyc.<module>
  ├── api
  ├── controller
  ├── service
  ├── service.impl
  ├── repository
  ├── mapper
  ├── domain
  ├── dto
  ├── convert
  ├── permission
  ├── event
  ├── config
  └── constant

模块开发组件总览

开放 API 组件详细使用说明

后端开发

后端开发先记住一个原则：Controller 只接收请求和返回响应，Service 负责业务动作，Repository/Mapper 负责数据访问。 新手写接口时可以按下面的步骤从 DTO 开始，最后再补权限、租户、异常和测试。

新手开发一个后端业务接口

后端常见文件怎么写

分层规则

接口约定

• 所有对外接口必须返回统一响应结构，禁止直接返回裸字符串、裸 Map 或框架异常。
• 后台管理接口必须配置 Shiro 权限标识，权限编码要能映射到菜单或按钮权限。
• 租户业务查询、更新、删除必须带租户上下文。
• 敏感字段禁止写入明文日志，包括密码、密钥、Token、身份证、手机号完整值。

REST 接口命名速查

后端组件使用细则

后端组件详细使用说明

典型接口骨架

/**
 * 查询业务列表。
 *
 * <p>按当前租户和查询条件分页返回业务数据，接口必须绑定菜单查询权限。</p>
 */
@RequiresPermissions("module:resource:query")
public ApiResult<PageResult<ResourceResponse>> page(ResourceQueryRequest request) {
  return ApiResult.success(resourceService.page(request));
}

模块测试命令

rtk env JAVA_HOME=<JDK21_HOME> \
  '/Applications/IntelliJ IDEA.app/Contents/plugins/maven/lib/maven3/bin/mvn' \
  -f zhyc-base-server/pom.xml -pl <module> -am test

后台前端开发

后台管理端位于 zhyc-base-vue，使用 Vue 3、Vite、TypeScript、Ant Design Vue、 Pinia 和 Vue Router。页面开发优先复用现有布局、API client、权限指令和状态处理模式。

新手先掌握的前端概念

目录约定

zhyc-base-vue/src
├── api/          # API client 和类型
├── router/       # 路由定义
├── utils/        # 认证、权限、上下文等工具
└── views/        # 业务页面

页面开发要求

• 页面不得直接拼接后端 URL，必须走 src/api 封装。
• 请求、响应和页面状态必须具备 TypeScript 类型。
• 新增、修改、删除、导出、发布等按钮必须绑定权限。
• 表单必须声明 Ant Design Vue 校验规则、触发方式和错误提示。
• 页面必须具备加载、失败、空数据状态。
• 删除、禁用、发布、撤回等危险操作必须二次确认。

开发一个业务功能的前端落地流程

前端控件选型和属性说明

字段类型到前端控件映射

表单控件规则模板

const formRules: Record<string, Rule[]> = {
  code: [
    { required: true, message: '请输入业务编码', trigger: 'blur' },
    { min: 2, max: 64, message: '业务编码长度为 2-64 个字符', trigger: 'blur' },
  ],
  name: [
    { required: true, message: '请输入业务名称', trigger: 'blur' },
    { max: 100, message: '业务名称不能超过 100 个字符', trigger: 'blur' },
  ],
  status: [
    { required: true, message: '请选择状态', trigger: 'change' },
  ],
  effectiveDate: [
    { required: true, message: '请选择生效日期', trigger: 'change' },
  ],
};

业务页面控件组合示例

<template>
  <section class="module-page">
    <a-card title="业务管理" :bordered="false">
      <template #extra>
        <a-space wrap>
          <a-input-search
            v-model:value="query.keyword"
            placeholder="请输入编码或名称"
            allow-clear
            :loading="loading"
            @search="handleSearch"
          />
          <a-select
            v-model:value="query.status"
            placeholder="状态"
            allow-clear
            :options="statusOptions"
            style="width: 140px"
            @change="handleSearch"
          />
          <a-range-picker
            v-model:value="query.createdRange"
            value-format="YYYY-MM-DD HH:mm:ss"
            show-time
            @change="handleSearch"
          />
          <a-button @click="resetQuery">重置</a-button>
          <a-button type="primary" @click="openCreate">新增</a-button>
        </a-space>
      </template>

      <a-alert v-if="errorMessage" :message="errorMessage" type="error" show-icon closable />

      <a-table
        row-key="id"
        :columns="columns"
        :data-source="records"
        :loading="loading"
        :pagination="pagination"
        @change="handleTableChange"
      >
        <template #bodyCell="{ column, record }">
          <a-tag v-if="column.key === 'status'" :color="statusMap[record.status]?.color">
            {{ statusMap[record.status]?.label || '未知' }}
          </a-tag>
          <a-space v-if="column.key === 'action'">
            <a @click="openEdit(record)">编辑</a>
            <a-popconfirm title="确认删除该记录？" @confirm="handleDelete(record)">
              <a class="danger-link">删除</a>
            </a-popconfirm>
          </a-space>
        </template>
      </a-table>
    </a-card>

    <a-modal
      v-model:open="formOpen"
      :title="formTitle"
      :confirm-loading="saving"
      destroy-on-close
      @ok="handleSubmit"
      @cancel="closeForm"
    >
      <a-form ref="formRef" :model="formModel" :rules="formRules" layout="vertical">
        <a-form-item label="业务编码" name="code">
          <a-input v-model:value="formModel.code" maxlength="64" allow-clear />
        </a-form-item>
        <a-form-item label="业务名称" name="name">
          <a-input v-model:value="formModel.name" maxlength="100" allow-clear />
        </a-form-item>
        <a-form-item label="状态" name="status">
          <a-select v-model:value="formModel.status" :options="statusOptions" />
        </a-form-item>
        <a-form-item label="排序号" name="sortNo">
          <a-input-number v-model:value="formModel.sortNo" :min="0" :max="9999" style="width: 100%" />
        </a-form-item>
        <a-form-item label="备注" name="remark">
          <a-textarea v-model:value="formModel.remark" :maxlength="500" show-count :auto-size="{ minRows: 3, maxRows: 6 }" />
        </a-form-item>
      </a-form>
    </a-modal>
  </section>
</template>

后台页面组件使用细则

后台页面组件详细使用说明

列表页基础骨架

<template>
  <section class="module-page">
    <a-card title="业务列表" :bordered="false">
      <template #extra>
        <a-space>
          <a-input-search v-model:value="keyword" placeholder="关键字" @search="loadList" />
          <a-button :loading="loading" @click="loadList">刷新</a-button>
          <a-button type="primary" @click="openCreateForm">新增</a-button>
        </a-space>
      </template>
      <a-alert v-if="errorMessage" :message="errorMessage" type="error" show-icon />
      <a-table row-key="id" :columns="columns" :data-source="records" :loading="loading" />
    </a-card>
  </section>
</template>

前端验证

rtk npm --prefix zhyc-base-vue run typecheck
rtk npm --prefix zhyc-base-vue run build

数据库与租户

首期采用共享库共享表，通过 tenant_id 做租户隔离。所有租户业务表和查询不得遗漏租户条件。

新手建一张业务表的步骤

表前缀规范

通用字段

id BIGINT NOT NULL COMMENT '主键'
tenant_id VARCHAR(64) NOT NULL COMMENT '租户业务编码，用于共享表模式下的数据隔离'
created_by BIGINT NULL COMMENT '创建人用户 ID'
created_at DATETIME NOT NULL COMMENT '创建时间'
updated_by BIGINT NULL COMMENT '最后更新人用户 ID'
updated_at DATETIME NOT NULL COMMENT '最后更新时间'
deleted TINYINT NOT NULL DEFAULT 0 COMMENT '逻辑删除标识'
version INT NOT NULL DEFAULT 0 COMMENT '乐观锁版本号'
remark VARCHAR(500) NULL COMMENT '备注'

业务表 DDL 模板

CREATE TABLE pur_supplier_category (
  id BIGINT NOT NULL COMMENT '主键',
  tenant_id VARCHAR(64) NOT NULL COMMENT '租户业务编码，用于共享表模式下的数据隔离',
  category_code VARCHAR(64) NOT NULL COMMENT '供应商分类编码，同一租户内唯一',
  category_name VARCHAR(100) NOT NULL COMMENT '供应商分类名称',
  parent_id BIGINT NULL COMMENT '父级分类 ID，空值表示一级分类',
  sort_no INT NOT NULL DEFAULT 100 COMMENT '排序号，值越小越靠前',
  status VARCHAR(20) NOT NULL COMMENT '状态：ENABLED 启用，DISABLED 停用',
  created_by BIGINT NULL COMMENT '创建人用户 ID',
  created_at DATETIME NOT NULL COMMENT '创建时间',
  updated_by BIGINT NULL COMMENT '最后更新人用户 ID',
  updated_at DATETIME NOT NULL COMMENT '最后更新时间',
  deleted TINYINT NOT NULL DEFAULT 0 COMMENT '逻辑删除标识',
  version INT NOT NULL DEFAULT 0 COMMENT '乐观锁版本号',
  remark VARCHAR(500) NULL COMMENT '备注',
  PRIMARY KEY (id),
  UNIQUE KEY uk_pur_supplier_category_code (tenant_id, category_code),
  KEY idx_pur_supplier_category_status (tenant_id, status, deleted),
  KEY idx_pur_supplier_category_parent (tenant_id, parent_id, deleted)
) COMMENT='供应商分类表';

数据库组件使用细则

数据库组件详细使用说明

扩展模块组件详细使用说明

低代码开发

低代码中心是平台的核心生产力能力，负责把业务库物理表、在线建模、字段元数据、页面模型和代码生成串联起来。 数据表建模既可以从数据源加载业务表结构导入，也可以先新建模型再生成数据库表。

新手从表到代码的完整路径

数据源加载规则

• 根据选中的数据源加载全部业务表结构，页面下拉只展示可导入的业务物理表。
• 默认过滤系统、流程、开放平台、可视化等平台内部表，例如 sys_*、openapi_*、visual_*、wf_* 和工作流引擎表。
• 如果业务库和平台库共库部署，表加载仍然以过滤规则保护平台基础表，避免误导入系统菜单、权限、流程和可视化配置表。
• 导入为模型后，字段配置作为代码生成、DDL 生成和页面生成的统一输入。

从已有业务表导入模型

先建模型再生成数据库表

当业务还没有物理表时，可以先在数据表建模中新建模型，再维护字段配置并生成 DDL。 该模式适合新业务从零设计表结构，生成前必须检查租户字段、逻辑删除字段、主键策略、索引和字段注释。

• 模型编码用于代码包名、接口路径和前端文件名，创建后不要频繁变更。
• 物理表名必须符合数据库命名规范，业务表不要使用平台保留前缀。
• 字段类型由平台类型映射到数据库方言类型，长度、精度、必填、主键和自增会影响 DDL。
• 保存模型只保存元数据；发布或生成 DDL 前必须预览 SQL，确认不会覆盖已有表。

生成链路

1. 创建或导入表模型。
2. 维护字段编码、字段名称、类型、长度、精度、必填、主键、自增等元数据。
3. 配置页面模型、关系模型、生成模板和权限编码。
4. 预览生成文件，确认覆盖策略和哈希记录。
5. 生成后端、后台前端、SQL、接口文档或移动端预留页面。

生成质量要求

• 后端模板必须生成 Controller、Service、Mapper、DTO、测试和中文注释。
• 前端模板必须生成 API client、类型、列表、表单、详情和权限按钮。
• SQL 模板必须生成表注释、字段注释、索引、租户字段和逻辑删除字段。
• 生成结果默认输出到预览或受控目录，不直接覆盖人工修改代码。

低代码组件使用细则

工作流开发

工作流中心通过平台工作流门面集成 Flowable。业务模块不得直接依赖 Flowable API， 只通过平台门面发起流程、处理任务、查询状态和写入审批记录。

新手接入一个审批业务

核心对象

业务接入步骤

1. 定义业务单据状态，例如草稿、审批中、通过、驳回、撤回、终止。
2. 完成业务表单和业务唯一键设计。
3. 创建流程模型并绑定业务表单。
4. 业务模块调用工作流门面发起流程。
5. 审批、驳回、撤回时写审批记录并同步业务状态。

业务状态与流程动作矩阵

工作流组件使用细则

开放 API 开发

开放 API 面向第三方系统集成和开发者门户。API Key 适合系统到系统集成，OAuth2/OIDC 适合第三方应用授权访问。

新手开放一个接口给第三方

安全链路

• API Key 调用必须校验时间戳、nonce、签名和权限。
• OAuth2 调用必须校验访问令牌、租户、应用授权和 API 权限。
• 网关必须记录应用、接口、结果、耗时和错误码。
• 对外错误码必须稳定，不能暴露 Java 异常类名和内部堆栈。

API Key 签名字段示例

签名原文建议格式：
METHOD + "\n" +
PATH + "\n" +
QUERY_STRING + "\n" +
BODY_SHA256 + "\n" +
TIMESTAMP + "\n" +
NONCE

校验顺序：
1. 校验应用状态和有效期
2. 校验时间戳窗口
3. 校验 nonce 是否重复
4. 校验签名
5. 校验租户、API 授权和限流

开放平台菜单

开放 API 组件使用细则

AI 能力中心

AI 能力中心用于统一接入大模型，并把 AI 能力安全地融合到后台页面、低代码、工作流、开放 API 和知识库场景。 平台规划见 AI 大模型能力中心规划设计。

开发边界

业务接入流程

1. 在 AI 能力中心配置模型供应商，密钥只保存密钥引用。
2. 创建 AI 应用，绑定默认模型、可用模型、配额策略和安全策略。
3. 配置提示词模板，明确变量、版本和发布状态。
4. 如需企业知识问答，创建知识库并完成文档解析、切片和向量化。
5. 业务页面、低代码、工作流或开放 API 通过 AI 应用编码调用 AI 能力。
6. 上线前检查权限、租户、配额、安全命中、调用审计和失败兜底。

模型供应商配置说明

模型、应用和提示词怎么配合

供应商测试失败排查

• 提示“解析密钥前必须绑定租户上下文”：检查登录状态、租户上下文和密钥所属租户。
• HTTP 401：优先检查 API Key 是否正确、是否过期、是否属于所选供应商，以及基础地址是否匹配供应商类型。
• 密钥下拉为空：先到系统管理的密钥中心新增 API 密钥，确认状态启用且当前租户可见。
• 模型调用失败但供应商测试通过：检查模型编码、模型权限、应用状态、配额策略和安全策略。

融合场景

扩展模块

扩展模块是业务系统常用的通用能力。新手开发业务时不要重复造消息、文件、作业、内容、检索这些基础能力， 先判断是否可以接入已有扩展模块。

新手选择扩展模块的方法

扩展模块组件使用细则

全文检索初始化和使用

1. 执行数据库初始化和种子脚本，确认全文检索菜单、索引配置表、重建任务表和检索日志表已创建。
2. 进入全文检索配置页面，新增索引编码、索引名称、来源表、主键字段、标题字段、内容字段和过滤字段。
3. 对需要检索的业务表执行重建任务，等待任务状态完成。
4. 在业务页面或全局检索入口发起搜索，后端按租户、权限和过滤字段返回结果。
5. 上线前查看检索日志，确认关键词、耗时、命中数量和失败原因可追踪。

权限与安全

权限与安全不是上线前才补的内容，而是每个接口、每张表、每个按钮设计时就要同步考虑。 初学者可以按“身份、权限、租户、数据、日志、密钥”六个维度检查。

新手安全检查表

权限编码

模块:资源:动作[:扩展]

常用动作包括 view、query、create、update、delete、export、import、enable、disable、publish、deploy、approve、reject、revoke。

安全门禁

• 后台管理接口必须有 Shiro 权限控制。
• 开放 API 必须有 API Key 签名或 OAuth2/OIDC 校验。
• 租户业务表和查询不得遗漏 tenant_id 隔离。
• 认证中心、开放 API 网关和核心平台之间只共享 Token、签名和权限契约，不共享内部实现类。
• 不得提交密钥、Token、密码、个人隐私或本地环境配置。

安全防护中心

安全防护中心位于系统管理菜单下，用于把三级等保常见的访问来源统计、违规发现、IP 封禁、访问限制规则和运行时拦截做成可配置能力。 新手先理解“看板、策略、访问限制、封禁、事件”五个对象，再开发扩展功能。

数据库和菜单初始化

• V5__system_security_protection.sql 创建 sys_security_policy、sys_security_event、sys_security_ip_block 三张表。
• V2__system_seed.sql 保留安全防护中心一个菜单入口，并把访问限制查询、保存、校验权限挂到该菜单下。
• V6__system_security_protection_menu.sql 用于已初始化数据库补齐并合并安全防护中心菜单和平台管理员角色授权。
• 运行时拦截由核心平台 PlatformSecurityProtectionFilter 完成，配置项为 zhyc.security.protection.enabled。

开发扩展步骤

1. 先在 Service 测试中补充风险场景，例如 CIDR 命中、封禁过期、策略停用。
2. 再扩展 SysSecurityProtectionService，保持租户、IP、策略编码和阈值校验在服务层完成。
3. 新增接口必须写 @RequiresPermissions，权限编码同步到菜单脚本。
4. 前端新增按钮必须同时绑定 v-permission，并提供 loading、错误提示和空状态。
5. 上线前执行后端测试、前端类型检查、权限门禁、敏感配置和 SQL 安全验证。

常见问题

验证与质量门禁

变更完成前必须按变更范围执行匹配验证，并在交付说明中列出命令、结果和未覆盖风险。

新手验证顺序

交付说明模板

变更范围：
- 后端：
- 前端：
- 数据库：
- 权限菜单：
- 低代码/工作流/开放 API：

已执行验证：
- rtk ...
- rtk ...

验证结果：
- 通过：
- 未覆盖：
- 未覆盖原因：

安全与租户检查：
- 后台接口权限：
- 租户隔离：
- 敏感信息：
- 审计日志：

剩余风险：
- 

回滚建议：
- 

手工验收用例模板

部署发布

发布不是简单执行构建命令。初学者需要先确认数据库脚本、环境变量、密钥、回滚方案和验证记录，再进入发布窗口。

新手发布流程

发布前检查

• 确认数据库脚本、补丁脚本、回滚方案和种子数据。
• 确认认证中心、核心平台、开放 API 网关的环境变量和密钥来源。
• 确认前端构建产物、API 地址、OAuth2 回调地址和跨域配置。
• 确认监控、日志、审计、异常告警和访问限制策略。
• 确认版本说明、变更范围、验证记录和剩余风险。

常用构建命令

rtk env JAVA_HOME=<JDK21_HOME> \
  '/Applications/IntelliJ IDEA.app/Contents/plugins/maven/lib/maven3/bin/mvn' \
  -f zhyc-base-server/pom.xml -pl zhyc-platform-app -am test

rtk npm --prefix zhyc-base-vue run build
rtk npm --prefix zhyc-base-uniapp run build:h5

回滚方案模板

更完整的本地运行和发布流程见 本地运行手册。

功能效果图

以下截图覆盖当前后台管理端一级菜单。移动端效果图后期随移动端版本计划更新。

常见问题

1. 为什么后台总是跳转统一认证？

优先检查本地运行时上下文、访问令牌过期时间、刷新令牌、认证中心地址、前端回调地址和 BFF 令牌刷新接口。令牌过期或接口返回 401 时，前端会清理上下文并跳转登录。

2. 低代码数据源为什么加载不到表？

检查数据源连接、密钥解析器、数据库账号权限和方言能力。加载业务表时会过滤系统、流程、开放平台和可视化等平台内部表。

3. 新增业务模块要从哪里开始？

先设计数据库表和权限编码，再补后端模块、API client、后台页面、菜单权限和验证命令。若适合生成，优先走低代码表模型和模板生成。

4. 移动端当前是否展示效果图？

当前文档仅保留移动端规划说明，不展示移动端效果图；后续随移动端版本计划更新。

5. 初学者应该先开发哪个业务练手？

建议先做一个简单字典类或主数据类业务，例如“供应商分类”或“物料分类”。它能覆盖建表、接口、列表、表单、权限和验证，但不会一开始就引入复杂审批和开放 API。

6. 为什么接口能查到数据但页面不显示？

优先检查 API client 返回类型、表格 data-source、分页字段映射、列 dataIndex 和接口响应结构。常见原因是后端返回 records，前端却读取了 list。

7. 为什么删除按钮隐藏了但接口还能被调用？

前端隐藏按钮只能改善体验，不能作为安全边界。必须在后端 Controller 绑定 Shiro 权限，并在 Service 层确认租户和状态边界。

8. 修改数据库表后还要改哪里？

需要同步检查实体、DTO、Mapper 列清单、前端类型、表格列、表单字段、低代码字段模型、初始化脚本或补丁脚本，以及相关测试数据。

9. 为什么添加密钥后供应商里仍然选不到？

先确认密钥类型是 API 密钥、状态为启用、所属租户与当前登录租户一致，并且页面已刷新密钥选项。供应商只保存密钥引用，不读取或展示密钥明文。

10. 供应商测试 401 怎么处理？

401 通常表示供应商拒绝认证。检查 API Key 是否有效、是否绑定了正确供应商、基础地址是否正确、模型服务是否要求额外组织或项目权限。平台不会把明文密钥写入日志，排查时只看密钥编码和供应商响应摘要。

11. 未登录为什么不能先看到页面？

后台和移动端受保护页面都必须先完成统一认证。未登录、令牌过期或上下文缺失时，前端会跳转登录页，不渲染菜单、表格、表单或业务数据，避免敏感信息短暂暴露。