# 草稿：审阅与应用

助手起草的变更先停在草稿中，不会自动生效。对话中的草稿卡片仅供打开草稿详情进行审阅；所有变更的应用与放弃操作均在「Agent」应用的「草稿」页逐项完成。你修改过的字段会标注「你改的」，助手后续修订不会覆盖你填写的值。

## 谁能用

组织成员均可查看并处理草稿，但权限与访问受以下规则限制：
- **仅限本人草稿**：草稿列表与详情页仅展示为你本人起草的草稿。若访问属于他人的草稿或已不存在的草稿，系统展示「找不到这份 Agent 草稿」，并提示说明「可能不是为你起草的，或链接有误。」。
- **必须本人登录操作**：应用整份草稿、放弃整份草稿、放弃单项条目、按最新数据继续以及修改字段，均必须由你本人登录后操作。助手自身的委托身份与代理令牌无权代为执行这些操作。
- **对话卡片权限提示**：若你无权打开某份草稿，对话卡片按钮悬浮提示「你不能打开这份草稿」；若卡片加载失败，提示「这份草稿已不存在，或你无权查看」。
- **列表访问限制**：若账号无权读取草稿列表，系统显示通用提示「没有权限」与「你的角色无权查看这部分内容。」。
- **助手的权限边界**：助手只能起草变更、向草稿追加条目、提交修订以及读取草稿内容，无法点击「应用」或「放弃」。

## 怎么打开

你可以通过以下几种途径进入草稿：
1. **通过对话中的草稿卡片**：在[助手对话](/agent/chat)中，当助手起草了变更，卡片上会显示待处理状态。若草稿仍有待处理项，点击卡片上的「审阅」；若草稿已处理结束，点击卡片上的「查看」。系统将在右侧面板里打开对应业务应用中的那一页：变更已经填在表单或设置里，由你在页面上接受或放弃。
2. **通过「Agent」应用页签**：在[工作台](/guide/workspace)中打开「Agent」应用，点击顶部的「草稿」页签，即可进入草稿列表页。
3. **通过业务记录页横幅**：当某条业务记录关联了助手起草的变更时，页面上方会显示横幅提示「Agent 有……个草稿涉及此记录」。点击横幅中的「查看」，进入这条变更在该业务应用里的审阅页（有多处时为「逐个查看」）。
4. **通过导航角标**：工作台导航栏「草稿」项旁会显示数字角标，代表当前仍有待处理条目的进行中草稿数量。
5. **通过定时任务**：由[定时任务](/agent/tasks)运行产出的草稿，同样会自动汇集在「草稿」列表中。

> **提示**
>
> 对话中的草稿卡片仅作为查看与审阅的快捷入口，卡片本身不提供「应用」按钮，也没有在应用中查看按钮。

## 界面一览

### 对话里的草稿卡片

对话中的草稿卡片实时展示当前草稿的审阅进度与状态：

![对话里的草稿卡：只提供「审阅」](/shots/agent-draft-card.webp)

图：对话里的草稿卡：只提供「审阅」

1. 卡片嵌在对话里；应用发生在 Agent「草稿」页，不在这张卡上
2. 草稿卡片（无摘要时标题为「助手起草了一份修改」）
3. 待审时「审阅」：打开 Agent「草稿」详情，卡片上没有「应用」

| 状态 / 位置 | 界面显示原文 | 说明 |
|---|---|---|
| 无标题时 | 「助手起草了一份修改」 | 草稿未设置摘要时的默认卡片标题 |
| 未加载完成 | 「不会自动生效，由你审阅后应用」 | 卡片数据加载中的提示 |
| 存在待处理项 | 「……项等你审阅后应用」 | 展示等待处理的条目数；若已有部分条目被执行，后接「，已应用……项」 |
| 全部应用完成 | 「已应用……项」或「已应用……项，放弃……项」 | 草稿中所有项均已处理完毕 |
| 全部放弃或无条目 | 「已放弃，没有执行任何修改」 | 整份草稿已放弃，未对业务数据造成改动 |
| 进行中操作按钮 | 「审阅」 | 仍有待处理项时显示，点击打开草稿详情页 |
| 已结束操作按钮 | 「查看」 | 草稿已全部应用或放弃后显示，点击打开草稿详情页 |

