查找和管理 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 得到同样已清理过的文本。参见命令行。