# MSH 前端自动化修复计划

## 概述

基于 Cursor Agent 代码审查报告（`ai-nutritionist-REVIEW.md`），建立自动化修复流程，逐一解决 AI 营养师页面的问题。

**修复原则：**
- 使用新增文件方式，保留原代码备份
- 遵循"测试发现 → 修改代码 → 测试验收"流程
- 每个修复任务独立追踪，可回滚
- **涉及 Coding 工作统一使用 Cursor CLI**

---

## 自动化 Cron 任务

### 任务 1：进度检查（每 5 分钟）
- **ID**: `msh-fix-check-5min`
- **触发**: 每 5 分钟
- **动作**: 检查修复任务进度，报告统计信息
- **输出**: 待处理/进行中/已完成 任务数量

### 任务 2：自动启动（每 30 分钟）
- **ID**: `msh-fix-auto-start-30min`
- **触发**: 每 30 分钟
- **动作**: 如无可进行中的任务，自动推荐并启动下一个任务
- **条件**: `in-progress/` 为空且 `backlog/` 不为空

---

## 任务执行规则（强制）

### 规则 1：Coding 工作使用 Cursor CLI

所有代码编写、重构、审查必须使用 Cursor CLI：

```bash
# 登录（一次性）
agent login

# 执行任务
agent --model auto --trust -p "任务描述"
```

### 规则 2：自动化检查

- 每 5 分钟自动检查进度
- 每 30 分钟自动推荐/启动任务
- 优先处理高优先级任务（FIX-001 ~ FIX-003）

---

## 修复任务队列

| 优先级 | 任务ID | 描述 | 状态 |
|--------|--------|------|------|
| 🔴 高 | FIX-001 | 移除初始假数据 | 待开始 |
| 🔴 高 | FIX-002 | 添加清空对话按钮 | 待开始 |
| 🔴 高 | FIX-003 | 拆分单文件组件 | 待开始 |
| 🟡 中 | FIX-004 | 多图合并为一轮对话 | 待开始 |
| 🟡 中 | FIX-005 | 消息列表使用稳定 key | 待开始 |
| 🟢 低 | FIX-006~009 | 其他优化项 | 待开始 |

---

## 使用方法

### 手动启动修复任务

```bash
cd /Users/apple/scott2026/msh-system/msh_single_uniapp

# 查看进度
./.fixes/scripts/check-progress.sh

# 启动任务
./.fixes/scripts/start-fix.sh FIX-001

# 完成任务
./.fixes/scripts/complete-fix.sh FIX-001
```

### 手动触发 Cursor 分析

```bash
# 使用 Cursor CLI 分析代码
agent --model auto --trust -p "分析 ai-nutritionist.vue 的问题"
```

---

## 文件结构

```
.fixes/
├── README.md              # 本文件
├── PROGRESS.md            # 进度追踪
├── backlog/               # 待处理任务 (9个)
├── in-progress/           # 进行中任务
├── completed/             # 已完成任务
└── scripts/               # 自动化脚本
    ├── start-fix.sh
    ├── complete-fix.sh
    └── check-progress.sh
```

---

**最后更新**: 2026-02-28
**自动化状态**: ✅ Cron 已配置