主题
产品概览
巧曦大屏搭建平台是一款 拖拽式数据可视化大屏 搭建工具，帮助团队快速制作监控看板、汇报展示、活动宣传、课堂实时评价投屏等全屏页面。
当前用户手册对应产品 v2.3.0（含发版后属性搜索、入场延迟、表面填充等补丁）面向编辑者的能力。
你能做什么
| 能力 | 说明 |
|---|---|
| 搭建大屏 | 空白或模板创建；57 类组件（含 16 类课堂评价）；多页面、拖拽、吸附、对齐 |
| 属性面板 | 五段 Tab（内容/样式/数据/行为/高级）；搜索定位（拼音/同义词/高亮）；钉选常用项 |
| 样式 | 文字/表面 纯色与渐变、透明度；图表提示框、悬停阴影、数据标签单位 |
| 组件动画 | 入场动画、科技外壳、图表轮播、列表滚动、数字卷轴、地图飞线/轮播、词云漂浮 |
| 绑定数据 | HTTP / WebSocket / 课堂评价 API；数据源库跨屏复用与共享；按需加载 |
| 快速出样 | 28 套配色、26 类示例数据、组件预设/收藏/最近 |
| 预览发布 | 登录预览、公开链接、二维码、iframe、四种适配模式、访问统计 |
| 课堂评价 | 活动全生命周期、H5 打分、16 类投屏组件、大屏遥控、SSE 实时推送 |
| 团队协作 | 成员角色、团队隔离、在线感知、版本历史（自动 patch + 手动存版）、保存冲突 |
| 复用模板 | 评分收藏、标签筛选、贡献向导脱敏、从模板一键创建 |
典型使用场景
| 场景 | 常用组件与能力 |
|---|---|
| 运维监控 | 折线/仪表盘、地图飞线、滚动列表 + WebSocket 推送 |
| 数据汇报 | 图表 + 标题 + 视频/图片；登录预览给领导验收 |
| 展厅宣传 | 多页切换、入场动画 + 科技外壳、外链 / 事件链 |
| 对外展示 | 发布公开链接、iframe 嵌入、手机扫码、PV 统计 |
| 课堂答辩/评审 | 评价活动 + 排行榜/雷达/动态 + 遥控切页/揭晓 + H5 评委打分 |
| 技能实训考核 | 进度环/热力图 + 评委展示 + Excel 导出 |
使用流程（一图流）
登录 → 我的大屏 / 模板库 / 评价活动
→ 创建项目 → 编辑器搭版（组件 + 属性 + 动画）
→ 绑数据或填示例 → 保存 → 预览 → 发布（可选）
→ 访问统计 / 版本历史 / 协作成员课堂评价 另有一条线：
评分模板 → 创建活动 → 对象/评委 → 发布并开始
→ 创建评价大屏 → 现场遥控投屏 → 结束 → 导出 Excel界面与模块地图
登录后侧栏按 五组 折叠（你能看到的取决于权限）：
| 分组 | 用户向常见入口 |
|---|---|
| 大屏管理 | 我的大屏、模板库、数据源库 |
| 课堂评价 | 评价活动、评分模板库 |
| 组织与用户 | （多为管理员）用户、团队、角色 |
| 权限配置 | （管理员）角色权限、组件权限等 |
| 平台运维 | （管理员）图片素材、更新通告、审计 |
顶栏：主题、账号到期提醒、系统通告铃铛、用户菜单（改密/退出）。
首次登录可能有：欢迎引导、系统更新弹窗、首页 新手任务 清单。
编辑器核心能力速览
| 区域 | 能力 |
|---|---|
| 左栏 | 组件（收藏/最近 + 分类）、预设、素材、图层 |
| 画布 | 八向缩放、框选、网格吸附、数据源名称标签 |
| 右栏 | 属性（五段 + 搜索）、大屏设置、数据源 |
| 工具栏 | 页面、缩放、撤销重做、保存、配色、预览、发布、协作头像 |
角色与权限（用户视角）
不同账号看到的 菜单、按钮、组件类型 可能不同，这是正常的 RBAC 设计。
| 常见角色 | 通常体验 |
|---|---|
| 编辑者 editor | 创建、编辑、保存、预览、发布（视细粒度权限） |
| 查看者 viewer | 预览为主，不能改内容 |
| 受限编辑 limited | 仅部分基础组件 |
| 演示账号 | 可编辑预览，通常 不可发布，界面/公开页可能有水印 |
某按钮灰色或提示「无权限」→ 联系管理员，不要自行假设 bug。
评价大屏专用权限
评价关联大屏使用 eval:screen-* 权限（与通用 screen:* 分离），协作者仅凭大屏成员身份也可编辑已绑定评价数据的屏。
本手册包含 / 不包含
包含（日常使用）
- 登录、界面、新手任务、系统通知
- 我的大屏、模板库、数据源库、编辑器、属性面板、动画
- 数据源、发布、协作、版本、课堂评价（含 遥控）
- 快捷键、常见问题
不包含（管理员后台）
- 用户 / 角色 / 菜单 / 权限码配置
- 图片素材库上传与分类
- 系统更新通告的编写与发布、审计日志查阅
- 在线广播推送（
system:broadcast:send）
普通用户通过顶栏 铃铛 查看已发布的更新说明，或阅读 版本更新说明。
技术说明（用户可感知）
| 项 | 说明 |
|---|---|
| 实时评价 | SSE 推送打分与遥控；断线降级 HTTP 轮询 |
| 协作在线 | 编辑器 WebSocket 感知；失败降级 HTTP 心跳 |
| 保存冲突 | content_version 乐观锁，409 时弹窗选择 |
| 数据加载 | 编辑器/预览仅拉取 当前页已绑定 数据源 |
| 地图区划 | 平台本地 API，不依赖外网 DataV |
| 未实现 | 非 OT/CRDT 同屏改同一字段；版本无可视化 diff UI |