# 数据、存储与导出

组织管理员在「数据」里按数据类型查看、筛选、新建、编辑、删除以及导入导出业务记录；在「存储」里把新文件改存到自带桶或改回平台存储；在「素材库」里只读查看已安装素材包。数据类型的字段定义在「数据模型」（详见[模型与 Agent 设置](/admin/models)），审计归档在「审计日志」（详见[安全、水印与审计](/admin/security)）。

## 谁能用

页面权限由组织角色决定。系统支持「管理员」「审计员」「分析员」「成员」四种角色：

| 页面 | 导航名称 | 所属分组 | 侧栏可见角色 | 页面读取权限 | 页面写入权限 |
|---|---|---|---|---|---|
| `/data` | 「数据」 | 「数据」 | 仅管理员 | 管理员；审计员通过直接访问链接只读查看 | 仅管理员；记录级操作可被类型的「谁可以操作」收窄 |
| `/storage` | 「存储」 | 「数据」 | 仅管理员 | 管理员；审计员通过直接访问链接只读查看（显示「只读」「审计员只能查看。」） | 仅管理员 |
| `/assets` | 「素材库」 | 「数据」 | 仅管理员 | 管理员、审计员、分析员、成员均可读取 | 本页面无写入操作 |
| `/models` | 「数据模型」 | 「数据」 | 仅管理员 | 详见[模型与 Agent 设置](/admin/models) | 详见[模型与 Agent 设置](/admin/models) |

权限规则与限制：
- 分析员或普通成员直接访问「数据」或「存储」页面时，界面展示空状态提示「没有权限」与「你的账号角色不允许查看这个页面。请联系租户管理员。」。
- 业务记录的默认权限为：管理员和成员可写，所有角色可读，仅管理员可删除；审计员始终只读。在具体数据类型上还可通过设置「谁可以操作」进一步收窄记录级权限。
- 数据导出仅限管理员本人在界面操作；助手与支持会话不能导出。
- 平台应急支持会话不能读取「素材库」。
- 存储配置的读取权限对管理员、审计员开放，助手也可代读（但不会返回密钥明文）；修改配置仅限管理员。

## 怎么打开

1. 登录[工作台](/guide/workspace)。
2. 在左侧套件分组中打开「行政」→「我的组织」。
3. 在左侧导航点击「数据」分组，根据需要进入对应页面：
   - 点击「数据」进入业务数据记录管理。
   - 点击「存储」进入对象存储配置。
   - 点击「素材库」进入已安装素材包浏览。
   - （同分组下还包含「数据模型」与「知识库」）

从助手或已发出的链接进入时，可直达「数据」「存储」或「素材库」。

页面链接与跳转规则：
- 「数据」页面可按数据类型打开；未指定类型时，默认选中列表中的第一个类型。
- 在「数据模型」列表中点击单行内的「数据」链接，可直接跳转至「数据」页面并自动选中该类型。
- 若组织内尚未创建任何数据类型，「数据」页面展示空状态并提供「去数据模型」按钮。
- 若组织内尚未安装任何素材包，「素材库」页面展示空状态并提供「去市场」链接，引导前往[应用与市场](/admin/apps)安装素材包。
- 工作台概览的开通清单中，「建立数据模型」项会直接链接至「数据模型」。
- 助手可以读取组织的数据类型列表，但不会读取记录正文内容。
- 「数据」页面目前不会根据链接自动定位到某一条记录。

## 界面一览

### 1. 数据（/data）

页头显示「数据」。页面右上角提供「导出 CSV」按钮；具备写入权限时同时提供「导入」与「新建」按钮。

![「数据」记录列表](/shots/admin-data.webp)

图：「数据」记录列表

1. 页头「数据」
2. 「导出 CSV」（本人操作；助手与支持会话不能导出）
3. 「导入」：第一行为字段标识，一次最多 1000 行
4. 「新建」一条记录
5. 类型下拉：按数据类型看记录

