Files
myrzx_bot/ranch_web/DESIGN.md
T

53 lines
4.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# BOT 控制台 UX 与设计规范
此方案替代 Web 2 早期桌面式菜单、账号页签与横向功能标签;版本继续为 2.0.0 开发版。依据 UI UX Pro Max 的 operations monitoring dashboard 建议,采用功能优先的管理后台,舍弃其营销首页、试用转化和装饰动画建议。
## 信息架构
| 导航组 | 页面 | 范围 |
| --- | --- | --- |
| 工作空间 | 运行总览、账号管理 | 全部牧羊人之心账号 |
| 游戏资源 | 连接管理、培育室、背包、牧场、每日事务 | 当前账号 |
| 自动化策略 | 孵蛋、赠礼、委托、探险、主线、扫荡与挑战 | 当前账号 |
| 运行观测 | 执行计划、战斗记录、数据分析、运行日志 | 当前账号 |
| 资料与系统 | 收益资料、系统与配置 | 收益和策略属于当前账号;版本和更新属于平台 |
布局为左侧分组导航、顶部账号选择、面包屑及右侧内容。总览展示实际账号摘要、运行状态、异常和更新时间;不编造收益曲线、成功率或健康分数。没有账号时提供新增入口。
平台仅一个管理员,不加入用户组织、权限、租户或审批。控制台专用于牧羊人之心,不提供游戏切换或其他游戏的预留入口。
## 多账号交互
- 顶部账号选择器明确当前操作范围,面包屑、角色资源、功能数据与日志始终属于同一账号。账号列表行操作显式绑定该行 ID。
- URL 带账号与功能,支持页面刷新、前进后退,不带密码或 token。切换账号不停止其他账号,也不覆盖输入和筛选。
- 各账号配置独立自动保存,显示保存中、已保存、失败可重试。版本冲突保留用户改动,开启前先保存成功。
- 绿色“开启”与红色“停止”控制当前账号执行;各功能开关决定参与执行的策略。停止不等待保存或长任务结束。
- 策略导入导出注明账号范围;导入不自动开启执行。平台退出与游戏退出分开;移除、喂养和扩建说明具体后果并确认。
- 账号任务结束后不得抢回用户后来切换的页面或账号。普通导航和筛选只读取数据,不触发游戏写操作。
## 视觉与可访问性
深色侧栏 #162235、浅色画布 #f4f6fa、白色内容面板;主色 #2563eb,正文 #17243b,辅助文字 #526079,边界 #dbe2ec。运行绿、等待琥珀、失败红均配文字。优先状态识别和操作效率,不使用装饰性大卡片或营销区。
系统中文字体,无外部字体/CDN;正文14–16px,辅助文字不小于12px,数字 tabular-nums。侧栏约224px,顶部约64px,内容留白20–24px,控件34–40px。图标使用一致SVG,图标按钮有名称和可见焦点。
页面按筛选、规则分组、数据、结果分区。长说明折叠,表格长值省略但可查看完整内容;宽表独立横向滚动,不撑宽网页。小屏使用可关闭侧栏抽屉,账号和启停仍可操作。支持键盘、焦点恢复、Escape与 reduced-motion。没有实时来源时只写最近更新时间。
## 性能与技术
Vue 3 + Vite负责新壳层、状态与构建;现有Python Engine、协议、业务动作与表单数据契约复用。框架更换本身不是性能提升证明。
- 账号摘要采用浅层响应式状态,大数据与DOM控件不做深层代理。
- 只刷新并绘制当前可见账号和页面;其他页面保留查询和选中状态,展示时再同步。
- 长表默认每页50条,可调整页容量;排序针对完整结果,跨页选中规则明确。
- 地区默认折叠,展开才创建行;日志按需获取、增量显示并限制长度。
- 视图、状态、日志请求防重叠;浏览器隐藏时减少查询,服务端策略继续运行。
- 定时刷新不覆盖正在编辑的值或焦点;数字框仅获得焦点后响应滚轮。
- 静态产物可直接由Python服务提供;Node仅用于开发与镜像构建。依赖锁定,生产不依赖CDN。
## 验收
保留既有十五项业务能力,以新导航重新组织。临时离线演示和fixture覆盖全页面、账号隔离、自动保存冲突、启停、确认动作、长表分页、日志、更新、管理认证及子路径部署;不使用真实游戏账号进行设计测试。
检查1440px、1280px和手机宽度的布局、键盘与可读性。长表性能以DOM数量和实际交互测试记录为准,不承诺采用Vue后固定倍数的提升。管理登录仍是独立页面,未认证时不提供工作台。