AIO 平台使用教程中心

总览：平台能做什么 START

四大端

五大能力域

界面导览（前台 / 后台） 快速

前台顶栏（登录后默认）

左侧表单列表

• ⭐ 常用：收藏的表单和文件夹
• 文件夹树：按文件夹分组，可展开/折叠
• 未分组表单：未归入文件夹的表单
• 点击表单项 → 中间打开；当前打开项左侧有高亮圆点
• 只显示你有权限查看的表单

中间表单区

• 表单内容 / 查看数据 两个 Tab：填写界面 / 已提交数据列表（搜索、排序、筛选、导出）
• 可全屏查看，刷新自动恢复上次打开的表单
• 三种表单类型：普通表单（采集）/ 仪表盘（图表看板）/ 数据池（Excel 大表）

管理后台（管理员）

• 顶栏 ⚙ 齿轮 → 输入后台密码进入
• 后台主体：成员管理、权限、系统设置、设备、审批等（入口按权限显示）
• 哪些入口可见由菜单权限控制，隐藏 = 无权访问，不是坏了

登录与账号安全 基础

三种登录方式

可信设备（免密登录）

首次在某台电脑登录后，可将其标记为"可信设备"（密钥有生命周期，默认 30 天）。之后在这台设备登录免二次验证。

• 查看/管理：右上角头像 → 可信设备
• 手机存 ID + 私钥，服务器存 ID + 公钥，验签匹配即通过（不限制设备数量）

手机端指纹 / 面容解锁

手机 App 支持本地指纹/面容锁（防别人拿起已解锁手机直接进 App）。注意：这是本地锁，与服务器验证是两道理，缺一不可；系统不支持或未录入指纹时可降级用密码登录。

表单与数据 核心

三种表单形态

建表单 / 看数据

1. 首页点 「搭建新表单」 → 进入搭建器设计 → 保存
2. 表单卡片点 「查看数据」 → 独立数据页：搜索、排序、列显隐、批量删除、CSV 导出
3. 卡片点 「设为主表单」 → 在客户首页直接展示
4. 附件文件在 files.html 统一管理

数据存储约定（重要）

• 数据分离：业务数据全部落客户库，平台库零业务数据
• 字段存储：子表单字段合并存入单个 JSON 列；其余字段一列一字段
• 用户显示统一「姓名 + 头像」，列表用表格、单条记录用表单

表单搭建器 拖拽

界面三段式

• 左栏：组件面板
• 中栏：画布（拖入、拖动位置、拖边框改大小）
• 右栏：属性面板（标签、字段名、必填等）

常用组件

关键属性

• 标签：字段显示名（中文，界面一律不暴露英文原始名）
• 字段名：脚本中引用用（data.字段名）
• 必填 / 不可重复
• 轮询秒数：传感器字段的采集周期（默认 5 秒）

计算脚本 自动化

基本写法

var 单价 = toNum(data.单价);        // 读字段
var 数量 = toNum(data.数量);
result.总价 = 单价 * 数量;           // 写结果
result.状态 = '已完成';

常用内置函数

子表单求和示例

var 总金额 = 0;
for (var i = 0; i < 明细_数量.length; i++) {
  总金额 += toNum(明细_数量[i]) * toNum(明细_单价[i]);
}
result.总金额 = toFixed(总金额, 2);

静默轮询（定时执行）

开启后脚本每 N 秒自动执行一次，无需用户操作。适用实时计算、定时校验。

公式引擎约定

• 用裸变量名引用字段（如 订单号、_记录ID）
• 不要写 fields.xxx —— 不是魔法根，运行时直接报错
• 支持自定义函数（先定义后调用）、跨触发共享变量

工作流引擎 19 节点

5 种触发方式

节点清单

Webhook 触发（外部系统接入）

1. 建工作流 → 触发节点选 Webhook → 复制生成的 URL + token
2. 第三方系统 POST 该 URL，body 携带字段（支持 Base64 / URL 编码传参）
3. 平台按 token 精确匹配到流程并执行，调用有审计记录
4. 响应格式由 response_format 决定

