# MAT- 私人測試操作與資料恢復指南

版本：0.1.3，macOS Apple Silicon 私人測試。這次請以同一台 Mac 完成一件真實工作，觀察 MAT- 是否幫助你理解、整理與推進專案。先選可承受測試中斷的小型任務；目前尚未正式發行。

## 安裝

開啟 DMG，將 MAT-.app 拖到 Applications，再從 Applications 開啟。此版未經 Apple 公證；如 macOS 要求確認，請由本人在系統介面處理。若無法開啟，回報畫面訊息，不需提供 Mac 密碼。更新前先正常關閉舊版，原帳號與資料目錄維持相容。不同建置版本可能再次要求金鑰鏈存取授權。

## 開始

1. 在「登入與帳號」輸入已受邀的 Email，取得驗證碼後於同一介面輸入。服務接受寄信請求不代表已登入。
2. 登入會開啟該帳號的本機資料分區。未登入的舊工作空間仍保留，不會自動移到新帳號。
3. 首次要使用雲端同步，至設定 → 個人資料啟用；先自動建立完整本機副本。啟用後，編輯會自動保存與背景上傳，不需每次按儲存。未啟用時仍可在此裝置工作。
4. 首頁可新建工作空間，或匯入 AI 依 JSON 說明書產生的工作空間。JSON 規格匯入不能代替包含原檔與歷史的完整備份。
5. 設定 → 使用說明 →「開啟獨立操作示範」。首次建立示範，後續開啟保留練習內容。「重設示範」只修改這個獨立示範；重設前內容仍可從版本恢復。

## 地圖與內容

- 點擊／拖曳空格建立節點，拖曳節點調整位置。單擊開啟內容，雙擊進入全畫面。
- 節點編輯區可置於下方、右方或全畫面。「編輯版面/新增欄位」安排標籤頁與欄位，拖曳握把排序，自動保存。
- 節點右鍵 → 顯示設定，安排地圖卡片顯示內容。背景圖的預覽與原檔分開；內容中的圖片／附件保留原檔與版本。
- 連線由輸出節點的右／下方通往輸入節點左／上方。普通順序線不限制人工操作。選中連線後可刪除，也可在「前後步驟」欄位移除。
- 橫向 60×12 與直向 12×60 是同一份資料的閱讀方式，切換不重建地圖。

## 局部重複流程

選取需要反覆執行的節點，建立局部重複流程並命名輪次。例如受眾分析只做一次，電影挑選至發布則每一期各自保存。新輪次不複製上一輪成果；共用欄位維持流程規格，每輪獨立欄位保存當輪內容。從側邊欄切換輪次，雙擊輪次名稱可直接改名。

## 導覽、封存與日期

側邊欄節點右鍵可「從側邊欄中隱藏」或「封存節點」。隱藏不影響地圖；所屬階段右鍵 →「復原隱藏節點」可選擇復原。地圖右上方「封存區」保留節點、輪次與附件引用，支援復原及經確認後永久移出封存區；原位置被占用時改放空位。既有版本與備份可能仍保留副本。

1×1 地圖卡片除了標題、狀態與背景圖，可顯示一個額外欄位，例如截止日期；文字摘要最多50字。日期欄位可直接輸入 YYYY-MM-DD，或按日曆符號開啟向上展開的選擇器。側邊／下方編輯區的手動文字框大小在本次工作台開啟期間記住，重新開啟重設，不寫入專案或雲端。

## 保存狀態

一般使用不需要刷新頁面或操作版本選擇。編輯先保存到此裝置，背景上傳；連線正常時約每15秒檢查其他裝置的修改。正在輸入或拖拽時保留目前畫面，結束後更新。不同節點、欄位與輪次的修改自動合併；同一欄位競爭採最後成功寫入者，文字欄位以整段內容為單位，並保留被取代內容供恢復。離線裝置較晚送出的修改可能成為最後寫入，這不是多人逐字即時協作。換裝置前確認已同步。

- 「已同步」：服務已確認目前文字資料；附件上傳仍有獨立狀態。

- 「正在儲存」：尚有未完成的本機寫入。此時不要關閉或清除裝置資料。
- 「此裝置已保存，等待同步」：本機交易完成，尚無雲端成功確認。啟用同步後，系統會背景上傳並重試；未啟用則保存在此裝置。
- 「同步遇到問題，本機修改仍保留」：保留裝置與本機資料，恢復連線／重新登入後重試。
- 「無法儲存」：不要離開目前視窗。釋放空間後重試；只有舊修改缺少合併基準或地圖沒有可用空位等特殊情況，才需要到「版本與恢復」檢查保留內容。
- 附件上傳狀態與文字保存分開。尚未同步且唯一裝置損毀的內容，沒有異地恢復保障。

## 備份與恢復

設定 → 隱私與資料 →「備份／還原」匯出完整備份。將備份放到另一個可靠位置；同裝置的自動副本無法保障該裝置損毀。完整備份包含此裝置已取得的持久歷史、轮次、原檔和衝突副本；外部圖像網址不包含外部原檔，尚未取得的雲端歷史也不在備份內。

還原會先驗證與預覽，確認後新增工作空間，保留原有工作空間。版本恢復產生新版本，保留恢復前內容。移入垃圾桶保留內容、輪次和附件，目前沒有永久刪除。

本機自動副本保留最近三份；歷史政策為最近100個版本及最近30日每日檢查點。待同步、衝突與垃圾桶工作空間受保護，不清理。這不是無限歷史。

## 限制與回報

一般附件單檔最多50 MiB，測試雲端每帳號128 MiB；完整備份目前採記憶體打包，JSON上限200 MiB、原檔合計140 MiB。不適合大型影片素材。macOS Intel、Windows、另一台實體 Mac 的首次安裝／更新及所有故障組合尚未驗證。Backblaze 異地自動備份尚未啟用。

設定 → 使用說明 →「下載診斷檔」。檔案只有版本與保存狀態，不包含正文、附件、帳號識別或憑證，也不會自動傳送。將檔案、重現步驟、預期／實際結果交給測試負責人。提供截圖前先檢查私人內容；不要傳送驗證碼或金鑰。

## 用幾天後，請告訴 Milo

1. 你用 MAT- 處理什麼工作？它有幫你理解或推進工作嗎？
2. 哪一步卡住，或讓你想回到原本的工具？請描述當時想完成的事情。
3. 你願意繼續用嗎？最主要的原因是什麼？

產品感受直接傳给邀請你的 Milo；系統錯誤再附版本、步驟與診斷檔，不需提交私人工作內容。