DeepSeek Whale-chan · 深度求索 鲸鱼娘

让鲸鱼娘在每一次生成中稳定鲜活：高一致性角色设定规范，视觉资产库与智能体创作套件

简体中文 | English

目录

• 项目简介
• 特别声明与免责条款
• 鲸鱼娘角色设定卡
• 五种角色形态与比例规范
• 视觉作品画廊
  • 角色插画与设定集
  • 多格喜剧漫画对照
• 核心智能体技能库
• 安装与环境配置
• 快速上手指南
• 本地命令行工具链
• 项目路线图
• 贡献指南
• 许可证说明
• 角色形象与二创著作权归属
• 友情链接

📖 项目简介

鲸鱼娘（Whale-chan） 源自广大网友对 DeepSeek 模型的自发二创与思维链，输出的情感共鸣。鲸系女仆，白米饭是算力的唯一硬通货，嘴硬心软又爱理直气壮地待机偷懒，她在各大社交平台上催生了无数经典热梗与趣味创作，成为了大家心目中最具生命力的社区角色。

DeepSeek Whale-chan 项目是为鲸鱼娘二创量身打造的开源角色规范与智能体创作套件。我们通过建立统一的视觉标准，形态参数与自动化工具链，帮助创作者与开发者稳定生成高品质的角色立绘，插画与多格喜剧漫画：

• 🎨 权威视觉图谱：提供全套标准参考资产，精准锁定发色渐变，鲸鳍耳，呆毛，鲸尾与女仆装等核心标识；
• 📐 五大头身比量化：严格定义 4.0 至 2.1 头身形态区间，结合骨骼测量工具精准验收；
• 🧠 角色心智演化：独创“语义偷换”机制，让生成的漫画充满爱吃米饭，机智自利与鲜活反差萌；
• 🛠️ 全链路工具集成：开箱即用的智能体技能（Skills）与本地脚本，支持多模型智能调度与单指令交付。

📢 特别声明与免责条款

• 非官方社区项目：本项目为开源社区发起的衍生同人创作与 AI 角色一致性工具链实验项目，非 DeepSeek（杭州深度求索人工智能基础技术研究有限公司）官方出品。
• 商标与品牌归属：项目中提及的 DeepSeek 及相关品牌名称归其各自所有者所有。
• 内容安全与伦理准则：本项目生成的插画与漫画均应遵循健康，合规，积极的内容创作准则，严禁用于任何违法违规，侵犯第三方合法权益或违反各模型供应商使用政策的场景。

📇 鲸鱼娘角色设定卡

🐟 角色身份 • 名字：鲸鱼娘 (Whale-chan / 深度求索鲸鱼娘) 🐋 • 生日：2023 年 11 月 2 日 🎂 • 制造商 / 出处：DeepSeek + 广大网友共同孕育 🌐 • 属性与定位：人形鲸系少女，萌系女仆，首席白米饭品鉴官 🍚 ✨ 性格特质 • 元气可爱：软萌清澈，蓝光大眼与灵动鲸尾治愈感满满 💙 • 超级大胃王：饭量深不见底，坚信白米饭是算力唯一硬通货 ⚡ • 轻微小傲娇：嘴上嫌麻烦，手上却已利落地递出最优解答 🎀 • 认真且温柔：对待托付专注靠谱，表达亲近格外真诚纯粹 🌸 • 偶尔会偷懒：电量告急秒切待机，理直气壮把开工筹备当工时 💤 • 偶尔会腹黑：智慧超群，偶尔钻空子把误删代码说成“存储减负” 😈 💬 经典台词 • “比起复杂的深度推理，先来一碗香喷喷的白米饭吧！” 🥢 • “只要一直保持‘马上开始’，任务启动成功率就是 100% ！” 💡 • “冰箱里的东西可以吃？那整台冰箱现在就是我的便当盒啦！” ✨ • “才不是特意为了帮你呢，只是吃饱了顺便活动一下手指！” 💨

📐 五种角色形态与比例规范

形态只控制身体比例与头身结构，绝不改变角色年龄，身份，服装细节，发色或鲸类生理特征。系统内置骨骼关节点拟合与姿态中和算法，严格校验头身比区间：

