Memories

Memories / 文件

本頁目錄

Memories 網頁版

在瀏覽器開啟 Memories 網頁版，連接既有的託管 Center。這是 Center 用戶端，不是瀏覽器本機加密保險庫。Center 營運者可以讀取託管內容。僅限裝置的機密、端對端配對及衝突解決仍應使用原生用戶端。

連線

啟用帳號驗證時，請選擇登入或註冊。電子郵件註冊會寄送一次性驗證碼，有效期限為 15 分鐘。輸入驗證碼，並選擇 12-256 UTF-8 位元組的密碼，以建立您的私人託管保險庫，然後登入。營運者選用使用者名稱註冊時，亦可使用該方式。註冊可以獨立於登入關閉。SMTP 失敗絕不會略過驗證。目前尚不支援重設密碼及變更電子郵件／使用者名稱。

對於管理員建立的成員或舊版 Center，請選擇使用權杖：

  1. 向管理員取得您 Center 的 HTTPS 來源，以及成員或限定範圍的授權權杖。管理員權杖不授權內容存取。
  2. 在網頁版輸入來源與權杖。託管 SaaS 請使用 https://memories.ivjn.us；公開網頁預設會選擇此位址。您也可以輸入自己的 Center（例如 https://center.example.com）。不要把權杖或密碼放入 URL。既有成員權杖仍可使用，不會自動轉換成密碼帳號。
  3. 連線後會顯示授權的保險庫與範圍。讀取、寫入及刪除控制項遵循授權；伺服器會獨立強制檢查每項操作。

您可以瀏覽記憶、知識卡片與檔案；搜尋其標題／標籤；建立及編輯記憶／卡片文字；編輯卡片標籤與隱私設定；上傳最大 12 MiB 的檔案；下載檔案；以及在授權允許時刪除項目。其他卡片欄位以唯讀方式顯示，敏感欄位則隱藏。更新文字時，伺服器會保留既有的結構化與受保護中繼資料。此用戶端無法編輯憑證、E2E 機密材料與有衝突的修訂。檔案會以附件方式下載，絕不在頁面中執行或預覽。

搭配 Center 部署

新版 Center 建置在 /app/ 提供相同的前端。不需要額外的網頁伺服器。遠端存取請使用 Center 前方既有的 HTTPS 反向代理；一般 HTTP 只支援用於本機開發的回送介面。

同來源使用（https://center.example.com/app/ 連接到 https://center.example.com）不需要 CORS 設定。若要以公開網站作為前端，請在啟動 Center 時允許該特定來源：

memories-center --data /path/to/center --web-origin https://memories.ivjn.us

簽署、管理員權杖、授權與託管密碼請沿用既有的受保護環境設定。--web-origin 可重複指定或以逗號分隔；MEMORIES_CENTER_WEB_ORIGINS 是對應的環境設定。除明確指定的 localhost／回送開發來源外，必須使用 HTTPS 來源。不接受萬用字元、含憑證的 URL、路徑、查詢或片段。

CORS 僅限託管工作階段、帳號驗證、記憶與 RPC 端點。它不允許瀏覽器存取管理、註冊裝置或授權管理端點，也不會放寬 bearer 授權。既有 Center 必須升級才能提供 /app/ 或使用此來源設定。若反向代理已實作等效的精確來源政策，也可改為提供既有內容 API。

工作階段行為

帳號登入會建立有效一小時的 bearer 授權。中斷連線時會嘗試撤銷該工作階段，包含頁面鎖定或離開時。若瀏覽器無法送出登出請求，授權仍會有效，直到伺服器強制規定的期限到期。關閉註冊或變更註冊模式不會終止既有帳號。

bearer 與回傳內容只保留在頁面記憶體中，不存入 localStorage、sessionStorage、IndexedDB 或 service-worker 快取。只有語言偏好會保存。重新載入、離開頁面、將頁面切到背景，或五分鐘沒有互動，都會清除連線與可見內容。自動鎖定會捨棄尚未儲存的變更。JavaScript 記憶體回收不保證實體抹除記憶體，瀏覽器擴充功能或偵錯工具可以查看內容，下載的檔案也會留在裝置上。

用戶端會將每個權杖綁定到選定來源，並拒絕重新導向。中斷連線時會取消待處理請求，並捨棄延遲回應。已抵達伺服器的請求在取消後仍可能完成：重試中斷的寫入前，請先檢查結果。

中文使用說明

開啟網頁版，填入自己的 Center HTTPS 位址，以及管理員提供的成員或授權權杖。託管 SaaS 位址為 https://memories.ivjn.us，官網網頁版預設會選擇該位址，也可以手動連接自己的 Center。啟用帳號服務後可選擇登入或註冊：電子郵件模式先驗證電子郵件再設定密碼，使用者名稱模式直接建立帳號。管理員可關閉註冊，既有帳號仍可登入。既有成員可選擇「使用權杖」；管理員權杖不能用於內容登入。

連線後可瀏覽、依標題和標籤搜尋記憶／卡片／檔案，編輯記憶與卡片內文、標籤和私人標記，上傳最大 12 MiB 的檔案並下載，在權限允許時刪除內容。卡片附加欄位目前唯讀，敏感欄位維持隱藏；編輯內文不會覆寫伺服器既有的結構化資料。憑證、裝置端對端機密和版本衝突請繼續使用原生用戶端處理。

新版 Center 內建 /app/ 頁面，同來源連線不需要跨來源設定。從官網連接自己的 Center 時，請為服務加入 --web-origin https://memories.ivjn.us，並沿用原本的受保護服務環境設定。這只開放指定內容介面的瀏覽器來源，不改變每次請求的權杖與權限檢查。

權杖與內容僅放在頁面記憶體中。重新整理、切到背景或閒置 5 分鐘會鎖定並清除頁面資料，自動鎖定會捨棄未儲存的編輯。資料儲存在 Center，伺服器營運者可以讀取；本版本不提供瀏覽器本機加密保險庫。網路中斷時先重新整理並核對寫入結果，避免重複提交。