用途:在项目中使用 openlogs 或 ol CLI 捕获并查看近期服务器日志,帮助回答“服务器发生了什么”、排查报错或查看最新运行输出。优先使用清理过的文本日志,除非确需 ANSI 颜色、光标控制或精确终端字节。
主要能力:openlogs tail 获取最近日志;openlogs tail <query> 获取命令或显式名称含该查询的最近运行;--raw 输出原始终端内容;-f 进入实时跟随;--out-dir 指定输出目录;可直接读取 .openlogs/latest.txt 或 .openlogs/ 下对应命令文件。
使用方式:先运行 openlogs tail -n 200;若用户指明命令或服务,运行 openlogs tail <query> -n 200;失败可改用 ol tail -n 200。CLI 不可用但工作区可访问时读 .openlogs/latest.txt 或对应文件。日志目录缺失时,确认服务器是否以 openlogs <command> 或 ol <command> 启动;未使用则需重新以 openlogs 启动后再检查。常用命令如 openlogs tail -n 100、openlogs tail dev -n 100、openlogs tail server -f、openlogs tail -f、openlogs tail --raw -n 100、openlogs tail --out-dir logs -n 200、openlogs bun dev、ol npm run dev。
适用场景:本地开发环境的服务器日志检查、错误定位、实时跟随输出。
限制:需项目已用 openlogs/ol 启动或存在 .openlogs 日志;若无法访问被 gitignore 的文件,需用户自行运行并粘贴输出;原始日志仅在清理日志掩盖关键信息时使用。回答时应说明所用命令或文件、用 1 至 3 句概述问题、引用关键错误行,并在日志缺失时明确告知应重新运行的命令。