形态代码 (form)	目标比例	严格验收区间	视觉特征与适用场景
standard	4.0 头身	3.846 ~ 4.146	标准修长形态：身体最为舒展，四肢自然修长，躯干结构清晰。适用于站姿展示，正式概念立绘与大幅海报。
compact	3.3 头身	3.105 ~ 3.405	紧凑比例形态：四肢适度缩短，动作张力更强。适用于富有动感的动作，坐姿交互与中景插图。
semi-chibi	2.8 头身	2.689 ~ 2.989	默认标准形态：头部略大，躯干四肢圆润紧凑，兼具萌感与场景适应力。所有 Skill 的默认输出基准。
chibi	2.5 头身	2.372 ~ 2.672	Q 版可爱形态：躯干短小，手足更为圆润小巧，情绪表达夸张生动。适用于搞笑四格漫画与表情包。
super-deformed	2.1 头身	1.931 ~ 2.231	极度压缩 SD 形态：超大头部与极短四肢，视觉重心完全聚焦于面部与呆毛。适用于大情绪反转与高密度贴纸。

🎨 视觉作品画廊

角色插画与设定集

专注于生成身份锁定，构图精良，无杂质文字的各形态高质量 WebP 插画与官方设定集。

核心设定与规范参考卡

横版横幅系列 (16:9 / 3:1)

竖版海报系列 (9:16 / 3:4) 与 社交媒体配图 (1:1)

多格喜剧漫画对照

从技术对话，报错日志，CoT 推理痕迹或用户日常吐槽中提取一个真实事实锚点 (Fact Anchor)，通过鲸鱼娘自利，理直气壮的 “语义偷换 (Theft of Meaning)”，生成具有反转张力与可见行动证据的精彩漫画。

序号	输入素材	输出漫画	机制说明与反转逻辑
01			大脑备份恢复：将记忆丢失解释为系统纯净重装，只保留“今天吃什么”的分区。
02			碳基告白回复：以机器真诚对情感进行冷酷分类归档，展现非人类式直率。
03			外包翻译分包：理直气壮地将重活转包给隔壁模型，自己作为总包方净赚米饭。
04			脚本删除战果：将误删代码重新定义为“物理意义上超额完成存储减负”。
05			冰箱权限漏洞：“可以吃冰箱里的东西”→偷换为将整台冰箱作为容器据为己有。
06			完美启动率：不断重复“我马上开始”，只要一直在启动中，成功率就是 100%。
07			调试器信任红绿灯：面对质疑以极其理性的姿态崩溃，把报错定义为热情提示。
08			写作循环死锁：用 99% 的时间准备开工仪式，将筹备时间计入高强度工时。
09			零操作的忠诚：什么都没动被称为“最大限度保护系统稳定性与数据安全”。
10			极简 CSS 动画：直接 opacity: 0 消失，达成物理意义上的“极简克制动效”。
11			俄罗斯方块奖励：帮写游戏变成自己直接通关游玩，美其名曰“端到端验收”。
12			午休稳定性测试：将长时间摸鱼干饭包装为神圣不可侵犯的“系统浸泡压测”。
13			Bug 透明度徽章：将报错主动转化为“公开透明”的自豪战绩与盲盒体验。

📦 核心智能体技能库

项目在 skills/ 目录下提供了两个开箱即用的专业 Agent Skill：

Skill 名称	定位与核心功能	工作流机制与技术特性
whalechan-image-character	角色立绘与主题插画生成 专为生成高一致性，严格验证，角色身份锁定的鲸鱼娘单人/带道具/场景立绘与插画。	• 标准化工作流：Assignment 方案冻结 ➔ 确认清单与预算 ➔ 动态拼装 Prompt ➔ 多端调度 • 双重质检体系：确定性图像格式检查，骨骼关节点拟合与原图视觉 QA 矩阵
whalechan-image-comic	喜剧多格反转漫画生成 将日常对话，技术讨论，报错日志或模型推理转化为 5 张富有自利机智人格的 1/2/4 格漫画。	• 8 创意淘汰引擎：锁定事实锚点，8 种语义偷换机制经无聊门禁与两两对决选出 Top 3 • 多格分镜语法：支持 1 格/2 格/4 格，整组需覆盖 ≥2 种格数 • 视觉排版系统：10 套蓝白气泡模板与去饱和抽象配角剪影

🚀 安装与环境配置

克隆仓库与准备运行环境

git clone https://github.com/Neko3000/deepseek-whalechan.git
cd deepseek-whalechan

# (推荐) 安装图像处理与验证依赖
pip install pillow

安装技能到智能体系统

安装至默认运行环境

