Appearance
C# 上位机 AI 开发现状
这份文件说明当前 C# / WPF / WinForms 上位机开发和 AI 编程工具的使用环境。
它不是工具安装教程,而是帮助你判断:为什么现在更推荐使用 Codex、Cursor、Claude Code、Codex++ 或国内 AI IDE 这类“能读项目、能改文件、能跑命令”的工具,而不是只把代码复制到 Web 对话框里让 AI 改。
1. C# 上位机开发仍然有现实需求
上位机软件常见于:
- 设备调试。
- 数据采集。
- 串口/TCP 通信。
- 工装测试。
- 产线监控。
- 参数配置。
- 日志、报表、数据追溯。
这类软件的典型环境仍然是 Windows。C#、.NET、WPF、WinForms 在这类场景里仍然常见,原因很直接:
- Windows 工控机和测试电脑普遍。
- C# 调串口、TCP、文件、数据库、图表库都方便。
- WPF 的 XAML 是文本,AI 比较容易读取和修改。
- MVVM、Service、Model、通信模块这种结构适合让 AI 分模块处理。
- Visual Studio 调试、断点、界面运行仍然成熟。
所以,这套资料重点放在 C# WPF/WinForms 上位机,而不是 Web、移动 App 或嵌入式固件。
2. AI 辅助编程的用法变化
阶段 1:Web 对话框复制粘贴
早期常见方式:
text
复制一段 C# 代码
-> 粘贴到 Web 端大模型
-> 让它改
-> 再复制回 Visual Studio优点:
- 不需要安装复杂工具。
- 适合问概念、改小段代码、解释报错。
缺点:
- AI 看不到完整项目结构。
- 多文件修改很容易漏。
- 它不知道 XAML、ViewModel、Service 之间的真实关系。
- 改完还要人工复制回去。
- 代码容易和当前项目上下文不一致。
这种方式现在仍然能用,但更适合需求整理、方案讨论、Prompt 准备,不适合完整项目开发。
阶段 2:VS Code / Visual Studio 插件辅助
后来常见方式是:
- 在 VS Code 里接第三方大模型。
- 用 GitHub Copilot / IntelliCode / Visual Studio AI 辅助补全。
- 在 IDE 里让 AI 改一小段函数或解释错误。
优点:
- 比 Web 复制粘贴方便。
- 能看到当前文件或部分上下文。
- 写函数、补注释、解释错误效率更高。
局限:
- 很多工具仍然偏“代码补全”或“局部修改”。
- 对跨文件架构、通信流程、回归测试、交付文档支持有限。
- 上位机项目经常涉及 UI、通信、协议、保存、日志、配置,单文件辅助不够。
Visual Studio 自带 AI 能力和 GitHub Copilot 仍然有价值,尤其适合写代码、解释错误和调试。但如果要从需求一路做到交付,只靠局部补全不够。
阶段 3:AI IDE 和 Coding Agent
现在更推荐的方式是:
text
AI 读取整个项目
-> 理解需求和现有结构
-> 给出影响范围
-> 修改多个文件
-> 运行构建或测试
-> 根据错误继续修
-> 输出回归清单和交付说明典型工具包括:
- Codex。
- Cursor。
- Claude Code。
- Codex++。
- Trae、CodeBuddy、WorkBuddy、CodeGeeX 等国内工具。
这类工具更适合上位机项目,因为它们可以处理多文件关系:
| 上位机模块 | AI Agent 能做什么 |
|---|---|
| WPF/XAML | 看布局、改绑定、调整样式 |
| ViewModel | 分析状态字段、Command、数据绑定 |
| 通信服务 | 检查串口、TCP、连接状态和异常 |
| 协议解析 | 分析帧头、长度、CRC、粘包半包 |
| 数据保存 | 检查 CSV/BIN/数据库写入 |
| 日志 | 检查运行日志、错误日志、通信日志 |
| 测试验收 | 根据修改范围生成回归清单 |
3. 为什么 Codex 适合这套资料
Codex 这类工具的优势不是“会写一段代码”,而是能按项目流程工作。
适合点:
- 可以读取本地文件。
- 可以分析项目结构。
- 可以按 Skill/Agent 路由任务。
- 可以修改多个文件。
- 可以运行命令检查结果。
- 可以把“需求 -> 修改 -> 验证 -> 交付”串起来。
这和上位机项目的真实流程更接近:
text
需求不清 -> 先拆需求
界面不合理 -> 先设计布局
通信不稳定 -> 先分析协议和日志
Bug 不明确 -> 先查根因
修改完成 -> 做回归验收
准备交付 -> 整理配置、环境、已知风险所以本资料默认以 skills/host-computer-dev 组织,而不是只提供一堆零散 Prompt。
4. Visual Studio 现在更适合做什么
在这种 AI Agent 流程下,Visual Studio 仍然重要,但角色变化了。
更推荐这样分工:
| 工具 | 主要用途 |
|---|---|
| Codex / Cursor / AI IDE | 读项目、改代码、拆任务、修 Bug、生成验收清单 |
| Visual Studio | 编译、调试、断点、运行界面、查看异常 |
| Git / GitHub / Gitee | 保存版本、查看差异、回滚 |
| 普通聊天 AI | 整理需求、讨论界面、解释协议、写 Prompt |
也就是说,不一定要在 Visual Studio 里完成所有代码修改。实际可以是:
text
Codex 改代码
-> Visual Studio 编译运行
-> 发现问题
-> 把错误或现象交给 Codex
-> Codex 继续修
-> 最后用 Visual Studio 做运行验证这种方式比纯手工复制代码来回改更适合复杂上位机项目。
5. 国内工具的现实位置
国内 AI IDE 和模型工具的价值在于:
- 国内访问方便。
- 支付方便。
- 成本可能更低。
- 对中文需求理解通常不错。
- 对普通用户更容易上手。
不足是:
- 自动流程和长期上下文稳定性可能不如 Codex。
- 跨文件大改时更需要人工检查。
- 有些工具不支持 Codex Skill,需要转换成项目规则。
- 运行命令、回归、文件备份能力要看具体工具。
所以国内工具不是不能用,而是要换一种用法:
text
先让它读资料包
-> 再让它读 Skill
-> 转换成当前工具的项目规则
-> 每次先让它给影响范围
-> 再做最小修改
-> 改完按 30 做回归6. 第三方 API / Codex++ 的位置
如果不想订阅官方套餐,可以考虑第三方 API / Codex++ 路线。
它的价值是:
- 可以接 DeepSeek、MiniMax、智谱等国内或第三方模型。
- 可以把模型 API 接入 Codex 类工作流。
- 成本和模型选择更灵活。
它的风险是:
- 需要自己配置 Base URL、API Key、模型名。
- 模型兼容性不一定稳定。
- 工具调用、长上下文、多文件修改能力取决于模型和中转层。
- 开启 Full Access 前必须备份项目。
所以这条路线适合愿意折腾配置的人,不适合完全不想管环境的新手。
7. 为什么上位机项目特别需要质量门
Web 项目改坏了,很多时候刷新页面就能看到。
上位机项目不一样,它可能涉及:
- 真实设备。
- 串口/TCP 通信。
- 数据保存。
- 协议解析。
- 现场配置。
- 测试结果。
- 客户交付。
AI 一旦误改通信协议、CRC、保存路径或线程逻辑,问题可能不是马上暴露,而是在现场或长时间运行后才出现。
所以本资料把这些内容作为硬要求:
- 先拆需求。
- 修改前备份。
- AI 先给影响范围。
- 每次只改一个目标。
- 修改后做回归。
- 交付前写清运行环境、配置和已知风险。
相关文件:
text
12-AI开发质量门.md
30-回归测试与验收清单.md8. 给用户的建议
如果你是第一次用 AI 做上位机开发,不要一开始追求“全自动”。
推荐顺序:
text
第一步:用普通 AI 整理需求和界面
第二步:选 Codex / Cursor / 国内 AI IDE / Codex++
第三步:让 AI 读资料包和 Skill
第四步:让 AI 读项目结构
第五步:按小任务逐步修改
第六步:用 Visual Studio 运行验证
第七步:按回归清单验收如果你已经会用 Codex,可以直接按 Skill 跑。
如果你不会 Codex,可以先用 Cursor 或国内 AI IDE,把 skills/host-computer-dev 转成项目规则。
如果你不想订阅官方套餐,可以看 05-第三方API与CodexPlusPlus路线.md。
9. 参考资料
这些资料可以帮助你理解当前 AI 编程工具的发展方向:
- OpenAI Codex:https://openai.com/codex/
- Codex 文档:https://developers.openai.com/codex/
- Visual Studio Copilot Agent Mode:https://learn.microsoft.com/en-us/visualstudio/ide/copilot-agent-mode
- Cursor:https://cursor.com/
- Claude Code:https://code.claude.com/docs/en/quickstart
- Stack Overflow Developer Survey 2025:https://survey.stackoverflow.co/2025/
- TIOBE Index:https://www.tiobe.com/tiobe-index/