dsh-piggy 0.31.0 → 0.37.0

package/CHANGELOG.md

@@ -5,6 +5,214 @@ All notable changes to `dsh-pig`. Versions follow the plugin's own
 
 ---
 
+## [Unreleased]
+
+## [0.37.0] — 2026-10-15 · 菜园 4.0：QQ 农场玩法、帮工、离线自动照顾（外壳 0.6.6）
+
+### 菜园 4.0（需要游戏 0.37.0）
+- 菜园照 QQ 农场的规矩重做：29 种作物、18 块地（开局 6 块，其余是荒地，每块 10000 菜币开垦），按真实时间长，关着也照长；长的时候会长草、生虫、干旱（雨天不旱），浇水、除草、杀虫免费还加经验；产量有浮动，收完留枯苗要铲掉才能再种；南瓜、橘子、柚子能收两季，石榴、椰子三季。
+- 菜园有等级：升下一级要「等级 × 100」经验，种子按等级解锁；三种肥料分别多长 2 / 3.5 / 5 小时。一键收获 / 照料 / 铲除 / 播种要先在商店买收割镰、喷雾桶、平地耙、播种器。
+- 两种界面、同一份数据：面板里是**小农场**（前 6 块地 + 一个主按钮做最该做的事，后面的地用一行字报情况）；点「大农场」打开**大农场**——桌面版是一扇能拉大缩小的窗口，网页版铺满页面——横版场景、18 块地斜着排、底部工具栏，点地块用手里的工具，也能用 Q/W/E/R 快捷键。大、小农场换成动森风的暖羊皮纸、薄荷按钮和花叶木纹点缀，种子袋、肥料、仓库、商店和购买框也换成同一套样式；小农场的五个工具与底部操作在窄面板里也能完整使用。
+- 帮工猪管 4 / 8 / 16 块地，赚到自己种同样地数的九成（原来七成），仍是六小时收一次仓、满级每小时最多 400；只补这块地原来指定的作物，缺那种种子就停在空地并报「缺××种子」，开荒地先清理再补种（清理不给经验、不吃体力）。
+- 农具档（顺手 / 轻巧 / 高效）从商店下架：3.0.0 线上买过的按买到档位累计退 **1000 / 4000 / 13000** 菜币，只退一次。
+- 老存档照旧：开过的地算数；地里的作物当作长完，按原来的产量收进仓库；旧洒水器、旧肥料和买过的农具档按原价退成菜币；大水壶换成喷雾桶。
+- 扩展素材不再限制图片张数和总大小，可以装下画面更丰富的扩展；每张图片仍会检查大小和完整性。扩展也能打开自己的大窗口，菜园 4.0.8 需要游戏 0.37.0。
+
+### 小猪
+- 普通猪每 8～16 秒眨一次眼；摸猪成功后它会害羞一小会儿，切换状态、隐藏或拖动时停下。
+- 小猪新增眨眼与「摸猪害羞」两张动作图（沿用 0.36.2 起的平涂无描边画风）。
+
+### 离开时和系统时间不对的时候
+- 离线自动照顾从「只吃东西」扩到三类：脏了用一份洗浴用品、闷了拿一个玩具，都优先刚好过线又最便宜的；回来会告诉你用了什么，也写进当天日记，设置里可关。
+- 系统时间被改错或对表拨回去时，猪猪原地不动：不补算、也不重复算；等时间调回来、真实时间越过原来那一点，才接着只算新增的那一段。
+- 离开太久、背包里的东西吃完之后还能撑 10 天；超过 10 天生命垂危（健康只剩 1 格、不能出门），累计满 30 天才撑不住离开（用还魂丹还能救回来）。生命垂危时也能带去看医生，看诊费按同一只猪看诊次数阶梯（第 1 次免费，之后 390 / 585，第 4 次起封顶 780）。
+- 一次结算最多推算到「背包能撑的天数 + 10 天」（绝对不超过 400 天），离开再久也不会一下子长几百天，更不会把面板卡住；年龄只按实际推算过的那一段增长。
+
+### 面板、桌面版和扩展
+- 面板刷新更跟手：画面没变就不重画，菜园的悬停卡不再被抹掉；真变了再重画时也会把悬停卡补回来；按住按钮、松开、点完这一套之前不会中途换掉按住的按钮。
+- 打开大农场时保留原面板，关掉大窗口焦点回到面板（需要桌面外壳 0.6.6）。网页版大农场铺满页面时不再露出面板底色；面板很矮时弹层、遮罩和购买框都不会戳出面板底边；大农场的「开垦」牌不再被旁边地块压住，点得到。
+- 下载扩展遇到坏包会指出真因：单张图片太大、图片名单写坏或文件校验不符都会明确报错，不会悄悄装一个没图的扩展。
+- 桌面版：小猪置顶丢了会在 3 秒内抢回来；全屏时小猪显示成什么样可以在设置里选（见下节）。
+
+### 全屏时隐藏小猪（需要桌面外壳 0.6.5）
+- 设置新增「全屏时（玩游戏、看视频）」：**隐藏小猪**（默认）/ **照常显示**。隐藏时只看小猪所在的那块屏，有程序全屏就把猪和面板收起来，退出全屏再回来；照常显示时猪压在全屏画面上面（独占全屏的游戏系统不让任何窗口盖上去）。选择存在这台电脑上，不进存档。
+- 全屏检测：Windows 用系统自带的 PowerShell 常驻一个小进程（每秒问一次前台窗口），不加新依赖；PowerShell 被禁用时设置里会说明，猪照常显示。Linux 用 xprop（Wayland 下只认得 X11 程序的全屏）；macOS 全屏程序在单独的桌面空间，「照常显示」时猪跟进去。旧外壳不显示这一项。
+
+### 修好的问题
+- 菜园扩展遇到被改坏的存档（经验值异常）不会再卡住整个菜园，等级照常算、菜照常种。
+- 离开很久回来，猪猪的年龄不会再少算几天，日记也不会缺页。
+- 生命垂危时原本只能干等：现在能带它去看医生，看一次就把生命值回满（第 1 次看诊免费）。
+- 离开特别久（几百天）时回来快了大约 6 倍，不用再等面板卡一下。
+
+## [0.36.2] — 2026-10-14 · 热修：平涂小猪、离开时自动吃东西、右键更稳（外壳 0.6.5）
+
+### 小猪
+- 小猪立绘换回旧版平涂无描边，去掉「小猪画风」设置。
+- 先撤回开心、照料、闲着与旅行时的反馈图（如三只猪叠在一起那张），照常显示立绘和动作图。
+
+### 离开时自动吃背包里的东西
+- 离开（关机、离线、很久没打开）期间，饱食掉到饿了的线时，猪猪会自己从背包吃一份食物：优先刚好吃饱又最便宜的。不吃药、还魂丹、礼物等非食物。
+- 回来时冒一句「你不在的时候，猪猪自己吃了 苹果×N」，也写进当天日记；背包空了会提示。设置里可关闭，旧存档默认开启。
+
+### 桌面版（外壳 0.6.5）
+- 启动时预先准备好面板：第一次右键马上打开；面板还在加载时再按右键不会把它关掉。
+- 修复轮询刷新替换掉按下中的按钮，导致购买或设置开关偶发点了没反应。
+
+## [0.36.1] — 2026-10-12 · 扩展整包下载（外壳 0.6.4 不变）
+
+### 扩展整包下载
+- 在线安装扩展改成只下一个扩展包（`.piggyext`），不再把代码和几十张图片一个个下：请求少了，国内直连更不容易半路卡住。目录里每条多了整包的地址和校验值；0.36.0 及更早的游戏照旧逐个下载，不受影响。
+
+## [0.36.0] — 2026-10-11 · 动森风菜园矿洞、无描边画风（外壳 0.6.4 不变）
+
+### 小猪画风
+- 完成无黑色描边的 181 张小猪审图候选，保留原角色、耳型、动作和场景；透明 PNG 按基础、形态、皮肤、反馈、徽章分类，逐字提示词和对照总览同步。整套获用户确认后接入游戏；设置新增「无描边 / 黑色描边」，本机记住选择，桌面猪与面板同步切换。导入皮肤保持原图，两套立绘分别校准可见高度，保留原有玩法和状态优先级。
+- 桌面边缘限制覆盖两套立绘的最大可见宽度，修复放大后胖猪电脑图被裁切的问题；换动作或画风仍保持位置和窗口尺寸。
+
+### 菜园、矿洞换成动森风画面
+- 菜园、矿洞的界面换成手绘风素材：海边菜园、木框菜畦、16 种作物各 3 个生长阶段，木牌手账风的矿洞、矿石和化石都有自己的图。
+- 菜园：顶上吊牌计分板放帮工，中间两列菜畦，玩家自己的猪站在旁边；底部木排四个工具一直摆着（不用再点开工具抽屉），下面是仓库、主按钮、商店。玩法和数值都没变。
+- 矿洞：没挖开的格子一律是同样的岩块，矿和化石挖开才看得到；够不着的格子调暗；猪站在最后挖开的那格。
+- 菜园、矿洞升 3.0.0，要游戏 0.36.0 以上。
+
+### 扩展可以带图片
+- 扩展目录多了 `assets/`（manifest 里 `assets` 列出），在线下载、本地导入、官方校验都把图片算进去；面板里用 `app.asset(名字)` 取图，`app.pigArt()` 取玩家现在的猪图。规则见[写扩展](docs/guides/writing-extensions.md)。
+
+## [0.35.0] — 2026-10-10 · 经济体系、新立绘、扩展自动化（外壳 0.6.4）
+
+### 新立绘
+- 普通猪、形态、皮肤、职业、成长阶段、动作、睡姿、不同状态的小猪和成就徽章，全部换成统一的黑色描边透明 PNG，按类型收进 `assets/pigs/`。游戏包反而小了一点。
+- 打工图改成猪趴在地上敲电脑；胖猪的宽图不再被裁掉。
+- 各种立绘按「猪的可见高度」统一校准，换皮肤、换形态时看起来一样大。
+- 自定义皮肤包改收 PNG，制作教程和示例包跟着换；以前做的 SVG 皮肤包照样能导入，已经装过的照常显示。
+
+### 经济
+- **不再限制每天玩几次**：番茄钟每个都给奖励；在线礼包每在线 1 小时一个、不设上限；猪在打工、上学、旅行时也能手动钓鱼。
+- 金币的进出都按来源记账，调试页「经济」能看钱从哪来、花到哪去（[设计](docs/design/economy.md)）。
+- **扩展有自己的钱**：菜币、矿石币、资质凭证……按扩展定的汇率跟金币互换（换成金币不收费，用金币买多收 5%）；删掉扩展时剩下的钱自动换成金币。背包里新增「钱包」页。
+- 各玩法的时薪都按收入区间核过（[J1](docs/numbers/J1-economy.md)、[J2](docs/numbers/J2-automation.md)）。
+
+### 玩法
+- **钓鱼 2.0**：40 种鱼、4 个钓点（小河、湖、海边、只在晚上开的夜潭）、4 把鱼竿；每种鱼游法不同、速度区间不同。等咬钩只要几秒（竹竿 3～8 秒），难度放在搏斗上，好竿让搏斗更容易；同种鱼越大越值钱。鲜虾鱼饵 15 → 6、夜光鱼饵 40 → 8。老存档送一把碳素竿。
+- **自动钓鱼加长**：可以买鱼篓、2 / 4 小时的自动钓、鱼饵盒；原来的 30 / 60 分钟一点没变。
+- **旅行 7 → 15 个地点**：公园、游乐场、动物园、海洋馆、竹林、雪山、沙漠、太空站（当过宇航员才能去），26 种新纪念品各有一句小故事。
+- **商店新上 27 件**：食物 12、洗浴 6、玩具 9。
+- **每个职业都能打 10 分钟短班**：时薪跟整班一样；短班不算完整一班，不会因为连打短班过劳生病。
+
+### 扩展（都要游戏 0.35.0）
+- **菜园 2.1.0**：16 种作物、8 块地；水壶、收割镰、播种器买了才能一键浇水 / 收获 / 种满；可以雇帮工猪替你收菜补种。界面换成插画版：天空、远山、木框田，主按钮自动做最该做的事。
+- **矿洞 2.1.0**：去掉体力，20 层，5 级镐一级级开路，矿脉、宝箱、化石、炸弹、电梯；可以雇小矿工猪替你挖。界面换成插画版洞窟。
+- **盲盒 3.0.0**：资质凭证放进钱包，1 张值 15 金币，能换成金币但不能用金币买；老存档的凭证打开盲盒时自动搬进钱包。
+- **扭蛋 1.2.0**：三台机器加进商店新上的东西。
+- 帮工、小矿工、自动钓鱼的仓都是攒满 6 小时就停，回来收一下接着干；满级每小时最多 400。
+- **扩展可以从文件导入**：「设置 → 扩展 → 📦 从文件导入」，选发布页上的扩展包 `.piggyext`（或扩展的三个文件）。官方扩展断网也能装；不是官方的先提醒风险，确认后才装，标「本地导入」、不会被在线更新盖掉。
+
+### 桌面版（外壳 0.6.4）
+- 新增代理设置：跟随系统、直连、自定义 HTTP / SOCKS5；游戏更新、外壳更新和在线扩展共用。
+- 小猪大小改成「− 百分比 ＋」，每次 10%，也能直接输入；换皮肤后照样能调，两个窗口马上同步。
+- 面板开着时，签到 / 礼包小气泡挪到猪旁边，猪说的话也不再被面板挡住。
+- 少问 GitHub：版本列表和在线扩展目录存在本机，一段时间内不重复请求，带 ETag 问「有没有变」，不再撞「每小时次数用完」。
+- 修复两个窗口抢消息导致调试台词不显示。
+
+### 其他
+- 网页版自带的 emoji 字体补上新玩法和扩展里用到的 40 多个表情。
+
+## [0.34.1] — 2026-10-09 · Gitee 的 Windows 安装包改成首次启动下载游戏（外壳 0.6.3）
+
+- **Gitee 的 Windows 安装包不再自带游戏**：安装包离 Gitee 单个附件 100MB 的上限只剩一点点，0.34.0 加了新图就放不下了。现在安装包只带外壳，第一次打开会弹个小窗口「正在下载小猪」，下好就进游戏（约 3.5MB）；断网或下载失败会说明原因，可以重试、打开下载页或退出。以后更新照旧在主屏「🔄 更新」里。
+  GitHub 的安装包、Gitee 的 Linux 和 macOS 安装包不变，照旧自带游戏。
+- 游戏包以后要是超过 95MB，会自动拆成几卷上传，外壳 0.6.3 起按顺序下载、逐卷校验再拼起来；老外壳看不到分卷的版本，会提示先更新外壳。
+- 开发用：`PIGGY_BUNDLED_GAME`（模拟安装包不带游戏）、`PIGGY_GAME_PIN`（指定首次下载用的清单），见 HANDOFF 8.2。
+
+
+## [0.34.0] — 2026-10-09 · 一猪多图、生日蛋糕、打盹睡姿（建议更新桌面外壳到 0.6.2）
+
+**一猪多图**
+- 普通小猪按状态换成对应的图（图的灵感来自 [PigHub](https://pighub.top/)，由 AI 重新画成本项目的样子，见 README「致谢与许可」）：
+  - 还没拆的纸盒是「猪递」；去世当天还是小猪的样子，满一天后是墓碑旁的幽灵；盲盒寻访页有寻访猪。
+  - 生病按病种和阶段：感冒流鼻涕、发烧（感冒第 2 期）、皮肤病起红疹、头晕晕乎乎；咳嗽、肠胃和病危保持原样加病色。
+  - 饿了、困了、孤单、脏了、开心；喂食、洗澡、玩耍、升级；上学、兴趣班（健身、听歌、画画）、钓鱼、旅行；部分职业打工（发传单、歌手、作曲、漫画家、运动员、教练、园丁、花店、CEO、明星）。
+  - 同一状态有几张图的按小时轮换。专属形态（猪猪王、恶魔猪等）、圆润/胖胖体型和导入的皮肤保留自己的立绘。
+  - 几张还没想好放哪的图（徽章、检疫合格、笼子等）先留着不用。
+- **生日**：猪生日当天头顶冒 🎂，点一下开个小派对——猪换成生日派对图、冒彩带，15 秒后恢复；当天点过就不再冒。不发奖励（以后另定）。
+- 图片离线处理成透明底 PNG、长边 256px，桌面版不再有白框；两张听歌图里耳机线、头箍围住的白底也去掉了。
+
+**打盹和动作**
+- 打盹时按当前形态换成睡姿，头顶偶尔冒 Zzz；自定义皮肤可以在 ZIP 里加可选的 `sleep.svg`，制作教程和示例包已更新。
+- 摸头轻压回弹，喂食短跳落地，玩耍左右两次小跳。
+
+**桌面版（外壳 0.6.2）**
+- Windows 上从桌面直接移到猪身上右键，第一次就能打开菜单（以前常要点好几次）。
+- 点面板里的照顾按钮时，猪的动作和气泡不再被面板盖住。
+- 右键猪不再顺带摸一下；脏和生病时身边绕着苍蝇/病毒；外出时也能看出脏了（「脏」排在外出和饿前面）；恢复桌面版的状态变色。以上来自贡献者 [@tetezi](https://github.com/tetezi) 的 [#8](https://github.com/CLICGGER-TYPES/dsh-piggy/pull/8)，谢谢！
+
+**调试**
+- 调试页新增「立绘」：每张图一个按钮，写明用在哪，点一下猪就显示这张；能指定做哪个小动作（含打盹）、马上过生日；「成长生病」页加了「发烧」。桌面版也能用（以前桌面版的「小动作」按钮是灰的）。
+
+**扩展**
+- 盲盒 2.2.2：寻访页加寻访猪图。
+
+## [0.33.1] — 2026-10-07 · 修：开着面板拖猪，面板越跑越远（要更新桌面外壳到 0.6.1）
+
+- **Windows 缩放 125%/150% 下开着面板拖猪，面板和猪越拉越远、松手后面板落在别处**（用户反馈录屏）：根子在桌面外壳拖动时每一帧「读回窗口大小再设回去」，分数缩放下读回来的比设的大 1px，拖一次猪窗口能从 345 宽涨到 482，钉在窗口右下角的猪被越推越远，鼠标也越甩越远。现在拖动全程用请求的大小、不用读回值；面板每一帧都按猪现在在哪直接算位置，不再在上一帧的面板位置上累加。
+- 拖动中面板和猪哪边对齐不再中途换边（以前拖到屏幕左边面板会横跳一个面板宽），放不下就停在屏幕边；松手后原来那边还放得下就保持。
+- 在 Win11 虚拟机 125% 缩放下用真鼠标开着面板拖 3 次并录屏逐帧量：面板和猪的相对位置拖动全程 90% 的帧偏差 ≤2px、不随时间增长（修前最远偏 204px），猪跟鼠标的距离中位数从 97px 降到 1～5px；Linux GNOME 9 组真拖录屏回归通过。
+- 游戏包会顺带把猪在窗口里的位置报给外壳（贴屏幕边时内容在窗口里挪过），面板按它贴猪；老外壳忽略这条，不影响。
+- 开发用：`tools/drag-film.py --panel` 逐帧量面板和猪的相对位置。
+
+## [0.33.0] — 2026-10-07 · 桌面版猪和面板分开、扩展成就
+
+### 桌面版：猪和面板各一个窗口（要更新桌面外壳到 0.6.0）
+
+- 面板不再和猪挤在同一个窗口里，而是单独一个窗口贴在猪旁边：上方放得下就开在上面，否则开在下面，整块在屏幕里。开关面板、切 App、喂食、冒气泡，猪的窗口都一动不动——以前这些都要改猪那个窗口的大小，差一拍猪就跳一下。
+- 拖猪时面板跟着走；拖到屏幕边上，猪一路跟着鼠标贴到边，松手不再瞬移。点到别处面板自动收起（「点外面自动收起」设置照旧）。
+- 面板里做的事（喂食、签到……），猪那边马上有反应和气泡。
+- 打开面板不再抢焦点，GNOME 不会因此弹「已就绪」提示。
+- 这个版本的游戏包需要桌面外壳 0.6.0；旧外壳会继续用自带的游戏包，「设置 → 更新」里会提示先更新桌面程序。
+- 开发用：`tools/desktop-geometry-check.mjs` 检查两个窗口的行为，GNOME 下用真鼠标拖动并录屏，`tools/drag-film.py` 逐帧看拖动中和松手后猪有没有跳。
+
+### 扩展成就与公共事件（贡献者 [@1nuoiscute](https://github.com/1nuoiscute)，[#7](https://github.com/CLICGGER-TYPES/dsh-piggy/pull/7)）
+
+- 为菜园、矿洞、扭蛋和盲盒新增 12 项成就与小猪 SVG 徽章，累计、收藏与最高探索层数由公共进度事件记录；图鉴最多展示 28 项。
+- 新增扩展 `api.emit` 与可选历史 `progress` 钩子；成功动作事务提交，拒绝和异常回滚，重复上报不重复计数。
+- 旧扩展数据只补录可证明经历，日期未知不编造；更新保留基线，卸载/领养保留主成就进度，新安装可继续积累。旧扩展详情提示更新。
+- 修复试玩页宿主按钮样式挤偏返回箭头。
+- 四个扩展随本版发布：farm/mine/gacha 1.1.0、blindbox 2.2.0（在「设置 → 🧩 扩展」里更新即可拿到新成就）。
+
+### 「Emoji 样式」在网页版也能用
+
+- 网页版也带一套瘦身 emoji 子集（0.9MB，覆盖游戏里用到的全部 emoji），「设置 → Emoji 样式」在网页版也能选，默认就是内置那套。桌面版仍用外壳提供的完整字体。
+
+### 其他
+
+- 桌面版帧率跟显示器刷新率走，不再写死 30fps；拖动的采样频率也跟显示器同步。
+- 存的猪位置改成「哪块显示器 + 相对偏移」，显示器拔掉会落到最近的屏；跨屏缝拖动不再被弹回。
+
+## [0.32.0] — 2026-10-06 · 小猪成就、日志导出与扩展下载修复
+
+### 小猪成就系统（贡献者 [@1nuoiscute](https://github.com/1nuoiscute)，[#6](https://github.com/CLICGGER-TYPES/dsh-piggy/pull/6)）
+
+- 图鉴新增成就分类，十六枚以小猪为主图案的透明 SVG 徽章，展示目标、进度和获得记录。
+- 成功照顾与实际完成学习、工作、旅行，以及钓鱼收藏和晋升记录驱动解锁；合并同时获得的徽章提示。
+- 记录和累计次数跨领养保留；完整重置清空。旧档只补录可验证经历，未知完成日期明确标注，存档版本保持 v12。
+- 增加隔离试玩入口与规则草案，首版只奖励徽章，不改属性或金币。
+
+### 设置里导出日志
+
+- 「设置 → 日志 → 导出日志」一键把运行日志存到你自己选的位置：桌面版弹系统「另存为」，网页版用浏览器的另存为，都不支持时退回普通下载。
+- 日志包含版本、渠道、存档版本、运行环境、每个动作的耗时与拒绝原因、扩展目录与下载的每次尝试、存档读写与迁移、浏览器里的未捕获错误和失败请求；桌面版还会带上窗口与更新的记录。
+- 日志同时写在存档目录的 `logs/dsh-piggy.log`（满 1.5 MB 轮转），内存里始终留最近 800 条。网页版以前没有任何可取的现场，现在也能导出。
+- 规则抛错后回滚、存档损坏留副本这类以前只有一行 console 的情况，现在都会出现在导出的日志里。
+
+### 扩展下载修复
+
+- 每个扩展文件下载 12 秒超时、最多试 3 次，三个文件并行；失败时说明是哪个文件、连哪个主机、什么原因（超时 / 被中断 / 域名解析不了），不再只有一句 `fetch failed`。在线目录读取也加了超时和重试。
+- 点「下载」立刻变成「下载中…」并挡住重复点击；失败的原因留在卡片上并给一个「重试」按钮，不再只闪 2.4 秒的气泡，也不再让面板看起来「点了没反应」。
+
+### 桌面外壳 0.5.0
+
+- 新增 `piggyShell.logs.save`，导出日志时弹系统「另存为」。页面与外壳的约定版本 `DESKTOP_VERSION` 升到 3；老外壳没有这个方法，会自动退回浏览器下载，功能仍可用。
+
 ## [0.31.0] — 2026-10-05 · 扭蛋、菜园、矿洞和盲盒寻访
 
 只更新游戏，不用重装桌面程序（桌面外壳仍是 0.3.0）。三个新扩展和盲盒 2.1.0 在「设置 → 🧩 扩展 → 在线扩展」里下载。
@@ -79,7 +287,7 @@ All notable changes to `dsh-pig`. Versions follow the plugin's own
   - 重复的加潜能（最多 6 潜）并给资质凭证；凭证商店换盲盒券、指定五星 / 六星、豪华大餐、百草丹。
   - 开盒：补给箱落下，箱缝透出星级颜色的光再打开；十连两行小箱子逐个翻开，可以跳过；六星撒彩纸。
   - 1.0 的收集自动换算：摆件保留为潜能，碎片 1 换 2 资质凭证。
-  - 数值单 `docs/tasks/numbers/X1-blindbox.md`。
+  - 数值单 `docs/numbers/X1-blindbox.md`。
 
 ## [0.30.0-rc.2] — 2026-10-05 · 盲盒上线 + rc.1 反馈修复（测试版）
 
@@ -91,7 +299,7 @@ All notable changes to `dsh-pig`. Versions follow the plugin's own
   - 重复的变碎片，10 碎片换一个没有的普通款，40 碎片换隐藏款。
   - 开盒：盒子摇两下打开，摆件一个个弹出来，新的标 NEW；隐藏款带金光、撒彩纸。展示柜里每个系列一排小底座，没抽到的是剪影，点一下看介绍，集齐有 🏅。
   - 装了盲盒以后，签到有 15%、在线礼包有 12% 的机会多送一张🎟 盲盒券，免费开 1 个。
-  - 数值单 `docs/tasks/numbers/X1-blindbox.md`，代码 `extensions/blindbox/`。
+  - 数值单 `docs/numbers/X1-blindbox.md`，代码 `extensions/blindbox/`。
 - 猪在外面时也能直接点打工、上课、旅行、自动钓鱼：先问「结束 xxx，改去 yyy 吗？」，确认后叫回来再出发（打工到一半没有这一班工钱，上学、旅行退钱，自动钓鱼退鱼饵）。
 
 ### Changed
@@ -110,7 +318,7 @@ All notable changes to `dsh-pig`. Versions follow the plugin's own
 
 ### Added
 - **钓鱼三种搏斗玩法**：鱼咬钩后随机是圆盘、竖条拉锯、拉力收线之一（原型见 `docs/prototypes/fishing-fight.html`）。
-- **台词翻倍**：原有 32 个场景每个翻倍，新增出门打工 / 上学 / 旅行、买东西、钱不够、钓到鱼 / 稀有鱼 / 鱼跑了、换皮肤、体型变化（审稿单 `docs/tasks/numbers/G4-lines.md`）。同一场景最近 3 句不重复。
+- **台词翻倍**：原有 32 个场景每个翻倍，新增出门打工 / 上学 / 旅行、买东西、钱不够、钓到鱼 / 稀有鱼 / 鱼跑了、换皮肤、体型变化（审稿单 `docs/numbers/G4-lines.md`）。同一场景最近 3 句不重复。
 - **按时间说话**：早上、中午、下午、傍晚、深夜、凌晨各问候一次；在线满 90 分钟提醒喝水、满 2 小时提醒休息眼睛；元旦、情人节、春节、元宵、清明、劳动节、儿童节、端午、七夕、中秋、国庆、圣诞和猪的生日（农历日期写到 2029 年）；周末问候。
 - **摸不同部位**：左键点猪会真的摸它，头、耳朵、鼻子、肚子、背、尾巴、脚各有反应和台词；30 秒内第 8 下开始不耐烦、不再加心情，停手 1 分钟消气。
 - **猪自己找事做**：面板收着、猪在家时，每 3–8 分钟打滚、打盹、追蝴蝶、挠痒、伸懒腰、看屏幕或吹泡泡。
@@ -147,7 +355,7 @@ All notable changes to `dsh-pig`. Versions follow the plugin's own
 - **还魂丹放进药品货架**（商店、背包、图鉴都一样），不再单独一个「复活」格子。
 - 图鉴道具的筛选页签横着放不下时，可以用鼠标滚轮左右滚。
 - **更新入口收进设置**：主菜单去掉「更新」格子；有新正式版时设置格子冒红点，设置页顶部「🔄 更新」带红点。更新面板按正式版分组，测试版收在对应正式版下面、默认折叠，标「手动安装」；红点和「更新到最新」只看正式版。
-- **照顾数值调整**（确认单 `docs/tasks/numbers/G2-care-balance.md`）：吃东西不再扣清洁；洗澡扣饱食、玩耍和玩具扣清洁都减半左右；只有饱食已经 100% 还硬喂才可能胀气，概率 15%；心情每小时掉 2.4（原 3.6），清洁每小时掉 3.6（原 4.2）。
+- **照顾数值调整**（确认单 `docs/numbers/G2-care-balance.md`）：吃东西不再扣清洁；洗澡扣饱食、玩耍和玩具扣清洁都减半左右；只有饱食已经 100% 还硬喂才可能胀气，概率 15%；心情每小时掉 2.4（原 3.6），清洁每小时掉 3.6（原 4.2）。
 
 ### Fixed
 - **桌面版导入皮肤 ZIP 总是失败**（提示「ZIP 目录损坏」或一串英文）：桌面程序把上传的文件当文字读坏了。现在游戏改用文本方式上传，DSH 网页版和桌面版都能导入，不用更新桌面程序。ZIP 损坏时提示「ZIP 文件损坏，请重新压缩后再导入」。
@@ -384,7 +592,7 @@ All notable changes to `dsh-pig`. Versions follow the plugin's own
 
 ## [0.25.0] — 2026-10-01 · — B6 台词
 
-- 24 个场景、90 多句台词（文案见 `docs/tasks/numbers/B6-lines.md`）：吃撑、打工回来/累了、上完课、毕业、旅行回来、长大、复活等都会说话。
+- 24 个场景、90 多句台词（文案见 `docs/numbers/B6-lines.md`）：吃撑、打工回来/累了、上完课、毕业、旅行回来、长大、复活等都会说话。
 - 闲着每 20–40 分钟冒一句，先说需要什么（饿/脏/孤单），不需要才闲聊；离开半小时以上再打开会打招呼。
 - 状态页：「🙋 叫你「主人」 改」可以改称呼；「🔔 免打扰」开了不闲聊、不弹日常消息，生病和死亡照样提醒。
 - 学习页：「🎯 兴趣」成了学段旁边的一个按钮。
@@ -392,7 +600,7 @@ All notable changes to `dsh-pig`. Versions follow the plugin's own
 
 ## [0.25.0] — 2026-10-01 · — B2 成长 · B3 疾病 · B4 学习→职业
 
-数值全部照 `docs/tasks/numbers/` 里用户 2026-10-01 确认的单子。存档 8 → 11，每一级升级前都会原样备份。
+数值全部照 `docs/numbers/` 里用户 2026-10-01 确认的单子。存档 8 → 11，每一级升级前都会原样备份。
 
 ### B2 成长
 - 成长值（存档里的 `xp`）按猪时间自己长：每小时 +100，乘照顾系数（心情、饿脏、健康）。
@@ -458,7 +666,7 @@ All notable changes to `dsh-pig`. Versions follow the plugin's own
 
 ### Changed（内部，界面无变化）
 - 客户端源码移到 `src/client/`，`client.js` 改为 esbuild 产物；`npm run build` 生成，
-  `test/bundle.test.js` 守住产物新鲜度。详见 [docs/REFACTOR-PLAN.md](docs/REFACTOR-PLAN.md)。
+  `test/bundle.test.js` 守住产物新鲜度。详见 [docs/archive/REFACTOR-PLAN.md](docs/archive/REFACTOR-PLAN.md)。
 - 新增 [docs/CONVENTIONS.md](docs/CONVENTIONS.md)（项目版编码规范）。
 - 分层拆分（均保留同名 barrel，导入路径零改动）：`data.js` → `data/` 9 个模块、
   `core.js` → `core/` 15 个模块、`index.js` → `snapshot/commands/routes`、
@@ -771,7 +979,7 @@ All notable changes to `dsh-pig`. Versions follow the plugin's own
 
 ## [0.15.0] — 2026-09-30
 
-改造计划的第一批（手感 + 商店）。完整计划见 [docs/ROADMAP.md](docs/ROADMAP.md)。
+改造计划的第一批（手感 + 商店）。完整计划见 [docs/archive/ROADMAP-2026-09-30.md](docs/archive/ROADMAP-2026-09-30.md)。
 
 ### Added
 - **小猪大了一圈。** 40px 在面板里太小了，整套尺寸重排：

package/LICENSE-noto-emoji.txt

@@ -0,0 +1,224 @@
+本项目的小猪立绘（assets/piglet.svg 及在它基础上改画的各张猪图）参照 Noto Emoji 的 🐖（U+1F416）重绘，
+属于 Noto Emoji 图片素材的衍生作品。Noto Emoji 的图片素材按 Apache License 2.0 授权，原始声明和许可全文如下。
+来源：https://github.com/googlefonts/noto-emoji （2D/svg/emoji_u1f416.svg）
+
+----- 原始声明（noto-emoji/2D/svg/LICENSE）-----
+
+Copyright 2013 Google, Inc. All Rights Reserved.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+----- Apache License 2.0 全文 -----
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+