📝 新增农场帮助图片

This commit is contained in:
Shu-Ying 2025-10-12 06:12:14 +08:00
parent 3d42c1d283
commit e3691a2319
4 changed files with 757 additions and 149 deletions

1
.gitignore vendored
View File

@ -1,4 +1,5 @@
/config/sign_in.json
/resource/*
# Byte-compiled / optimized / DLL files
__pycache__/

View File

@ -11,6 +11,7 @@ from .database.database import g_pSqlManager
from .dbService import g_pDBService
from .event.event import g_pEventManager
from .farm.farm import g_pFarmManager
from .farm.help import g_pHelpManager
from .farm.shop import g_pShopManager
from .json import g_pJsonManager
from .request import g_pRequestManager
@ -90,6 +91,8 @@ async def start():
# 检查作物文件是否缺失 or 更新
await g_pRequestManager.initPlantDBFile()
await g_pHelpManager.createHelpImage()
# 析构函数
@driver.on_shutdown

View File

@ -9,109 +9,115 @@ from zhenxun.services.log import logger
from ..config import g_sResourcePath
def rendeerHtmlToFile(path: Path | str, context: dict, output: Path | str) -> None:
"""
使用 Jinja2 渲染 HTML 模板并保存到指定文件会自动创建父目录
class CHelpManager:
@classmethod
def rendeerHtmlToFile(
cls, path: Path | str, context: dict, output: Path | str
) -> None:
"""
使用 Jinja2 渲染 HTML 模板并保存到指定文件会自动创建父目录
Args:
path (str): 模板 HTML 路径
context (dict): 用于渲染的上下文字典
output (str): 输出 HTML 文件路径
"""
templatePath = str(path)
outputPath = str(output)
Args:
path (str): 模板 HTML 路径
context (dict): 用于渲染的上下文字典
output (str): 输出 HTML 文件路径
"""
templatePath = str(path)
outputPath = str(output)
templateStr = Path(templatePath).read_text(encoding="utf-8")
template = Template(templateStr)
rendered = template.render(**context)
templateStr = Path(templatePath).read_text(encoding="utf-8")
template = Template(templateStr)
rendered = template.render(**context)
# 自动创建目录
Path(outputPath).parent.mkdir(parents=True, exist_ok=True)
# 自动创建目录
Path(outputPath).parent.mkdir(parents=True, exist_ok=True)
Path(outputPath).write_text(rendered, encoding="utf-8")
Path(outputPath).write_text(rendered, encoding="utf-8")
@classmethod
async def screenshotHtmlToBytes(cls, path: str) -> bytes:
"""
使用 Playwright 截图本地 HTML 文件并返回 PNG 图片字节数据
Args:
path (str): 本地 HTML 文件路径
Returns:
bytes: PNG 图片的原始字节内容
"""
async with async_playwright() as p:
browser = await p.chromium.launch()
page = await browser.new_page(
viewport={"width": 1200, "height": 900}, device_scale_factor=1
)
file_url = Path(path).resolve().as_uri()
await page.goto(file_url, wait_until="networkidle")
await page.evaluate("""() => {
return new Promise(r => setTimeout(r, 200));
}""")
image_bytes = await page.screenshot(full_page=True)
await browser.close()
return image_bytes
@classmethod
async def screenshotSave(
cls, path: str, save: str, width: int, height: int
) -> None:
"""
使用 Playwright 渲染本地 HTML 并将截图保存到指定路径
Args:
path (str): HTML 文件路径
save (str): PNG 保存路径 output/image.png
width (int): 图片宽度
height (int): 图片高度
"""
async with async_playwright() as p:
browser = await p.chromium.launch()
page = await browser.new_page(
viewport={"width": width, "height": height}, device_scale_factor=1
)
file_url = Path(path).resolve().as_uri()
await page.goto(file_url, wait_until="networkidle")
await page.evaluate("""() => {
return new Promise(r => setTimeout(r, 200));
}""")
# 确保保存目录存在
Path(save).parent.mkdir(parents=True, exist_ok=True)
# 截图并保存到本地文件
await page.screenshot(path=save, full_page=True)
await browser.close()
@classmethod
async def createHelpImage(cls) -> bool:
templatePath = g_sResourcePath / "html/help.html"
outputPath = g_sResourcePath / "temp_html/help.html"
savePath = DATA_PATH / "farm_res/html/help.png"
context = {
"main_title": "真寻农场帮助菜单",
"subtitle": "[]中为可选参数",
"page_title": "真寻农场帮助菜单",
"font_family": "MyFont",
"contents": [
{"title": "主要指令", "commands": ["指令A", "指令B"]},
{"title": "B", "commands": ["指令D", "指令E", "指令M", "指令i"]},
],
}
try:
cls.rendeerHtmlToFile(templatePath, context, outputPath)
bytes = await cls.screenshotSave(str(outputPath), str(savePath), 1500, 2300)
except Exception as e:
logger.warning("绘制农场帮助菜单失败", e=e)
return False
return True
async def screenshotHtmlToBytes(path: str) -> bytes:
"""
使用 Playwright 截图本地 HTML 文件并返回 PNG 图片字节数据
Args:
path (str): 本地 HTML 文件路径
Returns:
bytes: PNG 图片的原始字节内容
"""
async with async_playwright() as p:
browser = await p.chromium.launch()
page = await browser.new_page()
file_url = Path(path).resolve().as_uri()
await page.goto(file_url)
image_bytes = await page.screenshot(full_page=True)
await browser.close()
return image_bytes
async def screenshotSave(path: str, save: str) -> None:
"""
使用 Playwright 渲染本地 HTML 并将截图保存到指定路径
Args:
path (str): HTML 文件路径
save (str): PNG 保存路径 output/image.png
"""
async with async_playwright() as p:
browser = await p.chromium.launch()
page = await browser.new_page()
file_url = Path(path).resolve().as_uri()
await page.goto(file_url)
# 确保保存目录存在
Path(save).parent.mkdir(parents=True, exist_ok=True)
# 截图并保存到本地文件
await page.screenshot(path=save, full_page=True)
await browser.close()
async def createHelpImage() -> bool:
templatePath = g_sResourcePath / "html/help.html"
outputPath = DATA_PATH / "farm_res/html/help.html"
context = {
"title": "功能指令总览",
"data": [
{
"command": "开通农场",
"description": "首次进入游戏开通农场",
"tip": "",
},
{
"command": "购买种子",
"description": "从商店中购买可用种子",
"tip": "",
},
{"command": "播种", "description": "将种子种入土地中", "tip": "先开垦土地"},
{
"command": "收获",
"description": "收获成熟作物获得收益",
"tip": "",
},
{
"command": "偷菜",
"description": "从好友农场中偷取成熟作物",
"tip": "1",
},
],
}
try:
rendeerHtmlToFile(templatePath, context, outputPath)
image_bytes = await screenshot_html_to_bytes(html_output_path)
except Exception as e:
logger.warning("绘制农场帮助菜单失败", e=e)
return False
return True
g_pHelpManager = CHelpManager()

View File

@ -1,75 +1,673 @@
<!DOCTYPE html>
<html lang="zh">
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>{{ title }}</title>
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>智能功能展示 - 参数可视化</title>
<style>
body {
background-color: #ffe4e9;
font-family: "Microsoft YaHei", sans-serif;
* {
margin: 0;
padding: 0;
box-sizing: border-box;
font-family: "{{ font_family }}", system-ui, -apple-system, "Helvetica Neue", Arial, sans-serif;
}
@font-face {
font-family: "{{ font_family }}";
src: url("../font/Rounded.ttf") format("truetype");
font-weight: 400;
font-style: normal;
font-display: swap;
}
body {
background: linear-gradient(135deg, #fff9f9 0%, #f0f9ff 100%);
color: #5a5a5a;
padding: 20px;
min-height: 100vh;
}
.container {
max-width: 1400px;
width: 100%;
margin: 0 auto;
}
header {
text-align: center;
margin-bottom: 40px;
padding: 30px 20px;
}
h1 {
color: #ff85a2;
font-size: 3rem;
margin-bottom: 15px;
text-shadow: 2px 2px 0px rgba(255, 133, 162, 0.2);
position: relative;
display: inline-block;
}
h1::after {
content: "";
position: absolute;
bottom: -10px;
left: 50%;
transform: translateX(-50%);
width: 100px;
height: 4px;
background: linear-gradient(90deg, #ff85a2, #a2d2ff);
border-radius: 2px;
}
.description {
font-size: 1.2rem;
color: #888;
max-width: 800px;
margin: 20px auto;
line-height: 1.6;
background-color: rgba(255, 255, 255, 0.7);
padding: 20px;
border-radius: 15px;
box-shadow: 0 4px 10px rgba(0, 0, 0, 0.05);
}
.legend {
display: flex;
justify-content: center;
padding: 40px 20px;
gap: 20px;
margin: 20px 0;
flex-wrap: wrap;
}
.content-box {
background-color: #fff0f5;
border-radius: 24px;
padding: 30px;
box-shadow: 0 0 8px rgba(0, 0, 0, 0.1);
width: 900px;
.legend-item {
display: flex;
align-items: center;
background: white;
padding: 8px 15px;
border-radius: 20px;
box-shadow: 0 2px 8px rgba(0,0,0,0.1);
font-size: 0.9rem;
}
.title {
text-align: center;
font-size: 32px;
font-weight: bold;
margin-bottom: 40px;
.legend-color {
width: 16px;
height: 16px;
border-radius: 4px;
margin-right: 8px;
}
table {
.required-color {
background-color: #ff6b9c;
}
.optional-color {
background-color: #a2d2ff;
}
.conditional-color {
background-color: #b9fbc0;
}
.features-grid {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(400px, 1fr));
gap: 30px;
margin-top: 40px;
}
.feature-box {
background: linear-gradient(135deg, #ffffff 0%, #f8f8f8 100%);
border-radius: 25px;
padding: 25px;
box-shadow: 0 8px 20px rgba(255, 133, 162, 0.15);
transition: all 0.3s ease;
border: 3px solid transparent;
position: relative;
overflow: hidden;
cursor: pointer;
}
.feature-box:hover {
transform: translateY(-5px);
box-shadow: 0 12px 25px rgba(255, 133, 162, 0.25);
border-color: #ffc2d1;
}
.feature-box::before {
content: "";
position: absolute;
top: 0;
left: 0;
width: 100%;
border-collapse: collapse;
height: 8px;
background: linear-gradient(90deg, #ff85a2, #a2d2ff);
}
th {
background-color: #ffb6c1;
.feature-header {
display: flex;
align-items: center;
margin-bottom: 20px;
}
.feature-icon {
font-size: 2.5rem;
margin-right: 15px;
}
.feature-name {
font-size: 1.6rem;
font-weight: bold;
padding: 12px;
color: #ff6b9c;
}
.parameters-section {
margin: 20px 0;
}
.section-title {
font-size: 1rem;
color: #888;
margin-bottom: 10px;
display: flex;
align-items: center;
}
.section-title::before {
content: "📋";
margin-right: 8px;
}
.parameters-list {
display: flex;
flex-direction: column;
gap: 8px;
}
.parameter-item {
display: flex;
align-items: center;
padding: 10px 15px;
border-radius: 12px;
font-size: 0.95rem;
transition: all 0.2s ease;
}
.parameter-item:hover {
transform: translateX(5px);
}
.required-param {
background-color: rgba(255, 107, 156, 0.1);
border-left: 4px solid #ff6b9c;
}
.optional-param {
background-color: rgba(162, 210, 255, 0.1);
border-left: 4px solid #a2d2ff;
}
.conditional-param {
background-color: rgba(185, 251, 192, 0.1);
border-left: 4px solid #b9fbc0;
}
.param-badge {
display: inline-block;
padding: 3px 10px;
border-radius: 8px;
font-size: 0.8rem;
font-weight: bold;
margin-right: 12px;
min-width: 60px;
text-align: center;
}
td {
padding: 12px;
text-align: center;
.required-badge {
background-color: #ff6b9c;
color: white;
}
tr:not(:last-child) {
border-bottom: 1px solid #ddd;
.optional-badge {
background-color: #a2d2ff;
color: white;
}
.conditional-badge {
background-color: #b9fbc0;
color: #333;
}
.param-description {
flex: 1;
}
.logic-section {
margin-top: 20px;
padding: 15px;
background-color: rgba(255, 213, 165, 0.1);
border-radius: 12px;
border-left: 4px solid #ffd6a5;
}
.logic-title {
font-weight: bold;
color: #ff9e6d;
margin-bottom: 8px;
display: flex;
align-items: center;
}
.logic-title::before {
content: "🔍";
margin-right: 8px;
}
.logic-content {
font-size: 0.9rem;
color: #666;
line-height: 1.5;
}
.usage-example {
margin-top: 15px;
padding: 12px;
background-color: #f8f9fa;
border-radius: 8px;
font-family: 'Courier New', monospace;
font-size: 0.85rem;
color: #333;
border-left: 3px solid #888;
}
.decoration {
position: absolute;
width: 80px;
height: 80px;
opacity: 0.1;
z-index: 0;
}
.decoration-1 {
top: -20px;
left: -20px;
background-color: #ff85a2;
border-radius: 50%;
}
.decoration-2 {
bottom: -20px;
right: -20px;
background-color: #a2d2ff;
border-radius: 50%;
}
@media (max-width: 768px) {
.features-grid {
grid-template-columns: 1fr;
}
h1 {
font-size: 2.2rem;
}
}
footer {
margin-top: 50px;
text-align: center;
color: #aaa;
font-size: 0.9rem;
padding: 20px;
}
</style>
</head>
<body>
<div class="container">
<div class="content-box">
<div class="title">{{ title }}</div>
<table>
<thead>
<tr>
<th>指令</th>
<th>描述</th>
<th>Tip</th>
</tr>
</thead>
<tbody>
{% for entry in data %}
<tr>
<td>{{ entry.command }}</td>
<td>{{ entry.description }}</td>
<td>{{ entry.tip }}</td>
</tr>
{% endfor %}
</tbody>
</table>
</div>
<header>
<h1>✨ 真寻农场帮助菜单 ✨</h1>
<p class="description">简单介绍一下农场的各个功能和食用方法</p>
<div class="legend">
<div class="legend-item">
<div class="legend-color required-color"></div>
<span>必填参数</span>
</div>
<div class="legend-item">
<div class="legend-color optional-color"></div>
<span>可选参数</span>
</div>
<div class="legend-item">
<div class="legend-color conditional-color"></div>
<span>条件参数</span>
</div>
</div>
</header>
<main>
<div class="features-grid">
<!-- 必填 + 可选参数 -->
<div class="feature-box">
<div class="decoration decoration-1"></div>
<div class="decoration decoration-2"></div>
<div class="feature-header">
<div class="feature-name">at 开通农场</div>
</div>
<div class="logic-section">
<div class="logic-title">条件逻辑</div>
<div class="logic-content">
• 需要at小真寻<br>
</div>
</div>
</div>
<div class="feature-box">
<div class="decoration decoration-1"></div>
<div class="decoration decoration-2"></div>
<div class="feature-header">
<div class="feature-name">我的农场</div>
</div>
</div>
<div class="feature-box">
<div class="decoration decoration-1"></div>
<div class="decoration decoration-2"></div>
<div class="feature-header">
<div class="feature-name">农场详述</div>
</div>
</div>
<div class="feature-box">
<div class="decoration decoration-1"></div>
<div class="decoration decoration-2"></div>
<div class="feature-header">
<div class="feature-name">我的农场币</div>
</div>
</div>
<!-- 条件参数 -->
<div class="feature-box">
<div class="decoration decoration-1"></div>
<div class="decoration decoration-2"></div>
<div class="feature-header">
<div class="feature-name">种子商店</div>
</div>
<div class="parameters-section">
<div class="section-title">参数列表</div>
<div class="parameters-list">
<div class="parameter-item conditional-param">
<span class="param-badge conditional-badge">条件</span>
<span class="param-description">参数 - 根据类型决定含义</span>
</div>
</div>
</div>
<div class="logic-section">
<div class="logic-title">条件逻辑</div>
<div class="logic-content">
• 如果参数是中文 → 进入筛选模式,可接页码参数<br>
• 如果参数是数字 → 直接作为页码使用<br>
</div>
</div>
<div class="usage-example">
使用示例1: 种子商店 胡萝<br>
使用示例2: 种子商店 2<br>
使用示例3: 种子商店 胡萝 3
</div>
</div>
<!-- 多个参数 -->
<div class="feature-box">
<div class="decoration decoration-1"></div>
<div class="decoration decoration-2"></div>
<div class="feature-header">
<div class="feature-name">购买种子</div>
</div>
<div class="parameters-section">
<div class="section-title">参数列表</div>
<div class="parameters-list">
<div class="parameter-item required-param">
<span class="param-badge required-badge">必填</span>
<span class="param-description">作物/种子名称</span>
</div>
<div class="parameter-item optional-param">
<span class="param-badge optional-badge">可选</span>
<span class="param-description">数量</span>
</div>
</div>
</div>
<div class="usage-example">
使用示例: 购买种子 胡萝卜
使用示例: 购买种子 胡萝卜 5
</div>
</div>
<div class="feature-box">
<div class="decoration decoration-1"></div>
<div class="decoration decoration-2"></div>
<div class="feature-header">
<div class="feature-name">我的种子</div>
</div>
</div>
<div class="feature-box">
<div class="decoration decoration-1"></div>
<div class="decoration decoration-2"></div>
<div class="feature-header">
<div class="feature-name">播种</div>
</div>
<div class="parameters-section">
<div class="section-title">参数列表</div>
<div class="parameters-list">
<div class="parameter-item conditional-param">
<span class="param-badge required-badge">必填</span>
<span class="param-description">作物/种子名称</span>
</div>
<div class="parameter-item optional-param">
<span class="param-badge optional-badge">可选</span>
<span class="param-description">数量</span>
</div>
</div>
</div>
<div class="logic-section">
<div class="logic-title">操作提示</div>
<div class="logic-content">
• 数量不填默认将最大可能播种
</div>
</div>
<div class="usage-example">
使用示例1: 种子商店 胡萝<br>
使用示例2: 种子商店 2<br>
使用示例3: 种子商店 胡萝 3
</div>
</div>
<div class="feature-box">
<div class="decoration decoration-1"></div>
<div class="decoration decoration-2"></div>
<div class="feature-header">
<div class="feature-name">收获</div>
</div>
</div>
<div class="feature-box">
<div class="decoration decoration-1"></div>
<div class="decoration decoration-2"></div>
<div class="feature-header">
<div class="feature-name">铲除</div>
</div>
</div>
<div class="feature-box">
<div class="decoration decoration-1"></div>
<div class="decoration decoration-2"></div>
<div class="feature-header">
<div class="feature-name">我的作物</div>
</div>
</div>
<div class="feature-box">
<div class="decoration decoration-1"></div>
<div class="decoration decoration-2"></div>
<div class="feature-header">
<div class="feature-name">播种</div>
</div>
<div class="parameters-section">
<div class="section-title">参数列表</div>
<div class="parameters-list">
<div class="parameter-item conditional-param">
<span class="param-badge optional-badge">可选</span>
<span class="param-description">作物/种子名称</span>
</div>
<div class="parameter-item optional-param">
<span class="param-badge optional-badge">可选</span>
<span class="param-description">数量</span>
</div>
</div>
</div>
<div class="logic-section">
<div class="logic-title">操作提示</div>
<div class="logic-content">
• 不填写作物名将售卖仓库种全部作物
• 填作物名不填数量将指定作物全部出售
</div>
</div>
</div>
<div class="feature-box">
<div class="decoration decoration-1"></div>
<div class="decoration decoration-2"></div>
<div class="feature-header">
<div class="feature-name">偷菜 at</div>
</div>
<div class="logic-section">
<div class="logic-title">条件逻辑</div>
<div class="logic-content">
• 每人每天只能偷5次
• 后续需要at目标且目标开通真寻农场
</div>
</div>
</div>
<div class="feature-box">
<div class="decoration decoration-1"></div>
<div class="decoration decoration-2"></div>
<div class="feature-header">
<div class="feature-name">开垦</div>
</div>
</div>
<div class="feature-box">
<div class="decoration decoration-1"></div>
<div class="decoration decoration-2"></div>
<div class="feature-header">
<div class="feature-name">购买农场币</div>
</div>
<div class="parameters-section">
<div class="section-title">参数列表</div>
<div class="parameters-list">
<div class="parameter-item optional-param">
<span class="param-badge required-badge">必填</span>
<span class="param-description">数量</span>
</div>
</div>
</div>
<div class="logic-section">
<div class="logic-title">操作提示</div>
<div class="logic-content">
• 数量为消耗金币的数量
</div>
</div>
</div>
<div class="feature-box">
<div class="decoration decoration-1"></div>
<div class="decoration decoration-2"></div>
<div class="feature-header">
<div class="feature-name">更改农场名</div>
</div>
<div class="parameters-section">
<div class="section-title">参数列表</div>
<div class="parameters-list">
<div class="parameter-item optional-param">
<span class="param-badge required-badge">必填</span>
<span class="param-description">新的农场名</span>
</div>
</div>
</div>
<div class="logic-section">
<div class="logic-title">操作提示</div>
<div class="logic-content">
• 仅支持部分特殊符号
</div>
</div>
</div>
<div class="feature-box">
<div class="decoration decoration-1"></div>
<div class="decoration decoration-2"></div>
<div class="feature-header">
<div class="feature-name">农场签到</div>
</div>
</div>
<div class="feature-box">
<div class="decoration decoration-1"></div>
<div class="decoration decoration-2"></div>
<div class="feature-header">
<div class="feature-name">土地升级</div>
</div>
<div class="parameters-section">
<div class="section-title">参数列表</div>
<div class="parameters-list">
<div class="parameter-item optional-param">
<span class="param-badge required-badge">必填</span>
<span class="param-description">地块ID</span>
</div>
</div>
</div>
<div class="logic-section">
<div class="logic-title">操作提示</div>
<div class="logic-content">
• 地块ID通过农场详述获取
</div>
</div>
</div>
</div>
</main>
</div>
</body>
</html>
</html>