v4.3 · 电子木鱼与五处风景

v4.3 · 电子木鱼与五处风景

应用版本 4.3.0，在现有锦鲤池、赶海、猫咪庭院、财源广进之外加入“电子木鱼”。沿用原程序的主题选择、窗口控制、鼠标穿透、音量和本机存档。

本次更新

• 电子木鱼支持手动与自动敲击；鼠标按下开始动作，接触时统一发声、计数与飘字。长按不重复，快速输入不积压声音，切主题或休眠后不补敲。
• “愿想”提供预设与自定义飘字；“静念”提供 5/15/25/45 分钟计时。工具栏移除独立“记录”面板，保留已有计数和存档。
• 八种独立材质、可独立选择的音色、四季窗景、日夜与灯火；重新调整禅房暖光、灯位、香烛、手串、连续香烟及木槌接触位置。
• 同步此前未发布的主题独立日夜、财神香炉锚点、猫咪道具收纳及草垫动作修改；猫咪庭院移除惊鹿、背景音乐和持续风声，保留互动音效与鸟鸣。
• 猫咪正常启动继续使用原画。三维模型、骨架、工具和 CC BY 3.0 归属随源码保留，仅 ?cat3d=pilot 或 ?cat3d=all 启用开发预览；三维外观与部分动作尚未通过视觉验收，未宣称已完成。

本次发行验证

• 625 项项目 Node 测试通过，0 失败、0 跳过，覆盖各主题模型、存档、计数、声音调度与动作等逻辑。
• 5 项 Electron 窗口策略测试通过。
• Vite 生产构建通过；已有大于 500 kB 的 chunk 警告仍存在。
• 本次命名修改已在浏览器打开“愿想”“静念”面板验证，UI 操作不额外计数；本机桌面已验证新入口及原有计数保持。

macOS arm64 原生模块、Electron 桌面包、ad-hoc 签名与 ZIP 完整性校验通过；asar 与 Info.plist 均为 4.3.0，24 张木鱼运行素材校验一致。结果见 发行验证清单。自动测试不等于全功能人工验收：本次未重新逐一验证原四主题全部玩法、多显示器、真实系统休眠/唤醒、长时间运行及每档完整专注时长。

下载与更新

使用 GitHub Release 中的 yutang-v4.3-mac-arm64.zip（Apple Silicon Mac），解压后打开“浮生锦鲤池.app”；SHA256SUMS.txt 提供下载校验。保留应用标识及原有存档目录，不清空用户数据。

桌面包为 macOS 本地 ad-hoc 签名，未通过 Apple Developer ID 签名或公证。Windows/Linux 桌面安装包未提供。源码可使用 pnpm install --frozen-lockfile、pnpm dev 启动；Mac 构建命令为 pnpm package:mac。

v4.2 · 水下鱼群与礁边轻浪

浮生 · 摸鱼桌面 v4.2

本次优化赶海主题，保留锦鲤池、猫咪庭院、财源广进及已有存档。

• 鱼在动态水面下呈现透水层次，保留花纹与颜色，连续尾摆更流畅。
• 礁石接缝改为贴岩湿边与断续细泡沫，去除方形白贴片和整圈描边。
• 无待拾取来信时，约 4–6 分钟活跃等待后出现漂流瓶；修复新礁石阻断旧航道导致不出现的问题。
• 暂停、切换和离线不累计来信；收藏、寄信及原有潮汐规则保留。

已通过 510 项自动化测试、5 项桌面策略检查、真实画面捕捉/拾信/重启验证，以及 macOS arm64 安装包四主题、桌面穿透和恢复控制验证。Retina 1600×900 测试场景约 59 FPS。

完整文件清单、验证记录和同状态前后对比：v4.2 说明。

下载

yutang-v4.2-mac-arm64.zip 适用于 Apple Silicon Mac，解压后打开“浮生锦鲤池.app”。使用相同应用标识，已有存档继续保留。SHA256SUMS.txt 提供文件校验值。

安装包为 ad-hoc 签名，尚未 Apple 公证。Windows / Linux 原生桌面功能不在此次发布范围。验收时一次外部天气请求失败，已有回退正常，本地场景资源无错误。

v4.1 · 舒缓海浪与猫咪动作修复

赶海礁石避障、舒缓海浪与猫咪动作修复。应用版本 4.1.0。

• 鱼按真实可见礁石绕行，检查完整鱼身与游动路径；旧存档中落在岩面的个体就近恢复，保留原有数量和奖励。
• 海面水纹持续舒缓起伏，近岸浪向岸推进；礁石、沙地和海底保持稳定，原潮汐周期及玩法不变。
• 猫咪上下石阶、木廊和爬架采用安全落点间的短暂渐隐渐显，解决站立贴图拉伸和平移问题。
• 背向行走补齐远侧前后腿，使用各款猫自己的原画脚掌和毛皮，四肢交替运动。
• 包含本地已完成的分层赶海美术升级；保留锦鲤池、赶海、猫咪庭院、财源广进四主题、现有 UI 和存档键。

验证：492 项单元测试、5 项桌面策略测试、生产构建、原生模块编译及实际 macOS arm64 发行包检查通过。三种潮位共 86400 次鱼身避岩检查无侵入；真实界面捕捉/存档重载及猫咪 5 条上下设施路线通过；四主题本地资源正常。桌面穿透和恢复控制已验证。

