像素鲸鱼桌宠 nannan0v0/whale-pet

🐳 鲸鱼桌宠 WhalePet

一只像素鲸鱼，住在你的桌面上。

它会自己漫游、会打盹睡觉、你点它一下会被吓一跳，鼠标放着不动它还会游过来找你。

纯 Windows PowerShell 写的，不用安装任何东西。

预览

✨ 它有什么

七个动作（帧动画）

| 动作 | 什么时候出现 |
| 游动 swim | 默认状态，自己满屏漫游 |
| 睡觉 sleep | 一阵子没变化，有概率睡着（冒 Z 泡泡 + 头顶 deepsleep）|
| 发现 find | 你点它、或者提醒触发时（冒感叹号）|
| 发呆 bored | 待机时按概率切换，呆呆地放空一会儿 |
| 转圈 twirl | 鼠标停 45 秒 → 游过来绕着你的光标转一圈，然后回常态 |
| 翻肚皮 flipbellyup | 按概率触发的入水动作，只播一次 |
| 漂着 bellyup | 紧接着上一个循环播放，点它才翻回来 |

它会做什么

- 自己在屏幕上漫游 —— 随机挑个地方游过去，歇一会儿再走
- 鼠标停 1 分钟没动 → 它游过来追你的光标（朝哪边游就翻转朝向）
- 鼠标停 45 秒没动 → 它游过来绕着光标转一整圈，转完还会说一句话
- 点它（醒着）→ 冒出一句说话气泡（你画的），同时吐几个泡泡
- 点它（睡着）→ 受惊！冒感叹号，然后醒过来
- 点它（正在转圈）→ 停下
- 点它（翻着肚皮）→ 翻回来继续游
- 待机的时候 → 偶尔发呆、偶尔翻肚皮漂着、偶尔自言自语一句
- 拖它 → 挪到屏幕别的地方
- 右键 → 菜单（番茄钟 / 退出）

两个实用小功能（纯本地，不联网）

- ⏱ 番茄钟 —— 右键开始 25 分钟。计时期间它会睡觉陪你一起专注，到点把你叫醒
- 🧍 起身提醒 —— 每 60 分钟提醒你起来活动一下

🚀 怎么用

1. 点右上角绿色的 Code → Download ZIP
2. 解压到任意文件夹
3. 双击 Start.cmd ← 就是它

就这样 —— 不会留黑窗口，鲸鱼直接出现在你桌面上 ✓

Start.cmd 是干嘛的？
Windows 默认把 .ps1 文件关联到记事本 ✗ —— 所以双击 WhalePet.ps1 只会打开代码，不会运行 ✗ Start.cmd 就是替你把这件事做对：正确启动脚本，并且不留黑窗口 ✓

系统要求：Windows 7 以上，用系统自带的 PowerShell 就行 —— 不需要装 Python、不需要装 .NET、不需要联网。

怎么退出

右键鲸鱼 → Quit ✓

如果双击 Start.cmd 没反应

用这个能看到报错（会多一个黑窗口，方便排查 ✓）： 右键 WhalePet.ps1 → 使用 PowerShell 运行

如果提示"执行策略"限制，打开 PowerShell 跑一次这条，再双击： Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

🎨 想换成自己的形象？

不用改任何代码。 把 images/ 里的图换掉就行，文件名按下面的规则取：

| 文件名 | 会被当成 | 说明 |
| swim1.png swim2.png … | 游动帧 | 想画几帧就几帧，数字按顺序 |
| sleep1.png sleep2.png … | 睡觉帧 | 同上 |
| find1.png find2.png … | 发现帧 | 同上 |
| bubble-z.png | 睡觉的 Z 气泡 | |
| bubble-pop1.png bubble-pop2.png | 普通泡泡 | 可以有更多张 |
| bubble-excl.png | 感叹号气泡 | |
| speech-say1.png speech-say2.png … | 点击时显示的说话气泡 | 多张就随机挑一张 |
| speech-sleep.png | 睡觉时头顶挂的那句 | |
| speech-standup.png | 起身提醒时 | |
| speech-pomo.png | 番茄钟结束时 | |
| bored1.png bored2.png | 发呆（待机时随机出现）| 2 帧 |
| twirl1.png … twirl6.png | 转圈（追着鼠标绕圈，或原地打转）| 6 帧，点它停下 |
| flipbellyup1.png … flipbellyup6.png | 翻肚皮的入水动作 | 6 帧，只播一次 |
| bellyup1.png … bellyup6.png | 翻着肚皮漂着（循环播放）| 6 帧，点它翻回来 |

规则就两条：
1. 同一个动作的多帧，数字要按顺序（swim1 → swim5）
2. 气泡文件名里要带 bubble，说话气泡要带 speech —— 否则会被当成鲸鱼帧

为什么文件名要用英文？
脚本本体是纯英文写的。Windows PowerShell 5.1 读没有 BOM 的脚本时会用系统默认编码解码，一旦脚本里有中文就会整篇乱码 —— 连"按关键词找图片"都会失效。
所以把中文全部放在这份 README 里，脚本保持纯英文，在任何机器上都不会乱 ✓

图片格式：PNG / GIF / BMP / JPG 都行，透明底 PNG 最好，像素画效果最佳（脚本用最近邻放大，像素不会糊）。

建议：同一个动作的所有帧用同一张画布尺寸，动画播放时位置才不会跳。

图片缺失也不会崩 —— 没找到图的话会画一个方块顶着，让你知道脚本还活着。

