鲸鱼娘桌宠 pokerface-1224/deepseek-whale-girl-pet

鲸鱼娘桌宠 (DeepSeek Whale Girl Pet)

专为 DeepSeek Harness 打造的 Windows 原生桌面宠物插件。把鲸鱼女仆带到你的桌面，支持多种交互动作，还有一块与 DeepSeek Harness 实时同步的迷你操作面板。

✨ 核心特性

- 轻量原生桌面伴侣：基于 Windows 分层窗口实现像素级透明与点击穿透，支持自由拖动、贴边停靠与多视角切换（正面/侧面/背面）。
- 丰富互动与微表情：摸头互动、待机打瞌睡、沉思、摸鱼等多种生动动作状态。
- 文件投喂：把本地文件拖到角色本体，文件移入回收站，同时播放进食立绘、弹跳与爱心效果，恢复饱腹值。
- 迷你 Web 面板 (WebView2)：右键一键呼出迷你面板，轻量快捷交互。
- 多端会话双向同步：迷你面板与 DeepSeek Harness 主窗口之间双向实时同步激活会话，换端操作无缝衔接。
- 生命周期协同：随 DeepSeek Harness 自动托管启停，单实例互斥保护。

🛠️ 系统要求

- 操作系统：Windows 10 / 11 (x64)
- 运行环境：
- .NET Framework 4.6.2 及以上（Windows 系统内置）
- Microsoft Edge WebView2 Runtime（Windows 10/11 通常已内置）
- 宿主程序：DeepSeek Harness

🚀 安装与使用

作为 DeepSeek Harness 插件使用

1. 把本项目目录放进 DeepSeek Harness 插件目录，或以私有插件引入。
2. 在对应 profile 的配置中启用 @local/dsh-pet-whale。
3. 启动 DeepSeek Harness，桌宠会自动在屏幕右下角唤起。

常用操作

| 操作 | 响应 |
| 左键拖拽 | 移动桌宠位置并自动保存坐标 |
| 拖入文件 | 松开即将文件移至回收站并投喂，支持多选；每个成功回收的文件恢复10点饱腹值 |
| 左键双击 | 摸头互动并恢复默认正面立绘 |
| 鼠标右键 | 唤出快捷菜单（切换视角、动作状态、暂时隐藏、置顶设置等） |
| 打开迷你面板 | 右键菜单选择“打开迷你面板”，快捷唤出与主端同步的对话窗口 |
| 召唤/重新唤醒桌宠 | 侧边栏图标：点击 Harness 左下角鲸鱼娘专属图标斜杠命令：输入 /whale-girl 并回车全局快捷键：按下 Alt+W |

文件投喂与饱腹值

只接受本地普通文件，不接受文件夹、网络路径、链接或文本；落点必须在角色本体上，透明背景、气泡、阴影和爱心都不触发。拖放直接回收，无需确认，可从 Windows 回收站还原。无法回收或被占用的文件保留在原处，只有成功项恢复饱腹值，失败数量通过气泡或托盘通知反馈。

饱腹值初始60，上限100；运行期间每累计5分钟减少1点，隐藏时继续计时，关闭和系统休眠期间不扣减。数值和未满5分钟的累计时间保存在 pet-prefs.txt。右键菜单可查看当前数值；满腹时仍可投喂，文件继续回收。成功后显示约3秒进食立绘，关闭气泡台词也会播放动效，结束后恢复当前工作或待机状态。

💻 本地构建与测试

如需二次开发或重新编译原生程序：

编译 C# 原生桌宠程序 (WhalePet.exe) & ./desktop-pet/tools/build-desktop-pet.ps1

执行静态包结构校验
node tools/check_package.mjs

执行会话同步机制单元测试
node tools/test_sync.mjs

HTTP 鉴权、来源检查及同步连接过期处理
node tools/test_auth.mjs

校验客户端入口与原生进程确认协议
node tools/test_client.mjs
node tools/test_native_host.mjs

中文用户名、JSON 转义与原生账号菜单显示 & ./tools/test_account.ps1

饱腹值、偏好兼容、角色落点与进食效果测试（独立测试目录） & ./tools/test_feeding.ps1

实际回收、异步多文件投喂和回收站还原测试，仅处理测试新建文件 & ./tools/test_feeding.ps1 -Recycle

Windows：实际启动桌宠，验证隐藏后唤醒与重复实例唤醒
node tools/test_native_host.mjs --native

隐私与接口认证

桌宠 HTTP 接口复用 Harness 的 connection.admit() 校验认证 Cookie、Host 和请求来源，包括账号接口和 SSE 会话同步。未认证请求返回401，不可信来源返回403；认证服务不可用时拒绝请求。主窗口与迷你面板通过 Harness 的正常认证流程获得 Cookie，无需另设插件密码。同步连接在凭据失效时关闭，接口不允许任意跨域访问。账号菜单优先显示昵称，没有昵称时显示脱敏手机号或邮箱（如 138*0000、a@example.com）；账号快照只发送显示名，不返回原始联系方式字段。

🎨 鸣谢与署名 (Credits)

- 鲸鱼娘角色原作者：上善
- 鲸鱼娘二次设计 / 立绘制作：zipzippipe
- 项目维护与工程开发：pokerface-1224

特别鸣谢原作者 上善 与二次设计作者 zipzippipe 创作的生动可爱的鲸鱼娘形象！

📄 开源许可证

本项目采用分项许可协议：

- 代码部分：基于 MIT License 许可证开源。涵盖所有源代码、配置、编译构建脚本与底层通信实现。
- 美术与角色图像素材：涉及「鲸鱼娘」形象的所有角色立绘、动作素材、应用图标及预览图（包含 desktop-pet/art/ 目录下的所有图像素材、icon.png 等）采用 CC BY-NC-SA 4.0（知识共享 署名-非商业性使用-相同方式共享 4.0 国际许可协议） 授权。
- 角色原作者：上善
- 二次设计作者：zipzippipe
- 允许在非商业用途下免费使用、传播与二次创作；
- 二创或转载须保留原作者及二次设计作者署名，并以相同协议进行共享发布；
- 严禁任何商业盈利性用途。