# 开发服务日志目录

本目录用于存储开发服务的运行日志，便于 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/` 目录。