dsh-feiyu-wardrobe

🐋 大肥鱼衣橱 · dsh-feiyu-wardrobe

把 DSH 的 token 账单，变成一条鱼的衣柜。

当前版本：2.1.0（2.5D-only + DIY 全链路；破坏性变更见 CHANGELOG）

🆕 v2.0.0（2.5D-only，破坏性变更）：装好插件后，DSH 侧边栏会出现 🎀 换装间，点开即玩——左边舞台 + 右边衣柜的经典换装布局；角色是自研 WebGL2 2.5D 动态看板娘（59 骨 / 15 弹簧链、LBS 蒙皮、头部跟随 / 歪头 / 点头、呼吸、发丝与裙摆物理、眨眼 / 笑眼 / 口型、双身形在线切换），不再有 DOM 分层纸娃娃（旧 DOM 渲染路径已按用户拍板删除）；Q版 / 少女版双身形，上衣 3（毛衣 / 卫衣 / 水手服）× 下装 2（格纹 / 深蓝百褶）任意混搭 + 经典女仆长裙，另有 6 张场景背景、4 种粒子特效。养女儿向互动保留：摸摸头、喂食（消耗鱼粮）、心情、亲密度、每日问候、待机台词，与鱼粮经济联动。需要浏览器支持 WebGL2；不支持时换装间只显示文字提示（不做静态人物兜底），详见 docs/dress-up/2.5D-RUNTIME.md。真机性能未测。

🆕 DIY 上传（0.11.0，可选 · 默认关闭）：上传一张衣服照片 → 宿主本地代理调用云端图像 API 生成「角色穿这件衣服」的 look 与平涂色版 → 浏览器本地自动成层 → 预览确认后存入本地衣柜直接试穿；支持 .dshskin 导出/导入。默认关闭、需显式同意与费用确认、API key 只在宿主环境、内容守卫客户端+宿主双重拦截；详见下文「DIY 上传（可选 · 默认关闭）」。

完全离线：换装间和全部素材由插件自己的本地静态路由 /feiyu/dress-up/ 提供，不依赖 GitHub Pages / 外部网络。

也可以免安装在线试玩：https://git121995.github.io/dsh-feiyu-wardrobe/dress-up/

DeepSeek Harness 插件：agent 每花掉一次 token，你的大肥鱼就吃一顿饭；一顿顿饭攒成鱼粮币，鱼粮币解锁 21 件原创 SVG 穿搭；/fish report 生成一张 1080×1440 的饲养报告卡，可以直接发小红书 / QQ 群。

• 🍚 真实账本：按 DeepSeek 官方峰谷价把每次模型调用折成人民币，再按 1 元 = 100 鱼粮币发币
• 🎨 原创形象：胖鲸 + 21 件手绘 SVG 单品（帽子 / 面部 / 颈部 / 身体 / 手持 / 背景），不打包任何画师二创素材
• 🎀 换装小游戏（养女儿向、内容保守）：侧边栏换装间 + WebGL2 2.5D 动态角色（Q版/少女版双身形 + 骨骼/物理/眨眼/口型 + 任意上衣×下装混搭 + 背景特效），全部离线（需浏览器支持 WebGL2）
• 🐋 悬浮小鲸鱼：可拖动的迷你立绘，实时跟随当前穿搭；左键互动、右键菜单打开换装间（不会误触跳转），面板里可一键隐藏
• 🔒 纯本地：换装间零额外模型调用、零外部网络请求，不存聊天原文，只存聚合数字
• 📸 可晒卡：饲养天数、投喂金额、吃掉 token、亲密度、心情、近 7 天伙食、今日穿搭
• 🖼️ 可视化出图：/fish png 或 dsh-feiyu-report --png 直接渲染 PNG（默认 768，带 repo 水印），无需浏览器，可直接发 QQ 群 / B站评论区 / 小红书

名字与形象都是原创，属于社区玩梗项目，不是 DeepSeek 官方产品；「大肥鱼」一词来自社区对 DeepSeek 蓝色鲸鱼标识的可爱误认。

---

安装

需要 Node.js >= 22.5 和可用的 DeepSeek Harness（本版在 DSH 0.2.1-rc.2 上实测）。

# 装进你正在用的 profile（web / tui / headless 按需替换）
dsh plugin --profile web add dsh-feiyu-wardrobe

# 重启后生效
dsh --profile web

重启后随便让 agent 干点活，然后：

/fish

命令

