使用文件 / 帳號與同步
帳號同步
了解學員登入後會同步哪些設定、什麼時候同步、哪些欄位刻意留在本機,以及失敗時怎麼辦。
最後更新
同步的是「可攜」的那一半
登入後,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 份,較舊的在同步成功後清除。兩邊都改過的內容另存為同步副本,處理方式見 衝突處理。
怎麼確認同步有沒有生效
- 看帳號視窗的「上次同步」時間。
- 按「立即同步」,看結果視窗的說明。
- 到另一台電腦登入同一個帳號,確認提示詞清單與偏好設定是否符合預期。
若你同時在網站上編輯提示詞,見 網頁提示詞編輯。
這一頁有錯、或有沒寫到的地方?寫信到 training [at] miniasp.com,我們會依實際行為更新文件。