檔案與快速開檔

側欄的 檔案 身分是側欄所顯示 repo 的檔案樹，加上你打開的檔案的檢視器與編輯器。它的用途是在 agent 旁邊閱讀與小幅修改 —— 更深入的工作交給 agent 或你自己的編輯器。

在側欄頂端按 檔案 切過去。

檔案樹

• 目錄在你展開時才載入，所以大型 repo 也開得很快。
• 每一列顯示它是檔案還是目錄，以及多久之前修改過；標題列顯示目前看得到幾個項目。
• 磁碟上的檔案被建立、修改或刪除時 —— 不論是 agent、build，還是你在別的程式裡 —— 檔案樹會自己更新。
• 指向資料夾之內的 symbolic link 可以像一般目錄一樣展開。指向資料夾之外的則不行：側欄只讀取你加入的 資料夾裡的檔案。

repo 若有不只一個 git worktree，檔案樹頂端的 變更工作目錄 可以切換要顯示哪一個。每個資料夾各自 記得自己的選擇。

閱讀檔案

點一個檔案就會打開它。Markdown 會被渲染；其他檔案以語法高亮呈現。OpenSpec 的檔案按 在 OpenSpec 中檢視，會在 OpenSpec 身分打開同一個 artifact 或 spec；回到檔案樹 就回來。

repo 裡的 Markdown 被視為不受信任的內容：原始 HTML 以純文字呈現、script 絕不執行，http / https 連結會在你的瀏覽器開啟，而不是在 spekterm 裡（其他連結無法點擊）。放在 https: 位址上的圖片會被 載入 —— 見資料與網路。

編輯

打開的檔案可以編輯。

• Ctrl+S 存檔。
• 有未儲存變更的檔案，會在檔案樹與狀態列上標示。未儲存的變更在你切換檔案、切換資料夾之後都還在。
• 若檔案在你打開之後被磁碟上的改動改過，存檔不會覆蓋它 —— spekterm 會問你要怎麼做。
• 關閉 spekterm 時若有未儲存的變更，會問你要 全部儲存並結束 還是 不儲存並結束。

編輯器有語法高亮，但不執行語言服務（沒有型別檢查、自動完成或跳到定義）。這讓 spekterm 保持輕巧快速； 深入的修改請交給 agent 或你的編輯器。

新增、重新命名與刪除

在檔案樹上按右鍵，有 新增檔案、新增資料夾、重新命名 與刪除。在根目錄新增 會建在 檔案樹的最上層。

• 建立之前會先檢查名稱，不能用的話會說明原因（名稱為空、保留名稱、某些系統不允許的字元）。
• 刪除一定會先問，並在項目是目錄或含有未儲存變更時特別說明。刪除無法復原。
• 資料夾本身不能在這裡改名或刪除；請改成從 rail 移除它。

快速開檔

焦點在側欄時按 Ctrl+P，以檔名找檔案。

• 輸入名稱的任何部分；字母只要依序出現即可（scr 找得到 score.ts）。命中檔名的結果排在命中目錄 路徑的前面。
• 搜尋範圍是側欄目前顯示的工作目錄。被 git 忽略的檔案與其他 worktree 裡的檔案不會列出。
• 用方向鍵與 Enter 在「檔案」打開檔案；Esc 關閉清單，焦點回到側欄。

焦點在終端時，Ctrl+P 會交給終端 —— Claude Code 用它來翻 prompt 歷史。先點一下側欄，或直接用檔案樹。

「檔案」碰得到與碰不到的地方

「檔案」只在 rail 上的資料夾之內讀寫。即使是透過文件裡的連結，它也打不開那些資料夾之外的路徑。 這道邊界只約束側欄：終端是真的 shell，你的使用者帳號能去的地方它都能去。