feat: redesign the web console with Vue and isolated account workspaces
This commit is contained in:
+38
-20
@@ -1,34 +1,52 @@
|
||||
# Web 工作台设计
|
||||
# BOT 控制台 UX 与设计规范
|
||||
|
||||
## 方向与依据
|
||||
此方案替代 Web 2 早期桌面式菜单、账号页签与横向功能标签;版本继续为 2.0.0 开发版。依据 UI UX Pro Max 的 operations monitoring dashboard 建议,采用功能优先的管理后台,舍弃其营销首页、试用转化和装饰动画建议。
|
||||
|
||||
按明确需求采用 Impeccable 的 code-led Operate 路径。现有 `ranch_assistant/gui.py`、`accounts_gui.py` 及各功能 `*_gui.py` 是视觉与交互依据;不增加营销封面或装饰卡片,不改变十五页的顺序。
|
||||
## 信息架构
|
||||
|
||||
页面是一张紧凑的浅色操作台。顶层是菜单、账号页签和运行工具栏,中层是功能页与可横向滚动表格,底层是可调日志。功能名称、绿色开启与红色停止对应现有桌面。页签选中使用细蓝边和浅蓝背景,状态文字与颜色一起说明结果。
|
||||
| 导航组 | 页面 | 范围 |
|
||||
| --- | --- | --- |
|
||||
| 工作空间 | 运行总览、账号管理 | 全部牧羊人之心账号 |
|
||||
| 游戏资源 | 连接管理、培育室、背包、牧场、每日事务 | 当前账号 |
|
||||
| 自动化策略 | 孵蛋、赠礼、委托、探险、主线、扫荡与挑战 | 当前账号 |
|
||||
| 运行观测 | 执行计划、战斗记录、数据分析、运行日志 | 当前账号 |
|
||||
| 资料与系统 | 收益资料、系统与配置 | 收益和策略属于当前账号;版本和更新属于平台 |
|
||||
|
||||
## 基础规格
|
||||
布局为左侧分组导航、顶部账号选择、面包屑及右侧内容。总览展示实际账号摘要、运行状态、异常和更新时间;不编造收益曲线、成功率或健康分数。没有账号时提供新增入口。
|
||||
|
||||
- 字体:系统 UI,Windows 优先 Microsoft YaHei UI/Segoe UI,其他系统采用可用系统中文字体;不从网络下载。
|
||||
- 正文字号 13px,辅助文字 12px,页内标题 14px;表格紧凑、数字使用等宽数字。
|
||||
- 空间基准 4px,控件高 26–28px,表格行约 28px。表头置顶,长掉落文本省略并保留 tooltip。
|
||||
- 界面背景 `#f1f3f5`,内容白色,分隔 `#cbd1d8`,正文 `#202832`,次要文字 `#55616e`,强调 `#245d9b`。
|
||||
- 运行开启 `#20743a`,停止 `#b3261e`,警告 `#805300`。键盘焦点有 2px 可见轮廓,状态不会只靠颜色传达。
|
||||
- 菜单和上下文菜单使用独立浮层,确认使用原生 dialog,避免被滚动表格裁切。
|
||||
平台仅一个管理员,不加入用户组织、权限、租户或审批。控制台专用于牧羊人之心,不提供游戏切换或其他游戏的预留入口。
|
||||
|
||||
## 交互要求
|
||||
## 多账号交互
|
||||
|
||||
各账号独立保存内存中的页签、筛选、选中行、视图缓存和待保存配置。轮询期间不重建正在编辑的控件,不覆盖焦点所在输入。输入经 debounce 自动保存,执行策略前先完成待保存内容;冲突或校验错误保留用户输入并给出可重试状态。
|
||||
- 顶部账号选择器明确当前操作范围,面包屑、角色资源、功能数据与日志始终属于同一账号。账号列表行操作显式绑定该行 ID。
|
||||
- URL 带账号与功能,支持页面刷新、前进后退,不带密码或 token。切换账号不停止其他账号,也不覆盖输入和筛选。
|
||||
- 各账号配置独立自动保存,显示保存中、已保存、失败可重试。版本冲突保留用户改动,开启前先保存成功。
|
||||
- 绿色“开启”与红色“停止”控制当前账号执行;各功能开关决定参与执行的策略。停止不等待保存或长任务结束。
|
||||
- 策略导入导出注明账号范围;导入不自动开启执行。平台退出与游戏退出分开;移除、喂养和扩建说明具体后果并确认。
|
||||
- 账号任务结束后不得抢回用户后来切换的页面或账号。普通导航和筛选只读取数据,不触发游戏写操作。
|
||||
|
||||
表格提供排序、行选择、多选、原生 checkbox、number 与 select。普通浏览不改变 number 数值;只有输入获得焦点时滚轮才可作用。地图地区默认收起;筛选本身只请求 GET 视图。主线默认当前任务。表单由中文 schema、路径、类型与选项驱动,不以 JSON 文本框代替业务控件。
|
||||
## 视觉与可访问性
|
||||
|
||||
长任务保留任务状态并轮询;状态栏、账号切换和日志仍可使用。停止按钮提交即时停止操作,不等待前一任务完成。费用、消耗魔物和移除账号使用明确的二次确认。扩建先取服务端报价,确认后回传报价与批准字段。
|
||||
深色侧栏 #162235、浅色画布 #f4f6fa、白色内容面板;主色 #2563eb,正文 #17243b,辅助文字 #526079,边界 #dbe2ec。运行绿、等待琥珀、失败红均配文字。优先状态识别和操作效率,不使用装饰性大卡片或营销区。
|
||||
|
||||
日志只渲染文本,保留自动滚动开关;用户向上查看时不会被强行拉到底部。分隔条支持拖拽、方向键、Home/End。隐藏日志后内容区利用剩余高度。
|
||||
系统中文字体,无外部字体/CDN;正文14–16px,辅助文字不小于12px,数字 tabular-nums。侧栏约224px,顶部约64px,内容留白20–24px,控件34–40px。图标使用一致SVG,图标按钮有名称和可见焦点。
|
||||
|
||||
## 响应式与可访问性
|
||||
页面按筛选、规则分组、数据、结果分区。长说明折叠,表格长值省略但可查看完整内容;宽表独立横向滚动,不撑宽网页。小屏使用可关闭侧栏抽屉,账号和启停仍可操作。支持键盘、焦点恢复、Escape与 reduced-motion。没有实时来源时只写最近更新时间。
|
||||
|
||||
1280/1600 宽使用相同层级。工具栏可换行,导航和宽表格独立横向滚动;小屏保留原字段而不压缩成卡片。页签与菜单支持键盘,原生表单有 label,错误和状态使用可访问 live region。遵从减少动效偏好,界面无装饰动画。
|
||||
## 性能与技术
|
||||
|
||||
## 技术默认假设
|
||||
Vue 3 + Vite负责新壳层、状态与构建;现有Python Engine、协议、业务动作与表单数据契约复用。框架更换本身不是性能提升证明。
|
||||
|
||||
静态 ES modules 由 FastAPI 同源提供;路径为 `/static/`,入口 `/`。安全逻辑以服务端认证、Origin 校验、公开 DTO 与脱敏日志为边界,前端使用 `textContent`/DOM API,不执行来自游戏的 HTML。浏览器不保存密码、token、key、会话原文。截图、E2E 只使用离线演示或显式 fixture;无样本图表不产生虚构柱形。
|
||||
- 账号摘要采用浅层响应式状态,大数据与DOM控件不做深层代理。
|
||||
- 只刷新并绘制当前可见账号和页面;其他页面保留查询和选中状态,展示时再同步。
|
||||
- 长表默认每页50条,可调整页容量;排序针对完整结果,跨页选中规则明确。
|
||||
- 地区默认折叠,展开才创建行;日志按需获取、增量显示并限制长度。
|
||||
- 视图、状态、日志请求防重叠;浏览器隐藏时减少查询,服务端策略继续运行。
|
||||
- 定时刷新不覆盖正在编辑的值或焦点;数字框仅获得焦点后响应滚轮。
|
||||
- 静态产物可直接由Python服务提供;Node仅用于开发与镜像构建。依赖锁定,生产不依赖CDN。
|
||||
|
||||
## 验收
|
||||
|
||||
保留既有十五项业务能力,以新导航重新组织。临时离线演示和fixture覆盖全页面、账号隔离、自动保存冲突、启停、确认动作、长表分页、日志、更新、管理认证及子路径部署;不使用真实游戏账号进行设计测试。
|
||||
|
||||
检查1440px、1280px和手机宽度的布局、键盘与可读性。长表性能以DOM数量和实际交互测试记录为准,不承诺采用Vue后固定倍数的提升。管理登录仍是独立页面,未认证时不提供工作台。
|
||||
|
||||
Reference in New Issue
Block a user