别来无恙的 C# 上位机 AI 实战站

Appearance

更新日志 ​

每次更新只记录真实发生的变化，没有完成的内容不会提前写成已发布。

内容类型：更新记录难度：入门适合：所有用户阅读时间：约 7 分钟

2026.08 ​

08-26 · 案例证据与工程结论收口 ​

这一轮重点不是继续增加流程，而是检查案例和模板是否会把历史实现误写成今天的通用规则。

案例库按 V10 重解释

  • 案例总览新增“历史项目阶段 / 当前 V10 任务路由”双视角，案例用于理解为什么这样判断，当前方法页用于决定今天这次任务怎么做。
  • 新项目案例改为 Facts / Inference / Decisions / Frontier；Agent 能从材料确认的事实不重新问用户，通信中断、报警、停止等后果不再预设为统一 FaultStop。
  • 案例 A 总览按 Read-Only、Execution、Performance、Regression 分流，不再把“现有项目先完整影响分析”当成所有小改前置。
  • 案例 C 明确历史流程不等于当前固定流程，经验按 .agent-memory / CONTEXT.md / ADR / Skill 分层沉淀。

纠正技术案例中的绝对化结论

  • 串口原始数据保存改为先确认 Buffer Ownership；SerialPort.DataReceived 不再被描述成“事件直接传来的 byte[] 会自动被覆盖”。
  • Channel 只作为一种实现选择：Bounded/Unbounded、容量、满载、顺序、丢弃和 Stop 策略必须显式定义；保存失败是否继续采集属于业务后果，不再默认 fail-open。
  • ADC 曲线案例明确 Persistent Data / Working Set / Display Window 三种生命周期，修正“每帧替换”和“最近 N 点滑动窗口”混写；采样率与 UI 刷新率分离，性能结论需要基线。
  • 状态误判案例区分 SourceConfirmed / UserDecision / Inference / Unverified，修改后出现乱码只是 Observed，不再直接写成已确认编码根因；RolledBackToKnownGood ≠ RegressionFixed。
  • 图表案例取消固定品牌推荐，改为按当前框架兼容、数据规模、多轴、授权、维护成本和小型 PoC 选择；“看起来不卡”不再作为性能结论。
  • 试验状态机案例把 State 与 Event Consequence 分开，AlarmOnly / Advisory 不再被模板自动升级成 InterlockFault。

模板和站点入口

  • 模板中心补回通信保存、状态机、回退等历史锚点，旧链接继续有效，但不再维护重复旧模板。
  • 模板中心增加日志时间线、性能长稳、真实设备验证的最短 Prompt，并在 Review 中加入 HardwarePending、EnvironmentBlocked、Evidence / Inference / Unknown 检查。
  • 日志专题正式路径统一为 /log-timeline-analysis，旧 /log-timeline-diagnosis 保留 noindex 兼容入口。
  • “关于本站”更新为 V10 当前定位：任务路由、证据等级、真实设备安全和技术文档工程是长期主线。

08-26 · V10 工业现场、安全与长稳能力补齐 ​

详细设计进一步自适应

  • “通信与协议设计”升级：新协议才做完整设计；已有通信问题优先 Read-Only、RegressionFix、证据时间线和 Replay。
  • 新增 Device Session Owner 规则，诊断/恢复默认复用已有会话，不为了“顺便查状态”打开第二个互斥串口/SCPI/TCP Session。
  • 明确 CommunicationError ≠ FaultStop，超时、断线和设备异常的业务后果必须按 Information / Advisory / AlarmOnly / InterlockFault 决定。
  • “总体设计与架构方案”只服务新项目、新子系统和系统边界变化；普通 Fast / Execution 不再机械进入架构流程。
  • ADR 改成三条件门：Hard to reverse + Surprising without context + Real trade-off，不把 Changelog 当 ADR。
  • “设计评审与任务拆分”按 MicroPatch / BehaviorPatch / 新子系统分不同任务卡强度，任务按可验证业务闭环切片，而不是按 Model→Service→ViewModel→XAML 文件切片。
  • “UI 与交互详细设计”加入 UI MicroPatch 旁路、Behavior Contract、操作员/诊断分层和 UI 安全边界，明确按钮禁用不能替代后端联锁。