- **类型切换**：顶部下拉菜单（aria 标签「数据类型」）用于切换查看不同的数据类型。
- **排序控制**：排序下拉菜单（aria 标签「排序」）提供「最新创建在前」以及各个可用字段的升序与降序选项。敏感字段不参与排序。
- **筛选区域**：
  - 点击「添加筛选」可增加筛选行，每行包含字段、条件、筛选值。
  - 条件支持：「等于」「不等于」「属于」「小于」「不大于」「大于」「不小于」「包含」「介于」。
  - 筛选值输入框占位提示根据条件变化：「起,止」（用于「介于」）、「值1,值2」（用于「属于」）或「值」。
  - 已添加的筛选行右侧提供移除按钮（aria 标签「移除筛选」）。
  - 敏感字段不支持作为筛选条件。
- **数据表格**：
  - 列结构：默认最多展示 6 个非长文本字段，后接「更新」时间列；具备写入权限时展示操作列，包含「编辑」与删除按钮。
  - 单元格内容：空值显示「—」；已打码的敏感字段显示锁图标与「已加密」；布尔字段显示「是」或「否」；多关联字段显示「N 项」；日期时间按标准格式展示；枚举字段显示枚举徽章。
- **底栏信息**：
  - 左侧展示「共 」+ 记录条数 +「 条」。
  - 当启用排序且当前页满 25 条时，底栏追加提示「排序时只显示前 」+ 25 +「 条」。
  - 右侧提供翻页按钮「上一页」与「下一页」（处于排序状态时，「下一页」按钮禁用）。
- **空状态展示**：
  - 筛选无匹配：「没有符合条件的记录」「换一个筛选条件。」。
  - 类型下无数据：「还没有……」（无数据时提示「还没有」加上类型名称）；具备写入权限时提示「点右上角“新建”，或导入 CSV。」。
  - 组织内无数据类型：「还没有数据类型」「先到「数据模型」定义一个类型。」，提供按钮「去数据模型」。
  - URL 中的类型标识无效：「没有这个数据类型」。
- **导入对话框**：
  - 标题显示「导入 {名称}」。
  - 规则说明：「第一行为字段标识，一次最多 1000 行，多值用分号分隔。出错的行会跳过。」。
  - 导入结果展示：成功时显示「成功 」后接行数与「 行」，包含失败行时追加展示「，失败 」后接行数与「 行」；行错误明细逐条列出第几行、哪个字段以及原因（最多列出 50 条）。
- **删除确认弹窗**：
  - 标题显示「删除 ……？」（包含记录标题）。
  - 说明：「永久删除，无法恢复。被其他记录引用的记录不能删除。」。
  - 提供「删除」按钮，成功后提示「已删除」。
- **记录表单（新建 / 编辑）**：
  - 标题：新建时显示「新建……」，编辑时显示「编辑 ……」。
  - 「归属部门」：当用户具备多部门写入权限时显示。新建时提示「按部门查看数据的人据此看到它」；编辑时提示「改归属后，可见范围随之变化」。
  - 敏感字段：带有锁图标（aria 标签「加密存储」）；已加密字段输入框占位显示「已加密，留空不变」。
  - 布尔字段：提供选项「（未填）」「是」「否」。
  - 关联字段：选项显示「（无）」、「没有可选的记录」或「加载中…」，多选候选最多加载 200 条。
  - 并发冲突：若他人已先提交修改，表单提示「这条记录刚刚被别人修改了。关闭后重新打开，在最新内容上再改。」。
  - 底部操作：提供「取消」与「保存」按钮。保存成功后提示「已保存」或「已创建」。

### 2. 存储（/storage）

页头显示「存储」。未开放自带存储时显示「自带存储不可用」「只能使用平台存储。」；审计员访问时显示「只读」「审计员只能查看。」。

![「存储」：当前用平台存储](/shots/admin-storage.webp)

图：「存储」：当前用平台存储

1. 页头「存储」
2. 三卡：当前使用、已存文件、最近一次测试
3. 默认平台存储由运营方维护
4. 「使用自己的存储」：S3 兼容（MinIO、OSS、COS 等）

页面顶部展示三张统计与状态卡片：
- **「当前使用」**：展示当前生效的存储模式，为「自带存储」或「平台存储」。使用自带存储时，卡片内展示桶名、` @ ` 以及端点地址。
- **「已存文件」**：展示已存文件的字节数或「—」。下方说明根据统计情况分别显示「暂时无法统计。」、「当前存储中的总量。」或「只统计了前 5 万个文件，实际更多。」。
- **「最近一次测试」**：展示存储连通性测试结果，为「通过」「失败」或「未测试」。使用自带存储时提示「点击下方“重新测试”。」；使用平台存储时提示「平台存储由运营方维护。」。

