T003回报T003 回报

• 执行方：研发窗口（Claude Opus 5.5）
• 日期：2026-10-21
• 结论：全部完成（方案文档已交付，等待审查；其中 10 项细节标为待验证，见方案第八节）

做了什么

• 读了 D001～D003、D002 术语表、想法池、M2 草案、W001、T004～T006 任务卡和最新会话总结。
• 在离线知识库里逐项检索云系列、Vault、MythicMobs、MythicLib、网易、CraftEngine、Paper、PlaceholderAPI、LuckPerms 的接口资料；KB 没有的内容，尝试在线补查，补到了网易入驻指南的公开部分。
• 写成架构方案：研发/AcornCore_架构方案.md，共八节：总体结构、模块与故障隔离、数据层、多语言、奖励账本、外部接口、编年史、开发顺序、待验证清单。
• 看板上 T003 的状态改为"进行中"。总策划改看板时覆盖过一次，已经补回。审查前改为"待审查"。
• 没有写实现代码，没有改动 决策/ 和 策划/。

验收标准逐条结果

遇到的问题

1. 知识库在开发者 API 方面缺口很大。MythicMobs 只收了首页；MythicLib 和 LuckPerms 只抓到空壳；Paper 只有运维文档；netease-java 只有 4 篇入门页；CloudUI 主文档页内容为"加载中…"。云系列其他插件的文档质量很好，云副本事件、云世界重置、星月邮箱幂等接口都有原文。
2. 网易的认证和商业化接口资料不公开。入驻指南写明，资料在入驻拿到正式机后由官方对接人员发放，属于保密文件。所以网易模块目前只定了结构，具体对接要等资料到手。
3. 知识库与 D001 有一处表述冲突。知识库写"CloudUI 服务端需要 1.21.11 / 26.x"，标为 BLOCKED；D001 以作者答复为准，认为支持 1.21.10。方案按 D001 写，但 D001 的 T5 验证仍然必须做。

问题与建议

1. ⚠️ 网易账号的 UUID 是否固定（V1），这是整个"只存 ID"体系的前提。如果网易认证后 UUID 会随改名变化，就必须在网易模块里加一层"网易账号 → 内部玩家 ID"的映射，所有模块都用内部 ID。建议在问网易对接人的清单里加上这一条，越早确认，改动越小。
2. ⚠️ 副本奖励由谁来发（方案 4.5），需要总策划定规则。研发建议：高价值奖励一律由 AcornCore 监听云副本的通关事件，经账本发放；云副本 end.yml 的 rewards 只放低价值物品，或者不用。否则会回到 D001 担心的"各自发奖"。这条会影响用户填副本配置的模板。
3. 需要总策划给一份"高价值发放"清单，说明哪些必须走账本。方案目前举了副本核心奖励、世界 Boss、充值、补偿、活动大奖、新手旅人包，普通怪掉金币不走账本。
4. 建议给 T006 加一项测试（V2）：给玩家加金币后立刻强杀服务器进程，重启后看余额是否保留。如果 XConomy 是缓存后定时写库，账本记了"已发"钱却没到账，就得换一个立即写库的经济插件，或者改配置。
5. 金币建议用整数，不设小数。Vault 文档提示部分经济插件要求金额取整；整数也能避免对账误差。这属于数值决定，请总策划确认。
6. 网站上线前必须把数据库从 SQLite 迁到 MySQL。SQLite 是单个文件，网站所在的机器读不到。这一步可以排进 W-5 的前置条件。
7. 占位符写法：D002 示例写的是 {item}。方案采用 Paper 自带的 MiniMessage，占位符写作 <item>，含义不变。如果总策划希望文档统一，可以在 D002 里注明两种写法等价。
8. 代码仓库：项目目录目前不是 git 仓库。建议写代码前在 研发/AcornCore/ 初始化一个 git 仓库。云系列的闭源 jar 和授权文件不进版本管理，只放在本地 libs/。需要用户提供各云系列插件的 jar 作为编译依赖。
9. 建议补抓知识库：MythicMobs API 页、MythicLib Custom Elements、PlaceholderAPI 开发者页、Paper 开发者文档、PlayerPoints 仓库、Residence API、CloudUI 主文档页。补抓不急，第二批（世界 Boss）开工前完成即可。P0 平台层不依赖这些资料。
10. P0 平台层可以马上开工。它不依赖测试服，也不依赖任何待验证项。审查通过后我就开始写。