网站与Android 0.17.0更新
RELEASE-20260929-0170优化
- 移动端风格切换按钮固定排列在汉堡导航按钮左侧，保留滴墨动画。
- Android升级至0.17.0，下载入口同步更新，保留原包名与签名。
验证
- 本地195项回归、类型检查、正式构建及更新记录检查通过。
- APK构建及签名校验通过，与旧版签名一致。
- 安卓真机覆盖安装及导航视觉效果尚未验收。
每一步，都有记录
查看新增功能、体验优化和修复。每次更新的发布范围单独标明。
移动端风格按钮固定至导航栏
LOCAL-20260929-MOBILE-THEME优化
- 移动端风格切换按钮放入导航栏，始终排列在汉堡按钮左侧，保留滴墨与收墨动画。
- 统一800px响应式断点，按钮保持44px点击面积和8px间距，并适配右侧安全区域。
修复
- 移除依赖固定高度的悬浮定位，避免不同页面头部高度导致按钮错位。
验证
- 类型检查、正式构建及更新记录检查通过。
- 尚未进行浏览器与手机实机视觉验收。
网站与Android 0.16.0更新
RELEASE-20260922-0160优化
- 同步31馆原创造像封面及树下铜钱互动位置。
- Android升级至0.16.0，下载入口同步更新，保留原包名与签名。
验证
- 本地195项回归测试、APK构建及签名验证通过，新旧安装包签名一致。
- 安卓真机覆盖安装与移动端三维性能尚未验收。
铜钱移至山门左侧树下
LOCAL-20260922-COINS-TREE优化
- 三枚铜钱移至进山门后左侧第一棵树下，置于树干前方土面，避开树干和石边框。
- 点击区域随模型位置移动，山门与附近庭院视角均可点击打开六爻互动。
验证
- 类型检查通过；铜钱位置、资源释放及六爻逻辑3项回归测试通过。
- 尚未完成浏览器视觉验收。
其他电子祠堂统一使用原创造像封面
LOCAL-20260922-SANCTUARY-COVERS新增
- 补齐17张原创造像效果图，财神殿采用五路财神同框构图。
优化
- 全部31馆列表及人物介绍封面使用生成图，并标注非实拍；馆内实拍与三维素材保持原有来源。
- 新封面提供压缩图及列表缩略图，保存独立创作说明。
验证
- 已检查17张新图的整体构图，全部31馆封面与缩略图文件存在且封面校验值匹配。
- 类型检查、正式构建及更新记录检查通过。
- 尚未完成浏览器视觉验收和手机实机检查。
App弹窗新增客服二维码
LOCAL-20260922-SUPPORT-QR新增
- 右下角App弹窗在下载入口下方展示客服微信二维码，并标注“扫码添加客服”。
优化
- 二维码保留原图比例，弹窗按屏幕高度限制并支持内部滚动。
验证
- 二维码文件校验值与用户原图一致；类型检查、正式构建及更新记录检查通过。
- 尚未进行浏览器视觉验收及手机实机扫码验证。
首页2升级为唯一首页并完善移动端
LOCAL-20260919-HOME-PROMOTION优化
- 将原首页2升级为网站唯一首页，首页导航统一指向根地址，旧首页2地址自动回到首页。
- 手机端保留圆形汉堡按钮与全屏菜单，并为轮播标题、缩略入口和视频说明优化窄屏排版与触控区域。
- 日月交替动画按手机宽度重新定位，主题切换按钮移动到汉堡按钮左侧，避免遮挡账号、导航和轮播操作。
修复
- 移除导航中的重复首页入口，修复移动端主题按钮与轮播缩略入口重叠的问题。
- 修复窄屏视频文字在浅色画面上对比不足的问题。
验证
- 本地浏览器在360px、390px、430px及768px宽度检查首页，无横向溢出，汉堡菜单可用。
- 360px和390px下主题按钮、汉堡菜单、账号入口、日月动画及轮播控件无相互遮挡；昼夜切换状态已复核。
- 旧首页2地址跳转至首页，导航只保留一个首页入口。
- 完整回归195项、类型检查、正式构建及更新记录检查通过。
- 正式网站首页、管理后台、更新记录、文曲星页面及IP入口返回正常，旧首页2地址正确跳转到首页；网页容器健康，API与数据库保持运行，App未更新。
修复公开电子祠堂登录状态
LOCAL-20260919-SANCTUARY-SESSION优化
- 公开电子祠堂进入时恢复当前账号及首个可用家族，登录用户可直接使用收藏、献礼和祈福记录。
- 分别提示游客、已登录但尚未加入家族、登录状态读取失败三种情况，确认会话期间不再闪现游客登录按钮。
修复
- 修复右上角已显示登录账号，但公开祠堂下方仍提示登录使用收藏与献礼的问题。
验证
- 会话状态边界测试、完整回归、类型检查、正式构建及更新记录检查通过。
- 本地浏览器使用现有登录会话进入文曲星公开地址，页面不再显示登录提示，并正确展示个人中心、收藏与祈福记录。
- 正式网站候选镜像、文曲星页面、更新记录及容器健康检查通过；Android App未更新。
整理0.15.0跨电脑开发包
LOCAL-20260918-HANDOFF-0150新增
- 提供当前源码与网页运行素材主开发包，以及可选Blender工程和原始素材包。
- 提供新电脑启动说明、逐文件清单和压缩包SHA-256校验值。
优化
- 迁移包更新至网站与Android 0.15.0，保留最新首页2、宣传视频、昼夜背景、三维模型和完整测试。
- 排除依赖、构建缓存、旧发布包、服务器备份和临时文件，减少迁移体积。
验证
- 压缩包逐文件完整性、关键运行资源和私密文件排除规则通过。
- 尚未在另一台电脑实际安装依赖和启动项目。
网站与Android 0.15.0更新
RELEASE-20260918-0150新增
- 宣传视频作为轮播第一项，随后展示四张原创生成的使用指南配图，介绍建立家族、整理图谱、旧谱入册和参观祠堂。
- 为顶部动画新增两张去除固定太阳、月亮的水墨底图，保留原始昼夜头图。
优化
- 顶部采用视频、大图与功能说明并列的推荐轮播，支持五项缩略入口、前后切换、暂停及手机滑动。
- 视频静音自动播放，离开轮播或切换至功能图时暂停，播放结束后自动进入功能介绍；移除下方重复的视频区块。
- 原昼夜族谱头图改为顶部全宽水墨背景，按桌面与手机比例裁切山水、日月及族谱局部，并随主题平滑切换。
- 恢复日月交替动画：进入静夜时太阳沿弧线下沉、月亮升起，返回暖昼时按相反方向复位，并与背景明暗同步。
- 动态日月与水墨天空归入同一背景层，消除动画移动时原图固定日月露出的重影。
- 中文说明以清晰网页文字呈现，适配昼夜与手机排版。
验证
- 浏览器验证桌面端视频可静音播放，切换到功能图后暂停，返回视频后继续播放；五项缩略入口与轮播状态同步。
- 2048px、1440px及390px验证全宽背景裁切；日间仅显示一个动态太阳，静夜仅显示一个动态月亮，移动过程中底图没有固定日月重影，最终状态与主题同步且无横向溢出。
- 390px窄屏五项入口均可见且视频正常播放；类型检查、正式构建及更新记录检查通过。
- 完整回归194项通过；Android 0.15.0包名与版本检查通过，v2/v3签名有效且签名证书与0.14.0一致。触屏滑动及安卓真机尚未验收。
- 云端候选镜像探测及正式切换通过；主站、首页2、管理后台、更新记录、健康接口、IP入口和新版APK均返回正常，线上APK校验值与本地一致。
网站与Android 0.14.0更新
RELEASE-20260917-0140新增
- 首页2提供静音自动播放的宣传视频。
优化
- 首页2宽屏书卷布局与画面边界对齐。
- 手机端圆形汉堡按钮打开全屏导航，保留桌面横向导航。
修复
- 修复宽屏祠堂入口文字被挤压及视频区对齐问题。
验证
- 完整回归194项、类型检查、正式构建通过，Android构建与原签名校验通过。
- 云端独立数据库副本验证31馆收藏、献礼、积分、权限与人物照片通过。
- 未完成安卓真机覆盖安装、全业务页面视觉与性能验收。
手机全屏导航
LOCAL-20260917-FULLSCREEN-NAV优化
- 手机导航采用圆形汉堡图标，打开全屏菜单，支持独立滚动、关闭及选中后收起。
- 窄屏页头允许换行，菜单适配安全区域与屏幕高度，桌面保留横向导航。
验证
- 浏览器检查320px无横向溢出，全屏菜单支持关闭、选中后收起及祠堂子菜单；1440px导航保持横向。
- 类型检查与正式构建通过；未完成所有业务页面及手机真机验收。
手机端折叠导航
LOCAL-20260917-MOBILE-NAV新增
- 手机端增加汉堡导航按钮，展开后以两列呈现页面入口。
优化
- 首页及家族页面共用折叠导航，选择入口后收起，保留电子祠堂下拉选项及桌面横向导航。
验证
- 390px浏览器验证展开、收起、选中入口后收起及电子祠堂子菜单；1440px保持横向导航。
- 类型检查与正式构建通过；家族内部已登录页面及手机真机尚未完成验收。
首页2宽屏书卷布局
LOCAL-20260917-HOME2-FOLIO优化
- 宽屏主内容自适应加宽，首屏画面与视频保持对齐。
- 两侧增加淡墨题字与细线边饰，窄屏自动隐藏，沿用昼夜配色。
验证
- 宽屏浏览器检查昼夜效果，首屏与视频右边界一致；390px检查无横向溢出，边饰自动隐藏。
- 类型检查与正式构建通过；未进行手机真机验收。
首页2画面边缘对齐
LOCAL-20260917-HOME2-IMAGE-ALIGN优化
- 首屏水墨画与宣传视频使用一致的右边界，保留左侧文案对齐。
修复
- 修复首屏背景画面比视频突出一截的视觉错位。
验证
- 浏览器检查大屏、1440px及390px，首屏画面与视频右边缘坐标一致；手机画面左右边界均对齐，无横向溢出。
- 类型检查、正式构建通过。
首页2大屏布局修复
LOCAL-20260917-HOME2-RESPONSIVE优化
- 首页2首屏、视频与功能章节统一内容宽度和左右边界。
修复
- 修复超宽屏下祠堂内容被百分比留白挤压、入口标题逐字折行的问题。
验证
- 浏览器检查2560px、1440px及390px布局，首屏文案、视频与祠堂章节边界一致；祠堂入口正常横向排字，未出现横向溢出。
- 类型检查与正式构建通过；未进行安卓真机验收。
宣传视频画卷布局
LOCAL-20260917-PROMO-LAYOUT优化
- 首页2视频区采用分列标题、印章式题签与宽幅画面，简化外框并优化说明栏。
- 沿用昼夜配色和静音自动播放，窄屏采用纵向排版。
验证
- 类型检查、正式构建通过，浏览器检查桌面与390px窄屏布局，视频正常播放。
- 未进行安卓真机验收；本轮仅本地调整。
宣传视频静音自动播放
LOCAL-20260917-VIDEO-AUTOPLAY优化
- 首页2宣传视频改为静音自动循环播放，保留暂停、声音与全屏控制。
- 视频离开可视区域或页面进入后台时暂停，返回后恢复原先播放状态。
验证
- 类型检查、正式构建通过；浏览器确认视频未点击即可静音播放。
- 未进行手机真机与所有浏览器自动播放策略验收。
首页2宣传视频预览
LOCAL-20260917-HOME2-VIDEO新增
- 复制当前首页为独立首页2，保留原首页与备份。
- 首页2加入项目宣传视频，提供播放、暂停、全屏和失败重试。
优化
- 视频点击播放，离开可视区域或切换后台自动暂停；保留昼夜风格。
验证
- 类型检查、正式构建及更新文档检查通过；视频副本与原文件SHA256一致。
- 浏览器确认首页2视频可加载并播放到结束，1920×1080，时长约15秒。
- 未进行手机真机、全部浏览器或字幕验收；本轮未部署。
网站与 Android 0.13.0 更新
RELEASE-20260916-0130优化
- 同步当前首页、统一账号菜单与六组传统节日陈设，Android 安装包更新至0.13.0，保留原包名和签名。
验证
- 完整回归194项、类型检查与本地及服务器正式构建通过；安装包版本和原签名验证通过。
- 云端隔离资料验收通过；切换前后核心数据与环境配置校验一致。
- 公网入口、后台、注册找回密码、天气与健康检查正常，新版安装包下载校验一致。
- 未进行安卓真机覆盖安装与线上逐页视觉验收；自动支付尚未开放。
祠堂传统节日陈设
LOCAL-20260916-SHRINE-FESTIVALS新增
- 新增春节、元宵、清明、端午、中秋、重阳六组立体节日陈设。
- 新增按中国时区农历和节气自动显示、节日预览及关闭选项，并提供习俗来源说明。
优化
- 福字随殿门转动，供案侧桌避开香花操作区，节日层独立切换和释放资源。
验证
- 完整回归194项通过；粽子绳线调整后再次通过4项节日专项测试；类型检查与正式构建通过。
- 本地妈祖馆核对六组陈设，春节福字随门开合、节日切换及收起重开恢复自动模式正常。
- 未完成安卓真机性能、全部馆逐一检查及手机断点验收；天气服务连接异常，未验证天气变化下效果。
统一头像与账号菜单
LOCAL-20260916-UNIFIED-ACCOUNT-MENU优化
- 首页、公开页面与家族工作区共用账号菜单，头像沿用原有小尺寸淡色样式并显示昵称。
- 菜单统一为个人中心、我的家族、设置与记录、退出登录四项；无家族时引导进入家族空间。
修复
- 消除首页与其他页面头像和菜单不一致的问题。
验证
- 类型检查与正式构建通过。
- 浏览器核对首页和家族图谱使用相同账号组件、32px头像及四项菜单，Escape关闭正常。
- 未执行当前用户真实退出或安卓真机验收。
首页登录状态与头像菜单
LOCAL-20260916-HOME-ACCOUNT-MENU新增
- 登录后显示昵称首字头像，点击展开个人中心、家族空间、祠堂与退出登录菜单。
- 根据家族与管理权限显示设置、订单收藏及后台入口。
优化
- 首页按会话而非家族列表识别登录状态，返回页面或切换窗口时刷新。
- 菜单支持外部点击关闭、Escape返回头像、手机布局和昼夜主题。
修复
- 修复登录后首页仍固定显示登录注册入口的问题。
- 网络异常显示重试，退出失败保留账号并提示，不假装退出成功。
验证
- 10项账号与权限相关测试通过，覆盖无家族账号登录及退出后会话失效。
- 类型检查、正式构建与更新文档一致性检查通过。
- 本地浏览器使用现有登录会话核对头像、菜单与个人中心入口；验证Escape关闭、桌面及390px夜间布局。
- 未在用户当前会话执行真实退出，退出会话失效使用隔离测试验证；未做安卓真机验收。
记忆脉络动画提速
LOCAL-20260916-MEMORY-ATLAS-MOTION优化
- 连线光点周期由9秒缩短为3秒，节点漂移提速，悬停高亮反馈缩短至150毫秒。
- 继续支持暂停、页面不可见时停止及系统减少动画。
修复
- 动画使用实际时间推进，并复用连线元素，避免每帧重新创建支线。
验证
- 类型检查、正式构建与更新文档一致性检查通过。
- 浏览器核对五条光点连线周期均为3秒，暂停后动画停止。
- 参考站动态页面连接超时，未完成逐帧对比；未进行安卓真机及系统减少动画验收。
移除首页2
LOCAL-20260916-REMOVE-HOME2优化
- 移除首页2及公开、家族导航中的入口，原地址自动返回首页。
验证
- 类型检查、正式构建与更新文档一致性检查通过。
首页2按钮圆角调整
LOCAL-20260916-HOME2-ROUNDED-BUTTONS优化
- 首页2主要按钮、下载入口、导航及章节与祠堂入口统一采用更柔和的12px圆角，昼夜模式一致。
验证
- 类型检查通过；浏览器核对主要操作、导航、登录与下载按钮圆角均为12px，并检查首屏实际显示。
- 未重新运行完整回归或安卓真机验收。
首页2 React 与 Tailwind 高保真页面
LOCAL-20260916-HOME2-TAILWIND新增
- 首页2接入 Tailwind CSS，使用 React 组织可交互的高保真页面。
优化
- 统一宣纸水墨版式、章节目录、昼夜配色及手机响应式布局。
- 保留家族空间、公开祠堂、常见问题与 App 下载入口，族谱插图完整展示。
修复
- 修正主操作按钮文字对比度。
验证
- 类型检查、正式构建与更新文档一致性检查通过。
- 浏览器检查390、1024、1440px宽度无页面横向溢出；昼夜切换、章节目录、常见问题和App下载入口验证通过。
- 未进行安卓真机、减少动画系统设置及图片失败故障注入验收。
宣纸水墨首页2
LOCAL-20260916-HOME2-FIGMA新增
- 新增独立首页2，保留现有首页，并在导航中增加入口。
- 新增宣纸水墨首屏、章节目录、家谱整理与多端访问介绍。
优化
- 根据 Figma 设计调整版式、留白、文字层级与昼夜配色。
- 复用现有登录、家族空间、公开祠堂、App 下载和主题切换功能。
验证
- 189项回归测试、类型检查、正式构建与更新文档一致性检查通过。
- 浏览器检查1440、1024、390px宽度及昼夜配色，未发现页面横向溢出；目录跳转、常见问题、App下载入口验证通过。
- Figma首屏设计与完整昼夜网页对照稿已保存；未进行安卓真机验收，图片失败及系统减少动画未做浏览器故障注入验收。
电子族谱与 Android 0.12.0
RELEASE-20260916-0120优化
- 同步水墨首页、昼夜动画、导航配色与付款订单界面。
- Android 更新至 0.12.0，保留原包名、签名及网站地址。
修复
- 未配置自动支付接口时禁止新建付款订单，历史订单保留查询。
验证
- 本地189项回归、类型检查及正式构建通过，APK版本与原签名一致。
- 服务器数据库副本迁移、31馆业务与权限验收通过，切换前后核心数据和配置校验一致。
- 公网首页、后台、祠堂、天气、更新页及APK下载校验通过。
- 浏览器自动验收连接超时，未完成线上视觉复核；安卓真机覆盖安装未验收；自动支付尚未开放。
订单扫码支付界面准备
LOCAL-20260916-AUTO-PAYMENT-UI新增
- 新增项目确认与支付宝订单付款准备页面，展示固定金额和专属二维码区域。
- 订单详情增加根据真实到账状态显示的支付成功面板。
优化
- 区分付款状态与履约进度；保留历史人工订单核验入口。
修复
- 未配置支付接口时禁止默认创建新付款订单，不展示静态收款码冒充专属二维码。
验证
- 13项隔离订单测试、类型检查、正式构建及文档一致性检查通过。
- 本轮未完成付款弹窗浏览器视觉检查；真实支付、回调及自动跳转须待支付接口接入后验收。
付款页面更换支付宝收款码
LOCAL-20260916-ALIPAY-QR优化
- 付款页换用新的支付宝收款码，同步收款方、扫码说明及保存入口。
- 保留历史订单及人工核验流程，提醒已付款用户勿重复转账。
验证
- 12项隔离订单测试通过；未实际扫码付款。
恢复本地登录服务
LOCAL-20260916-LOGIN-SERVICE新增
- 提供固定使用现有本地测试资料的启动入口，避免误连旧目录。
修复
- 恢复后台运行，解决登录提示服务暂不可用。
验证
- 后台已启动，直接接口与网页转发均正常返回登录校验结果；未使用真实账号密码验证登录。
- 启动脚本语法与更新记录一致性检查通过。
微信收款码与人工核验订单
LOCAL-20260916-WECHAT-ORDERS新增
- 接入微信收款码，提供原图放大、保存及订单号复制。
- 微信订单支持提交交易单号、后台核实到账、受理及记录执行结果。
优化
- 付款失败保留输入，核验中定时刷新，可从个人中心继续查看订单。
- 区分历史模拟订单与微信订单，到账后仍须履约完成。
修复
- 微信订单禁止模拟付款，重复提交不重复入账，同一交易单号不能核验两笔订单。
验证
- 12项隔离订单测试通过，覆盖权限、并发、版本冲突、流水号复用及人工履约；未发生真实转账。
- 类型检查、正式构建及更新文档一致性检查通过。
- 收款码文件校验与原图一致；浏览器停在登录页，付款弹窗视觉检查、微信真机扫码与实际到账尚未验收。
统一首页导航选中状态
LOCAL-20260916-HOME-NAV-STATES优化
- 暖昼导航使用纸色底、赭色文字与细底线，贴合宣纸与水墨页面。
- 静夜导航使用深墨底与克制金色强调，并统一悬停和键盘焦点反馈。
修复
- 阻止通用工作区的蓝色选中样式覆盖首页导航，修复昼夜模式下底色突兀的问题。
验证
- 类型检查通过。
- 浏览器验证暖昼与静夜的导航选中状态、文字对比和主题切换表现。
落墨入夜与收墨见昼
LOCAL-20260916-THEME-INK新增
- 主题按钮增加滴墨晕染与收墨上提动画。
优化
- 墨迹变化后切换日月图案，随后页面与日月场景同步渐变。
- 切换期间避免重复触发，保留键盘焦点；减少动画设置下直接切换。
验证
- 类型检查及正式构建通过。
- 浏览器验证落墨时保持白昼、收墨时保持黑夜，动画后才改变主题；完成后恢复可操作状态。
- 减少动画逻辑已实现，未进行真机视觉验收。
修正翻书衔接与导航渐变同步
LOCAL-20260916-HOME-MOTION-CONTINUITY优化
- 封面尚未完全落下时内页接续翻动，消除停顿。
- 导航与页面共用渐变中的背景色，统一渐变曲线。
修复
- 移除封面翻到一半时突然出现的右侧空白页。
- 移除导航背景二次渐变造成的颜色滞后。
验证
- 类型检查和两项翻页时序测试通过。
- 浏览器确认封面与第一张内页接续出现；渐变中导航背景与页面背景颜色一致。
加快首页翻书与昼夜切换
LOCAL-20260916-HOME-MOTION-SPEED优化
- 翻书整体节奏加快约40%，约3秒展开完成，保留七张纸页的连续翻动。
- 昼夜配色、背景与日月动作统一缩短至1.4秒。
验证
- 类型检查及翻页时序测试通过；页面配色、山水、日月与图片渐变时长已统一。
- 本轮未重新进行浏览器视觉验收。
统一首页与线装族谱翻页
LOCAL-20260916-HOME-UNIFIED优化
- 将水墨首页设为唯一首页，移除重复导航，旧首页地址跳转至首页。
- 昼夜配色、山水背景与日月运动使用统一渐变时长。
- 线装族谱采用右侧书脊，封面与纸页从左向右翻动，分离正反面并增加纸页弯曲。
修复
- 修正最终文字提前出现、翻页正反面和封面开启方向不一致。
验证
- 完整回归186项、类型检查和正式构建通过。
- 浏览器检查封面初始画面、中间纸页、最终落页及昼夜中间色；主题切换不重新翻书。
- 390、1024、1440宽度无页面横向溢出；旧首页2、首页3地址跳转至首页。
- 未进行安卓真机验收；本机 API 数据库启动异常，登录后的家族操作未在本轮重验。
网站更新：祠堂图文与首页3动画
WEB-20260916-LOCAL-SYNC优化
- 同步当前本地网站功能，包括祠堂图文调整、六爻入口及首页3的水墨动画与记忆脉络交互。
修复
- 包含翻书最终页面显示时序修复。
验证
- 本地完整回归186项、类型检查和正式构建通过。
- 数据库副本迁移与隔离资料验收通过；公网首页、首页3、后台、更新页面、祠堂页面及天气服务检查通过。
- 发布前后既有核心数据校验一致；原 Android 安装包校验一致，本轮未重新打包。
修正翻书最终页面提前显示
LOCAL-20260916-HOME3-PAGE-SEQUENCE修复
- 最终族谱左页改为最后一张翻页的背面，落页后才固定展示，避免提前出现又被空白页覆盖。
- 右侧最终内容随最后书页翻过书脊才露出，减少动画仍直接显示完整页面。
验证
- 浏览器检查初始阶段没有最终页图层，结束阶段固定为最终左右页，无控制台错误；新增最终页面时序回归检查。
- 完整回归186项、类型检查及正式构建通过；未做安卓真机和逐帧视觉验收。
首页3多页翻书动画
LOCAL-20260916-HOME3-PAGE-FAN优化
- 封面展开后七张书页错峰翻动，增加弯曲纸缘、页间投影与落页缓动，最终停留在现有族谱页面。
- 动画约四秒，仅页面加载播放，减少动画时直接展示最终页面。
验证
- 类型检查通过；浏览器打开页面检查加载流程，未进行逐帧或安卓真机性能验收。
- 正式构建与更新记录一致性检查通过。
首页3族谱补齐线装封面
LOCAL-20260916-HOME3-BOOK-COVER优化
- 参考原画另一卷的蓝灰布纹、族譜题签与线装，补全被遮挡的封面并映射到翻书表面。
修复
- 替换此前合拢时的纯色封面，保留初次加载播放且无重播按钮。
验证
- 浏览器已检查初始合拢封面，题签、布纹和装订线正常；类型检查通过。
- 正式构建通过；本轮未新增业务逻辑或进行安卓真机验收。
首页3单卷展书与节点交互修正
LOCAL-20260916-HOME3-MOTION-REFINE新增
- 记忆脉络增加文字节点缓慢漂移、连线跟随及小节点功能说明，支持悬停、键盘和点击。
优化
- 日月改为独立天空元素，随昼夜切换升落并融入薄雾，不再移动原图圆形裁切块。
修复
- 移除展卷重播按钮，仅加载时播放；去掉直立第二卷及动画结束时整图替换，统一书页与背景衔接。
验证
- 浏览器实测节点详情打开、关闭、暂停及390像素页面无横向溢出，重播入口已移除。
- 系统减少动画设置、安卓真机及加载失败未进行现场验收。
- 类型检查与正式构建通过；浏览器确认昼夜切换不会重播翻书，无控制台错误。
首页3翻书、日月交替与记忆脉络
LOCAL-20260916-HOME3-LIVING-BOOK新增
- 首页3族谱增加沿书脊展开的分层翻页动画，可重播；保留原画中的族谱文字。
- 新增“记忆的脉络”，五条分支连接亲缘、导入、家史、祠堂和多端访问，点击进入对应介绍。
优化
- 暖昼与静夜切换增加日月升落和水墨画渐变过渡；手机端脉络采用纵向布局。
- 翻书素材加载失败回退静态画卷，减少动画时直接展开，动态脉络可暂停并在离屏时停止。
修复
- 调整首屏点击层级，确保画卷重播按钮可用。
验证
- 浏览器实测翻书重播、昼夜切换、手机画卷、脉络暂停与功能跳转；390、1024、1440像素无页面横向溢出，未记录浏览器错误。
- 减少动画分支已检查代码，未进行系统级切换或安卓真机验证。
- 完整回归185项、类型检查和正式构建通过；图片加载故障回退仅检查代码，未进行网络故障注入。
首页3展卷入场与记忆连线
LOCAL-20260916-HOME3-MOTION新增
- 首页3增加旧谱、口述、家族空间与电脑手机之间的动态连线，支持暂停和继续。
优化
- 首屏标题、说明、按钮与水墨画依次入场；下方内容随阅读渐显，保留暖昼和静夜画面。
- 连线在离屏或页面隐藏时暂停，系统减少动画时改为静态展示。
验证
- 浏览器检查暖昼、静夜、390/1024/1440像素布局，无页面横向溢出；连线暂停、继续和离屏暂停正常，浏览器未记录错误。
- 减少动画分支已检查代码，未进行系统设置切换或安卓真机验收。
- 完整回归185项、类型检查及正式构建通过。
七馆造像图片更新与祠堂目录调整
LOCAL-20260916-SHRINE-PHOTOS优化
- 月老、灶神、寿星、文昌帝君、魁星、神农、玄天上帝重新选用许可明确的供奉造像实拍，卡片与三维图像神龛同步更新。
- 移除土地公、城隍入口，保留历史献礼、订单和累计积分；其他人物保持原样。
修复
- 取消月老神龛旧图专用地址，避免实拍与场景图片不一致。
验证
- 已对比12张候选及7张最终裁切图，逐项保存来源、作者、日期、裁切范围及许可。
- 完整回归185项通过；覆盖已移除馆的访问和献礼拦截、历史积分及记录保留、其他馆图片配置不变。
- 类型检查、正式构建和更新文档一致性检查通过；浏览器已检查31馆目录、月老实拍与来源展示，390像素页面无横向溢出。未逐馆进行三维现场漫游验收。
六爻解释新增专业版入口
LOCAL-20260915-LIUYAO-PRO新增
- 在卦象解释的原典链接右侧增加“专业版”，新标签页打开指定网站，保留当前卦象。
验证
- 链接地址与新标签页属性已核对，类型检查通过；更新文档已同步并通过一致性检查。
铜钱模型移至墙边地面
LOCAL-20260915-COIN-PLACEMENT优化
- 三枚立体方孔铜钱移至山门左侧墙脚附近地面，点击模型开启六爻。
修复
- 修正铜钱被铺地遮挡的问题，移除常驻圆圈提示，仅键盘聚焦时显示焦点标记。
验证
- 183 项回归通过；最终位置的三项专项测试、类型检查及正式构建通过。
- 浏览器验证实体铜钱显示和六爻入口，取消常驻圆圈。
山门铜钱与六爻文化互动
LOCAL-20260915-LIUYAO新增
- 山门左侧新增三枚方孔铜钱，可点击进入六爻互动。
- 独立摇卦六次，按自下而上记录爻象，展示本卦、动爻、变卦及 64 卦通俗解释。
优化
- 支持摇卦动画、减少动态效果、键盘访问和关闭后继续；离开参观后清空记录。
验证
- 完整回归 183 项、类型检查、正式构建通过。
- 浏览器完成六次摇卦、动爻变卦与解释展开，验证关闭重开保留结果、焦点返回铜钱。
- 390px 弹窗内容滚动且操作按钮可达；安卓真机及系统减少动画模式未实机验收。
祠堂接入实物灰泥材质
LOCAL-20260915-SCANNED-WALLS新增
- 引入两套免费 CC0 灰泥素材，外墙与殿内分别使用粗细不同的抹灰表现。
优化
- 颜色、高度与粗糙度按空间尺寸铺设，增加墙脚分段压顶，保留完整窗洞侧壁。
- 两档贴图按需加载并共享，失败保留原墙面，退出后释放资源。
验证
- 完整回归 180 项、类型检查及正式构建通过，新增墙面贴图已纳入场景预算检查。
- 本机 RTX 5070 Ti OptiX 完成两套材质对比渲染，64 采样约 3.38 秒。
- 桌面殿前、殿中、开门通行及全屏检查正常，390px 无正文横向溢出；安卓真机性能与真实天气联动未验收。
祠堂墙面灰泥质感优化
LOCAL-20260915-WALL-FINISH优化
- 室内外灰泥墙增加抹灰层次、细砂凹凸、粗糙度变化和克制的墙脚色差。
- 按空间尺度生成墙面细节，兼容基础模型与精细模型，不增加外部贴图下载。
修复
- 避免墙面细节随墙体尺寸拉伸；保留已有光照处理。
验证
- 完整回归 178 项、类型检查和正式构建通过。
- 本地浏览器检查殿前、殿中墙面、自动开门及全屏；未出现材质编译错误。
- 安卓真机性能与真实天气联动未验收，本地天气服务仍提示连接失败。
电子族谱 0.11.0：人物馆扩充与首页3优化
RELEASE-20260915-0110新增
- 新增 13 座人物馆与原创造像效果图，目录扩展至 33 馆。
优化
- 同步首页3水墨展示、功能入口与下载交互优化。
- Android 更新至 0.11.0，沿用原包名、签名与主域名。
修复
- 扩展献礼与收藏目录约束，生成图与实拍明确区分，群像保留完整构图。
验证
- 本地完整回归 177 项、类型检查、正式构建与更新记录一致性检查通过。
- 云端 PostgreSQL 副本迁移通过，隔离资料验证 33 馆访问与收藏、新馆献礼、积分、隐私与权限；核心业务数据切换前后校验一致。
- 公网首页、首页3、后台、更新记录、注册及找回密码入口正常；13 张新增图片与 APK 下载校验一致。
- API 与 OCR 健康检查通过，天气地区与坐标查询正常；新旧 APK 签名一致。
- 安卓真机覆盖安装、登录保持、文件导入导出与三维性能，以及完整后台浏览器交互仍待验收。
按庙宇清单补齐人物馆与造像效果图
LOCAL-20260915-SHRINE-CHECKLIST新增
- 新增释迦牟尼佛、四大天王、十八罗汉、三清、玉皇大帝、太上老君、王母娘娘、八仙、送子观音、门神、福禄寿三星、孔子和岳飞，共 13 馆。
- 新增 13 张原创彩绘造像效果图、人物介绍、分类和参考来源，目录增至 33 馆。
优化
- 群像保留完整构图；生成图明确标注非实拍，参观页区分图像神龛与文曲星立体雕像。
- 补充别称搜索，并说明三清与老君、观音与送子观音、三星与寿星的关联。
修复
- 扩展献礼与收藏目录约束，新增馆沿用现有个人记录、积分与权限流程。
验证
- 完整回归 177 项通过，包含新增 13 馆献礼、收藏、积分与重复迁移验证。
- 网页已验证 33 馆列表、秦琼别称搜索与门神造像效果图入口。
- 图片及缩略图合计 4266108 字节；全部原图已保存在本地。
- 类型检查与正式构建通过；门神馆在 390、1024、1440px 下正文无横向溢出，已检查图片放大、恢复、三维切换与收起重开。
- 既有本地数据库启动异常尚未处理，登录后浏览器写入、实时天气及安卓真机未验收；数据操作使用隔离 PGlite 验证。
首页3内容精简与入口补全
LOCAL-20260915-HOME3-POLISH新增
- 补齐六个功能章节入口、多端区域的 App 下载入口，以及四条常见问题。
优化
- 减少开篇铺垫和重复祠堂入口，开始整理与进入家族空间统一通过已有家族入口。
- 设备示意与下载面板采用更协调的水墨配色，提升说明文字可读性。
- 手机首屏改为顺序排版，避免文字与背景重叠；等待配色就绪后加载对应画作。
修复
- 背景加载失败的重试按钮移到可交互前景层。
- 下载面板关闭后返回触发按钮；补充键盘跳过导航入口。
验证
- 完整回归 175 项、类型检查及正式构建通过。
- 浏览器验证六个章节锚点、常见问题展开、下载面板开关、关闭后的焦点返回与键盘跳过导航。
- 检查 390、1024、1440px 和昼夜配色，正文无横向溢出。
- 本地既有数据库启动异常，登录后家族流程未能验收；原数据未重置。图片失败重试和减少动画尚未做浏览器故障注入及系统设置实测。
新增水墨长卷首页3
LOCAL-20260915-HOME3新增
- 首页3保留首页2的族谱与山水背景，并随昼夜配色切换对应画作。
- 加入首页中的多端访问、亲缘图谱、导入校对、家史、电子祠堂与隐私说明。
优化
- 用纸页章节、宋楷标题与朱砂点缀统一宣传内容，导航在首页2之后加入首页3。
- 复用 React Bits 章节入场，支持减少动画；图片加载失败提供重试。
验证
- 完整回归 175 项、类型检查和正式构建通过。
- 已检查 390、1024、1440px 页面宽度、昼夜切换、背景加载及章节跳转，正文无横向溢出。
- 图片失败重试与减少动画已提供实现，尚未做浏览器故障注入及系统减少动画实测；未部署云端或更新 App。
电子族谱品牌更新与主站发布
RELEASE-20260915-0100新增
- 主域名现可访问电子族谱首页，总管理后台位于 /admin；服务器 IP 自动转到 HTTPS 主站。
优化
- 产品名称统一为电子族谱，家族历史后的电子祠堂仍保留原功能名称。
- 同步发布当前首页、邮箱注册与找回密码、祠堂展示及文曲星原创造像等本地改进。
- Android 0.10.0 使用 HTTPS 主站，保持原包名与签名；域名变化后可能需要重新登录。
修复
- 同步 App 客户端版本标识。
验证
- 完整本地回归 175 项、类型检查、正式构建及更新文档一致性检查通过。
- 云端数据库副本验证注册确认、20 个祠堂、献礼积分、隐私、照片与版本冲突；正式切换前后既有核心数据一致。
- 公网首页、后台入口、更新页、注册与找回密码页面、旧入口、天气查询及 APK 下载校验通过，邮件服务器身份验证通过。
- 浏览器确认首页产品名称与祠堂导航名称；后续交互验收因浏览器控制超时未完成。安卓真机覆盖安装及完整操作尚待验收。
文曲星造像效果图与立体模型接入
LOCAL-20260915-WENQU-SCULPTURE新增
- 文曲星馆新增原创造像效果图，并明确标注生成内容，区分真实庙宇实拍。
- 三维神龛增加端坐持卷的独立彩绘文士模型，包含座椅、底座、衣袍及静态遮蔽贴图。
优化
- 提供电脑与手机两档雕像；为文曲星单独压缩基础建筑，完整场景维持资源预算。
- 模型完成加载后替换姓名牌位；失败保留基础显示，离开后释放迟到资源。
验证
- 完整本地回归 175 项通过，覆盖模型体积、供案净空、资源释放、场景预算及现有献礼与权限。
- 已在 1440、1024、390px 检查页面、图片与三维切换及供案视点，无正文横向溢出。
- Blender 工程使用 RTX 5070 Ti 渲染，重开后贴图保留且可复渲染。
- 类型检查、正式构建与更新文档一致性检查通过；已检查全屏切换和收起重开。
- 模型自然度仍与生成参考图有差距；安卓真机、不同天气与完整键盘操作尚未验收。
文曲星原创造像形象与三维灰模样板
LOCAL-20260915-WENQU-CONCEPT新增
- 完成端坐彩绘文士的正面创作效果图与正侧背制作参考，明确区分生成内容和真实庙宇实拍。
- 制作包含坐姿人物、书卷、座椅和底座的完整立体灰模，提供多角度审阅图与 Blender 工程。
优化
- 整理文曲、文昌与魁星的文化参考和形象边界；背面结构标注为原创设计。
验证
- 本机 RTX 5070 Ti 已使用 Cycles OptiX 完成灰模渲染；已检查正面、侧面、背面与斜侧面。
- 保存后重新打开 Blender 工程并复渲染成功，内置参考图保留；类型检查、正式构建和更新文档一致性检查通过。
- 本轮仅供形象与结构审阅；最终雕刻、贴图及网页接入尚未进行，不代表最终网页效果。
财神殿与五路财神实拍、三维陈列
LOCAL-20260915-FIVE-WEALTH-HALL新增
- 财神馆更名为财神殿，介绍赵公明、萧升、曹宝、陈九公与姚少司五路财神。
- 新增五张台中南天宫财神洞造像实拍，可分别切换、放大并查看摄影与许可。
- 三维场景改为中央赵公明与两侧四路财神的授权照片陈列，配有各自名号。
优化
- 保留原馆标识、收藏和献礼归属，新增五路财神及各人物搜索词。
- 三维照片部分加载失败时保留姓名和成功图片，离开后释放迟到资源。
验证
- 9 项定向测试通过，覆盖路线、各馆身份、素材校验、照片加载失败与资源释放、原有献礼及幂等。
- 类型检查、正式构建与更新文档一致性检查通过。
- 已在浏览器检查桌面三维殿中五尊陈列、实拍切换及 390px 图片加载，正文无横向溢出。
- 未进行安卓真机、系统减少动画和全量业务回归。
首页数字家谱视觉与入场动画
LOCAL-20260915-HOME-DIGITAL-HERITAGE新增
- 家族树增加数字展台、细线轨迹与沿枝干播放的光线，保留原创人物头像。
- 首屏与功能章节加入轻量入场动画，强调网页与 Android 两端使用。
优化
- 首页日夜两套科技蓝配色、标题层级、按钮及功能图文样式统一调整。
- 动画播放后停止；开启减少动画时显示静态内容，加载脚本前正文也保持可读。
验证
- 类型检查、正式构建及更新文档一致性检查通过。
- 已在浏览器检查 1440px 暖昼与静夜、1024px 暖昼、390px 静夜首屏和导入章节，无正文横向溢出；日夜切换和功能目录跳转正常。
- 减少动画与卸载清理已代码检查；尚未在系统减少动画设置、安卓真机和读屏工具下验收。
增加页面动画组件基础资源
LOCAL-20260915-REACT-BITS新增
- 引入文字渐显、内容淡入和滚动入场三种动画组件，供后续页面设计按需使用。
验证
- 类型检查、正式构建及更新文档一致性检查通过。
- 组件尚未接入页面，未进行动画效果验收。
暖昼族谱主图补充日轮
LOCAL-20260915-INK-DAY-SUN优化
- 暖昼族谱主图右上方增加水墨日轮，与静夜月亮位置呼应，沿用完整比例展示。
验证
- 已检查生成图中日轮与族谱内容；本轮未进行浏览器截图复验。
首页2白天水墨版与月亮适配
LOCAL-20260915-INK-DAY-MOON-FIT新增
- 新增白天版族谱和江南祠堂水墨配图，沿用原书页文字与世系示例。
优化
- 首页2日夜共用水墨长卷版式，暖昼采用宣纸底色、淡墨远山和日光书页，保留已有动画与功能入口。
修复
- 主视觉改为保持完整比例展示，避免电脑端铺满裁切导致月亮消失；手机端配图独立排在文案下方。
验证
- 浏览器在1440宽度检查了静夜月亮完整显示，以及切换后白天族谱与文字的展示。
- 本轮未完成手机真机验收；日夜配图以生成素材制作，未部署服务器或更新 App。
- 类型检查、正式构建及更新文档一致性检查通过。
参考族谱实物重绘首页书册
LOCAL-20260915-GENEALOGY-REFERENCE-V3优化
- 参照已查看的徽州家谱内页照片，重做薄纸线装册、平展书页、细版框及分层世系。
- 右页采用三代世系示例，左页人物条目与关系对应；标注示例，不复制参考图真实家族资料。
验证
- 人工检查生成图的书页结构、示例文字及图文关系；参考出处和素材说明已保存。
- 类型检查、正式构建及更新文档一致性检查通过；页面截图尚未复验。
首页族谱宣传图文字校订
LOCAL-20260915-GENEALOGY-TEXT-REVIEW优化
- 参考传统族谱栏目，将宣传图书页改为繁体竖排目錄与凡例，采用经核对的短文，保留水墨画面与线装书质感。
修复
- 移除原图密集伪文字和虚构世系图；说明凡例为原创示意内容，不冒充古籍原文。
验证
- 已人工检查新图题签、目录五项及四列凡例文字，素材和体例参考已写入文档。
- 类型检查、正式构建与更新文档一致性检查通过；本轮未进行页面截图复验。
首页2静夜水墨长卷改版
LOCAL-20260915-INK-NIGHT-REDESIGN新增
- 新增传统线装族谱样式与月夜祠堂水墨原创宣传图，包含纸页、缝线、竖排版式与世系图细节。
- 新增画卷渐显、短暂雾气流动与分段进入动画，支持系统减少动画设置。
优化
- 首页2静夜重设计为墨黑、月白与朱砂点缀，使用水墨画面串联家谱、名册、家史、祠堂和多端访问介绍。
- 暖昼保持现有页面；静夜保留导航、注册登录、家族空间和免登录文化祠堂入口。
- 图片保存到项目并压缩为 WebP，保留加载失败提示与重试入口。
验证
- 浏览器检查了1440与390宽度静夜画面，窄屏未发现正文横向溢出，两张宣传图加载正常；已验证日夜切换。
- 宣传图为生成素材，不冒充真实家族档案或景点实拍；两张源 WebP 合计301316字节。
- 尚未完成安卓真机、Lighthouse性能测量、模拟图片失败重试及系统减少动画的浏览器实测。
- 类型检查、正式构建和更新记录格式及文档一致性检查通过。
首页树头像装饰精简
LOCAL-20260915-TREE-ROUND-AVATARS优化
- 去掉首页人物头像外侧的叶形底板与叶脉装饰线，保留圆形头像和枝叶展开效果。
验证
- 已核对头像叶形路径已移除，人物图案与树枝保持不变。
- 类型检查、正式构建和更新文档一致性检查通过；本轮未进行浏览器截图复验。
中国风首页2与头像家族树
LOCAL-20260915-INK-HOME-TWO新增
- 在首页后新增首页2入口，以原创线装族谱插画、宣纸纹理、水墨远山和印章介绍图谱、导入、家史、祠堂及多端访问。
- 首页2支持日夜配色，并提供注册、家族空间与免登录文化祠堂入口。
优化
- 原首页大树的世代文字改为原创示意头像，保留枝叶展开动画，不使用真实人物资料。
- 公共导航和家族导航同时加入首页2，原首页继续保留。
验证
- 浏览器已检查原首页头像树、首页2桌面日夜配色及首页导航切换。
- 未进行手机真机验收；本轮没有修改业务接口或写入家族资料。
- 类型检查、正式构建和更新文档一致性检查通过。
下拉菜单与内页日夜配色修复
LOCAL-20260915-INNER-PAGE-SURFACES优化
- 家史空状态、提示卡、编辑区和修订记录统一使用当前主题的背景、边框与文字颜色。
- 补齐人物详情、弹窗标题与底栏、支系面板等共用区域的主题配色。
修复
- 修复电子祠堂下拉列表外层白底形成明显白框的问题，保留清晰的键盘焦点提示。
- 修复静夜家史页面出现白色和浅紫色卡片、标题对比度不足的问题。
验证
- 浏览器已检查家史页面暖昼和静夜切换，以及静夜下拉菜单、空状态和引导卡片。
- 类型检查、正式构建与更新记录格式及文档一致性检查通过。
- 本轮仅修改样式，未进行数据写入测试；其他业务页与手机真机尚未逐页实测。
导航悬停可读性与图标配色开关
LOCAL-20260915-NAV-HOVER-ICON优化
- 配色切换改为圆形太阳和月亮图标，保留鼠标提示、无障碍名称及44像素点击区域。
修复
- 修复家族导航悬停时遗留白色文字与浅色背景冲突；公共导航和选中项悬停同时使用当前主题配色。
验证
- 类型检查、正式构建和更新文档一致性检查通过。
- 已核对旧悬停规则及主题样式优先级；本轮浏览器连接状态已失效，尚未完成实际鼠标悬停复验。
日夜视觉重设计与备案入口
LOCAL-20260915-APPEARANCE-REDESIGN-ICP新增
- 全站页面底部增加鲁ICP备2026008965号-4，链接至工信部备案网站。
优化
- 暖昼重设计为象牙白、陶土色与深蓝文字；静夜采用深海蓝与柔和金色。
- 重新调整首页拱形主视觉、标题层级、按钮、功能概览及卡片层次，保留世代大树和配色记忆。
修复
- 修正首屏标题在部分桌面宽度下出现的意外换行。
验证
- 类型检查、正式构建及更新文档一致性检查通过；浏览器已检查两套桌面首页、日夜切换与备案号实际显示，并核对链接地址。
- 本轮未改动业务接口，未重复业务回归；手机真机与全部业务内页尚未实测。
首页功能介绍与参考版式整合
LOCAL-20260915-HOME-REFERENCE-SECTIONS新增
- 首页加入可定位的功能概览、多端说明、三代图谱示意、导入校对三步、家史时间线与故事卡。
- 增加公开祠堂和家族空间双入口，以及成员权限、资料来源、修改记录介绍。
优化
- 保留粗壮世代大树、电脑手机插画及暖昼静夜配色；演示内容明确标注，注册说明与邮箱验证流程保持一致。
验证
- 类型检查、正式构建及更新文档一致性检查通过；浏览器核对页面内容和导入区域定位，检查静夜三步卡片、家史区域与暖昼隐私收尾卡片。
- 本轮未改变业务接口或读取演示用真实资料，未重复业务回归；手机真机及全部响应式宽度未实测。
暖昼与静夜配色及世代大树
LOCAL-20260915-WARM-APPEARANCE新增
- 新增暖昼与静夜配色切换，保存本机选择并在刷新、页面切换后沿用。
优化
- 加粗首页大树主干、枝条与根系，叶片仅显示世代，移除姓名和人物关系文案。
- 页面采用暖纸色、木色与静夜靛蓝，减少光晕和装饰，首页、账户及业务阅读区域共享配色。
验证
- 类型检查、正式构建及更新文档一致性检查通过；浏览器检查暖昼首页、静夜首页及注册表单，已验证配色切换与重新打开页面后的保留。
- 本轮未调用注册或邮件接口；手机真机、全部后台内页及系统减少动画模式未实测。
家族树人物叶片与全站视觉衔接
LOCAL-20260915-GRAND-TREE-THEME新增
- 首页大树扩展树冠、根系与枝条，以叶片展示三代虚构人物、世代和亲缘关系。
优化
- 家族工作区导航改为深蓝配色，统一图谱、资料与表单的浅蓝阅读区域。
- 公开祠堂卡片、管理后台和更新页面同步调整边框、背景及配色，保持资料可读性。
验证
- 类型检查、正式构建及更新记录一致性检查通过；浏览器已检查首页树冠、图谱空状态、导入入口与公开祠堂卡片，未写入数据。
- 本轮仅调整视觉，未改变权限和业务接口；手机真机、管理后台全部内页及完整业务回归未重复验收。
会生长的家族树与多端连接插画
LOCAL-20260915-LIVING-TREE-DEVICES新增
- 首页增加树干、根系与枝叶逐步展开的家族树，将人物档案、家谱、家史和数字祠堂融入枝叶。
- 多端区域增加原创电脑与手机插画，用流动光带连接两端的家族记忆示意。
优化
- 示意图使用可缩放矢量绘制，适应页面宽度，并支持减少动画偏好。
验证
- 类型检查、正式构建及更新文档一致性检查通过；浏览器已核对本地首页内容与桌面主视觉。
- 本轮未修改业务接口，未重复运行业务回归；手机真机与系统减少动画模式尚未实测。
首页前端开发交接说明
LOCAL-20260915-HOMEPAGE-HANDOFF新增
- 新增首页开发交接说明，整理产品定位、页面内容、家族树视觉、多端展示、账户流程及验收要求。
验证
- 已对照现有首页、导航、账户和下载组件核对说明；本轮未修改程序行为，未重复运行界面或业务测试。
完整首页导航与宽幅账户页面
LOCAL-20260915-HOME-NAV-DESKTOP新增
- 首页加入展开的三代家族树示意与网页、Android App 多端联动介绍。
优化
- 首页位于家族图谱前；首页、公开祠堂与账户页面展示完整功能导航，私密功能仍需登录和权限。
- 注册与找回密码使用宽幅桌面双栏表单，窄屏自动调整为单栏。
- 登录或注册成功后默认返回首页，可从导航进入各功能。
验证
- 类型检查通过；已在浏览器检查1440像素注册页与首页、1024像素首页，未出现正文横向溢出。
- 本轮仅调整页面与导航，未发送邮件或修改密码。
- 390像素首页与找回表单、1024像素找回表单无正文横向溢出；首页与家族图谱双向导航通过。正式构建、更新文档一致性检查通过。本轮未重复运行业务回归，未进行真实注册或重置。
科技感首页与邮箱验证账户服务
LOCAL-20260915-HOME-EMAIL-AUTH新增
- 新增项目宣传首页，展示家族图谱、图片导入、家史和电子祠堂参观，右上角提供登录与注册入口。
- 新增邮箱验证码注册和找回密码；密码重置后退出其他设备的旧登录。
优化
- 公开参观与家族空间分别提供入口，首页不再直接展示登录表单。
- 验证码采用一次性、有效期、发送频率和错误次数限制；失败保留表单输入。
修复
- 修复手机首页装饰图形引起的横向溢出。
验证
- 169 项回归通过，邮箱流程测试使用模拟发送器与隔离资料。
- 真实 SMTP 测试发送成功，用户确认收到邮件；未修改真实账户密码。
- 浏览器检查首页入口、手机找回密码表单和登录失败反馈；完整真实账户注册和找回流程由用户验收。
- PGlite 迁移已验证，独立 PostgreSQL 与安卓真机尚未验收。
- 390、1024、1440 像素首页检查完成；类型检查、正式构建及更新文档一致性检查通过。
无需登录即可参观其他电子祠堂
LOCAL-20260914-PUBLIC-SANCTUARIES新增
- 新增独立公开祠堂目录和人物详情，无需登录或建立家族即可浏览图文、实拍及 3D 场景。
- 登录页面与未建立家族的页面提供公开参观入口。
优化
- 公开页面复用现有图文与场景，不加载个人祈福记录、收藏或家族资料；个人操作保留现有登录及权限检查。
验证
- 不带登录信息的目录和详情请求返回成功；个人中心公开地址返回 404，个人记录和家族接口仍返回未登录。
- 浏览器检查搜索、人物详情、妈祖实拍及 3D 加载，390 像素未出现正文横向溢出。
- 完整回归 165 项通过。安卓真机未验收；本机实时天气连接失败，场景可继续参观。
- 1440 像素公开目录布局、类型检查和正式构建通过，更新文档已同步。
电子祠堂下拉导航
LOCAL-20260914-SHRINE-NAV新增
- 顶部电子祠堂菜单提供家族电子祠堂和其他电子祠堂两个入口。
优化
- 移除家族电子祠堂页面内的重复跳转按钮，统一从顶部下拉菜单进入。
- 下拉菜单适配窄屏，支持键盘操作、Escape 和点击外部关闭。
验证
- 浏览器验证两个入口跳转与自动收起、键盘进入、Escape 关闭、点击外部关闭；检查 390 和 1440 像素菜单位置。
- 类型检查通过；未改动业务数据，未重复运行完整业务回归。
- 正式构建通过，更新记录已同步并通过文档一致性检查。
顶部导航验收与键盘焦点修复
LOCAL-20260914-NAV-ACCEPTANCE修复
- 从账号菜单打开弹窗并关闭后，键盘焦点返回可见的账号入口。
验证
- 恢复浏览器验收，检查 390、1024、1440 像素下的顶部导航；所检页面未出现正文横向溢出，手机导航在自身区域滚动。
- 人物档案、设置与记录和图谱导航切换，账号菜单展开、Escape 关闭及邀请弹窗关闭后的焦点恢复通过。
- 未提交业务数据；多家族切换和安卓真机尚未验收。
- 类型检查、正式构建通过；更新文档已同步并通过一致性检查。本轮未重复运行完整业务回归。
家族工作区改为顶部横向导航
LOCAL-20260914-TOP-NAV优化
- 家族导航从左侧移至顶部，内容区域使用完整宽度；窄屏可横向滑动导航。
- 家族切换保留在顶栏，创建家族、邀请与账号操作集中在右上角菜单。
- 电子祠堂人物馆沿用电子祠堂导航高亮，账号菜单支持 Escape 关闭。
验证
- 类型检查、正式构建和更新文档一致性检查通过。
- 浏览器验收被自动审批系统兼容性错误阻断，实际布局、窄屏和菜单交互未完成验收。本轮未重复运行完整业务回归。
整理跨电脑开发迁移包
LOCAL-20260914-HANDOFF新增
- 提供源码与网页模型包、可选 Blender 源素材包，以及新电脑开发说明。
优化
- 排除依赖、构建缓存和旧发布包，保留模型制作所需源文件。
验证
- 三个压缩包完整性检查通过，提供逐文件清单及 SHA-256 校验值；主开发包未包含私有配置、签名或本地数据库。
- 新电脑实际安装尚未验收，Blender 与 Android 工具路径需按说明配置。
启用电子祠堂专属 HTTPS 域名
WEB-20260914-DOMAIN新增
- 通过 https://zoop.yuanhangxing.top 访问电子祠堂，HTTP 自动转至 HTTPS。
优化
- 启用有效证书及自动续期，保留原地址供旧 App 使用。
验证
- 域名解析、证书、公网首页、登录页、后台、更新页、下载和天气检查通过。
- 合法来源的空登录请求进入参数校验，非本站写入请求被拒绝；未使用真实账号完成登录操作。
- 原有另一个网站首页摘要保持一致；Android 真机未验收。
电子祠堂 0.9.0：全馆精细场景与供案互动
RELEASE-20260914-090优化
- 精细三维场景覆盖人物馆与已开启三维的自建祠堂，完善墙窗、屋顶和蒲团。
- 人物馆供案附近显示圆形互动按钮，香花图案与动作融入按钮。
- Android 0.9.0 沿用原包名、签名及云端地址。
验证
- 本地完整回归 165 项、类型检查与正式构建通过。
- 云端数据库副本迁移及 20 馆、权限、献礼与照片检查通过；切换前后核心数据摘要及配置校验一致。
- 公网首页、登录、后台、更新记录、天气与两档蒲团模型通过；APK 下载校验与原签名一致。
- 安卓真机覆盖安装、登录保持与性能尚未验收，全部馆逐一视觉验收未完成。
精细三维场景覆盖人物馆与自建祠堂
LOCAL-20260914-SHARED-REFINED-SCENE优化
- 将最新屋顶、墙窗、回廊、庭院、灯笼、供案与蒲团接入全部人物馆及已开启三维的自建祠堂。
- 统一精细模型加载与光照，保留各馆姓名、主像和主题；人物馆沿用供案图案按钮。
修复
- 解除精细构件仅在财神馆加载的限制。
验证
- 完整回归 165 项通过，含全部人物与自建馆两档最新基础模型身份保留检查。
- 类型检查、正式构建通过，更新记录与文档同步。
- 妈祖馆网页已检查精细建筑；不变更自建祠堂原有三维开关、献花点烛或纪念照片。
- 全部馆逐一视觉检查及安卓真机性能未完成。
- 当前家族没有已建纪念馆，带真实纪念照片的自建馆未完成界面验收，未创建测试人物或修改数据。
香花图案与动作融入圆形按钮
LOCAL-20260914-ALTAR-BUTTON-EFFECTS优化
- 敬香与献花圆形按钮直接显示原有香炉、花束图案；成功后在对应按钮内播放动作。
修复
- 移除成功后按钮上方重复弹出的香花图案，保留文字反馈和场景内三维献礼。
验证
- 网页已确认香炉、花束图案显示在圆形按钮内。
- 类型检查、正式构建通过；更新文档已同步。
- 本轮未提交实际献礼、未重复运行完整回归；成功动画与安卓真机未作操作验收。
供案互动改为三个圆形图案按钮
LOCAL-20260914-ALTAR-ICONS优化
- 到达供案附近后，下方仅显示敬香、献花、香火三个圆形图案按钮，保留键盘名称及悬停说明。
- 成功反馈短暂显示，离开供案后隐藏互动；实拍与异常回退保留原操作区。
修复
- 移除远处走近供案提示与供案大面板，减少对场景的遮挡。
验证
- 类型检查、正式构建通过；更新文档已同步。
- 网页确认远处不显示献礼引导，到供案后出现三个圆形图标；香火图标可打开并关闭项目弹窗。
- 未提交实际献礼与订单；安卓真机、全屏及全部屏宽未重新验收。本轮未重复运行完整回归。
供案前的场景互动献礼
LOCAL-20260914-ALTAR-INTERACTION新增
- 走近供案后在场景内出现敬香、献花与香火互动菜单；远处提供走近供案入口。
优化
- 根据镜头实际位置显示菜单，离开供案后收起，沿用原有香花图像、成功动作、积分提示和香火界面。
- 压缩互动区并保留匿名选项、错误重试与献礼说明，支持减少动画。
修复
- 三维显示失败时保留普通献礼入口。
验证
- 完整回归 164 项通过，包含供案实际距离与各场景锚点检查。
- 类型检查、正式构建与更新记录一致性检查通过。
- 本地网页已检查走近供案弹出菜单、离开后收起、香火弹窗及关闭；未提交真实献礼或订单。
- 安卓真机与全套屏宽、实际献礼后的动画尚未逐项界面验收。
重制财神大殿编织蒲团
LOCAL-20260914-CUSHIONS新增
- 原创封闭蒲团模型、编织材质、圆润包边与轻微坐面压陷。
优化
- 依据实际地面高度摆放，两档模型共享重复构件，保持中轴通行空间。
修复
- 替换旧蒲团并清理遗留悬空圆线；加载失败保留基础模型，离开后释放迟到资源。
验证
- 完整回归 163 项通过，覆盖两档贴图、地面接触、通道边界、失败回退、资源释放与总资源预算。
- 已使用 RTX 5070 Ti 的 Cycles OptiX 实际渲染同机位前后效果图，并检查本地网页近景。
- 类型检查、正式构建及更新记录与文档一致性检查通过。
- 安卓真机性能及全部指定屏宽未验收；离线渲染不等同网页实时画质。
补齐财神主殿前窗的内外结构
LOCAL-20260914-FRONT-WINDOWS新增
- 四个前窗的贯通窗洞、贯穿墙厚的窗框、内侧窗棂及内窗台。
优化
- 统一内外窗格位置与窗衬，保留下半部木板和外侧收边。
修复
- 修复前窗后仍为整块墙、从殿内看不到窗户的问题。
验证
- 完整回归 161 项通过，包括窗洞墙垛、门洞避让和四窗内外射线可见性。
- 实际本地网页已从殿内回望检查窗框、窗棂和窗台；安卓真机未验收。
- 类型检查、正式构建和更新文档一致性检查通过。
协调财神主殿墙窗与庭院材质细节
LOCAL-20260914-EXTERIOR-HARMONY新增
- 主殿窗内衬层、窗框收边及灰砖墙脚。
- 回廊分段叠瓦、瓦端厚边和分段屋脊。
优化
- 统一灰泥、木构、灰瓦及柱础的色调与粗糙度，减弱回廊木柱的鲜亮反光。
- 增加树皮凹凸、叶脉、多层叶色和不规则树冠，调整树干锥度。
- 重复瓦片采用实例化，共享贴图与几何；两档贴图在本地生成，无新增外站图片请求。
验证
- 完整回归 159 项通过，包含材质确定性与释放、叠瓦厚度与边界、窗墙装饰避让殿门。
- 网页已检查墙窗及回廊、树木视角；安卓真机帧率未验收。
- 类型检查、正式构建和更新文档一致性检查通过；实际浏览器检查宽度 448px，未完成全部桌面宽度逐项截图。
按原素材比例重新适配财神主殿屋顶
LOCAL-20260914-ROOF-REFIT优化
- 从原始授权建筑素材重新提取屋顶，统一缩放，恢复坡面、翘角与脊饰之间的比例。
- 增加两侧承托梁柱和檐下空间，保留中央殿门及参观路线。
- 提高瓦片保留精度，加入本地网格解码和压缩，维持电脑与手机资源预算。
修复
- 替换此前分别拉伸宽深高的屋面和不匹配的旧长椽条。
验证
- 完整回归 156 项通过，包含实际压缩模型解码、原素材比例、衬板闭合及两档资源预算。
- 已检查本地网页庭院正面和殿前仰视；安卓真机性能未验收。
- 类型检查、正式构建及更新文档一致性检查通过；网页自动开门进殿已验证。
修正主殿屋檐比例与衬板
LOCAL-20260914-EAVES优化
- 缩短主殿前后出檐，重建贴合瓦底的衬板和有厚度的封闭檐口。
修复
- 修正屋檐出挑过深、衬板过度简化导致的大平面与接合异常。
- 同步收短殿前椽条，避免骨架伸出瓦面。
验证
- 完整回归 156 项通过，包含两档屋檐边界、衬板闭合、椽条对齐及资源预算检查。
- 本地网页已检查庭院正面及殿前仰视；安卓真机画面与性能未验收。
- 类型检查、正式构建及更新文档一致性检查通过。
补齐灯笼与器皿表面细节
LOCAL-20260914-MATERIAL-DETAIL新增
- 灯笼细织物贴图、门前木石表面凹凸，以及原创铜器和陶瓷微纹理。
优化
- 香炉及茶具主体与装饰细节共享材质，避免只有边缘得到优化；保留已经完善的苹果、屋瓦和回廊素材。
修复
- 移除精细模型中无用的纹理坐标层，控制新增材质开销。
验证
- 154 项完整回归、类型检查、正式构建通过；桌面与手机资源预算通过。
- 使用 RTX 5070 Ti 完成灯笼、门前构件和器皿三组同机位离线对比，并检查本地网页供案效果。
- 未完成安卓真机性能与全部人物馆人工验收；糕点、花瓣叶片等尚未更换专用贴图，详见材质清单。
恢复本地实时天气
LOCAL-20260914-WEATHER-RESTORE优化
- 本地天气配置持久保存，重启后继续使用已配置的天气服务。
修复
- 修复本地重启后回退到不可连接的旧天气服务而显示未更新的问题。
验证
- 本地应用接口实测广州实时天气和地区搜索成功，天气来源为 WeatherAPI。
- 仅调整本地私有配置并重启网页服务，未修改业务代码；未进行安卓真机验收。
依据写实指南修复木构材质与光照层次
LOCAL-20260914-GUIDE-MATERIALS新增
- 供桌、神龛与格扇补齐木材粗糙度和微法线，保留现有授权素材。
优化
- 按照构件方向与统一尺度展开木纹，区分陶瓷和铜器的表面反射。
- 电脑端请求高性能图形模式，手机继续使用低功耗档；统一财神室内外日光方向并减少均匀补光。
修复
- 修复部分桌裙及装饰面的无效纹理坐标，避免带贴图的模型仍显示为纯色。
验证
- 完整回归 153 项、类型检查、正式构建通过；电脑与手机资源预算通过。
- 已完成同机位 GPU 离线对比、工程重开与本地网页供案/庭院检查；安卓真机未验收。
- 本地测试环境天气服务未连通，使用默认光照，未将实时天气验收记为通过。
电子祠堂 0.8.0：财神精细模型更新
RELEASE-20260914-080新增
- 财神祠堂接入精细屋顶、苹果、花束、柑橘及回廊梁柱。
优化
- 细化灯笼、供案、神龛与门窗；分区加载、两档资源预算和失败回退同步更新。
修复
- 修正柱础与地坪接合，保留天气驱动光照及现有献礼交互。
验证
- 152 项完整回归、类型检查、本地及云端正式构建通过。
- 云端数据库副本通过迁移、二十馆业务、隐私、积分、权限及照片验收；切换前后核心数据摘要与配置一致。
- 公网首页、登录、后台、更新页面及实时天气正常；新模型与 APK 文件校验通过。
- 安卓真机覆盖安装、登录保持和三维帧率待验收。
财神柑橘与回廊梁柱精细替换
LOCAL-20260914-MANDARIN-COLONNADE新增
- 引入免费许可的中式亭阁柱础、柱头及梁枋，适配为连续回廊构件。
- 新增原创 Blender 柑橘模型，包含不规则果形、顶部凹陷、果蒂和果皮法线纹理。
优化
- 两档模型共享重复构件；保留回廊屋顶、地坪和原参观路线。
修复
- 柱础对齐回廊地坪；加载成功后整体替换，失败保留原构件。
验证
- 152 项完整回归、类型检查、正式构建通过；更新文档一致性检查通过。
- 本地网页已检查回廊、供案和自动开门；两档模型边界、资源预算与加载回退测试通过。
- 手机真机、指定三种视口宽度及本轮实际献礼操作未验收。
财神献花花束与花器细化
LOCAL-20260914-FLOWER-MODEL新增
- 原创 Blender 花束模型，增加弯曲花瓣、花蕊、尖叶、叶脉、花茎和带内壁的花器。
优化
- 提供电脑与手机两档，沿用原献礼位置、成功动画和减少动画表现。
修复
- 模型加载不改变献礼状态；仅成功献花后展示，失败保留原花束。
验证
- 149 项完整回归、类型检查及正式构建通过；包含真实模型显隐、边界、重复呈现、释放及校验值测试。
- 离线预览已检查；本轮网页实际献花动画与安卓真机仍待人工验收。
财神祠堂主体模型逐批迭代
LOCAL-20260914-SUBJECT-ITERATION新增
- 采用已核实CC0许可的完整灯笼模型，重新制作供桌和神龛主体。
优化
- 调整侧窗格扇、门板与回廊柱身结构、树干曲线及茶具与糕点轮廓。
- 共用灯笼几何，继续分区加载；保持桌面、红布、主像及献礼位置。
修复
- 仅在新主体完整加载后清理对应旧家具，保留地面、红布和人物图像；离开后恢复并释放资源。
验证
- 148 项回归、类型检查与正式构建通过；两档资源约18.79 MiB和9.30 MiB。
- 本地桌面检查主体替换；指定手机宽度、真机流畅度和全部角度穿模仍待验收。
财神祠堂室内外分区精细构件
LOCAL-20260914-ZONE-DETAILS新增
- 增加原创 Blender 灯笼、门前柱础与檐下构件、殿内连接及供案器物纹饰，分区加载并保留基础场景。
优化
- 灯笼共用模型，增加不规则树枝和叶片层次；改善暗部材质、柑橘与花瓣，保留天气驱动的光照。
- 压缩背景模型并保留原有光照贴图，新构件使用静态遮蔽烘焙。
修复
- 校正茶具、香炉与红布的接触高度，调整柑橘落盘位置。
- 资源预算检查改用网页实际加载的大殿和全部分区清单。
验证
- 147 项完整回归、类型检查及正式构建通过，包含分区重试、迟到释放、门洞净空、供案高度和两档资源预算。
- 已检查本地桌面庭院、殿前、殿中和供案；手机指定宽度、安卓真机帧率及全部角度穿模仍待验收。
- 实际资源清单合计电脑约18.88 MiB、手机约8.89 MiB；Blender 工程重开后四区构件与烘焙数据完整。
财神屋瓦与扫描供品接入本地网页
LOCAL-20260914-WEB-REFINEMENT新增
- 财神三维场景接入免费屋瓦、脊饰和扫描苹果，提供桌面与手机资源档位。
优化
- 调整庭院灯笼织物材质；保留原有参观、门、天气和献礼功能。
修复
- 补齐网页屋檐衬层；新模型加载失败时保留原物件，退出后释放迟到资源。
验证
- 143 项完整回归、类型检查、正式构建通过；包含模型校验、失败回退、迟到资源释放及资源预算检查。
- 本地浏览器检查庭院、闭门进入供案和收起重开；未进行安卓真机、手机布局及本轮实际献礼操作验收。
- 网页继续使用实时渲染，不等同于离线 Cycles 效果。
屋面与檐口接合修整样板
LOCAL-20260913-ROOF-JUNCTIONS新增
- 增加主屋面连续衬层及四组檐下支撑，提供近景前后对比。
优化
- 补充保存后重开复渲染检查。
修复
- 修整重开工程后显现的旧檐口与新屋面高度冲突。
验证
- 完成四张1920×1080 OptiX 对比图，两个前后机位一致。
- 重开后贴图完整，屋面复渲染平均像素差约0.00000011。
- 仅检查所列离线机位，未完成全角度空间及网页验收。
免费屋瓦与脊饰接入本地样板
LOCAL-20260913-FREE-ROOF新增
- 将免费建筑中的屋瓦与脊饰分离，提供庭院和屋顶两个机位的前后对比。
优化
- 调整屋面覆盖范围与高度，保留现有门洞、台阶、室内及扫描苹果。
修复
- 移除旧主屋面，调整外露顶板高度。
验证
- 完成四张1920×1080 OptiX 渲染，前后机位一致。
- 两份工程重开后贴图完整，确认新屋顶只有一份且旧屋面已移除。
- 门、台阶和苹果位置保持一致；尚未完成全角度穿模、瓦缝及网页性能验收。
供案扫描苹果与灯笼材质本地样板
LOCAL-20260913-FREE-ASSET-INTEGRATION新增
- 扫描苹果整合到供案，提供供案与灯笼同机位前后对比。
优化
- 灯笼增加细布纹、透光和内部暖光，调整检查机位以完整展示流苏。
验证
- RTX 5070 Ti OptiX 完成四张1920×1080图片，单张约9至13秒。
- 两份工程重开后贴图已打包，四枚扫描苹果数量正确，两组前后机位一致。
- 建筑素材尚未整合，网页与安卓性能未验证。
免费祠堂素材本地渲染比较
LOCAL-20260913-FREE-ASSET-STUDY新增
- 增加苹果、建筑、灯笼与麒麟的独立 Blender 选材小样、图片和许可说明。
优化
- 通过统一光照检查素材细节，校正灯笼与扫描模型的导入朝向。
验证
- 已使用 RTX 5070 Ti OptiX 输出五张本地图片，导入检查未发现缺失贴图。
- 苹果模型及贴图通过原站 MD5 校验；建筑与灯笼免费许可已通过官方接口核对。
- 灯笼和麒麟材质仍需调整；馆藏香炉下载需要账户认证，未取得文件。
- 尚未整合完整大殿或进行网页、手机性能验收。
财神祠堂本地高质量渲染样板
LOCAL-20260913-OPTIX-STUDY新增
- 独立 Blender 工程与庭院、殿门、供案三个固定机位的前后效果图。
- 提供本机渲染操作说明、可拖动的图片对比页面及素材来源清单。
优化
- 细化灯笼布面、骨架和流苏，增加瓦片搭接、枝叶与供品细节。
- 修正供案红布遮挡雕饰及瓦片被屋顶底层盖住的问题。
验证
- 已使用 RTX 5070 Ti 的 OptiX 进行实际预览及2560×1440离线渲染。
- 两份工程独立重开后未发现缺失贴图，三个对比机位一致。
- 这是独立场景样板，庭院为重建基线，并非网页逐物体精确导出；没有验证网页或安卓实时性能。
- 六张正式图已完成；固定机位复渲染像素差异极小，类型检查、正式构建和更新文档一致性检查通过。
主殿门窗与檐下建筑细节
LOCAL-20260913-FACADE-JOINERY新增
- 主殿增加立体窗框、下部木板线脚、双层石窗台、檐下椽头、柱脚和梁柱斜撑。
- 门扇增加木框、连续格栅和门环垫板，装饰随门轴转动。
优化
- 窗格采用木材质替换原来的金色细线，共享已有木石纹理并合并静态构件绘制。
验证
- 完整回归141项通过，覆盖静态构件门洞避让、门饰随轴转动和共享几何释放。
- 本地财神殿前及开门画面已检查；其他人物馆、手机尺寸和安卓真机尚未逐项验收。
- 本轮为连通场景共用立面的原创程序建模，不包含新的 Blender 烘焙或建筑实景复原。
- 类型检查、正式构建及更新文档一致性检查通过。
庭院雪花轻摆与边界保护
LOCAL-20260913-SNOW-DRIFT优化
- 雪花在下落时轻微横向飘动，各自节奏不同；靠近露天区域边缘时缩小摆动幅度。
- 减少动画时停止飘动，保持现有雨雪渐变和粒子数量。
验证
- 完整回归140项和类型检查通过，新增连续三分钟模拟降雪的边界及冻结检查。
- 未进行真实雪天浏览器画面或安卓真机验收；此轮不包含积雪、地面湿润或新增建筑模型。
- 正式构建及更新记录文档一致性检查通过。
雨雪天气平滑切换
LOCAL-20260913-PRECIPITATION-TRANSITION优化
- 降雨和降雪随天空逐渐出现或消退，快速切换从当前状态继续。
- 雨滴与雪花保持独立下落速度，减少动画时立即切换并停止粒子运动。
修复
- 清除天气时同步隐藏雨雪，避免旧效果残留。
验证
- 完整回归139项和类型检查通过，覆盖雨雪交叉过渡、反向切换、减少动画、清除和重复释放。
- 本轮未进行真实雨雪天气的浏览器画面和安卓真机验收。
- 正式构建和更新文档一致性检查通过。
天空与环境光平滑过渡
LOCAL-20260913-SKY-TRANSITION优化
- 天空颜色、云量、雾和环境光随天气平滑过渡，与庭院夜灯衔接。
- 快速切换从当前画面继续，减少动画时直接呈现目标；首次加载直接显示当前天气。
修复
- 离开场景后停止天气过渡，重复释放受到保护。
验证
- 完整回归138项、类型检查及正式构建通过。
- 本地财神庭院全屏显示与天气加载检查通过，已保存截图。
- 反向切换与减少动画通过自动测试；逐地区界面切换、指定手机尺寸及安卓真机尚未验收。
- 本轮不包含雨雪粒子之间的淡入淡出，也不代表新增建筑细节或全场景烘焙。
庭院灯光渐变与重开稳定性
LOCAL-20260913-LIGHT-TRANSITION优化
- 庭院夜灯逐渐亮起和熄灭，快速反向切换从当前亮度继续。
- 减少动画时直接切换；场景离开后停止更新，重复释放受到保护。
验证
- 完整回归137项通过，覆盖连续过渡、反向切换、减少动画和卸载后停止更新。
- 本地网页首次进入、收起重开及天气恢复检查通过。
- 快速切换与减少动画为自动测试；逐地区界面切换及安卓真机待验收。
- 类型检查、正式构建和更新文档一致性检查通过。
财神庭院昼夜灯光
LOCAL-20260913-COURTYARD-NIGHT新增
- 庭院灯笼与石灯根据天气昼夜状态呈现暖光，日间关闭额外照明。
优化
- 手机限制两盏局部照明，桌面四盏，不新增阴影贴图。
验证
- 完整回归136项通过，涵盖昼夜切换、灯数限制及释放。
- 本地网页夜间庭院全屏验收完成。
- 日间切换已做自动测试，未完成逐天气界面验收或安卓真机帧率测试。
- 类型检查、正式构建及更新文档一致性检查通过。
财神庭院构件与铺地细化
LOCAL-20260913-COURTYARD-DETAIL新增
- 庭院石板加入倒角和细微色差，补足石灯围板与灯笼吊点。
优化
- 柱础与石灯底部增加柔和接触暗部，保留天气实时阴影。
验证
- 完整回归135项通过，包含铺地高度、中轴避让及接触纹理释放检查。
- 本地网页庭院全屏检查完成；接触暗部为程序生成，不是完整庭院烘焙。
- 安卓真机、全部天气及全尺寸组合待验收。
- 类型检查、正式构建及更新文档一致性检查通过。
财神木质构件光照细化
LOCAL-20260913-WOOD-LIGHTMAP新增
- 梁架、神龛与供案所属木质构件加入独立间接光照贴图，保留原木纹。
优化
- 压缩模型表面朝向数据，保留现有几何细节并满足两档资源预算。
验证
- 完整回归134项通过，包含木构烘焙、独立坐标、光照不重复叠加及压缩方向精度检查。
- 本地网页殿中全屏检查正常，灯笼与红布显示正常。
- 本轮仍是财神静态样板；庭院、动态陈设和安卓真机待后续验收。
- 类型检查、正式构建和更新文档一致性检查通过。
财神墙地光照贴图样板
LOCAL-20260913-WALL-LIGHTMAP新增
- 大殿墙面与石材接入独立光照贴图：桌面2048、手机1024像素，表现固定室内灯光的间接反射。
优化
- 光照贴图降噪、压缩并复用原有资源释放流程，避免与顶点间接光重复叠加。
验证
- 完整回归134项通过；网页殿中全屏检查灯罩、红布及降噪后的墙面显示。
- 本轮仅覆盖墙面与石材，其余表面沿用原光照；安卓真机和全部天气逐项视觉检查待验收。
- 类型检查、正式构建与更新文档一致性检查通过。
财神大殿接入间接光烘焙
LOCAL-20260913-INDIRECT-LIGHT新增
- 静态大殿加入固定室内灯光的间接反射烘焙，配合网页实时光照。
优化
- 分别生成桌面与手机资源，烘焙数据控制在原场景体积预算内。
- 保留天气、门与献礼的实时交互，灯笼和供案红布修复继续生效。
验证
- 完整回归 132 项通过；本地网页殿中全屏检查通过。
- 本轮为顶点间接光烘焙，尚未完成高分辨率光照贴图、庭院及动态陈设烘焙；安卓真机待验收。
- 类型检查、正式构建与更新文档一致性检查通过。
修复供案红布穿模与灯笼布面缺失
LOCAL-20260913-FABRIC-FIX修复
- 供案红布连续包过桌沿，垂边避开正面雕花，修正布料颜色显示。
- 保留手机档完整灯罩布面，避免模型压缩后只剩灯笼框架；同步修正布面朝向并更新资源版本。
验证
- 完整回归 130 项通过，新增两档六盏灯笼布面保留检查和红布间距检查。
- 本地网页殿中全屏实测：灯罩完整显示，供案正面红布不再与雕花交错。
- 安卓真机未验收。
- 类型检查、正式构建与更新文档一致性检查通过。
财神近景构件品质样板
LOCAL-20260913-QUALITY-STUDY新增
- 财神样板增加原创 Blender 灯笼褶皱、束口、铜箍和垂穗，以及神龛侧板、层叠檐口、供案连接构件。
优化
- 桌面和手机分别导出，背景模型独立精简，保留原参观路线、门和献礼坐标。
验证
- 完整回归 129 项通过；类型检查与正式构建通过。已在本地网页检查场景加载和闭门进入供案。
- 财神场景资源桌面约 18.61 MiB、手机约 8.58 MiB；已生成同机位 Blender 渲染对比。
- 未新增完整全局光照烘焙，未验证安卓真机；渲染图不代表手机实际画质。
接入 WeatherAPI 免费天气与地区搜索
UPDATE-20260913-WEATHERAPI新增
- 新增 WeatherAPI.com 天气及地区搜索接入，复用已选地区与场景天气效果。
优化
- 同地区请求合并，天气缓存10分钟，地区结果缓存一天。
- 按实际天气来源显示署名，区分授权、免费额度、限频与连接异常。
修复
- 未知天气数据不误显示为晴天，雷雪天气保留降雪效果。
验证
- 完整回归127项、类型检查、正式构建与文档一致性通过。
- 服务器真实天气验证通过；公网北京、泰安天气与北京、泉州中文搜索返回正常。
- 安卓真机和逐尺寸场景动画待验收。
天气配置接入与异常提示修复
FIX-20260913-WEATHER优化
- 区分天气未启用、授权异常、服务繁忙与暂时连接失败；保留默认天空。
修复
- 补齐云端天气配置传入，修复收起地区菜单后只显示笼统“天气未更新”的问题。
验证
- 完整回归125项、类型检查、正式构建与文档一致性通过。
- 生产接口缺失配置、授权异常及限频已用模拟上游验证；尚无生产密钥，真实天气未恢复，安卓真机待验收。
电子祠堂 0.7.0：精细场景与纪念照片
RELEASE-20260913-070新增
- 自建祠堂支持照片上传、分别裁剪封面和殿内主像，复用已保存的人物照片。
- 各人物馆和自建祠堂接入精细三维建筑、室内外连通路线与开关门。
优化
- 完善供案、香花、庭院及建筑细节，更新传统人物供奉场所实拍。
- 香火入口与订单支付区域完善；未配置收款码时不开放收款。
验证
- 完整回归124项、类型检查、正式构建及更新文档一致性检查通过。
- 云端 PostgreSQL 副本迁移及20馆献礼、收藏、隐私、积分和照片存取裁剪验证通过；正式切换前后既有核心资料与配置一致。
- 公网首页、登录、后台、更新页面、两档三维模型及安装包下载校验通过；APK包名、版本和原签名一致。
- 实时天气尚需配置生产服务；真实收款未开启。安卓真机覆盖安装、照片选择与三维流畅度待验收。
自建祠堂照片上传、裁剪与人物照片复用
LOCAL-20260913-MEMORIAL-PHOTOS新增
- 建立祠堂可上传照片、选择该人物已保存照片或保留姓名牌位。
- 封面与殿内照片分别调整位置和放大裁剪，三维预览同步显示。
- 已有祠堂增加设置纪念照片入口，支持换图及恢复姓名牌位。
优化
- 建立或保存成功后才存储照片，取消不保存；照片按家族及人物隐私权限读取。
修复
- 失败保留输入，相同提交重试不重复保存；照片修改冲突提示刷新后重试。
验证
- 完整回归124项、类型检查、正式构建和更新文档一致性检查通过；覆盖照片存取、复用、越权、损坏文件、裁剪边界及幂等。
- 浏览器检查手机照片来源切换、空状态、未选照片时禁止提交。
- 实际文件选择器上传、裁剪后3D画面和安卓真机待人工验收；PostgreSQL实库未验证。
传统人物造像核对与供奉照片统一
LOCAL-20260913-PORTRAIT-AUDIT新增
- 补充文殊、弥勒、文昌帝君及寿星的正式供奉场所造像实拍。
优化
- 九个人物馆统一卡片、详情与三维主像，优先展示供奉场所的正面造像。
- 关公改用丰原慈济宫正面神龛照片，妈祖改用天后宫主坛照片。
修复
- 修正实拍已更新但主图仍使用绘画或博物馆藏品的问题。
- 补充土地公照片地点；文曲星候选存在称谓混用，继续明确标为文化配图。
验证
- 完整回归122项、类型检查与正式构建通过；图片校验值、来源对应与两档模型资源预算通过。
- 人工核对人物图像及候选照片，浏览器检查关公手机实拍、弥勒桌面主图与来源说明。
- 现有19馆有供奉照片，文曲星待补充；部分保留照片角度及清晰度仍可改善，未逐馆验收全部三维视点或安卓真机。
自建电子祠堂接入精细庭院与大殿
LOCAL-20260913-FAMILY-DETAILED-HALL优化
- 自建祠堂和建立页面的三维预览统一使用精细庭院、大殿、供案与可开关殿门。
- 保留岱庙意境配色、人物姓名牌位及五站参观路线。
修复
- 修复自建祠堂仍加载旧版简化庭院的问题；原有三维开关继续生效。
验证
- 完整回归121项、类型检查、正式构建通过；模型测试覆盖自建祠堂两档构建与资源释放。
- 浏览器检查1440px新建预览、自动开门进入供案及390px参观控件；未提交新建资料。
- 现有验收祠堂未开启三维，未更改其开关；已有启用实例及安卓真机待人工验收。
全人物馆精细大殿与供奉场所实拍
LOCAL-20260913-ALL-DETAILED-HALLS新增
- 20个人物馆统一接入精细大殿和庭院细节，保留各馆名称、主像与主题配色。
- 观音实拍改为吉隆坡天后宫殿内供奉场景，主像采用同源照片局部。
优化
- 共用桌面与手机模型资源，保持原有门、参观路线、天气与献礼操作。
- 实拍按正式供奉场所筛选；缺少合格素材的馆明确提示待补充。
修复
- 撤下博物馆藏品及供奉场所未核实的实拍，避免将独立摆件作为庙内参观场景。
验证
- 完整回归121项、类型检查和正式构建通过；20馆两档资源均在预算内。
- 浏览器检查观音桌面精细大殿、供奉实拍及妈祖手机大殿。
- 当前15馆有合格实拍，5馆待补充；逐馆完整人工验收和安卓真机帧率待验证。
香火付款码预留与订单核验流程
LOCAL-20260913-PAYMENT-REVIEW新增
- 付款页面预留收款码展示位置，清晰展示订单金额、编号和付款步骤。
- 增加付款待核验状态，后台支持说明、通过或退回，个人中心可继续处理订单。
优化
- 香火按钮移动到献花右侧，实拍与三维场景保持一致。
- 手机付款弹窗内容独立滚动、操作按钮持续可见；待核验订单定期刷新。
修复
- 重复提交和并发核验不重复确认付款，同一流水号不能用于确认多笔订单。
- 未配置付款码时关闭真实付款，保留明确标注的本地流程演练。
验证
- 完整回归120项、类型检查和正式构建通过。
- 浏览器验证创建订单、提交核验及个人中心持久状态；检查1440与390宽度付款布局。
- 后台流程通过隔离接口测试；完整后台人工点击、真实扫码、PostgreSQL迁移及安卓真机待验收。
3D祠堂地区天气与天空动画
LOCAL-20260913-REGIONAL-WEATHER新增
- 3D场景右上角新增地区搜索，记住选择并定期同步当地天气。
- 晴、阴、雨、雪、雾与昼夜变化联动天空和自然光；庭院新增雨雪效果。
优化
- 天气变化保留当前参观位置；减少动画时停止云层与雨雪运动。
- 天气读取失败提供重试，保留同地区已加载内容；支持恢复默认场景。
修复
- 部分中文城市简称自动尝试城市全名；切换地区取消旧请求。
验证
- 完整回归116项、类型检查和正式构建通过。
- 浏览器核实晴天与雨天真实数据联动、室内遮雨；检查1440、1024、390宽度菜单与键盘返回焦点。
- 雪天和减少动画通过程序测试；真实降雪画面、长时间刷新及安卓真机流畅度待验收。
室内外灯具、石灯与植物近景细化
LOCAL-20260913-CRAFTED-FIXTURES新增
- 室外灯笼新增骨架、织物纹理、口圈、吊绳、结饰和流苏，改在回廊檐下悬挂。
- 室内 Blender 灯具增加织物灯罩、分层口圈与独立流苏，补充供案和神龛收边。
优化
- 树冠改用薄叶片；石灯柱身与盖顶改为有转折的结构。
修复
- 清理原有椭球灯罩和重复吊线、垂饰。
验证
- 完整回归113项通过，重新导出后的模型与庭院专项5项通过。
- 本地检查室外灯笼、石灯、薄叶树冠；真机性能和完整全局光照未验收。
- 类型检查、正式构建和更新记录检查通过；检查1440与390宽度显示及收起重开。
财神庭院材质、绿化与建筑投影优化
LOCAL-20260913-COURTYARD-REALISM新增
- 庭院增加分层树叶、花池边石、石灯、回廊栏杆、墙脚砌石与入口檐下构件。
- 新增覆盖庭院的日光投影，使室外建筑与地面有更清楚的光影关系。
优化
- 庭院木石材质复用已核实的贴图，调整屋顶与墙面配色；保留中轴通行和室内献礼位置。
修复
- 移除简单锥形树冠和背景锥体，避免与新庭院植被重复。
- 修复换材质后屋面背面被剔除的问题，清理重复树干。
验证
- 最终完整回归113项、类型检查和正式构建通过。
- 本地浏览器检查1440与390宽度的场景加载、庭院视点与收起重开，手机页面无横向溢出。
- 安卓真机帧率与完整全局光照仍待验收。
财神大殿材质、阴影与两侧陈设细化
LOCAL-20260913-HALL-DETAILS新增
- 两侧花器、辅助柜与拜垫，保留中轴通道及原有献礼位置。
- 梁柱曲线撑木、供桌叶形浮雕及铜器粗糙度细节。
优化
- 补齐木石法线和粗糙度贴图，加入 Blender 烘焙的静态遮蔽阴影。
- 手机模型减面并缩小纹理，保持现有资源预算。
验证
- 完整回归112项通过，包含陈设避让、烘焙数据、法线贴图和模型资源检查。
- 当前为静态AO烘焙，尚未完成完整全局光照烘焙；安卓真机帧率待验收。
- 类型检查、正式构建和文档一致性检查通过；本地检查1440与390宽度的加载、收起重开和室内路线。
财神馆接入 Blender 精细大殿样板
LOCAL-20260913-BLENDER-HALL新增
- 使用 Blender 制作带倒角石地面、曲线斗拱、厚格扇和浮雕供案的大殿，先在财神馆提供体验。
- 保留可编辑工程和建筑渲染预览，导出桌面与手机两档模型。
优化
- 保留原有庭院开门路线、人物图像、供品和香花动作；新模型完整加载后再替换旧建筑。
修复
- 模型加载失败时保留旧建筑，离开后释放迟到的资源，避免重新挂入已关闭场景。
验证
- 完整回归111项通过；全项目类型检查通过。
- 本地查看网页室内模型、供案和主像；检查1440与390宽度、收起重开。
- 安卓真机帧率未验收，当前仅财神馆使用新模型；静态渲染与网页实时画面存在差异。
- 更新文档一致性检查与正式构建通过。
补充关公等四馆造像实拍
LOCAL-20260913-STATUE-PHOTOS新增
- 关公、月老、灶神、玄天上帝新增身份及许可明确的庙内造像实拍，实拍覆盖增至19馆。
优化
- 月老卡片和神龛换用题名明确的新造像照片；实拍保留放大、全屏和香花操作。
- 补充摄影作者、拍摄日期、地点、许可及本地素材校验清单。
修复
- 造像照片的加载和操作提示不再统一称作大殿照片，避免误导。
验证
- 完整回归108项通过；新增四张照片逐张查看。
- 本地检查关公实拍打开、缩放、键盘复位与全屏；390像素页面无横向溢出。
- 文曲星素材仍待补充；尚未核实合适的免费360°全景。安卓真机与离线失败注入未重测。
- 更新记录一致性检查、全项目类型检查及正式构建通过。
敬香与献花按钮居中
LOCAL-20260913-OFFERING-BUTTONS优化
- 实拍和3D场景共用的敬香、献花按钮组居中排列，手机保留等宽触控按钮。
验证
- 本地浏览器检查1440与390像素宽度：按钮组居中，按钮高度44像素，页面无横向溢出。
- 仅调整样式；献礼和积分逻辑未改动。
全人物祠堂室内外连通与实拍入口
LOCAL-20260913-CONNECTED-SHRINES新增
- 20个人物馆统一实拍与3D场景入口；15馆配置实拍，缺少合格素材的馆明确提示待补充。
- 庭院与精细大殿连接为同一空间，增加五处参观位置、双扇门和自动开门通行。
优化
- 各馆使用自己的名称、主题与主像，补充门环、门轴、格扇、匾额和材质；保留供案贡品与原有香花动作。
- 合并静态构件和共享材质；切换室内外不重建场景，沿安全中轴路线进出。
修复
- 身份未核实的月老旧照片停用于主像与实拍；文化配图和绘画不标作实拍。
- 实拍与三维切换、跨人物切换不新增献礼记录。
验证
- 108项完整回归、类型检查与正式构建通过，覆盖全部人物两档模型、路线与资源释放。
- 本地浏览器检查390、1024、1440像素布局，实测开关门、双向参观、实拍切换、隔离献礼与积分更新。
- 安卓真机帧率、系统减少动画设置、浏览器网络与模型失败注入未实测；并非逐馆逐尺寸覆盖全部交互组合。
财神供案贡品与香花细节
LOCAL-20260913-CAISHEN-ALTAR新增
- 供案加入苹果、柑橘果盘、三只茶盏与糕点，常驻陈设不产生记录或积分。
- 香炉增加内壁和香灰，敬香成功后只在同一炉内插香；香支区分竹芯、香体、灰端与余烬。
优化
- 细化花瓣、花蕊、叶片、花茎和花器，以有限时长轻烟取代球形烟团；保留操作区原有香花图像与动作。
- 桌面改为木纹、金属仅局部点缀，补充桌布垂坠、贡品接触阴影，降低过亮光照。
修复
- 贡品与香花使用独立摆放位置；重复成功反馈不堆积模型，减少动画时停止烟雾漂移。
验证
- 105项回归、类型检查和正式构建通过，覆盖两档供案模型、常驻与成功状态分离、重复调用、减少动画、有限坐标及资源释放。
- 本地浏览器验证敬香加1、献花加2、同炉插香、场景切换、收起重开及390/1024/1440像素布局；截图已保存。
- 安卓真机帧率、浏览器系统减少动画设置和献礼网络失败界面本轮未实测；相关自动回归通过。
财神精细大殿样板
LOCAL-20260913-CAISHEN-HALL新增
- 财神默认进入独立三维大殿，保留原有庭院入口；增加殿门、殿中与供案三个参观位置。
- 完善立体神龛、供桌、铜香炉、格扇、柱础、藻井与灯具；赵公明主体采用授权图像并明确说明。
优化
- 使用本地木石材质、铜器微凹凸与粗糙度、环境反光和殿内暖光，提供手机与桌面两档资源。
- 敬香献花保留原有图像和动画，成功后呈现在新供案；场景资源失败可重试，献礼操作仍可使用。
修复
- 新旧场景切换使用各自视点与献礼位置，防止旧坐标错位及视点索引越界。
验证
- 103项回归、类型检查和正式构建通过，覆盖场景坐标、素材预算与校验、模型资源释放、材质失败和延迟加载。
- 浏览器验证敬香加1、献花加2、场景切换、全屏、键盘、收起重开，以及390、1024、1440像素布局；实测贴图缺失与恢复重试。
- 安卓真机帧率、浏览器减少动画设置及献礼网络失败界面本轮未实测；相关既有自动测试通过。
细化祠堂建筑与殿内装饰
LOCAL-20260913-SHRINE-DETAIL新增
- 主殿增加分层斗拱、彩绘梁枋、格栅窗、顶部装饰、神龛边框和供台纹饰。
- 增加柱础、石栏杆、殿内铺地、木墙板与细微木纹。
优化
- 加密屋顶瓦垄，使用瓦色表现，保留各馆配色和自建祠堂风格。
- 重复装饰构件合并绘制，参观关闭时释放几何、材质与纹理。
验证
- 100项回归、类型检查和正式构建通过；覆盖各馆模型生成、实例坐标与资源释放。
- 浏览器检查财神殿前画面、全屏参观和390像素宽度殿内切换，无页面横向溢出。
- 真机帧率未测试；仍为原创风格化建筑模型，非实地扫描。
创建电子祠堂时选择三维参观
LOCAL-20260913-MEMORIAL-3D-OPTION新增
- 创建弹窗增加“是否建立 3D 祠堂”滑块，默认关闭，开启后可预览并保存三维庭院。
优化
- 普通祠堂保留献花、点烛和留言，仅开启三维选项的祠堂显示参观入口。已有祠堂默认使用普通展示。
修复
- 移除自建祠堂中的岱庙建筑介绍链接。
验证
- 100项回归测试通过，覆盖三维选择保存、默认关闭、参数与权限校验。
- 浏览器验证开关、三维预览、取消及键盘空格切换；390像素宽度未见页面横向溢出。手机真机未验收。
保留场景祈福区的香花图像与动画
LOCAL-20260913-RESTORE-OFFERING-ART优化
- 实拍和建模中的祈福区恢复原有香炉与花束常驻图像，献礼成功后播放原有敬香、烟雾、花开和心意提示动画。
修复
- 修正整理祈福操作后原有香花图像不再常驻显示的问题，继续沿用减少动态效果设置。
验证
- 复用原有香花组件与服务端成功状态，不新增献礼请求或积分逻辑；构建与界面检查结果见本轮交付。
简介后进入场景，统一祈福操作
LOCAL-20260913-SCENE-RITUAL-LAYOUT优化
- 将实拍与建模区域放到人物简介下方，阅读后即可进入场景祈福。
- 敬香、献花、香火入口、匿名公开选择、积分及提交反馈统一放入场景，移除页面重复的独立祈福区。
修复
- 撤回公开记录的结果与错误保留在记录旁，收起场景后仍可查看。
验证
- 99项回归测试通过；浏览器确认简介在场景之前，展开实拍只有一组敬香献花按钮，香火弹窗可打开关闭。
- 手机真机及故障重试界面本轮未复验。
移除妈祖庭院全景，保留建模参观
LOCAL-20260913-REMOVE-COURTYARD-PANORAMA优化
- 妈祖馆保留大殿实拍，将“庭院与模型”入口简化为“建模”。
修复
- 移除不符合需求的庭院360°实景入口、图片及加载逻辑，建模入口直接进入三维庭院。
验证
- 类型检查通过；保留场景献礼、模型视角操作和大殿实拍功能。
妈祖大殿实拍与主像查看
LOCAL-20260913-HALL-PHOTO新增
- 妈祖馆默认进入天后宫大殿正面实拍，清晰展示主像与供案；注明摄影者、日期、来源及共享许可。
优化
- 支持放大主像、照片内滚动、恢复完整大殿与全屏查看，明确标注实拍照片非360°全景。
- 献礼沿用原有记录和积分，成功后恢复完整照片并在画面下方播放对应香花动画；庭院全景和模型保留为次级入口。
修复
- 调整默认参观内容，避免用庭院景色代替面对主像的大殿体验。
验证
- 99项回归通过；本地浏览器实测大殿加载、放大与恢复、敬香保存及加1分。
- 390与1024宽度检查未见正文横向溢出，手机宽度主像完整、献礼按钮可达；手机真机和照片加载失败重试仍待验收。
妈祖实景参观与场景献礼
LOCAL-20260913-PANORAMA-OFFERINGS新增
- 妈祖馆加入可免费复用的吉隆坡天后宫庭院360°实景，标明真实地点、拍摄年份、摄影者和许可。
- 人物祈福场景内可直接敬香、献花，确认成功后呈现香炉与花束，并同步个人记录和祈福值。
优化
- 支持实景与三维庭院切换、全屏与键盘环顾；实景为固定位置环顾，未覆盖馆继续提供意境模型。
- 场景献礼与原页面共用公开选择、提交状态和重试逻辑，场景切换不会重复献礼或加分。
- 优化手机献礼按钮与全屏滚动，支持减少动态效果及实景加载失败后重试或切换模型。
修复
- 连续献礼时让已摆放的香花回到稳定位置，结束参观释放场景资源并恢复入口焦点。
验证
- 99项回归和类型检查通过，包含祈福幂等、权限、积分及场景几何、资源释放、实景文件校验。
- 隔离资料实测实景加载、敬香加1、献花加2、个人记录、模型殿内献礼、场景切换、全屏和键盘操作；390、1024、1440宽度未见正文横向溢出，关闭后画布释放且焦点恢复。
- 手机真机、多指手势、图片超时及图形故障恢复尚待验收；实景仅覆盖妈祖馆的一处庭院，不代表景点线下代行。
走进电子祠堂 · 三维庭院参观
LOCAL-20260913-SHRINE-3D-TOUR新增
- 人物电子祠堂增加三维庭院参观，自建家族祠堂采用岱庙意境模板。
- 支持山门、庭院、殿前、殿内切换，拖动环顾、缩放、自动环视、键盘和全屏。
优化
- 按人物文化主题区分庭院、殿堂与陈设，沿用有来源的图像并提供建筑参考说明。
- 按需加载三维资源，结束参观后释放资源；无法显示三维时保留其他页面功能。
修复
- 调整主殿开间，避免正中立柱遮挡人物图像。
验证
- 97项回归、类型检查、正式构建和更新文档一致性检查通过，包含三维几何有效性和资源释放检查。
- 浏览器实测妈祖和地藏庭院、殿内、全屏、自动环视、关闭与焦点恢复，自建祠堂姓名牌与键盘返回；390、1024、1440宽度未见正文横向溢出。
- 手机真机、多指手势及图形故障恢复尚待验收；三维场景为意境建模，非实地复原或摄像头AR。
电子祠堂品牌同步 · Android 0.6.0
RELEASE-0.6.0优化
- 网页、后台及 Android 应用名称统一为“电子祠堂”。
- 家族追思和传统祈福人物页面统一使用电子祠堂名称，专属页面显示为“人物名 + 电子祠堂”。
- Android 更新至0.6.0，保留原包名、签名、云端地址和登录存储，可覆盖旧版安装。
修复
- 同步应用标签、导出文件名、下载入口、权限提示和服务错误提示中的旧名称。
验证
- 本地96项完整回归、类型检查、正式构建和电子祠堂页面验收已通过。
- Android 0.6.0 的版本、包名、应用名称、v2/v3签名及证书一致性检查通过；公网安装包校验值与本地一致。
- 云端数据库副本迁移及二十馆、收藏、献礼、隐私、祈福值、后台权限验收通过；公网页面可访问，既有核心数据与配置摘要保持一致。
- 当前没有可用安卓设备，真机覆盖安装、登录保持、返回键和文件导入导出待验收。
平台统一更名为电子祠堂
LOCAL-20260912-ELECTRONIC-SHRINE-RENAME优化
- 平台品牌、登录页、家族空间、总管理后台和更新页面统一使用“电子祠堂”名称。
- 家族追思与传统祈福人物页面统一使用“电子祠堂”，专属页面显示为“人物名 + 电子祠堂”。
- 同步调整建立、返回、收藏、订单和权限提示中的相关名称，保留现有网址、接口及数据结构兼容性。
修复
- 清理当前界面中“承谱”“线上纪念馆”“祈福纪念馆”等新旧名称混用。
验证
- 96项完整回归、类型检查、正式构建及更新记录一致性检查通过。
- 浏览器实测登录页、20座电子祠堂列表、地藏菩萨专属电子祠堂、家族追思页、后台无权限页及更新记录页面，名称与入口显示正确。
- 本地数据库成功读取原有献礼、祈福值、收藏和订单入口；未部署服务器或重新打包 Android。
祈福纪念馆与献礼动画 · Android 0.5.0
RELEASE-0.5.0新增
- 二十座祈福纪念馆、人物图文、匿名动态、祈福值与个人收藏。
- 敬香增加香头亮起与袅袅烟气，献花增加花束呈上与花朵展开；成功后播放，支持减少动态效果。
- 新增个人中心及订单管理界面；香火真实付款尚未接入，云端不开放下单。
优化
- 新增馆图文、配图许可及手机布局同步更新，App 下载入口更新至0.5.0。
修复
- 连续成功献礼可重新播放动画，页面切换时清理旧动画计时。
验证
- 本地96项完整回归、类型检查、正式构建和更新记录一致性检查通过。
- 浏览器验证敬香与献花成功动画及390px布局；减少动态效果已实现，系统偏好切换尚未实测。
- 云端独立数据库副本验证二十馆、收藏、献礼积分、公开及撤回、权限保护和禁止模拟下单。
- 公网页面、人物图片和安装包下载检查通过；既有核心数据及配置校验一致。
- Android版本、包名、签名及公网安装包校验通过，与0.4.0签名一致；真机覆盖安装、登录保持和返回键待验收。
补齐十四座纪念馆人物图片
LOCAL-20260912-SANCTUARY-PHOTOS新增
- 后续新增的十四座馆补齐对应人物的绘画或造像照片，主图和缩略图随项目保存。
- 每张图片记录作者、来源、许可及校验值；三官采用三位同框造像，弥勒注明布袋和尚化身形象。
优化
- 更新人物配图说明，移除旧的印章占位介绍；保留图片加载失败时的文字印章。
- 按比例优化图片，不额外裁切主体，卡片和专属馆同步显示。
验证
- 已逐张检查十四张人物图片；类型检查通过。
- 浏览器验证地藏主图、卡片缩略图与许可展开，390、1024、1440宽度无横向溢出。
- 96项完整回归、类型检查、正式构建及更新记录一致性检查通过；未进行服务器或 Android 真机验收。
祈福纪念馆扩充至二十座
LOCAL-20260912-SANCTUARY-TWENTY新增
- 新增神农、保生大帝、玄天上帝、三官大帝、文殊菩萨、普贤菩萨、地藏菩萨与弥勒八座馆。
- 新增丰收与静心分类，补充各馆文化介绍、别称搜索、参考来源和原创文化印章配图。
优化
- 所有新增馆均支持免费献礼、祈福值、公开记录、收藏、线上和代行模拟订单。
修复
- 完善目录迁移的重复执行保护，避免已有新馆记录时旧约束阻止服务重启。
验证
- 96项完整回归通过，包含新增馆记录与订单、二十馆图文完整性及带数据重复迁移检查。
- 浏览器验证二十馆列表、丰收与静心筛选、神农馆献花；390、1024、1440宽度无横向溢出。
- 类型检查、正式构建与更新记录一致性检查通过；未进行独立 PostgreSQL、服务器或 Android 真机验收。
新增六座传统祈福纪念馆
LOCAL-20260912-SANCTUARY-EXPANSION新增
- 新增土地公、灶神、寿星、文昌帝君、魁星、城隍，纪念馆扩充至十二座。
- 新增家宅、敬老分类与人物别称搜索；每馆补充文化介绍、参考来源和明确标注的原创印章配图。
优化
- 新馆完整沿用献香、献花、祈福值、匿名动态、个人收藏及香火订单；文昌、文曲、魁星分别保存记录。
- 扩充数据库可用目录，保留原有献礼与收藏；香火付款继续为本地模拟。
验证
- 96项完整回归通过，包含六座新馆献礼、收藏、公开记录、积分及线上与代行订单。
- 浏览器验证别称搜索、家宅和敬老筛选、收藏、献香与手机香火弹窗；390、1024、1440宽度无横向溢出。
- 类型检查、正式构建与更新记录一致性检查通过。未进行独立 PostgreSQL、服务器或 Android 真机验收。
香火项目、个人订单与代行处理
LOCAL-20260912-SANCTUARY-ORDERS新增
- 专属纪念馆新增香火入口，提供线上与代行项目、确认付款及订单进度。
- 个人中心集中管理订单和收藏，支持订单筛选、继续付款和取消待付款订单。
- 总管理后台新增祈福订单，支持代行受理、执行说明及完成记录。
优化
- 原有免费上香和献花保留；香火项目为暂定测试价格，不额外增加祈福值。
- 订单金额由服务端确定，重复提交及付款保护避免重复处理；手机弹窗按钮纵向排列。
修复
- 修正空收藏的浏览入口，并确保同次付款的进度按业务顺序展示。
验证
- 95项完整本地回归通过，覆盖价格、权限、幂等、并发、取消和代行状态冲突；类型检查、正式构建与更新记录一致性检查通过。
- 浏览器验证线上与代行模拟付款、取消、订单刷新和个人收藏；390、1024、1440宽度订单页面无横向溢出，手机弹窗按钮可达、Escape关闭后焦点返回。
- 后台订单处理已通过接口测试，尚未完成后台页面逐项验收；未验收真实支付、独立 PostgreSQL 或 Android 真机。
祈福人物图文、匿名动态与心意累计
LOCAL-20260912-SANCTUARY-COMMUNITY新增
- 六座祈福纪念馆新增授权图片、人物背景和来源说明，区分历史、传说与文化配图。
- 新增全平台匿名祈福动态，每馆只展示最近10条；献礼默认私密，可主动公开并撤回。
- 新增个人总祈福值及各馆累计：上香加1点、献花加2点，历史献礼同样计入。
- 支持跨家族收藏纪念馆，并组合使用分类、关键词及我的收藏筛选。
优化
- 公开记录不展示账号或家族身份，撤回不扣减积分；我的公开筛选支持找到较早的公开献礼。
- 统一跨家族献礼限频与幂等保护，增加加载重试、图片失败回退及移动端图文布局。
验证
- 88项完整本地回归通过，覆盖迁移、积分、匿名动态、撤回、收藏、跨家族限频与幂等。
- 浏览器验证收藏筛选、公开献礼、撤回、积分增量、刷新保留、缺图回退及键盘访问。
- 390、1024、1440宽度检查无横向溢出；类型检查、正式构建和更新记录一致性检查通过。
- 未进行本轮服务器发布、独立 PostgreSQL 或 Android 真机验收。
祈福纪念馆与个人心意记录
LOCAL-20260912-SANCTUARIES新增
- 线上纪念馆新增“查看其他纪念馆”入口，提供财神、妈祖、文曲星、观音、关公和月老专属页面。
- 支持按人物名称、别称及心愿关键词搜索，免费上香、献花并查看自己的近期记录。
优化
- 成功献礼提供动画与文字反馈，支持减少动画偏好，适配窄屏和键盘访问。
- 祈福记录持久保存，按账号和家族空间隔离；失败支持重试，并防止重复提交。
验证
- 82 项完整回归通过，包含祈福保存、幂等冲突、频率限制、权限隔离及图谱版本不变检查。
- 本地浏览器完成入口、关键词搜索、空结果、上香、献花、刷新保留记录及键盘访问检查。
- 390、1024、1440 宽度检查页面无横向溢出；尚未进行 Android 真机验收。
- 类型检查、正式构建及更新记录一致性检查通过。
图片识别与 Android 0.4.0
RELEASE-0.4.0新增
- 图片识别导入已发布至网页与 App，支持逐张重试、对照校正及来源追溯。
优化
- Android 0.4.0 支持按上传类型选择文件与多图选择，下载入口更新至新版安装包。
- 云端页面明确提示图片上传至家谱服务器处理，不调用第三方识图平台。
验证
- 79 项完整回归、类型检查与正式构建通过。
- 云端 PostgreSQL 副本通过真实识别、校对入库、关系与来源接口验收；重启后图片保留。
- 公网首页、后台、更新页和新版 APK 可访问；下载安装包校验一致，既有核心数据与密钥保持不变。
- 新旧安装包签名一致；未连接安卓真机，覆盖安装与系统文件选择仍待真机验收。
本地图片识别与导入校对
LOCAL-20260911-OCR新增
- 支持 JPG、PNG、WebP 名册图片在本机识别，提供任务进度、逐张重试和取消。
- 增加图片与表格对照、列对应调整、低置信度提示及逐行来源定位。
- 识别结果经校对审核后录入人物与关系，人物来源保留图片编号与对应原文。
优化
- 刷新页面后可重新打开识别任务；识别失败保留成功结果，重复提交避免重复生成记录。
- 图片通过家族权限读取，识别过程不向外部上传图片。
修复
- 修复图片任务入口的请求地址与重复组件标识问题。
- 无编号图片不生成用于匹配亲属的虚构编号，避免没有来源依据的连线。
验证
- 79 项完整回归通过，包含真实本地模型识别及单独标注的故障模拟。
- 浏览器通过多图上传、失败重试、对照校正、错误保留输入和确认录入检查；1440、1024、390px 页面无意外横向溢出。
- 类型检查、正式构建与更新文档一致性检查通过；未进行真机或云端验收。
图谱分支展开与收起动画
WEB-20260911-TREE-MOTION新增
- 人物分支展开和收起增加平滑位移、节点淡入淡出及连线过渡。
优化
- 固定被点击人物的位置，保留当前缩放与拖动状态，连续操作从当前画面继续。
- 遵循系统减少动态效果偏好；图谱关系和最终布局规则保持不变。
修复
- 消除展开或收起时整张画布重建导致的瞬间跳变。
验证
- 76 项回归测试、类型检查通过。
- 浏览器确认展开与收起存在中间动画帧，被点击人物位置保持不变，连续反向操作正常，连线在过渡期间保持显示。
网站新增 App 悬浮下载入口
WEB-20260911-APP-DOWNLOAD新增
- 网站右下角新增 App 悬浮球，点击展开 Android 0.3.0 下载按钮。
优化
- 支持点击空白处、关闭按钮及 Escape 收起；打开弹窗、人物详情和手机菜单时避让。
- 已安装的承谱 App 内不重复显示下载入口。
验证
- 类型检查、正式构建和更新文档一致性检查通过。
- 桌面与手机尺寸检查通过；下载按钮、Escape 收起及焦点返回已验证。
网页与 Android 0.3.0 同步更新
RELEASE-0.3.0新增
- 关系直接修改、人物来源与修改记录、家史审核工作流和更新记录页面。
- 提供 Android 0.3.0 安装包，支持覆盖安装。
优化
- 统一清爽蓝灰界面，优化手机导航、人物详情、表格与弹窗操作。
修复
- 修复人物详情重复标识警告。
- 安装包构建在原签名密钥缺失时停止，避免产生无法覆盖安装的版本。
- 后台保存失败或版本冲突时，错误显示在当前编辑区并保留输入，支持取消刷新和重复提交保护。
- 长人物表单的保存失败提示固定在弹窗顶部，滚动后仍可见并保留输入。
验证
- 73 项隔离回归、类型检查与正式构建通过。
- 后台在桌面、平板和手机尺寸完成检查；隔离资料验证后台与人物保存成功、失败重试、版本冲突保留输入和弹窗键盘焦点循环。
- Android 版本和签名校验通过，与旧版签名一致；尚未进行真机覆盖安装验收。
- 数据库副本迁移、云端健康与公网页面检查通过；既有资料校验一致，公网 APK 与签名构建包校验值一致。
清爽蓝灰界面与更新记录
LOCAL-20260911-UI新增
- 新增更新记录页面，与项目更新文档使用同一份内容。
优化
- 统一字号、对比度、间距和操作尺寸。
- 整理图谱工具栏、人物详情、表格与弹窗，适配窄屏。
修复
- 修复人物详情中亲属关系和来源记录使用相同标识导致的重复键警告，保留所有人物与合法关系。
- 手机导航关闭后不再参与键盘导航；弹窗和手机抽屉支持焦点约束与返回。
验证
- 73 项本地隔离回归测试通过；类型检查与正式构建通过。
- 已检查桌面、平板和手机尺寸下的图谱、人物详情、导入、家史、更新页面及后台权限提示页。
- 后台账号管理内页及浏览器中的加载失败、保存失败和版本冲突场景尚未完成界面验收。
家史工作流与人物追溯（历史补录）
HISTORY-LOCAL新增
- 家史草稿、审核、发布、归档与版本记录。
- 亲子及伴侣关系直接修改，人物来源及修改记录。
优化
- 关系保存前预览修改内容，保护版本冲突与重复提交。
验证
- 此前已通过 73 项自动化回归；补录不代表本次重新发布。
安卓客户端与独立管理后台（历史补录）
HISTORY-CLOUD新增
- 安卓在线客户端和独立账号管理后台。
优化
- 客户端直接进入家谱，提供加载与断网重试体验。
验证
- 历史发布内容整理；未确认的实际更新日期不作推测。