docs: preserve project context and Gitea handoff
This commit is contained in:
+122
@@ -0,0 +1,122 @@
|
||||
# 项目交接入口
|
||||
|
||||
> 整理日期: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 路径是本机证据定位,不是仓库携带的附件。新模型不需要依赖先前聊天或自动注入的记忆工具;以当前代码、这些文档及能实际读取的证据为准。
|
||||
@@ -170,6 +170,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,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 的生产反馈。若只是源码交接,不要自行制造新版本。
|
||||
Reference in New Issue
Block a user