# AI 的写入范围

> 一张确认卡能改哪些对象、提交前怎么校验、确认后怎么落库。

Source: https://loomworld.cn/docs/ai-writes

## 一张确认卡能做什么

智能体对项目的所有写动作都通过同一张确认卡，卡上是 1–8 个原子操作，一次确认全部生效、一次撤销全部撤回。可做的操作按对象分组：

- 人物：新建、改字段（名称、别称、性别、年龄、职业/身份、人物弧光、形象备注、阶段状态、层级、所属势力）、删除。
- 人物关系：新建（共同关系词或双向两词加备注）、删除。
- 地点 / 道具 / 设定 / 伏笔 / 时间线：各自的新建、改字段、删除；设定还可以整段替换描述；时间线含剧情线的名称、颜色、模式与轴范围。
- 剧本：正文补丁（保留行身份）、章节与场次与时空的结构字段修改与新建删除。

不能写的：按章变化的关键帧、关系的章节追踪状态、排行榜、地图手绘与摆放、后台维护链路、画布上的位置。这些字段不在白名单里，智能体提不出来，也就改不到。

## 确认前它会先验一遍

- 指向的章节 / 场次 / 时空 / 内容块必须真实存在且层级一致；伏笔与时间线的锚点同此要求。
- 时间段必须结束坐标大于起始坐标；枚举字段只能落在既有档位（层级、叙事权重、伏笔手法与重要度、设定分类等）。
- 删除类操作会算清影响并在卡上显示计数：出场、关系、子地点子树、入向关联、线内事件、剧本锚点。删章节或场次会连带清理指向它们的伏笔与时间线锚点，不留悬挂引用。
- 涉及势力时，卡上会同时写明「将新建哪几张势力卡」与「这个人物最终属于哪些势力」；名字有歧义或卡片状态已变时整卡拒绝，不会把成员悄悄清空。

## 项目在你确认期间变了怎么办

卡上带的是"当时那份内容"的指纹。确认时 Runtime 会重算并逐目标比对：目标没了整卡以目标不存在拒绝；内容变了同样拒绝。不会出现"它按旧稿算，把你后来的修改盖掉"。放久了的卡显示「提案已过期」，点「更新并继续」让它读最新状态重出一版。

## 确认之后怎么落库

- **锁编辑**屏幕出现「正在应用 AI 修改」的提示，期间的普通编辑不会写进去——避免两份真相打架。

- **先排空旧改动**把此前等待中的普通保存先提交完，再在锁内复查身份与指纹。

- **一次性提交**全部操作按序应用后整笔写入权威存储；只有这一步成功，界面内容、版本与派生文件才跟着更新。

- **留一条退路**写前的整份快照压入项目撤销栈，撤销一次即回到确认前。瞬时失败时候选内容从未进入项目，卡片保持可重试。

## 图像不走这张卡

生成人物肖像、道具图与地点图是另一条链：先由智能体按档案起草提示词，你改词后再生成，满意才「采用」进档案；也可以走 Direct 路径直接按你的描述出图，不叠加项目默认视觉。产物以引用形式返回再落入项目，图片数据不进入对话历史。项目画风存在项目设置里，只是出图时的默认依据。

## 限制与排错

- 同一张卡里「新建一条剧情线 + 把新事件挂到这条新线上」目前不支持：线的标识要落库后才生成，请分两步。
- 工具参数写错时模型最多自我纠正两次；权限、取消或版本问题会立即停止并给出原因。
- 已成功生成的图片不会因为后面一步失败而整体作废。
- 所有 AI 写入都记在你的账号用量里，可在账号中心查看调用与积分流水。

回看整体机制：[AI 协作总览](https://loomworld.cn/docs/ai-overview)。