在等待审阅期间，卡片平时通过实时推送更新状态；若推送不可用，系统约每 120 秒自动轮询一次状态。

### 草稿列表

打开「Agent」应用的「草稿」页签，进入草稿列表：
- **页面标题**：显示「草稿」。
- **状态筛选**：
  - 「进行中」：默认筛选视图，展示仍有待处理项的草稿（包含部分条目已应用的草稿）。若列表为空，提示「没有待处理的草稿」与「都处理完了。」。
  - 「全部」：展示你所有的历史草稿。若列表为空，提示「还没有草稿」与「在对话里让 Agent 起草变更。」。
- **列表条目信息**：
  - **行标题**：展示草稿摘要内容；若未填写摘要，则显示「未命名的草稿」。处于非「进行中」状态的草稿会在标题旁展示状态芯片。
  - **副行信息**：展示变更涉及的应用中文名称（多个应用之间以「、」拼接，无条目时显示「没有条目」），后接条目数量（如 N 项或「……项待处理」），以及相对时间（「刚刚」、「……分钟前」、「……小时前」、「昨天」或具体日期）。
- **自动刷新**：列表约每 20 秒自动刷新一次。

![Agent「草稿」列表](/shots/agent-draft-list.webp)

图：Agent「草稿」列表

1. 页标题「草稿」
2. 筛选「进行中」（默认，含部分已应用）
3. 筛选「全部」：历史草稿

### 草稿详情

草稿详情页采用跨应用统一审阅架构，多项变更按应用与业务意图分组展示。打开详情页时，系统会自动重新执行一遍数据预检。

![草稿详情：逐项审阅后应用](/shots/agent-draft-detail.webp)

图：草稿详情：逐项审阅后应用

1. 底部「自动应用」设置卡片
2. 返回草稿列表
3. 应用栏「放弃」：放弃整份未处理项

#### 页头区域
- **标题与徽章**：顶部展示草稿摘要或默认标题「Agent 草稿」；标题旁带有 ✦ 紧挨「Agent 草稿」标识（中间无空格），并标注当前草稿状态芯片（「进行中」「部分已应用」「已应用」「已放弃」）。
- **返回导航**：点击「← 草稿」返回草稿列表。
- **跨应用提示**：当草稿包含多个应用的变更时，页头提示「另有……项在……中处理」。

#### 应用栏
当草稿状态为「进行中」或「部分已应用」，且仍有待处理条目时，页面显示应用栏（区域无障碍标签为「应用」）：
- **执行后果预告**：显示「应用后将：」并列出操作涉及的类别（包含「通知」「审批」「扣次 / 余额」「流水」「删除」「分享」「新建」「修改」等，未匹配的归入「其他」）。
- **风险提示**：提示「部分校验只在执行时进行，应用时仍可能被拒绝。」。
- **跳过提示**：若部分条目当前无法执行，提示「另有……项暂时不能应用，将跳过：……」（多项时后接「 等」）。
- **依赖关联**：若所选项依赖未勾选的条目，提示「所选的项依赖……项未选的变更，不纳入的话依赖它们的项会被跳过。」，并提供「一并纳入」按钮。
- **应用范围统计**：显示「范围：」，后接「所选……项」或「全部待处理中可应用的项」，后面可带类型统计（如新建 1 · 删除 1）。
- **操作按钮**：提供危险操作按钮「放弃」，以及执行按钮「应用……项」或「应用」。
- **不可应用提示**：若当前无法执行应用，应用栏会提示「草稿已关闭」「没有待处理的项」或「没有可应用的项：……」。

#### 分组与条目导航
- **分组结构**：
  - **系统组**：显示具体操作标题，或显示「新建」、「修改」、「删除」、「操作」加对应实体名称。
  - **意图组**：带有 ✦ 标记及助手生成的意图组名，提供「应用本组」快捷操作。组内可展示状态说明（如 N 项待选择 · M 项过期）。若在该组中仅放弃了部分项，系统会提示「其余……项仍按……修改，可能前后不一致」。
- **条目布局**：
  - 单项草稿：草稿仅含 1 项变更时，不展示卡片列表，整页直接展示该项详情。
  - 多项草稿：支持使用键盘方向键或 `J` / `K` 键快速在条目之间切换；窄屏模式下需要点击条目卡片滚动到详情区域。
  - 空态提示：草稿无内容时提示「这份草稿里没有内容」；未选择任何条目时提示「选一项查看。」。

