使用文件 / 帳號與同步

帳號同步

了解學員登入後會同步哪些設定、什麼時候同步、哪些欄位刻意留在本機,以及失敗時怎麼辦。

最後更新

同步的是「可攜」的那一半

登入後,ZeroType 會把可以跟著帳號走的設定同步到雲端,讓你在另一台電腦登入同一個學員帳號時,提示詞與偏好設定直接到位。

同步的文件 內容
appsettings.json 可攜偏好設定,取自本機設定檔與預設值
SYSTEM.md 系統提示詞
USER.md 主提示詞
USER-*.md 其他提示詞 profile
global_replacements.json 自訂詞彙

刻意不同步的內容:API 金鑰、金鑰庫中繼資料、登入憑證、授權資料、麥克風設定、快捷鍵、錄音檔、歷史記錄與診斷檔案。這些東西只留在這台電腦。

哪些欄位永遠留在本機

即使兩台電腦登入同一個帳號,下面這些欄位也不會互相覆蓋:

類別 欄位
硬體與系統 麥克風裝置、三組快捷鍵、macOS 的轉錄方式
本機路徑與更新來源 自訂詞彙檔路徑、測試用更新來源
AI 服務 端點、模型、金鑰名稱、即時轉錄開關

理由很直接:金鑰只存在各自的電腦,若把端點與金鑰名稱同步過去,另一台只會得到一個沒有金鑰可用的設定。所以每台電腦的 AI 服務各自獨立,不會互相覆蓋,也不會因此產生衝突。

其餘偏好設定(輸入模式、輸出轉換、提示詞內容等)照一般規則同步。Windows 與 macOS 可以共用同一個學員帳號,兩個平台讀寫同一份雲端文件。

預設是關閉的

自動同步預設關閉,避免在你確認之前,就把設定同步到錯誤的電腦或帳號。

  • 關閉時:登入仍會設定 AI 服務,但不讀寫雲端文件,狀態顯示「自動同步未開啟」。
  • 開啟後:立即下載雲端設定並三方合併,之後每 60 秒檢查一次。
  • 狀態會記在這台電腦的帳號狀態檔,之後更新版本沿用你的選擇,不會自己變回去。

第一次同步要先選一邊

當這台電腦還沒有這個帳號的同步紀錄,而雲端已經有不一樣的內容時,ZeroType 不會直接合併,而是請你選:

選擇 結果
以雲端為準 這台電腦的偏好設定與提示詞換成雲端版本,只在雲端存在的文件會保留,只在這台電腦存在的文件會移除
以這台電腦為準 雲端換成這台電腦的內容,只在雲端存在的文件會移除,其他電腦下次同步時跟著更新
不選、關閉自動同步 不讀寫任何文件

兩種選擇都會先顯示差異並請你確認;偏好設定裡的麥克風、快捷鍵與 AI 服務在兩種選擇下都保留本機值。

如果兩邊內容完全相同,不會詢問,直接建立同步基準;雲端是空的,就直接上傳本機內容。

什麼時候會同步

時機 行為
登入、開啟帳號視窗、啟動程式 立即同步
按「立即同步」 立即同步,顯示進度與結果
每 60 秒 背景同步,只更新狀態文字,不彈視窗
關閉偏好設定、提示詞編輯器或連線測試視窗 立即重試先前延後的同步

背景同步遇到重複的失敗會自動退避:60 秒、120 秒、240 秒……最多延後 30 分鐘。同步成功後恢復正常頻率。

同步會延後的情況

為了不覆蓋你還沒儲存的草稿,也不在錄音途中換掉正在使用的設定,下列情況會延後套用,並在狀態列說明原因:

  • 偏好設定、提示詞編輯器或連線測試視窗開著。
  • 正在錄音、轉錄或 AI 校正。

關閉這些視窗或完成處理後,ZeroType 會自動重試。Windows 版沒有「沒有草稿就自動交接」,所以從偏好設定開啟帳號視窗完成登入後,要先把偏好設定關掉,自動設定才會套用。

同步失敗時會看到什麼

  • 網路或服務暫時不通:本機設定原樣保留,狀態顯示原因,之後自動重試。
  • 網站拒絕某份文件:狀態會說明是哪種問題(例如文件裡含有金鑰欄位),本機檔案不會被改動;修正後按「立即同步」再試一次。
  • 學員金鑰暫時取不到:偏好設定與提示詞照常同步,只另外說明學員 AI 自動設定未完成;原本的 provider 與金鑰不受影響。

失敗原因會寫進本機的 logs 資料夾,但不會記錄金鑰、登入憑證或文件內容。

容量上限與備份

項目 上限
單一同步文件 512 KiB
每個帳號的同步內容 4 MiB
文件數量 200 份

第一次真正要改動本機檔案之前,ZeroType 會先備份到 account-sync-backups,只保留最新 50 份,較舊的在同步成功後清除。兩邊都改過的內容另存為同步副本,處理方式見 衝突處理。

怎麼確認同步有沒有生效

  1. 看帳號視窗的「上次同步」時間。
  2. 按「立即同步」,看結果視窗的說明。
  3. 到另一台電腦登入同一個帳號,確認提示詞清單與偏好設定是否符合預期。

若你同時在網站上編輯提示詞,見 網頁提示詞編輯。

這一頁有錯、或有沒寫到的地方?寫信到 training [at] miniasp.com,我們會依實際行為更新文件。