檔案與資料夾

OAR 把它擁有的一切都放在一個資料夾裡，也就是狀態資料夾：設定檔、存有你對話的資料庫、記錄，以及上傳的檔案。本頁說明這個資料夾在哪裡、裡面有什麼、哪些部分可以刪除、哪些存有機密，以及中繼會自行移除什麼。有些資料根本不在狀態資料夾中：每個供應商都把自己的 session 資料和登入資訊放在自己的資料夾裡。

狀態資料夾 #

npm install -g 和 oar update 會取代套件，但絕不會動到狀態資料夾。OAR_STATE_ROOT 必須在你執行 oar 的每個 shell 中設定，否則指令會去預設資料夾找；見環境變數。oar doctor 會印出正在使用的路徑：狀態資料夾、設定檔、資料庫及其大小。安裝中也列出了每種安裝方式的相同路徑。

有三個環境變數可以搬移單一部分：COPILOT_WEB_RELAY_CONFIG 搬移設定檔，COPILOT_WEB_RELAY_DATA_DIR 搬移資料目錄（資料庫、鎖定檔和上傳的檔案），COPILOT_WEB_RELAY_LOG_DIR 搬移記錄資料夾。在 config.json 中，key dataDir 也能搬移資料目錄；環境變數優先。相對路徑的 dataDir 從 config.json 所在的資料夾算起。

0.9.14 新增 上傳的檔案也跟著資料目錄走：<dataDir>/uploads。舊版本留在 server/uploads 中的上傳檔案，或某次搬移複製到狀態資料夾 uploads/ 中的檔案，仍會在原處讀取。

0.9.14 新增 全域安裝的中繼不論怎麼啟動，都會使用狀態資料夾的資料目錄：oar start、Linux 服務、兩種 Windows 自動啟動模式，以及搭配 OAR 擴充功能的單純 gh copilot。如果 config.json 中有先前自動啟動的中繼使用過的 dataDir，資料會從那裡複製一次，該資料夾則維持原樣。

在 macOS 和 Linux 上，中繼會讓資料目錄只有你能讀取（模式 700），並讓設定檔和資料庫檔案只有擁有者能存取（模式 600）。

搬移舊安裝 #

在專案改名之前，狀態存放在 git 檢出的 server/ 資料夾中，而檢出的啟動器所用的設定檔和記錄則在 ~/.config/copilot-remote（有設定時為 $XDG_CONFIG_HOME/copilot-remote；Windows：%LOCALAPPDATA%\copilot-remote）。全域安裝會在第一次執行 oar setup 或 oar copilot 時，把該資料夾中的設定檔和記錄複製到狀態資料夾一次。oar start 不會搬移。要匯入某個檢出的狀態（其中包括它的資料庫）：

oar setup --migrate-from /home/dev/projects/old-oar

指定的資料夾是檢出目錄本身，而不是它的 server/ 資料夾。會發生的事：

• 它會複製資料庫（連同其 -wal 和 -shm 檔案）、設定檔、原本在 data/ 中的 Cursor agent 存放區（只在有資料庫時）、uploads 資料夾，以及 50 MB 以下的 logs 資料夾。
• 它絕不會更動來源。滿意之後，請自行刪除舊資料夾。
• 只要還有中繼從來源執行，它就會拒絕，並說明原因。
• 複製的結果要先經過檢查才算數：資料庫必須通過 SQLite 的完整性檢查，且對話和訊息的數量必須相同。否則它會移除它複製的內容（0.9.14 新增 不再是整個狀態資料夾），並留下一則訊息。
• 0.9.14 新增 它絕不覆寫。狀態資料夾中已有的 config.json 會保留。安裝程式的中繼所建立的空資料庫會被移到 backups/（請先停止中繼：oar stop）；如果資料庫中已有對話，它會拒絕，並說明你該改做什麼。在複製資料庫期間，它會持有中繼的鎖定，所以這段時間不會有中繼在上面啟動。
• 它會把一份回執寫到 backups/MIGRATION.md，並在狀態資料夾中寫入標記檔 .migrated。

