仓库提供两个面向不同意图的本机 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 | 待排期 | 启动器、发布打包、可访问性与用户试用修正 | 可重复安装/启动;键盘与窄屏完整走通 |
新会话按以下顺序恢复:
- 阅读根目录
AGENTS.md、README.md、docs/DEVELOPMENT-STATUS.md和本文。 - 检查本文迭代账本、最新 Git 历史、工作区与对应 Demo 项目。
- 从最新
main创建符合仓库约定的主题分支。 - 一次只把一个“动作到证据”的纵向切片标为进行中;不得同时开启第三轮。
- 行为、边界、运行命令或下一优先级变化时,同步本文、CHANGELOG 和开发 状态;完整 Release 构建测试仍是提交门禁。
所有演示文本应区分“实际执行证据”和“说明性边界”。未经授权标准与一致性 测试核对,不得把工程回环、固定脚本或成功运行改写成标准合规或生产就绪声明。