Appearance
关于本站
这是一个面向 C#/.NET/WPF/WinForms 工业上位机开发的 AI 协作实战站。内容来自脱敏项目过程、可验证工程实践、公开资料以及明确标注的教学重构。
本站的目标不是让流程越来越多，而是让 AI 在真实项目里更快判断：这次到底需要查多少、改多少、问多少、验证到什么程度。
1. 这个站适合谁
比较适合
- 正在做 C#、WPF、WinForms 上位机项目的人。
- 经常处理串口、TCP、SCPI、Modbus、设备状态、数据采集和日志的人。
- 需要维护已有工业软件，而不是只从零生成 Demo 的工程师。
- 需要编写设计方案、研制总结、说明书、测试/验收资料的人。
- 想长期使用 Codex / Agent，但不希望每个小改都变成一小时流程的人。
2. 当前方法核心：先分任务，再决定流程深度
text
Read-Only Trace
= 只是查当前代码怎么工作
Fast / MicroPatch
= 明确小改
Execution
= 目标和边界已经明确
Discovery
= 仍有会改变业务结果的未知
V0–V4
= 独立决定验证强度所以本站既保留完整新项目工作流，也明确反对把完整工作流套到所有日常任务上。
3. 这个站不承诺什么
边界说明
- 不承诺 AI 一次生成完整可交付工业软件。
- 不把编译通过写成业务功能通过。
- 不把 Fake / Replay 通过写成真机验收通过。
- 不把“代码看起来可疑”直接写成已确认根因。
- 不把某个图表库、架构、协议做法写成所有项目的标准答案。
- 不建议把未脱敏客户源码、协议、日志和敏感参数直接上传到不受控环境。
- 不允许 Agent 未经明确授权自动执行真实高压、运动、阀门、继电器等危险动作。
4. 内容可信度怎么表达
本站逐步统一使用更明确的证据状态：
| 状态 | 含义 |
|---|---|
Verified | 有实际验证证据 |
SourceConfirmed | 代码/配置/协议/批准材料明确支持 |
UserDecision | 项目人员明确做出的业务决策 |
DesignOnly | 只有设计，尚未实现/验证 |
Inference | 合理推断，但不是直接证据 |
Unverified | 当前无法确认 |
EnvironmentBlocked | 验证被环境阻塞，不能写成 TestFailed |
HardwarePending | 软件侧已准备，但仍需真实设备/HITL |
Bug 调查还使用 EvidenceGrade A–D，避免把候选假设写成根因。
5. 案例有三种来源
- 真实脱敏案例：来自实际项目，保留真实问题和证据边界。
- 重构教学案例：把多次经验组合成一个清晰教学场景，不冒充单个项目原始记录。
- 教学演示项目：为了帮助新手理解而刻意简化，不代表生产环境。
历史案例会保留“当时怎么做”，但当前推荐方法以 V10 权威方法页为准。
进入：实战案例总览。
6. 网站和 Skill 的关系
text
网站
= 为什么这样做、怎样理解、案例和方法
host-computer-dev Skill
= Agent 实际执行这些规则
CONTEXT.md
= 当前项目稳定业务语言
.agent-memory
= 当前项目历史事实和已知坑
ADR
= 长期重要且非显然的取舍网站不是把 SKILL.md 重新排版一遍；它要让工程师能理解这些方法为什么成立、什么时候不应该使用。
7. 工业现场安全是独立边界
真实设备验证默认遵循：
text
Fake / Simulation
→ Replay
→ 软件侧 focused verification
→ 必要的只读真机
→ HITL需要高压、运动、阀门、急停、保护链等动作时，人工授权和现场确认不能被自动测试替代。
详见 真实设备操作与验证安全边界。
8. 正式技术文档不是“AI 润色”
本站把设计方案、详细设计、研制总结、使用说明、测试/验收和接口协议作为技术文档工程处理，强调：
- 文档类型；
- 读者；
- Evidence Map；
- 图表和矩阵；
- 未验证项；
- HardwarePending / EnvironmentBlocked；
- 历史样稿不能污染当前事实。
详见 技术文档工程。
9. 哪些内容容易变化
以下内容不作为永久结论：
- AI 工具价格和套餐；
- 模型能力和产品入口；
- 第三方库最新版本和授权；
- IDE/Codex 当前 UI；
- 某个厂商产品的最新特性。
这类内容需要结合当前官方资料重新确认。
相对稳定的是：任务路由、业务语义、证据方法、安全边界、状态/资源生命周期和可追溯文档方法。
10. 建议从哪里开始
- 不知道当前问题走哪条路 → 按问题找方案
- 想理解整个 V10 → AI 工程能力地图
- 想直接用 Skill → host-computer-dev Skill 说明
- 新项目/新子系统 → 完整项目工作流
- 已有项目修改 → 功能修改最小流程
反馈
如果某页没有解决你的问题，最有价值的反馈通常是：
- 哪个真实场景缺失；
- 哪条规则让小任务变慢；
- 哪个结论缺证据或说得过满；
- 哪两个页面互相矛盾；
- 哪个工业现场问题仍然没有清楚入口。
QQ 群：1016188499
一句话原则
本站追求的不是“AI 多做流程”，而是让工程经验以最小必要成本出现在正确任务上，并让最终结论有证据、有边界、能回到真实设备和交付责任。