release: prepare Web 2.0.0

This commit is contained in:
AttilaNet
2026-11-11 11:23:43 +08:00
parent 654567caa3
commit 923a367263
13 changed files with 73 additions and 49 deletions
+41 -23
View File
@@ -1,10 +1,26 @@
# 牧羊人之心Bot
原生 PySide6 桌面辅助,当前正式版本 **1.2.0**(`v1.2.0`),适配资料基线为《牧羊人之心》Android **1.9.68**。
支持多账号独立运行、牧场培养、每日事务、自动扫荡及本地掉落分析;1.2.0 增加主线与委托推进、内置模拟挑战、潜能突破和自动探险等功能,能力与验证限制见下文。
当前 Web 正式版本 **2.0.0**,源码入口为 `main`;原生 PySide6 桌面正式版本保留 **1.2.0**(`v1.2.0`)。两者的适配资料基线均为《牧羊人之心》Android **1.9.68**。
支持多账号独立运行、牧场培养、每日事务、主线与委托推进、近似战斗模拟、探险、扫荡及本地掉落分析,能力与验证限制见下文。
## 运行指引
### Web 2.0.0(main)
Windows 使用 Python 3.12+,在项目根目录执行:
```powershell
py -3 -m venv .venv-web
.\.venv-web\Scripts\python.exe -m pip install -r ranch_web\requirements.txt
.\Start_Ranch_Web.cmd
```
访问 `http://127.0.0.1:8765`。配置管理密码后先在独立 `/login` 页面登录,再添加游戏账号、选择区服或恢复保存的会话;本机 loopback 未设置管理密码时可直接访问。配置功能后,手动点击顶部“开启”运行策略;重启、恢复会话或导入配置后,策略默认关闭。
Web 无需 Node/npm 或 PySide6,数据独立保存在 `local_state/ranch_web`。Linux Python 启动、离线演示与环境配置见 [Web 运行说明](ranch_web/README.md);单服务 Docker、`/data` 持久化、子路径反代与宿主机受控更新见 [Web 部署说明](deploy/web/README.md)。
### 桌面 1.2.0
1. 在 Windows 中安装 Python 3,并确保 `python` 命令可用。
2. 在项目目录执行 `python -m pip install -r ranch_assistant/requirements.txt`,安装 PySide6 等依赖。
3. 双击项目根目录下的 `Start_Ranch_Helper.cmd` 启动辅助。
@@ -14,20 +30,31 @@
也可以在项目目录运行 `python -m ranch_assistant` 启动。
首次使用可先查看各页面数据、配置规则,再开启策略;重启、恢复会话或导入配置后,策略开关默认关闭。
## Web 2 开发运行与部署入口
## 适配版本
`develop/v2.0.0` 提供 **2.0.0.dev1** 开发工作台,保留原15页导航、多账号页签、顶部玩家数值与统一启停、可调整日志区,复用现有 Engine 和策略。尚未合并 main 或发布正式版,桌面入口继续可用。
| 组件与版本 | 《牧羊人之心》Android 基线 | 入口与状态 |
| --- | --- | --- |
| Web 2.0.0 | 1.9.68 | 正式版本;源码入口 `main`,`Start_Ranch_Web.cmd` / `sh start-web.sh` |
| 桌面 1.2.0(`v1.2.0`) | 1.9.68 | 当前桌面版本;`Start_Ranch_Helper.cmd` / `python -m ranch_assistant` |
| 桌面 1.1.1(`v1.1.1`) | 1.9.68 | 历史正式版本,1.1 系列修复与界面更新 |
| 桌面 1.1.0(`v1.1.0`) | 1.9.68 | 历史已发布版本 |
| 桌面 1.0.0(`v1.0.0`) | 1.9.68 | 历史已发布版本 |
- Windows:Python 3.12+,安装 `ranch_web/requirements.txt` 后运行 `Start_Ranch_Web.cmd`,访问 `http://127.0.0.1:8765`。
- Web 使用原生 HTML/CSS/ES 模块与 FastAPI,无需 Node/npm 或 PySide6;数据独立保存在 `local_state/ranch_web`。
- Linux:提供单服务 Docker、`/data` 持久化及宿主机受控更新;只接官方稳定 `v2.x.y`,默认只通知,未配置执行器时仅检查。
- 配置管理密码后,先进入独立 `/login` 页面,登录后才能打开工作台;退出管理登录或会话失效后返回登录页。
本表记录适配资料基线,不代表其他客户端版本兼容或全部功能已完成实机验收。Docker 镜像以标签流水线成功结果为准,在线更新依赖对应 GitHub Release 条目;详见 [部署说明](deploy/web/README.md)。
本地虚拟环境、离线演示与环境配置见 [Web 开发运行说明](ranch_web/README.md);Linux 单服务 Docker、`/data` 持久化、GHCR 镜像与宿主机备份/回滚更新见 [Web 部署更新入口](deploy/web/README.md)。更新仅接受官方稳定 `v2.x.y`,没有 Web 2 正式版时不会安装旧桌面版;Windows 未配置执行器时仅检查更新。Linux Docker 部署烟测已通过,真实游戏 API 与生产升级/回滚仍待验收。
## Web 2.0.0 主要功能与掉线修复
完整离线后端验证 **193项:192通过、1跳过(Windows符号链接权限),0失败/错误**;浏览器 **21项全部通过,JS/CSP错误为0**。完整测试命令见 [Web 验证说明](ranch_web/README.md#离线验证)。独立管理登录页补丁的线上重新部署验收待完成,真实游戏 API 尚未验收。
- **原布局与15页**:沿用桌面页面顺序、账号页签、顶部玩家数值与统一启停、可调整日志区。
- **多账号与独立后台**:各账号隔离并行、同账号请求串行;关闭网页或退出管理登录后,服务端继续监控及已开启的策略。
- **管理登录与子路径**:独立管理登录页、HttpOnly / SameSite cookie、写请求来源校验;支持 `/ranch` 等反代子路径,游戏凭据保存在服务端。
- **策略与数据**:复用孵蛋、牧场、喂养、突破、赠礼、每日、主线、委托、探险和扫荡策略,支持自动保存、导入导出、执行计划及掉落分析。
- **日志与更新**:普通日志按账号限量持久保存,调试详情按进程缓存;仅检查官方稳定 2.x Release,未配置执行器时仅检查,受控安装与备份/回滚由宿主机执行,自动安装默认关闭。
## 当前功能
本次修复连接状态误判:区分在线、临时故障重试、游戏会话失效与未连接,显示最后成功通信及下次重试时间,旧快照标注为缓存。临时故障先停止策略,再退避执行只读探测;会话失效时停止游戏轮询,需手动恢复或重新登录。恢复成功后仍需手动开启策略,未确认的写操作不自动重发,页面轮询不会清除游戏连接错误。
战斗模拟仍为近似模型,特殊关卡并非全部支持。已有离线回归和早期部署烟测的阶段、命令及限制见 [Web 验证说明](ranch_web/README.md#离线验证);这些记录不代表正式 2.0.0 已完成真实游戏 API 或生产升级/回滚验收。
## 桌面 1.2.0 功能基线
| 模块 | 1.2.0 当前实现(战斗能力范围见下文) |
| --- | --- |
@@ -97,13 +124,15 @@
“每点体力数量”按已知消耗样本的物品总量除以实际扣除体力计算,未知消耗不参与。
资料包含1178个关卡和2079种道具名称;v1.2 的独立任务资料另含1165个任务、337个NPC和4269份剧情脚本,其中4239份属于已支持的线性类别,主线引用的720份中有718份属于该类别。脚本分类数量不代表任务或战斗全部通过;30份特殊选择等脚本、4类特殊接取入口及任务1001006的抽蛋钩子仍不支持。部分技能、触发器与场地机制尚未实现;战斗记录缺少名称时仍可能显示任务/关卡编号或内部结果 `local`。客户端热更新与当前账号资源是否一致尚未验证。
账号凭据、策略、地图缓存、购蛋/扫荡记录及统计数据库均保存在本机 `local_state/ranch_helper/`,按账号和角色隔离。
桌面账号凭据、策略、地图缓存、购蛋/扫荡记录及统计数据库保存在本机 `local_state/ranch_helper/`;Web 使用独立的 `local_state/ranch_web/`(Docker 为 `/data`),均按账号和角色隔离。
v1.2.0 功能基线回归为 **56个模块逐模块独立进程测试,共724项通过、0项跳过**;单进程运行整套Qt测试曾出现崩溃,不能表述为同进程整套测试成功。**本次版本号发布14项定向测试及旧 dev1 配置兼容验证通过**:正式版版本常量与导出断言已更新为1.2.0,旧 `1.2.0.dev1` 的 schema 1/2 配置导入兼容已验证;**两组有重叠,不相加**。当前桌面自动战斗固定使用内置近似模型,原 AIR 仅作离线研究,不是桌面可选运行时。历史阶段记录见[实施验证记录](analysis/V1_2_IMPLEMENTATION.md#验证记录),当前验收范围见[验收清单](analysis/V1_2_ACCEPTANCE_CHECKLIST.md)。本地模拟结果不代表真实账号通关、服务器接受结算或全部关卡支持。**本轮未调用真实游戏 API,未完成真实账号任务、开战、结算、领奖与资源消耗验收**;软件在用户开启策略后,可按配置和能力检查自动执行已支持操作。
详细配置与实现范围见[辅助使用说明](ranch_assistant/README.md)。
## 项目目录与测试
- `ranch_assistant/`:原生 PySide6 界面、登录会话、手动孵蛋规则、牧场管理及测试。
- `ranch_web/`:Web 工作台、独立账号后台、管理登录、策略与日志接口。
- `deploy/web/`:Docker 部署、宿主机受控更新与历史验证记录。
- `analysis/`:接口清单、行为分析、原始反编译源码及部分审计证据。
- `tools/`:本地资料提取、接口清单生成和历史分析工具。
- `backend/`:早期的独立本地接口原型,不是辅助连接的官方服务。
@@ -120,17 +149,6 @@ python -B -m unittest ranch_assistant.tests.test_battle_simulator -v
原始 APK、构建包、第三方工具、签名材料、账号会话、
密码、数据库、截图和运行日志均由 `.gitignore` 排除;账户数据仍保存在本机。
## 适配版本
| 辅助版本 | 《牧羊人之心》Android 客户端版本 | 状态 |
| --- | --- | --- |
| 1.2.0(`v1.2.0`) | 1.9.68 | 当前版本;功能、模型及验收限制见上文 |
| 1.1.1(`v1.1.1`) | 1.9.68 | 历史正式版本,1.1系列修复与界面更新 |
| 1.1.0(`v1.1.0`) | 1.9.68 | 已发布版本 |
| 1.0.0(`v1.0.0`) | 1.9.68 | 已发布版本 |
本表仅记录已经分析、测试的版本对应关系,不代表对其他客户端版本的兼容承诺。
## v1.2 实现与研究记录
[实施与阶段交接](analysis/V1_2_IMPLEMENTATION.md)与[方案与阶段状态](analysis/V1_2_PLAN.md)保留开发阶段的能力、测试证据和客户端调用链研究;其中版本状态与运行时方案是历史记录,正式版当前范围以本页、[使用说明](ranch_assistant/README.md)和[验收清单](analysis/V1_2_ACCEPTANCE_CHECKLIST.md)为准。