真实设备安全

  • 新增“真实设备操作与验证安全边界”。默认 HardwareAction: ForbiddenByDefault。
  • 软件侧优先静态、focused test、Fake、Replay；真实设备只读观察和状态改变分开管理。
  • 高压、运动、阀门、继电器、加热、气路、联锁等高风险动作即使获得真机验证授权也保持 HITL。
  • 未执行的真机步骤使用 HardwarePending，不为了得到“全部通过”自动碰设备。
  • 原“AI 开发安全与脱敏边界”重构为资料/信息安全，与真实设备动作安全明确分工。

性能与长稳

  • 新增“性能与长稳诊断”：先建立可测 Baseline，再找 narrow hotspot，一次只优化一个有证据的瓶颈。
  • 覆盖 WPF Dispatcher 堆积、图表/日志无限增长、接收回调阻塞、同步 IO、队列背压、内存/GC、Stop/Dispose 假死和 RX→UI 延迟。
  • 性能结论要求同场景优化前后对比，同时保留功能正确性证据；短场景改善不能冒充长稳已验证。

项目知识与版本语义

  • “项目记录规范”改为价值驱动：Read-Only / MicroPatch 默认不建完整记录，只沉淀未来能减少搜索、返工或争议的事实、决策和证据。
  • 明确当前任务记录、.agent-memory、CONTEXT.md、ADR 的不同职责，不再默认保存完整 Prompt 和 AI 对话流水账。
  • “原型、功能初版和可验收版本”明确区分 ProductVersion 与 V10 V0–V4 Verification Level，避免 V0.3 产品版本与 V3 验证等级混淆。
  • 可验收状态改为看 Requirement→Evidence 追踪，不再用“连过真机/编译通过”作为单一完成标准。

新手路线

  • “AI 在每一步能做什么”和“新手学习路径”明确区分教学流程与生产流程：学习时多走一步是为了理解，真实项目按 Read-Only / Fast / Execution / Discovery 自适应。
  • 删除“每次 AI 修改都固定构建→运行→记录”“所有任务都先分析、先方案、用户确认后才写代码”等通用硬规则。

08-25 · V10 实战增益继续收口 ​

这一轮不再为了“版本统一”机械重写文章，而是从 V10 Skill 反查网站真正缺失、且能减少返工的工程能力。

需求与通信减负

  • “上位机项目需求拆解表”升级为 V10 Discovery：区分 Facts / Decisions，使用 Decision Tree / Frontier，只问当前阻塞实现的业务决策；Blocking Frontier 清零后停止，不再固定五轮访谈。
  • 已有项目优先写 Requirement Delta；目标、边界和行为已经明确时直接进入 Execution，不重新做完整 PRD。
  • “串口 / TCP 通信任务模板”增加 Read-Only / Execution / RegressionFix / Discovery 分流，不再把所有通信任务都当成新模块设计。
  • “通信证据包”改为证据优先：近期回归先比较 known-good，偶发问题先建时间线，优先 Fake / Replay，EvidenceGrade D 不再写成已确认根因。

操作员体验

  • 新增“操作员界面与维护诊断分层”：OperatorSummary 面向实验/测试人员，DiagnosticDetail 保留 SCPI、原始协议、错误码、寄存器、堆栈和时间线。
  • 明确主界面不应默认暴露 PID、线程、类名、DLL 等开发者概念；高频故障需要去重、节流和恢复提示。
  • WPF 页面和典型问题索引增加该专题入口。

业务约束传播

  • 新增“业务约束跨层传播”：先区分 DisplayOnly / DomainConstraint / ExperimentalChange。
  • DomainConstraint 只沿固定 UI → Domain/Application → MES/API → DeviceApply → FocusedTests 链检查一次，既防止只改 UI，也避免为一个数字全仓库漫游。
  • 强调内部表示与外部契约分离、设备倍率/clamp、历史兼容只在实际相关时检查。

设备会话与生命周期

  • “线程与资源生命周期设计”升级为 V10 日常可用版本，不再要求只有“完成总体设计”后才能使用。
  • 增加 Device Session Ownership、单连接、Start / Stop / Dispose 区分、Cancellation 传播、Timer 重入、事件解绑、重连旧任务残留和 Queue 背压。
  • 明确诊断优先复用现有设备会话；不要为了排查问题偷偷打开第二个串口/SCPI/TCP 会话改变现场条件。

站点交互一致性

  • 修复首页项目 Prompt 生成器：生成内容现在与 V10 正文一致，会先判断 Read-Only / Fast / Execution / Discovery；规格明确时不再输出“先不要直接写代码、重新分析完整计划”的旧话术。
  • 新专题已接入能力地图、侧边栏和相关专题，不作为孤立文章存在。

08-25 · V10 第二轮网站方法体系对齐 ​

