# 项目脚本

本目录包含项目维护和自动化脚本。

## 脚本说明

### update-claude-docs.sh
**用途**: 自动更新各模块的 CLAUDE.md 文档时间戳

**功能**:
- 检测项目文件变更
- 自动更新相关模块的 CLAUDE.md 最后更新时间
- 验证所有 CLAUDE.md 文件完整性

**使用方法**:
```bash
# 手动运行
./scripts/update-claude-docs.sh

# 自动运行 (通过 pre-commit hooks)
git commit -m "update: 修改前端组件"  # 自动触发
```

**触发条件**:
- `frontend/` 目录变更 → 更新 `frontend/CLAUDE.md`
- `docs/deployment/` 目录变更 → 更新 `docs/deployment/CLAUDE.md`
- `.gitea/workflows/` 目录变更 → 更新 `.gitea/workflows/CLAUDE.md`
- `CLAUDE.md` 变更 → 更新根目录时间戳

## 自动化集成

### Pre-commit Hooks
脚本已集成到 pre-commit hooks 中，会在以下情况自动运行：
- 提交涉及模块文件变更时
- 自动更新时间戳并包含在本次提交中

### 配置文件
- **lint-staged.config.js** - 配置自动触发规则
- **package.json** - 项目脚本配置

## 最佳实践

### 开发流程
1. 正常开发和修改文件
2. 使用 `git add` 添加变更
3. 使用 `git commit` 提交（自动触发脚本）
4. 脚本自动更新相关 CLAUDE.md 文档
5. 时间戳更新会包含在提交中

### 手动维护
如果需要手动更新文档：
```bash
# 运行脚本
./scripts/update-claude-docs.sh

# 提交更新
git add .
git commit -m "docs: 更新 CLAUDE.md 文档"
```

## 扩展计划

### 未来功能
- 自动生成模块依赖图
- 检查 CLAUDE.md 文档格式
- 自动同步配置变更
- 生成变更日志