# 雲端版本與本機快取

> 誰是權威版本、編輯怎麼存檔、圖片如何上雲端，以及未登入時剩下的能力。

Source: https://loomworld.ai/zh-tw/docs/sync-model

## 誰是權威版本，誰是快取

普通免費帳號的專案儲存在本機，登入不會自動上傳。三檔有效訂閱均不限雲端專案數量；有效訂閱或已登記的 Global 歷史權益下，新建、匯入或開啟的目前專案會自動開啟同步，完整上傳正文、圖片與專案附屬紀錄，裝置保留本機複本。不會掃描並上傳未開啟的其他專案。Web 使用目前瀏覽器的 IndexedDB，桌面端使用本機專案資料夾與 SQLite 資料庫。不限專案數量不代表無限儲存容量，單一檔案與上傳大小仍有技術限制。

開啟一個已連結專案時按這個順序判斷：

- 先用專案列表裡的摘要比對版本：雲端沒變、本機也沒有待上傳內容，就跳過整包擷取，直接開寫。
- 雲端有更新而本機乾淨（沒有任何待上傳修改）時，擷取最新稿覆蓋本機快取；桌面端隨後寫回設計檔案與衍生檔案。
- 本機有待上傳內容（包括那 350 毫秒防手震裡還沒寫入磁碟的編輯）且雲端也有新版時，進入衝突，兩邊都留。

自動開啟同步與專案 AI 前的版本檢查以目前網頁版為準；桌面端需使用支援這些功能的用戶端，舊版行為可能不同。

## 儲存與上傳的順序

每一次編輯先儲存到本機，不等待網路。有有效雲端權益時，儲存成功後的修改在背景合併上傳；日常寫作不保證每次按鍵都立即上傳。網路失敗不會撤銷本機修改；恢復連線且權益有效時會重試最新稿。訂閱到期或權益查詢失敗只暫停上傳，本機寫作繼續。

- 儲存提示區分「本機已儲存」與「雲端已同步」。本機儲存成功不代表上傳完成；日常自動儲存和背景同步不會反覆彈出提示，異常或狀態恢復時會另行提示。
- 開啟的已連結專案會在視窗重新聚焦和每 60 秒各做一次摘要活動訊號；背景分頁不跑定時，切走或關掉專案就停。活動訊號不會在你還打字時悄悄換稿。
- 每一輪專案對話、一次性技能、改寫、出圖、匯入分析及自動維護都先檢查雲端權益，並確認本機最新內容已同步。離線、衝突或同步失敗時停止本輪 AI；點數包不單獨開通雲端權益。尚無專案的起始流程與純費用估算另行處理。

## 圖片怎麼上雲端

上行時會先把正文與資料裡的長 data URL 圖片拆成內容定址資料：同一專案內的相同圖片複用同一份資產，專案 JSON 裡只留輕量引用；開啟與對帳時再按引用把圖片還原回本機。首次上雲端也走同一條路徑——圖沒傳完會把剛建的雲端專案丟進垃圾桶、本機不建連結，不留半成品。

- 擷取不到的圖片引用會原樣留在稿裡並標示同步錯誤，不會被悄悄刪掉。
- 單張圖超過 20 MB 原始位元組、或拆完圖之後正文仍超過 32 MB，會標示錯誤狀態且相同內容不再反覆重傳。這種專案請拆分或壓縮圖片後再傳。

## 未登入與離線時

未登入或普通免費帳號的本機專案不自動上傳。瀏覽器作品依賴目前瀏覽器的資料儲存，清除網站資料會刪除僅在本機的專案與未上傳修改；換瀏覽器或裝置請先匯出專案包。桌面端使用本機專案資料夾，可以自行複製備份。

離線時可以繼續本機寫作，雲端同步權限有效時聯網後補傳。訂閱到期不刪除已有作品，本機仍可編輯、儲存和匯出，已有雲端專案仍可讀取、匯出或刪除；續訂後先核對雙方版本再恢復同步。雲端專案被刪除時，本機連結會拆除，本機作品保留。

## 限制與排錯

- 同步是內容級的整包對帳，不做欄位級三方合併——所以衝突的處理方式是「兩邊都留」，不是自動合稿。
- 遇到同步錯誤先保留目前頁面與本機專案，不要清網站資料；請查看錯誤原因，恢復網路或有效權益後再重試。
- 換裝置前先確認目前專案已同步，再用同一帳號開啟雲端版本。僅本機專案或尚未上傳的修改請先匯出 .quill.json 專案包；不要複製瀏覽器快取來遷移。

衝突之後怎麼找回內容見 [衝突副本](https://loomworld.ai/zh-tw/docs/conflict-copies)，備份與遷移見 [匯出與匯入專案包](https://loomworld.ai/zh-tw/docs/export-quill)。