# 牧羊人之心牧场助手 · Web ## 产品约束 把现有辅助能力组织为单管理员、多账号的牧羊人之心 Web 控制台。界面依照 Web 场景重新设计,不以桌面布局或页面顺序为约束;业务名称、保护条件与操作语义继续复用。版本为 `2.0.0.dev1`,游戏数据版本 `1.9.68`;本次不合并 main、不发布正式版本。专用于牧羊人之心,不提供多游戏入口,不增加多用户或权限管理。 使用者在 Windows 本机配置、验证,随后可在 Linux Docker 常驻运行。多个浏览器访问同一个管理员工作台;账号互相隔离,各账号串行执行,账号之间可以并行。 ## 固定工作台结构 1. 左侧分组导航,顶部账号选择器、面包屑,右侧内容区。 2. 全部账号运行总览和账号管理;各账号行可独立开启、停止和进入工作区。 3. 当前账号昵称、等级、经验、金币、氪金、体力;随机刷新间隔、绿色开启/红色停止、刷新/预览、自动保存状态。 4. 原有十五项业务按游戏资源、自动化策略、运行观测、资料与系统分组;各账号保留独立查询和规则。 5. 独立日志页与可收起的当前账号日志面板,提供级别筛选、搜索、跟随和脱敏详情;系统页提供配置导入导出、版本更新和连接管理。 视觉、路由、范围切换、性能与验收要求见 [UX 设计规范](DESIGN.md)。 ## 核心操作 - 账号密码登录后选择区服进入;恢复已保存会话;退出与清除登录记录。游戏凭据仅交给同源服务端,不进入浏览器持久存储或 URL。 - 配置通过中文 schema 生成原生控件;逐蛋孵化/补货规则、物品赠礼保留量、逐魔物培养目标、关卡规则等直接在对应页面编辑。自动保存显示待保存、保存中、失败与已保存状态。 - 培育室扩建、牧场锁定/解锁、批量派遣/喂养、上下文菜单和费用二次确认沿用核心行为。切换功能页只读取视图,不触发游戏写操作。 - 主线默认当前主线,可切换筛选。地图按地区默认折叠,展示普通关卡、矿洞、难度、次数和工具库存。探险支持队员手选/自动与完成后自动领奖说明。 - 数据分析用真实 DTO 绘制 SVG 条形图,保留来源筛选、体力效率、样本和不确定性说明。没有样本时明确说明。 - 策略统一导入导出;收益 CSV/XLSX 导入与可用数据下载。错误展示具体原因,不把不支持的任务伪装成可执行任务。 - 帮助可检查 GitHub 正式版本并提交受控更新请求。未配置部署器时明确显示原因,更新提交不表示更新成功。 ## 安全与验证 不发真实游戏 API 测试,不读取或更改私人 `local_state` 账号。浏览器测试仅使用临时目录、fake 后端或服务端离线演示。所有游戏文本用 `textContent` 呈现;日志使用服务端脱敏数据。管理登录、同源校验与 cookie 由 API 负责。 ## 技术默认假设 Vue 3 + Vite 构建前端,FastAPI 同源提供静态资源和 `/api`,不加载 CDN 或网络字体。以共享 WebManager/API/视图 DTO 契约为准,前端不构造游戏在线成功数据。服务端拥有业务规则,前端拥有展示与交互;使用表格分页、分组懒加载和按需刷新减少浏览器负担。桌面使用侧栏,小屏使用抽屉,宽表格独立滚动。凭据不进入浏览器持久存储。