#### 条目状态徽章
每个条目根据校验和处理进度展示状态徽章（就绪状态通常不作特殊强调）：
- 「就绪」：校验已通过，可直接执行应用。
- 「有警告」：存在业务警告信息，需人工审阅确认。
- 「待选择」：包含需要你手动挑选的候选字段。
- 「待你填写」：包含仅限本人填写的敏感或必填字段。
- 「无效」：存在校验错误，无法执行。
- 「过期」：底层业务数据在草稿生成后已被改动。
- 「未校验」：依赖草稿内其他新建项，执行时按顺序校验。
- 「已应用」：该条目已成功执行写入。
- 「已放弃」：该条目已被放弃，不再执行。

#### 条目详情区域
- **特殊状态提示**：
  - 待删除条目：标记「待删除」，并提示「应用后这条记录将被删除。」。
  - 已放弃条目：提示「这一项已放弃，不会执行。」。
  - 执行失败条目：提示「上次应用没有成功，已回到待处理」或「应用没有完成，内容已保留，可以稍后重试。」。
  - 数据过期条目：提示「……在草稿生成后被改动」，展示「生成时」「现在」「将执行」三方数据对照，并说明「要按最新数据继续，还是放弃这一项，由你决定。」，提供「按最新数据继续」与「放弃这一项」操作。
  - 助手说明：展示「Agent 的说明」。
  - 依赖未校验条目：提示「这一项用到本草稿里其他项要创建的内容，现在还校验不了；应用时会在它们之后校验并执行，没通过就回到待处理。」。
  - 不可应用状态：提示「还不能应用」。
- **字段变更表格**：
  - 表格列包含：「字段」「原值」「Agent 提议」「当前（将执行）」「操作」。（窄屏模式下自适应为「原值」「Agent 提议」「当前」堆叠标签）。
  - 新建条目的未填必填项显示为「待填」；由系统生成的只读字段显示为「创建后生成」；空值统一显示为「—」。
  - 字段提示信息包含「需要你选择」与「只有你能填」。若候选列表为空，提示「没有候选，请联系应用管理员。」，候选值默认不作预先选择。
  - 字段编辑支持：默认提供「保存」与「取消」按钮；布尔类型提供「是」与「否」；枚举类型提示「请选择」；字符串数组提示「每行一项」；金额字段单位固定为「元」。
  - 本人/敏感字段：展示为「已填写（不显示）」，提供「重新填写」按钮（占位提示「重新填写；留空表示不填」），填写完成后点击「填好了」保存。此类字段不提供「采用提议」与「恢复原值」操作。
- **你修改过的字段**：
  - 当你手动修改了某字段后，该字段当前值旁会显式标注「你改的」，并说明该字段「保留了你填写的值，Agent 之后的提议不会覆盖它。」。
  - 若助手后续对该字段提交了新提议，系统会提示「Agent 修订了……，保留了你填写的值；它的新提议显示在该字段下面，需要时可以采用。」。
  - 带有「你改的」标记的字段并未禁用输入框，你仍可随时点击「修改」，也可点击「采用提议」采纳助手的新建议，或点击「恢复原值」还原。
- **条目底部操作**：非过期场景下，条目详情底部提供「放弃这一项」按钮。
- **记录来源追溯**：变更应用后，业务记录来源标注为「由 Agent 起草，……于……应用」（具体标明由你、某成员姓名或一位成员应用）或「按预签名自动应用」。

#### 确认应用对话框
- 标题展示「确认应用……项」，说明「确认后才会执行。」。
- 展示对应操作声明的确认句原文。
- 若包含删除或高风险操作，显示警示「其中有删除或高风险的变更：」。
- 若操作需要二次身份验证，显示提示「这类操作应用前需要再次验证你的身份。」。
- 操作按钮提供「取消」与「确认并应用」。

#### 放弃整份草稿对话框
- 弹窗提示「放弃这份草稿？」。
- 说明文案显示「这份草稿中……项待处理变更将不执行，已应用的不受影响。」。
- 提供确认操作按钮「放弃」。

