release: prepare Web 2.0.0
This commit is contained in:
+1
-1
@@ -1,6 +1,6 @@
|
|||||||
FROM python:3.12-slim-bookworm
|
FROM python:3.12-slim-bookworm
|
||||||
|
|
||||||
ARG WEB_VERSION=2.0.0.dev1
|
ARG WEB_VERSION=2.0.0
|
||||||
ARG VCS_REF=unknown
|
ARG VCS_REF=unknown
|
||||||
LABEL org.opencontainers.image.source="https://github.com/attilanet/myrzx_bot" \
|
LABEL org.opencontainers.image.source="https://github.com/attilanet/myrzx_bot" \
|
||||||
org.opencontainers.image.title="myrzx_bot Web" \
|
org.opencontainers.image.title="myrzx_bot Web" \
|
||||||
|
|||||||
@@ -1,10 +1,26 @@
|
|||||||
# 牧羊人之心Bot
|
# 牧羊人之心Bot
|
||||||
|
|
||||||
原生 PySide6 桌面辅助,当前正式版本 **1.2.0**(`v1.2.0`),适配资料基线为《牧羊人之心》Android **1.9.68**。
|
当前 Web 正式版本 **2.0.0**,源码入口为 `main`;原生 PySide6 桌面正式版本保留 **1.2.0**(`v1.2.0`)。两者的适配资料基线均为《牧羊人之心》Android **1.9.68**。
|
||||||
支持多账号独立运行、牧场培养、每日事务、自动扫荡及本地掉落分析;1.2.0 增加主线与委托推进、内置模拟挑战、潜能突破和自动探险等功能,能力与验证限制见下文。
|
支持多账号独立运行、牧场培养、每日事务、主线与委托推进、近似战斗模拟、探险、扫荡及本地掉落分析,能力与验证限制见下文。
|
||||||
|
|
||||||
## 运行指引
|
## 运行指引
|
||||||
|
|
||||||
|
### 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` 命令可用。
|
1. 在 Windows 中安装 Python 3,并确保 `python` 命令可用。
|
||||||
2. 在项目目录执行 `python -m pip install -r ranch_assistant/requirements.txt`,安装 PySide6 等依赖。
|
2. 在项目目录执行 `python -m pip install -r ranch_assistant/requirements.txt`,安装 PySide6 等依赖。
|
||||||
3. 双击项目根目录下的 `Start_Ranch_Helper.cmd` 启动辅助。
|
3. 双击项目根目录下的 `Start_Ranch_Helper.cmd` 启动辅助。
|
||||||
@@ -14,20 +30,31 @@
|
|||||||
也可以在项目目录运行 `python -m ranch_assistant` 启动。
|
也可以在项目目录运行 `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`。
|
本表记录适配资料基线,不代表其他客户端版本兼容或全部功能已完成实机验收。Docker 镜像以标签流水线成功结果为准,在线更新依赖对应 GitHub Release 条目;详见 [部署说明](deploy/web/README.md)。
|
||||||
- Web 使用原生 HTML/CSS/ES 模块与 FastAPI,无需 Node/npm 或 PySide6;数据独立保存在 `local_state/ranch_web`。
|
|
||||||
- Linux:提供单服务 Docker、`/data` 持久化及宿主机受控更新;只接官方稳定 `v2.x.y`,默认只通知,未配置执行器时仅检查。
|
|
||||||
- 配置管理密码后,先进入独立 `/login` 页面,登录后才能打开工作台;退出管理登录或会话失效后返回登录页。
|
|
||||||
|
|
||||||
本地虚拟环境、离线演示与环境配置见 [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 当前实现(战斗能力范围见下文) |
|
| 模块 | 1.2.0 当前实现(战斗能力范围见下文) |
|
||||||
| --- | --- |
|
| --- | --- |
|
||||||
@@ -97,13 +124,15 @@
|
|||||||
“每点体力数量”按已知消耗样本的物品总量除以实际扣除体力计算,未知消耗不参与。
|
“每点体力数量”按已知消耗样本的物品总量除以实际扣除体力计算,未知消耗不参与。
|
||||||
资料包含1178个关卡和2079种道具名称;v1.2 的独立任务资料另含1165个任务、337个NPC和4269份剧情脚本,其中4239份属于已支持的线性类别,主线引用的720份中有718份属于该类别。脚本分类数量不代表任务或战斗全部通过;30份特殊选择等脚本、4类特殊接取入口及任务1001006的抽蛋钩子仍不支持。部分技能、触发器与场地机制尚未实现;战斗记录缺少名称时仍可能显示任务/关卡编号或内部结果 `local`。客户端热更新与当前账号资源是否一致尚未验证。
|
资料包含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,未完成真实账号任务、开战、结算、领奖与资源消耗验收**;软件在用户开启策略后,可按配置和能力检查自动执行已支持操作。
|
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/README.md)。
|
||||||
|
|
||||||
## 项目目录与测试
|
## 项目目录与测试
|
||||||
|
|
||||||
- `ranch_assistant/`:原生 PySide6 界面、登录会话、手动孵蛋规则、牧场管理及测试。
|
- `ranch_assistant/`:原生 PySide6 界面、登录会话、手动孵蛋规则、牧场管理及测试。
|
||||||
|
- `ranch_web/`:Web 工作台、独立账号后台、管理登录、策略与日志接口。
|
||||||
|
- `deploy/web/`:Docker 部署、宿主机受控更新与历史验证记录。
|
||||||
- `analysis/`:接口清单、行为分析、原始反编译源码及部分审计证据。
|
- `analysis/`:接口清单、行为分析、原始反编译源码及部分审计证据。
|
||||||
- `tools/`:本地资料提取、接口清单生成和历史分析工具。
|
- `tools/`:本地资料提取、接口清单生成和历史分析工具。
|
||||||
- `backend/`:早期的独立本地接口原型,不是辅助连接的官方服务。
|
- `backend/`:早期的独立本地接口原型,不是辅助连接的官方服务。
|
||||||
@@ -120,17 +149,6 @@ python -B -m unittest ranch_assistant.tests.test_battle_simulator -v
|
|||||||
原始 APK、构建包、第三方工具、签名材料、账号会话、
|
原始 APK、构建包、第三方工具、签名材料、账号会话、
|
||||||
密码、数据库、截图和运行日志均由 `.gitignore` 排除;账户数据仍保存在本机。
|
密码、数据库、截图和运行日志均由 `.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 实现与研究记录
|
## v1.2 实现与研究记录
|
||||||
|
|
||||||
[实施与阶段交接](analysis/V1_2_IMPLEMENTATION.md)与[方案与阶段状态](analysis/V1_2_PLAN.md)保留开发阶段的能力、测试证据和客户端调用链研究;其中版本状态与运行时方案是历史记录,正式版当前范围以本页、[使用说明](ranch_assistant/README.md)和[验收清单](analysis/V1_2_ACCEPTANCE_CHECKLIST.md)为准。
|
[实施与阶段交接](analysis/V1_2_IMPLEMENTATION.md)与[方案与阶段状态](analysis/V1_2_PLAN.md)保留开发阶段的能力、测试证据和客户端调用链研究;其中版本状态与运行时方案是历史记录,正式版当前范围以本页、[使用说明](ranch_assistant/README.md)和[验收清单](analysis/V1_2_ACCEPTANCE_CHECKLIST.md)为准。
|
||||||
|
|||||||
+2
-2
@@ -1,11 +1,11 @@
|
|||||||
name: ranch-web
|
name: ranch-web
|
||||||
services:
|
services:
|
||||||
web:
|
web:
|
||||||
image: ${RANCH_WEB_IMAGE:-ghcr.io/attilanet/myrzx_bot-web:dev}
|
image: ${RANCH_WEB_IMAGE:-ghcr.io/attilanet/myrzx_bot-web:v2.0.0}
|
||||||
build:
|
build:
|
||||||
context: .
|
context: .
|
||||||
args:
|
args:
|
||||||
WEB_VERSION: ${RANCH_WEB_BUILD_VERSION:-2.0.0.dev1}
|
WEB_VERSION: ${RANCH_WEB_BUILD_VERSION:-2.0.0}
|
||||||
user: "10001:10001"
|
user: "10001:10001"
|
||||||
init: true
|
init: true
|
||||||
restart: unless-stopped
|
restart: unless-stopped
|
||||||
|
|||||||
@@ -1,12 +1,12 @@
|
|||||||
# Web 2 Linux Docker 部署与更新
|
# Web 2.0.0 Linux Docker 部署与更新
|
||||||
|
|
||||||
本目录对应 `develop/v2.0.0`、`2.0.0.dev1`,当前仍是开发版本。以下正式镜像命令仅在官方发布对应稳定 `v2.x.y` 后可用;没有 Web 2 正式发布时,更新检查明确返回“暂无正式版”,不会安装旧桌面 1.2.0。开发分支不发布稳定镜像,不自动更新服务器。
|
本目录对应 Web 正式版本 `2.0.0`,源码入口 `main`;游戏资料基线为 `1.9.68`,桌面版保留 `1.2.0`。Docker 镜像以稳定 `v2.x.y` 标签流水线成功结果为准,以下 pull 命令仅在对应镜像已发布且可访问后可用。在线更新依赖对应 GitHub Release 条目;仅有 merge/tag 时可能仍显示“暂无正式版”,不会安装旧桌面 1.2.0。
|
||||||
|
|
||||||
## 容器与持久化
|
## 容器与持久化
|
||||||
|
|
||||||
需要 Linux、Docker Engine、带 `up --wait --wait-timeout` 和 `pull --policy` 的 Docker Compose v2。宿主机更新器另需 Python 3.12+(仅标准库)。镜像使用 Python 3.12,无 PySide6、Node 或 npm,单服务、单 Uvicorn worker;账号由应用内独立线程并行。
|
需要 Linux、Docker Engine、带 `up --wait --wait-timeout` 和 `pull --policy` 的 Docker Compose v2。宿主机更新器另需 Python 3.12+(仅标准库)。镜像使用 Python 3.12,无 PySide6、Node 或 npm,单服务、单 Uvicorn worker;账号由应用内独立线程并行。
|
||||||
|
|
||||||
将审核后的项目源码放在 `/opt/ranch-web`,项目、Python 源码、Compose 及部署配置由 root 持有,且禁止其他用户写入。以下路径适用于全新部署,持久化账号目录使用单独的 UID/GID 10001:
|
将审核后的 `main` 项目源码放在 `/opt/ranch-web`,项目、Python 源码、Compose 及部署配置由 root 持有,且禁止其他用户写入。以下路径适用于全新部署,持久化账号目录使用单独的 UID/GID 10001:
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
cd /opt/ranch-web
|
cd /opt/ranch-web
|
||||||
@@ -17,7 +17,7 @@ sudo install -m 0600 -o root -g root deploy/web/image.env.example .image.env
|
|||||||
sudoedit .env .image.env
|
sudoedit .env .image.env
|
||||||
```
|
```
|
||||||
|
|
||||||
在 `.env` 填入独立的 `RANCH_WEB_PASSWORD`,这是 Web 管理密码,不是游戏密码;`.image.env` 填入已正式发布的完整镜像,例如 `RANCH_WEB_IMAGE=ghcr.io/attilanet/myrzx_bot-web:v2.0.0`。Compose 默认只发布到宿主机 `127.0.0.1:8765`,容器内监听 `0.0.0.0:8765` 并强制管理密码。使用域名反代时,同时配置 `RANCH_WEB_ALLOWED_HOSTS` 与 `RANCH_WEB_ALLOWED_ORIGINS`;TLS 入口设置 `RANCH_WEB_SECURE_COOKIE=true`。代理保留正确的 Host,写请求依赖来源校验。
|
在 `.env` 填入独立的 `RANCH_WEB_PASSWORD`,这是 Web 管理密码,不是游戏密码;`.image.env` 示例默认 `RANCH_WEB_IMAGE=ghcr.io/attilanet/myrzx_bot-web:v2.0.0`,需确认对应镜像已发布后再 pull。Compose 默认只发布到宿主机 `127.0.0.1:8765`,容器内监听 `0.0.0.0:8765` 并强制管理密码。使用域名反代时,同时配置 `RANCH_WEB_ALLOWED_HOSTS` 与 `RANCH_WEB_ALLOWED_ORIGINS`;TLS 入口设置 `RANCH_WEB_SECURE_COOKIE=true`。代理保留正确的 Host,写请求依赖来源校验。
|
||||||
|
|
||||||
`/opt/ranch-web/data` 挂到容器 `/data`,包括账号、加密会话与密钥、配置、SQLite 统计和更新请求;独立于桌面数据。心跳控制目录独立只读挂到 `/run/ranch-updater`。使用 bind mount 的目录必须预先创建,Compose 不会悄悄创建 root 所有、容器无法写入的目录。默认容器用户 `10001:10001`,根文件系统只读,临时文件写到 `/tmp`。不要对现有账号目录重新初始化密钥。
|
`/opt/ranch-web/data` 挂到容器 `/data`,包括账号、加密会话与密钥、配置、SQLite 统计和更新请求;独立于桌面数据。心跳控制目录独立只读挂到 `/run/ranch-updater`。使用 bind mount 的目录必须预先创建,Compose 不会悄悄创建 root 所有、容器无法写入的目录。默认容器用户 `10001:10001`,根文件系统只读,临时文件写到 `/tmp`。不要对现有账号目录重新初始化密钥。
|
||||||
|
|
||||||
@@ -30,11 +30,11 @@ sudo sh deploy/web/compose.sh ps
|
|||||||
curl --fail http://127.0.0.1:8765/api/health
|
curl --fail http://127.0.0.1:8765/api/health
|
||||||
```
|
```
|
||||||
|
|
||||||
脚本固定读取 `.env` 与 `.image.env`,相当于 `docker compose --project-name ranch-web --env-file .env --env-file .image.env --file compose.yaml ...`。更新器会持久化已选镜像到 `.image.env`,之后也应通过此脚本启动,以免误用默认开发镜像。
|
脚本固定读取 `.env` 与 `.image.env`,相当于 `docker compose --project-name ranch-web --env-file .env --env-file .image.env --file compose.yaml ...`。更新器会持久化已选镜像到 `.image.env`,之后也应通过此脚本启动,以免误用默认镜像版本。
|
||||||
|
|
||||||
GitHub 首次创建 GHCR 包可能为私有;仓库管理员可将 `myrzx_bot-web` 包设为 Public。私有包部署需操作者先在宿主机执行 `sudo docker login ghcr.io`,使用具备 `read:packages` 的凭据;不要把 registry 凭据交给 Web 容器。[GHCR 官方文档](https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-container-registry)
|
GitHub 首次创建 GHCR 包可能为私有;仓库管理员可将 `myrzx_bot-web` 包设为 Public。私有包部署需操作者先在宿主机执行 `sudo docker login ghcr.io`,使用具备 `read:packages` 的凭据;不要把 registry 凭据交给 Web 容器。[GHCR 官方文档](https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-container-registry)
|
||||||
|
|
||||||
若目前只在 Linux 上验证开发分支,将 `.image.env` 保持 `:dev`,本地构建后启动;这不会发布镜像:
|
若仅在 Linux 上验证审核后的 `main` 源码,可在本地构建后启动;这不会发布镜像,也不要求远端已有对应镜像:
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
sudo sh deploy/web/compose.sh build web
|
sudo sh deploy/web/compose.sh build web
|
||||||
|
|||||||
@@ -1,2 +1,2 @@
|
|||||||
# Development builds are local only. Set a real published v2.x.y for production.
|
# Pull only after the v2.0.0 image publishing workflow succeeds and the image is available.
|
||||||
RANCH_WEB_IMAGE=ghcr.io/attilanet/myrzx_bot-web:dev
|
RANCH_WEB_IMAGE=ghcr.io/attilanet/myrzx_bot-web:v2.0.0
|
||||||
|
|||||||
@@ -1,8 +1,8 @@
|
|||||||
# 牧羊人之心牧场助手 · Web
|
# 牧羊人之心牧场助手 · Web 2.0.0
|
||||||
|
|
||||||
## 产品约束
|
## 产品约束
|
||||||
|
|
||||||
把现有桌面助手的功能和操作结构迁移至单管理员 Web 工作台。桌面版是页面顺序、信息密度、业务名称、保护条件与交互的依据,保留桌面兼容。版本为 `2.0.0.dev1`,游戏数据版本 `1.9.68`;本次不合并 main、不发布正式版本。
|
把现有桌面助手的功能和操作结构迁移至单管理员 Web 工作台。桌面版是页面顺序、信息密度、业务名称、保护条件与交互的依据,保留桌面兼容。Web 正式版本为 `2.0.0`,源码入口 `main`,游戏数据版本 `1.9.68`;桌面正式版保留 `1.2.0`。启动与配置见 [运行说明](README.md),Docker 与更新条件见 [部署说明](../deploy/web/README.md)。
|
||||||
|
|
||||||
使用者在 Windows 本机配置、验证,随后可在 Linux Docker 常驻运行。多个浏览器访问同一个管理员工作台;账号互相隔离,各账号串行执行,账号之间可以并行。
|
使用者在 Windows 本机配置、验证,随后可在 Linux Docker 常驻运行。多个浏览器访问同一个管理员工作台;账号互相隔离,各账号串行执行,账号之间可以并行。
|
||||||
|
|
||||||
|
|||||||
+7
-5
@@ -1,6 +1,6 @@
|
|||||||
# Web 2 开发运行
|
# Web 2.0.0 运行说明
|
||||||
|
|
||||||
Web 包版本 **2.0.0.dev1**,游戏资料基线 **1.9.68**,开发分支 `develop/v2.0.0`。当前正式桌面版仍为 1.2.0;Web 未合并 main、未发布正式版本。桌面入口 `python -m ranch_assistant` 保留,Web 使用独立依赖与数据根。
|
Web 正式版本 **2.0.0**,源码入口 `main`,游戏资料基线 **1.9.68**。桌面正式版保留 **1.2.0**,入口为 `python -m ranch_assistant`;Web 使用独立依赖与数据根。
|
||||||
|
|
||||||
Web 采用 FastAPI / Uvicorn 和原生 HTML/CSS/ES 模块,无 Node、npm 或前端编译步骤,不安装 PySide6。页面和策略能力沿用现有核心,详细业务范围与原有限制见 [桌面使用说明](../ranch_assistant/README.md)。多浏览器连接同一个管理员工作台;一个服务实例内,各账号独立线程并行,同一账号操作串行。
|
Web 采用 FastAPI / Uvicorn 和原生 HTML/CSS/ES 模块,无 Node、npm 或前端编译步骤,不安装 PySide6。页面和策略能力沿用现有核心,详细业务范围与原有限制见 [桌面使用说明](../ranch_assistant/README.md)。多浏览器连接同一个管理员工作台;一个服务实例内,各账号独立线程并行,同一账号操作串行。
|
||||||
|
|
||||||
@@ -10,9 +10,9 @@ Web 采用 FastAPI / Uvicorn 和原生 HTML/CSS/ES 模块,无 Node、npm 或
|
|||||||
- [x] 保留账号页签、顶部数值与统一启停、可调日志;规则自动保存,配置与统计按账号/角色隔离,重启、恢复会话及导入策略后保持停止。
|
- [x] 保留账号页签、顶部数值与统一启停、可调日志;规则自动保存,配置与统计按账号/角色隔离,重启、恢复会话及导入策略后保持停止。
|
||||||
- [x] Windows Python 启动与离线演示;Web 导入链和依赖不使用 Qt,无 Node 构建步骤。
|
- [x] Windows Python 启动与离线演示;Web 导入链和依赖不使用 Qt,无 Node 构建步骤。
|
||||||
- [x] 提供 Linux Docker 与稳定 2.x 受控更新、停机备份及失败回滚脚本;已完成 Linux Docker 部署、持久化权限、健康检查和定时更新检查烟测。
|
- [x] 提供 Linux Docker 与稳定 2.x 受控更新、停机备份及失败回滚脚本;已完成 Linux Docker 部署、持久化权限、健康检查和定时更新检查烟测。
|
||||||
- [x] 开发版本为 `2.0.0.dev1`,保留桌面兼容,不等同正式发布或真实游戏 API 验收。
|
- [x] 正式版本为 `2.0.0`,保留桌面兼容;战斗模拟为近似模型,特殊关卡并非全部支持,真实游戏 API 验收范围不因版本号变更而扩大。
|
||||||
|
|
||||||
## Windows 本地开发
|
## Windows 本地运行
|
||||||
|
|
||||||
使用 Python 3.12+,在项目根目录执行(本机已安装 3.13):
|
使用 Python 3.12+,在项目根目录执行(本机已安装 3.13):
|
||||||
|
|
||||||
@@ -77,7 +77,9 @@ Web 检查固定官方 GitHub Releases 的稳定 `v2.x.y`,跳过桌面 1.x、
|
|||||||
|
|
||||||
## 离线验证
|
## 离线验证
|
||||||
|
|
||||||
本次后台连接与日志修复:Web 后端 **245 项中 244 通过、1 项因 Windows 符号链接权限跳过**,浏览器 **31 项全部通过**;独立故障重放四组通过。行为与证据边界见 [连接修复说明](../analysis/WEB_CONNECTION_FIX.md)。现有后端命令追加 `ranch_web.tests.test_base_path ranch_web.tests.test_activity ranch_web.tests.test_connection_state`,浏览器命令追加 `ranch_web.tests.browser.test_base_path_browser ranch_web.tests.browser.test_connection_browser.ConnectionBrowserTests` 可覆盖本次回归。
|
2.0.0 发布整理本轮仅调整版本元数据,API 策略与行为未改;完整 Web 后端回归 **246 项:245 通过、1 项因 Windows 符号链接权限跳过、0 失败**。以下保留此前功能提交及开发阶段的验证记录。
|
||||||
|
|
||||||
|
前一功能提交的后台连接与日志修复:Web 后端 **245 项中 244 通过、1 项因 Windows 符号链接权限跳过**,浏览器 **31 项全部通过(本轮未重跑)**;独立故障重放四组通过。行为与证据边界见 [连接修复说明](../analysis/WEB_CONNECTION_FIX.md)。现有后端命令追加 `ranch_web.tests.test_base_path ranch_web.tests.test_activity ranch_web.tests.test_connection_state`,浏览器命令追加 `ranch_web.tests.browser.test_base_path_browser ranch_web.tests.browser.test_connection_browser.ConnectionBrowserTests` 可覆盖该功能回归。
|
||||||
|
|
||||||
独立管理登录页调整后的完整非浏览器后端验证为 **193项:192通过、1跳过(Windows符号链接权限),0失败/错误,用时26.994秒**。以下命令显式列出全部10个后端模块,避免发现并混入浏览器测试:
|
独立管理登录页调整后的完整非浏览器后端验证为 **193项:192通过、1跳过(Windows符号链接权限),0失败/错误,用时26.994秒**。以下命令显式列出全部10个后端模块,避免发现并混入浏览器测试:
|
||||||
|
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
"""Headless Web workspace for the ranch assistant."""
|
"""Headless Web workspace for the ranch assistant."""
|
||||||
|
|
||||||
__version__ = "2.0.0.dev1"
|
__version__ = "2.0.0"
|
||||||
GAME_VERSION = "1.9.68"
|
GAME_VERSION = "1.9.68"
|
||||||
|
|
||||||
__all__ = ["__version__", "GAME_VERSION"]
|
__all__ = ["__version__", "GAME_VERSION"]
|
||||||
|
|||||||
@@ -17,6 +17,8 @@ from ranch_assistant.progression import ProgressionPolicy
|
|||||||
from ranch_assistant.exploration import ExplorePolicy
|
from ranch_assistant.exploration import ExplorePolicy
|
||||||
from ranch_assistant import policy_io
|
from ranch_assistant import policy_io
|
||||||
|
|
||||||
|
from . import __version__
|
||||||
|
|
||||||
|
|
||||||
POLICY_CLASSES = {
|
POLICY_CLASSES = {
|
||||||
"policy": Policy, "quest_policy": QuestPolicy, "daily_policy": DailyPolicy,
|
"policy": Policy, "quest_policy": QuestPolicy, "daily_policy": DailyPolicy,
|
||||||
@@ -217,7 +219,7 @@ def apply_config(engine, config):
|
|||||||
|
|
||||||
def export_config(config, snapshot=None):
|
def export_config(config, snapshot=None):
|
||||||
value = policy_io.portable_config(validate_config(config), snapshot)
|
value = policy_io.portable_config(validate_config(config), snapshot)
|
||||||
value["assistantVersion"] = "2.0.0.dev1"
|
value["assistantVersion"] = __version__
|
||||||
return value
|
return value
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
@@ -372,7 +372,7 @@ async function exportYields(account=current()) {
|
|||||||
async function command(name,account=current()) {
|
async function command(name,account=current()) {
|
||||||
try {
|
try {
|
||||||
if(name==='add-account'||name==='add-demo')return await addAccount(name==='add-demo');
|
if(name==='add-account'||name==='add-demo')return await addAccount(name==='add-demo');
|
||||||
if(name==='about')return dialog('关于牧场助手',el('div',{},el('p',{text:`牧羊人之心牧场助手 Web ${state.meta?.version || '2.0.0.dev1'}`}),el('p',{text:`游戏数据版本 ${state.meta?.gameVersion || '1.9.68'}`}),el('p',{class:'info-note',text:'与桌面助手共用核心策略。配置在服务端自动保存;运行开关在重启和恢复会话后保持关闭。'})),{info:true});
|
if(name==='about')return dialog('关于牧场助手',el('div',{},el('p',{text:`牧羊人之心牧场助手 Web ${state.meta?.version || '2.0.0'}`}),el('p',{text:`游戏数据版本 ${state.meta?.gameVersion || '1.9.68'}`}),el('p',{class:'info-note',text:'与桌面助手共用核心策略。配置在服务端自动保存;运行开关在重启和恢复会话后保持关闭。'})),{info:true});
|
||||||
if(name==='updates')return await showUpdates();
|
if(name==='updates')return await showUpdates();
|
||||||
if(name==='admin-logout'){hideWorkbench();try{await api.logout();}finally{requireAuth();}return;}
|
if(name==='admin-logout'){hideWorkbench();try{await api.logout();}finally{requireAuth();}return;}
|
||||||
if(!account)throw new Error('请先新增或选择账号。');
|
if(!account)throw new Error('请先新增或选择账号。');
|
||||||
@@ -575,7 +575,7 @@ async function bootstrap() {
|
|||||||
$('#app').hidden=false;
|
$('#app').hidden=false;
|
||||||
const [meta,schema]=await Promise.all([api.meta(),api.schema()]);state.meta=meta;state.schema=schema;
|
const [meta,schema]=await Promise.all([api.meta(),api.schema()]);state.meta=meta;state.schema=schema;
|
||||||
if(state.redirecting)return;
|
if(state.redirecting)return;
|
||||||
$('#app-version').textContent=meta.version || '2.0.0.dev1';$('#game-version').textContent=meta.gameVersion || '1.9.68';$('#access-mode').textContent=auth.access_mode==='local'||auth.access_mode==='loopback'?'本机工作台':auth.required?'管理工作台':'本机工作台';
|
$('#app-version').textContent=meta.version || '2.0.0';$('#game-version').textContent=meta.gameVersion || '1.9.68';$('#access-mode').textContent=auth.access_mode==='local'||auth.access_mode==='loopback'?'本机工作台':auth.required?'管理工作台':'本机工作台';
|
||||||
await syncAccounts();if(state.redirecting)return;state.ready=true;setStatus('工作台已连接');
|
await syncAccounts();if(state.redirecting)return;state.ready=true;setStatus('工作台已连接');
|
||||||
}catch(failure){if(failure.status===401||$('#app').hidden){requireAuth();return;}if(state.redirecting)return;setStatus(failure.message);$('#page-host').replaceChildren(el('div',{class:'initial-state'},el('p',{text:failure.message}),el('button',{text:'重新连接',onClick:bootstrap})));}
|
}catch(failure){if(failure.status===401||$('#app').hidden){requireAuth();return;}if(state.redirecting)return;setStatus(failure.message);$('#page-host').replaceChildren(el('div',{class:'initial-state'},el('p',{text:failure.message}),el('button',{text:'重新连接',onClick:bootstrap})));}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -26,7 +26,7 @@
|
|||||||
</div></details>
|
</div></details>
|
||||||
<details class="menu"><summary accesskey="h">帮助<span class="access-key">(H)</span></summary><div class="menu-popup"><button data-command="updates">检查版本更新…</button><button data-command="debug">调试日志</button><button data-command="about">关于…</button></div></details>
|
<details class="menu"><summary accesskey="h">帮助<span class="access-key">(H)</span></summary><div class="menu-popup"><button data-command="updates">检查版本更新…</button><button data-command="debug">调试日志</button><button data-command="about">关于…</button></div></details>
|
||||||
</nav>
|
</nav>
|
||||||
<span class="window-title">牧羊人之心牧场助手 <span id="app-version">2.0.0.dev1</span></span>
|
<span class="window-title">牧羊人之心牧场助手 <span id="app-version">2.0.0</span></span>
|
||||||
<span id="access-mode" class="muted">正在连接本地服务</span>
|
<span id="access-mode" class="muted">正在连接本地服务</span>
|
||||||
</header>
|
</header>
|
||||||
<div class="account-bar"><div id="account-tabs" class="account-tabs" role="tablist" aria-label="账号"></div><button id="add-account" class="compact" title="新增账号">+ 新增账号</button></div>
|
<div class="account-bar"><div id="account-tabs" class="account-tabs" role="tablist" aria-label="账号"></div><button id="add-account" class="compact" title="新增账号">+ 新增账号</button></div>
|
||||||
|
|||||||
@@ -18,6 +18,7 @@ from unittest.mock import patch
|
|||||||
import httpx
|
import httpx
|
||||||
from fastapi.testclient import TestClient
|
from fastapi.testclient import TestClient
|
||||||
|
|
||||||
|
from ranch_web import __version__
|
||||||
from ranch_web.app import create_app
|
from ranch_web.app import create_app
|
||||||
from ranch_web.config import WebConfig
|
from ranch_web.config import WebConfig
|
||||||
|
|
||||||
@@ -134,7 +135,7 @@ class ApiTests(unittest.TestCase):
|
|||||||
|
|
||||||
def test_health_meta_and_updates_have_no_game_side_effects(self):
|
def test_health_meta_and_updates_have_no_game_side_effects(self):
|
||||||
self.manager.calls.clear()
|
self.manager.calls.clear()
|
||||||
self.assertEqual(self.client.get("/api/health").json(), {"status": "ok", "version": "2.0.0.dev1"})
|
self.assertEqual(self.client.get("/api/health").json(), {"status": "ok", "version": __version__})
|
||||||
meta = self.client.get("/api/meta")
|
meta = self.client.get("/api/meta")
|
||||||
self.assertEqual(meta.status_code, 200)
|
self.assertEqual(meta.status_code, 200)
|
||||||
self.assertEqual(meta.json()["gameVersion"], "1.9.68")
|
self.assertEqual(meta.json()["gameVersion"], "1.9.68")
|
||||||
@@ -273,7 +274,7 @@ class ApiTests(unittest.TestCase):
|
|||||||
self.assertEqual(client.get(prefix + "/config").json()["config"]["interval"], 60)
|
self.assertEqual(client.get(prefix + "/config").json()["config"]["interval"], 60)
|
||||||
exported = client.get(prefix + "/config/export")
|
exported = client.get(prefix + "/config/export")
|
||||||
document = poll(exported.json()["id"])["result"]
|
document = poll(exported.json()["id"])["result"]
|
||||||
self.assertEqual(document["assistantVersion"], "2.0.0.dev1")
|
self.assertEqual(document["assistantVersion"], __version__)
|
||||||
imported = client.post(prefix + "/config/import", json=document)
|
imported = client.post(prefix + "/config/import", json=document)
|
||||||
self.assertEqual(imported.status_code, 202)
|
self.assertEqual(imported.status_code, 202)
|
||||||
poll(imported.json()["id"])
|
poll(imported.json()["id"])
|
||||||
|
|||||||
@@ -11,6 +11,7 @@ from unittest.mock import patch
|
|||||||
import httpx
|
import httpx
|
||||||
from fastapi.testclient import TestClient
|
from fastapi.testclient import TestClient
|
||||||
|
|
||||||
|
from ranch_web import __version__
|
||||||
from ranch_web.app import create_app
|
from ranch_web.app import create_app
|
||||||
from ranch_web.config import COOKIE_NAME, WebConfig, hash_password, verify_password
|
from ranch_web.config import COOKIE_NAME, WebConfig, hash_password, verify_password
|
||||||
from ranch_web.tests.test_api import FakeManager, FakeUpdates
|
from ranch_web.tests.test_api import FakeManager, FakeUpdates
|
||||||
@@ -315,7 +316,7 @@ class AuthTests(unittest.TestCase):
|
|||||||
def test_admin_password_does_not_corrupt_public_identifiers_or_versions(self):
|
def test_admin_password_does_not_corrupt_public_identifiers_or_versions(self):
|
||||||
client = self.client(WebConfig(data_dir=self.root, password="1"))
|
client = self.client(WebConfig(data_dir=self.root, password="1"))
|
||||||
self.assertEqual(client.post("/api/auth/login", json={"password": "1"}).status_code, 200)
|
self.assertEqual(client.post("/api/auth/login", json={"password": "1"}).status_code, 200)
|
||||||
self.assertEqual(client.get("/api/meta").json()["version"], "2.0.0.dev1")
|
self.assertEqual(client.get("/api/meta").json()["version"], __version__)
|
||||||
account = client.post("/api/accounts", json={"demo": True}).json()
|
account = client.post("/api/accounts", json={"demo": True}).json()
|
||||||
self.assertEqual(account["id"], "account_1")
|
self.assertEqual(account["id"], "account_1")
|
||||||
self.assertEqual(client.get("/api/accounts/account_1/status").status_code, 200)
|
self.assertEqual(client.get("/api/accounts/account_1/status").status_code, 200)
|
||||||
|
|||||||
Reference in New Issue
Block a user