|
1 | 1 | # TestPilot AI 开发备忘录 |
2 | 2 |
|
3 | | -> 最后更新:2026-03-26(✅ v14.3 引擎稳定性修复 + 蓝本规则重构 v13→v15) |
| 3 | +> 最后更新:2026-03-27(📋 v14.4 模板全面重构规划) |
4 | 4 | > 项目结构详见 README.md,此处不重复。 |
5 | 5 |
|
6 | 6 | --- |
7 | 7 |
|
| 8 | +## 📋 v14.4 模板全面重构(2026-03-27 待执行) |
| 9 | + |
| 10 | +### 核心问题 |
| 11 | + |
| 12 | +1. **文件编码损坏**:所有5个平台模板文件(web/android/ios/miniprogram/desktop)均有大量 U+FFFD 乱码字符(最早从 commit `0561cf9` v8 开始引入),中文在某些编辑/提交过程中被截断 |
| 13 | +2. **模板含项目特定内容**:web.md 中出现 `财务报表`、`快速记账`、`凭证号`、`记账凭证`、`生活账本`、`account_book` 等只属于 account_book 项目的具体内容 —— 作为通用模板这是不允许的 |
| 14 | +3. **中文提示词风险**:中文在 git/编辑器/终端各环节均可能产生编码问题,且 AI 模型对英文指令理解更精准 |
| 15 | + |
| 16 | +### 文件现状 |
| 17 | + |
| 18 | +| 文件 | 版本 | 行数 | 乱码字符数 | 项目特定内容 | |
| 19 | +|------|------|------|-----------|------------| |
| 20 | +| web.md | v12 | 508 | 393 | 财务报表、记账、account_book、快速记账、凭证、生活账本 | |
| 21 | +| android.md | v9 | 336 | 273 | 记账 | |
| 22 | +| ios.md | v9 | 283 | 222 | 记账 | |
| 23 | +| miniprogram.md | v9 | 284 | 251 | 记账 | |
| 24 | +| desktop.md | v9 | 260 | 195 | (待查) | |
| 25 | + |
| 26 | +### 执行计划 |
| 27 | + |
| 28 | +#### 任务1:全部模板改为英文 |
| 29 | +- 将 web.md / android.md / ios.md / miniprogram.md / desktop.md 全部重写为英文 |
| 30 | +- **理由**: |
| 31 | + - 彻底消除编码损坏风险(纯 ASCII + 基本 UTF-8 emoji 不会被截断) |
| 32 | + - AI 模型(GPT/Claude/Gemini 等)对英文指令的理解更精准、更稳定 |
| 33 | + - 国际化友好,非中文用户也能使用 |
| 34 | +- **注意**:示例中的选择器值(如 `button[title='Save']`)用英文通用示例,不要出现任何特定项目的内容 |
| 35 | + |
| 36 | +#### 任务2:清除项目特定内容 |
| 37 | +- 所有示例改为通用化: |
| 38 | + - `财务报表` → `Financial Report` 或 `Dashboard` |
| 39 | + - `快速记账` → `Quick Add` 或 `Add Item` |
| 40 | + - `记账凭证` → `Create Record` |
| 41 | + - `凭证号` → `Record ID` |
| 42 | + - `生活账本` → `Personal Book` |
| 43 | + - `account_book` → `my-app` 或 `your-project` |
| 44 | +- 示例场景用通用业务:登录/注册、CRUD列表、表单提交、导航切换 |
| 45 | + |
| 46 | +#### 任务3:基于 git 干净版本重建 |
| 47 | +- web.md 已有干净 v7 备份在 `d:\temp_web_clean.md`(commit `ffffb4d`,409行,0乱码) |
| 48 | +- 其他4个文件也需从 git 历史找到最后一个无乱码的版本作为基础 |
| 49 | +- 在干净基础上叠加 v8-v12 的增量规则(选择器验证、Tailwind陷阱、Lucide图标规则等) |
| 50 | + |
| 51 | +#### 任务4:同步检查 AGENTS.md 模板(内嵌在 rulesInjector.ts) |
| 52 | +- AGENTS.md 内容内嵌在 `extension/src/rulesInjector.ts` 的字符串中 |
| 53 | +- 检查是否也有项目特定内容需清理 |
| 54 | +- 考虑是否也改为英文(需评估:AGENTS.md 是给编程AI看的通用指令,英文更合适) |
| 55 | + |
| 56 | +#### 任务5:重建 + 测试 + 发布 |
| 57 | +- 用 `create_file` 或 Python 脚本一次性写入每个正确的模板文件 |
| 58 | +- 运行 `npx @vscode/vsce package` 构建新 VSIX |
| 59 | +- Git commit + push |
| 60 | +- 在 account_book 项目上测试:删除 `.testpilot/platforms/` 目录,让插件重新注入,验证英文模板正常工作 |
| 61 | + |
| 62 | +### 关键原则 |
| 63 | +- **模板 = 通用规则 + 通用示例**,绝不允许出现任何特定项目的类名、字段名、业务术语 |
| 64 | +- **英文优先**:模板文件、AGENTS.md、copilot-instructions.md 模板均改为英文 |
| 65 | +- **版本号统一递增**:重构后所有模板版本号对齐 |
| 66 | + |
| 67 | +--- |
| 68 | + |
8 | 69 | ## ✅ v14.3 引擎稳定性 + 规则架构重构(2026-03-26 晚) |
9 | 70 |
|
10 | 71 | > ⚠️ 仍在测试中,部分修改可能需要进一步验证 |
|
0 commit comments