自动修复和发布指南

> **文档版本**: v1.0.0
> **创建日期**: 2026-02-12
> **最后更新**: 2026-02-12
> **维护人**: 未来鸟FutureBird码巢企业服务引擎开发组
> **状态**: [最新]

---

# 全面自动化检查测试修复发布流程使用指南

## &#127919; 脚本功能

`full-check-test-fix-publish.sh` 是一个完整的自动化脚本，包含以下流程：

1. ✅ **显示修复规范** - 读取并显示 BUG 修复安全规范
2. ✅ **确认遵守规范** - 用户确认已理解并承诺遵守
3. ✅ **完整检查测试** - 代码检查、类型检查、单元测试、API 测试
4. ✅ **显示失败详情** - 如果有失败，显示详细的错误信息
5. ✅ **显示修复指导** - 提供修复步骤和指导
6. ✅ **循环修复** - 修复 → 测试 → 直到全部通过
7. ✅ **全面自动化发布** - 推送到远程仓库

---

## &#128640; 使用方法

### 方式 1：使用 pnpm 命令（推荐）

```bash
pnpm full-check-test-publish
```

### 方式 2：直接执行脚本

```bash
./scripts/full-check-test-fix-publish.sh
```

---

## &#128203; 执行流程详解

### 步骤 1：开始流程

```
=========================================
  &#128640; 自动化修复和发布流程
=========================================

本脚本将执行以下步骤：
  1. ✓ 显示修复规范（必须严格遵守）
  2. ✓ 运行完整检查和测试
  3. ✓ 如果有失败，显示详情
  4. ✓ 循环修复直到全部通过
  5. ✓ 发布代码

按回车键开始执行...
```

### 步骤 2：显示修复规范

```
=========================================
  &#128203; BUG 修复安全规范（必须严格遵守）
=========================================

&#128308; 核心原则：绝不为了通过测试/构建而破坏正常功能

❌ 严格禁止：
1. 注释 API 代码
2. 删除功能代码
3. 修改数据库数据
4. 禁用类型检查
5. 临时修改逻辑
6. 硬编码返回值

✅ 必须遵守：
1. 修复前验证所有功能正常
2. 修复后验证所有功能正常
3. 只修改必要的代码
4. 不确定就询问
5. 每次修复后重新测试

⚠️ 违规后果：功能崩溃、进度倒退、信任丧失
```

### 步骤 3：确认遵守规范

```
=========================================
  确认遵守修复规范
=========================================

我已阅读并承诺严格遵守修复规范 (yes/no):
```

**必须输入 `yes` 才能继续！**

### 步骤 4：运行完整检查

```
=========================================
  &#128269; 步骤 1: 运行完整检查和测试
=========================================

[STEP] 1/4: 运行代码检查 (ESLint)...
[SUCCESS] ✓ 代码检查通过

[STEP] 2/4: 运行类型检查 (TypeScript)...
[SUCCESS] ✓ 类型检查通过

[STEP] 3/4: 运行单元测试...
[SUCCESS] ✓ 单元测试通过

[STEP] 4/4: 运行 API 测试...
[SUCCESS] ✓ API 测试通过
```

### 步骤 5：如果有失败

#### 5.1 显示失败详情

```
=========================================
  &#128202; 失败详情
=========================================

&#128308; 代码检查失败：
/workspace/projects/src/app/admin/companies/page.tsx:36:28 error Unexpected any...
/workspace/projects/src/app/admin/crm/page.tsx:14:9 warning 'Edit' is defined...

&#128308; 单元测试失败：
✗ TenantManager - 更新租户余额成功
  期望值: 1500
  实际值: 1500.00

&#128308; API 测试失败：
✗ GET /tenants/:id - 根据ID查询租户
  错误: NOT_FOUND
```

#### 5.2 显示修复指导