#### 常见页级提示与错误
- 「没有完成」加具体原因。
- 「有的项在你审阅之后被改动了，已重新加载。请再看一遍后应用。」
- 「这份草稿正在应用，请等它完成。」
- 「这一项属于另一个应用，请在那个应用里处理。」
- 「找不到这一项，或草稿已经关闭。」
- 「还需要你填写或选择：「……」」
- 「需要你先确认：……」
- 「已应用……项，……项没有成功」以及「未成功的项已回到待处理，可修改后重试。」
- 「操作没有完成」

### 自动应用设置卡片

对于支持预签名的安全操作，草稿详情页底部会展示「自动应用」区域：
- **卡片标题**：显示「自动应用：……」（包含具体操作标题）。
- **说明文案**：提示「……校验通过后自动应用，可随时撤销。有警告、待选择或无效的项仍需你处理。」。
- **状态与有效期**：未开启时显示「未开启。」；可选择「有效期」为「30 天」、「90 天」（默认）、「一年」或「不设期限」。
- **操作按钮**：提供「开启自动应用」；已开启后可点击「再签一条」。
- **签署内容描述**：显示「将签署：」，并说明「Agent 起草的……自动应用，不再逐条审阅」。
- **撤销签署**：可点击「撤销」；弹窗提示「撤销自动应用？」，并说明「撤销后这类变更需重新逐条审阅，已应用的不受影响。」。

## 常用操作

### 从对话进入并审阅应用草稿

1. 在对话中，当助手起草变更后，找到草稿卡片（显示「助手起草了一份修改」或摘要）。
2. 点击卡片上的「审阅」按钮，进入草稿详情页。
3. 在左侧列表或分组中查看各项变更，也可以使用键盘方向键或 `J` / `K` 键上下切换条目。
4. 检查各条目的「字段变更」内容：
   - 若某字段需要手动填写或修改，点击操作列的「修改」，修改后点击「保存」。
   - 若条目标注为「待选择」，从候选列表中选择合适的值。
   - 若条目包含本人敏感字段，点击「重新填写」，输入后点击「填好了」。
   - 若条目标注为「过期」，对照「生成时」「现在」「将执行」的差异，点击「按最新数据继续」或点击「放弃这一项」。
5. 勾选需要应用的条目，或直接点击意图组上的「应用本组」。
6. 点击应用栏中的「应用……项」（或「应用」）。
7. 在弹出的「确认应用……项」对话框中核对确认文案（说明「确认后才会执行。」）。若涉及高风险或删除操作，系统会展示「其中有删除或高风险的变更：」并在提示「这类操作应用前需要再次验证你的身份。」后要求完成身份验证。
8. 核对无误后，点击「确认并应用」。

### 修改字段与采纳助手提议

1. 在条目详情的「字段变更」列表中，找到目标字段，点击操作列的「修改」。
2. 输入或选取新数值：
   - 布尔值选择「是」或「否」。
   - 枚举值在「请选择」下拉框中选取。
   - 字符串列表按「每行一项」换行输入。
   - 金额数值输入相应数字（单位为「元」）。
3. 点击「保存」。保存后该字段当前值旁标注「你改的」，说明该字段「保留了你填写的值，Agent 之后的提议不会覆盖它。」。
4. 若助手后续对该字段提交了新的提议，新内容会展示在「Agent 提议」列中，不会替换你的当前值。
5. 若决定采纳助手的新方案，点击操作列的「采用提议」；若想放弃修改并回到初始数据，点击「恢复原值」。

### 处理过期条目

1. 在草稿详情页中选中带有「过期」徽章的变更条目。
2. 查看条目详情中的对比提示「……在草稿生成后被改动」，对照「生成时」「现在」「将执行」三列数据的变动情况。
3. 根据提示「要按最新数据继续，还是放弃这一项，由你决定。」做出选择：
   - 若认可基于当前最新数据继续执行，点击「按最新数据继续」。
   - 若不应继续执行该变更，点击「放弃这一项」。

### 放弃单个条目

1. 在草稿详情页中选中需要放弃的变更条目。
2. 滚动至条目详情底部，点击「放弃这一项」（或在数据过期对比区域点击「放弃这一项」）。
3. 放弃后，该条目徽章更新为「已放弃」，并提示「这一项已放弃，不会执行。」。

