日志
约 1179 字大约 4 分钟
Harbor 把程序输出集中到同一个界面中。Task 启动后可以立即查看实时日志;停止后,仍然可以从历史记录中继续排查。
先选择正确的日志
日志区域左侧显示当前 Workspace 最近的任务日志:
- 带有 live 状态的是正在运行的 Task,内容会持续更新。
- 带有 history 状态的是已经停止的 Task,内容不会再变化。
- 正在运行的日志排在最前面,其他日志按最近更新时间排序。
每次启动 Task 都会创建一条新的日志。通过任务名称、config 和启动时间,可以区分同一 Task 的多次运行。
查看实时日志
启动 Task 后,选择对应的 live 日志即可观察输出。Harbor 首次打开时直接读取文件末尾,并在界面中只保留最近 2048 行;后续只读取新增内容,不会反复加载或排版整份日志。
切换页面或 Workspace 不会影响任务进程。回到能发现该 Task 的 Workspace 后,可以继续查看它的实时状态;日志记录仍保存在启动任务时使用的 Workspace 中。
提示
程序需要及时输出日志。Python 程序可以使用 python -u,或主动刷新 stdout,避免输出长时间停留在缓冲区中。
查看历史日志
Task 停止后,live 日志会自动变成 history。选择历史记录即可通过 Monaco 查看上一次或更早的运行结果。
每个 Workspace 默认最多使用 1024 MB 保存 Task 日志,并最多保留最近 50 条。 达到任一限制时,Harbor 会从最旧的已停止日志开始清理;正在运行、仍在写入的日志不会被删除, 因此活动日志可能暂时超过容量上限。容量可以在 Settings 中调整,最小值为 64 MB。
历史日志非常大时,界面只读取文件末尾 1 MiB,通常足够保留错误发生前后的关键信息。
本地和远端 Workspace 的日志互相独立。远端任务日志保存在远端机器上,由 Harbor API 读取,不需要手动下载文件。
复制日志
日志很长时,不要把全部内容直接复制给同事或 AI:
- 如果已经选中文字,复制按钮只复制选中内容。
- 没有选区时,复制日志末尾指定行数。
- 默认复制最后 128 行,也可以选择 256、512 或 1024 行。
- 最大复制范围为最后 1024 行。
通常先复制最后 128 行;只有错误上下文不完整时再逐步增加。
Harbor Log 与 Task Log
Task Log 是程序自身的 stdout 和 stderr,用于判断命令是否成功、依赖是否缺失或程序为何退出。
Harbor Log 记录 GUI 与 harbor_core 的行为,用于排查连接、版本、远端部署、Workspace 切换和 API 错误。点击日志区域标题旁的文档图标即可切换到 Harbor Log。
遇到问题时可以按这个顺序判断:
- Task 能发现但启动失败:先看 Task Log。
- Task 没有出现:检查搜索路径,再看 Harbor Log 的扫描信息。
- 远端无法连接或版本不符:查看 Harbor Log。
- 程序已经运行但功能异常:查看对应 live Task Log。
让 AI 分析日志
Harbor Skill 可以通过 API 直接读取状态和日志,不需要先手动复制:
使用 $harbor,看看 camera 为什么启动失败。使用 $harbor,看看为什么连不上远端。如果需要把内容交给其他 AI 或聊天窗口,再使用复制功能控制日志长度。
常见问题
- 启动失败时先查看任务日志顶部的命令和工作目录。
- 日志没有及时出现时,检查程序是否缓冲 stdout。
- 远端失败时同时检查 Harbor Log 与 Task Log。
- 图形程序报
could not connect to display时,如果需要远端操作窗口就设置remote_display_virtual: true;如果程序实际无需界面则改用 headless 模式。参见远端运行。
日志保存位置
本地 Workspace 按 id 使用独立目录;远端 Task 日志统一保存在执行机器的远端运行目录:
~/.harbor/workspace/<workspace-id>/log
~/.harbor/remote/log因此,重命名本地的远端 Workspace 不会重命名或丢失远端 Task 日志。日志归属执行机器 和 Task 启动记录,而不是 GUI 中显示的 Workspace 名称。
一般不需要直接操作这些文件;通过 Harbor 界面或 API 查看,可以保持本地与远端使用方式一致。