Memories

Memories / 文件

本頁目錄

桌面系統匣與 WebUI

Windows 系統匣與 macOS 選單列應用程式提供本機 Memories 背景服務的快速檢視。兩者共用內嵌的狀態儀表板及受限的一般卡片編輯器，沒有外部字型、指令碼或分析追蹤。儀表板支援英文、中文、日文、德文及法文，並能適應較窄的視窗。

狀態投影維持唯讀。解鎖後，卡片編輯器接受保管庫 ID，提供類型選擇器、具型別的欄位、重新命名／移除、拖曳排序，以及建立可重複使用範本的功能。其經過驗證與來源檢查的 POST /api/cards 只會透過同目錄的 CLI 轉送明確允許的卡片／類型操作。它無法解鎖、提升權限、執行程式或揭露敏感值。敏感操作需要原生行動應用程式／CLI 驗證；瀏覽器不提供生物辨識／PIN 註冊功能。請參閱卡片類型。

啟動

  • Windows：解壓縮發行 ZIP，按兩下 memories-tray.exe。將它與 memories.exe 放在同一目錄。啟動器不會開啟主控台視窗。
  • macOS：從 macOS 套件開啟 Memories.app。它會出現在選單列，不會開啟 Dock 視窗。應用程式套件包含配套 CLI。
  • 從終端機：memories tray 會開啟原生系統匣與儀表板；memories webui 只會開啟瀏覽器儀表板，並保持在前景執行。Linux 可以使用 webui；原生系統匣只支援 Windows 與 macOS。
memories --home /path/to/development-home tray
memories --home /path/to/development-home webui --no-open --port 0
memories-tray --home /path/to/development-home --no-open

--home／MEMORIES_HOME 使用與 CLI 相同的儲存區。沒有覆寫設定時，啟動器使用所選組態的 storage_dir，或一般的每位使用者 Memories 主目錄。--config PATH／MEMORIES_CONFIG 選擇 TOML 檔；請參閱組態。--port 0（預設值）會選擇可用的回送連接埠；指定的連接埠也必須可用。前景執行的 webui 命令會印出其本機能力 URL，其中包含片段權杖。--no-open 會停用自動開啟瀏覽器。系統匣的開啟狀態儀表板選單項目可稍後開啟儀表板，即使組態中設定了 desktop.open_browser = false 也一樣；--open 會明確覆寫該設定。--lang 選擇系統匣語言；瀏覽器起初使用自己的地區設定，並提供語言選擇器。

狀態與服務生命週期

系統匣選單會顯示離線、需要設定、已鎖定或已解鎖。啟動背景服務會在配套 CLI 背景服務無法使用時啟動它。這不會初始化儲存區、解鎖或要求提升權限。請照常在終端機使用 memories init、memories unlock 及 memories sudo。

頁面每兩秒重新整理一次。解鎖後會顯示資料庫、啟用的代理及遠端工作階段數量；已設定的雲端供應商類型；待上傳與待下載數量；已套用／已拒絕的傳輸；以及等待同步的資料庫。狀態投影不會顯示記憶文字、資料庫名稱、憑證、帳號身分、檔案路徑或權杖。背景服務鎖定或無法使用時，會清除資料庫／同步詳細資訊。輪詢狀態不會使保管庫持續保持解鎖。

最近變更是目前瀏覽器頁面開啟期間觀察到的事件，不是持久保存的安全稽核紀錄。離線狀態可能表示背景服務已停止、忙碌時間超過探測期限，或版本不相容。請一起升級 CLI 與背景服務，並在升級後重新啟動背景服務。

結束系統匣會移除圖示並停止該儀表板的接聽器。背景服務仍會執行，包括從選單啟動的背景服務。對前景 WebUI 而言，Ctrl+C 會關閉其接聽器。不會安裝任何自動登入啟動註冊。每次個別啟動都使用不同的連接埠與權杖。重新啟動後若要再次開啟儀表板，請使用系統匣選單，避免使用舊書籤 URL。

瀏覽器存取邊界

儀表板只繫結至 127.0.0.1，供同一台電腦使用。每次啟動都會使用新的隨機存取權杖。瀏覽器會從網址列移除權杖，只在分頁工作階段中儲存它。狀態請求需要該權杖，且必須通過 Host／Origin 檢查。一般卡片編輯器使用相同的檢查與封閉的操作允許清單；不提供 HTTP 解鎖、提升權限、憑證交付、命令執行或通用 IPC 端點。啟動 JSON 會回報 read_only: false、status_read_only: true 及 card_editor: true，以區分卡片寫入與唯讀狀態投影。請參閱安全性。

建置與封裝

cargo build --workspace --release --locked 會同時建置 memories-tray、CLI、relay 及 FFI。Windows 套件須從乾淨且已提交的簽出目錄建立：

pwsh -File scripts/package-windows.ps1

在具備 Rust、Xcode Command Line Tools 及 Python 3 的 macOS 主機上：

bash scripts/package-macos.sh

macOS 指令碼會建置主機架構（Apple Silicon 或 Intel），封裝 Memories.app、CLI／relay／FFI 檔案、所有受版本控制的 docs/、字型授權、逐檔建置清單及封存檔校驗碼。它不會為發行進行應用程式簽署或公證。Windows 建置不會驗證 macOS 執行階段行為。各次發行實際測試的內容，請參閱驗證。

在 Linux GNU 主機上，bash scripts/build-linux.sh 會建置 release 工作區；bash scripts/package-linux.sh 會從乾淨且已提交的簽出目錄建立 CLI／relay／FFI .tar.gz。請參閱 Linux 必要條件。使用 memories webui 開啟儀表板；Linux 套件不包含不受支援的原生系統匣啟動器。