可调参数

打开 WhalePet.ps1，最上面一段全部可以改：

大小与窗口 $script:PetSize = 150 # 鲸鱼多大 $script:TopPad = 130 # 头顶留白（放说话气泡用） $script:SpeechDropY = 80 # 说话气泡往下推多少像素

帧率（每帧毫秒 = 这个数 x 50，数字越小动画越快） $script:SwimEvery = 3 # 游动 $script:SleepEvery = 25 # 睡觉（慢呼吸） $script:FindEvery = 2 # 发现 $script:BoredEvery = 12 # 发呆 $script:TwirlEvery = 1 # 转圈 $script:FlipEvery = 6 # 翻肚皮入水（只播一次） $script:BellyEvery = 6 # 翻肚皮漂着（循环）

移动 $script:RoamSpeed = 3 # 平常漫游速度（像素/跳） $script:ChaseSpeed = 6 # 追光标的速度 $script:FindSpeedMul = 2 # "发现"期间移动快几倍 $script:TwirlSpeed = 8 # 转圈时滑过去的速度 $script:TwirlOrbitR = 95 # 绕圈半径 $script:TwirlOrbitStep = 0.08 # 绕圈快慢（越大越快，约 4 秒一圈） $script:TwirlLaps = 1 # 绕几圈

触发概率（每 5 秒掷一次骰子） $script:SleepChance = 3 # 睡着 $script:BoredChance = 18 # 发呆 $script:BellyChance = 5 # 翻肚皮 $script:TwirlChance = 0 # 随机转圈（0 = 关；下面那条才是转圈的主开关） $script:TwirlIdleMs = 45000 # 鼠标停多久 → 游过去转圈 $script:IdleSpeechChance = 8 # 待机时自言自语的概率

提醒与台词 $script:MouseIdleMs = 60000 # 鼠标停多久 → 追过来 $script:StandUpMs = 3600000 # 起身提醒间隔（1 小时） $script:PomoMinutes = 25 # 番茄钟时长 $script:IdleSpeechFile = 'speech-say4' # 待机时说的是哪句 $script:TwirlSpeechFile = 'speech-say7' # 转圈结束时说的是哪句

🔒 安全说明

这个脚本故意做得很保守：

- ❌ 不联网 —— 一行网络请求都没有
- ❌ 不要 API Key —— 没有账号、没有密钥、没有配置文件
- ❌ 不读个人路径 —— 所有图片都从脚本自己所在的文件夹找
- ❌ 不下载、不执行任何外部东西（没有自动更新）
- ✅ 唯一的系统访问：读一下 C 盘剩余空间（用在磁盘提醒上，可在代码里关掉）

想加"API 余额显示"这类联网功能的人注意：那需要你的密钥，千万不要写进要公开的脚本里。
正确做法是把密钥放在本地一个被 .gitignore 忽略的文件里，脚本从那里读。

❓ 常见问题

双击没反应？ 双击 Start.cmd ✓（不是 WhalePet.ps1 ✗ —— 双击那个只会用记事本打开 ✓）还是不行 → 右键 WhalePet.ps1 → 使用 PowerShell 运行，这样能看到报错 ✓

Windows 弹出「已保护你的电脑」或者杀毒软件报警？ 点 「更多信息」→「仍要运行」 ✓ 原因有两层：① 文件是从网上下载的，Windows 一律会拦一下 ✓ ② Start.cmd 是「隐藏窗口启动 PowerShell」—— 这恰好是杀毒软件比较敏感的那类行为 ✗ 属于误报 ✓ 想自己确认安全：右键 Start.cmd → 编辑 ✓ 里面只有几行命令，一眼能看完 ✓ （这个脚本不联网、不下载、不读个人文件 ✓ 详见下面的「安全说明」✓）

只有个蓝色方块，没有鲸鱼？ 说明 images/ 里没有能被识别的图。检查两件事：图片是不是放在 images/ 文件夹里、文件名有没有按上面的规则取。

鲸鱼跑哪去了？ 它可能在屏幕别处漫游 —— 等它游回来，或者用鼠标把它拖回来。

它会不会挡着我点东西？ 不会。窗口的透明区域是点击穿透的，只有鲸鱼本身能点到。

怎么退出？ 右键鲸鱼 → Quit ✓（用 Start.cmd 启动的话，不会留黑窗口 ✓）

🙌 制作

- 像素图 / 动画 / 角色设计 / 测试：nannan0v0 —— 每一帧、每个气泡都是手画的
- 代码：与 AI 助手（DeepSeek Harness）协作完成；需求、设计决定和验收全部由作者把关

这是非官方同人作品，与 DeepSeek 官方没有隶属或合作关系。

📄 许可

MIT License —— 随便用、随便改、随便商用，保留署名就行。

English (short)

A pixel whale desktop pet for Windows, written in plain PowerShell — no install needed. Double-click Start.cmd to run it. (Windows opens .ps1 files in Notepad by default, so running the script itself needs a right-click → Run with PowerShell.)

It roams your screen on its own, takes naps, follows your cursor when you go idle,
says something when you click it, and gets startled awake if you poke it while it sleeps.
Also includes a Pomodoro timer and an hourly stand-up reminder.

Drop your own art into images/ and name the files after the action
（swim / sleep / find 用于帧，bubble- 用于气泡，speech- 用于文字气泡）——不用改代码。

不联网。不要 API key。不上报遥测。 只有一头鲸鱼。