檔案系統

Beam 將持久使用者內容與可替換的應用快取分開。備份、移動、檢查或排查 Beam 安裝問題時，請參考此頁面。

Beam 儲存使用者檔案的位置

Beam 會解析作業系統的“影片”資料夾，並在其中建立 Beam/user。重定向或本地化的“影片”資料夾會改變解析後的位置，因此下面的路徑是通常的預設值，而不是硬編碼位置。

• Windows: %USERPROFILE%\Videos\Beam\user
• macOS: ~/Movies/Beam/user
• Linux: ${XDG_VIDEOS_DIR:-~/Videos}/Beam/user

在 Windows 上開啟資料夾

按

Win+R

，貼上 %USERPROFILE%\Videos\Beam\user，然後按

↵

。Windows 會展開 %USERPROFILE%，並在檔案資源管理器中開啟該資料夾。

在 macOS 上開啟資料夾

開啟 Finder，按

⌘+Shift+G

，貼上 ~/Movies/Beam/user，然後按

↵

。Finder 會將 ~ 展開為你的主資料夾。

在 Linux 上開啟資料夾

開啟檔案管理器，按

Ctrl+L

，輸入 ~/Videos/Beam/user，然後按

↵

。如果“影片”目錄被重定向，請在終端中執行 xdg-open "$(xdg-user-dir VIDEOS)/Beam/user"。

資料夾會按需建立

有些目錄只有在首次使用相關功能後才會出現。查詢 projects/ 前先錄製一次；查詢桌布庫前先匯入一個背景。

使用者資料佈局

Beam/user 目錄可能包含以下持久資料：

Beam/user/
├── preferences.json
├── projects/
│   └── project-<readable-name>/
├── media/
│   └── wallpapers/
│       ├── image/
│       └── video/
└── models/
    └── whisper/

• preferences.json 儲存外觀、錄製器行為、所選裝置、快捷鍵、引導狀態、預設和儲存的視窗位置。需要時，它會使用規範化的預設值建立或替換。
• projects/ 儲存每個 Beam 專案及其錄製會話。這是最重要的備份目錄。
• media/wallpapers/image/ 和 media/wallpapers/video/ 儲存匯入共享桌布庫的背景副本。這些目錄是可選的。
• models/whisper/ 儲存已下載的本地轉錄模型、模型清單和臨時 .partial 下載檔案。模型是可選的，可以重新下載。

錄製和專案

每個專案使用一個易讀的目錄名稱，例如 project-vivid-cosmic。穩定的專案 UUID 位於 project.json 中，因此目錄名稱不是專案的身份。重新命名專案也可能重新命名其目錄。

專案目錄

一個已開發的專案可能如下所示：

project-<name>/
├── project.json                         required
├── thumbnail.webp                       optional
├── media/                               optional imported editor media
├── backgrounds/                         optional project backgrounds
└── session-<uuid>/                      one or more recording sessions
    ├── manifest.json                    completed session
    ├── manifest.partial.json            interrupted/in-progress recovery state
    ├── health.jsonl                     capture diagnostics
    ├── timing.jsonl                     clock synchronization anchors
    ├── screen/                          screen video segments
    ├── system-audio/                    optional system-audio segments
    ├── microphone/                      optional microphone segments
    ├── camera/                          optional camera segments
    ├── cursor/                          optional cursor and interaction data
    └── session/teleprompter.json        optional teleprompter document

必需的專案後設資料

• project.json 是專案清單和事實來源。其中包含架構版本、穩定專案 ID、顯示名稱、時間戳、會話引用、編排、演示設定、字幕、縮放狀態和匯入資源引用。
• 每個完成的會話通常都有 manifest.json，用於描述平臺、所選來源、許可權、警告、軌道格式、片段、指標和完成狀態。
• manifest.partial.json 會在捕獲進行中或會話未完成時保留可恢復的後設資料。恢復的會話可以合法地使用它，而不是 manifest.json。

不要手動編輯清單

清單是帶有跨檔案引用的版本化應用資料。手動編輯、移動單個會話檔案或重新命名專案內的檔案，可能導致編輯器無法使用媒體。

軌道和媒體目錄

• screen/ 在螢幕捕獲成功時包含編號的 MP4 螢幕片段。
• system-audio/、microphone/ 和 camera/ 包含為相應啟用來源寫入的編號 WebM 片段。
• 即使沒有選擇某個來源，五個軌道目錄也可能存在。應使用會話清單中的 tracks 條目和狀態，而不是根據空目錄是否存在來判斷錄製了什麼。
• 活動或中斷的瀏覽器媒體寫入期間可能存在臨時 .partial 媒體檔案。已完成的片段會以原子方式重新命名。
• media/ 包含匯入編輯器的影片、影象或音訊副本。透過 Beam 移除未使用的匯入資源時，可能會刪除其副本檔案。
• backgrounds/ 包含專門匯入該專案的背景副本。

游標、互動和診斷

• cursor/cursor.json 在游標捕獲可用時包含錄製的游標事件。
• cursor/telemetry.json 包含規範化的游標移動樣本，用於游標跟隨等編輯器行為。
• cursor/shapes.json 描述原生游標形狀；在平臺或相容性路徑需要時，cursor/shapes/*.png 可能包含捕獲的點陣圖形狀。
• cursor/input.json 包含獲得許可的快捷鍵和點選互動後設資料。不會儲存輸入的文字。
• health.jsonl 記錄捕獲健康狀態和中斷；timing.jsonl 記錄用於對齊軌道的時間錨點。移動或診斷專案時，請將兩者與會話一起保留。

可選的演示檔案

• thumbnail.webp 是生成的專案卡片預覽，可以重新建立。
• 只有在為該會話儲存提詞器文件後，才會存在 session/teleprompter.json。
• 生成的字幕和編輯器配置儲存在 project.json 中；專案內不會有單獨的字幕檔案。

備份完整的專案目錄

Beam 未在錄製時，將 project-<name>/ 作為一個整體複製。單獨的螢幕 MP4 不包含編輯器編排、可選軌道、游標資料、字幕或診斷資訊。

更新

下載的更新儲存在作業系統快取中，與專案分開。pending/ 目錄可能包含安裝程式或更新存檔以及 update-info.json。新版本成功啟動後，Beam 會清理更新器快取，同時保留仍在等待安裝的更新。

• Windows: %LOCALAPPDATA%\beam-updater\pending
• macOS: ~/Library/Caches/beam-updater/pending
• Linux: ${XDG_CACHE_HOME:-~/.cache}/beam-updater/pending

更新狀態

Beam 還會將 update-cache-state.json 儲存在 Electron 的應用資料目錄中，以區分已安裝的更新和仍在等待的更新。通常的父目錄是 Windows 上的 %APPDATA%\Beam、macOS 上的 ~/Library/Application Support/Beam，以及 Linux 上的 ${XDG_CONFIG_HOME:-~/.config}/Beam。

更新器檔案可以刪除

不要備份或移動更新器快取。如果當前沒有正在下載或等待重啟的更新，可以刪除它，Beam 會在未來重新下載更新。更新正在下載或已準備安裝時，切勿刪除它。