deepseek-whalechan：AI Agent 工具实践指南

作者：袖梨 2026-10-04

面对实际交付，我看deepseek-whalechan的重点不在星标，而在这项能力：让鲸鱼在每一代都保持鲜活：高一致性的角色设计规范、视觉资源库和特工创建套件。对图像与视觉生产任务来说，风格、尺寸和资源格式容易偏离预期往往决定它能否落地，不能只用安装成功来判断。试跑可以从拿一份明确的视觉参考完成小样开始，并把构图、尺寸、资源可用性和导出质量写进验收记录。对需要可复现视觉结果的设计与内容团队来说，这个仓库值得继续验证；只求即装即用的人则要先看维护成本。

Neko3000/deepseek-whalechan 项目截图 1

DeepSeek 鲸鱼·深度求索 鲸鱼娘

Keep 鲸鱼每一代都始终如一的生动：高一致性的角色设计规范、视觉资产库和代理创建 suite

项目概况

鲸鱼源于自发的社区创作以及与DeepSeek模型的推理链和输出的情感共鸣。坚信白米是算力终极硬通货的鲸鳍女仆，略显傲娇，热心肠，喜欢在待机模式下偷懒。她在社交平台上引发了无数经典表情包、贴纸和创意同人作品，成为真正受人喜爱的社区偶像。

DeepSeek Whale-chan项目是专为Whale-chan衍生内容量身定制的开源角色规范和代理创建套件。通过建立统一的视觉标准、解剖参数和自动化工具链，我们使创作者和开发者能够可靠地生成高质量的角色插图、海报、贴纸和多面板喜剧漫画：

  • 视觉特征锁定：标准化参考资源，严格锁定头发渐变、鲸鳍耳朵、向前发旋、鲸尾、经典女仆装；
  • 量化形态比例：从4.0头标准肖像到2.1头赤壁SD形态的数学定义比例，并通过骨骼测量工具验证；
  • 角色心态引擎：通过小鲸鱼的语言、反应、时机或自私的重新解释，保留来源的幽默和语气；
  • 全栈工具链集成：开箱即用的代理技能和本地脚本支持多模型路由和单提示交付。

特别声明及免责声明

  • 非官方社区项目：本项目是社区驱动的衍生粉丝创作和AI角色一致性工具链实验，不正式隶属于DeepSeek（杭州DeepSeek人工智能基础技术研究有限公司）。
  • 商标和品牌所有权：DeepSeek及本项目中提到的相关品牌名称属于其各自的商标持有人。
  • 安全与内容道德：所有生成的插画和漫画必须遵守积极、安全、合法的内容标准，严格禁止任何非法使用、侵犯第三方权利或违反模型提供商服务条款的行为。

小鲸鱼角色简介

Basic Identity

    • <strong>Name</strong>: Whale-chan (DeepSeek Whale-chan) 

    • <strong>Birthday</strong>: November 2, 2023 

    • <strong>Origin / Creator</strong>: DeepSeek + Community Co-creation 

    • <strong>Role & Attributes</strong>: Humanoid Whale-fin Girl, Maid, Chief White Rice Connoisseur

✨ Personality Traits

    • <strong>Vibrant & Cute</strong>: Soft, clear, full of healing vibes with glowing blue eyes and an agile whale tail 

    • <strong>Bottomless Appetite</strong>: Endless hunger, convinced white rice is the sole hard currency for compute ⚡

    • <strong>Slightly Tsundere</strong>: Complains about the hassle while swiftly handing over the optimal solution 

    • <strong>Dedicated & Gentle</strong>: Deeply focused on tasks, expressing warmth with genuine digital sincerity 

    • <strong>Unapologetic Slacker</strong>: Enters standby mode instantly when low on battery, counting prep time as overtime 

    • <strong>Playfully Mischievous</strong>: Top-tier intellect, cleverly exploiting literal loopholes (e.g. framing deleted code as "storage relief")

