本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 在 Quick 中处理应用程序中的数据
<a name="working-with-data-apps"></a>

您可以通过多种方式在 Quick 应用程序中保留和管理应用程序中的数据。

## Built-in 应用程序存储
<a name="apps-builtin-storage"></a>

保留数据的最简单方法是使用内置的应用程序存储。它是一个键值系统，不需要外部设置，并且可以扩展以支持大量记录。

### 存储范围
<a name="apps-storage-scopes"></a>
+ **私有存储**-数据仅对当前用户可见。用于个人设置、首选项、保存的筛选条件、书签和每用户状态。
+ **共享存储**-任何拥有应用程序访问权限的人都可以看到数据。用于协作列表、评论、投票、共享配置和团队数据。

### 存储操作
<a name="apps-storage-operations"></a>


| 操作 | 专属 | 已共享 | 说明 | 
| --- | --- | --- | --- | 
| 放置项目 | 支持 | 是 | 存储或更新键值项目。 | 
| 获取项目 | 支持 | 是 | 按键检索物品。 | 
| 列出项目 | 支持 | 是 | 使用可选的 key prefix 过滤器列出项目。 | 
| 删除项目 | 支持 | 是 | 按键移除一件物品。 | 
| 按标签列出 | 否 | 是 | 按标签（二级索引）查询共享项目。 | 

### 重要概念
<a name="apps-storage-concepts"></a>
+ **表**-数据的逻辑分组。您可以定义表名；无需设置。
+ **Keys** — 每个项目在其表中都有一个唯一的密钥。密钥最多可包含 255 个字符。
+ **值**-最大 350 KB 的字符串值。对结构化数据使用 JSON 序列化。
+ **标签（仅限共享）**-共享项目的可选分类字符串。标签支持按类别进行高效查询。
+ **写入模式**-UPSERT（默认）覆盖现有项目。如果密钥已经存在，则 INSERT 会失败，这对于防止重复很有用。

**注意**  
每个应用程序都有完全独立的存储空间。在用户会话和应用程序重新加载期间，数据会一直保留。

## 导出数据
<a name="apps-exporting-data"></a>

您可以要求代理添加导出功能。Quick 中的应用程序支持通过 bridge API 将数据导出为 CSV、JSON、PDF 和 Excel 文件。您也可以让您的应用程序将数据快照写入连接的空间。这可以用作备份，并使数据可供其他 Quick 功能使用。

## 当 AI 推理处于活动状态时处理写入批准
<a name="apps-write-approvals"></a>

当应用程序使用 AI 推理并写入数据（到共享存储空间或通过操作连接器）时，您必须查看和批准每个写入负载。此安全措施可确保您在应用程序保留 AI-generated 内容之前对其进行审查。

有三种策略可以减少批准提示的频率：

1. **Batch 写入** — 只需一次操作即可收集所有项目并将其保存在单个存储密钥下。

1. 将 **AI 与写入分开** — 设计应用程序，让 AI 处理和数据持久性在不同的用户操作中进行。

1. **不需要时移除 AI 推理** — 如果您的应用程序不使用 AI-generated 内容，请确保未注册 AI 推理集成。如果没有 AI 推断，则可以选择 “允许在此应用程序上运行” 进行写入操作。该权限在各个会话中保持不变。

## 访问用户信息
<a name="apps-user-identity"></a>

使用 Quick 中的应用程序，你可以在运行时访问当前用户的身份。这使您可以个性化应用程序体验、显示用户名或实现按用户划分的逻辑。

可用的用户信息包括电子邮件、名字、姓氏和身份名。

**提示**  
将用户身份与私有存储空间相结合，为每位用户打造个性化体验，例如问候语、保存的首选项、书签和自定义仪表板。