wiki 文件中的機密

使用機密參照，取代記憶或知識卡片目前內文中的已知密碼或權杖。文件會保留 {{secret:API_KEY}} 之類的標記，並由同一保險庫中的加密憑證保存其值。目前的讀取、搜尋與 MCP 不會展開標記。

此功能需要更新版 CLI／常駐程式或行動應用程式。在同步包含參照的文件前，請先更新每個用戶端：舊用戶端無法解碼新的內容欄位。請參閱安全邊界與驗證結果。

取代機密

啟動常駐程式並解鎖資料庫。使用清單或搜尋回傳的保險庫與文件短 ID。取代前，請在同一個終端機執行 sudo：

memories sudo
memories memory protect-secret VAULT_ID DOCUMENT_ID API_KEY

知識卡片請使用：

memories card protect-secret VAULT_ID CARD_ID API_KEY

CLI 會提示輸入精確的機密，且不回顯。不要將機密放入引數或參照名稱。取代採區分大小寫的字面比對；不使用正規表示式。目前內文中所有不重疊的符合項目都會取代。例如，含有兩次相同合成權杖的內文會變成：

API_KEY={{secret:API_KEY}}
Authorization: Bearer {{secret:API_KEY}}

成功時會在一般 JSON 回應中回傳文件 id、新的 credential ID 與 replacements 次數。憑證建立與文件取代會一起提交；遭拒絕的操作不會儲存任何一項變更。

在行動應用程式中，開啟記憶／卡片選單，選擇保護文件中的機密，確認歷程警告，輸入參照名稱，再於隱藏欄位輸入機密。出現提示時，完成密碼授權。

參照名稱包含 1-64 個 ASCII 字母、數字、底線或連字號，且不得已在該文件使用。一份文件最多可有 64 個參照。取代需要本機 sudo 與保險庫寫入權限。下列情況會遭拒絕：

• 機密為空，或未出現在目前內文中。
• 名稱無效、已建立對應，或其標記已出現在內文中。
• 機密也出現在標題、標籤或來源等中繼資料中，或會留在新標記中，或會改變既有參照標記。
• 文件有尚未解決的版本衝突，或產生的內容超過大小或參照數量限制。

重試前，請移除中繼資料中暴露的值並解決衝突。這些編輯仍會保留已簽署的歷史版本。

複製目前值

複製需要本機 sudo。文件參照即使只有一個，也必須提供其標籤。憑證或受保護卡片請使用本身的 ID：

memories sudo
memories credential copy VAULT_ID DOCUMENT_ID --label API_KEY
memories credential copy VAULT_ID CREDENTIAL_ID
memories credential copy VAULT_ID PROTECTED_CARD_ID

CLI 會寫入系統剪貼簿，只顯示複製狀態（"copied": true）。已驗證的本機用戶端會收到明文，以執行複製。一般憑證讀取與匯出仍不提供，MCP 即使具有寫入授權，也無法執行取代或複製。

在行動應用程式中，從文件、受保護卡片或憑證選單選擇複製機密。若為文件，請選取參照名稱，確認剪貼簿警告，並在提示時完成授權。應用程式會顯示成功而不顯示值，並在進入背景或鎖定後捨棄延遲回應。

受保護的帳號與權杖卡片會複製其儲存的密碼或權杖。env 卡片會複製儲存的 dotenv 文字。OTP 卡片會複製其 Base32 種子；請使用獨立的 OTP 動作產生目前的一次性代碼。剪貼簿複製只接受 UTF-8 文字，並拒絕含有 NUL 位元組的憑證。

Linux 依 WAYLAND_DISPLAY 選擇輔助程式；不會自動從 wl-copy 改用 xclip。缺少輔助程式或無法存取剪貼簿會使命令失敗。服務會先記錄交付意圖，再將值傳送到用戶端，因此單憑該稽核項目無法證明剪貼簿複製成功。

編輯、同步與限制

文件的具型別 secrets 對應表會將標籤綁定到憑證 ID。手動輸入標記不會建立憑證或授予存取權。一般編輯必須保留既有對應表；CLI 與行動版編輯器都會保留。目前 MCP 的 card_write 工具不攜帶該對應表，因此透過它更新含有機密參照的卡片會遭拒絕。請使用 CLI 或行動版編輯器處理這些卡片。從內文移除標記不會刪除對應或憑證。

參照會解析目前的憑證值。若要更新，請將回傳的憑證 ID 用於已授權的憑證取代命令，例如 memories credential add VAULT_ID API_KEY --id CREDENTIAL_ID，該命令會提示隱藏輸入。文件標記維持相同。這會變更儲存的值；供應者端的金鑰輪替必須另外執行。

文件與憑證會在加密同步時隨保險庫一起傳送。獨立備份復原會保留沒有歧義的資產參照；僅限裝置的保險庫仍排除於同步與備份之外。刪除被參照的憑證或讓其維持衝突狀態，會使透過該參照複製的操作無法執行。

取代只會變更目前內文。先前已簽署的修訂、復原封存、既有備份、其他文件與分享副本可能保留原始機密。請向發行者撤銷或輪替已暴露的金鑰。

剪貼簿內容可能在鎖定後仍存在，並可被其他應用程式、剪貼簿歷程或作業系統同步讀取或保留。使用後請清除剪貼簿；應用程式不保證剪貼簿抹除。