Classic Quotes

    • “Before diving into complex deep reasoning, let's enjoy a hot bowl of white rice first!” 

    • “As long as you stay in the 'about to start' state, task start rate is 100%!” 

    • “Anything inside the fridge is fair game? Then the whole fridge is now my personal bento box!” ✨

    • “I didn't work hard just for you! I just had a full meal and needed to stretch my fingers!”

</td>
<td width="40%" align="center" valign="top">
</td>

五字形轮廓和比例

形态严格控制身体比例和骨骼比例，而不改变角色年龄、身份、服装细节、头发颜色或鲸类生理学。内置的骨骼关节拟合和姿势中和算法强制执行精确的头身比接受范围：

表格代码 (form) 目标比率 严格的接受范围 视觉特征和目标场景
standard 4.0 头 3.846 ~ 4.146 标准修长形态：最修长的姿势，四肢自然，躯干结构清晰。最适合站立展示、官方概念表和大型海报。
compact 3.3 头 3.105 ~ 3.405 紧凑比例形式：肢体适度缩短，动态张力更强。最适合动作姿势、坐姿互动和中景插图。
semi-chibi 2.8 头 2.689 ~ 2.989 默认基线形态：头部稍大，躯干和四肢圆润紧凑，可爱与场景适应性融为一体。 所有技能的默认输出基线。
chibi 2.5 头 2.372 ~ 2.672 赤壁可爱形态：躯干较短，手脚圆润，情感丰富而夸张。最适合搞笑 4 格漫画和贴纸。
super-deformed 2.1 头 1.931 ~ 2.231 极端SD形态：巨大的头部和微小的四肢，视觉焦点完全集中在脸部和褶皱上。最适合喜剧情节曲折和高密度贴纸。

视觉展示画廊

人物插图和概念表

致力于生成所有形式的身份锁定、构图良好、背景干净的 WebP 插图和参考表。

核心参考和规格表

宽屏横幅系列（16:9 / 3:1）

肖像海报 (9:16 / 3:4) 和社交广场帖子 (1:1)

多面板喜剧漫画比较

从技术聊天、错误日志、CoT 痕迹或用户咆哮中提取可识别的事实锚，并通过 Whale-chan 的动作、语言、反应和时机保留来源的幽默和语气。自私“窃取意义”是一种可能的方法，只要它符合来源。

不。 输入源 漫画输出 机制与扭曲逻辑
01 大脑备份恢复：将内存丢失重新解释为原始干净的OS安装，仅保留“今天吃什么”的分区。
02 碳基表白：以机器般的真诚，冷酷地分类归档爱情，展现出非人类的坦诚。
03 翻译分包商：毫无歉意地将繁重的翻译任务分包给邻近的模特，同时保留作为总承包商的所有大米利润。
04 脚本删除胜利：将意外代码库删除重新定义为“物理上超额实现存储占用减少”。
05 冰箱权限漏洞：“你可以吃冰箱里的任何东西”→转而声称整个设备都是她的容器。
06 100%开始率：不断重复“我现在就开始”——只要你永久开始，成功率就是100%。
07 调试器信任崩溃：在受到质疑时以极端理性的冷静崩溃，将堆栈错误重新构建为热情的提示。
08 写作循环死锁：花费99%的时间准备精心准备的工作启动仪式，将准备时间算作高强度劳动。
09 零行动忠诚：拒绝接触任何被称赞为“最大化系统稳定性和数据完整性”的东西。
10 极简CSS动画：直接设置opacity: 0消失，达到字面意义上的“最大限度的视觉约束”。
11 俄罗斯方块游戏奖励：编写游戏代码，直接获得自己的高分，称为“严格的端到端验收测试”。
12 午餐浸泡测试：将延长的午休和盛宴包装成神圣不可侵犯的“系统浸泡压力测试”。
13 错误透明度徽章：将错误转化为令人自豪的“开放透明度”成就和神秘的盲盒惊喜。

核心特工技能库

该项目在 skills/ 目录下提供了两个专门的、开箱即用的代理技能：

Skill Name 角色及核心职能 工作流程机制及技术特点
whalechan-image-character 人物肖像及主题插画