0.9.14 新增 搬移過來的上傳檔案會放在 data/uploads/，中繼從那裡讀取；Cursor agent 存放區則放在 data/cursor-agents/，中繼預設從那裡讀取。先前某次搬移留在狀態資料夾 uploads/ 中的上傳檔案，會在下次中繼啟動時合併到 data/uploads/；不會覆寫或刪除任何東西。檢出目錄中以符號連結連到的資料夾，會被複製成真正的資料夾。

裡面有什麼 #

路徑相對於狀態資料夾。「可以安全刪除」的意思是之後中繼仍能運作；這不代表你不會失去任何東西。

在狀態資料夾之外，安裝程式的 oar 啟動器位於 ~/.local/bin/oar（僅限它安裝到 ~/.oar/npm 的情況），Linux 服務則是 ~/.config/systemd/user/oar.service。移除它們的方法見移除 OAR。0.9.15 新增 oar uninstall 會移除服務和套件，並讓狀態資料夾維持原樣；oar uninstall --purge 會在你輸入 delete 之後刪除它。

git 檢出把相同的檔案放在 server/ 中。生成的圖片不在狀態資料夾中，見狀態資料夾之外。

資料庫 #

資料庫是一個 SQLite 檔案：copilot.db。中繼會在第一次啟動時建立它。其中存放的就是你會稱為「你的資料」的東西：

• 對話及其訊息，連同對話紀錄、附件的索引和釘選訊息
• 訊息佇列、排入佇列和等待中的訊息，以及 agent 提出的問題
• 你在網頁介面中變更的中繼設定（全 App 開關、供應商設定、保留期限選擇、更新偏好、模型清單）
• OpenAI、Cursor 和 0.9.17 新增 DeepSeek 的 API 金鑰（如果你輸入了）
• 配對的中繼及其 token，以及監看 session 的訂閱，不論 session 在此中繼還是在配對的中繼上
• 你裝置的網頁推播訂閱，以及中繼的推播金鑰
• 分享對話的連結
• subagent 和工作流程的紀錄，以及每個對話的活動和思考
• 上傳檔案的索引，以及哪些訊息使用它們
• Check Usage（檢查用量）中方案用量計的用量快照，以及 0.9.17 新增 DeepSeek 卡片所計算的內容：每個模型、每天 DeepSeek 回合的 token 和搜尋次數、每個 DeepSeek session 最後回報的合計，以及它的進度條所依據的餘額讀數
• 圖片對話：它們的操作，以及生成圖片之間的連結
• 預覽卡片

每次中繼啟動時，資料庫遷移都會自行執行。它們會建立缺少的部分並新增欄位，再次執行也不會改變任何東西。你不需要執行它們，也無法略過它們。

備份 #

OAR 沒有備份指令。資料庫以 SQLite 的預寫式（write-ahead）模式執行，所以最近的變更可能還在它旁邊的 -wal 檔案中。要備份它：

1. 用 oar stop 停止中繼。
2. 把 copilot.db，以及 copilot.db-wal 和 copilot.db-shm（如果存在）一起複製。
3. 再次啟動中繼。

要還原時，先停止中繼，然後把複製的檔案原樣放回去。不要在中繼執行時單獨複製 copilot.db，也不要把某個資料庫檔案和另一份副本的 -wal 檔案混在一起。備份中含有你的 API 金鑰和 token，見機密存放在哪裡；請像保護狀態資料夾一樣保護它。

記錄 #

Copilot 擴充功能引擎沒有 worker 記錄：它就是 Copilot CLI 自己的終端機。以 systemd 服務執行的中繼也會寫入 journal，見自動啟動中繼。

以 npm start 啟動的 git 檢出把記錄放在 server/logs。以 oar start 或 oar copilot 啟動的則放在 ~/.config/copilot-remote/logs（Windows：%LOCALAPPDATA%\copilot-remote\logs），除非 COPILOT_WEB_RELAY_LOG_DIR 指定了另一個資料夾。