主配置区域包含以下部分：
- **「存储位置」**：提供开关「使用自己的存储」，说明为「S3 兼容存储（MinIO、AWS S3、OSS、COS 等）」。
- **「连接设置」**：
  - 准备指引：提示「请先在你的存储里准备好」—「创建存储桶。」「创建访问密钥，需要这个桶的读、写、列出、删除权限。」「配置 CORS（见下方），否则浏览器无法直传。」。
  - 快速填充：提供预设按钮「MinIO / SeaweedFS / Ceph（自建）」「Amazon S3」「阿里云 OSS」「腾讯云 COS」。
  - 设置字段：包含「端点」（必填）、「浏览器访问地址」（提示「留空则与端点相同。端点仅内网可达时填写。」）、「存储桶」、「路径前缀」（提示「可选，例如 kwork」）、「区域」、「访问密钥 Access Key」（已保存时显示徽章「已保存」）、「私有密钥 Secret Key」以及「路径风格寻址」（提示「MinIO、SeaweedFS 开启，AWS、OSS、COS 关闭。」）。
  - 操作按钮：提供「重新测试已保存的设置」（仅复测当前已保存参数，不改动表单输入）、「只测试，不保存」（仅测试表单填写的参数，不入库）与「测试并保存」（测试通过后保存；测试未通过则不保存）。
- **测试结果与步骤**：
  - 测试覆盖步骤依次为：「连接与权限」「写入」「读取」「列出」「预签名上传」「浏览器跨域（CORS）」「删除」。
  - 失败提示：「没有通过连通性测试，设置没有保存。」或「没有通过连通性测试。」，并提示「见下方标红的一步。」。
  - 跨域访问警告会先写出探测详情，再提示服务器访问不到不一定有问题，请确认浏览器能访问，并配置跨域访问。
  - 成功提示：「连通性测试通过」；保存成功提示「已保存，新上传的文件会写入你的存储」。
- **「存储桶 CORS 配置」**：
  - 说明：「把下面的配置应用到存储桶（MinIO 用」`mc cors set`「，其他在控制台的 CORS 页面）。」，下方给出跨域配置代码块。
- **改回平台存储**：
  - 当关闭「使用自己的存储」开关时，展示面板「将改回平台存储」，说明「新文件会放回平台存储。你存储桶里已有的文件不会被删除，但改回期间无法访问。」，提供按钮「改回平台存储」。
  - 二次确认弹窗提示「改回平台存储？」「你存储桶里已有的文件不会被删除或迁移。」，点击「改回」后提示「已改回平台存储」。

### 3. 素材库（/assets）

页头显示「素材库」。用于查看在应用市场中已安装并启用的素材包。

- **页签切换**：顶部提供「全部」「提示词」「技能」三个页签。
- **搜索框**：占位提示「搜名称、说明、正文…」。
- **状态与空态**：
  - 部署环境未开启时提示「这个部署没有启用素材库。」。
  - 搜索或筛选无结果时提示「没有符合的素材」「换个关键词，或者切换类型。」。
  - 组织尚未安装素材包时提示「还没有安装素材包」「去市场安装一个素材包。」，并提供按钮「去市场」。
- **素材卡片**：
  - 分组标题显示版本号与条目数。
  - 带有分类徽章「提示词」或「技能」。
  - 提供操作按钮「复制正文」。
- **只读特性**：本页面为只读展示，不提供上传、修改或删除素材的操作。

### 4. 审计归档（在「审计日志」）

审计日志归档功能位于「合规」分组下的「审计日志」页面（详见[安全、水印与审计](/admin/security)），不包含在「数据」页面内：
- 包含「审计归档」小节，提供「完整校验」功能。
- 状态分为「已封存至」「最新」「待封存」「数据库内」，以及「已锁定」「有独立副本，未锁定」「尚未归档」。
- 「封存分段」列表展示「范围」「时间」「大小」、SHA-256 哈希值与「锁定至」时限。
- 提供「导出全部」审计链按钮，成功提示「已导出完整审计链（导出本身也会被记录）」。
- 底栏展示「显示 N 条（最多 200 条，更早的记录在审计归档里）」。

