尋找與管理 Moonpool 的工作階段記錄與偵錯記錄

Moonpool 會保存四類輸出：

類型	位置	保留
工作階段記錄	設定資料夾中的 cli-output\<id>\<session-start-ms>.log	目前的工作階段一律保留；更早的工作階段依下面的保留規則處理
moonpool.log	設定資料夾	僅在 將除錯資訊寫入檔案 開啟時才寫入
傾印檔	你指定的位置，或工作階段記錄自己的路徑	直到你刪除它
捲動緩衝區	終端機分頁中	10,000 行，直到 Moonpool 結束

設定資料夾列在設定位於何處中。

工作階段記錄

應用程式在它的終端機裡印出的所有內容，也會寫入一個記錄檔：

<config folder>\cli-output\<id>\<session-start-ms>.log

• 每個應用程式每次 Moonpool 工作階段一個檔案。那串數字是該 Moonpool 處理程序啟動的時間。

• 停止並重新啟動應用程式，會繼續附加到同一個檔案。一條暗色的分隔線標出每次新執行的開始位置，同樣的標記也會顯示在終端機分頁中：

  1767225600000.log

  Local:   http://localhost:5173/
  ---------- restarted 2026-10-05 09:14:02 ----------
  Local:   http://localhost:5173/

• id 中除了字母、數字、- 與 _ 之外的字元，在資料夾名稱裡會變成 _。所以 . 會變成 _。非英文字母會被保留。

• 該檔案保存的是原始的終端機輸出，包括色彩代碼。需要純文字時請使用傾印檔。

重新開啟應用程式的分頁會重播本次工作階段的記錄，所以你能看到它先前的輸出。

保留規則

保留規則只涉及更早的 Moonpool 工作階段的記錄。它在你啟動應用程式時執行，只處理該應用程式的資料夾，從最舊的開始。

在工作階段之間保留應用程式輸出記錄（cliLogging）	更早工作階段的記錄會怎樣
關（預設）	在該應用程式下次啟動時刪除。
開	保留，直到資料夾的總大小超過 每個應用程式的記錄保留量（logRetentionMb，預設 10 MB），然後刪除最舊的。

目前工作階段的檔案計入這個總量，但絕不會被刪除或截斷。所以一個非常大的目前記錄可能把所有更早的記錄都擠掉。

1. 在工作階段之間保留應用程式輸出記錄 對應 cliLogging。它下面的 每個應用程式的記錄保留量 對應 logRetentionMb。

moonpool.log

開啟 將除錯資訊寫入檔案（debugLogging）後，Moonpool 會把帶時間戳記的行附加到設定資料夾中的 moonpool.log：包括 apps.json 的載入、啟動（含命令與資料夾）、控制命令與錯誤。請在重現問題之前把它開啟。

開啟與複製

在設定中，每個記錄群組下方：

• 開啟 CLI 記錄資料夾 與 開啟記錄檔 會在檔案管理員中開啟該資料夾。
• 複製 CLI 記錄資料夾路徑 與 複製記錄檔路徑 會把路徑放到剪貼簿。

在終端機分頁中，全部複製 會把整個捲動緩衝區複製為文字。

傾印檔

dump 動詞讓你能在指令碼中取得一份工作階段記錄：

& "$env:USERPROFILE\.moonpool\moonpool.exe" dump my-app C:\temp\my-app.log

指定輸出路徑時，它會寫入一份去掉色彩代碼的純文字副本。不指定時，它會回報工作階段記錄自己的路徑。代理可以透過 moonpool_app_output 取得同樣已清理過的文字。請參閱命令列。