DSH 鲸鱼娘皮肤全套打包，TypeScript 写的开源皮肤工具到底能干什么
一周新增 1092 颗星，CC BY-NC-SA 4.0 开源，主语言 TypeScript。一个为 DSH Web 定制的鲸鱼娘系列皮肤套件，附皮肤管理工具，适合二次元社群运营和前端插件开发参考。
适合：已经在使用或评估 DSH Web 的二次元社群站长，想找一套工程化、可扩展、协议清晰的鲸鱼娘主题皮肤。
先说结论
值得上手，但别把它当成「独立 APP」。 dsh-deep-whale 本质是 DSH Web（Deep Sea Helper，一类弹幕 / 直播助手社区项目）的鲸鱼娘主题皮肤包，配套还带了一套换肤框架。一周拿下 1092 颗星，靠的是「鲸鱼娘」这个圈子的拉新能力，加上 TypeScript 工程结构写得确实够干净，拿来当二次元 UI 模板用，比很多付费素材库值。
一句话定位：它是皮肤资产，不是聊天软件。 真正干活的还是 DSH Web 本体。
真正的问题
大多数皮肤包只有图，没有「换皮」的代码。 这是二次元社区项目的老毛病：做皮肤的同事只导出一堆 png，剩下的人还得手动改 CSS、找 className、一个个文件替换。本仓库之所以被讨论，是因为它把这件事往前推了一步。
仓库结构上看，主要分三类资产：
- 鲸鱼娘角色形象素材与深海女仆工坊 maid-atelier 的 UI 皮肤
- 一套 TypeScript 写的皮肤切换逻辑和插件钩子
- 配套的构建脚本，能直接编译进 DSH Web
授权是 CC BY-NC-SA 4.0。 注意这是「署名 + 非商业 + 相同方式共享」，商业项目、私活外包、用在公司产品里换皮，都属于违规区。个人站、同好会、非营利作品、二创分享才安全。
怎么做更省力
先把 README 里 Deep Sea Helper 的安装说明看一遍，再去 Releases 下载对应版本的皮肤包。 别跳步骤，作者的文档把皮肤目录结构和分发位置写得很细，省得你后面反复调试。
皮肤包解压之后，建议做下面这几件小事：
- 检查 skin 文件夹里是否同时有 web 与 mobile 端资源，有的项目会分开打包
- 看一下 themes.json 或同名配置，这是切肤入口
- TypeScript 源码改完一定要按 README 的脚本重新构建一次，不然 DSH Web 加载的还是旧版本
| 资源位置 | 主要用途 | 改动频率 |
|---|---|---|
| skin/ | 静态图与样式 | 偶尔换图 |
| src/ | TypeScript 切换逻辑 | 需要时改 |
| themes.json | 皮肤列表配置 | 加新皮肤必改 |
嫌配置改起来啰嗦，可以试试 Markdown 智能编辑器 之类的工具管理 themes.json 的注释与字段对照，让改动一眼能扫到。
哪些坑要避开
- CC BY-NC-SA 4.0 这条线别越。 商业网站、付费插件、嵌入自家产品，都算违规；只有保留署名、同样以 CC BY-NC-SA 4.0 再分发，才算合规。
- DSH Web 版本要对齐。 仓库的 Releases 一般只支持最近两三个版本，跨大版本硬塞多半报错。
- 不要直接修改 node_modules 里的皮肤源。 你下次升级就被覆盖了，应该按 README 说明在皮肤扩展目录里覆盖。
- 图标与字体遵循仓库内打包好的版本。 自己外链图床，外网一加载失败整套皮都花了。
- 二次创作请保留原作者的署名信息。 这是协议里强制的一条，省了这条一切都白做。
现在就能动手
打开 Releases 页，按你的 DSH Web 版本下载最新皮肤包；下载完成直接跑构建脚本，确认 themes.json 里已经把「deep-whale」勾上；最后按 README 的对照说明核对一遍图标、字体、示例文案是否同时被替换。 跑通这一套大约十几分钟，把皮肤合进自己的 DSH 实例就能立刻生效。顺手在 Releases 里把项目加入 Watch，作者后续出新皮肤你也能第一时间收到。