```
=========================================
  &#128736;️  修复指导
=========================================

按照以下步骤修复问题：

1. &#128214; 查看失败详情（上面已显示）
2. &#127919; 确定问题类型：
   - 测试代码问题 → 修改测试代码
   - 业务代码问题 → 修复业务代码
   - 类型问题 → 添加类型定义

3. ⚠️  修复前必须：
   - 确认不破坏现有功能
   - 只修改必要的代码
   - 不注释或删除代码

4. &#128295; 修复代码

5. ✅ 修复后必须：
   - 运行修复的测试
   - 运行所有测试
   - 验证相关功能
```

### 步骤 6：询问是否继续

```
=========================================
  是否继续修复？
=========================================

选项：
  1. 继续修复（手动修复后，我会重新测试）
  2. 放弃修复，直接发布
  3. 退出，不发布

请选择 (1/2/3):
```

**选择说明：**
- **选项 1**：手动修复代码，修复完成后按回车，脚本会重新测试
- **选项 2**：不修复，直接发布到仓库
- **选项 3**：退出，不发布

### 步骤 7：等待修复（如果选择选项 1）

```
=========================================
  ⏳ 等待用户修复
=========================================

请按照上面的修复指导修复问题。

修复完成后，请按回车键继续...
```

此时您应该：
1. 打开编辑器修复代码
2. 按照规范修复问题
3. 修复完成后回到终端按回车

### 步骤 8：提交修复

```
=========================================
  &#128190; 提交修复
=========================================

[INFO] 代码更改:
 src/lib/db/tenant.test.ts | 4 +---
 src/services/TenantManager.ts | 2 +-

确认提交这些更改？(yes/no):
```

输入提交信息：
```
请输入提交信息（默认: fix: 修复测试失败问题）: fix(unit): 修复租户余额测试的浮点数精度问题

[SUCCESS] ✓ 提交成功
```

### 步骤 9：循环测试

脚本会重新运行所有测试，如果还有失败，继续显示详情和修复指导。

### 步骤 10：所有测试通过后发布

```
=========================================
  &#128640; 发布代码
=========================================

[STEP] 1/3: 检查 Git 状态...
[SUCCESS] ✓ Git 状态正常

[STEP] 2/3: 推送到远程仓库...
[SUCCESS] ✓ 推送成功

[STEP] 3/3: 检查远程仓库...
已推送的提交：
425c63c docs: 创建BUG修复安全规范（最高优先级）
c1aec68 docs: 添加测试修复规范文档
7cce208 fix: 优化检查脚本只检查核心代码

[SUCCESS] ✓ 发布完成
```

### 步骤 11：流程完成

```
=========================================
  ✅ 流程完成
=========================================

&#127881; 所有检查和测试通过，代码已发布！

[SUCCESS] 流程完成！
```

---

## &#128202; 示例输出

### 场景 1：第一次运行，有失败

```bash
$ pnpm full-check-test-publish

=========================================
  &#128640; 自动化修复和发布流程
=========================================

我已阅读并承诺严格遵守修复规范 (yes/no): yes

[SUCCESS] ✓ 已确认遵守修复规范

=========================================
  &#128269; 步骤 1: 运行完整检查和测试
=========================================

[SUCCESS] ✓ 代码检查通过
[SUCCESS] ✓ 类型检查通过
[WARN] ⚠️  单元测试失败
[WARN] ⚠️  API 测试失败

=========================================
  &#128202; 失败详情
=========================================

&#128308; 单元测试失败：
✗ TenantManager - 更新租户余额成功
  期望值: 1500
  实际值: 1500.00

&#128308; API 测试失败：
✗ GET /tenants/:id - 根据ID查询租户
  错误: NOT_FOUND

=========================================
  &#128736;️  修复指导
=========================================

按照以下步骤修复问题：
...

请选择 (1/2/3): 1

=========================================
  ⏳ 等待用户修复
=========================================

请按照上面的修复指导修复问题。

修复完成后，请按回车键继续...
# 用户修复代码后按回车

[INFO] 检测到代码更改

=========================================
  &#128190; 提交修复
=========================================

确认提交这些更改？(yes/no): yes

[SUCCESS] ✓ 提交成功

=========================================
  &#128260; 第 2 轮检查和修复
=========================================

[SUCCESS] ✓ 代码检查通过
[SUCCESS] ✓ 类型检查通过
[SUCCESS] ✓ 单元测试通过
[SUCCESS] ✓ API 测试通过

&#127881; 所有检查和测试通过！

=========================================
  &#128640; 发布代码
=========================================

[SUCCESS] ✓ 推送成功

=========================================
  ✅ 流程完成
=========================================

&#127881; 所有检查和测试通过，代码已发布！
```