## 常用操作

### 查看与筛选记录

1. 在左侧导航点击「数据」分组下的「数据」。
2. 在顶部「数据类型」下拉菜单中选择要查看的数据类型。
3. 若需要过滤记录，点击「添加筛选」选择字段与条件（如「等于」「包含」「介于」等），并输入筛选值。多项筛选可重复点击添加；不需要的筛选行点击「移除筛选」删除。
4. 若需要排序，在「排序」下拉菜单中选择「最新创建在前」或指定字段的升序/降序。
5. 在底栏查看记录总数（显示「共 」+ 条数 +「 条」），点击「上一页」或「下一页」翻页。

> **提示**
>
> 敏感字段（加密存储）不支持筛选与排序。列表默认每页展示 25 条记录；当启用字段排序且当前页满 25 条时，系统只展示前 25 条记录，底栏「下一页」按钮会自动禁用。

### 新建记录

![「新建客户」](/shots/admin-data-new.webp)

图：「新建客户」

1. 有多部门时「归属部门」：按部门看数据的人据此看到它
2. 类型字段：名称必填
3. 邮箱、手机、阶段等按数据模型来
4. 「保存」

1. 在左侧导航点击「数据」分组下的「数据」。
2. 在顶部下拉菜单中选择目标数据类型。
3. 点击页面右上角「新建」。
4. 在「新建……」弹窗中填写表单：
   | 字段类型 | 输入方式 | 说明 |
   |---|---|---|
   | 常规字段 | 文本框 / 下拉框 | 单行文本最多 2000 个字符，长文本最多 20000 个字符。 |
   | 敏感字段 | 密码框（带「加密存储」锁图标） | 内容加密存储，界面与助手均不展示明文。 |
   | 布尔字段 | 单选按钮 | 可选「（未填）」「是」「否」。 |
   | 关联字段 | 搜索下拉选择框 | 支持单选或多选（最多关联 200 项），候选列表最多拉取 200 条记录。无候选时显示「（无）」或「没有可选的记录」。 |
   | 「归属部门」 | 下拉选择框 | 仅在操作人具备多个部门写入权限时显示。提示「按部门查看数据的人据此看到它」。若留空，默认为创建人所在部门。 |
5. 点击底部「保存」。保存成功后提示「已创建」，新记录显示在列表中。

### 编辑记录

1. 在「数据」页面列表中，点击目标记录行右侧的「编辑」（或直接点击该行）。
2. 在「编辑 ……」弹窗中修改字段内容。若敏感字段已打码，输入框提示「已加密，留空不变」，无需修改时保持留空即可。
3. 若具备多部门写入权限，可根据需要修改「归属部门」（提示「改归属后，可见范围随之变化」）。
4. 点击底部「保存」。保存成功后提示「已保存」。

> **注意**
>
> 若两人同时修改同一条记录，后保存的人会收到冲突提示：「这条记录刚刚被别人修改了。关闭后重新打开，在最新内容上再改。」。此时需要关闭表单并重新打开，在最新数据上修改。

### 删除记录

1. 在「数据」页面列表中，点击目标记录行右侧的删除按钮。
2. 在弹出的确认弹窗中阅读提示：「删除 ……？」「永久删除，无法恢复。被其他记录引用的记录不能删除。」。
3. 点击弹窗中的「删除」按钮。删除成功后提示「已删除」。

> **危险**
>
> 记录删除为永久删除，无法恢复。若该记录已被其他业务记录引用，系统将拒绝删除。

### 导出 CSV

1. 在「数据」页面顶部选择需要导出的数据类型。
2. 根据需要设置筛选条件与排序规则（导出的文件会携带当前界面的筛选与排序）。
3. 点击页面右上角「导出 CSV」。
4. 浏览器自动保存下载文件，文件命名格式为 `{类型标识}.csv`。

