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

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

当前版本：0.10.1

🆕 换装间 3.1（纸娃娃分层 v2）：装好插件后，DSH 侧边栏会出现 🎀 换装间，点开即玩——左边舞台 + 右边衣柜的经典换装布局；右侧衣柜只放衣服图标；Q版 / 少女版双身形、7 槽位纸娃娃分层（素体 / 手臂+手 / 完整前发 + 每件衣服「衣身 + 袖子」两片）——上衣 3（毛衣 / 卫衣 / 水手服）× 下装 2（及膝格纹 / 百褶长裙）任意混搭，另有经典女仆长裙；手/前臂在裙子前面、长发丝在衣服前面、长袖袖口正确盖住手腕，图层遮挡关系按真实穿着顺序合成；另有 6 张场景背景、4 种粒子特效。人物会呼吸/浮空/蹦跳、会眨眼、说话有口型、偶尔笑眼，站进场景里而不是浮在壁纸上。桌面右下角还有一只悬浮小鲸鱼，跟着当前穿搭换装，拖动移动、右键菜单打开换装间。

完全离线：换装间和全部素材由插件自己的本地静态路由 /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 单品（帽子 / 面部 / 颈部 / 身体 / 手持 / 背景），不打包任何画师二创素材
• 🎀 换装小游戏（养女儿向、内容保守）：侧边栏换装间 + 7 槽位纸娃娃分层（Q版/少女版双身形 + 素体/手臂/完整前发 + 衣服「衣身+袖子」分片 + 任意上衣×长裙混搭 + 背景特效），手/前臂/长发遮挡关系正确，全部离线
• 🐋 悬浮小鲸鱼：可拖动的迷你立绘，实时跟随当前穿搭；左键互动、右键菜单打开换装间（不会误触跳转），面板里可一键隐藏
• 🔒 纯本地：换装间零额外模型调用、零外部网络请求，不存聊天原文，只存聚合数字
• 📸 可晒卡：饲养天数、投喂金额、吃掉 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 生成竖版卡片，浏览器打开直接截图。

换装间（分层换装）

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

• 左右布局：左边舞台、右边衣柜（分类 + 纯衣服图标网格 + 随机/立绘卡）
• 7 槽位纸娃娃分层（v6）：drawOrder = body → topUnder → bottom → topBody → arms → sleeve → hair。 每个身形有 body（素体）/ arms（手臂+手）/ hair（完整前发） 三层身体部件； 每件上衣/连衣裙拆成 衣身（topBody/topUnder）+ 袖子（sleeve） 两片—— 袖子盖在手臂上，手/前臂盖在裙子与衣身上，水手服下摆塞进裙子，长发侧丝盖在衣服上： 手不再消失、袖口关系正确、长发不会被腰线截断；服装走保守日常系（长袖长裙/及膝裙），没有暴露款式
• 组合数 O(N)：不再预生成「上衣×下装」组合矩阵，任意上衣 + 下装即时合成； 新增一件衣服 = 加「衣身 + 可选袖子」两层（用同一套部件掩膜自动切），不用重跑组合图

• 人物有动态：待机浮空/呼吸/轻摆、点击蹦跳说话、换装弹入、鼠标视差
• 站进场景：每张背景有地面线，人物脚底对齐地面并带接触阴影，不再是「壁纸前贴一个人」
• 双身形切换：Q版（三头身）/ 少女版（六头身），各 6 件衣服（1 连衣裙 + 3 上衣 + 2 及膝下装）
• 背景 6 + 粒子特效 4（飘雪 / 花瓣 / 星光）任意搭配；默认穿搭 = 经典女仆装；互动台词走「养女儿/陪伴」路线，保守不含暗示
• 点角色随机说话、随机换装、左右方向键换套装、保存立绘卡（900×1350）
• 离线：DSH 里由 lib/webserver.js 注册 /feiyu/dress-up/ 静态路由（仅 GET/HEAD、拒绝目录穿越），不依赖 GitHub Pages

素材管线（全部可复现，细节见 docs/dress-up/PROMPTS.md）：

# 1) 生成素体（白色无肩带连体泳衣）与单件穿着 look：见 docs/dress-up/PROMPTS.md
# 2) 白底单件图（whiteout）：每件衣服再生成一张「只留衣服、其余纯白」的图
# 3) 构建游戏素材：身体部件掩膜（tools/build_masks.py）/ 抠图 matte / 形状配准 / 衣服袖·身拆分 / manifest v6 / QA 拼图
python3 tools/build_wardrobe.py --src .scratch/feiyu-gen/raw12 --out docs/dress-up

构建需要 pillow + numpy + opencv-python（仅构建用；游戏运行零依赖）。

素材版权：

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

报告卡 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

隐私与版权

• 只存聚合数字：金额、token 数、次数、日期、穿搭状态；不存任何聊天原文、模型输出、工具参数。
• 不联网：插件和报告卡都不发请求；卡片是自包含 HTML，没有远程字体/图片/脚本。
• 两套美术：报告卡里的胖鲸与 21 件单品是本项目原创 SVG；换装间的素体/衣服图层/头发叠层是本项目用 Seedream 基于自建素体生成的素材（角色概念参考社区二创），不直接再分发任何画作，不冒充官方形象。
• 非官方：本项目是社区插件，不属于 DeepSeek 官方项目；「大肥鱼」相关梗的归属属于社区。
• 后续开放「皮肤包」格式时，同样只支持本地加载用户自己的素材，不代分发未授权作品。

接 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 类型检查 + 100+ 个单元/集成测试（定价、经济、状态迁移、渲染、PNG、命令、CLI、换装间静态路由、分层换装素材完整性）

npm run verify

路线图

• 已完成：v0.7 真·分层换装 → v0.8 性能修复 + 保守内容收敛 → v0.9 7 槽位纸娃娃（手/前发/袖口遮挡正确）
• 下一步 · P0 养成互动：喂食 / 摸摸头 / 一起吃饭 / 心情变化 / 亲密度等级 / 每日问候（复用鱼粮经济 + 换装间，台词过保守标准）
• 下一步 · 配饰层：头饰 / 鞋子 / 手持，复用 v6 槽位模型加 accessory 槽位（raw3 素材已在）
• 之后：用户上传衣服 → 自动生成图层入库（上传链路已验证）、皮肤包格式（.dshskin）、社区衣服交换码
• 更远：多鱼塘（多会话鱼）、每日小任务；把 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/   换装间前端：7 槽位分层换装（wardrobe-core.js + manifest v6 + art/<shape>/{body,arms,hair,layers}）
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。