|
|
@@ -0,0 +1,98 @@
|
|
|
+# 开发服务日志目录
|
|
|
+
|
|
|
+本目录用于存储开发服务的运行日志,便于 AI 代理和开发者诊断问题。
|
|
|
+
|
|
|
+## 目录结构
|
|
|
+
|
|
|
+```
|
|
|
+logs/
|
|
|
+└── dev-logs/ # 开发服务日志目录
|
|
|
+ ├── dev-current.log # 当前会话日志(追加模式)
|
|
|
+ ├── dev-20260114-093000.log # 历史日志(时间戳命名)
|
|
|
+ └── dev-20260113-143022.log # 历史日志
|
|
|
+```
|
|
|
+
|
|
|
+## 日志文件说明
|
|
|
+
|
|
|
+### dev-current.log
|
|
|
+- 当前开发服务会话的日志
|
|
|
+- 每次启动 `pnpm run dev` 时追加写入
|
|
|
+- 包含会话开始时间标记(`===== SESSION START: YYYY-MM-DD HH:MM:SS =====`)
|
|
|
+- 最新的日志内容,适合快速查看
|
|
|
+
|
|
|
+### dev-YYYYMMDD-HHMMSS.log
|
|
|
+- 历史日志归档文件
|
|
|
+- 每次启动开发服务时创建新的归档文件
|
|
|
+- 文件名包含启动时间戳
|
|
|
+- 保留 7 天后自动删除
|
|
|
+
|
|
|
+## AI 代理查询指南
|
|
|
+
|
|
|
+### 查看当前日志
|
|
|
+```bash
|
|
|
+# 查看最新的当前日志
|
|
|
+cat logs/dev-logs/dev-current.log
|
|
|
+
|
|
|
+# 使用 tail 查看最后 100 行
|
|
|
+tail -n 100 logs/dev-logs/dev-current.log
|
|
|
+
|
|
|
+# 实时监控日志
|
|
|
+tail -f logs/dev-logs/dev-current.log
|
|
|
+```
|
|
|
+
|
|
|
+### 搜索错误和警告
|
|
|
+```bash
|
|
|
+# 搜索所有错误
|
|
|
+grep -i "error" logs/dev-logs/dev-current.log
|
|
|
+
|
|
|
+# 搜索警告
|
|
|
+grep -i "warning" logs/dev-logs/dev-current.log
|
|
|
+
|
|
|
+# 搜索特定服务的日志
|
|
|
+grep "mini:" logs/dev-logs/dev-current.log
|
|
|
+grep "web:" logs/dev-logs/dev-current.log
|
|
|
+```
|
|
|
+
|
|
|
+### 查看特定会话
|
|
|
+```bash
|
|
|
+# 列出所有日志文件
|
|
|
+ls -lh logs/dev-logs/
|
|
|
+
|
|
|
+# 查看特定时间段的日志
|
|
|
+cat logs/dev-logs/dev-20260114-*.log
|
|
|
+```
|
|
|
+
|
|
|
+### 日志分析示例
|
|
|
+```bash
|
|
|
+# 统计错误数量
|
|
|
+grep -ci "error" logs/dev-logs/dev-current.log
|
|
|
+
|
|
|
+# 查找最近的错误(最后 10 个)
|
|
|
+grep -i "error" logs/dev-logs/dev-current.log | tail -n 10
|
|
|
+
|
|
|
+# 查找包含特定关键词的日志
|
|
|
+grep -B 5 -A 5 "Module not found" logs/dev-logs/dev-current.log
|
|
|
+```
|
|
|
+
|
|
|
+## 日志内容
|
|
|
+
|
|
|
+日志包含以下服务的输出:
|
|
|
+- `dev:mini` - 小程序 H5 开发服务
|
|
|
+- `dev:mini-talent` - 人才小程序 H5 开发服务
|
|
|
+- `dev:weapp` - 微信小程序开发服务
|
|
|
+- `dev:weapp-talent` - 人才微信小程序开发服务
|
|
|
+- `dev:web` - Web 开发服务
|
|
|
+
|
|
|
+## 清理策略
|
|
|
+
|
|
|
+- 自动清理:超过 7 天的归档日志会被自动删除
|
|
|
+- 手动清理:可以手动删除 `logs/dev-logs/` 目录下的文件
|
|
|
+
|
|
|
+## 启动开发服务
|
|
|
+
|
|
|
+```bash
|
|
|
+# 启动带日志记录的开发服务
|
|
|
+pnpm run dev
|
|
|
+```
|
|
|
+
|
|
|
+日志会自动保存到 `logs/dev-logs/` 目录。
|