> **提示**
>
> - 单次导出最多支持 10 万行记录。
> - 导出的数据范围受当前操作人的部门权限约束，只能导出本人有权查看的数据。
> - 隐藏字段在导出的 CSV 中整列省略。
> - 为防范公式注入风险，以公式特殊字符开头的单元格前缀会自动添加撇号。
> - 导出操作必须由管理员本人在界面执行，助手与平台支持会话无权导出数据。

### 导入 CSV

1. 在「数据」页面顶部选择目标数据类型。
2. 点击页面右上角「导入」。
3. 在「导入 {名称}」弹窗中选择本地的 CSV 文件。
4. 确认导入文件符合规范：
   - 第一行必须为字段标识；
   - 单次导入最多 1000 行，请求体大小不超过 16 MB；
   - 多值字段在单元格内使用分号分隔；
   - 文件中若包含未知的字段列，系统将整表拒绝导入；
   - 文件中的 `id` 列会被系统自动忽略，导入仅执行新建记录，不会按 `id` 更新已有记录。
5. 系统解析并导入数据。导入完成后展示结果：
   - 成功标题展示「成功 」+ 行数 +「 行」，若有失败行则再接「，失败 」+ 行数 +「 行」，出错的行会自动跳过；
   - 界面最多列出 50 条行错误明细，每条写出第几行、哪个字段以及原因。

### 配置并启用自带存储

![自带存储空表单（示例值，不保存）](/shots/admin-storage-byo.webp)

图：自带存储空表单（示例值，不保存）

1. 「端点」：例如 https://minio.example.com（示例，不保存）

1. 在左侧导航点击「数据」分组下的「存储」。
2. 打开「使用自己的存储」开关。
3. 按照界面「请先在你的存储里准备好」指引在对象存储服务中完成准备工作：
   - 创建存储桶；
   - 创建访问密钥，确保密钥拥有该存储桶的读、写、列出、删除权限；
   - 配置跨域规则（CORS），保证浏览器能够直接上传。
4. 填写连接参数（可点击「MinIO / SeaweedFS / Ceph（自建）」「Amazon S3」「阿里云 OSS」「腾讯云 COS」快速填充预设）：
   | 字段 | 必填 | 说明 |
   |---|---|---|
   | 「端点」 | 是 | S3 服务的访问地址。 |
   | 「浏览器访问地址」 | 否 | 留空则与端点相同。端点仅内网可达时填写供浏览器访问的外网地址。 |
   | 「存储桶」 | 是 | 存放文件的 S3 存储桶名称。 |
   | 「路径前缀」 | 否 | 可选，填写对象键前缀，例如 `kwork`。 |
   | 「区域」 | 否 | 存储桶所在的区域代码。 |
   | 「访问密钥 Access Key」 | 是 | 访问密钥 ID。已保存时右侧显示「已保存」徽章。 |
   | 「私有密钥 Secret Key」 | 是 | 私有访问密钥。 |
   | 「路径风格寻址」 | 否 | 开关项。MinIO、SeaweedFS 开启，AWS S3、阿里云 OSS、腾讯云 COS 关闭。 |
5. 点击「只测试，不保存」验证配置；或直接点击「测试并保存」。
6. 系统依次测试「连接与权限」「写入」「读取」「列出」「预签名上传」「浏览器跨域（CORS）」「删除」七个步骤。
7. 测试通过后提示「连通性测试通过」，保存成功后提示「已保存，新上传的文件会写入你的存储」，顶部「当前使用」卡片更新为自带存储。若测试未通过，提示「没有通过连通性测试，设置没有保存。」，并在界面标红失败步骤。

> **提示**
>
> 已保存配置后，若仅需验证当前存储可用性，可直接点击「重新测试已保存的设置」，不会改动当前表单中的内容。

### 改回平台存储

1. 在「存储」页面，关闭「使用自己的存储」开关。
2. 界面展示提示面板「将改回平台存储」与说明「新文件会放回平台存储。你存储桶里已有的文件不会被删除，但改回期间无法访问。」。
3. 点击面板中的「改回平台存储」按钮。
4. 在二次确认弹窗中阅读提示「改回平台存储？」「你存储桶里已有的文件不会被删除或迁移。」，点击「改回」。
5. 系统完成切换并提示「已改回平台存储」，「当前使用」卡片更新为「平台存储」。