curl -X POST 'https://你的域名/api/webhook/<token>' \
  -H 'Content-Type: application/json' \
  -d '{"订单号":"A001","金额":100}'

API 节点（调外部接口）

在工作流里调用第三方 HTTP 接口。支持的认证方式：none / api_key / bearer / basic / hmac / oauth2_cc / oauth2_ac。

AI 节点

调用系统配置里的大模型做智能处理（客服答疑、分类、生成）。会话上下文独立标记，不污染其他会话。

审批流程 按业务流

流程怎么走

1. 流程节点配置审批人（按成员/角色/部门）
2. 提交后按节点顺序流转，审批人收到待办通知（站内信 + 可选邮件/IM）
3. 审批人处理：同意 / 驳回 / 转交
4. 节点支持抄送、加签，并按配置的通知渠道推送

待办入口

• 顶栏 🔔 铃铛 → 待办/通知角标
• 审批列表可查看"我发起的 / 我处理的"

成员与权限 管理员

添加成员

1. 进入「成员管理」→ 点「添加成员」
2. 填用户名、密码
3. 设角色与权限
4. 保存

权限层次

通讯录同步

接钉钉/飞书/企微后，可一键同步组织架构与成员到平台（在「系统设置 → 通讯录同步」操作）。

快速搭建与 SDL 进阶

快速搭建（AI 辅助）

• AI 对话生成配置：用自然语言描述需求（"做一个设备巡检表，带照片上传"），AI 生成表单/工作流配置
• SDL 导入 / 导出：把一份配置导出成 SDL 文本，换环境时导入还原；也可直接把 SDL 文本粘给 AI 改

SDL 是什么

SDL（Structure Definition Language）是一种简洁的文本配置语言，用于描述表单、工作流、权限等系统配置。典型形态：

## type:form
@type=form
@name=员工信息表
field:name|label=姓名|type=text|required=true
field:dept|label=部门|type=select|options=IT,HR,财务

设备管理 工业

设备账号与硬件

• 设备账号：每个设备/网关在平台有一个账号，用于鉴权
• 设备分组：设备账号支持分组管理（如"1号线""2号线"）
• 硬件配置：每个设备的协议、连接参数、绑定字段

支持的协议（EXE 直连）

建一个设备（以 Modbus TCP 为例）

1. 设备管理 → 新增设备 → 协议选 Modbus TCP
2. 填 IP、端口（502）、Unit ID
3. 绑定到表单字段 / 动作脚本
4. 点「测试连接」通过 → 保存

EXE 桌面客户端 设备端

首次使用

1. 打开 EXE → 登录页填服务器地址（http/https + 端口）
2. 选择登录方式：桌面登录（需管理员审批本机）/ 设备登录（设备账号免审批）
3. 登录成功 → 设备状态变为在线

能力清单

本机 HTTP 命令口

EXE 在本机起一个 HTTP 服务，供本机前端页面、外部脚本、运维调用，执行设备读写、脚本、回填表单。

安全设计：只监听 127.0.0.1（不开全网卡）+ Bearer token 鉴权。

ESP32 硬件中心 硬件

首次配网（必做）

1. 手机 App → 设备配网 → 连设备热点 SensorHub_Config（密码 config123）
2. 下发 WiFi 名称/密码 + 平台服务器地址
3. 设备重启 → 自动登录平台 → 建立通信

插槽与外设

主机插槽（XH2.54 6pin：VCC/GND/SIG1/SIG2/SDA/SCL）可插传感器（输入）与执行器（输出）。

绑定到平台

1. 插好插件
2. 平台端设备绑定：选表单字段 → 端口 → 协议 → 采集方式/轮询秒数 → 量程/单位
3. 固件每 100ms 轮询、状态变化即上报事件；平台按绑定回填字段

手机端 App 移动

能做什么

连接服务器

1. 登录页填服务器地址（客户域名）
2. 首次需在服务器后台确认该设备（可信设备流程）
3. 通知走平台长连接（/ws/notify）

