# AI 的寫入範圍

> 一張確認卡能改哪些對象、送出前怎麼驗證、確認後怎麼寫入儲存。

Source: https://loomworld.ai/zh-tw/docs/ai-writes

## 一張確認卡能做什麼

AI 代理對專案的所有寫入動作都透過同一張確認卡，卡上是 1–8 個不可分割操作，一次確認全部生效、一次復原全部復原。可做的操作按物件分組：

- 人物：新建、改欄位（名稱、別名、性別、年齡、職業／身分、人物弧光、形象備註、階段狀態、層級、所屬勢力）、刪除。
- 人物關係：新建（共同關係詞或雙向兩詞加備註）、刪除。
- 地點／道具／設定／伏筆／時間軸：各自的新建、改欄位、刪除；設定還可以整段替換描述；時間軸包含劇情線的名稱、顏色、模式與軸範圍。
- 劇本：正文修補程式（保留行身分）、章節與場次與時空的結構欄位修改與新建刪除。

不能寫的：按章變化的關鍵影格、關係的章節追蹤狀態、排行榜、地圖手繪與擺放、背景維護鏈路、畫布上的位置。這些欄位不在白名單裡，AI 代理提不出來，也就改不到。

## 確認前它會先驗一遍

- 指向的章節／場次／時空／內容區塊必須真實存在且層級一致；伏筆與時間軸的錨點同此要求。
- 時間段必須結束座標大於起始座標；列舉欄位只能落在既有檔位（層級、敘事權重、伏筆手法與重要度、設定分類等）。
- 刪除類操作會算清影響並在卡上顯示計數：出場、關係、子地點子樹、入向關聯、線內事件、劇本錨點。刪章節或場次會連帶清理指向它們的伏筆與時間軸錨點，不留懸空引用。
- 涉及勢力時，卡上會同時寫明「將新建哪幾張勢力卡」與「這個人物最終屬於哪些勢力」；名字有歧義或卡片狀態已變時整卡拒絕，不會把成員悄悄清空。

## 專案在你確認期間變了怎麼辦

卡上帶的是「當時那份內容」的數位指紋。確認時 Runtime 會重算並逐目標比對：目標沒了整卡以目標不存在拒絕；內容變了同樣拒絕。不會出現「它按舊稿算，把你後來的修改覆蓋掉」。放久了的卡顯示「提案已過期」，點「更新並繼續」讓它讀取最新狀態重新產生一版。

## 確認之後怎麼寫入儲存

- **鎖定編輯**螢幕出現「正在套用 AI 修改」的提示，期間的普通編輯不會寫進去——避免兩份真相衝突。

- **先排空舊改動**把此前等待中的普通儲存先提交完，再在鎖定內複查身分與數位指紋。

- **一次性提交**全部操作按順序套用後整筆寫入權威儲存；只有這一步成功，介面內容、版本與衍生檔案才跟著更新。

- **留一條退路**寫入前的整份快照壓入專案復原堆疊，復原一次即回到確認前。瞬時失敗時候選內容從未進入專案，卡片保持可重試。

## 圖像不走這張卡

生成人物肖像、道具圖與地點圖是另一條鏈：先由 AI 代理按檔案起草提示詞，你改詞後再生成，滿意才「採用」進檔案；也可以走 Direct 路徑直接按你的描述出圖，不疊加專案預設視覺。產物以引用形式回傳再落入專案，圖片資料不進入對話歷史。專案畫風存在專案設定裡，只是出圖時的預設依據。

## 限制與排錯

- 同一張卡裡「新建一條劇情線 + 把新事件掛到這條新線上」目前不支援：線的識別碼要寫入儲存後才生成，請分兩步。
- 工具參數寫錯時模型最多自我修正兩次；權限、取消或版本問題會立即停止並給出原因。
- 已成功生成的圖片不會因為後面一步失敗而整體作廢。
- 所有 AI 寫入都記在你的帳號用量裡，可在帳號中心查看呼叫與點數紀錄。

回看整體機制：[AI 協作總覽](https://loomworld.ai/zh-tw/docs/ai-overview)。