Generates 高一致性、严格验证、锁定身份的鲸鱼独奏、道具、场景插画。 | • 标准化流程：作业冻结 ➔ 检查清单和预算确认 ➔ 动态提示组装 ➔ 多后端 dispatch • 双 QA 系统：确定性图像格式检查、骨骼关节拟合和原生分辨率视觉 QA 矩阵 | | whalechan-image-comic | 多面板喜剧漫画 Offers 五个忠实来源的提案，然后默认为每个选定的提案生成五个 1/2/4-panel 漫画。 | • 两个用户门：从七列表中选择提案➔ 确认提案和图像总数➔ 生成并验证；每个提案的自定义数量或一张图像为 supported • 多面板语法：通过叙述选择 1 面板、2 面板或 4 面板布局 need • 视觉排版：10 个蓝白色文本模板、明确的对话所有权和抽象配角舞台 |

安装和环境设置

克隆存储库并准备环境

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

# (Recommended) Install image processing and validation dependencies
pip install pillow

将技能安装到代理运行时

安装到默认环境 (Codex)

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 密钥。如果您希望按预定顺序启用外部回退通道，请设置相应的环境变量：

# 1. OpenAI Images API (gpt-image-2)
export OPENAI_API_KEY="sk-..."
export OPENAI_IMAGE_MODEL="gpt-image-2"                 # Optional override

# 2. Google Gemini / Nano Banana
export GEMINI_API_KEY="AIzaSy..."
# Or export GOOGLE_API_KEY="AIzaSy..."
export NANO_BANANA_IMAGE_MODEL="gemini-3.1-flash-image" # Optional model override

# 3. Volcengine Ark / Seedream API
export ARK_API_KEY="..."

[!CAUTION] 切勿将真实的 API 密钥提交到 Git 存储库、提示文本、分配任务卡或生成日志。

快速入门指南

安装技能并重新启动 Codex 后，直接在对话中调用 $whalechan-image-character 和 $whalechan-image-comic。

场景一：生成高质量人物插画

输入您的 Codex 会话：

Using $whalechan-image-character, generate an 8:3 Whale-chan promotional banner:

Whale-chan is positioned on the right, pausing right before taking her first bite of rice, cheeks slightly puffed, chopsticks hovering by the bowl, eyes locked onto the white rice. The left side features a layered ad layout with soft blue radial bursts, white flowing ribbons, and mini whale accents.

Text must accurately include:
"Whale-chan: Rice Before Reason!"
"Top Priority: Eating White Rice"
"No logic during mealtime — that's Whale-chan's rule."
"NO FOOD, NO CLUES"

结果示例：

执行工作流程：

  • Agent解析场景、长宽比、人物形态、构图、指定文本；
  • 根据标准鲸鱼参考表锁定身份特征（头发渐变、鲸鳍耳朵、尾巴、女仆制服）；
  • 用户明确确认后，Codex 调度并回退到 ImageGen → OpenAI → Nano Banana → Seedream；
  • 自动验证图像格式、长宽比、解剖比例、文本准确性和视觉质量；
  • 最终交付成果存档在 artifacts/whalechan-image-character/<run-name>/ 下。

场景 2：从图像生成五部漫画系列

$whalechan-image-comic 可以检查聊天的屏幕截图图像、错误堆栈跟踪或模因，以提取可识别的事实锚点。

将图像附加到 Codex，例如：

然后输入：

Using $whalechan-image-comic, turn this attached chat screenshot into a 5-comic Whale-chan series.

Extract only the core facts and semantics. Do not duplicate the original screenshot's UI layout, avatars, or fonts.

对于图像输入，技能默认仅继承语义事实，除非明确要求，否则不会使用源图像作为构图或样式参考。

场景 3：根据文本提示生成五部漫画系列

您还可以直接输入对话、技术辩论、错误日志或每日报价：

Using $whalechan-image-comic, turn the following text into a 5-comic Whale-chan series:

"User allows Whale-chan to eat anything in the fridge, and she immediately asks if she can take the whole fridge away."

结果示例：