命令	说明
/fish	看鱼今天的状态（投喂金额、token、亲密度、心情、穿搭）
/fish list	逛衣柜：按部位列出全部单品、价格与拥有状态
/fish buy <名字|id>	用鱼粮币买下并自动穿上
/fish wear <名字|id>	换上已拥有的单品
/fish takeoff <部位>	脱掉某个部位（bg / body / neck / face / hand / hat）
/fish rename <名字>	给鱼改名
/fish png [尺寸]	渲染当前穿搭的 PNG（默认 768；可直接发群）
/fish report	生成饲养报告卡（HTML，1080×1440）
/fish help	帮助

不占单独模型调用，命令本身不烧 token。

怎么玩

1. 喂食：每次模型调用按官方峰谷价折成 CNY，1 CNY = 100 鱼粮币（可配置）。新鱼出生送 120 币 + 小叶子一顶。
2. 干饭 / 互动 / 连续天数 一起涨 亲密度（0–100：陌生鱼 → 点头之交 → 饭搭子 → 老饭友 → 家人 → 过命交情）。
3. 心情 由「今天吃了几顿 + 聊了几句 + 距上一顿多久 + 连续天数」决定：饿晕了 / 有点饿 / 悠哉 / 满足 / 撑到翻肚。表情会跟着变。
4. 衣柜 21 件单品、三个稀有度：普通 / 稀有 / 史诗（王冠 600 币，慢慢攒）。
5. 晒卡：/fish report 或 dsh-feiyu-report 生成竖版卡片，浏览器打开直接截图。

换装间（2.5D 动态角色）

docs/dress-up/ 是一个纯前端换装页，也内嵌在 DSH 侧边栏面板里，免安装、手机也能玩：

• 左右布局：左边舞台、右边衣柜（分类 + 纯衣服图标网格 + 随机/立绘卡）
• 单一渲染路径 = 自研 WebGL2 2.5D：透明 canvas 上渲染骨骼蒙皮角色（59 骨 / 15 spring 链 / 两身形各 1 张图集）， 头部跟随鼠标、呼吸、发丝/裙摆物理、眨眼/笑眼/口型；背景与粒子特效仍在 CSS/DOM 层，换背景不触发 canvas 重绘
• 组合数 O(N)：任意上衣 + 下装即时组合（毛衣/卫衣/水手服 × 格纹/深蓝百褶），另有女仆连衣裙； 所有服装共用同一骨架与物理，换装不重置头部/表情/物理状态
• 双身形切换：Q版（三头身）/ 少女版（六头身），在线切换、参数/表情/物理状态保留
• 背景 6 + 粒子特效 4（飘雪 / 花瓣 / 星光）任意搭配；默认穿搭 = 经典女仆装；互动台词走「养女儿/陪伴」路线，保守不含暗示
• 点角色说话（头部区域触发摸摸头）、随机换装、左右方向键换套装、保存立绘卡（900×1350）
• 无 WebGL2 时：换装间只显示文字提示（「换装间需要 WebGL2；请升级浏览器或开启硬件加速」+ 重试按钮）， 不做静态图/人物兜底；DIY 造型为静态贴片，不支持骨骼动画
• 离线：DSH 里由 lib/webserver.js 注册 /feiyu/dress-up/ 静态路由（仅 GET/HEAD、拒绝目录穿越），不依赖 GitHub Pages

素材管线（全部可复现，2.5D 资产规范见 .scratch/m3/ASSET-SPEC-2D5.md 的历史快照，构建脚本见 tools/build_2d5.py）：

# 2.5D production 资产（.scratch/m4/dist/<shape>/{rig.json,tex/}）→ 仓库 docs/dress-up/art/2d5/
python3 tools/build_2d5.py --rig .scratch/m4/dist/chibi/rig.json \
    --texdir .scratch/m4/dist/chibi/tex --out docs/dress-up/art/2d5 --shape chibi
# girl 同理；构建自动做图集打包/UV 重映射/定点化/pixelEqual 校验

构建需要 pillow + numpy（仅构建用；游戏运行零依赖）。旧 DOM 分层素材管线（build_wardrobe/build_masks）已在 v2.0.0 删除，历史见 git。

素材版权：

• 立绘 / 服装：本项目用 Seedream 5.0（火山方舟）基于自建素体生成，不是现有画作的再分发
• 角色概念参考：大肥鱼社区二创（上善无形「溟月」→ ZipZipPipe 女仆鲸鱼娘 的社区衍生形象），仅作风格与设定参考
• 本项目免费开源、不商业化、不卖皮肤

DIY 上传（可选 · 默认关闭）