下载附件 yutang-v4.1-mac-arm64.zip，解压后打开「浮生锦鲤池.app」。此包适用于 Apple Silicon Mac，保持原有 ad-hoc 签名，尚未 Apple 公证。Windows / Linux 原生桌面支持不在本版本范围。

已知限制：动作仍是二维原画动画；本次测试中外部天气服务出现请求失败，程序继续使用现有回退。本地风景不依赖该服务。

性能短测（1600×900 / DPR 2 / 高画质）：赶海约 58 FPS，猫咪充分暖身后的同机对照约 55 → 58 FPS，未观察到本轮造成明显退化；并非所有设备稳定 60 FPS 的保证。

详细实现、验证与限制见仓库 docs/RELEASE-V4.1.md。

v4.0 · 摸鱼桌面：四处风景，财源广进

同一个桌面程序，切换锦鲤池、赶海、猫咪庭院与财源广进四个主题。此次版本包含完整源码、运行素材与原稿，保留既有存档键和桌面交互方式。

本次更新

• 新增「财源广进」：上香、供灯、供品与添茶、心愿牌、自由布置、静心和日夜变化。
• 小金蟾自主活动，支持投铜钱、拾取和送入聚宝盆；加入灯笼、流苏、微尘、薄云、香烟、灯火及轻柔配乐。
• 供桌摆件可长按左键拖动，支持缩放、收纳和撤销。
• 每块祈愿牌独立编辑、显示和保存；新增牌留白，旧存档保留文字及布局，修改一块不会改变其他牌。
• 财神背景使用 AI 扩图补齐窗口边缘，原画等比显示，保留人物、匾额及物件坐标。
• 猫咪庭院调整原画步态、场景互动与轻微风声，新增温馨轻缓配乐「晴窗小憩」。

下载与运行

• 下方 mac-arm64.zip 为 Apple Silicon Mac 桌面版，解压后打开应用。
• 应用名称和标识沿用「浮生锦鲤池」，内部可切换全部四个主题，避免改变已有桌面存档位置。
• 源码可使用 GitHub 自动提供的 Source code 压缩包；开发运行方法见仓库 README。

验证与已知限制

• 483 项自动检查通过（包含 5 项桌面策略检查），生产构建、macOS 打包与签名校验通过。
• 实际 Electron 验证四个主题加载，以及祈愿牌独立编辑、切换主题、关闭重启后的恢复。
• macOS 包为本地 ad-hoc 签名，未进行 Apple 公证；当前提供 Apple Silicon 构建。
• 天气需要外部网络服务；素材与音乐在本地加载。

V3.0 · 摸鱼桌面：锦鲤、赶海与猫咪庭院

应用版本统一为 3.0.0。同一个程序切换锦鲤池、赶海与猫咪庭院，保留原有本机存档。

• 新增猫咪庭院：16 款品种/花色外观、体型与眼睛耳朵定制、名字和性格、六种互动道具、回窝休息。
• 重制四肢协调步态，平地不弹跳；上下石阶有起跳和落稳。补齐四季全场景、树冠遮挡、接触阴影、日夜与萤火虫。
• 加入柔和微风、偶发鸟鸣和猫叫，声音统一在设置中控制。
• 修复喂食距离与朝向：按 16 款猫咪的嘴部和当前体型安排就餐位置，先走到位、转向再进食；支持双猫同盆，食盆不漂移。
• 同步赶海海水与岩石交界、生物分布等已有修复。

验证：407 项逻辑测试、5 项桌面策略测试通过；开发版 19 个进食场景与 macOS arm64 正式包 6 个代表场景通过，三主题切换和猫咪状态恢复正常。生产构建及本地签名校验通过。远端全部 525 个文件已与本地发布源码逐一核对。

下载下方 Source code (zip)，按 README 安装依赖后运行 pnpm dev；Apple Silicon Mac 可用 pnpm package:mac 构建桌面版。本次 GitHub 发布包含完整源码、离线素材、原稿与验证脚本，不附编译安装包。macOS 使用本地 ad-hoc 签名，未进行 Apple 公证；Windows/Linux 原生桌面层尚未实现。

完整发布说明 · 喂食验证与复现方式

V2.0 · 摸鱼桌面：锦鲤与赶海

浮生「摸鱼桌面」双主题完整源码发布。原锦鲤池与新增赶海共用同一套界面、桌面窗口和设置，旧存档继续保留。

• 赶海：30 分钟动态潮汐，可手动立即涨退潮；观察、捕捉、救助、拾贝、小桶、放生和图鉴。
• 漂流瓶：每次涨潮带来一只来信瓶；自然涨潮、手动退潮转涨潮都支持，同一轮不重复。海上已有未拾来信时保留原瓶。
• 29 封压缩手写信纸，已收藏不再重复；支持在同一张纸上打字和画画，放流有动画。
• 岩石遮挡、海浪、沙滩绘画、鱼蟹动效与锦鲤柔和游姿一并更新。
• 附完整离线素材、测试、原生 macOS 源码与开发说明。

验证：245 项逻辑测试、5 项桌面策略测试通过，生产构建及 macOS arm64 打包/本地签名校验通过。实际页面已验证涨潮来瓶与拾取收藏。

下载下方 Source code (zip)，按 README 安装并运行 pnpm dev；原生桌面目前适配 Apple Silicon Mac，其他系统可先运行网页。此处 V2.0 是 GitHub 合集里程碑，内部构建版本保留 2.4.1。应用未进行 Apple 公证；本次发布的是源码，不含编译后的安装包。