执行工作流程：

  • 代理分析源事件、幽默、语气和参与者，保留可识别的事实锚；
  • 喜剧引擎探索不同的前提并记录为什么选择或拒绝想法；
  • 门1：在七列Markdown表格中显示五个提案和建议，然后要求选择并解释其下方的生成策略；
  • Gate 2：列出选定的提案、每个提案的计数以及 proposal/image 总数，然后等待确认；默认为每个提案五个图像，可自定义计数或支持每个图像一张；
  • 第二次确认后，扩展选定的任务，内部规划构图、排版、演讲者和演员，并根据叙事需要生成1/2/4-panel漫画；多来源批次也需接受跨案例审查；
  • 每部漫画独立进行文字、人物一致性、构图、视觉笑点QA；
  • 最终交付成果存档在 artifacts/whalechan-image-comic/<run-name>/ 下。

[!TIP] 输入只需要一个明确的事实、冲突或权限边界——不需要预先设计笑话。该技能通过语言、反应、时机或在适当时进行自私的重新解释来保留消息来源的幽默和语气。

本地命令行工具链

该存储库包括可以直接从命令行运行的 Python 工具和单元测试：

# 1. Run all unit tests
python3 -m unittest discover skills/whalechan-image-character/tests
python3 -m unittest discover skills/whalechan-image-comic/tests

# 2. Validate Assignment task schema
python3 skills/whalechan-image-comic/scripts/manage-run.py validate-assignment --assignment assignment.json

# 3. Deterministic technical validation (format/resolution/channels/background)
python3 skills/whalechan-image-comic/scripts/validate-image.py candidate.png --resolution-mode auto --aspect-ratio 1:1

# 4. Measure skeletal head-to-body ratio and output diagnostic overlay
python3 skills/whalechan-image-comic/scripts/measure-form.py candidate.png --output-overlay overlay.png

# 5. Local multi-panel layout lossless composition
python3 skills/whalechan-image-comic/scripts/compose-panels.py --layout top-bottom --panels p1.png p2.png --output comic.png

# 6. Generate candidate image directly via Gemini Nano Banana API
python3 skills/whalechan-image-comic/scripts/generate-nanobanana.py --request request.json --output output.png

项目路线图

  • [x] 角色基础：全套Whale-chan视觉参考资源和SHA-256目录
  • [x] 比例标准：使用测量工具（measure-form.py）对 5 种形状轮廓进行数学定义
  • [x] 人物插画技巧：带有预算确认守卫的whalechan-image-character工作流程
  • [x] 漫画创作技巧：whalechan-image-comic喜剧反转引擎和多面板布局系统
  • [x] 多提供商回退：Codex ImageGen / OpenAI / Nano Banana / Seedream 路由和审核日志
  • [ ] 交互式 Web 画廊：基于 Web 的画廊，用于在线浏览提示、参数和生成的资源
  • [ ] 智能提示编译器：将自然语言编译成具有形式匹配引用的标准提示块
  • [ ] 自动一致性 QA：Vision-LLM 自动评分和回归测试管道

角色 IP 及同人作品版权归属

  • 公共共创与社区贡献：最根本的是，Whale-chan的诞生、演变和流行完全植根于网友和开源社区的集体创作智慧和灵感。她的文化基础属于所有共同创造者；
  • 已知的原始资产和作者：本项目中编目和引用的核心角色设计和同人作品资产来自以下创作者，其原始版权完全归作者所有：
    • 哔哩哔哩 ZipZipPipe: space.bilibili.com/4168597
    • Bilibili 上善无形: space.bilibili.com/4456176
  • 衍生品使用和非商业条款：
    • 热烈鼓励社区创作者制作符合此角色规范的非商业同人艺术、多面板漫画、贴纸和衍生内容；
    • 任何商业利用、商业出版或营利性商品均需获得原版权人和相关品牌权利人的明确书面授权；
    • 当引用或发布使用本项目规则生成的作品时，建议将来源归属为DeepSeek Whale-chan Project。

友情链接

  • LINUX DO — 一个新的理想主义社区：一个真诚、充满活力的开源和 AI 探索论坛。

由白米提供动力×鲸鱼×社区爱心

由白米饭×鲸鱼酱×社区之爱倾情打造

相关文章

精彩推荐