> **注意**
>
> 改回平台存储后，原先存储在自带存储桶里的文件不会被自动迁移或删除；但在改回期间，平台无法访问这些旧文件。后续新上传的文件将直接存入平台存储。

### 浏览与复制素材

1. 在左侧导航点击「数据」分组下的「素材库」。
2. 点击顶部页签在「全部」「提示词」「技能」之间切换。
3. 在搜索框输入关键词，检索素材名称、说明或正文。
4. 在匹配的素材卡片上，点击「复制正文」即可将素材正文复制到剪贴板。

## 状态说明

### 存储运行状态

| 状态项 | 显示值 | 说明 |
|---|---|---|
| 「当前使用」 | 「自带存储」 | 组织当前使用自建或第三方 S3 兼容存储，卡片显示桶名与端点。 |
| | 「平台存储」 | 组织当前使用平台提供的统一存储，由运营方维护。 |
| 「最近一次测试」 | 「通过」 | 最近一次连通性测试全部 7 个步骤均成功执行。 |
| | 「失败」 | 连通性测试中存在失败步骤，界面会标红对应步骤。 |
| | 「未测试」 | 尚未执行连通性测试。使用自带存储时可点击「重新测试已保存的设置」。 |

### 存储连通性测试步骤流转

连通性测试按以下固定顺序依次校验：

`连接与权限 → 写入 → 读取 → 列出 → 预签名上传 → 浏览器跨域（CORS） → 删除`

- 所有步骤全部通过，测试结果为「通过」，可成功保存配置。
- 任一步骤失败，测试流程中断并标红失败步骤，测试结果为「失败」，系统不会保存配置。
- 针对跨域检测异常，界面会给出 CORS 警告提示：「……。服务器访问不到不一定有问题，请确认浏览器能访问，并配置 CORS。」。

## 让助手帮你做

助手可以协助处理日常数据记录的起草与存储切换准备，但涉及高风险变更时必须经过人工确认：

- **新建记录**：对助手说出字段信息，助手生成新建记录草稿。归属部门可留空，系统默认填入创建人所在部门。
- **修改记录**：对助手说出要修改的内容，助手仅提交变更字段，支持清空指定字段或修改归属部门。
- **配置自带存储**：助手可协助起草自带存储参数。这属于高风险操作，存储密钥必须由管理员本人在审阅页面填写，助手预演阶段不会测试连通性。保存前需人工确认：
  > 保存后，组织里新上传的文件都存进这个存储桶（已上传的留在原处）；平台用这里的密钥读写它。
- **改回平台存储**：助手可协助起草切回平台存储。这属于高风险操作，保存前需人工确认：
  > 之后新上传的文件存到平台存储；已经存在你们存储桶里的文件留在那里，平台不再读写它们。
- **数据模型管理**：在[模型与 Agent 设置](/admin/models)中，助手还可协助起草「新建数据类型」「修改数据类型」「删除数据类型」以及「强制删除数据类型及其全部记录」。

你可以这样对助手说：

> 给客户新建一条，名称是某某公司。
> 把这条记录的阶段改成交。
> 改用我们自己的 MinIO，端点是……
> 改回平台存储。

> **助手的能力边界**
>
> - 助手不能执行 CSV 导入或数据导出。
> - 助手不能执行存储连通性测试；代读存储设置时，系统不会向助手返回密钥明文。
> - 助手不能管理素材库。
> - 助手不能读取记录列表的正文内容（仅能读取组织的数据类型列表）。
> - 敏感字段的内容不会输入给助手。

## 设置

| 设置项 | 作用 | 取值 / 默认 | 谁能修改 |
|---|---|---|---|
| 「使用自己的存储」及连接设置 | 决定组织内后续新上传的文件存放位置（自带存储桶或平台存储） | 默认关闭（使用平台存储） | 仅管理员 |
| 「路径风格寻址」 | 适配不同对象存储服务（MinIO、SeaweedFS 开启，AWS S3、阿里云 OSS、腾讯云 COS 关闭） | 随快速填充预设自动切换 | 仅管理员 |
| 数据类型定义与「谁可以操作」 | 定义数据类型的字段结构、敏感性、归属部门以及记录操作权限 | 在「数据模型」中配置（详见[模型与 Agent 设置](/admin/models)） | 仅管理员 |
| 数据保存期限与擦除策略 | 配置各类数据的保存期限与个人信息擦除规则 | 在「数据与合规」中配置（详见[安全、水印与审计](/admin/security)） | 仅管理员 |

