Skip to content

Latest commit

 

History

History
110 lines (80 loc) · 5.36 KB

DEMOS.md

File metadata and controls

110 lines (80 loc) · 5.36 KB

Demo 体验与迭代接续

目标与边界

仓库提供两个面向不同意图的本机 Web Demo:

  • SecsFrame.CommunicationDemo 面向集成和现场调试。用户配置 端点、建立连接、选择或编辑 SML、发送数据/控制消息,并在同一工作面查看 状态、消息与结构化诊断。
  • SecsFrame.GuidedDemo 面向成果演示。用户从一个明确的开始 动作进入固定脚本,每一步只聚焦一个能力、一个实际动作和一组可见证据。

两个 Demo 都直接引用仓库项目,不复制协议实现。它们展示已实现的工程行为, 不新增标准默认值、设备消息 Profile 或 SEMI 合规结论。本机回环响应规则只 用于形成可观察事务,不代表任何设备接口定义。

采用 ASP.NET Core Interactive Server 是为了让浏览器承担界面,同时让本机 服务进程直接使用 HsmsConnection 的 TCP 能力。首轮不引入新的 前端框架或外部运行期资源。

注意力模型

通讯测试工具

阶段 用户首要问题 主关注区 持续证据
未连接 参数是否正确、能否连上 连接配置 顶栏状态与连接活动
Selected 发什么、是否等待回复 SML 编辑与发送 Session、System Bytes
操作中 动作是否完成 当前命令与禁用状态 活动时间线
故障 哪一层、哪个操作、哪个计时器 最新诊断 稳定诊断代码和详细字段
复盘 刚才发生了什么 活动与诊断 有界、倒序的会话内记录

因此界面不是传统仪表盘:连接、消息、日志是一个从左到右的工作流。未连接时 强调第一栏;进入 Selected 后强调第二栏;第三栏始终可见且不抢占当前操作。 窄屏按相同顺序纵向排列,避免改变工作心智。

分步演示系统

阶段 用户首要问题 主关注区 持续证据
开始前 这次会看到什么 场景标题与开始动作 固定步骤总数
执行中 当前系统做了什么 当前步骤舞台 已完成步骤轨迹
结果出现 如何证明不是静态动画 实际结果 状态、SML、事务标识
步骤切换 下一步关注什么 下一步动作 已完成证据保留
完成 当前成果覆盖到哪里 运行总结 能力/边界清单

演示系统不暴露连接表单或自由编辑器。所有输入固定且可复现;每次只执行当前 步骤,用户明确点击后才前进,不使用自动轮播。

当前工程

通讯工具

运行:

dotnet run --project demo/SecsFrame.CommunicationDemo/SecsFrame.CommunicationDemo.csproj

默认地址为 http://localhost:5080。首个纵向切片包括:

  • Active/Passive、IP、端口、Session ID 和显式 T3/T5/T6/T7/T8;
  • 默认开启的本机真实 TCP Active/Passive 回环;
  • 三个可编辑 SML 样例与严格 SML 解析;
  • 数据消息发送、Secondary 显示、Linktest 和 Separate;
  • 最多 500 条的内存活动流,显示状态、方向、System Bytes、SML 和受限 结构化诊断;不自动写盘或上传。

当前回环端对 W-Bit 消息返回相同 Body,并把 Function 加一。这个规则在界面 日志中明确标为非设备 Profile。

分步演示

运行:

dotnet run --project demo/SecsFrame.GuidedDemo/SecsFrame.GuidedDemo.csproj

默认地址为 http://localhost:5081。首个纵向切片固定演示公共连接、Selected、 动态 Item/SML、真实 Primary/Secondary、Linktest 和会话恢复。GEM、Trace、 诊断故障样本与运输故障将在后续脚本中逐项加入。

迭代账本

每个开发会话最多完成两轮迭代。完成一轮后立即更新本节;达到两轮后停止新增 范围,把下一轮留给新会话。

轮次 状态 范围 验收
D1 已完成 通讯工具首条连接/消息/日志纵向链路 Release 编译;真实回环发送与控制命令;1440px/390px 无横向溢出
D2 已完成 分步演示首条核心 HSMS 导览 五步实际动作与证据;Release 编译;1440px/390px 无横向溢出
D3 下一会话 通讯工具入站回复、消息收藏、日志筛选/脱敏导出 先定义数据分级;外部端点与回环回归
D4 下一会话 分步演示 GEM 基础与 Trace/诊断场景 每个场景引用现有公共 API 和专题边界
D5 待排期 启动器、发布打包、可访问性与用户试用修正 可重复安装/启动;键盘与窄屏完整走通

跨会话接续

新会话按以下顺序恢复:

  1. 阅读根目录 AGENTS.md、README.md、 docs/DEVELOPMENT-STATUS.md 和本文。
  2. 检查本文迭代账本、最新 Git 历史、工作区与对应 Demo 项目。
  3. 从最新 main 创建符合仓库约定的主题分支。
  4. 一次只把一个“动作到证据”的纵向切片标为进行中;不得同时开启第三轮。
  5. 行为、边界、运行命令或下一优先级变化时,同步本文、CHANGELOG 和开发 状态;完整 Release 构建测试仍是提交门禁。

所有演示文本应区分“实际执行证据”和“说明性边界”。未经授权标准与一致性 测试核对,不得把工程回环、固定脚本或成功运行改写成标准合规或生产就绪声明。