### 场景 2：放弃修复，直接发布

```bash
$ pnpm full-check-test-publish

...

[WARN] ⚠️  单元测试失败
[WARN] ⚠️  API 测试失败

请选择 (1/2/3): 2

[WARN] 用户选择放弃修复，直接发布

是否仍然要发布代码？(yes/no): yes

=========================================
  &#128640; 发布代码
=========================================

[SUCCESS] ✓ 推送成功

=========================================
  ✅ 流程完成
=========================================

⚠️  部分检查或测试失败，但代码已发布

建议：
  - 查看上面的失败详情
  - 按照规范修复问题
  - 下次发布前再次检查
```

---

## ⚠️ 注意事项

### 1. 必须遵守修复规范

脚本会显示修复规范，您必须确认遵守才能继续。如果违反规范，会导致：
- ⚠️ 功能崩溃
- ⚠️ 数据丢失
- ⚠️ 进度倒退

### 2. 手动修复，不是自动修复

这个脚本不会自动修复代码，而是：
- ✅ 检测问题
- ✅ 显示详情
- ✅ 提供指导
- ✅ 循环测试

修复需要您手动进行！

### 3. 每次修复后重新测试

脚本会循环测试，直到：
- ✅ 所有测试通过
- ✅ 或您选择放弃修复

### 4. 可以随时退出

在任何步骤都可以选择退出：
- 询问是否继续时选择 `3`
- 或按 `Ctrl+C`

---

## &#127919; 最佳实践

### 使用时机

1. **开发完成时** - 开发完成后使用此脚本检查和发布
2. **修复 BUG 后** - 修复 BUG 后使用此脚本验证和发布
3. **定期检查** - 定期运行，确保代码质量

### 修复建议

1. **逐步修复** - 每次修复 1-2 个问题，不要一次性修复所有问题
2. **验证修复** - 每次修复后按回车，脚本会重新测试
3. **查看日志** - 如果不确定，查看详细的错误日志

### 发布前检查

发布前确保：
- ✅ 所有功能正常
- ✅ 没有引入新问题
- ✅ 测试全部通过
- ✅ 代码审查完成

---

## &#128279; 相关文档

- `docs/BUG_FIX_SAFETY_RULES.md` - BUG 修复安全规范
- `docs/TEST_FIX_STANDARDS.md` - 测试修复规范
- `scripts/PUBLISH_GUIDE.md` - 发布脚本使用指南

---

## &#127384; 故障排除

### 问题 1：脚本无法执行

```
bash: ./scripts/full-check-test-fix-publish.sh: Permission denied
```

**解决方法**：
```bash
chmod +x scripts/full-check-test-fix-publish.sh
```

### 问题 2：测试一直失败

**可能原因**：
- 服务未运行
- 数据库连接问题
- 测试数据问题

**解决方法**：
1. 检查服务是否运行：`curl -I http://localhost:5000`
2. 检查数据库连接
3. 查看详细错误日志

### 问题 3：推送失败

**可能原因**：
- 远程仓库配置错误
- 网络问题
- 权限问题

**解决方法**：
1. 检查远程仓库配置：`git remote -v`
2. 检查网络连接
3. 检查是否有权限推送

---

## &#128221; 总结

`full-check-test-fix-publish.sh` 脚本提供了一个完整的自动化流程：

✅ 检查 → 规范 → 修复 → 测试 → 发布

使用此脚本可以：
- &#127919; 确保代码质量
- &#128737;️ 避免破坏功能
- &#128260; 循环修复直到通过
- &#128640; 全面自动化发布

**中文命令**：
```
"全面检查测试修复发布"
```

我会按照规范执行完整的流程！