logs/ - 日志文件目录

用途

存放项目运行过程中生成的日志文件。

存放文件类型

• ✅ 应用运行日志（app.log, debug.log）
• ✅ 构建日志（build.log）
• ✅ 工具脚本执行日志（tool_name.log）
• ✅ 测试日志（test_results.log）
• ✅ 错误日志（error.log）

命名规范

推荐格式：

<功能模块>_<日期>.log
例如：
- vocab_build_2026-01-28.log
- ocr_debug_2026-01-28.log
- test_results_2026-01-28.log

Git 管理

• ✅ 此目录本身会被追踪（通过 .gitkeep）
• ❌ 目录内的所有 *.log 文件会被 .gitignore 忽略
• 日志文件仅保留在本地，不提交到版本控制

清理策略

建议定期清理：

• 保留最近 7 天的日志
• 超过 7 天的日志可以删除或归档

清理命令：

# 删除 7 天前的日志
find logs/ -name "*.log" -mtime +7 -delete

Claude 自动遵循

当 Claude 需要生成或保存日志文件时，会自动将文件保存到 logs/ 目录，而不是根目录或其他位置。

---

最后更新：2026-01-28