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

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

当前版本：0.6.0

🆕 换装间 2.0（衣服真的穿在身上）：装好插件后，DSH 侧边栏会出现 🎀 换装间，点开即玩——左边舞台 + 右边衣柜的经典换装布局；右侧衣柜只放衣服图标；Q版 / 少女版双身形、6 套整套立绘、上衣×下装混搭、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 单品（帽子 / 面部 / 颈部 / 身体 / 手持 / 背景），不打包任何画师二创素材
• 🎀 换装小游戏：侧边栏换装间 + 整套穿着立绘换装（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 侧边栏面板里，免安装、手机也能玩：

• 左右布局：左边舞台、右边衣柜（分类 + 纯衣服图标网格 + 随机/立绘卡）
• 整套穿着立绘：用 Seedream 图生图，以自建素体为参考，直接生成「同一角色、同一姿势、穿好整套衣服」的完整立绘——换装 = 换整套立绘，衣服永远是穿在身上的（不是贴图层）
• 人物有动态：待机浮空/呼吸/轻摆、点击蹦跳说话、换装弹入、鼠标视差
• 站进场景：每张背景有地面线，人物脚底对齐地面并带接触阴影，不再是「壁纸前贴一个人」
• 双身形切换：Q版（三头身）/ 少女版（六头身），各有 6 套连衣裙 + 上衣×下装组合
• 混搭：上衣 3（毛衣 / 卫衣 / 水手服）× 下装 2（格纹 / 百褶）= 6 组预生成组合立绘
• 背景 6 + 粒子特效 4（飘雪 / 花瓣 / 星光）任意搭配；默认穿搭 = 经典女仆装
• 点角色随机说话、随机换装、左右方向键换套装、保存立绘卡（900×1350）
• 离线：DSH 里由 lib/webserver.js 注册 /feiyu/dress-up/ 静态路由（仅 GET/HEAD、拒绝目录穿越），不依赖 GitHub Pages

素材管线（全部可复现）：

# 1) 生成素体（Q版 / 少女版）：见 docs/dress-up/PROMPTS.md
# 2) 以素体为参考生成「整套穿着立绘」：<shape>-dress-<id>.png / <shape>-combo-<top>-<bottom>.png
# 3) 构建游戏素材（白底转透明 + 统一尺寸 + 缩略图 + bounds + manifest）
python3 tools/build_wardrobe.py --src .scratch/feiyu-gen/raw8 --out docs/dress-up

提示词、素体特征清单、新增衣服流程见 docs/dress-up/PROMPTS.md。

素材版权：

• 立绘 / 服装：本项目用 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 类型检查 + 73 个单元/集成测试（定价、经济、状态迁移、渲染、PNG、命令、CLI、换装间静态路由、换装素材完整性）

npm run verify

路线图

• v0.6：换装间接入鱼粮经济（用 /fish 攒的币解锁衣服）、更多整套立绘（外套 / 泳装 / 节日限定）
• v0.6：头饰 / 鞋子等配饰层、皮肤包格式（.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/   换装间前端：整套立绘换装（wardrobe-core.js + art/<shape>/ 立绘 + thumbs）
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。