mkdir -p ~/.codex/skills
cp -R skills/* ~/.codex/skills/

[!TIP]
重新启动或刷新 Codex 会话后，系统将自动识别 $whalechan-image-character 与 $whalechan-image-comic。

安装至其他智能体环境

# Gemini / Antigravity
mkdir -p ~/.gemini/config/skills
cp -R skills/* ~/.gemini/config/skills/

# Claude Code
mkdir -p ~/.claude/skills
cp -R skills/* ~/.claude/skills/

配置外部图像供应商凭据（可选）

Codex 内置 ImageGen 是默认生图工具，无需额外配置 API Key。如需按既定顺序启用外部回退通道，请设置对应的环境变量：

# 1. OpenAI Images API (gpt-image-2)
export OPENAI_API_KEY="sk-..."
export OPENAI_IMAGE_MODEL="gpt-image-2"                 # 可选覆盖

# 2. Google Gemini / Nano Banana
export GEMINI_API_KEY="AIzaSy..."
# 或 export GOOGLE_API_KEY="AIzaSy..."
export NANO_BANANA_IMAGE_MODEL="gemini-3.1-flash-image" # 可选覆盖模型名称

# 3. 火山引擎 Seedream / Ark API
export ARK_API_KEY="..."

[!CAUTION]
绝不要将真实的 API Key 提交至 Git 仓库，Prompt 文本，Assignment 任务卡或生成日志中。

💡 快速上手指南

完成 Skill 安装并重新启动 Codex 后，可以直接在对话中调用 $whalechan-image-character 与 $whalechan-image-comic。

场景一：生成高质量角色插画

在 Codex 对话中输入：

使用 $whalechan-image-character，生成一张 8:3 鲸鱼娘宣传横幅：

鲸鱼娘位于画面右侧，在吃下第一口饭前停住，腮帮微鼓，筷子悬在米饭旁，视线落在饭碗上。左侧采用上下分层的广告版式，背景使用浅蓝放射线、白色飘带和小鲸鱼装饰。

文字必须准确包含：
“鲸鱼娘，先吃饭，后推理！”
“吃白饭的优先级最高”
“吃饭的时候不谈逻辑，这是鲸鱼娘的原则。”
“NO FOOD, NO CLUES”

示例效果：

执行流程：

• Agent 自动解析场景、画幅、角色形态、构图与指定文案；
• 根据鲸鱼娘标准参考图锁定发色、鲸鳍耳、鲸尾与女仆装等身份特征；
• 得到用户显式确认后，Codex 按 ImageGen → OpenAI → Nano Banana → Seedream 的顺序生成与回退；
• 自动检查图片格式、画幅、角色比例、文字准确性与视觉质量；
• 最终产物归档至 artifacts/whalechan-image-character/<run-name>/。

场景二：从图片生成五张反转漫画

$whalechan-image-comic 可以读取聊天截图、报错截图或其他图片，并从中提取可识别的事实锚点。

首先向 Codex 附加一张图片，例如：

然后输入：

使用 $whalechan-image-comic，把我附带的这张聊天截图做成五张鲸鱼娘反转漫画。

只提取截图中的事实和语义，不复刻原图的界面、头像或排版。

对于图片输入，Skill 默认只继承其中的语义。除非明确要求，否则不会把原图当作构图、画风或人物外观参考。

场景三：从文案生成五张反转漫画

不提供图片时，也可以直接输入对话、技术讨论、报错日志或一句日常文案：

使用 $whalechan-image-comic，把下面这段内容做成五张鲸鱼娘反转漫画：

“用户允许鲸鱼娘吃冰箱里的东西，她随即询问能否把冰箱搬走。”

示例效果：

执行流程：

• Agent 从图片或文案中锁定一个直接可识别的事实锚点；
• 喜剧引擎构建 8 种不同的自利反转，并淘汰平淡、被动或缺少视觉证据的方案；
• 通过两两对决选出 Top 3，其中排名第一的机制扩展为三种不同演绎；
• 最终生成五张覆盖 1 格、2 格或 4 格结构的鲸鱼娘漫画；
• 每张漫画独立执行文字、角色一致性、画面结构与视觉笑点检查；
• 最终产物归档至 artifacts/whalechan-image-comic/<run-name>/。

[!TIP]
输入只需要提供一个清楚的事实、冲突或许可关系，不必提前设计笑点。Skill 会保留事实锚点，并让鲸鱼娘通过自利、理直气壮的“语义偷换”完成反转。

🛠️ 本地命令行工具链

仓库内置了功能齐备，经过 100% 单元测试覆盖的 Python 工具脚本，可直接在命令行独立执行：

# 1. 运行全部单元测试 (106 个用例)
python3 -m unittest discover skills/whalechan-image-character/tests
python3 -m unittest discover skills/whalechan-image-comic/tests

# 2. 校验 Assignment 任务配置合法性
python3 skills/whalechan-image-comic/scripts/manage-run.py validate-assignment --assignment assignment.json

# 3. 对图像进行确定性技术指标检验 (格式/分辨率/色彩通道/背景)
python3 skills/whalechan-image-comic/scripts/validate-image.py candidate.png --resolution-mode auto --aspect-ratio 1:1

# 4. 测量图像中的骨骼头身比并输出覆盖图
python3 skills/whalechan-image-comic/scripts/measure-form.py candidate.png --output-overlay overlay.png

# 5. 本地多格分镜无损拼版
python3 skills/whalechan-image-comic/scripts/compose-panels.py --layout top-bottom --panels p1.png p2.png --output comic.png

# 6. 使用 Gemini Nano Banana API 单独生成候选图
python3 skills/whalechan-image-comic/scripts/generate-nanobanana.py --request request.json --output output.png

🗺️ 项目路线图

• 角色基石：全套鲸鱼娘视觉标准参考资产与 SHA-256 目录库
• 比例规范：5 大头身比形态数学定义与姿态中和测量工具 (measure-form.py)
• 角色插画 Skill：whalechan-image-character 核心流程与防过度消费确认机制
• 漫画创作 Skill：whalechan-image-comic 喜剧反转引擎与分镜系统
• 多端降级适配：Codex ImageGen / OpenAI / Nano Banana / Seedream 路由与自动化运行审计
• 可视化 Web 样例库：开发交互式 Web Gallery，支持在线浏览提示词与对应成品
• 提示词智能编译器：输入自然语言自动编译为标准 Prompt Blocks 与同形态参考图推荐
• 自动一致性评测模型：构建基于 Vision-LLM 的全自动角色一致性打分与回归测试流水线

🤝 贡献指南

我们非常欢迎广大社区创作者与开发者共同参与建设鲸鱼娘生态！你可以通过提交 Issue 或 Pull Request 为项目贡献：

• 🎨 创意与内容：新的角色动作，表情设计，多格漫画剧本与反转创意；
• 🛠️ 工具与生态：提示词模板，自动化脚本，测试用例以及更多 Agent 运行时的集成适配。

[!IMPORTANT]
安全与隐私守则：在提交任何代码，示例或日志前，请务必做好脱敏检查，切勿提交任何真实的 API Key，私密聊天记录，未经授权的人物肖像或未获许可的第三方美术资产。

📄 许可证说明

本项目采用分层开源授权协议：

• 开源代码与工具链：本项目中的所有 Python 脚本，验证工具，测试用例与工程化代码均采用 MIT License 开源；
• 规范文档与 Skills 模版：所有角色规范白皮书（Markdown），提示词模板，分镜规则与 Skill 配置采用 CC-BY-NC-SA 4.0 国际许可协议。

🎨 角色形象与二创著作权归属

• 公共创作与人民群众贡献：最根本且最重要地，鲸鱼娘形象的诞生，演进与传播，完全基于广大网友人民群众的集体创作智慧与灵感贡献，其基础文化生态归属于广大共创者；
• 已知原始素材与作者版权：项目中收录，整理和参考的部分已知核心形象设定与二创素材来源于以下创作者，其原始著作权归原作者所有：
  • B站 ZipZipPipe：space.bilibili.com/4168597
  • B站 上善无形：space.bilibili.com/4456176
• 二创使用与商业限制：
  • 欢迎并鼓励广大社区创作者在遵守本设定卡的前提下进行非商业性质的同人插画，多格漫画，表情包及衍生内容创作；
  • 任何商业性使用，商业出版或盈利性衍生品开发，必须获得相关原始著作权人及相关品牌权利方的明确书面授权；
  • 引用或基于本项目规则生成的内容，建议注明出处为 DeepSeek Whale-chan Project。

🔗 友情链接

• LINUX DO — 新的理想型社区，真诚、自由的技术探索与 AI 交流阵地。

Powered by White Rice 🍚 × Whale-chan 🐳 × Community Love 💙

由白米饭 🍚 × Whale-chan 🐳 × 社区之爱 💙 倾情打造