Appearance
三种使用路径
⚠️ 这是旧版路径说明，保留作参考。推荐使用
00-先读我-阅读路线.md中的最新路线。
这份文件是补充说明，不是第一次使用的必读文件。
如果你已经看过 00-先读我-阅读路线.md，并且已经知道自己是“新项目、已有项目改功能、修 Bug、使用 Skill/Agent”中的哪一种，可以先跳过本文件。
如果你仍然分不清自己该走哪条路，再看这份文件。
这套资料不是让你从头到尾按文件顺序硬读。
你应该先判断自己属于哪类情况，再按对应路径使用。这样可以节省时间，也能避免一上来就让 AI 写大段代码导致失控。
按能力基础选择使用方式
会一点 C#，但不会系统拆项目
重点看：
11-上位机项目需求拆解表.md20-WPF上位机AI开发流程.md50-常用Prompt库.md
你的重点是先用 10-问题定义与用户场景.md 把用户、现场、痛点和第一阶段成功标准说清楚，再把零散需求整理成完整方案，让 AI 根据业务目标反推页面、ViewModel、Service、通信和数据模块。
会设备调试，但软件结构比较弱
重点看：
11-上位机项目需求拆解表.md21-串口TCP通信任务模板.md30-回归测试与验收清单.md
你的重点是把设备、协议、报文、操作流程和验收要求说清楚，让 AI 不要只生成界面代码，而是围绕真实设备流程工作。
会写代码，但不会稳定使用 AI
重点看：
40-Bug调查与最小修复流程.md50-常用Prompt库.md60-host-computer-dev-Skill说明.md
你的重点是学会给 AI 限定范围：先判断问题等级，小问题直接最小修改，疑难问题再调查，最后按影响范围回归验证。
完全零基础
不建议直接拿这套资料做完整项目。
建议先补 C#、Visual Studio、WPF/WinForm、串口/TCP 基础。本资料可以作为需求整理和学习路线参考，但不能替代基础编程学习。
路径一：我要从 0 做一个新上位机项目
适合情况：
- 只有项目想法，还没有代码。
- 只有设备协议或客户需求。
- 想用 WPF/WinForm 做测试软件、采集软件、调试工具。
- 不确定项目应该先做界面、通信还是数据库。
推荐阅读顺序：
| 顺序 | 文件 | 你要做什么 |
|---|---|---|
| 1 | 00-先读我-阅读路线.md | 先理解这套资料怎么用 |
| 2 | 01-适用人群与边界.md | 判断你的项目是否适合 |
| 3 | 10-问题定义与用户场景.md | 先定义用户、现场、痛点、成功标准和非目标 |
| 4 | 11-上位机项目需求拆解表.md | 再填写第一层骨架，让 AI 整理第一版需求方案 |
| 5 | 12-AI开发质量门.md | 判断是否可以进入技术方案 |
| 6 | 50-常用Prompt库.md | 用“多轮迭代确认需求”继续确认第二版方案 |
| 7 | 20-WPF上位机AI开发流程.md | 根据已确认的需求方案选择结构、页面和模块 |
| 8 | 22-架构决策ADR模板.md | 记录重要技术选择 |
| 9 | 21-串口TCP通信任务模板.md | 根据需求方案设计通信和协议解析 |
| 10 | 30-回归测试与验收清单.md | 根据需求方案做第一版验收 |
| 11 | 31-度量复盘与经验沉淀.md | 阶段结束后记录返工和经验 |
你要复制的核心 Prompt：
text
我准备从 0 做一个 C# WPF 上位机项目。请先不要写代码。
请根据下面零散需求和需求拆解表，先帮我整理成第一版需求方案。
请输出：
1. 项目目标和使用场景。
2. 现场操作流程。
3. 核心业务流程草案。
4. 页面规划草案。
5. 通信需求草案。
6. 数据保存草案。
7. 日志、报警、权限是否需要进一步确认。
8. 第一阶段最小可运行版本范围。
9. 下一轮最需要确认的 5-10 个问题。
需求拆解表：
【粘贴 02 文件中填写好的内容】最终你应该得到：
- 项目模块清单。
- 第一版需求方案。
- 页面规划草案。
- 通信和数据保存草案。
- 需要继续确认的问题。
- 第一阶段开发顺序。
- 验收清单。
如果你手上已经有需求说明书或技术要求，不要直接跳过需求整理。先使用 50-常用Prompt库.md 里的“拆解需求说明书或技术要求”，让 AI 把文档拆成明确要求、AI 推测、风险点和下一轮确认问题。
路径二：我已经有项目，想增加或修改功能
适合情况：
- 项目已经能运行。
- 想加一个页面、按钮、参数配置、日志窗口、历史查询。
- 想增加串口/TCP 功能或修改协议。
- 担心 AI 改坏已有项目。
推荐阅读顺序：
| 顺序 | 文件 | 你要做什么 |
|---|---|---|
| 1 | 11-上位机项目需求拆解表.md | 填写“已有项目改造时填写”部分 |
| 2 | 20-WPF上位机AI开发流程.md | 先描述修改目标，让 AI 判断可能影响的页面和模块 |
| 3 | 21-串口TCP通信任务模板.md | 如果涉及通信，先拆通信需求 |
| 4 | 12-AI开发质量门.md | 修改前检查影响范围是否清楚 |
| 5 | 50-常用Prompt库.md | 找对应 Prompt：新功能、页面、通信、数据 |
| 6 | 30-回归测试与验收清单.md | 修改后做回归 |
| 7 | 31-度量复盘与经验沉淀.md | 有返工时记录原因 |
你要复制的核心 Prompt：
text
我有一个已有 C# WPF/WinForm 上位机项目，现在只想增加/修改一个功能。
请先不要写代码，也不要重构无关部分。
本次修改目标：
【用自然语言写清楚想改成什么效果】
当前现象：
【现在软件是什么样】
期望效果：
【希望改完后是什么样】
不希望改动：
【写清楚不要动哪些模块】
请输出：
1. 可能影响哪些页面、状态、命令、通信、数据或服务。
2. 需要我补充哪些截图、项目结构、代码文件或日志。
3. 最小修改方案。
4. 修改后的回归测试点。最终你应该得到：
- 明确的修改范围。
- 需要补充或修改的材料清单。
- 风险点。
- 最小实现步骤。
- 回归测试清单。
路径三：我的项目有 Bug，想让 AI 帮我查
适合情况：
- 编译报错。
- 运行异常。
- UI 不刷新。
- 串口/TCP 收不到数据。
- CRC 错误、粘包半包、偶发丢包。
- 数据保存失败。
- UI 卡死或运行久了变慢。
推荐阅读顺序：
| 顺序 | 文件 | 你要做什么 |
|---|---|---|
| 1 | 40-Bug调查与最小修复流程.md | 先填写 Bug 信息收集表 |
| 2 | 50-常用Prompt库.md | 使用“只定位根因”或“给最小修复方案” |
| 3 | 21-串口TCP通信任务模板.md | 如果是通信 Bug，补充协议和日志 |
| 4 | 12-AI开发质量门.md | 判断是否可以进入修复或交付 |
| 5 | 30-回归测试与验收清单.md | 修复后做验证 |
| 6 | 31-度量复盘与经验沉淀.md | 记录缺陷来源和测试遗漏 |
你要复制的核心 Prompt：
text
请你作为 C# WPF/WinForm 上位机 Bug 调查助手。
请先只调查根因，不要直接修改代码。
问题现象：
复现步骤：
出现频率：
最近改动：
相关日志：
相关代码或截图：
期望行为：
实际行为：
请输出：
1. 可能原因列表。
2. 最可能原因和证据。
3. 还需要补充哪些信息。
4. 最小复现方法。
5. 是否可以进入最小修复阶段。最终你应该得到：
- 根因分析。
- 证据链。
- 最小修复方案。
- 验证清单。
- 残余风险。
补充：如果你需要先做界面效果图
如果你的项目需要先确认界面效果图、原型图或演示图，不要强行先把所有 UI 细节填满。先把页面目标、使用人员、主要操作流程、需要显示的信息和期望风格整理给 AI。
如果需要先做界面效果图，建议把屏幕尺寸、使用人员、现场操作流程、关键数据、关键操作和状态提示整理清楚。具体按钮、表格、曲线和状态区怎么排布，可以让 AI 先出方案。