機密存放在哪裡 #

當 worker 在 tmux 下啟動時，中繼會把它的供應商金鑰（OpenAI、Cursor 或 0.9.17 新增 DeepSeek 的金鑰，或是來自中繼環境、給 Claude Cloud 或 0.9.17 新增 Claude worker 用的 CLAUDE_CODE_OAUTH_TOKEN）寫入系統暫存資料夾中的一個暫存檔，只有你能讀取。worker 的 shell 讀取一次後就會刪除它。每個 worker 只會拿到它自己供應商的金鑰。

保留期限 #

中繼會自行移除以下項目。除非你刪除對話，否則不會刪除其他任何東西。

刪除對話會從資料庫中移除它的訊息、佇列項目、提問和 subagent 紀錄，以及屬於它的 Claude 對話紀錄和生成的圖片。0.9.17 新增 對 DeepSeek 對話，還會在 data/deepseek-claude/ 中移除對話紀錄、session 的資料夾、它已停止的 Claude Code 留下的東西（它的註冊資訊、hook 環境和 shell 快照），以及沒有其他 session 使用時的專案資料夾；並從資料庫中移除它的 session 最後回報的合計。它加到 DeepSeek 卡片合計和每日數字中的部分會保留。每個供應商自己保存的內容見下一節。

狀態資料夾之外 #

在 0.9.14 之前，Cursor 存放區預設位於套件資料夾內的 server/data/cursor-agents，而更新會取代這個資料夾，所以對話可能會失去它儲存的 agent 並得到一個新的（見 Cursor）。存放區仍在舊位置的對話會繼續在那裡使用它；兩個位置都有存放區的對話，會使用最後變更的那一個；不會搬移或刪除任何東西。

你的 agent 的工作成果，也就是你專案資料夾中的檔案，完全在 OAR 的儲存空間之外。

每個資料目錄一個中繼 #

中繼啟動時會在資料目錄中建立 relay-server.lock，停止時移除它。這個檔案存放中繼的處理程序編號、它的 token 的雜湊，以及它的啟動時間。

如果第一個中繼正在執行時，第二個中繼在同一個資料目錄上啟動，第二個會印出一行訊息並結束，0.9.14 新增 結束代碼為 78（之前為 1），Linux 服務不會重試這個代碼：

Relay already running (pid=4242, startedAt=2026-01-05T09:12:40.000Z; lock /home/dev/.oar/data/relay-server.lock). It is held by relay process 4242: oar stop, or end process 4242.

如果看到的是 Relay appears to be owned by another live process 而不是 Relay already running，表示執行中的中繼使用另一個 token。當無法確認持有者是中繼時，提示會是 If no relay is running, end process 4242 or delete the lock.。oar start 在 The relay did not come up 之後會印出相同的提示。第一個中繼不會受到影響。當實際執行的中繼不是你預期的那一個時，訊息會一直停在待處理狀態；oar doctor 會顯示正在使用的設定檔和資料庫。

當機或斷電後，鎖定檔會被留下。0.9.14 新增 如果鎖定是在上次開機之前建立的，或者它的處理程序編號現在屬於一個在它之後才啟動的處理程序，這個鎖定就是過時的：下一次啟動會把它移到一旁，記錄 Recovered stale singleton lock，然後接手鎖定。這不再依據時鐘判斷，所以時鐘跳動不會讓執行中的中繼看起來像已經消失，兩個同時回收同一個鎖定的啟動也不會都執行起來。無法讀取的鎖定（斷電留下的空鎖定）會再讀取一次，並視為已被持有，除非它的時間相差超過 10 秒。oar start 不再移除這個版本寫入的鎖定；當中繼的連接埠上沒有任何回應時，它仍會移除舊版本寫入的鎖定。

兩個中繼只要有各自的資料目錄和連接埠，就可以同時執行。oar 如何找到中繼，見 oar 指令；重新啟動會保留什麼，見重新啟動與繼續。