release: prepare Web 2.0.0

This commit is contained in:
AttilaNet
2026-11-11 11:23:43 +08:00
parent 654567caa3
commit 923a367263
13 changed files with 73 additions and 49 deletions
+2 -2
View File
@@ -1,8 +1,8 @@
# 牧羊人之心牧场助手 · Web
# 牧羊人之心牧场助手 · Web 2.0.0
## 产品约束
把现有桌面助手的功能和操作结构迁移至单管理员 Web 工作台。桌面版是页面顺序、信息密度、业务名称、保护条件与交互的依据,保留桌面兼容。版本为 `2.0.0.dev1`,游戏数据版本 `1.9.68`;本次不合并 main、不发布正式版本。
把现有桌面助手的功能和操作结构迁移至单管理员 Web 工作台。桌面版是页面顺序、信息密度、业务名称、保护条件与交互的依据,保留桌面兼容。Web 正式版本为 `2.0.0`,源码入口 `main`,游戏数据版本 `1.9.68`;桌面正式版保留 `1.2.0`。启动与配置见 [运行说明](README.md),Docker 与更新条件见 [部署说明](../deploy/web/README.md)。
使用者在 Windows 本机配置、验证,随后可在 Linux Docker 常驻运行。多个浏览器访问同一个管理员工作台;账号互相隔离,各账号串行执行,账号之间可以并行。
+7 -5
View File
@@ -1,6 +1,6 @@
# Web 2 开发运行
# Web 2.0.0 运行说明
Web 包版本 **2.0.0.dev1**,游戏资料基线 **1.9.68**,开发分支 `develop/v2.0.0`。当前正式桌面版仍为 1.2.0;Web 未合并 main、未发布正式版本。桌面入口 `python -m ranch_assistant` 保留,Web 使用独立依赖与数据根。
Web 正式版本 **2.0.0**,源码入口 `main`,游戏资料基线 **1.9.68**。桌面正式版保留 **1.2.0**,入口为 `python -m ranch_assistant`;Web 使用独立依赖与数据根。
Web 采用 FastAPI / Uvicorn 和原生 HTML/CSS/ES 模块,无 Node、npm 或前端编译步骤,不安装 PySide6。页面和策略能力沿用现有核心,详细业务范围与原有限制见 [桌面使用说明](../ranch_assistant/README.md)。多浏览器连接同一个管理员工作台;一个服务实例内,各账号独立线程并行,同一账号操作串行。
@@ -10,9 +10,9 @@ Web 采用 FastAPI / Uvicorn 和原生 HTML/CSS/ES 模块,无 Node、npm 或
- [x] 保留账号页签、顶部数值与统一启停、可调日志;规则自动保存,配置与统计按账号/角色隔离,重启、恢复会话及导入策略后保持停止。
- [x] Windows Python 启动与离线演示;Web 导入链和依赖不使用 Qt,无 Node 构建步骤。
- [x] 提供 Linux Docker 与稳定 2.x 受控更新、停机备份及失败回滚脚本;已完成 Linux Docker 部署、持久化权限、健康检查和定时更新检查烟测。
- [x] 开发版本为 `2.0.0.dev1`,保留桌面兼容,不等同正式发布或真实游戏 API 验收。
- [x] 正式版本为 `2.0.0`,保留桌面兼容;战斗模拟为近似模型,特殊关卡并非全部支持,真实游戏 API 验收范围不因版本号变更而扩大。
## Windows 本地开发
## Windows 本地运行
使用 Python 3.12+,在项目根目录执行(本机已安装 3.13):
@@ -77,7 +77,9 @@ Web 检查固定官方 GitHub Releases 的稳定 `v2.x.y`,跳过桌面 1.x、
## 离线验证
本次后台连接与日志修复:Web 后端 **245 项中 244 通过、1 项因 Windows 符号链接权限跳过**,浏览器 **31 项全部通过**;独立故障重放四组通过。行为与证据边界见 [连接修复说明](../analysis/WEB_CONNECTION_FIX.md)。现有后端命令追加 `ranch_web.tests.test_base_path ranch_web.tests.test_activity ranch_web.tests.test_connection_state`,浏览器命令追加 `ranch_web.tests.browser.test_base_path_browser ranch_web.tests.browser.test_connection_browser.ConnectionBrowserTests` 可覆盖本次回归。
2.0.0 发布整理本轮仅调整版本元数据,API 策略与行为未改;完整 Web 后端回归 **246 项:245 通过、1 项因 Windows 符号链接权限跳过、0 失败**。以下保留此前功能提交及开发阶段的验证记录。
前一功能提交的后台连接与日志修复:Web 后端 **245 项中 244 通过、1 项因 Windows 符号链接权限跳过**,浏览器 **31 项全部通过(本轮未重跑)**;独立故障重放四组通过。行为与证据边界见 [连接修复说明](../analysis/WEB_CONNECTION_FIX.md)。现有后端命令追加 `ranch_web.tests.test_base_path ranch_web.tests.test_activity ranch_web.tests.test_connection_state`,浏览器命令追加 `ranch_web.tests.browser.test_base_path_browser ranch_web.tests.browser.test_connection_browser.ConnectionBrowserTests` 可覆盖该功能回归。
独立管理登录页调整后的完整非浏览器后端验证为 **193项:192通过、1跳过(Windows符号链接权限),0失败/错误,用时26.994秒**。以下命令显式列出全部10个后端模块,避免发现并混入浏览器测试:
+1 -1
View File
@@ -1,6 +1,6 @@
"""Headless Web workspace for the ranch assistant."""
__version__ = "2.0.0.dev1"
__version__ = "2.0.0"
GAME_VERSION = "1.9.68"
__all__ = ["__version__", "GAME_VERSION"]
+3 -1
View File
@@ -17,6 +17,8 @@ from ranch_assistant.progression import ProgressionPolicy
from ranch_assistant.exploration import ExplorePolicy
from ranch_assistant import policy_io
from . import __version__
POLICY_CLASSES = {
"policy": Policy, "quest_policy": QuestPolicy, "daily_policy": DailyPolicy,
@@ -217,7 +219,7 @@ def apply_config(engine, config):
def export_config(config, snapshot=None):
value = policy_io.portable_config(validate_config(config), snapshot)
value["assistantVersion"] = "2.0.0.dev1"
value["assistantVersion"] = __version__
return value
+2 -2
View File
@@ -372,7 +372,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.0.dev1'}`}),el('p',{text:`游戏数据版本 ${state.meta?.gameVersion || '1.9.68'}`}),el('p',{class:'info-note',text:'与桌面助手共用核心策略。配置在服务端自动保存;运行开关在重启和恢复会话后保持关闭。'})),{info:true});
if(name==='about')return dialog('关于牧场助手',el('div',{},el('p',{text:`牧羊人之心牧场助手 Web ${state.meta?.version || '2.0.0'}`}),el('p',{text:`游戏数据版本 ${state.meta?.gameVersion || '1.9.68'}`}),el('p',{class:'info-note',text:'与桌面助手共用核心策略。配置在服务端自动保存;运行开关在重启和恢复会话后保持关闭。'})),{info:true});
if(name==='updates')return await showUpdates();
if(name==='admin-logout'){hideWorkbench();try{await api.logout();}finally{requireAuth();}return;}
if(!account)throw new Error('请先新增或选择账号。');
@@ -575,7 +575,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.0.dev1';$('#game-version').textContent=meta.gameVersion || '1.9.68';$('#access-mode').textContent=auth.access_mode==='local'||auth.access_mode==='loopback'?'本机工作台':auth.required?'管理工作台':'本机工作台';
$('#app-version').textContent=meta.version || '2.0.0';$('#game-version').textContent=meta.gameVersion || '1.9.68';$('#access-mode').textContent=auth.access_mode==='local'||auth.access_mode==='loopback'?'本机工作台':auth.required?'管理工作台':'本机工作台';
await syncAccounts();if(state.redirecting)return;state.ready=true;setStatus('工作台已连接');
}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})));}
}
+1 -1
View File
@@ -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.0.dev1</span></span>
<span class="window-title">牧羊人之心牧场助手 <span id="app-version">2.0.0</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 -2
View File
@@ -18,6 +18,7 @@ from unittest.mock import patch
import httpx
from fastapi.testclient import TestClient
from ranch_web import __version__
from ranch_web.app import create_app
from ranch_web.config import WebConfig
@@ -134,7 +135,7 @@ class ApiTests(unittest.TestCase):
def test_health_meta_and_updates_have_no_game_side_effects(self):
self.manager.calls.clear()
self.assertEqual(self.client.get("/api/health").json(), {"status": "ok", "version": "2.0.0.dev1"})
self.assertEqual(self.client.get("/api/health").json(), {"status": "ok", "version": __version__})
meta = self.client.get("/api/meta")
self.assertEqual(meta.status_code, 200)
self.assertEqual(meta.json()["gameVersion"], "1.9.68")
@@ -273,7 +274,7 @@ class ApiTests(unittest.TestCase):
self.assertEqual(client.get(prefix + "/config").json()["config"]["interval"], 60)
exported = client.get(prefix + "/config/export")
document = poll(exported.json()["id"])["result"]
self.assertEqual(document["assistantVersion"], "2.0.0.dev1")
self.assertEqual(document["assistantVersion"], __version__)
imported = client.post(prefix + "/config/import", json=document)
self.assertEqual(imported.status_code, 202)
poll(imported.json()["id"])
+2 -1
View File
@@ -11,6 +11,7 @@ from unittest.mock import patch
import httpx
from fastapi.testclient import TestClient
from ranch_web import __version__
from ranch_web.app import create_app
from ranch_web.config import COOKIE_NAME, WebConfig, hash_password, verify_password
from ranch_web.tests.test_api import FakeManager, FakeUpdates
@@ -315,7 +316,7 @@ class AuthTests(unittest.TestCase):
def test_admin_password_does_not_corrupt_public_identifiers_or_versions(self):
client = self.client(WebConfig(data_dir=self.root, password="1"))
self.assertEqual(client.post("/api/auth/login", json={"password": "1"}).status_code, 200)
self.assertEqual(client.get("/api/meta").json()["version"], "2.0.0.dev1")
self.assertEqual(client.get("/api/meta").json()["version"], __version__)
account = client.post("/api/accounts", json={"demo": True}).json()
self.assertEqual(account["id"], "account_1")
self.assertEqual(client.get("/api/accounts/account_1/status").status_code, 200)