# 程序导览

> 一次走遍 Ganter Lab 各个区域的导览，逐页打开页面并指向真实的控件：从哪里开始、提供给谁、气泡里有什么、它从不做什么，以及按顺序排列的各站。

**开始导览** 会按照搭建工作站的顺序走遍 Ganter Lab 的各个区域：从欢迎开始，经过 Connector、Logic、Process 和 View，再到菜单里的其余页面。每到一站，导览都会自己打开页面，并在这一站讲解的控件旁边放一个气泡，用一个圆环圈出这个控件。画面需要屏幕上有数据的地方，气泡还会播放一段真实程序的短片。导览只打开页面并指给你看：它不创建、不编辑，也不按下任何东西，所以在生产中的工作站上也可以走一遍。

## 从哪里开始 {#where-it-starts}

| 位置 | 按钮在哪里 | 什么时候画出来 |
|---|---|---|
| [欢迎](welcome#the-tour) | 页面标题的右边，程序各区域那条路线的上方 | 欢迎这一项在导航栏上，并且导览提供给当前身份 |
| 帮助面板 | 帮助键（右上角的 ?）打开的面板顶部，每一页都有 | 导览提供给当前身份，不管工作站是否保留欢迎页 |

从帮助面板开始时会先关掉面板，让气泡独占整个窗口。帮助面板本身的说明见[窗口](app-window#contextual-help)。

## 提供给谁 {#who-is-offered-it}

导览提供给欢迎页所面向的那些身份（见[欢迎](welcome#who-sees-it)），只有一点不同：它不取决于工作站是否保留那一页，因为帮助面板在每一页都提供它。

| 情况 | 是否提供 | 走过的站 |
|---|---|---|
| 生效的角色持有配置 Connector、配置 Logic、管理 Process、编辑仪表画面、管理本地用户、管理代理（MCP）中的任意一项 | 提供，从欢迎页和帮助面板都能开始 | 角色能打开其页面的每一站，管理员能走全部 25 站 |
| 生效的角色一项都没有（只做监视和操作） | 不提供 | 无 |
| 欢迎页已经用 **不再显示** 拿掉了 | 提供，从帮助面板开始 | 同上，但少了欢迎页上的两站 |
| 已发布的演示 | 提供给每位访客 | 21 站：访客能打开的 18 站，加上 AI 助手工作时的三段短片，短片显示在访客当前所在的页面上。用户、设置、账户和代理这几页从不打开 |

生效的角色打不开其页面的那一站，不会出现在这个角色的导览里，所以气泡上的计数就是这个角色将要看到的站数。在已发布的演示上，播放短片的站是例外：它显示在访客当前所在页面的中间，不会打开它自己的页面。每块屏幕走自己的导览：在工作站自己的窗口里走的导览绝不会带动网络上的浏览器，反过来也一样。导览进行中，如果有人在这块屏幕上登录或退出登录，导览只保留新身份能看到的站；如果屏幕上的这一站不在其中，导览就结束。

## 气泡 {#the-balloon}

| 部分 | 内容 |
|---|---|
| 顶部 | 这一站所在页面的名称，与导航栏上的写法相同；当前走到哪一站，例如“25 项中的 3 项”；以及 **关闭导览** |
| 短片 | 在画面需要数据的站上：一段真实程序的短片，静音并循环播放 |
| 标题和正文 | 这一站讲解的内容，使用界面语言 |
| 对话 | 在关于 AI 助手的三站上：读者提出的请求和助手的回答，画在读者自己助手的一个小窗口里（你的 AI 助手，Claude、Codex 或任何支持 MCP 的助手），因为对话发生在那里，而不在程序里 |
| 底部 | 从第二站起有 **返回**，还有 **下一步**，在最后一站上变成 **完成** |

焦点在气泡里时，Esc 关闭导览，左方向键后退，右方向键前进；右方向键从不结束导览，结束要按 **完成**。导览结束后，焦点回到导览开始之前所在的位置，或者回到帮助键。导览打开时转到另一页（通过菜单、链接或浏览器的后退），导览就结束；在这一站的页面内移动，例如在 View 里打开另一个画面，导览不会结束。

气泡放在控件空间最大的那一侧，只要有一侧放得下就绝不盖住控件，并且始终留在窗口内。页面滚动、窗口改变大小时它都会跟着移动，还会把不在视野中的控件带进视野。页面此刻没有画出的控件（生效的角色没有的命令、空列表、仍在加载的页面）会让气泡带着同样的文字停在窗口中央，控件一出现，气泡就移到它旁边。

## 它从不做的事 {#what-it-never-does}

| 导览从不 | 原因 |
|---|---|
| 创建、编辑或按下任何东西 | 它用与导航栏相同的导航打开页面，并指向页面上的控件；需要屏幕上有数据的内容用短片展示 |
| 需要互联网 | 它的文字和短片都随程序一起安装；这份安装没有带的短片就干脆不画出来 |
| 载入演示或任何示例数据 | 它展示的是工作站自己的页面，页面里有什么就是什么 |
| 更改工作站的设置 | 关闭导览后，你会停在当时那一站的页面上 |

这些短片是从英文界面的程序录制的，因此不管界面语言是什么，短片里显示的都是英文；旁边气泡里的文字始终使用界面语言。

## 各站 {#the-stops}

完整的导览，按顺序排列。在已发布的演示上共有 21 站：第 16、18、23 和 24 站不在其中，第 19 到 21 站在访客当前所在的页面上播放短片。

| 序号 | 页面 | 这一站展示的内容 | 短片 |
|---|---|---|---|
| 1 | 欢迎 | 页面上那条走遍每个区域的路线，以及导览怎样走得更远，走进每一个页面 | 否 |
| 2 | Connector | 程序自带的驱动，按所连接的设备类别分组，以及工作站添加它要用的驱动的地方 | 否 |
| 3 | Connector | 用来添加驱动、并在它下面添加设备、串行线路或文件夹的 +；在网络上找到设备 | 是 |
| 4 | Connector | 实时读取的点位：原始值变成工程值，以及通信的健康状态 | 是 |
| 5 | Logic | Connector 里的每个数值都在 Logic 里成为一个地址 | 否 |
| 6 | Logic | 由表达式算出的变量 | 是 |
| 7 | Logic | 报警触发并被确认；负责自动化的动作和触发器 | 是 |
| 8 | Process | 模型：一次定义、在多个单元上运行的试验或生产工序 | 否 |
| 9 | Process | 运行：配方、步骤和结论 | 是 |
| 10 | Process | PDF 报告、打印的标签，以及导出为 CSV 和 Excel | 是 |
| 11 | Process | 历史：每一条已记录的运行，带整次运行的图表、备注和导出 | 是 |
| 12 | View | 监控画面的列表 | 否 |
| 13 | View | 编辑器：摆放仪表盘、图表、按钮和图元，并把每一个绑定到点位 | 是 |
| 14 | View | 全屏，以及在“远程访问”页面打开远程访问后，在另一台计算机的浏览器里打开工作站的画面 | 是 |
| 15 | 事件 | 报警、事件条目和联锁的时间线，以及它们的筛选和导出 | 否 |
| 16 | 用户 | 角色和权限；用 PIN 在本地登录，不需要服务器 | 否 |
| 17 | 验证 | 自动找出的配置问题，每一项都能直接打开到问题所在的位置 | 否 |
| 18 | 代理 | 连接 Claude、Codex 或其他支持 MCP 的助手，并选择它能改动什么 | 否 |
| 19 | 代理 | 用文字提出请求，由助手搭建；每一处更改都有记录 | 是 |
| 20 | 代理 | 问怎么做，由助手根据程序自带的文档讲解 | 是 |
| 21 | 代理 | 通过助手操作：它用序列号启动一次运行，实时跟踪，用结论回答，生成 PDF 并给这次运行加上备注；每一项操作权限都由你按范围逐一打开 | 是 |
| 22 | 远程访问 | 在平板或另一台计算机的浏览器里打开的工作站画面：地址及其二维码、谁可以进入，以及以自己的画面打开的设备 | 否 |
| 23 | 设置 | 语言，日期、时间和数字的格式，以及浅色或深色 | 否 |
| 24 | 账户 | 账户和许可证：离线时照样有效，订阅至少每 90 天与网站联系一次，永久许可证激活之后就再也不需要联系；免费模式 | 否 |
| 25 | 欢迎 | 回到欢迎页：每一页的帮助键，以及入门 | 否 |