## 注意事项

- **记录列表与排序上限**：数据列表每页固定展示 25 条记录。设置排序条件后列表不提供分页，且仅保证展示前 25 条记录，底栏「下一页」按钮会被禁用。
- **敏感数据保护**：被标记为敏感（加密存储）的字段在界面中打码展示，不对助手输出明文，不支持作为筛选条件，也不支持参与排序。
- **记录长度与容量限制**：单条记录体大小上限为 64 KB；单行文本字段最多 2000 个字符；长文本字段最多 20000 个字符。
- **关联数据限制**：关联字段在表单下拉菜单中最多展示 200 条候选记录；一条记录的多关联字段最多关联 200 项。
- **导入与导出上限**：CSV 导入单次最多 1000 行，请求体大小上限为 16 MB；CSV 导出单次最多导出 10 万行。
- **数据模型修改约束**：数据类型一旦产生了业务记录，字段的数据类型、敏感加密属性、关联目标类型将无法再修改（仍可新增字段）。
- **删除依赖约束**：被其他记录引用的记录不能直接删除；被其他数据类型引用的类型也不能直接删除。若强制删除数据类型，其名下的全部记录与敏感数据加密密钥将被永久销毁。
- **存储切换与旧文件访问**：
  - 连通性测试未通过时，自带存储配置无法保存。
  - 存储模式切换仅对后续新上传的文件生效，原有已上传的文件不会被自动迁移或删除。
  - 改回平台存储期间，原先保存在自带存储桶里的旧文件将无法在平台中访问。
  - 「已存文件」统计与[套餐与用量](/admin/usage)中的文件存储统计同源，最多统计前 5 万个对象，超出时提示「只统计了前 5 万个文件，实际更多。」。
- **素材库只读**：素材库仅用于浏览和复制在应用市场已安装并启用的素材包，不支持在页面内直接上传、编辑或删除素材。
- **移动端适配**：移动端采用同一套表单，在窄屏设备上数据表格会自动折行展示。

## 目前不支持

- 助手不能执行 CSV 导入、数据导出、存储连通性测试以及素材库管理。
- 在「数据」页面不能直接修改数据类型的字段定义（需前往「数据模型」操作）。
- CSV 导入不支持按已有记录的 `id` 更新记录（导入文件中的 `id` 列会被系统忽略，所有有效行均按新建处理）。
- 「存储」页面不提供文件迁移工具与完整文件清单管理功能。
- 页面不支持从链接直接打开并定位到单条记录。

## 常见问题

### 为什么按字段排序后无法点击「下一页」翻页？
列表在启用排序条件后不提供分页功能，底栏会提示「排序时只显示前 」+ 25 +「 条」，并禁用「下一页」按钮。如果需要查看全量排序结果，建议点击页面右上角「导出 CSV」导出至本地表格软件中处理。

### 为什么导入 CSV 时包含了 `id` 列，却没有更新原有记录而是新建了记录？
CSV 导入功能目前仅支持新建记录。导入文件中的 `id` 列会被系统自动忽略，不会按 `id` 查找并更新已有记录。

### 切换回平台存储后，之前保存在自己存储桶里的文件还能正常访问吗？
不能在平台中直接访问。切换回平台存储后，原先存储在自带存储桶里的文件不会被平台删除或迁移；但在改回平台存储期间，平台无法读取这些旧文件。后续新上传的文件会存入平台存储。

### 为什么某些字段在列表顶部的筛选和排序下拉菜单中找不到？
在「数据模型」中被配置为加密存储的敏感字段，出于安全保护机制，系统不支持将其作为筛选条件，也不支持参与排序。

### 能否在「素材库」中直接上传自定义的提示词或技能？
不能。「素材库」为只读浏览页面，不提供上传、编辑或删除操作。素材内容来源于在市场中安装并启用的素材包。若组织尚未安装素材包，可点击页面中的「去市场」进行安装。