Files
main_plugin_farm/docs/18-web-panel-and-data-directory.md
T

44 lines
2.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 网页头像栏与数据目录
## 头像栏
正式渲染器读取 `metadata.json` 的 `panel` 配置。头像、头像框、昵称、
经验条、等级、农场币和点券使用原始 `WebGLPersionInfo` prefab 的矩形、
锚点与文字对齐方式,不再使用旧版 `userInfo.png` 的位置。
来源为已下载公开资源包 `mainscene_053483f584f07436ac0569e2f4f7ed01`。
提取脚本只读取资源,不执行游戏脚本。原始包哈希及六张新增素材的哈希
记录在 `src/farm_render/source_assets/manifest.json`。完整头像框先于文字、
后于头像合成;Gold 的裁切透明边距按资源中的 textureRectOffset 恢复。
坐标以左上角为起点。Unity RectTransform 的锚点、pivot 和父矩形计算出
各元素矩形。渲染器采用宽 1920 的参考画布,输出坐标和尺寸乘以
`输出宽度 / 1920`;1280 像素网页截图按 2/3 对照。1920 是本渲染器的
对照基准,没有把它报告为已经提取到的网页 CanvasScaler 参数。
原始头像矩形为 `[32.2744, 39.7618, 111.3870, 107.7072]`,
头像框为 `[3.0930, 8.8650, 169.7500, 169.5000]`。昵称在头像右侧,
经验条与等级在昵称下方,农场币和点券在第三行。文字按矩形尺寸适配,
经验条裁切填充图片,不通过拉伸改变纹理。
保留本项目的账户与经验规则。网页的 VIP、晶钻、星钻及购买按钮没有
对应业务,不添加假余额或操作入口。渲染时暂时收起底板上原图纵坐标
168 到 208 的空栏区域,将原始下边框上移拼接。头像和现有文字的位置、
字号保持不变,面板可见高度约缩短 19%;原始素材完整保留,便于以后恢复。
## 数据目录
默认路径改为宿主 `DATA_PATH / farm_db`。为保持数据连续,数据库文件名
`farm-preview.sqlite3`、日志文件名和 deployment 标识不变。
更新插件后下次启动时,若默认旧目录 `farm_preview` 中存在本项目 SQLite,
且 `farm_db` 不存在,会把整个旧目录重命名为 `farm_db`,同时保留日志和
SQLite 附属文件。迁移在打开数据库前进行,成功后记录迁移日志。
若两个目录同时存在,启动失败并提示明确选择数据目录,禁止覆盖或默默
创建空账户。文件被占用导致重命名失败时同样终止启动;应停止旧实例再启动。
原有显式 `farm_preview_data_dir` 配置继续生效;该配置用于自定义路径,
不会被自动移动。若显式配置仍指向 `farm_preview`,需自行更改该路径。
本轮只修改开发源并进行隔离测试;没有移动正在使用的宿主数据或重启机器人。