适用人群与边界（V10）

内容类型：方法说明难度：入门适合：想判断本站是否适合自己的人阅读时间：约 6 分钟

本站面向 C# / .NET 上位机、测试平台、设备控制、数据采集和工装软件开发。它既可以帮助新人建立基本方法，也可以帮助已有项目经验的人把 AI / Agent 接入日常开发。真实设备安全、业务最终决策和交付结果仍由工程师负责。

1. 最适合哪些人

初级 / 中级上位机开发人员

会一些 C#、WPF/WinForms、串口/TCP，但完整项目容易卡在：

• 需求和现场语言怎么落到软件；
• 状态机、通信、数据、UI 怎么分；
• AI 为什么总改太多；
• Bug 怎么从猜测变成证据；
• 修改后到底要验证到什么程度。

本站不会要求你每次都先走完整“需求→架构→开发→测试”链路，而是教你先判断 Read-Only、Fast、Execution、Discovery，再选择对应工程深度。

自动化测试、设备调试、工装开发人员

你可能不是专职软件工程师，但熟悉仪器、设备、试验步骤和现场约束。这类经验很有价值，AI 可以帮你把它转成：

• Behavior Contract；
• 设备/通信接口；
• 上位机页面和流程；
• 自动测试；
• 技术方案、研制总结和说明书。

已经有成熟工程经验，但想把 AI 用得更稳的人

对于资深工程师，价值不在“让 AI 教你 C#”，而在：

• Read-Only Trace 快速追调用链；
• Git/known-good 做近期回归定位；
• Fake/Replay 缩短设备 Bug 反馈；
• 第一轮 Diff Review；
• Context / Memory / ADR 管理长期项目知识；
• 技术文档 Evidence Map；
• 显式 Architecture Hotspot Review。

2. 特别适合哪些项目

• 串口 / TCP / UDP / Modbus 设备控制；
• 示波器、电源、信号源、采集卡等仪器控制；
• WPF / WinForms 测试软件；
• 数据采集、CSV/数据库、日志与历史查询；
• 报警、联锁、状态机和试验流程；
• MES/上层系统接口；
• 实验室和工装测试平台；
• 正式设计方案、研制总结、使用说明、测试验收资料。

3. 你需要具备什么基础

不要求你先精通所有技术，但至少要愿意做到：

1. 能运行或观察项目，提供真实现象；
2. 能区分“我希望什么”和“现在发生什么”；
3. 愿意看 Git Diff 或至少核对修改文件；
4. 涉及真实设备时能做基本现场确认；
5. 不把 AI 的合理解释自动当成测试证据。

完全零基础也可以从 新手入门 开始，不建议第一天就让 Agent 接管完整商业项目。

4. AI 可以自主承担什么

在有 Git 回退、权限受控的普通工程环境中，Agent 很适合自主完成：

• 搜索代码、调用链和配置来源；
• Read-Only Trace；
• 明确 MicroPatch；
• 普通源码修改；
• 静态检查、affected build、focused test；
• Fake / Simulation / Replay；
• 日志、Diff、known-good 对比；
• 正式文档 Compose / Revise / Review 草稿；
• 非破坏性的资料整理和项目知识沉淀候选。

这些事情不需要每一步都让用户确认文件名、类名和可从仓库直接查到的事实。

5. 哪些事情必须保留人工决策或授权

业务决策

例如：

• 超限后应该 InterlockFault 还是 AlarmOnly？
• 自检失败是否允许继续？
• 停机窗口和测试窗口的真实业务边界是什么？
• 临时实验条件是否要升级为正式规格？

这些会改变最终产品行为，用户/工程师必须决定。

危险真实设备动作

未经明确授权，Agent 不应自动执行：

• 高压输出；
• 运动机构；
• 继电器/大功率输出；
• 加热、气路等危险动作；
• 破坏性数据库操作；
• 正式发布覆盖。

最终验收

自动测试可以证明很多软件行为，但不能替代现场安全和真实设备验收。

6. “AI 自主”不等于“所有任务都走完整流程”

V10 的路线：

查现状
→ Read-Only Trace

明确小改
→ Fast

目标明确的业务修改
→ Execution

关键业务规则未定
→ Discovery

Execution 再按语义分：

MicroPatch
BehaviorPatch
RegressionFix
ExperimentalChange

所以：

• 改一个文案不需要需求访谈；
• “连续 5 次只报警不停止”不需要重做完整需求文档，但要固定 Behavior Contract；
• “以前正常、昨天改坏”要先比 known-good；
• 新项目规则尚未确定时才需要较深 Discovery。

7. 验证也不是越多越专业

V10 用 V0–V4：

等级	典型任务
V0	纯静态/文案
V1	XAML、普通局部代码
V2	设备、通信、MES、数据、共享约束
V3	状态机、联锁、并发、恢复
V4	发布、大范围兼容和重构

任何修改都需要与风险匹配的验证，但这不等于每次都必须 full build + full test + 真机。

8. 本站不能承诺什么

本站和 Skill 不能承诺：

1. 不看项目事实就解决所有问题；
2. 所有 AI 生成代码都可以直接交付；
3. AI 可以替代真实设备联调和安全评审；
4. 没有测试证据也可以写“经验证通过”；
5. 某个 AI 工具、套餐、模型能力长期不变；
6. 一套固定模板适合所有项目和所有任务。

9. 哪些用法不适合

• 想一句话让 AI 生成并交付完整商业项目；
• 不愿学习任何基本工程概念，也不愿核对结果；
• 把未脱敏客户数据、密钥、真实设备敏感信息直接发给外部服务；
• 在没有专业人员和安全环境时让 AI 控制高风险设备；
• 用于违法、破解授权、作弊或违规采集。

10. 如果你是资深工程师

不需要放弃已有成熟流程。更适合把 V10 当成一层 Agent 执行纪律：

你的工程规范
+ 现有架构/测试体系
+ V10 Intent Gate / Context Budget / Evidence / Verification

只吸收能减少重复劳动、提高证据质量的部分，不为了“AI 化”重建已有稳定体系。

11. 如果你是完全新手

推荐：

认识上位机
→ C# / VS 基础
→ WPF/WinForms 基础
→ 串口/TCP 基础
→ 第一个可运行 Demo
→ AI Review / 小修改
→ 再进入完整工程方法

学习阶段可以让 AI 解释更多；生产阶段则按任务风险选择最短流程。

下一步

• 5 分钟开始
• V10 Skill 说明
• AI 辅助 C# 开发路线
• 完整阅读路线

一句话原则

本站的目标不是让 AI 接管工程判断，而是把可自动化的事实获取和执行交给 Agent，把真正需要人的业务、安全和验收决策留给工程师。