> **注意**
>
> 若在意图组中仅放弃了部分条目，系统会提示「其余……项仍按……修改，可能前后不一致」。请确认保留的条目是否仍具有业务一致性。

### 放弃整份草稿

1. 在草稿详情页顶部的应用栏中，点击「放弃」按钮。
2. 系统弹出二次确认对话框「放弃这份草稿？」，提示「这份草稿中……项待处理变更将不执行，已应用的不受影响。」。
3. 点击「放弃」按钮确认放弃。整份草稿状态变更为「已放弃」。

> **危险**
>
> 放弃待处理项或整份草稿属于不可撤销操作，放弃后无法重新恢复执行。已经应用成功的条目不受影响，不会被回滚。

### 开启与撤销自动应用规则

1. 在草稿详情页底部找到「自动应用」区域（仅支持预签名的操作会展示）。
2. 在「自动应用：……」卡片中选择「有效期」（可选「30 天」、「90 天」、「一年」或「不设期限」）。
3. 点击「开启自动应用」（如需追加其他规则可点击「再签一条」）。系统显示签署内容「将签署：」，说明「Agent 起草的……自动应用，不再逐条审阅」。
4. 若后续需要停用免审规则，点击对应卡片上的「撤销」，在确认弹窗「撤销自动应用？」中查看说明「撤销后这类变更需重新逐条审阅，已应用的不受影响。」，点击确认完成撤销。

## 状态说明

### 草稿整体状态

整份草稿的状态流转如下：

`进行中` →（部分条目执行成功）`部分已应用` →（待处理条目清空）`已应用` 或 `已放弃`

| 状态名称 | 说明 |
|---|---|
| 「进行中」 | 草稿已生成，包含待审阅与待处理的变更条目。 |
| 「部分已应用」 | 草稿中的部分条目已被应用执行，但仍有其他待处理条目留在草稿中。 |
| 「已应用」 | 草稿中的所有条目均已成功应用执行，草稿已关闭。 |
| 「已放弃」 | 整份草稿被放弃，或所有待处理条目均已被放弃，草稿已关闭。 |

### 单项条目状态与徽章

单项条目的生命周期流转如下：

`待处理` → `已应用` 或 `已放弃`

- **应用失败处理**：若某条目在应用执行阶段失败，该条目不会丢失，系统提示「上次应用没有成功，已回到待处理」或「应用没有完成，内容已保留，可以稍后重试。」，条目重新回到待处理状态供你修改后重试。
- **条目徽章对照表**：

| 徽章名称 | 说明 |
|---|---|
| 「就绪」 | 校验通过，可直接加入应用范围执行。 |
| 「有警告」 | 数据存在业务提醒，需人工审阅确认。 |
| 「待选择」 | 字段存在多个候选值，提示「有字段需要你选择」或「请先为……选一个候选」。 |
| 「待你填写」 | 包含敏感或必须由本人填写的字段，提示「……只有你能填，请先填写」。 |
| 「无效」 | 数据校验未通过，提示「有错误，不能应用」或「有错误，不能应用：……」。 |
| 「过期」 | 底层业务数据在草稿生成后被其他操作修改，提示「……在草稿生成后被改动」。 |
| 「未校验」 | 依赖同草稿中其他待创建对象，提示「这一项用到本草稿里其他项要创建的内容，现在还校验不了；应用时会在它们之后校验并执行，没通过就回到待处理。」。 |
| 「已应用」 | 该项已成功写入业务系统。 |
| 「已放弃」 | 该项已明确放弃，显示「这一项已放弃，不会执行。」。 |

## 让助手帮你做

在对话中，你可以要求助手生成草稿、追加变更或调整已有提议。助手仅能执行读取与起草，无法代你完成最终确认。你可以对助手说：

> 帮我把刚才整理好的 3 个新客户信息起草成变更草稿。  
> 查看刚才的草稿，把第 2 项里的联系电话重新修改一下。  
> 刚才起草的草稿里，帮我再追加一条添加备注的修改项。  
> 读取当前草稿的内容，帮我解释一下各项变更的具体原因。  