v2.1.0 · agent 可调用宿主管线（S2）+ 可动套装安装（S3）：dsh-feiyu-diy CLI / /diy 命令把「图片 → Seedream look/flatout → 宿主 Python 自动成层 → 自动绑定 → QA → 安装」串成一条流水线（默认关闭、预算/守卫/缓存沿用本机 DIY 配置；失败自动回退静态贴片）。安装后的 DIY 套装会出现在换装间衣柜（🧵）：选中即动态 2.5D 可动换装（runtime 运行时合并增量 pack，不重建 base 图集），支持删除与 .dshskin 导出/导入；页面通过宿主 /feiyu/diy/registry.json 读取（静态托管/未开启 → 无 DIY，不报错）。格式见 docs/dress-up/DIY-PACK.md、管线见 docs/dress-up/DIY-PIPELINE.md。

「✨ DIY 上传」把你自己拍的衣服变成角色能穿的分层图层：上传一张衣服照片（挂拍/平铺/穿着均可） → 宿主本地代理调用云端图像 API（火山方舟 Seedream）生成「角色穿这件衣服」的 look + 同姿势平涂色版 → 浏览器本地 canvas 自动 diff 成层（自适应阈值 / 补头发遮挡 / 拆袖 / 自动 QA）→ 预览确认后存入 浏览器 IndexedDB 本地衣柜，以 2.5D 静态贴片方式试穿（暂停骨骼动画、按槽位叠加全画布贴片）——UI 会明确提示「DIY 造型为静态，不支持骨骼动画」；可删除、可导出/导入本地 .dshskin 分享包。

opt-in 与安全边界（很重要）：

• 默认关闭。不开启、不生成时没有任何网络请求，纯离线换装完全不受影响。
• 首次开启需要显式同意：衣服图会发送到云端图像 API 并产生费用（1 件 ≈ 2 张图 ≈ ¥0.42–0.60）， 每次生成前还会二次确认；宿主有每日图片数/金额上限，超限直接拒绝。
• API key 只在宿主环境（ARK_API_KEY，或 ~/.config/seedream/env），不进前端、不进日志/错误响应； 浏览器只与本机宿主同源路由通信，云端图片 URL 下载后即丢弃。
• 内容硬守卫（客户端 + 宿主双重）：暴露/超短/性感向/涉未成年人输入直接拒绝，不送 API； 偏短/贴身描述自动降级为保守版型（长袖/及膝/宽松）。基于文本词表 + 保守 prompt 模板， 图像分类器是后续项（不宣称完全防护）。
• 生成结果与记录只存在本机浏览器（IndexedDB），不上传服务器、无遥测。

开启方式（宿主配置，改完重启 DSH）：

- id: feiyu-wardrobe
  name: dsh-feiyu-wardrobe
  config:
    diy:
      enabled: true
      # dailyImageLimit: 40   # 每日张数上限
      # dailyBudgetYuan: 10   # 每日金额上限（¥）

完整契约（代理路由/预算/缓存/守卫/.dshskin schema/已知限制）见 docs/dress-up/DIY-UPLOAD.md。目前只支持 Q版（chibi） 身形。

报告卡 CLI

dsh-feiyu-report                    # 用本机 state 生成 HTML 卡片
dsh-feiyu-report --png fish.png     # 直接出 PNG（QQ 群 / 评论区可用）
dsh-feiyu-report --png fish.png --size 1024
dsh-feiyu-report --demo --png demo.png
dsh-feiyu-report --open             # 生成后用默认浏览器打开
dsh-feiyu-report --out card.html    # 自定义 HTML 输出路径
dsh-feiyu-report --sheet            # 渲染整个衣柜目录页

出图是纯本地 SVG → PNG（@resvg/resvg-js，预编译二进制），不调用浏览器、不联网。

配置

在 profile 的 cordis.patch.yml 里覆盖（都是可选项）：

- id: feiyu-wardrobe
  name: dsh-feiyu-wardrobe
  config:
    fishName: 大肥鱼            # 初始鱼名，之后也能 /fish rename
    statePath: ""               # 默认 <DSH_HOME>/feiyu-wardrobe/state.json
    timezoneOffsetMinutes: 480  # 北京时间
    coinPerCNY: 100             # 1 元 token 花费 = 多少鱼粮币
    birthGiftCoins: 120         # 出生礼
    dailyRetentionDays: 120     # 每日台账保留天数
    holidays: []                # 法定节假日（峰谷价用），YYYY-MM-DD
    diy:                        # DIY 上传（可选，默认关闭；见 docs/dress-up/DIY-UPLOAD.md）
      enabled: false            # true = 开启云端生成 + 本地衣柜（需宿主 ARK_API_KEY）
      dailyImageLimit: 40       # 每日图片张数上限
      dailyBudgetYuan: 10       # 每日金额上限（¥）
    dressUp:                    # 换装间（v2：2.5D-only，无渲染模式开关）
      interaction:
        enabled: true           # 互动/喂食经济开关；false = 页面 local-only（只播台词/动作，不扣鱼粮）

