Files
AIGame/Temp/register_secondary_docs.py
T

59 lines
5.2 KiB
Python
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.
from pathlib import Path
entries = {
'Doc/UI_Normal_Set.md': '''
## 营地冒险手册控件补充(2026-11-04)
任务、签到、邮件页使用同属 Candy 风格的轻描边控件,目录为 `AIClient/Assets/Bundles/UI/Texture/Journal/`。由 `AIClient/AgentScripts/ReviewSecondaryUi.cs` 的 `CreateControls` 经 Unity Pipeline 程序化生成圆角、渐变和短阴影;复用 Home 业务图标,没有增加主题切换。
| 切图 | 用途 |
| --- | --- |
| `journal_card` | 奶油白内容卡片 |
| `journal_hero` | 深蓝重点信息面板 |
| `journal_gold_card` | 七日奖励及签到入口 |
| `journal_primary_normal` / `journal_primary_pressed` | 金色领取操作普通/按下态 |
| `journal_secondary_normal` / `journal_secondary_pressed` | 浅蓝导航操作普通/按下态 |
| `journal_disabled` | 请求中等不可操作状态 |
| `journal_progress_bg` / `journal_progress_fill` | 进度底槽/金色填充 |
全部为 128×128 RGBA、Full Rect,九宫格 Border **L,R,T,B = 30,30,28,32**(Unity L,B,R,T = 30,32,30,28),JSON 使用 Sliced。边界由 `UiSpriteNineSliceRules` 自动维护,目录自动收集为 `UI_JournalAtlas`。
''',
'Doc/ResDesc_Picture.md': '''
## 二级界面 · 营地冒险手册视觉升级(2026-11-04)
- 新增 `AIClient/Assets/Bundles/UI/Texture/Journal/` 下 10 张控件图:`journal_card.png`、`journal_hero.png`、`journal_gold_card.png`、`journal_primary_normal.png`、`journal_primary_pressed.png`、`journal_secondary_normal.png`、`journal_secondary_pressed.png`、`journal_disabled.png`、`journal_progress_bg.png`、`journal_progress_fill.png`。用于任务、签到、邮件的卡片、重点信息、按钮完整状态和进度展示。
- 生成方式:`AIClient/AgentScripts/ReviewSecondaryUi.cs` 的程序化圆角距离场/渐变/短阴影,经 Unity Pipeline `ReviewSecondaryUi.Build` 创建 PNG 并设置导入;不是 AI 生图。所有图为 128×128 RGBA、Full Rect、Sliced,Unity Border L,B,R,T = 30,32,30,28,`UiSpriteNineSliceRules` 自动维护。新增 `.meta` 均由 Unity 创建。
- `AIClient/Assets/Bundles/UI/Atlas/UI_JournalAtlas.spriteatlas`:目录图集流水线自动生成,收集以上控件;继续复用 Home 图标和 Common 返回按钮。
- `Doc/UIPrefabCreater/UI_PrototypeTasks.json`、`UI_PrototypeSignin.json`、`UI_PrototypeMail.json` → `AIClient/Assets/Bundles/UI/Prefab/` 下同名 Prefab:由 `Tools/redesign_secondary_ui.py` 编写 JSON,再经 Unity JSON 转换器生成。竖屏 1080×1920,按宽缩放,安全区内滚动。
- 视觉:深蓝重点区域、奶油内容卡、柔和金色奖励,降低旧木纹/厚金边/高光噪声。任务按每日委托与成长足迹分组;单项只显示当前可用动作或领取完成状态。签到采用六张日奖励卡及独立第七日礼物,邮件采用可收缩列表与正文区。
- 验证:`ReviewSecondaryUi.Review` 使用真实页面刷新方法及隔离内存数据,覆盖任务未完成/可领/已领、请求阻塞、跨日禁领、签到三态、邮件空态、信件宽度、短屏滚动、刘海安全区。预览与回执:`Tools/output/secondary_ui/`。标准屏三页及 1080×1680、1080×2400 场景已渲染检查;未执行服务端领取请求,未发布 CDN 或构建微信底包。
''',
'Doc/ResDesc_Config.md': '''
### 二级界面 JSON 与刷新逻辑(2026-11-04)
- `Doc/UIPrefabCreater/UI_Prototype{Tasks,Signin,Mail}.json`:营地冒险手册页面骨架,生成入口 `Tools/redesign_secondary_ui.py`,Prefab 由 Unity Pipeline 调用 JSON 转换器生成。
- `PrototypeFlow.cs`:任务单动作切换、进度条、签到状态标签、邮件行收缩及选中态;保留原服务端接口及奖励配置。
- `UiSafeArea.cs`:对铺满父节点的容器按安全区收缩四边;现有顶部/底部 HUD 的偏移行为保留。该 AOT 改动随下次底包构建交付。
- `AIClient/AgentScripts/ReviewSecondaryUi.cs`:生成控件、构建三页及隔离内存状态验证;预览和回执在 `Tools/output/secondary_ui/`。不修改账号进度。
''',
'Doc/UI_AutoGen_Overview.md': '''
## 二级界面冒险手册(2026-11-04)
任务、签到、邮件页继续使用 JSON→Prefab,使用 `Texture/Journal/` 轻描边 Candy 控件与 Home 图标。`Tools/redesign_secondary_ui.py` 为 JSON 编写入口;`ReviewSecondaryUi.Build` 经 Pipeline 生成切图并调用转换器,`ReviewSecondaryUi.Review` 负责隔离数据验证及截图。切图登记见 `ResDesc_Picture.md`,九宫格清单见 `UI_Normal_Set.md`。
三页的 SafeArea 为四边拉伸容器;`AOT.UI.UiSafeArea` 对此类节点收缩 offsetMin/offsetMax,保留既有边缘 HUD 的位移逻辑。内容放入 ScrollRect,短屏可滚动;邮件使用预制 VerticalLayoutGroup 收缩缺省行。业务运行时只填内容、改变状态和布局,不创建页面骨架。
'''
}
for file, entry in entries.items():
path = Path(file)
content = path.read_bytes()
marker = b'\n\n### ' if file.endswith('ResDesc_Config.md') else b'\n\n## '
at = content.rfind(marker)
assert at >= 0 and b'???' in content[at:at+100], file
path.write_bytes(content[:at] + entry.encode('utf-8'))
print('Repaired UTF-8 resource registration.')