> **注意**
>
> 助手**不能**代表你点击「应用」或「放弃」，**不能**替你填写本人敏感字段，也**不能**替你从候选值中进行勾选。所有实际业务写入与放弃必须由你本人在草稿详情页审阅并确认。

## 设置

草稿列表本身没有全局系统设置项。自动应用相关的免审规则可在「Agent」应用的「自动应用」页签中统一查看与管理。

## 注意事项

- **可见范围与权限隔离**：草稿列表与详情严格遵循个人可见原则，仅显示由你触发或为你起草的内容。他人无法查看你的草稿，直接访问链接会显示「找不到这份 Agent 草稿」。
- **必须由本人登录执行**：应用整份、放弃整份、放弃单项、按最新数据继续以及字段修改等关键写操作，必须由你本人账号登录完成，助手的后台委托令牌无权执行。
- **放弃操作不可逆**：放弃待处理项或放弃整份草稿后，无法恢复执行；已应用成功的条目不会随草稿放弃而回退撤销。
- **高风险操作二次验证**：包含删除或高风险行为的变更，在确认对话框中会专门标出「其中有删除或高风险的变更：」，并提示「这类操作应用前需要再次验证你的身份。」。
- **不能预签的操作**：高风险、删除、动作执行，以及需要人工确认、选择、填写或二次验证身份的操作，均不支持配置「自动应用」。
- **窄屏与移动端适配**：在窄屏设备上，多项草稿需点击条目卡片方可滚动至详情区域；字段变更表格会转为「原值」「Agent 提议」「当前」标签堆叠显示；移动端新建条目不会单独占据一列空的「原值」。
- **并发与改动保护**：若在你审阅期间底层条目被改动，系统会提示「有的项在你审阅之后被改动了，已重新加载。请再看一遍后应用。」；若整份草稿正在执行应用，系统提示「这份草稿正在应用，请等它完成。」。

## 目前不支持

- **对话卡片直接应用**：对话中的草稿卡片不支持直接点击「应用」执行变更，也没有提供在应用中查看按钮，必须进入对应业务应用的审阅页，由你接受后才会生效。
- **在「草稿」里查看与决定**：点「草稿」列表的一行，会在草稿应用里打开这份草稿，每条变更列出改了哪些字段（旧值 → 新值），可直接「接受」或「放弃」；需要你选择或数据已变的条目会提示到应用里处理。想在业务应用里看，点卡片右下角的「在应用中查看」。

## 常见问题

### 为什么我在对话卡片上找不到「应用」按钮？
对话中的草稿卡片仅用于提示审阅进度，并提供「审阅」（进行中）或「查看」（已结束）入口。为确保变更安全，助手起草的所有修改必须由你在「Agent」应用的草稿详情页中逐项核对字段差异后，再手动点击「应用」。

### 我修改了字段后，为什么助手的后续提议没有覆盖我的修改？
当你点击「修改」并保存字段后，当前值旁会标记「你改的」，说明该字段「保留了你填写的值，Agent 之后的提议不会覆盖它。」。系统会保护人工确认的数据，助手的新提议只会展示在「Agent 提议」列供你参考。这并不意味着输入框被锁死，你仍可随时点击「修改」，或点击「采用提议」采纳助手的新方案，或点击「恢复原值」。

### 条目提示「过期」是什么原因？应该如何处理？
当草稿生成后，如果底层业务记录被其他人员或系统修改，该条目会进入「过期」状态，并提示「……在草稿生成后被改动」。详情页会展示「生成时」「现在」「将执行」三方数据对比。你可以根据最新数据选择点击「按最新数据继续」以基于最新内容应用变更，或点击「放弃这一项」放弃执行。

### 为什么有些条目在应用时被提示跳过？
如果某些条目存在未填写的本人字段（提示「……只有你能填，请先填写」）、未选择的候选值（提示「请先为……选一个候选」）、校验错误，或者依赖的其他项尚未就绪，应用栏会提示「另有……项暂时不能应用，将跳过：……」。你需要在详情中先补全填写、选定候选或修复错误，然后再执行应用。

### 为什么某些操作在草稿底部没有出现「自动应用」设置？
自动应用仅适用于可预签名的安全操作。凡是涉及删除、高风险、动作执行，或需要你人工确认、选择候选、填写敏感信息以及再次验证身份的操作，系统均不允许预签自动应用规则。