任务路由与入口

  • 首页从统一“先分析/先计划”改为 Intent Gate：Read-Only / Fast / Execution / Discovery。
  • WPF 页面新增 UI MicroPatch Bypass：文案、颜色、Margin、列宽和现成 Style 不再默认进入完整 UI 设计流程。
  • 现代 AI IDE 协作流程取消“所有任务固定先出 Plan”，明确 Compact Brief、Context Budget 和 V0–V4。
  • 项目 Context 页面重构为 CONTEXT.md / .agent-memory / ADR / Rules 分工，不再用一个 PROJECT_CONTEXT.md 混装历史问题和稳定术语。

新增专题

  • 新增“测量值语义”：区分 RawValue、EngineeringValue、Conversion、ThresholdBasis、Aggregation、LoggedUnit。
  • 新增“行为与告警语义”：用 Behavior Contract 固定 Trigger / Condition / Action / Reset / Record / NonGoals，并区分 InterlockFault / AlarmOnly / Advisory / Information。
  • 新增“技术文档工程”：覆盖设计方案、详细设计、研制总结、使用说明、测试验收、需求规格和接口协议，强调 Evidence Map 与可追溯结论。

工程体系同步

  • Agent 工程改为“专家按需调用”，不再默认按需求→架构→开发→测试→文档串行全跑。
  • AI 工程能力地图增加 Read-Only、BehaviorPatch、RegressionFix、ExperimentalChange、Measurement、Documentation 等能力入口。
  • AI 开发验证体系增加 V0–V4、Focused First、NoTestsMatched、EnvironmentBlocked、Feedback Ladder 和 EvidenceGrade。
  • “读懂 C# 项目”新增 Read-Only Trace 和 Context Budget。
  • 测试/回归、代码 Review 和典型问题索引统一到 V10 的 focused verification 与 behavior-first 思路。
  • 侧边栏补充测量值、行为告警、技术文档工程，并修复旧 Prompt/ADR 锚点入口。

08-25 · host-computer-dev V10 与网站第一轮口径同步 ​

新增 / 升级

  • Skill 升级为 V10“行为语义与执行效率版”，增加 Read-Only Trace、UI MicroPatch Bypass、BehaviorPatch、Temporal Regression、ExperimentalChange、Measurement Semantics、Operator Message Policy 和 Advisory Fail-Open。
  • RegressionFix 强制 known-good-first：用户说“以前正常、最近改后异常”时，先比较 changed files 和相关 method/config/协议差异，再分析其它可疑代码。
  • Bug 调查加入 EvidenceGrade 和 SuspectedTransient，重试恢复不能直接写成“根因已确认”。
  • 行为修改新增 InterlockFault / AlarmOnly / Advisory / Information 后果分级。
  • E-SafeNet 已知项目优先走 affected-project 一次性预清和 HostDev verify。
  • V9 技术文档工程体系继续保留：设计方案、详细设计、研制总结、说明书、测试验收和接口协议按文档类型组织。

网站同步

  • 更新阅读路线、Skill 说明、功能修改流程、Bug/回归定位、资料包说明、加密环境、质量门、回归验收、模板中心、完整工作流和详细设计总览。
  • docs/skills/host-computer-dev/ 已同步为 V10 核心源码镜像，删除旧 v1.0 / Lane -1~3 口径。
  • 旧二进制下载包已移除，正式 V10 ZIP 需要以已验证包重新发布后再恢复下载入口。

08-01 · 内容补全与体验优化 ​

  • 新手入门新增环境安装与版本选择、串口与 TCP 基础、Git 最小入门等基础文章。
  • AI 纠偏指南补充常见纠偏话术。
  • 学习路线、G0-G9 质量门、导航和移动端排版继续统一。

2026.07 ​

07-30 · 工作流、模板与案例更新 ​

  • 完整项目工作流补齐总体设计、详细设计、通信、数据、状态机、线程和设计评审。
  • 新增六阶段新手简化版，模板中心增加任务选择卡片和模板等级。

07-29 · 首页与新手入门建设 ​

  • 首页改为新手导向并加入阶段选择器。
  • 新增新手入门栏目和趋势/问题索引。

待补充标记说明 ​

部分案例仍缺真实截图、长稳记录或最终 Git 提交证据。没有原始材料时保持“待验证/缺证据”口径，不补造演示性测试结果。

别来无恙 · C# 上位机 AI 实战站 · 从零到交付 · QQ 群：1016188499

内容用于工程学习与经验交流，设备结果与交付风险仍需人工确认。