留下決定13 / 20
回看每一版
本頁內容
意圖文件的每次變更都留著。選一個版本,就能看到那一次改了哪幾篇、每篇改了什麼,是你自己改的,還是 Agent 提議、你接受的,以及當時的文字有怎樣的說明。當初是怎麼定下來的,翻得回去。
進入文件歷史
有三個入口:
- 把滑鼠移到側邊欄「意圖」的標題行,點選歷史按鈕。
- 選擇選單「顯示方式 → 文件歷史」,或按
⌘Y(Windows 和 Linux 上為Ctrl+Y)。 - 在一段顯示「這是先前文字的說明」的旁註裡,點「在文件歷史中檢視」。
前兩個入口只切換側邊欄,並選中最新的版本,主區域不變。第三個入口會選中最近改過這篇文件的版本,並把目前文件原地換成那個版本的歷史文件。
歷史中,主區域的分頁、並排、程式碼面板和對話照常使用。點側邊欄頂部的「離開文件歷史」回到平常的側邊欄,歷史文件分頁隨之關閉。
版本從哪裡來
一次意圖文件的變更就是一個版本。版本按來源有幾種:
| 來源 | 清單中的標題 |
|---|---|
| 接受一份提議 | 提議的標題,例如「進入寬限期時郵件通知團隊擁有者」 |
| 接受一份整理方案 | 整理 |
| 你在 Noea 裡儲存,或在 Noea 之外修改了檔案 | 手動修改。連續的手動修改合併為一個版本,直到下一次解釋完成 |
| 所有改過的文件都回到了某個已記錄的狀態 | 回到「那個版本的標題」 |
| 開始記錄版本時文件的樣子 | 開始記錄 |
讀版本清單
在歷史中,側邊欄下半部分換成版本清單,按天分組,最新的在前。每個版本佔兩行:第一行是標題;第二行依次是時間、狀態圖示、來源圖示和改動的文件數,例如「2 份文件」。
- 時間:手動修改版本顯示第一次到最後一次改動的時間段,還沒有結束的標「進行中」。
- 狀態:已說明、調查中或未說明,即這一版的文字是否已經有了說明,懸停可以看到。
- 來源:區分你和 Agent;回到舊版本有單獨的圖示。
側邊欄上半部分仍是意圖文件樹,層級和展開狀態與進入前相同。所選版本改動過的文件帶標記:
| 改動 | 標記 |
|---|---|
| 新增 | 名稱旁綠點 |
| 修改 | 名稱旁黃點 |
| 刪除 | 列在它最後所在的位置,紅色刪除線、變淡 |
| 改名 | 顯示新名,旁邊淡淡地寫著原名 |
打開某一版的文件
選中一個版本,點選文件樹裡的一篇文件,主區域打開它在這一版的樣子。歷史文件是唯讀的,標題旁有鎖圖示,懸停時說明這是哪個版本;排版、大綱、尋找和旁註都和平常一樣,文字可以選中複製。
文件裡按審閱模式的樣式標出這一版相對上一版的改動:新增、改寫和刪除,刪除的段落留在原處。底部可以逐處瀏覽。
如果這一版沒有改動這篇文件,顯示的是在此之前最近一次改動後的內容,並註明來自哪個時間;如果這篇文件在這一版還不存在,或被這一版刪除了,也會寫明。
換選版本時,已打開的歷史文件會跟著切到同一篇文件在新版本中的樣子。一個視窗同時只有一個歷史文件分頁。
看當時的說明
歷史文件裡的每一段顯示的是這一版文字對應的說明。如果這一段後來被改寫或刪除,旁註頂部寫著「這是此版文字的說明」:它解釋的是當時的文字,不代表文件現在的樣子。這一版還沒有說明的段落標「尚未說明」,正在調查的標「調查中」。
這讓你能回答「當時為什麼這樣實作」:比如三週前接受「寬限期」這份提議時,說明裡列出了「7 天按 168 小時計算」這個選擇,後來才改成按團隊時區的自然日。
想回到舊版本時
文件歷史只用來查看,不提供「恢復到這一版」。需要恢復時,從歷史文件裡複製當時的文字,回到目前文件貼上並儲存;或者在對話裡請 Agent 起草一份提議,把某段改回舊版本的說法,你審閱後接受。
如果你用 Git 管理意圖資料夾,也可以用 Git 恢復檔案。文件全部回到某個已記錄的狀態時,版本清單裡會出現一條「回到……」。