# 牧羊人之心牧场助手 · Web 2.0.2 ## 产品约束 把现有桌面助手的功能和操作结构迁移至单管理员 Web 工作台。桌面版是页面顺序、信息密度、业务名称、保护条件与交互的依据,保留桌面兼容。本轮 Web 发布目标为 `2.0.2`,源码入口 `main`,游戏数据版本 `1.9.68`;桌面正式版保留 `1.2.0`。启动与配置见 [运行说明](README.md),Docker 与更新条件见 [部署说明](../deploy/web/README.md)。 使用者在 Windows 本机配置、验证,随后可在 Linux Docker 常驻运行。多个浏览器访问同一个管理员工作台;账号互相隔离,各账号串行执行,账号之间可以并行。 ## 固定工作台结构 1. 顶部原生风格菜单:账号、策略、配置、帮助。 2. 多账号页签,支持新增、切换、移除。 3. 当前角色昵称、等级、经验、金币、氪金、体力;随机刷新间隔、绿色开启/红色停止、刷新/预览、调试、日志显隐。 4. 同桌面顺序的功能页:登录、培育室、背包、牧场、每日事务、自动孵蛋、自动主线、战斗记录、自动赠礼、自动委托、自动探险、自动扫荡、数据分析、执行计划、收益资料。 5. 可拖动高度、可隐藏的底部日志和常驻状态栏。 ## 核心操作 - 账号密码登录后选择区服进入;恢复已保存会话;退出与清除登录记录。游戏凭据仅交给同源服务端,不进入浏览器持久存储或 URL。 - 手动选服、恢复会话和自动重登成功读取角色后,均默认开启策略,自动执行已配置且已勾选的功能,可在顶部停止;不改变各子功能的勾选。获取区服候选及失败候选不视为登录成功,界面以服务端在线与运行状态为准。导入配置只替换规则并停止执行,下次成功登录仍自动开启;服务重启后未成功登录时不直接执行。 - 配置通过中文 schema 生成原生控件;逐蛋孵化/补货规则、物品赠礼保留量、逐魔物培养目标、关卡规则等直接在对应页面编辑。自动保存显示待保存、保存中、失败与已保存状态。 - 培育室扩建、牧场锁定/解锁、批量派遣/喂养、上下文菜单和费用二次确认沿用核心行为。切换功能页只读取视图,不触发游戏写操作。 - 主线默认当前主线,可切换筛选。地图按地区默认折叠,展示普通关卡、矿洞、难度、次数和工具库存。探险支持队员手选/自动与完成后自动领奖说明。 - 数据分析用真实 DTO 绘制 SVG 条形图,保留来源筛选、体力效率、样本和不确定性说明。没有样本时明确说明。 - 策略统一导入导出;收益 CSV/XLSX 导入与可用数据下载。错误展示具体原因,不把不支持的任务伪装成可执行任务。 - 帮助可检查 GitHub 正式版本并提交受控更新请求。未配置部署器时明确显示原因,更新提交不表示更新成功。 - 已在 2.0.1 完成私有仓库和 GHCR 认证的部署,可在 2.0.2 发布就绪后直接通过“帮助 → 检查版本更新…”升级,无需重复初始化或替换宿主机更新器;升级完成后刷新网页以加载新版界面,安装结果以宿主机健康检查为准。 ## 2.0.2 分类日志 各功能页提供当前账号的分类日志面板;底部总日志和调试日志入口继续保留,账号之间不混入日志。 | 功能页 | 分类 | 日志范围 | | --- | --- | --- | | 登录 | `login`、`general` | 登录及常规记录,包括混合或无法归类的旧记录 | | 每日事务 | `daily` | 每日事务记录 | | 牧场 | `ranch` | 手动牧场操作、自动潜能突破及对应暂停记录 | | 自动孵蛋 | `hatching` | 孵蛋与牧场整理策略记录,包括自动喂养、出售、收取及暂停 | | 自动主线 | `mainline` | 主线推进记录 | | 自动赠礼 | `gifts` | 赠礼记录 | | 自动委托 | `commissions` | 委托记录 | | 自动探险 | `exploration` | 探险记录 | | 自动扫荡 | `maps` | 扫荡及地图挑战记录 | - 同一账号使用单一共享日志拉取,供总日志与分类面板复用;浏览器共享缓存上限 1200 条,每个面板最多显示最近 600 条。 - 分类面板提供文字搜索、级别筛选、独立清空显示与下载、隐藏、跟随最新及暂停跟随。清空只影响当前账号当前面板,不清空其他面板或服务端历史;下载遵循本面板的清空范围与筛选条件。 - 分类随普通运行日志记录持久保存。动作来源上下文优先于通用文字前缀;孵蛋/牧场整理策略产生的“暂停喂养”归入 `hatching`,不因文字中包含喂养而改归 `ranch`。 - 无分类旧记录仅在所有片段的明确前缀一致指向同一类别时保守推断;不拆分或强行重分混合记录。混合、未知或无法识别的类别保留为 `general`,在总日志和登录面板可见。 功能与验证范围见 [2.0.2 发布说明](../analysis/RELEASE_2_0_2.md)。 ## 安全与验证 不发真实游戏 API 测试,不读取或更改私人 `local_state` 账号。浏览器测试仅使用临时目录、fake 后端或服务端离线演示。所有游戏文本用 `textContent` 呈现;日志使用服务端脱敏数据。管理登录、同源校验与 cookie 由 API 负责。 ## 技术默认假设 原生 HTML/CSS/ES modules,无 React、npm 构建、CDN 或网络字体。FastAPI 同源提供静态资源和 `/api`。以共享 WebManager/API/视图 DTO 契约为准,前端不构造游戏在线成功数据。桌面/服务端拥有业务规则,前端拥有展示与交互。1280 和 1600 宽桌面均可操作,小屏允许横向滚动。非业务的布局偏好可以存本机,凭据不可持久化。