AI 智能助手 大模型

配置（系统设置 → AI 配置）

1. 到 DeepSeek 开放平台申请 API Key（sk- 开头）
2. 系统设置 → AI 配置：启用 AI 助手 → 填 API Key
3. API 地址填 https://api.deepseek.com，模型填 deepseek-chat
4. 按需设并发数 → 保存 → 发条消息验证

AI 能做什么

• 顶栏「AI 企业助手」对话答疑
• AI 可查平台真实数据（知识库 + 数据查询工具）
• 工作流里用 AI 节点做智能处理

知识库 AI 配套

用法

1. 顶栏「企业知识库」→ 新建文档 / 上传
2. AI 助手问答时自动检索知识库相关片段
3. 可配向量模型提升检索质量（需额外配置）

企业网盘与文件 文件

能做什么

• 集中浏览/下载表单上传的附件（图片、文档等）
• 按表单/目录归集，替代散落在各表单记录里的附件
• 新建目录、重命名、删除文件

表单附件怎么进网盘

1. 表单里放「图片/文件上传」组件
2. 用户填表上传附件 → 自动存到网盘并与记录关联
3. 顶栏进网盘统一查看管理

钉钉 / 飞书 / 企微 集成

钉钉

1. 钉钉开放平台创建企业内部应用 → 拿 AppKey / AppSecret
2. 配置回调地址：https://你的域名/api/im/dingtalk/callback
3. 系统设置 → 钉钉集成 → 填 AppKey / AppSecret / 机器人编码 / 群 Webhook → 保存
4. 验证：群内 @机器人发消息，看平台日志匹配到商户

飞书

1. 飞书开放平台创建企业自建应用 → 拿 App ID / App Secret
2. 开启机器人能力，配事件订阅回调：https://你的域名/api/im/feishu/callback
3. 系统设置 → 飞书集成 → 填入保存
4. 验证 URL challenge 通过、消息日志正常

企业微信

1. 企微管理后台 → 应用管理 → 自建应用 → 拿 CorpID / Secret / AgentId
2. 配「接收消息服务器」URL：https://你的域名/api/im/wecom/callback
3. 系统设置 → 企业微信 → 填 CorpID / Secret / AgentId / Token / EncodingAESKey
4. 验证回调验签通过、通讯录同步成功

通知渠道 / 群助手

把平台事件推到群里：审批来了、告警了、流程走完了 → 自动发钉钉群/飞书群/企微群。

1. 在 IM 群建自定义机器人 → 复制 Webhook URL（钉钉还需加签 secret）
2. 平台「通知渠道」新建群助手：选平台类型 + 填 Webhook URL + Secret
3. 建通知规则：绑定"来源（流程/工作流/审批）+ 状态 + 群助手"
4. 测试：触发一次审批，群里收到消息

系统邮箱与通知 通知

配置（系统设置 → 系统邮箱）

1. 到邮箱服务商开启 SMTP/IMAP，拿授权码（不是登录密码）
2. 填 SMTP 服务器（如 smtp.qq.com）、端口 465、账号、授权码、发件人
3. 保存 → 触发一次找回密码验证收件

通知方式一览

OCR 识别 识别

三种引擎（系统设置 → OCR 识别引擎）

开放 API 与 Webhook 对接

两个方向

开放 API 密钥

1. 系统设置 → 开放 API 密钥 → 生成密钥（完整密钥只显示一次）
2. 第三方调用平台接口时携带该密钥
3. 平台校验放行

系统设置总览 配置中心

安全与合规 管理

安全机制

灾备与备份 运维

怎么配（运维）

1. 备机部署灾备接收端，确认端口可访问
2. 主机填灾备服务器地址 + 认证密钥
3. 备机标记为"灾备服务器"并填主机 IP
4. 「系统设置 → 灾备状态」查看同步进度

另有远程备份：定时把数据/归档备份到远程服务器。

外接清单（31 项） 总表

出网域名清单（私有化部署需开通）

常见问题 FAQ