隐私与版权

• 只存聚合数字：金额、token 数、次数、日期、穿搭状态；不存任何聊天原文、模型输出、工具参数。
• 不联网：插件和报告卡都不发请求；卡片是自包含 HTML，没有远程字体/图片/脚本。
• 两套美术：报告卡里的胖鲸与 21 件单品是本项目原创 SVG；换装间的 2.5D 角色（59 骨绑定/图集）是本项目用 Seedream 基于自建素体生成并自行绑定的素材（角色概念参考社区二创），不直接再分发任何画作，不冒充官方形象。DIY 成层用的 3 张素体参考掩膜（art/diy/masks/chibi/）是不可见的算法输入，不是渲染资产。
• 非官方：本项目是社区插件，不属于 DeepSeek 官方项目；「大肥鱼」相关梗的归属属于社区。
• 后续开放「皮肤包」格式时，同样只支持本地加载用户自己的素材，不代分发未授权作品。
• DIY 上传默认关闭：开启后仅把用户上传的衣服图 + 自建素体发给云端图像 API 用于生成；API key 只在宿主环境，生成结果/记录只存本机浏览器 IndexedDB，无遥测；可随时关闭开关或删除记录。

接 QQ / 聊天机器人（出图能力）

「换装」是视觉性的，所以核心能力是出图而不是出文字：

• 任何能执行命令的 QQ 机器人（LangBot、DSH + QQ 适配器等）都可以在 wear 之后调一次 dsh-feiyu-report --png /tmp/fish.png，把 PNG 直接发到群里；
• DSH 内也可以用 /fish png 生成文件，再由机器人发送；
• 图片带仓库水印，别人转发一次就是一次曝光。

注意：本项目只负责「渲染并给出 PNG 文件」，QQ 平台的接入、账号风控由你选用的机器人框架负责。

兼容性与测试

• DSH >= 0.1.0（本版在 0.2.1-rc.2 实测）
• Node.js >= 22.5，零运行时依赖
• npm run verify = tsc --checkJs 类型检查 + 230+ 个单元/集成测试（定价、经济、状态迁移、渲染、PNG、命令、CLI、换装间静态路由、2.5D 资产契约/图集完整性、manifest v8、无 WebGL2 纯文本提示、DIY 守卫/代理/预算/缓存/成层/IndexedDB 记录/.dshskin、M5 互动/经济）

npm run verify

路线图

• 已完成：v0.7 真·分层换装 → v0.8 性能修复 + 保守内容收敛 → v0.9 7 槽位纸娃娃 → v1.0.0 2.5D（opt-in）+ 养成互动
• v2.0.0（本轮，破坏性变更）：删除 DOM 分层渲染，收敛为 2.5D-only；无 WebGL2 仅文字提示；DIY 改静态贴片
• 下一步 · 配饰层：头饰 / 鞋子 / 手持，复用 2.5D 槽位（drawable slot）体系
• DIY 上传 M1（默认关闭）：上传衣服 → 宿主代理生成 look/flatout → 浏览器本地成层/QA → IndexedDB 本地衣柜 → .dshskin 导入导出（8/8 真实照片 QA 成层通过，见 docs/dress-up/DIY-UPLOAD.md）
• 之后：皮肤包社区交换码、DIY 图像分类器补强、真机性能矩阵
• 更远：多鱼塘（多会话鱼）、每日小任务；把 dsh-memory-gate 的记忆做成「鱼记得你说过什么」，但依然只读聚合摘要

开发

git clone https://github.com/GIT121995/dsh-feiyu-wardrobe && cd dsh-feiyu-wardrobe
npm install
npm test            # node --test
npm run typecheck   # tsc --checkJs
node bin/feiyu-report.mjs --demo --out card.html   # 预览报告卡

结构：

lib/webserver.js 换装间本地静态路由（/feiyu/dress-up/，离线可用）
lib/client.js    浏览器半区：侧边栏换装间入口 + 主面板 iframe + 悬浮小鲸鱼
docs/dress-up/   换装间前端：2.5D-only（runtime-2d5*.js + manifest v8 + art/2d5/<shape>/{rig.json,atlas.webp}）
lib/catalog.js   21 件原创 SVG 单品 + 稀有度/价格
lib/render.js    360×360 场景与 1080×1440 报告卡
lib/economy.js   鱼粮币 / 亲密度 / 心情 / 连续天数
lib/pricing.js   DeepSeek 官方峰谷价计费
lib/runtime.js   会话事件 → 经济系统，买/穿/改名
lib/commands.js  /fish 命令
bin/             dsh-feiyu-report CLI

License

MIT。见 LICENSE。