Compare commits
2
Commits
a9b5f73552
...
v2.0.13
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
b976151263 | ||
|
|
598bdf5c1c |
@@ -59,6 +59,8 @@ jobs:
|
||||
PY
|
||||
- name: Install Web runtime and test dependencies
|
||||
run: python -m pip install -r ranch_web/requirements-test.txt
|
||||
- name: Offline battle loss cooldown and progression regression
|
||||
run: python -B -m unittest ranch_assistant.tests.test_battle_retry ranch_assistant.tests.test_progression_replay_loop ranch_web.tests.test_web_policies -v
|
||||
- name: Offline sweep hidden handoff, battles, and engine regression
|
||||
timeout-minutes: 3
|
||||
run: |
|
||||
@@ -111,6 +113,12 @@ jobs:
|
||||
WEB_VERSION: ${{ steps.version.outputs.version }}
|
||||
VCS_REF: ${{ github.sha }}
|
||||
run: docker build --build-arg "WEB_VERSION=$WEB_VERSION" --build-arg "VCS_REF=$VCS_REF" --tag ranch-web-smoke .
|
||||
- name: Verify image version and source revision
|
||||
env:
|
||||
VCS_REF: ${{ github.sha }}
|
||||
run: |
|
||||
docker image inspect ranch-web-smoke --format '{{json .Config.Labels}}' > /tmp/ranch-web-image-labels.json
|
||||
python -c "import json,os; from ranch_web import __version__; labels=json.load(open('/tmp/ranch-web-image-labels.json')); assert labels['org.opencontainers.image.version']==__version__; assert labels['org.opencontainers.image.revision']==os.environ['VCS_REF']"
|
||||
- name: Offline container health, persistence permissions, and graceful stop
|
||||
run: |
|
||||
docker run --detach --name ranch-web-smoke --network none --read-only \
|
||||
|
||||
+1
-1
@@ -1,6 +1,6 @@
|
||||
FROM python:3.12-slim-bookworm
|
||||
|
||||
ARG WEB_VERSION=2.0.12
|
||||
ARG WEB_VERSION=2.0.13
|
||||
ARG VCS_REF=unknown
|
||||
LABEL org.opencontainers.image.source="https://github.com/attilanet/myrzx_bot" \
|
||||
org.opencontainers.image.title="myrzx_bot Web" \
|
||||
|
||||
+136
@@ -0,0 +1,136 @@
|
||||
# ?????Web 2.0.13?2026-11-17?
|
||||
|
||||
- ???????`D:\Projects\myrzx_bot`?
|
||||
- ???????????????????3?????1?168??????????????????????????? [2.0.13 ????](analysis/RELEASE_2_0_13.md)?
|
||||
- ?????560????????558???2? Windows ???????26?????19??????
|
||||
- ??????????????????? GitHub Release + GHCR????? Gitea ?? API???????? X99?
|
||||
- ?????`origin` ? `https://gitea.witchercheung.cn/witcher/myrzx_bot.git`?`github` ? `https://github.com/AttilaNet/myrzx_bot.git`?????????????????????? `github`?
|
||||
- ?? Git Credential Manager ??? AttilaNet??? GitHub ????????????????????????
|
||||
- ???? `2.0.13`??? `v2.0.13`???????? GitHub Actions?Release??????????? SHA????????????????????
|
||||
|
||||
## ??? 2026-11-16 ? 2.0.12 ????
|
||||
|
||||
???????? remote ???????????????????????? Git ????????????????????????????
|
||||
|
||||
# 项目交接入口
|
||||
|
||||
> 整理日期:2026-11-16,Asia/Shanghai。面向没有看过历史对话的新模型。
|
||||
> 当前应用:Web **2.0.12**;游戏资料基线:Android **1.9.68**;桌面历史正式版本:**1.2.0**。
|
||||
|
||||
## 先读这些
|
||||
|
||||
1. 本文件:当前状态、工作约束、下一步。
|
||||
2. [项目上下文](docs/handoff/PROJECT_CONTEXT.md):功能、架构、关键决策和失败教训。
|
||||
3. [运维与发布交接](docs/handoff/OPERATIONS.md):运行、测试、部署、私有更新通道和凭据定位。
|
||||
4. [README](README.md)、[Web 产品约束](ranch_web/PRODUCT.md)、[2.0.12 发布说明](analysis/RELEASE_2_0_12.md)。按实际任务再读代码,不需要重新遍历全部反编译文件。
|
||||
|
||||
新窗口可以直接输入:**“先阅读 HANDOFF.md 和它链接的两份交接文档,再核对 Git 状态,继续处理我的新需求。”**
|
||||
|
||||
## 项目目标与当前状态
|
||||
|
||||
这是《牧羊人之心》单管理员、多游戏账号的 BOT。现阶段重点是 Python 后端常驻运行、Web 配置与监控、Windows 本地开发、Linux Docker 部署。用户已经放弃跨游戏平台方向,也撤回过侧边栏管理后台重设计;保留当前紧凑的多账号页签、功能 Tab 和原有底部日志布局。
|
||||
|
||||
- 应用功能基线提交:`a9b5f73552bf87efe65b4f0d6fd878bcb14dfbc9`。
|
||||
- 本地稳定标签:`v2.0.12`,指向上述功能基线;本次交接文档提交不会改变应用版本或重打该标签。
|
||||
- 2.0.12 已在原 GitHub 发布通道发布,Linux CI、GHCR 镜像和更新器资产均核验通过。
|
||||
- **没有正在进行的功能开发或待合并代码。** 此次任务仅归档上下文、切换 Git 远程并推送文档。
|
||||
- **没有手动把 2.0.12 部署到 X99。** 用户通过在线更新安装;用户尚未反馈该版本线上安装及隐藏关卡恢复的最终结果,不要声称生产已验收。
|
||||
- 工作区有用户自己的 `ranch-policies-1.2.0.dev1.json`。它原本就是未跟踪文件,禁止顺手修改、删除或加入提交。
|
||||
- 以前的子代理已经结束。没有需要接管的常驻代理、SSH 会话或未完成的实验进程。
|
||||
|
||||
## 仓库位置与 Git 迁移
|
||||
|
||||
实际项目目录是:
|
||||
|
||||
```text
|
||||
C:\Users\11789\Documents\Projects\Codex_ws\myrzx_bot
|
||||
```
|
||||
|
||||
环境或旧会话可能仍显示 `myrzx_fang`,执行命令时应显式指定实际工作目录,先核对 `git rev-parse --show-toplevel`。
|
||||
|
||||
用户于 2026-11-16 要求移除原 GitHub `origin` 的本地远程配置,将已有 `gitea` 重命名为 `origin`:
|
||||
|
||||
```text
|
||||
origin = https://gitea.witchercheung.cn/witcher/myrzx_bot.git
|
||||
```
|
||||
|
||||
- 这里只移除本地 remote,不删除 GitHub 上的仓库。
|
||||
- 后续日常提交和本次文档推送面向 Gitea `origin/main`。
|
||||
- 提交身份仍为 `AttilaNet <zbolink@foxmail.com>`,仅使用项目配置,不修改全局身份。
|
||||
- 原远程配置的本地备份在 `local_state/context_handoff/git-config.before-origin-migration.2026-11-16.private`。
|
||||
- **Git 远程迁移不等于在线更新通道迁移。** 当前应用仍检查 GitHub Release,镜像仍取 GHCR;旧发布脚本还可能假设 `origin` 是 GitHub。下一次发布先阅读运维交接,不能盲跑旧清理脚本。
|
||||
- 此次只推送文档所在的 `main`,不创建新 Release、不触发新版本标签,也不假定 Gitea 已拥有原站全部标签。
|
||||
|
||||
## 最近完成:2.0.12 隐藏关卡恢复
|
||||
|
||||
用户症状:
|
||||
|
||||
```text
|
||||
策略等待处理:扫荡(关卡 0211):遭遇隐藏关卡,请在游戏内手动战斗;禁止自动重发,请在游戏内核对结果
|
||||
```
|
||||
|
||||
根因是扫荡路径识别了隐藏事件,却没有接上已有战斗流程。原客户端的行为已经在 `StageStartPanel.as` 中核验:隐藏事件返回 `stageEvent.hideStageId` 后,取消本次扫荡模式,直接进行该隐藏关卡的**难度 1** 战斗,不再发送第二次 `stageStart`。
|
||||
|
||||
已完成的行为:
|
||||
|
||||
- 新隐藏记录持久保存入场响应、原始队伍快照及交接证据,接入现有快速 HP/DPS 模型,按战斗时钟完成结算。
|
||||
- 结算和战果记录使用隐藏关卡 ID,计数只预留一次;停止、恢复、重启和重复回包均有专门回归。
|
||||
- 普通奖励事件直接发奖,与隐藏战斗分开处理,不能把隐藏事件里的 `result` 当成已经发放的奖励。
|
||||
- 当时现场的旧记录只有父关卡 `0211`、难度 `3`、提示和 `sampleId`;原响应被日志轮转覆盖,无法还原隐藏 ID。只有满足严格证据条件的精确旧记录才会本地归档为“未完成,已放弃”,保留证据与次数,不伪造服务端结算。
|
||||
- 旧记录即使找回隐藏 ID,缺少原始队伍快照也不能拿当前属性补算,仍须保留具体中文待核对原因。
|
||||
- 真正已发送但结果未知的入场、结算、领奖等请求仍然不重放,不能为了消除提示直接删除 pending。
|
||||
|
||||
最近验证:**491 项唯一仓库测试,489 通过、2 项 Windows 预期跳过**;另外 2 项 Web 离线探针通过。两支当前队伍与 `hd01`~`hd08` 的 16 种代表组合全部获模型支持,重复试算得到 13 种胜利、3 种失败,单次约 0.4~14 毫秒。模型预测不等于实际游戏通关或线上验收。
|
||||
|
||||
## 文件定位
|
||||
|
||||
| 文件或目录 | 用途 |
|
||||
| --- | --- |
|
||||
| `ranch_web/app.py`、`service.py`、`scheduler.py`、`store.py` | HTTP、账号工作线程、常驻调度、持久化与启停意图 |
|
||||
| `ranch_web/static/`、`views.py`、`policies.py` | 当前 Web 页面、DTO、策略配置 |
|
||||
| `ranch_assistant/engine.py` | 共享业务调度、策略执行与待核对恢复 |
|
||||
| `ranch_assistant/sweeping.py`、`battles.py`、`sweep_recovery.py` | 扫荡、隐藏战斗交接、持久化请求与旧记录证据核对 |
|
||||
| `ranch_assistant/battle_simulator.py` | 现有快速近似战斗模型;不需要重新实现完整 AIR 引擎 |
|
||||
| `ranch_assistant/progression.py`、`quests.py`、`commission_history.py` | 主线、委托规划与每日历史 |
|
||||
| `ranch_assistant/cultivation.py`、`gifts.py`、`breakthrough.py`、`exploration.py` | 主培养、赠礼、潜能突破、探险 |
|
||||
| `ranch_assistant/data/` | 原版导出的静态资料与战斗配置,避免为界面显示重新请求游戏 |
|
||||
| `deploy/web/`、`.github/workflows/web-image.yml` | Docker、宿主机更新器与现有 GitHub 镜像发布流程 |
|
||||
| `analysis/RELEASE_*.md`、`analysis/as3/` | 发布说明、可按需核验的原客户端源码证据 |
|
||||
| `local_state/`、`test-artifacts/` | 本机凭据、缓存、原始快照、报告及发布辅助工具;目前不随 Git 提交 |
|
||||
|
||||
## 失败经验与稳定约束
|
||||
|
||||
- **界面改版已撤回**:不要再主动改成跨游戏平台或侧边栏后台。
|
||||
- **日志只有原来底部那一块**:当前 Tab 决定日志分类;右上角唯一开关;刷新与重新进入默认收起,不恢复总日志或新增各页日志框。
|
||||
- **运行意图与瞬时状态分开**:登录成功默认执行已勾选功能;只有用户明确“停止”才持久暂停。掉线、内部错误或待核对暂停不能伪装成用户停止,也不能仅凭心跳成功声称策略正在运行。
|
||||
- **多账号隔离、账号内串行**:快速孵化、赠礼、突破、探险定时器不能调用整个全局 poll,避免半秒一次误跑主线或扫荡。
|
||||
- **资质备用不培养**:每种主培养固定 1 只,严格更优资质备用最多 1 只;赠礼和经验只给主培养,到上限不能转喂同种备用。锁定、在队、装备、委托保留等保护不能自动解除。
|
||||
- **战斗使用现有近似模型**:用户明确要求快速公式模型,允许近似,不要重新下载 SDK 或长期折腾原生运行时。现有伤害配置的历史与限制见项目上下文;本轮没有修改参数。
|
||||
- **旧记录原始输入不可补造**:恢复必须依据入场证据;当前等级/属性不是旧战斗的原始输入。
|
||||
- **正常登录也有本地 info 日志**:`api.py` 的 `进入参数检查 / info / scope=local` 已精确兼容;不能放宽成忽略全部未知日志。
|
||||
- **Linux 子进程输入故障已修**:大 stdin 与 `communicate(timeout)` 的 POSIX 重试曾导致超时;现在用匿名临时文件传完整输入,保留取消和大小限制。
|
||||
- **CI 测试依赖要安装**:保留 `ranch_web/requirements-test.txt` 中的 HTTPX 以及工作流安装步骤;Docker 仍只安装运行依赖。
|
||||
|
||||
## 当前判断
|
||||
|
||||
最近的隐藏关卡问题已经完成离线复现、修复、独立复核与发布,当前没有新的失败现场需要继续开发。下一步应由用户安装版本并反馈实际结果;如果产生新反馈,以实际运行版本和新的原始日志为准。Git 远程切到 Gitea 已完成,线上更新通道迁移尚未实施,不能把两件事视为同一个已完成任务。
|
||||
|
||||
## 下一位模型如何接手
|
||||
|
||||
1. 确认实际目录、`git status --short --branch`、本地版本和脱敏后的 remote 目标,先了解是否有用户新增改动。
|
||||
2. 读取上述两份详细交接文档。用户提出新需求后,围绕相关模块定位;目前不用继续修一个已经发布完成的旧任务。
|
||||
3. 若用户反馈更新后仍异常,先核对**实际运行版本**、具体账号的 `strategy_requested/manual_stop/strategy_state`、原始请求与 pending 证据,再决定改动;不要把缓存页面、心跳成功、模型不支持和真实战败混为一谈。
|
||||
4. 用户长期偏好“父模型分析指挥、子代理实施、父模型独立核验”。具体实现交给职责不重叠的子代理,先复现再修复,最后检查实际测试报告和源码哈希,不只接受子代理口头通过。
|
||||
5. 离线验证可自行完成;真实游戏操作由用户控制。不主动部署 X99;正常交付方式是发布后由用户在线更新。
|
||||
6. 新发布前先解决当前 Gitea 源码仓库与原 GitHub/GHCR 发布通道的关系,再选择发布流程,不自动重建被用户移除的 GitHub remote。
|
||||
|
||||
## 验证材料与本地凭据定位
|
||||
|
||||
- 公开说明:`analysis/RELEASE_2_0_12.md`。
|
||||
- 本机完整 QA:`test-artifacts/hidden-stage-qa/final-report.md`、`final-verification.private.json`。
|
||||
- 实现冻结:`test-artifacts/hidden-sweep-final/verification.json`。
|
||||
- 最终审查:`test-artifacts/independent-hidden-review/run_20261114T043503_641431Z/review_report.json`。
|
||||
- 发布交接:`test-artifacts/releases/v2.0.12/final-handoff.json`。
|
||||
- 管理员访问记录:`local_state/deployment_x99/access.private.json`;更新通道凭据:`local_state/deployment_x99/update_credentials.private.json`。文件只在本机时,不要假定新 clone 也有。
|
||||
|
||||
以上 ignored 路径是本机证据定位,不是仓库携带的附件。新模型不需要依赖先前聊天或自动注入的记忆工具;以当前代码、这些文档及能实际读取的证据为准。
|
||||
@@ -1,11 +1,13 @@
|
||||
# 牧羊人之心Bot
|
||||
|
||||
Web **2.0.12**,源码发布入口为 `main`;原生 PySide6 桌面正式版本保留 **1.2.0**(`v1.2.0`)。两者的适配资料基线均为《牧羊人之心》Android **1.9.68**。
|
||||
Web **2.0.13**,源码发布入口为 `main`;原生 PySide6 桌面正式版本保留 **1.2.0**(`v1.2.0`)。两者的适配资料基线均为《牧羊人之心》Android **1.9.68**。
|
||||
支持多账号独立运行、牧场培养、每日事务、主线与委托推进、近似战斗模拟、探险、扫荡及本地掉落分析,能力与验证限制见下文。
|
||||
|
||||
**2.0.13** 新增战败冷却自动重试:主线与委托达到连续战败上限后,默认等待3小时,可配置1~168小时;冷却结束后重新检查队伍、资源和策略授权。冷却跨重启保留,手动停止和未知请求不重发的规则继续生效。每日委托额度耗尽时显示下次刷新时间。见 [2.0.13 发布说明](analysis/RELEASE_2_0_13.md)。
|
||||
|
||||
## 运行指引
|
||||
|
||||
### Web 2.0.12(源码发布入口 main)
|
||||
### Web 2.0.13(源码发布入口 main)
|
||||
|
||||
Windows 使用 Python 3.12+,在项目根目录执行:
|
||||
|
||||
@@ -23,7 +25,7 @@ Web 无需 Node/npm 或 PySide6,数据独立保存在 `local_state/ranch_web`
|
||||
|
||||
现场旧 pending 仅保留 `0211 / 3`、提示与 `sampleId`,原始响应已被日志轮转覆盖,无法还原隐藏关卡 ID。仅对符合精确四字段 legacy 形态、严格确认已入场且未结算的这类旧阶段,本版保留证据,在本地归档为未完成并放弃,不提交胜利或失败、不重发入场,让后续策略继续;这不表示当前生产战斗已经打通。
|
||||
|
||||
本版共 **491 项唯一仓库测试:489 通过、2 项 Windows 预期跳过,0 失败 / 错误**;历史测试不计入本版。正式镜像与稳定 Release 就绪后,由用户通过“帮助 → 检查版本更新…”在线升级,详情见 [本版发布说明](analysis/RELEASE_2_0_12.md)。
|
||||
2.0.12 历史版本共 **491 项唯一仓库测试:489 通过、2 项 Windows 预期跳过,0 失败 / 错误**;历史测试不计入本版。正式镜像与稳定 Release 就绪后,由用户通过“帮助 → 检查版本更新…”在线升级,详情见 [本版发布说明](analysis/RELEASE_2_0_12.md)。
|
||||
|
||||
沿用 2.0.11 的 Linux 战斗输入传输与按证据恢复修复。手动停止继续阻止提交,来源策略关闭时等待启用,未知已发送写请求不重放,见 [2.0.11 发布说明](analysis/RELEASE_2_0_11.md)。
|
||||
|
||||
@@ -48,7 +50,7 @@ Web 无需 Node/npm 或 PySide6,数据独立保存在 `local_state/ranch_web`
|
||||
|
||||
| 组件与版本 | 《牧羊人之心》Android 基线 | 入口与状态 |
|
||||
| --- | --- | --- |
|
||||
| Web 2.0.12 | 1.9.68 | 源码发布入口 `main`,`Start_Ranch_Web.cmd` / `sh start-web.sh` |
|
||||
| Web 2.0.13 | 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 | 历史已发布版本 |
|
||||
@@ -170,6 +172,10 @@ python -B -m unittest ranch_assistant.tests.test_battle_simulator -v
|
||||
原始 APK、构建包、第三方工具、签名材料、账号会话、
|
||||
密码、数据库、截图和运行日志均由 `.gitignore` 排除;账户数据仍保存在本机。
|
||||
|
||||
## 开发交接
|
||||
|
||||
新会话先阅读 [HANDOFF.md](HANDOFF.md),再按需查看[项目上下文](docs/handoff/PROJECT_CONTEXT.md)与[运维和发布交接](docs/handoff/OPERATIONS.md)。文档记录当前版本、历史决策、用户偏好、验证边界,以及切换至 Gitea 后的 Git 与在线更新通道关系。
|
||||
|
||||
## v1.2 实现与研究记录
|
||||
|
||||
[实施与阶段交接](analysis/V1_2_IMPLEMENTATION.md)与[方案与阶段状态](analysis/V1_2_PLAN.md)保留开发阶段的能力、测试证据和客户端调用链研究;其中版本状态与运行时方案是历史记录,正式版当前范围以本页、[使用说明](ranch_assistant/README.md)和[验收清单](analysis/V1_2_ACCEPTANCE_CHECKLIST.md)为准。
|
||||
|
||||
@@ -0,0 +1,27 @@
|
||||
# Web 2.0.13 发布说明
|
||||
|
||||
Web **2.0.13** 基于 **2.0.12**;游戏资料 **1.9.68**,桌面正式版保留 **1.2.0**。
|
||||
|
||||
## 本版范围
|
||||
|
||||
- **战败冷却后自动重试**:主线、支线及委托战斗达到配置的连续战败上限后,默认冷却3小时。新增“战败冷却时间(小时)”,支持1~168小时;Web 自动主线、自动委托共享同一设置,桌面位于“自动主线 → 推进策略”。
|
||||
- **等待时间明确**:任务阻塞原因显示北京时间的冷却截止时间。到期后重新检查策略、队伍、体力、资源和战斗支持条件,再决定是否继续;不再因历史战败计数永久阻塞。
|
||||
- **重启保留进度**:记录最近一次确认战败的时间,冷却不会因刷新或重启重新计时。没有时间戳的旧战败记录在首次读取时开始一次冷却,并持久保存;不修改任务步骤或战果。
|
||||
- **恢复缓存同步**:任务规划与战斗日志两处战败计数均能到期恢复,即使角色快照没有变化,也会重新规划。
|
||||
- **每日委托等待**:接取额度耗尽时显示下次每日刷新时间。沿用原有跨日刷新与10秒宽限逻辑,等待服务器确认后再接取,不虚增额度。
|
||||
|
||||
## 沿用约束
|
||||
|
||||
手动停止仍阻止策略执行;关闭来源策略不会被冷却恢复擅自开启。结果未知的入场、结算等请求继续保留待核对,不因冷却到期删除或重放。多账号状态继续隔离。
|
||||
|
||||
战斗继续使用现有快速近似模型和 `client_v4_x10` 伤害配置;本版不修改伤害参数,10倍伤害也不构成所有关卡必胜的保证。
|
||||
|
||||
## 验证
|
||||
|
||||
本版验证结果在发布前由实际离线回归报告填入。测试不调用真实游戏 API,不部署生产、不修改真实账号策略或 journal。
|
||||
|
||||
## 发布与升级
|
||||
|
||||
源码与同一版本标签同步到 GitHub 和 Gitea。在线更新继续使用原 GitHub Release + GHCR 通道;本版不迁移更新服务器。
|
||||
|
||||
正式镜像及稳定 Release 核验就绪后,用户在“帮助 → 检查版本更新…”发起升级。随版提供 `updater.pyz` 和 `SHA256SUMS`;升级完成后刷新网页。发布成功与生产安装验收分别核对。
|
||||
+2
-2
@@ -1,11 +1,11 @@
|
||||
name: ranch-web
|
||||
services:
|
||||
web:
|
||||
image: ${RANCH_WEB_IMAGE:-ghcr.io/attilanet/myrzx_bot-web:v2.0.12}
|
||||
image: ${RANCH_WEB_IMAGE:-ghcr.io/attilanet/myrzx_bot-web:v2.0.13}
|
||||
build:
|
||||
context: .
|
||||
args:
|
||||
WEB_VERSION: ${RANCH_WEB_BUILD_VERSION:-2.0.12}
|
||||
WEB_VERSION: ${RANCH_WEB_BUILD_VERSION:-2.0.13}
|
||||
user: "10001:10001"
|
||||
init: true
|
||||
restart: unless-stopped
|
||||
|
||||
+10
-8
@@ -1,8 +1,10 @@
|
||||
# Web 2 Linux Docker 部署与更新
|
||||
|
||||
当前应用及更新示例为 `v2.0.12`。下文首次初始化章节保留 2.0.1 流程及历史版本示例。游戏资料基线为 `1.9.68`,桌面版保留 `1.2.0`。镜像流水线成功、Git tag 与 GitHub Release 是不同的发布步骤:在线更新必须等对应镜像及非草稿、非预发布的 Release 均发布后才能使用。私有仓库未获授权返回 404 属于访问失败,不代表没有版本;只有成功读取列表且没有稳定 2.x 时才显示“暂无正式版”。
|
||||
**2.0.13** 新增战败冷却自动重试:主线与委托达到连续战败上限后,默认等待3小时,可配置1~168小时;冷却结束后重新检查队伍、资源和策略授权。冷却跨重启保留,手动停止和未知请求不重发的规则继续生效。每日委托额度耗尽时显示下次刷新时间。见 [2.0.13 发布说明](../../analysis/RELEASE_2_0_13.md)。
|
||||
|
||||
2.0.12 修复扫荡隐藏事件的自动战斗接续:完整入场响应与原始队伍快照等原始输入均已保存且可验证时,才按 `stageEvent.hideStageId` 直接构建隐藏关卡难度1的战斗,不再请求入场,战后使用隐藏 ID 结算。旧记录即使能从 trace 找回隐藏 ID,缺少原始队伍也保留中文待核对状态,不以当前属性重算,不发送游戏写请求。现场旧 `0211 / 3` 记录的原始响应已被日志轮转覆盖,无法还原隐藏 ID;仅对符合精确四字段 legacy 形态、严格确认已入场且未结算的这类旧阶段,保留证据并在本地归档为未完成、放弃,不提交胜负或重发入场。归档不等于服务端已结算,也不表示当前生产战斗已打通,见 [本版发布说明](../../analysis/RELEASE_2_0_12.md)。
|
||||
当前应用及更新示例为 `v2.0.13`。下文首次初始化章节保留 2.0.1 流程及历史版本示例。游戏资料基线为 `1.9.68`,桌面版保留 `1.2.0`。镜像流水线成功、Git tag 与 GitHub Release 是不同的发布步骤:在线更新必须等对应镜像及非草稿、非预发布的 Release 均发布后才能使用。私有仓库未获授权返回 404 属于访问失败,不代表没有版本;只有成功读取列表且没有稳定 2.x 时才显示“暂无正式版”。
|
||||
|
||||
2.0.13 修复扫荡隐藏事件的自动战斗接续:完整入场响应与原始队伍快照等原始输入均已保存且可验证时,才按 `stageEvent.hideStageId` 直接构建隐藏关卡难度1的战斗,不再请求入场,战后使用隐藏 ID 结算。旧记录即使能从 trace 找回隐藏 ID,缺少原始队伍也保留中文待核对状态,不以当前属性重算,不发送游戏写请求。现场旧 `0211 / 3` 记录的原始响应已被日志轮转覆盖,无法还原隐藏 ID;仅对符合精确四字段 legacy 形态、严格确认已入场且未结算的这类旧阶段,保留证据并在本地归档为未完成、放弃,不提交胜负或重发入场。归档不等于服务端已结算,也不表示当前生产战斗已打通,见 [本版发布说明](../../analysis/RELEASE_2_0_12.md)。
|
||||
|
||||
已在 2.0.1 完成私有仓库和 GHCR 认证的部署,稳定 Release 与正式镜像发布后,可直接通过“帮助 → 检查版本更新…”升级,无需先安装 2.0.2、重复初始化或替换宿主机更新器。尚未接入私有在线更新的宿主机才需参考下文“已有宿主机首次初始化”。
|
||||
|
||||
@@ -23,7 +25,7 @@ sudo install -m 0600 -o root -g root deploy/web/image.env.example .image.env
|
||||
sudoedit .env .image.env
|
||||
```
|
||||
|
||||
在 `.env` 填入独立的 `RANCH_WEB_PASSWORD`,这是 Web 管理密码,不是游戏密码;`.image.env` 的目标示例为 `RANCH_WEB_IMAGE=ghcr.io/attilanet/myrzx_bot-web:v2.0.12`,需确认对应镜像已发布后再 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,写请求依赖来源校验。
|
||||
在 `.env` 填入独立的 `RANCH_WEB_PASSWORD`,这是 Web 管理密码,不是游戏密码;`.image.env` 的目标示例为 `RANCH_WEB_IMAGE=ghcr.io/attilanet/myrzx_bot-web:v2.0.13`,需确认对应镜像已发布后再 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`。不要对现有账号目录重新初始化密钥。
|
||||
|
||||
@@ -55,7 +57,7 @@ Web 只读检查官方 GitHub Releases;默认只接受 `v2.MINOR.PATCH`,跳
|
||||
|
||||
### 已完成 2.0.1 初始化的宿主机
|
||||
|
||||
稳定 Release 与正式镜像发布后,用户打开“帮助 → 检查版本更新…”,检查到 2.0.12 后手动提交更新请求,可从 2.0.1 直接安装。现有私有仓库认证、GHCR 登录与宿主机更新器继续使用;Web 按钮仍要求有效心跳及 `accept_web_requests=true`。请求显示 `pending` 只表示已提交,宿主机完成备份、安装及健康检查后才确认成功;升级完成后刷新网页以加载新版界面,底部日志默认收起。Windows 或未启用执行器时仍仅可检查版本。自动安装默认关闭。
|
||||
稳定 Release 与正式镜像发布后,用户打开“帮助 → 检查版本更新…”,检查到 2.0.13 后手动提交更新请求,可从 2.0.1 直接安装。现有私有仓库认证、GHCR 登录与宿主机更新器继续使用;Web 按钮仍要求有效心跳及 `accept_web_requests=true`。请求显示 `pending` 只表示已提交,宿主机完成备份、安装及健康检查后才确认成功;升级完成后刷新网页以加载新版界面,底部日志默认收起。Windows 或未启用执行器时仍仅可检查版本。自动安装默认关闭。
|
||||
|
||||
### 全新宿主机安装
|
||||
|
||||
@@ -165,14 +167,14 @@ Windows 或未安装执行器的 Docker 部署仍能检查版本,但按钮会
|
||||
|
||||
[web-image.yml](../../.github/workflows/web-image.yml) 仅对官方仓库的严格稳定 `v2.x.y` tag 推送 `ghcr.io/attilanet/myrzx_bot-web:v2.x.y`;校验 `ranch_web.__version__` 必须与 tag 一致,不能只改变镜像 label。PR 与手动运行只测试、构建,不推送。开发分支 push 不触发正式镜像发布,也没有 `latest` 滚动升级通道。CI 执行更新器、私有凭据和独立包回归,并在无外网容器中检查 healthcheck、非 root 数据写权限、无 Qt 和正常停止;镜像发布状态以对应 tag 的工作流结果为准。
|
||||
|
||||
本版共 **491 项唯一仓库测试:489 通过、2 项 Windows 预期跳过,0 失败 / 错误**,见 [2.0.12 发布说明](../../analysis/RELEASE_2_0_12.md#验证)。本轮不实际调用游戏 API、不部署生产、不修改真实用户策略或生产 journal。2.0.11 的测试结果见 [历史发布说明](../../analysis/RELEASE_2_0_11.md#验证),不计入本版。CI 保留通过 `ranch_web/requirements-test.txt` 安装 HTTPX 的修复。
|
||||
2.0.12 历史版本共 **491 项唯一仓库测试:489 通过、2 项 Windows 预期跳过,0 失败 / 错误**,见 [2.0.12 发布说明](../../analysis/RELEASE_2_0_12.md#验证)。本轮不实际调用游戏 API、不部署生产、不修改真实用户策略或生产 journal。2.0.11 的测试结果见 [历史发布说明](../../analysis/RELEASE_2_0_11.md#验证),不计入本版。CI 保留通过 `ranch_web/requirements-test.txt` 安装 HTTPX 的修复。
|
||||
|
||||
2.0.8 共验证739项独立测试:736通过、3项 Windows 跳过;其中非浏览器662项(659通过、3跳过),浏览器77项全部验证通过,详见 [发布说明](../../analysis/RELEASE_2_0_8.md#验证)。2.0.7 结果保留在 [历史发布说明](../../analysis/RELEASE_2_0_7.md#验证)。以下命令可复现本地更新器构建与离线检查;历史 Windows 离线验证与 Linux 部署烟测见 [Web 运行说明](../../ranch_web/README.md#离线验证),不计入本版验收。可在无 Docker 的机器上构建临时更新器资产并打印计划;`--dry-run` 不联网、不读取凭据、不调用 Docker,也不写文件:
|
||||
|
||||
```sh
|
||||
python -B tools/build_web_updater.py --output test-artifacts/releases/v2.0.12/updater.pyz
|
||||
python -B test-artifacts/releases/v2.0.12/updater.pyz --version
|
||||
python -B test-artifacts/releases/v2.0.12/updater.pyz --config deploy/web/updater.example.toml --apply v2.0.12 --dry-run
|
||||
python -B tools/build_web_updater.py --output test-artifacts/releases/v2.0.13/updater.pyz
|
||||
python -B test-artifacts/releases/v2.0.13/updater.pyz --version
|
||||
python -B test-artifacts/releases/v2.0.13/updater.pyz --config deploy/web/updater.example.toml --apply v2.0.13 --dry-run
|
||||
python -B -m unittest ranch_web.tests.test_updates ranch_web.tests.test_web_updater ranch_web.tests.test_private_updates ranch_web.tests.test_web_updater_package -v
|
||||
```
|
||||
|
||||
|
||||
@@ -1,2 +1,2 @@
|
||||
# Pull only after the v2.0.12 image publishing workflow succeeds and the image is available.
|
||||
RANCH_WEB_IMAGE=ghcr.io/attilanet/myrzx_bot-web:v2.0.12
|
||||
# Pull only after the v2.0.13 image publishing workflow succeeds and the image is available.
|
||||
RANCH_WEB_IMAGE=ghcr.io/attilanet/myrzx_bot-web:v2.0.13
|
||||
|
||||
@@ -0,0 +1,288 @@
|
||||
# 运维、验证与 Git 交接
|
||||
|
||||
更新日期:2026-11-16(Asia/Shanghai)\
|
||||
项目背景见 [PROJECT_CONTEXT.md](PROJECT_CONTEXT.md)。本文件供新窗口的维护代理直接操作,不保存密码或 Token 明文。
|
||||
|
||||
## 本机仓库与基本约束
|
||||
|
||||
真实项目根目录:
|
||||
|
||||
```text
|
||||
C:\Users\11789\Documents\Projects\Codex_ws\myrzx_bot
|
||||
```
|
||||
|
||||
宿主环境有时仍把 cwd 显示成旧的 `myrzx_fang`;所有命令显式设置上述 `workdir`,不要在旧目录另建副本。
|
||||
|
||||
- Windows PowerShell,本机 Python 3.13;项目要求 Python 3.12+。命令统一使用 `python -X utf8 -B` 或 `.venv-web\Scripts\python.exe -X utf8 -B`,避免 pyc 和控制台编码干扰。
|
||||
- 当前发布基线:`main`、tag `v2.0.12`、提交 `a9b5f73552bf87efe65b4f0d6fd878bcb14dfbc9`。新会话先重新查询,不假定仍是此 SHA。
|
||||
- Git 提交身份:`AttilaNet <zbolink@foxmail.com>`。用户允许私有仓库存放运维信息;本次交接文档只保存凭据位置,密码、Token 等真实值从既有私有文件读取,未复制进文档。
|
||||
- 用户自有、未跟踪的 `ranch-policies-1.2.0.dev1.json` 不要修改或暂存。
|
||||
- `local_state/`、`test-artifacts/`、凭据、日志、数据库、APK 等由 `.gitignore` 排除;不要用 `git add -f` 把它们带入文档提交。
|
||||
- 当前没有正在开发的 feature。开始新修复前检查 `git status --short`、`git log -1`、`git branch --show-current` 和 remote,避免覆盖用户改动。
|
||||
|
||||
建议的只读开工检查:
|
||||
|
||||
```powershell
|
||||
git status --short
|
||||
git branch --show-current
|
||||
git log -1 --oneline
|
||||
git remote -v
|
||||
git diff --check
|
||||
```
|
||||
|
||||
## 本地运行
|
||||
|
||||
首次准备 Web:
|
||||
|
||||
```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`。也可在项目根目录执行:
|
||||
|
||||
```powershell
|
||||
python -X utf8 -B -m ranch_web
|
||||
```
|
||||
|
||||
Linux/macOS 源码启动使用 `sh start-web.sh`。Web 不需要 Node/npm、PySide6 或 APK 工具;本地数据默认在 `local_state/ranch_web`。
|
||||
|
||||
桌面历史版仍可用 `Start_Ranch_Helper.cmd` 或 `python -B -m ranch_assistant`,依赖见 `ranch_assistant/requirements.txt`。桌面和 Web 数据根不同,不要混用或同时操作同一游戏账号来“对比测试”。
|
||||
|
||||
## 测试策略
|
||||
|
||||
优先运行与修改范围对应的确定性离线测试,再按共享核心的影响扩大范围。测试使用临时目录、fake transport/client、合成账号和离线 HTTP 服务;禁止真实游戏写请求。浏览器测试可用 loopback,但不能把 loopback 白名单变成公网访问。
|
||||
|
||||
### 常用依赖和静态检查
|
||||
|
||||
```powershell
|
||||
python -X utf8 -B -m pip install -r ranch_web\requirements-test.txt
|
||||
python -X utf8 -B -m compileall -q ranch_assistant ranch_web
|
||||
git diff --check
|
||||
```
|
||||
|
||||
`requirements-test.txt` 包含运行依赖和 HTTPX;CI 曾缺少 HTTPX,这一安装步骤不能删。若已有 `.venv-web`,优先用其中的 Python。浏览器测试另需 Python Playwright 和 Edge;可用 `RANCH_WEB_BROWSER` 指定 `msedge.exe`,默认路径是 `C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe`。
|
||||
|
||||
### 通用离线回归
|
||||
|
||||
```powershell
|
||||
python -X utf8 -B -m unittest discover -s ranch_assistant\tests -p "test_*.py" -v
|
||||
python -X utf8 -B -m unittest discover -s ranch_web\tests -p "test_*.py" -v
|
||||
```
|
||||
|
||||
后一条可能包含依赖 Playwright/Edge 的浏览器模块;缺少可选依赖时的 skip 要与真正通过分开报告。正式验收需明确列出实际运行的模块、去重后的测试数和 skip 原因,不能把多轮结果简单相加。
|
||||
|
||||
### 最近修复的定向命令
|
||||
|
||||
隐藏关卡接续与恢复:
|
||||
|
||||
```powershell
|
||||
python -X utf8 -B -m unittest `
|
||||
ranch_assistant.tests.test_sweep_hidden_handoff `
|
||||
ranch_assistant.tests.test_sweep_hidden_battles `
|
||||
ranch_assistant.tests.test_sweep_hidden_engine -v
|
||||
```
|
||||
|
||||
Linux 战斗子进程输入、恢复和页面能力:
|
||||
|
||||
```powershell
|
||||
python -X utf8 -B -m unittest `
|
||||
ranch_assistant.tests.test_battle_worker_transport `
|
||||
ranch_assistant.tests.test_battle_recovery `
|
||||
ranch_assistant.tests.test_battle_capability_presentation `
|
||||
ranch_web.tests.test_lifecycle_recovery `
|
||||
ranch_web.tests.test_battle_recovery_contract `
|
||||
ranch_web.tests.test_status_recovery_api -v
|
||||
```
|
||||
|
||||
自动登录、持久运行意愿和连接状态:
|
||||
|
||||
```powershell
|
||||
python -X utf8 -B -m unittest `
|
||||
ranch_web.tests.test_run_intent `
|
||||
ranch_web.tests.test_scheduler_recovery `
|
||||
ranch_web.tests.test_auto_relogin `
|
||||
ranch_web.tests.test_connection_state -v
|
||||
```
|
||||
|
||||
主培养、委托和快速模型:
|
||||
|
||||
```powershell
|
||||
python -X utf8 -B -m unittest `
|
||||
ranch_assistant.tests.test_species_retention_limits `
|
||||
ranch_assistant.tests.test_primary_cultivation `
|
||||
ranch_assistant.tests.test_primary_resource_admission `
|
||||
ranch_assistant.tests.test_commission_history `
|
||||
ranch_assistant.tests.test_commission_priority `
|
||||
ranch_assistant.tests.test_commission_procurement `
|
||||
ranch_assistant.tests.test_battle_quick `
|
||||
ranch_assistant.tests.test_snapshot_potential_anomalies -v
|
||||
```
|
||||
|
||||
UI 修改至少覆盖对应浏览器模块,例如:
|
||||
|
||||
```powershell
|
||||
python -X utf8 -B -m unittest `
|
||||
ranch_web.tests.browser.test_workbench_browser `
|
||||
ranch_web.tests.browser.test_admin_login_browser `
|
||||
ranch_web.tests.browser.test_connection_browser `
|
||||
ranch_web.tests.browser.test_auto_relogin_browser -v
|
||||
```
|
||||
|
||||
分类日志、安静 UI 和子路径分别使用 `ranch_web.tests.browser.test_task_logs_browser`、`ranch_web.tests.browser.test_quiet_ui_browser`、`ranch_web.tests.browser.test_base_path_browser`。先看当前测试名称,不要盲抄历史命令。
|
||||
|
||||
### 战斗恢复的必测边界
|
||||
|
||||
修改 `battles.py`、`engine.py`、`battle_simulator.py` 或 Web 生命周期时,至少验证:
|
||||
|
||||
1. 已确认入场后本地崩溃/超时,不会再次 `stageStart`。
|
||||
2. 原始输入齐全时只重跑本地计算一次;保存的完成结果可续交一次。
|
||||
3. 缺原始队伍输入的旧隐藏记录不会用当前属性补算。
|
||||
4. 已发送的未知 `battleEnd`、记录、探险、突破或任务写请求不重放。
|
||||
5. 手动 Stop、账号代际变化和来源策略关闭都阻止新写,且不误改持久运行意愿。
|
||||
6. 恢复只处理 pending,不夹带其他策略;多账号状态完全隔离。
|
||||
7. Windows 测试不能替代 Linux 管道语义。涉及子进程 stdin/stdout 时,用 Linux/Python 3.12 的离线进程测试或 CI 镜像验证。
|
||||
|
||||
## 生产部署现状
|
||||
|
||||
用户入口:
|
||||
|
||||
```text
|
||||
https://witchercheung.cn/myrzx_bot
|
||||
```
|
||||
|
||||
生产在用户的 X99 内网 Ubuntu 服务器,Docker 容器经已有 FRP/反向代理暴露;不要改动 FRP 或其他服务。
|
||||
|
||||
| 项目 | 已知配置 |
|
||||
| --- | --- |
|
||||
| SSH 入口 | `ssh -tt -p 50022 witcher@120.78.82.189`;已有 SSH key 可登录。该地址转发到内网 X99。 |
|
||||
| X99 内网地址 | `192.168.31.187`,Ubuntu 24.04、Python 3.12。上次诊断记录 Docker 29.8.0、Compose 5.5.1;使用前核对当前版本。 |
|
||||
| 源码/Compose | `/opt/ranch-web` |
|
||||
| 持久数据 | `/opt/ranch-web/data`,UID/GID `10001:10001`,目录 `0700`;含账号、密钥、配置、统计、历史和更新请求。 |
|
||||
| 容器/项目 | `ranch-web-web-1` / Compose project `ranch-web` |
|
||||
| 端口 | 生产发布 `127.0.0.1:58765 → 容器 8765`,经现有 FRP/反代访问;不要误用旧的 57865。 |
|
||||
| 容器安全 | 非 root、只读根文件系统、单 Uvicorn worker、restart `unless-stopped`;不挂 Docker socket。 |
|
||||
| 配置 | `/opt/ranch-web/.env` 和 `.image.env` root `0600`;不得用仓库示例覆盖。 |
|
||||
| Web 安全 | base path `/myrzx_bot`,Host/Origin 白名单,Secure + HttpOnly 管理 cookie;未登录不得暴露工作台。 |
|
||||
| 更新器 | `/opt/ranch-web/updater.pyz`,配置 `/etc/ranch-web-updater.toml`,备份在 `/opt/ranch-web/backups`,失败数据在 `/opt/ranch-web/failed-data`。 |
|
||||
| 更新控制 | `accept_web_requests=true`、`auto_apply=false`;timer 维护心跳,官方版本每小时检查,安装由用户从 Web 发起。 |
|
||||
|
||||
sudo 需要交互凭据时先在已验证的 sudo 提示下输入;不得把密码放进命令参数、脚本、日志或 Markdown。已有 SSH key 不代表免密 sudo。
|
||||
|
||||
常用只读检查(确有需要时):
|
||||
|
||||
```sh
|
||||
sudo sh /opt/ranch-web/deploy/web/compose.sh ps
|
||||
curl --fail http://127.0.0.1:58765/api/health
|
||||
sudo systemctl status ranch-web-updater.timer
|
||||
sudo journalctl -u ranch-web-updater.service --no-pager -n 80
|
||||
```
|
||||
|
||||
生产检查优先使用管理 API 的 GET 和既有调试记录;不要为“测试一下”刷新关卡、开启策略、领奖励、打战斗、删除账号或重置 pending。管理登录/退出本身会写管理会话,仍需遵守用户授权。
|
||||
|
||||
## 凭据位置与读取规则
|
||||
|
||||
本机以下文件均位于忽略目录。本次文档只记录位置和用途;需要认证时从既有私有文件读取真实值,按用户最新授权处理私有仓库内容。
|
||||
|
||||
| 文件 | 用途与规则 |
|
||||
| --- | --- |
|
||||
| `local_state/deployment_x99/access.private.json` | Web 管理入口元数据和 `web_password`。读取到内存供管理登录使用,不打印、不复制到文档、不提交。该文件不保证记录的应用版本是最新版。 |
|
||||
| `local_state/deployment_x99/update_credentials.private.json` | 私有 GitHub/GHCR 更新凭据,`ghcr_username` 缺省时历史脚本使用 `AttilaNet`。只在内存中读取,不能打印认证头或写入仓库。 |
|
||||
| `/opt/ranch-web/data/update-github-token`(服务器) | 私有 GitHub Release 只读 Token 文件,预期 `0600`、UID/GID 10001;容器内同文件为 `/data/update-github-token`。不要读取到聊天输出。 |
|
||||
| root 的 Docker GHCR 登录配置(服务器) | 由宿主机 `docker login ghcr.io --password-stdin` 管理。不要复制开发机凭据,也不要把 registry Token 交给 Web 容器。 |
|
||||
|
||||
不要在文档里虚构“SSH 密码保存文件”。如果某凭据不在上述真实位置,先检查已有安全存储或让用户通过私密文件提供;不要要求把密码贴到聊天中。
|
||||
|
||||
## 在线更新与发布
|
||||
|
||||
### 用户升级
|
||||
|
||||
现有 X99 已配置私有 GitHub Release + GHCR 通道。新版本正式镜像和稳定 Release 都核验后,用户打开 **“帮助 → 检查版本更新…”**,手动提交更新;宿主机执行备份、拉取、停止、切换、健康检查及失败回滚。`pending` 只代表请求已排队,成功以宿主机状态为准。完成后用户刷新网页加载新静态资源。
|
||||
|
||||
除非用户再次明确要求,维护代理只发布版本,**不手动 SSH 部署 X99、不代替用户点击在线更新**。
|
||||
|
||||
### 当前发布链仍是 GitHub
|
||||
|
||||
截至 2.0.12:
|
||||
|
||||
- 正式发布仓库:`AttilaNet/myrzx_bot`(GitHub 私有)。
|
||||
- Actions:`.github/workflows/web-image.yml`,稳定 `v2.x.y` tag 构建并推 `ghcr.io/attilanet/myrzx_bot-web:v2.x.y`。
|
||||
- 更新器只接受官方 GitHub Releases 的稳定 2.x,严格递增并校验固定镜像;tag、镜像和 Release 缺一不可。
|
||||
- `deploy/web/updater.py`、`ranch_web/updates.py`、`.github/workflows/web-image.yml` 固定 GitHub owner/repo、API 或 GHCR 地址;忽略目录中的历史 `test-artifacts/publish_web_*.py` 发布辅助也按 GitHub 流程编写,使用前必须重新审查。
|
||||
|
||||
**本次 Gitea remote 迁移没有修改上述任何发布端点。** 如果 GitHub 仓库以后不可写或 Actions/Release 被删除,现有在线发布会失败;只推 Gitea tag 不会生成 GHCR 镜像,也不会让 X99 发现更新。迁移到 Gitea Releases/Actions/Container Registry 是独立项目,必须先设计认证、镜像命名、更新器来源固定、回滚与兼容,再改代码和部署文档。
|
||||
|
||||
### 发布检查清单
|
||||
|
||||
1. 在干净基线上完成实现与审查;确认版本号、README、部署说明和 `analysis/RELEASE_X_Y_Z.md` 与最终范围一致。
|
||||
2. 运行适当回归和浏览器测试,记录唯一测试数及预期 skip;`git diff --check`,检查待提交文件和敏感信息。
|
||||
3. 保留用户未跟踪文件,明确暂存公开源码/文档,不用 `git add .` 横扫私有产物。
|
||||
4. 用授权身份提交;需要合入 `main` 时使用正常 merge,不强推、不改已发布 tag。
|
||||
5. 创建与 `ranch_web.__version__` 一致的 `v2.x.y` annotated tag,推送到**实际承担发布的 remote**。当前发布链仍需要 GitHub,不能因 Gitea 名为 `origin` 就误以为推 Gitea 足够。
|
||||
6. 等稳定 tag 的 Actions 成功,核验 GHCR 镜像 version/revision label 与精确 main SHA。
|
||||
7. 构建 `updater.pyz`:
|
||||
|
||||
```powershell
|
||||
python -X utf8 -B tools\build_web_updater.py --output test-artifacts\releases\vX.Y.Z\updater.pyz
|
||||
```
|
||||
|
||||
生成 ASCII/LF 的 `SHA256SUMS`,比较包内源码与精确提交 blob,再上传 GitHub Release。发布必须是非草稿、非预发布。
|
||||
8. 独立核对 Release、资产摘要、main/tag SHA、镜像 digest 和源码版本。最后才按明确授权清理旧 Release/tag/分支;先备份且不得用仅面向 GitHub 的旧 helper 去删除 Gitea 同名 ref。
|
||||
9. 告知用户可在线更新,但不声称生产已恢复,直到用户安装并反馈。
|
||||
|
||||
历史发布辅助位于忽略的 `test-artifacts/`,可能不存在于新机器,也可能绑定旧版本号。使用前审查,不要直接运行旧 `--apply`、cleanup 或 deploy 脚本。
|
||||
|
||||
## Git remote 迁移到 Gitea
|
||||
|
||||
### 已完成的迁移
|
||||
|
||||
用户已有的私有 Gitea 仓库:
|
||||
|
||||
```text
|
||||
https://gitea.witchercheung.cn/witcher/myrzx_bot.git
|
||||
```
|
||||
|
||||
迁移前本机同时存在:
|
||||
|
||||
```text
|
||||
gitea https://gitea.witchercheung.cn/witcher/myrzx_bot.git
|
||||
origin https://github.com/AttilaNet/myrzx_bot.git
|
||||
```
|
||||
|
||||
父任务已执行 `git remote remove origin` 删除旧 GitHub remote,再执行 `git remote rename gitea origin`。现在唯一的 `origin` 是上述 Gitea URL;`git ls-remote` 已确认 Gitea `main` 和 `HEAD` 在应用基线 `a9b5f73552bf87efe65b4f0d6fd878bcb14dfbc9`。迁移前 Git 配置备份在忽略目录:
|
||||
|
||||
```text
|
||||
local_state/context_handoff/git-config.before-origin-migration.2026-11-16.private
|
||||
```
|
||||
|
||||
**本次没有删除 GitHub 网站仓库,也没有把在线更新迁到 Gitea。只推 `main` 的交接文档提交,不推 `v2.0.12` 或其他 tag,不迁移 Release、CI、GHCR。** Gitea 在文档提交前尚无 `v2.0.12` tag。
|
||||
|
||||
### 文档推送与后续核对
|
||||
|
||||
父任务负责暂存、提交和推送文档。先检查工作区与远端实际状态,确认 Gitea 认证可用。Gitea 为私有仓库,推送若要求认证,应使用已有凭据管理器或用户提供的私有凭据,不把密码写进 remote URL、命令输出或文档。
|
||||
|
||||
```powershell
|
||||
git remote -v
|
||||
git ls-remote origin
|
||||
git branch --set-upstream-to=origin/main main
|
||||
git push origin main
|
||||
git rev-parse HEAD
|
||||
git ls-remote origin refs/heads/main
|
||||
git status --short --branch
|
||||
```
|
||||
|
||||
不要重复执行 remove/rename,也不要执行 `git push --tags`。推送后核对本地 HEAD 与 Gitea `main` 完全一致。是否推送其他历史分支留待用户另行要求,不要为了“同步全部”把私有实验分支或旧引用无差别上传。
|
||||
|
||||
迁移后应满足:
|
||||
|
||||
- 本机仅有目标 Gitea `origin`(除非用户另有 remote),URL 不含内嵌密码。
|
||||
- `main` 跟踪 `origin/main`,文档提交在 Gitea 可见,工作区除用户原有策略 JSON 外无意外改动。
|
||||
- GitHub 网站仓库没有被 `git remote remove` 删除;该命令只删除本地 remote 配置。
|
||||
- 文档明确保留“更新发布仍依赖 GitHub/GHCR”的限制。不要运行旧 cleanup helper 删除 Gitea 的 tag 或分支。
|
||||
|
||||
如要把后续发布也迁到 Gitea,先另开任务:决定 Gitea Actions/其他 CI、容器 registry、Release API、认证与 X99 updater 配置,并为旧 GitHub 通道保留可回滚方案。未完成前继续发布必须显式说明 GitHub 发布 remote/流程,不能只看本地 `origin` 名称。
|
||||
|
||||
## 新会话收尾模板
|
||||
|
||||
完成工作后简洁报告:实际改动、关键根因、运行了哪些测试及 skip、提交/远端 SHA、是否发布或部署、仍需用户做什么。离线结果和生产结果分开写;遇到不确定的请求状态,保留证据并说明不能安全自动做的部分,而不是为了“全部完成”伪造结果。
|
||||
@@ -0,0 +1,151 @@
|
||||
# 项目上下文与接手说明
|
||||
|
||||
更新日期:2026-11-16(Asia/Shanghai)\
|
||||
源码基线:`main` / `v2.0.12` / `a9b5f73552bf87efe65b4f0d6fd878bcb14dfbc9`\
|
||||
运维命令见 [OPERATIONS.md](OPERATIONS.md)。
|
||||
|
||||
## 先读这里
|
||||
|
||||
- 这是《牧羊人之心》单游戏、单管理员的多账号牧场辅助。当前主产品是 **Web 2.0.12**;PySide6 桌面版保留在 **1.2.0**,不再作为新 Web 功能的主要界面。两者的游戏资料基线都是 Android **1.9.68**。
|
||||
- 截至上述基线,没有待合并的开发功能分支。2.0.12 已发布源码、镜像和 Release,但用户尚未反馈升级后的生产验收;不要把“已发布”写成“现场已恢复”。
|
||||
- 项目已有大量真实账号状态、私有日志和恢复记录。新会话不得为了复现问题调用真实游戏写接口、清空 pending、重置密钥或修改用户策略。离线测试、合成 fixture 和明确授权的只读诊断优先。
|
||||
- 本地源码 remote 已迁移:Gitea 是唯一的 `origin`,旧 GitHub remote 仅从此工作区移除,GitHub 网站仓库未删除;**在线更新链路并未迁移**。本次只推 `main` 文档,不推 tag。详见运维文档的 Git 迁移章节。
|
||||
- 新会话先读根目录 `HANDOFF.md`、`README.md`、本文、运维文档和最新发布说明。历史记录用于理解约束,不应替代当前代码和测试。
|
||||
|
||||
## 产品目标与边界
|
||||
|
||||
目标是在浏览器中管理多个彼此隔离的游戏账号,让后台持续执行用户明确开启的策略;关闭网页或退出管理登录不应停止服务端任务。每个账号独立并行,同一账号内的游戏操作串行,避免账号间串数据、串日志或重复请求。
|
||||
|
||||
Web 保持现有管理工作台形态:账号页签、顶部玩家状态、15 个功能页、统一“开启/停止”,以及唯一的底部日志区。当前没有多管理员、多权限或接入其他游戏的计划,也没有 Node/npm 前端构建链。
|
||||
|
||||
“自动”有硬边界:已经发送但结果未知的写请求不能自动重放;不能为了解除阻塞伪造胜利、奖励、任务进度或服务端确认。恢复行为必须区分“本地可安全继续”“需要来源策略授权”“用户已停止”和“确实未知”。
|
||||
|
||||
## 已有能力
|
||||
|
||||
| 范围 | 当前行为与重要约束 |
|
||||
| --- | --- |
|
||||
| 登录与连接 | 第一弹账号密码登录、官方区服和角色选择、会话恢复。保存登录记录的账号在服务重启后自动登录;掉线按账号设置的时长重登。只有删除账号或清除登录记录取消这种恢复安排。 |
|
||||
| 策略运行意愿 | 登录/重登成功后自动执行原有已勾选子功能,不会擅自全选功能。只有用户手动“停止”持久暂停;点击“开启”恢复。内部错误、待核对和服务重启不能把运行意愿永久清掉。 |
|
||||
| 牧场基础数据 | 培育室坑位、蛋的分类背包、牧场/魔物、好感、资质、等级/突破/潜能、物品及锁定状态;支持搜索、排序、分组和部分手动操作。 |
|
||||
| 孵蛋与补货 | 按蛋规则买蛋/抽蛋、孵化、成长同步、成熟收取、派遣或喂养;默认十连,可允许单抽,遵守金币保留、每日额度、库存下限和目标。空坑装填有独立的短间隔调度。 |
|
||||
| 主培养与资质备用 | 已启用种类固定主培养 1 只、严格更优资质备用最多 1 只。主培养优先使用已养成的高等级魔物;备用只保留,不自动喂养、赠礼或突破。新备用更优时先处理旧备用;同分/更差不继续收为备用。锁定、在队、装备和委托保留等保护仍有效。 |
|
||||
| 喂养、赠礼、突破 | 自动经验、同种突破材料、赠礼和潜能突破只作用于主培养;达到当前等级/好感/潜能条件后停止,不转喂同种备用。赠礼有冷却;突破遵守材料/委托保留量,不擅自买材料或消耗货币。 |
|
||||
| 每日事务 | 每日签到、七日签到、累计奖励、已有 VIP 日奖、邮件附件的查看、手动领取与按勾选项自动领取。 |
|
||||
| 自动委托 | 当前委托/每日记录分栏;合格候选跨城市按预计氪金 20→15→10 排序,并显示不可接取或回退原因。材料/蛋/击杀或成熟魔物备料复用已有收集与保护规则。领奖确认金额与静态预计奖励分开,未确认不能猜。 |
|
||||
| 主线与任务 | 当前进行中、待接取和待领奖任务优先显示;支持部分接取、线性对话、交付、领奖、任务补链和普通地图备料。受前置、城市、资源、保护规则及战斗模型能力限制,不能声称所有主线均已支持。 |
|
||||
| 探险 | 读取队伍状态,自动领取已完成奖励;再次出发默认关闭,按队配置地区、保留体力和成员。不花钱开队或召回,未知请求持久化且不重放。 |
|
||||
| 扫荡与挑战 | 地区折叠、难度/星级、每日上限、保留体力和战队;未满星可走实验模拟挑战。普通关、事件和矿洞/门票资源关有不同入口;资源关单独授权并检查工具库存。队员探险中时不能静默换人入场。 |
|
||||
| 数据分析 | 本地按账号、关卡和难度统计扫荡及事件奖励,含出现次数、数量、实测比例、95% 区间、平均每点体力数量;不需要为画图额外请求游戏服务。 |
|
||||
| 策略与日志 | 策略自动保存、导入/导出;运行详情只进原底部日志区。切换页签只改变该区显示的账号+功能分类,不新增页内日志框或“总日志”。F5/重新进入默认收起,右上角是唯一显隐入口。 |
|
||||
|
||||
完整页面能力和桌面版差异见 `README.md`、`ranch_assistant/README.md`;不要把历史 APK 修改工具当成 Web 的正常运行依赖。
|
||||
|
||||
## 架构地图
|
||||
|
||||
- `ranch_assistant/`:游戏协议、登录、状态快照、策略规划与执行、持久 journal、战斗模拟和桌面 UI。
|
||||
- `login.py`、`api.py`、`sessions.py` 处理登录、协议与会话;真实响应要经过既有解码和脱敏边界。
|
||||
- `engine.py` 是策略编排核心;`progression.py`、`quests.py`、`sweeping.py`、`battles.py`、`management.py`、`market.py`、`gifts.py`、`exploration.py` 等分领域实现。
|
||||
- `battle_simulator.py` 保留隔离运行时和逐帧研发实现;正常执行使用 `battle_quick.py` 的快速 HP/DPS 数值模型。
|
||||
- `data/` 保存从 1.9.68 资料构建的任务、地图、战斗和收益数据;不应为通过测试手改配置来“支持”关卡。
|
||||
- `ranch_web/`:FastAPI/Uvicorn、账号 worker、调度、加密存储、视图 DTO、管理认证和更新客户端。
|
||||
- `service.py` / `scheduler.py` 管理账号生命周期、运行意愿、心跳、重试和恢复。
|
||||
- `store.py` 管持久化;`views.py` 组织 15 页数据;`app.py` 管 API、认证、CSRF/Origin、Host 和子路径。
|
||||
- `static/` 是原生 HTML/CSS/ES Modules,无 Vue、React 或打包步骤。`pages.js`、`app.js`、`task-logs.js` 等保持现有页面和日志交互。
|
||||
- `deploy/web/`:Compose 启动脚本、宿主机更新器、配置示例与更新协议。
|
||||
- `tools/`:资料构建、离线研究、支持范围检查和 updater.pyz 构建工具。
|
||||
- `analysis/`:逆向资料、接口清单和历史版本发布说明。最新版本的事实以 `analysis/RELEASE_2_0_12.md` 为准。
|
||||
- `ranch_web/tests/`、`ranch_assistant/tests/`:离线单元/集成/浏览器测试。`local_state/` 与 `test-artifacts/` 是忽略目录,不属于可分源码。
|
||||
|
||||
部署是单容器、单 Uvicorn worker;账号并行在应用内部实现。不能让多个 worker、replica 或服务实例共享同一个 `/data`。
|
||||
|
||||
## 关键设计约定
|
||||
|
||||
### 用户意愿、连接状态与执行能力分开
|
||||
|
||||
持久化的“用户希望运行”不等于当前 worker 正在执行,也不等于游戏连接健康。内部故障可暂时挂起执行,但不能改写手动启停意愿。心跳成功也不代表角色数据在更新或策略未被 pending 阻塞;界面必须显示真实状态和具体原因。
|
||||
|
||||
停止策略后仍允许只读刷新;停止/代际切换必须撤销尚未发送的恢复写操作。恢复只能处理原 pending,不得顺带启动其他无关策略。
|
||||
|
||||
### 所有消耗性恢复都要有证据
|
||||
|
||||
战斗 journal 要保留请求阶段、原始响应、必要的原始队伍/装备/属性输入、内容摘要、执行状态和取消/停止信息。恢复时区分未发送、已确认入场、结果待提交和未知已发送写请求。相同实例和请求证据用于幂等,不靠“再试一次”判断成功。
|
||||
|
||||
### 战斗是近似模型
|
||||
|
||||
2.0.9 起正常入口采用快速 HP/DPS、伤害、有效血量、时间和关卡目标的估算;保留现有 `client_v4_x10` 伤害配置,逐帧实现仅用于研发。2.0.12 没有改战斗数学或伤害参数。离线胜利不是服务端验收,战败也不能当成“不支持”。不要擅自切回原逐帧大模拟或宣称完全复刻客户端。
|
||||
|
||||
### 保护规则和账号隔离不可绕过
|
||||
|
||||
主培养、严格更优备用、锁定、在队、装备、委托预留等硬保护不能为了清库存或交委托而绕过。配置导入保留用户既有启停意图,导入本身不自动开启策略,也不会把手动停止改为开启;不跨账号套用私有状态。日志、筛选、下载、运行状态和恢复记录都必须按账号隔离。
|
||||
|
||||
## 重要历史问题与修复
|
||||
|
||||
### 早期逆向与功能演进
|
||||
|
||||
项目最初研究 APK、接口与战斗数据,后来形成 PySide6 桌面辅助。早期伤害修改、抓包和原生 AIR 运行研究留下了工具与资料;当前 Web 不需要重新编译 APK,也不应重新展开这些耗时研究。1.x 逐步加入多账号、牧场、孵蛋、委托、扫荡、探险和数据分析;2.0.0 将现有能力迁移为 FastAPI + 原生前端和 Docker 单服务。
|
||||
|
||||
### 调度、状态与 UI
|
||||
|
||||
- **快速定时器串跑全量策略**:探险/突破等 1 秒级定时器曾调用完整 `engine.poll`,造成主线/扫荡被高频执行。修复方向是白名单化的快速动作分发,快速任务不能加速主线或地图。
|
||||
- **队伍探险仍可入场**:旧检查只看魔物是否存在,没有识别 `inExploreTeam` / `exploreTeams`。现在普通扫荡、挑战、任务和委托战斗都要按整队可用性拒绝并说明原因,不能静默移除探险成员。
|
||||
- **心跳活着但策略停了**:2.0.1~2.0.6 持续拆分持久运行意愿、临时故障、会话失效和自动重登。当前语义是登录后恢复已勾选策略,只有手动停止持久暂停。
|
||||
- **日志 UI 反复走偏**:2.0.2 曾新增页内日志区,2.0.3 已纠正为一个原底部日志区。后续又删除设置页大段重复运行说明和“加载中”小字,加载使用居中 spinner。不要恢复总日志、页内第二日志框或自动弹日志。
|
||||
- **表单布局**:2.0.6 收紧 checkbox/radio 与标签的间距,统一标签—控件关联、换行和窄屏布局。不要把说明文字重新铺得到处都是。
|
||||
- **子路径部署**:生产保留 `/myrzx_bot` 前缀。后端使用配置的 base path 构造规范化路由、cookie 和页面元数据;前端所有 API/跳转需走统一 path helper。要防止双前缀鉴权旁路,且未登录不能加载工作台或 `app.js`。
|
||||
|
||||
### 牧场与委托
|
||||
|
||||
- **每只新魔物都被喂养/送礼**:2.0.7 将主培养与资质备用彻底分开。更优资质可以保留作转移材料,但不能取代已养成主培养自动吃资源。
|
||||
- **委托只写“不可接”**:2.0.8 增加每日记录、具体原因和 20→15→10 的候选回退说明。次数耗尽、城市未解锁、资源/保护不足、暂态错误和模型限制要区分;不能为接 20 氪金委托绕过限制。
|
||||
- **委托备料不全**:2.0.9 补材料、蛋/击杀及成熟魔物的采购/收集规划,先算现有库存再补缺口,并遵守金币、保护和未知写约束。城市锁定和每日额度仍需真实解锁/等待。
|
||||
- **潜能误报**:修复过快照属性解释导致的 `overpoten` 误判。不能通过删除异常检查来放行;只有证实输入解释错误才可修正。
|
||||
|
||||
### 战斗恢复
|
||||
|
||||
- **2.0.10 的待核对阻塞**:2026-11-13 的现场是委托备料普通关已确认 `stageStart`,本地模型随后超时,旧版无法清除 pending。根因是 Linux 子进程 stdin 首次部分写入后,后续 `communicate(input=None)` 没有继续输入/EOF,子进程等输入直到 wall-clock timeout。
|
||||
- **2.0.11 的修复**:有界输入先写入自动清理的 seekable 临时文件,再给子进程完整 stdin;之后 `communicate()` 不再传 input。新记录保存原始输入,允许仅重跑本地计算一次,不重发 `stageStart`。缺输入的精确旧技术失败按原始客户端失败退出协议记录一次;响应丢失仍不得重放。来源策略关闭显示等待授权,手动停止禁止恢复写。
|
||||
- **2.0.12 的隐藏关卡**:旧扫荡拿到 `stageEvent` 后没有接续战斗。新记录或可完整恢复记录现在使用原响应的 `stageEvent.hideStageId` 构建隐藏关难度 1,不再次入场,结算也用隐藏 ID。
|
||||
- **旧现场不能凭空补全**:用户当时的 `0211 / 3` pending 只剩提示和 `sampleId`,原始响应已被 8 MB × 2 日志轮转覆盖,隐藏 ID 无法还原。仅符合精确四字段 legacy 形态、已确认入场且未结算的记录才本地归档为“未完成,已放弃”,不提交胜负或奖励。
|
||||
- **独立审查抓到的最后边界**:如果旧 trace 能找回隐藏 ID,却没有 `entry_snapshot` 等原始输入,绝不能用当前队伍(例如后来升到 999 级)补算并结算。这种记录必须保持中文待核对、零游戏写请求。
|
||||
|
||||
## 2.0.12 验证证据与未验收部分
|
||||
|
||||
- 仓库测试按测试 ID 去重共 **491 项:489 通过、2 项 Windows 预期跳过、0 失败/错误**;其中隐藏关卡专项 50 项、受影响引擎回归 74 项。不同阶段重复运行不能累加成新的测试数。
|
||||
- 另有 **2 项 Web 离线恢复探针**通过,验证恢复、启停、账号隔离和禁止重复请求,不计入上述 491 项。
|
||||
- 静态模型对两支队伍 × `hd01`~`hd08` 共 16 种配置各重复两次:13 种配置模型胜利、3 种模型失败,32 次合计约 102.646 ms,单次最长约 14.193 ms。只证明这些静态输入可复现,不证明生产通关。
|
||||
- 发布包含 GHCR 正式镜像、GitHub 稳定 Release、`updater.pyz` 和 SHA256 校验资产。旧 v2.0.11 发布物/refs 已有独立备份后按用户要求清理。
|
||||
- 没有在 2.0.12 验证轮中调用真实游戏 API、修改生产策略或手动部署 X99。用户那条历史隐藏战斗并未被实际打通;等待用户安装并反馈。
|
||||
|
||||
## 仍然有限或容易误判的地方
|
||||
|
||||
1. 战斗是快速近似模型,特殊机制、剧情选择和部分任务类型仍可能不支持;覆盖一部分配置不等于全部主线/委托可完成。
|
||||
2. 新隐藏战斗依赖完整、可验证的原始输入。历史日志轮转后,不应从普通关 ID、难度或 `sampleId` 推造隐藏 ID。
|
||||
3. 本地“放弃/归档”只解除客户端持久阻塞,不代表服务端已经结算;是否值得增加只读核对必须先有明确、安全的协议证据。
|
||||
4. 委托的城市、次数、库存和保护限制不能绕过;20 氪金优先不是所有情况下都必须接 20。
|
||||
5. 生产升级、回滚和真实账号恢复仍需用户操作后观察。管理页面“已登录”本身不是验收。
|
||||
6. Git remote 改为 Gitea 不代表更新器支持 Gitea。现有代码、Actions 和发布辅助仍指向 GitHub `AttilaNet/myrzx_bot` Release 与 GHCR;未来迁移发布通道需单独设计、测试和更新用户文档。
|
||||
|
||||
## 历史技术索引:遇到对应问题再读
|
||||
|
||||
| 历史问题或决策 | 接手要点与证据入口 |
|
||||
| --- | --- |
|
||||
| APK 与热更新 | 项目最初尝试过伤害倍率包、属性包和原生运行研究。用户曾确认后来的倍率包可用,但当前任务不是继续制作 APK;原始包、签名和构建中间产物可能已因磁盘清理删除。基础分析在 `analysis/REPORT.md`,不要假定旧工具所指的二进制仍在本机。 |
|
||||
| API 清单 | `analysis/API_INVENTORY.md` 和 `analysis/as3/scripts/net/pixvi/myr/net/` 是接口用途与原客户端字段的入口。界面上隐藏了地址、Token、协议密钥和请求序号,不代表协议不再需要它们。 |
|
||||
| 登录区服解析 | 登录响应的 `servers` 曾包含 Fastjson `$ref` 重复引用,直接逐行取 `id` 导致 KeyError。当前 `ranch_assistant/api.py` 只解析受限的本数组引用并整理区服;角色信息来自 `masterInfos`。不要把合法 JSON 引用误当成第三、第四个区服。 |
|
||||
| “非法”登录 | 区服列表成功不等于角色入场成功。签名日期的原实现使用四位年份 `yyyyMMdd`;`api.py` 目前使用 `%Y%m%d`,保留这个修复和协议请求序号的持久化。排查时按渠道验证、区服、入场、角色读取分阶段看日志。 |
|
||||
| 魔物的几种等级 | 普通等级/当前等级上限、同种突破 `tpLevel/tpExp`、潜能阶段 `potentialLevel` 是不同系统;同种突破最高 4 级的语义不能套到潜能阶段。低等级但尚未解锁上限的魔物不能一直吃经验,主培养到上限也不能自动转喂同种备用。 |
|
||||
| 潜能材料协议 | 历史修复确认 `monsterPotentialUpgrade` 的 `payload.itemId` 和名字容易误解的 `traceInfo.itemTypeId` 都使用道具堆栈实例 ID,不是静态道具类型 ID。修改前对照 AS3 和既有突破测试。 |
|
||||
| UI 性能与表格 | Qt 曾因跨表复用同一个 QTableWidgetItem 重复报警,也曾在大库存刷新后阻塞界面数秒。Web 延续后台工作线程、缓存视图与按需准备数据;不要在 GET 视图渲染里做游戏网络操作或每次全量重建所有账号。 |
|
||||
| 地图与探险 | 地图解锁信息按角色落地缓存,库存和消耗量按新快照更新;用户手动刷新才拉完整关卡进度。探险结束应自动领奖并释放队伍;成员正在探险要阻止整个原战队入场,不是把该成员丢掉后照样提交。 |
|
||||
| 反作弊研究 | `analysis/BATTLE_RULES.md` 记录历史检查分析。当前不应删除异常记录或把不支持、战败、未知响应直接包装成胜利;修复过的潜能异常应从原始属性解释查证。 |
|
||||
| 研究方案的时效性 | `analysis/V1_2_PLAN.md`、`analysis/V1_2_RUNTIME_IMPLEMENTATION.md`、`analysis/V1_2_SIMULATION_IMPLEMENTATION.md` 是历史研究。后来的用户明确选定快速公式模型;这些旧文档不能推翻当前 `battle_quick.py`、`battle_simulator.py` 和最新发布说明。 |
|
||||
| Git 历史与身份 | 早期曾整理 4 个本地提交作者为 `AttilaNet <zbolink@foxmail.com>`,再正常合入远程初始 MIT 提交。后来才形成当前 main/稳定标签流程;不要重做历史重写、改全局 Git 身份或凭旧会话把远程改回 GitHub。 |
|
||||
|
||||
## 合作偏好与下一步
|
||||
|
||||
- 用户希望直接推进,避免重复询问已授权的事项;中文、简洁、先讲结论。大量重复报错时要先找根因,不靠重试或表面改文案。
|
||||
- 用户希望主代理负责诊断、拆解、审查和集成,具体实现尽量委派给子代理;主代理必须独立检查代码和复现关键边界,不能照单子代理结论。
|
||||
- 修改共享核心时先约定文件/函数所有权,避免多个代理覆盖;测试使用 `python -X utf8 -B`,先写可失败的确定性离线回归,再修复。
|
||||
- 不要重新设计 UI、重写战斗引擎、重跑 APK 逆向或顺手做全面重构。先读当前实现和发布说明,围绕实际问题做最小修复。
|
||||
- 未经新一轮明确授权,不主动部署 X99。发布正式版本后由用户通过在线更新安装;不要以本地离线测试冒充生产结果。
|
||||
- 下一会话最先确认:当前 Git remotes、实际 HEAD、用户是否已升级 2.0.12,以及隐藏战斗/旧 pending 的生产反馈。若只是源码交接,不要自行制造新版本。
|
||||
@@ -0,0 +1,19 @@
|
||||
"""Local cooldown for confirmed battle losses."""
|
||||
import math
|
||||
from datetime import datetime, timedelta, timezone
|
||||
|
||||
|
||||
def loss_retry_reason(state, now, policy):
|
||||
limit = int(getattr(policy, "stop_after_loss", 0) or 0)
|
||||
if not limit or int(state.get("losses", 0)) < limit:
|
||||
return ""
|
||||
last_loss = state.get("last_loss_at")
|
||||
if type(last_loss) not in (int, float) or not math.isfinite(last_loss) or last_loss <= 0:
|
||||
last_loss = float(now)
|
||||
state["last_loss_at"] = last_loss
|
||||
deadline = last_loss + getattr(policy, "loss_retry_hours", 3) * 3600
|
||||
if now >= deadline:
|
||||
state.update(losses=0, last_loss_at=None)
|
||||
return ""
|
||||
retry_at = datetime.fromtimestamp(deadline, timezone(timedelta(hours=8))).strftime("%m-%d %H:%M:%S")
|
||||
return f"已达战败停止次数,冷却至 {retry_at}(北京时间)后自动重新检查并重试"
|
||||
@@ -32,6 +32,7 @@ from .resource_stages import resource_entry_reason, item_requirements, available
|
||||
from .quests import indexed, stage_has_level
|
||||
from .sweeping import SweepPolicy, hidden_stage_id
|
||||
from .team_availability import team_availability_reason
|
||||
from .battle_retry import loss_retry_reason
|
||||
|
||||
|
||||
def value(obj, name, default=None):
|
||||
@@ -152,6 +153,14 @@ class BattleJournal:
|
||||
state = self.role(snapshot)
|
||||
return next((r for r in state["records"] if r["attempt_id"] == state["pending"]), None)
|
||||
|
||||
def loss_reason(self, snapshot, policy):
|
||||
state = self.role(snapshot)
|
||||
before = (state.get("losses"), state.get("last_loss_at"))
|
||||
reason = loss_retry_reason(state, snapshot.now, policy)
|
||||
if before != (state.get("losses"), state.get("last_loss_at")):
|
||||
self.save()
|
||||
return reason
|
||||
|
||||
def records(self, snapshot):
|
||||
with self.lock:
|
||||
self.reload()
|
||||
@@ -201,8 +210,10 @@ class BattleJournal:
|
||||
shared_loss_budget = record.get("kind") != "map_battle" and not record.get("sweep_sample_id")
|
||||
if outcome == "loss" and shared_loss_budget:
|
||||
state["losses"] += 1
|
||||
state["last_loss_at"] = snapshot.now
|
||||
elif outcome == "win" and shared_loss_budget:
|
||||
state["losses"] = 0
|
||||
state["last_loss_at"] = None
|
||||
self.save()
|
||||
|
||||
def cursors(self, snapshot):
|
||||
@@ -350,9 +361,8 @@ class BattleOrchestrator:
|
||||
return "任务实例或服务器步骤已变化,请重新规划"
|
||||
if planner_validated is None and checkpoints.get(str(number), {}).get("submitted"):
|
||||
return "该任务步骤已有确认记录,等待剧情 / 服务器步骤核对"
|
||||
limit = max(0, int(policy.stop_after_loss))
|
||||
if limit and self.journal.role(snapshot)["losses"] >= limit:
|
||||
return "已达战败停止次数,请核对阵容后重置战败计数"
|
||||
if reason := self.journal.loss_reason(snapshot, policy):
|
||||
return reason
|
||||
reason = team_availability_reason(snapshot, policy.team)
|
||||
if reason:
|
||||
return reason
|
||||
|
||||
@@ -956,6 +956,8 @@ class Engine:
|
||||
try:
|
||||
self._ensure_progression()
|
||||
self._recover_confirmed_progression()
|
||||
retry_reason = self.progression_planner.battle_retry_reason(self.snapshot, self.progression_policy)
|
||||
journal_retry_reason = self.battle_journal.loss_reason(self.snapshot, self.progression_policy)
|
||||
self._battle_snapshot_source = self.snapshot
|
||||
self._battle_snapshot_digest = digest(self.snapshot.raw)
|
||||
self.progression_planner.battle_capability_key = digest({
|
||||
@@ -963,6 +965,7 @@ class Engine:
|
||||
key = digest({"snapshot": self._battle_snapshot_digest, "policy": vars(self.progression_policy),
|
||||
"quests": vars(self.quest_policy), "ranch": vars(self.policy), "local_state": self.progression_planner.state_signature(self.snapshot),
|
||||
"purchase_left": self.progression_planner.procurement_daily_left,
|
||||
"loss_retry": (retry_reason, journal_retry_reason),
|
||||
"pending": self._progression_pending(), "runtime": id(self.battles.runtime),
|
||||
"day": ProgressionPlanner._loop_day(self.snapshot, self.snapshot.now - 10)})
|
||||
if force or key != self._progression_cache_key:
|
||||
@@ -990,6 +993,7 @@ class Engine:
|
||||
self._progression_cache_key = digest({"snapshot": self._battle_snapshot_digest, "policy": vars(self.progression_policy),
|
||||
"quests": vars(self.quest_policy), "ranch": vars(self.policy), "local_state": self.progression_planner.state_signature(self.snapshot),
|
||||
"purchase_left": self.progression_planner.procurement_daily_left,
|
||||
"loss_retry": (retry_reason, journal_retry_reason),
|
||||
"pending": self._progression_pending(), "runtime": id(self.battles.runtime),
|
||||
"day": ProgressionPlanner._loop_day(self.snapshot, self.snapshot.now - 10)})
|
||||
self._progression_error = ""
|
||||
|
||||
@@ -40,6 +40,8 @@ def checked_progression_policy(data):
|
||||
if not isinstance(data, dict):
|
||||
raise ValueError("主线策略必须是对象")
|
||||
raw = asdict(ProgressionPolicy()) | data
|
||||
if type(raw["loss_retry_hours"]) is not int or not 1 <= raw["loss_retry_hours"] <= 168:
|
||||
raise ValueError("战败冷却时间须为1至168小时")
|
||||
for key in ("reserve_ti", "max_money"):
|
||||
if type(raw[key]) is not int or not 0 <= raw[key] <= 1_000_000_000:
|
||||
raise ValueError("主线策略数量超出范围:" + key)
|
||||
|
||||
@@ -45,8 +45,9 @@ import uuid
|
||||
|
||||
from .game_data import ProgressionData, load_progression_data
|
||||
from .model import Planner, seconds
|
||||
from .quests import commission_priority, commission_selection, commission_reason_kind, indexed, stage_has_level
|
||||
from .quests import commission_priority, commission_selection, commission_reason_kind, commission_quota_reason, indexed, stage_has_level
|
||||
from .procurement import ResourceProcurement, resource_kind
|
||||
from .battle_retry import loss_retry_reason
|
||||
|
||||
|
||||
CATEGORIES = {1: ("mainline", "主线"), 2: ("sidequest", "支线"),
|
||||
@@ -96,6 +97,7 @@ class ProgressionPolicy:
|
||||
allow_monsters: bool = False
|
||||
item_reserves: dict[str, int] = field(default_factory=dict)
|
||||
stop_after_loss: int = 1
|
||||
loss_retry_hours: int = 3
|
||||
repair_chain: bool = True
|
||||
battle_mode: str = "original"
|
||||
auto_farm: bool = True
|
||||
@@ -105,13 +107,15 @@ class ProgressionPolicy:
|
||||
"allow_sweep", "allow_items", "allow_monsters", "repair_chain", "auto_farm"):
|
||||
if not isinstance(getattr(self, name), bool):
|
||||
raise ValueError(f"{name} must be a boolean")
|
||||
for name in ("reserve_ti", "max_money", "stop_after_loss"):
|
||||
for name in ("reserve_ti", "max_money", "stop_after_loss", "loss_retry_hours"):
|
||||
value = getattr(self, name)
|
||||
if type(value) is not int or value < 0:
|
||||
raise ValueError(f"{name} must be a nonnegative integer")
|
||||
setattr(self, name, _integer(value))
|
||||
if self.stop_after_loss < 1:
|
||||
raise ValueError("stop_after_loss must be at least 1")
|
||||
if not 1 <= self.loss_retry_hours <= 168:
|
||||
raise ValueError("loss_retry_hours must be between 1 and 168")
|
||||
if (not isinstance(self.team, str) or not 1 <= len(self.team) <= 64
|
||||
or self.team.strip() != self.team or not self.team.isprintable()):
|
||||
raise ValueError("team must be a nonempty printable name of at most 64 characters")
|
||||
@@ -203,11 +207,15 @@ class ProgressionPlanner:
|
||||
"position": str(snapshot.raw.get("position") or ""), "tasks": {}, "received": {},
|
||||
"unlocked": [], "finished": [], "stage_unlocks": [], "city_unlocks": [],
|
||||
"stage_passes": [], "stage_levels": [], "stage_locks": [],
|
||||
"pending": None, "losses": 0, "applied": [],
|
||||
"pending": None, "losses": 0, "last_loss_at": None, "applied": [],
|
||||
"commissions": {"day": None, "remaining": None, "offers": None, "accepted": [], "expired_ids": [], "finished": []},
|
||||
})
|
||||
return scope, account
|
||||
|
||||
def battle_retry_reason(self, snapshot, policy):
|
||||
_, account = self._account(snapshot)
|
||||
return loss_retry_reason(account, snapshot.now, policy)
|
||||
|
||||
def _tasks(self, snapshot, account):
|
||||
received = {key: task for key, task in account["received"].items()
|
||||
if not account["tasks"].get(f"{_integer(task.get('id'))}:{key}", {}).get("removed")}
|
||||
@@ -626,8 +634,8 @@ class ProgressionPlanner:
|
||||
"""Reject an unusable battle before navigation or its before-story."""
|
||||
if _integer(snapshot.raw["master"].get("ti")) < policy.reserve_ti:
|
||||
return "当前体力低于保留体力"
|
||||
if account["losses"] >= policy.stop_after_loss:
|
||||
return "达到任务战败停止次数"
|
||||
if reason := loss_retry_reason(account, snapshot.now, policy):
|
||||
return reason
|
||||
if kind == "battle" and not step.get("battle"):
|
||||
return "任务战斗配置缺失"
|
||||
if kind == "passStage":
|
||||
@@ -742,7 +750,7 @@ class ProgressionPlanner:
|
||||
else:
|
||||
return []
|
||||
scope, account = self._account(snapshot)
|
||||
if account["losses"] >= policy.stop_after_loss:
|
||||
if loss_retry_reason(account, snapshot.now, policy):
|
||||
return []
|
||||
ranked = []
|
||||
seen = set()
|
||||
@@ -1008,7 +1016,7 @@ class ProgressionPlanner:
|
||||
city_info = self.city_diagnostic(city, snapshot)
|
||||
supply = None
|
||||
reason = ("城市编号无效" if city <= 0 else
|
||||
"当日接取次数已用完(剩余0次),等待次日刷新" if remaining <= 0 else
|
||||
commission_quota_reason(snapshot) if remaining <= 0 else
|
||||
f"策略限定城市 {quest_policy.city}" if quest_policy.city and city != quest_policy.city else
|
||||
city_info["city_reason"] if not city_info["city_unlocked"] else
|
||||
"委托列表已跨日,等待刷新确认" if recorded is not None and recorded != today and account["commissions"]["day"] != today else
|
||||
@@ -1335,6 +1343,7 @@ class ProgressionPlanner:
|
||||
record["next_value"] = response.get("taskStepValue")
|
||||
if intent.kind == "progression_battle" and not _from_snapshot:
|
||||
account["losses"] = 0
|
||||
account["last_loss_at"] = None
|
||||
if intent.battle_kind == "passStage":
|
||||
# Exact TaskStartPanel.step2WinHandler -> passLocalStage
|
||||
# effects, only after the real step settlement succeeded.
|
||||
@@ -1492,6 +1501,7 @@ class ProgressionPlanner:
|
||||
if intent.account_key != scope or intent.kind != "progression_battle":
|
||||
raise ValueError("Battle intent/account mismatch")
|
||||
account["losses"] += 1
|
||||
account["last_loss_at"] = snapshot.now
|
||||
if account["pending"] and account["pending"]["token"] == intent.token:
|
||||
account["pending"] = None
|
||||
|
||||
@@ -1518,10 +1528,12 @@ class ProgressionPlanner:
|
||||
for scope, account in restored.items():
|
||||
if not re.fullmatch(r"[0-9a-f]{64}", scope) or not isinstance(account, dict):
|
||||
raise ValueError("Invalid local progression account")
|
||||
account.setdefault("last_loss_at", None)
|
||||
for key in ("stage_passes", "stage_levels", "stage_locks"):
|
||||
account.setdefault(key, [])
|
||||
account.setdefault("commissions", {"day": None, "remaining": None, "offers": None, "accepted": [], "expired_ids": [], "finished": []})
|
||||
required = {"position", "tasks", "received", "unlocked", "finished", "stage_unlocks", "city_unlocks", "pending", "losses", "applied", "stage_passes", "stage_levels", "stage_locks", "commissions"}
|
||||
required.add("last_loss_at")
|
||||
if set(account) != required or not isinstance(account["tasks"], dict) or not isinstance(account["received"], dict):
|
||||
raise ValueError("Invalid local progression state fields")
|
||||
if account["pending"]:
|
||||
|
||||
@@ -265,9 +265,9 @@ class ProgressionPages:
|
||||
self.progression_team.addItem(team, team)
|
||||
form.addRow("推进战斗队伍", self.progression_team)
|
||||
for key, label, maximum in (("reserve_ti", "保留体力", 1_000_000_000), ("max_money", "单次交付金币上限(0=不交金币)", 1_000_000_000),
|
||||
("stop_after_loss", "连续失败后停止次数", 999)):
|
||||
("stop_after_loss", "连续失败后停止次数", 999), ("loss_retry_hours", "战败冷却时间(小时)", 168)):
|
||||
widget = IntegerInput()
|
||||
widget.setRange(1 if key == "stop_after_loss" else 0, maximum)
|
||||
widget.setRange(1 if key in ("stop_after_loss", "loss_retry_hours") else 0, maximum)
|
||||
widget.setValue(getattr(defaults, key))
|
||||
setattr(self, "progression_" + key, widget)
|
||||
form.addRow(label, widget)
|
||||
|
||||
@@ -7,6 +7,14 @@ from .model import Action, Planner, seconds
|
||||
CN = timezone(timedelta(hours=8))
|
||||
|
||||
|
||||
def commission_quota_reason(snapshot):
|
||||
offset = (9 if (snapshot.raw.get("client_context") or {}).get("lang") == "JP" else 8) * 3600
|
||||
day = int((snapshot.now - 10 + offset) // 86400)
|
||||
reset_at = (day + 1) * 86400 - offset + 10
|
||||
stamp = datetime.fromtimestamp(reset_at, timezone(timedelta(seconds=offset))).strftime("%m-%d %H:%M:%S")
|
||||
return f"当日接取次数已用完(剩余0次),等待 {stamp} 自动刷新后继续"
|
||||
|
||||
|
||||
def commission_reason_kind(reason):
|
||||
text = str(reason or "")
|
||||
for kind, words in (
|
||||
|
||||
@@ -0,0 +1,139 @@
|
||||
"""Offline checks for cooldown recovery and midnight quota refresh."""
|
||||
from datetime import datetime, timedelta, timezone
|
||||
from pathlib import Path
|
||||
import tempfile
|
||||
import unittest
|
||||
from unittest.mock import Mock, patch
|
||||
|
||||
from ranch_assistant.battles import BattleJournal
|
||||
from ranch_assistant.engine import Engine
|
||||
from ranch_assistant.game_data import ProgressionData
|
||||
from ranch_assistant.model import Catalog, Policy
|
||||
from ranch_assistant.policy_io import checked_progression_policy
|
||||
from ranch_assistant.progression import ProgressionPlanner, ProgressionPolicy
|
||||
from ranch_assistant.quests import QuestPolicy
|
||||
from ranch_assistant.tests.test_progression import config, snapshot, step, task
|
||||
|
||||
|
||||
class BattleRetryTests(unittest.TestCase):
|
||||
def setUp(self):
|
||||
self.catalog = Catalog()
|
||||
self.tasks = {"400": task("400", type=4, steps=[step("battle", battle={"teams": []})])}
|
||||
self.snapshot = snapshot(currentTasks=[{"id": 40, "typeId": "400", "curStep": 1}])
|
||||
self.planner = ProgressionPlanner(self.catalog, config(self.tasks))
|
||||
self.quest = QuestPolicy(enabled=True, battle_tasks=True)
|
||||
self.policy = ProgressionPolicy()
|
||||
|
||||
def test_configured_interval_controls_next_battle_attempt(self):
|
||||
self.policy.loss_retry_hours = 2
|
||||
with patch("ranch_assistant.model.time.time", return_value=100000):
|
||||
self.planner.battle_lost(self.snapshot, self.plan()[0])
|
||||
with patch("ranch_assistant.model.time.time", return_value=107199):
|
||||
self.assertTrue(self.plan()[0].blocked)
|
||||
with patch("ranch_assistant.model.time.time", return_value=107200):
|
||||
self.assertFalse(self.plan()[0].blocked)
|
||||
|
||||
def test_retry_hour_validation(self):
|
||||
self.assertEqual(checked_progression_policy({}).loss_retry_hours, 3)
|
||||
for hours in (0, 169, True, 1.5):
|
||||
with self.subTest(hours=hours), self.assertRaises(ValueError):
|
||||
checked_progression_policy({"loss_retry_hours": hours})
|
||||
|
||||
def test_legacy_loss_wait_survives_planner_restore(self):
|
||||
account = self.planner._account(self.snapshot)[1]
|
||||
account.update(losses=1)
|
||||
account.pop("last_loss_at")
|
||||
state = self.planner.export_state()
|
||||
self.planner.restore_state(state)
|
||||
with patch("ranch_assistant.model.time.time", return_value=100000):
|
||||
self.assertTrue(self.plan()[0].blocked)
|
||||
state = self.planner.export_state()
|
||||
self.planner.restore_state(state)
|
||||
with patch("ranch_assistant.model.time.time", return_value=110799):
|
||||
self.assertTrue(self.plan()[0].blocked)
|
||||
with patch("ranch_assistant.model.time.time", return_value=110800):
|
||||
self.assertFalse(self.plan()[0].blocked)
|
||||
|
||||
def plan(self):
|
||||
return self.planner.commission_plan(self.snapshot, self.quest, Policy(), battle_policy=self.policy)
|
||||
|
||||
def test_loss_wait_expires_without_changing_task_progress(self):
|
||||
with patch("ranch_assistant.model.time.time", return_value=100000):
|
||||
intent = self.plan()[0]
|
||||
self.planner.battle_lost(self.snapshot, intent)
|
||||
blocked = self.plan()[0]
|
||||
self.assertIn("冷却", blocked.block_reason)
|
||||
with patch("ranch_assistant.model.time.time", return_value=110799):
|
||||
self.assertTrue(self.plan()[0].blocked)
|
||||
with patch("ranch_assistant.model.time.time", return_value=110800):
|
||||
resumed = self.plan()[0]
|
||||
self.assertFalse(resumed.blocked)
|
||||
self.assertEqual(resumed.kind, "progression_battle")
|
||||
self.assertEqual(resumed.step_number, 1)
|
||||
|
||||
def test_quota_exhaustion_waits_for_midnight_reset(self):
|
||||
now = datetime(2026, 11, 16, 12, tzinfo=timezone(timedelta(hours=8))).timestamp()
|
||||
self.snapshot.raw["currentTasks"] = []
|
||||
self.snapshot.raw["history"].update(loopTaskTime=now, loopTaskNum=0, loopTask={"1": ["400"]})
|
||||
with patch("ranch_assistant.model.time.time", return_value=now):
|
||||
self.assertEqual(self.plan(), [])
|
||||
row = self.planner.commission_offers(self.snapshot, self.quest, Policy())[0]
|
||||
self.assertIn("00:00", row["reason"])
|
||||
self.assertIn("自动", row["reason"])
|
||||
with patch("ranch_assistant.model.time.time", return_value=now + 2 * 86400):
|
||||
self.assertEqual(self.plan()[0].kind, "progression_loop_reset")
|
||||
|
||||
def test_old_policy_uses_three_hour_default(self):
|
||||
self.assertEqual(self.policy.loss_retry_hours, 3)
|
||||
|
||||
def test_restart_keeps_original_loss_deadline(self):
|
||||
with tempfile.TemporaryDirectory() as root:
|
||||
path = Path(root) / "battle.json"
|
||||
with patch("ranch_assistant.model.time.time", return_value=100000):
|
||||
journal = BattleJournal(path)
|
||||
record = journal.begin(self.snapshot, {"kind": "progression_battle"})
|
||||
journal.finish(self.snapshot, record, "loss")
|
||||
original = journal.loss_reason(self.snapshot, self.policy)
|
||||
with patch("ranch_assistant.model.time.time", return_value=103600):
|
||||
restarted = BattleJournal(path)
|
||||
self.assertEqual(restarted.loss_reason(self.snapshot, self.policy), original)
|
||||
with patch("ranch_assistant.model.time.time", return_value=110800):
|
||||
restarted = BattleJournal(path)
|
||||
self.assertEqual(restarted.loss_reason(self.snapshot, self.policy), "")
|
||||
self.assertEqual(restarted.role(self.snapshot)["losses"], 0)
|
||||
|
||||
def test_expired_cooldown_preserves_unknown_request(self):
|
||||
journal = BattleJournal()
|
||||
journal.role(self.snapshot).update(losses=1, last_loss_at=100000)
|
||||
record = journal.begin(self.snapshot, {"kind": "progression_battle"})
|
||||
journal.update(record, "unknown", message="verify first")
|
||||
with patch("ranch_assistant.model.time.time", return_value=110800):
|
||||
self.assertEqual(journal.loss_reason(self.snapshot, self.policy), "")
|
||||
self.assertEqual(journal.pending(self.snapshot)["phase"], "unknown")
|
||||
|
||||
def test_cooldown_boundary_invalidates_engine_cached_intents(self):
|
||||
engine = Engine(self.catalog, game_data=ProgressionData(config(self.tasks)))
|
||||
engine.snapshot = self.snapshot
|
||||
engine.quest_policy = self.quest
|
||||
engine._battle_capability = Mock(return_value=(True, ""))
|
||||
with patch("ranch_assistant.model.time.time", return_value=100000):
|
||||
engine._ensure_progression()
|
||||
engine.progression_planner._account(self.snapshot)[1].update(losses=1, last_loss_at=100000)
|
||||
engine.battle_journal.role(self.snapshot).update(losses=1, last_loss_at=100000)
|
||||
engine._refresh_progression_cache(force=True)
|
||||
self.assertTrue(engine._progression_intents[0].blocked)
|
||||
with patch("ranch_assistant.model.time.time", return_value=110800):
|
||||
engine._refresh_progression_cache()
|
||||
self.assertFalse(engine._progression_intents[0].blocked)
|
||||
self.assertEqual(engine.battle_journal.role(self.snapshot)["losses"], 0)
|
||||
engine.auto = False
|
||||
engine.demo = False
|
||||
engine.client = Mock()
|
||||
engine.read_snapshot = Mock(return_value=self.snapshot)
|
||||
engine.settle_pending_growth = Mock(return_value=False)
|
||||
engine.poll()
|
||||
self.assertFalse(engine.last_executed)
|
||||
engine.client.call.assert_not_called()
|
||||
engine.quest_policy.enabled = False
|
||||
engine._refresh_progression_cache(force=True)
|
||||
self.assertEqual(engine._progression_intents, [])
|
||||
@@ -1,8 +1,10 @@
|
||||
# 牧羊人之心牧场助手 · Web 2.0.12
|
||||
# 牧羊人之心牧场助手 · Web 2.0.13
|
||||
|
||||
**2.0.13** 新增战败冷却自动重试:主线与委托达到连续战败上限后,默认等待3小时,可配置1~168小时;冷却结束后重新检查队伍、资源和策略授权。冷却跨重启保留,手动停止和未知请求不重发的规则继续生效。每日委托额度耗尽时显示下次刷新时间。见 [2.0.13 发布说明](../analysis/RELEASE_2_0_13.md)。
|
||||
|
||||
## 产品约束
|
||||
|
||||
把现有桌面助手的功能和操作结构迁移至单管理员 Web 工作台。桌面版是页面顺序、信息密度、业务名称、保护条件与交互的依据,保留桌面兼容。Web `2.0.12`,源码发布入口 `main`,游戏数据版本 `1.9.68`;桌面正式版保留 `1.2.0`。启动与配置见 [运行说明](README.md),Docker 与更新条件见 [部署说明](../deploy/web/README.md),既有功能与历史验证见 [2.0.8 发布说明](../analysis/RELEASE_2_0_8.md)。
|
||||
把现有桌面助手的功能和操作结构迁移至单管理员 Web 工作台。桌面版是页面顺序、信息密度、业务名称、保护条件与交互的依据,保留桌面兼容。Web `2.0.13`,源码发布入口 `main`,游戏数据版本 `1.9.68`;桌面正式版保留 `1.2.0`。启动与配置见 [运行说明](README.md),Docker 与更新条件见 [部署说明](../deploy/web/README.md),既有功能与历史验证见 [2.0.8 发布说明](../analysis/RELEASE_2_0_8.md)。
|
||||
|
||||
2.0.12 聚焦扫荡隐藏事件的自动战斗接续与旧缺失响应记录的本地归档;保留账号简短状态、错误、表格、表单与原单一底部分类日志,见 [本版发布说明](../analysis/RELEASE_2_0_12.md)。
|
||||
|
||||
@@ -28,7 +30,7 @@
|
||||
- 帮助可检查 GitHub 正式版本并提交受控更新请求。未配置部署器时明确显示原因,更新提交不表示更新成功。
|
||||
- 已在 2.0.1 完成私有仓库和 GHCR 认证的部署,稳定 Release 与正式镜像发布后,可直接通过“帮助 → 检查版本更新…”升级,无需先安装 2.0.2、重复初始化或替换宿主机更新器;升级完成后刷新网页以加载新版界面,安装结果以宿主机健康检查为准。
|
||||
|
||||
## 2.0.12 本轮范围
|
||||
## 2.0.12 历史修复
|
||||
|
||||
- 完整入场响应与原始队伍快照等原始输入均已保存且可验证时,隐藏事件才按 `stageEvent.hideStageId` 直接构建隐藏关卡难度1的战斗,关闭扫荡并自动战斗,无需手动确认,不再发送第二次 `stageStart`;`battleEnd` / `recordBattleResult` 使用隐藏 ID。
|
||||
- 新记录或可恢复旧记录仅在完整入场及原始输入可验证时自动续打,保留用户停止、来源策略及未知已发送请求的核对约束。旧记录即使能从 trace 找回隐藏 ID,缺少原始队伍也保留中文待核对状态,不用当前属性替代原始属性,不发送游戏写请求。
|
||||
@@ -97,7 +99,7 @@
|
||||
|
||||
## 安全与验证
|
||||
|
||||
本版共 **491 项唯一仓库测试:489 通过、2 项 Windows 预期跳过,0 失败 / 错误**,见 [2.0.12 发布说明](../analysis/RELEASE_2_0_12.md#验证)。2.0.11 的测试结果见 [历史发布说明](../analysis/RELEASE_2_0_11.md#验证),不计入本版;战斗模型仍为近似实现。
|
||||
2.0.12 历史版本共 **491 项唯一仓库测试:489 通过、2 项 Windows 预期跳过,0 失败 / 错误**,见 [2.0.12 发布说明](../analysis/RELEASE_2_0_12.md#验证)。2.0.11 的测试结果见 [历史发布说明](../analysis/RELEASE_2_0_11.md#验证),不计入本版;战斗模型仍为近似实现。
|
||||
|
||||
2.0.9 的历史验证见 [历史发布说明](../analysis/RELEASE_2_0_9.md#验证),不计入本版。
|
||||
|
||||
|
||||
+7
-5
@@ -1,8 +1,10 @@
|
||||
# Web 2.0.12 运行说明
|
||||
# Web 2.0.13 运行说明
|
||||
|
||||
Web **2.0.12**,源码发布入口 `main`,游戏资料基线 **1.9.68**。桌面正式版保留 **1.2.0**,入口为 `python -m ranch_assistant`;Web 使用独立依赖与数据根。自动委托提供当前委托与每日记录,功能和历史验证状态见 [2.0.8 发布说明](../analysis/RELEASE_2_0_8.md)。
|
||||
**2.0.13** 新增战败冷却自动重试:主线与委托达到连续战败上限后,默认等待3小时,可配置1~168小时;冷却结束后重新检查队伍、资源和策略授权。冷却跨重启保留,手动停止和未知请求不重发的规则继续生效。每日委托额度耗尽时显示下次刷新时间。见 [2.0.13 发布说明](../analysis/RELEASE_2_0_13.md)。
|
||||
|
||||
2.0.12 修复扫荡触发隐藏关卡后的接续:完整入场响应与原始队伍快照等原始输入均已保存且可验证时,新记录或可恢复旧记录才按 `stageEvent.hideStageId` 构建隐藏关卡难度1的战斗,自动战斗且无需手动确认,不再发送第二次 `stageStart`,战后使用隐藏 ID 结算。旧记录即使能从 trace 找回隐藏 ID,缺少原始队伍也保留中文待核对状态,不用当前属性替代原始属性,不发送游戏写请求。现场旧 `0211 / 3` pending 的原始响应已被日志轮转覆盖,隐藏 ID 无法还原;仅对符合精确四字段 legacy 形态、严格确认已入场且未结算的这类旧阶段,保留证据、本地归档为未完成并放弃,不提交胜负或重发入场,让后续策略继续。归档不等于服务端已结算,本版未在生产打通当前这场战斗,见 [本版发布说明](../analysis/RELEASE_2_0_12.md)。
|
||||
Web **2.0.13**,源码发布入口 `main`,游戏资料基线 **1.9.68**。桌面正式版保留 **1.2.0**,入口为 `python -m ranch_assistant`;Web 使用独立依赖与数据根。自动委托提供当前委托与每日记录,功能和历史验证状态见 [2.0.8 发布说明](../analysis/RELEASE_2_0_8.md)。
|
||||
|
||||
2.0.13 修复扫荡触发隐藏关卡后的接续:完整入场响应与原始队伍快照等原始输入均已保存且可验证时,新记录或可恢复旧记录才按 `stageEvent.hideStageId` 构建隐藏关卡难度1的战斗,自动战斗且无需手动确认,不再发送第二次 `stageStart`,战后使用隐藏 ID 结算。旧记录即使能从 trace 找回隐藏 ID,缺少原始队伍也保留中文待核对状态,不用当前属性替代原始属性,不发送游戏写请求。现场旧 `0211 / 3` pending 的原始响应已被日志轮转覆盖,隐藏 ID 无法还原;仅对符合精确四字段 legacy 形态、严格确认已入场且未结算的这类旧阶段,保留证据、本地归档为未完成并放弃,不提交胜负或重发入场,让后续策略继续。归档不等于服务端已结算,本版未在生产打通当前这场战斗,见 [本版发布说明](../analysis/RELEASE_2_0_12.md)。
|
||||
|
||||
正常执行默认使用现有内置实验运行时入口的快速 HP/DPS 模型,保留现有伤害配置,无需选择新模式;逐帧实现仅供研发。模型按双方属性、血量、每秒伤害、时间与目标估算胜利、战败或超时,仍有机制简化,不保证全部关卡可通关或与客户端结果一致。
|
||||
|
||||
@@ -108,11 +110,11 @@ sh start-web.sh --no-browser
|
||||
|
||||
Web 检查固定官方 GitHub Releases 的稳定 `v2.x.y`,跳过桌面 1.x、未来 3.x、草稿和预发布。开发版本 `2.0.0.dev1` 可升级至同数字的正式 `v2.0.0`;没有正式 Web 2 发布时明确显示暂无更新。Windows 默认仅检查;Web “更新”按钮仅在宿主机显式启用并有有效只读心跳时可提交 `pending` 请求,安装、备份和回滚由宿主机执行。默认定时检查只通知,自动安装需操作者 opt-in。
|
||||
|
||||
已在 **2.0.1** 完成私有仓库和 GHCR 认证的部署,稳定 Release 和正式镜像就绪、宿主机心跳有效后,可直接通过“帮助 → 检查版本更新…”升级 **2.0.12**,无需先安装 2.0.2、重复初始化或替换宿主机更新器。升级完成后刷新网页以加载新版界面,底部日志默认收起。安装结果以宿主机健康检查为准;首次配置仅供尚未初始化的宿主机参考。
|
||||
已在 **2.0.1** 完成私有仓库和 GHCR 认证的部署,稳定 Release 和正式镜像就绪、宿主机心跳有效后,可直接通过“帮助 → 检查版本更新…”升级 **2.0.13**,无需先安装 2.0.2、重复初始化或替换宿主机更新器。升级完成后刷新网页以加载新版界面,底部日志默认收起。安装结果以宿主机健康检查为准;首次配置仅供尚未初始化的宿主机参考。
|
||||
|
||||
## 离线验证
|
||||
|
||||
本版共 **491 项唯一仓库测试:489 通过、2 项 Windows 预期跳过,0 失败 / 错误**,见 [2.0.12 发布说明](../analysis/RELEASE_2_0_12.md#验证)。镜像工作流在安装测试依赖后,独立执行隐藏关卡 handoff、battles、engine 三个专用回归模块;通过 `ranch_web/requirements-test.txt` 安装 HTTPX 的修复继续保留。2.0.11 的测试结果见 [历史发布说明](../analysis/RELEASE_2_0_11.md#验证),不计入本版。以下为继续保留的子进程传输、战斗恢复、能力展示、Web 生命周期、恢复契约及状态 API 回归命令:
|
||||
2.0.12 历史版本共 **491 项唯一仓库测试:489 通过、2 项 Windows 预期跳过,0 失败 / 错误**,见 [2.0.12 发布说明](../analysis/RELEASE_2_0_12.md#验证)。镜像工作流在安装测试依赖后,独立执行隐藏关卡 handoff、battles、engine 三个专用回归模块;通过 `ranch_web/requirements-test.txt` 安装 HTTPX 的修复继续保留。2.0.11 的测试结果见 [历史发布说明](../analysis/RELEASE_2_0_11.md#验证),不计入本版。以下为继续保留的子进程传输、战斗恢复、能力展示、Web 生命周期、恢复契约及状态 API 回归命令:
|
||||
|
||||
```console
|
||||
python -B -m unittest ranch_assistant.tests.test_battle_worker_transport ranch_assistant.tests.test_battle_recovery ranch_assistant.tests.test_battle_capability_presentation ranch_web.tests.test_lifecycle_recovery ranch_web.tests.test_battle_recovery_contract ranch_web.tests.test_status_recovery_api -v
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
"""Headless Web workspace for the ranch assistant."""
|
||||
|
||||
__version__ = "2.0.12"
|
||||
__version__ = "2.0.13"
|
||||
GAME_VERSION = "1.9.68"
|
||||
|
||||
__all__ = ["__version__", "GAME_VERSION"]
|
||||
|
||||
@@ -166,6 +166,7 @@ def validate_config(config):
|
||||
for section in ("sweep_policy", "progression_policy"):
|
||||
_choice(result[section]["team"], ("teamA", "teamB", "teamC"), "战队")
|
||||
_int(result["progression_policy"]["stop_after_loss"], "连续失败停止次数", 1, 999)
|
||||
_int(result["progression_policy"]["loss_retry_hours"], "战败冷却小时", 1, 168)
|
||||
_object(result["explore_policy"]["teams"], "探险队伍")
|
||||
for key, raw in result["explore_policy"]["teams"].items():
|
||||
_id(key, "探险队伍")
|
||||
|
||||
@@ -415,7 +415,7 @@ async function exportYields(account=current()) {
|
||||
async function command(name,account=current()) {
|
||||
try {
|
||||
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.12'}`}),el('p',{text:`游戏数据版本 ${state.meta?.gameVersion || '1.9.68'}`})),{info:true});
|
||||
if(name==='about')return dialog('关于牧场助手',el('div',{},el('p',{text:`牧羊人之心牧场助手 Web ${state.meta?.version || '2.0.13'}`}),el('p',{text:`游戏数据版本 ${state.meta?.gameVersion || '1.9.68'}`})),{info:true});
|
||||
if(name==='updates')return await showUpdates();
|
||||
if(name==='admin-logout'){hideWorkbench();try{await api.logout();}finally{requireAuth();}return;}
|
||||
if(!account)throw new Error('请先新增或选择账号。');
|
||||
@@ -640,7 +640,7 @@ async function bootstrap() {
|
||||
$('#app').hidden=false;
|
||||
const [meta,schema]=await Promise.all([api.meta(),api.schema()]);state.meta=meta;state.schema=schema;
|
||||
if(state.redirecting)return;
|
||||
$('#app-version').textContent=meta.version || '2.0.12';$('#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.13';$('#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('工作台已连接');
|
||||
}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>
|
||||
<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>
|
||||
<span class="window-title">牧羊人之心牧场助手 <span id="app-version">2.0.12</span></span>
|
||||
<span class="window-title">牧羊人之心牧场助手 <span id="app-version">2.0.13</span></span>
|
||||
<span id="access-mode" class="muted"></span>
|
||||
</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>
|
||||
|
||||
+3
-1
@@ -69,6 +69,8 @@ def _strategy_fields(catalog):
|
||||
quest += [_field(["quest_policy", "city"], "城市编号(0=所有已解锁城市)", "integer", min=0, max=99),
|
||||
_field(["quest_policy", "max_money"], "单次最多提交金币", "integer", min=0, max=10_000_000),
|
||||
_field(["quest_policy", "item_reserves"], "保留道具", "id_counts")]
|
||||
quest += [_field(["progression_policy", "stop_after_loss"], "连续战败暂停次数(与主线共用)", "integer", min=1, max=999),
|
||||
_field(["progression_policy", "loss_retry_hours"], "战败冷却时间(小时)", "integer", min=1, max=168)]
|
||||
progression_labels = [("enabled", "启用自动主线策略"), ("mainline", "主线"), ("sidequests", "支线"),
|
||||
("commissions", "委托(仅诊断)"), ("accept", "接取已确认的任务"), ("auto_dialogue", "自动推进已支持的对话"),
|
||||
("repair_chain", "补全已确认的任务链"), ("allow_items", "允许提交物品"), ("allow_monsters", "允许提交魔物"),
|
||||
@@ -77,7 +79,7 @@ def _strategy_fields(catalog):
|
||||
progression += [_field(["progression_policy", "team"], "推进战斗队伍", "select", options=team_options)]
|
||||
progression += [_field(["progression_policy", key], label, "integer", min=low, max=high) for key, label, low, high in (
|
||||
("reserve_ti", "保留体力", 0, 1_000_000_000), ("max_money", "单次交付金币上限(0=不交金币)", 0, 1_000_000_000),
|
||||
("stop_after_loss", "连续失败后停止次数", 1, 999))]
|
||||
("stop_after_loss", "连续失败后停止次数", 1, 999), ("loss_retry_hours", "战败冷却时间(小时)", 1, 168))]
|
||||
progression += [_field(["progression_policy", "item_reserves"], "交付后至少保留物品", "id_counts")]
|
||||
maps = [_field(["sweep_policy", key], label) for key, label in (
|
||||
("enabled", "启用勾选关卡自动刷图"), ("allow_challenge", "未满星时自动挑战"), ("allow_special", "允许矿洞 / 门票关卡"))]
|
||||
|
||||
Reference in New Issue
Block a user