VKmich16 / VK-1

# DSH 余额宠物 · Windows / macOS
贴在桌面上的小挂件：角色举着一块平板，实时显示你的 DeepSeek（DSH）余额。
余额每**下降 0.01 元**，她红闪 + 震动 + 播放打击音效，头顶飘出 `-0.01`，0.2 秒一次串成一条；
余额**上升（充值）**时，屏幕右侧掉下一盆米饭，把它拖到角色身上才一次性入账。
本仓库有**两个自研实现**（Windows / macOS），另有**社区维护的 DSH 网页插件版**和**独立网页嵌入版**，按你的环境选：
| 平台 | 当前版本 | 技术栈 | 说明 |
| --- | --- | --- | --- |
| 🪟 **Windows** | **v3** | PowerShell 5.1 + 内嵌 C# | 见下文「Windows 版」 |
| 🍎 **macOS** | **v1.3.1** | Swift + AppKit | 见下文「macOS 版」 |
| 🌐 **DSH 网页插件** · @YCTS-otree | 社区维护 | DSH bundle（JS） | 把 D-16BVM 移植进 DSH，支持与其它余额插件一键互切 |
| 🌐 **DSH 网页插件** · @TsukiKenga | 社区维护 | DSH bundle（JS） | 五角色可切换 · 扣费步长可配 · 6 路音效各自调节 |
| 🌐 **独立网页嵌入** | **v0.1.1** | 普通网页 JS + 可选 Python 余额服务 | 不依赖 DSH，可放进自己的网页，见下文「网页嵌入」 |
Windows 版与 macOS 版**互不依赖**，各自独立运行；都只访问 DeepSeek 官方接口，不联网上传任何数据。网页插件版是第三方移植，见下。
---
## 🌐 网页嵌入
这玩意也可以放进你自己的网页里：个人首页、导航页、监控面板都能用，不需要安装 DSH。角色默认待在网页右下角，保留喂饭、铁盆、火控雷达和扣费/充值动画；支持鼠标拖动、手机触屏拖动，电脑右键或手机长按打开菜单。
将构建产物部署到网站的 `/vk-1/`，再给页面加一行：
 [code] 
这是**网页内挂件**，不会跨应用浮在系统桌面上。透明区域不会挡住网页点击，拖动位置会记住。
需要显示真实余额时，可搭配同源余额服务；API Key 不写进网页脚本或 localStorage。构建、部署和测试方法见 网页嵌入说明。该实现基于 @YCTS-otree 的 MIT 社区网页版，独立放在 `integration/`，不修改 Windows/macOS 实现。
---
## 🪟 Windows 版
不需要安装、不需要管理员权限 —— 双击就能跑。用 Windows 自带的 PowerShell 5.1
现场编译内嵌的 C#，WinForms 无边框窗口 + 逐像素透明，透明区域鼠标穿透。
**v3 有三件好玩的：**
### 1. 她会换表情
四张脸，按当前状态自动切换：
| 表情 | 什么时候出现 |
| --- | --- |
| 😄 **开心** | 平时都是这张 |
| 😣 **紧张** | 正在扣费的时候（扣完还会保持 1 秒） |
| 😤 **傲娇** | 米饭盆放了 10 秒还没喂她 |
| 😐 **冷脸** | 铁盆扣在她头上的时候 |
铁盆在头上时**扣费她也保持冷脸**；只有新的米饭盆掉下来才会让她重新开心。
### 2. 铁盆：米饭盆的「后事」
米饭盆被她**吃掉**的地方，会掉出一个**铁盆**：
- 铁盆不值钱、也不能吃，纯玩具，随便拖
- **拖到她头上**（或者干脆扔到她头顶），它就会扣在她头上 → 她变冷脸，还会顶着盆一起抖
- **双击她的头** → 她弹一下，铁盆消失
- 同时只会有一个，不会越堆越多
### 3. 火控雷达：目标名牌
有米饭盆的时候，盆周围会出现一个《战争雷霆》风格的**绿色方括号 + 一排读数**：
| 读数 | 含义 |
| --- | --- |
| **距离** | 盆离她多远（单位 kpx） |
| **接近率** | 盆在靠近（正数）还是远离（负数） |
| **相对高度** | 正数 = 盆比她高，负数 = 比它低 |
| **方向环** | 一根指针，指向盆相对她的方位 |
> ⚠️ **米饭盆落地后 10 秒还没喂她，就会被自动吸走吃掉。**
> 如果一次充了好几笔、掉了一地盆：**只要有一个满 10 秒，所有的盆会一起被吸走。**
想提前看看名牌长什么样（不喂也不会被吸）：右键 →「测试充值动画」→「打开火控雷达」。
### 下载与使用
本仓库**暂未发布 Release**，直接下载仓库即可：
1. 点右上角 **Code → Download ZIP**（或 `git clone`），解压到任意目录
 （路径里有中文也没关系，但**不要放在只读位置**）。
2. 进入 **`windows/`** 目录。
3. 双击 **`启动DSH余额宠物.vbs`**。
4. 第一次启动会让你填自己的 DeepSeek API Key（`sk-` 开头）；不想填就先取消，
 挂件会离线显示 `--`，之后随时右键 →「设置 API Key」补上。
 装了 DSH 的话，Key 会被自动读取，不弹框。
**运行要求**：Windows + PowerShell 5.1（系统自带）。
> **建议装 Node.js** —— 取余额会先试 .NET，失败再走 Node。
> 有些机器上 .NET 拿不到 TLS 凭据（`SEC_E_NO_CREDENTIALS`），这时只有 Node 这条路能通。
> 出问题时看同目录的 `pet.log`，它会写明走了哪条路。
### 常用操作
| 操作 | 效果 |
| --- | --- |
| 左键按住拖动角色 | 移动；松手后自动吸附回屏幕左下角 |
| 左键按住米饭盆拖动 | 拖到角色身上就喂给她：盆消失 → 头顶冒爱心 → 充值一次性入账 |
| 左键按住铁盆拖动 | 铁盆也能拖，还能扣在她头上 |
| **双击她的头** | 头上扣着铁盆时：她弹一下，铁盆消失 |
| 右键 | 菜单：立即刷新余额 / 测试扣费 / 测试充值动画 / 演示连续扣费 / 尺寸 / 声音 / 设置 Key / 退出 |
| 双击托盘图标 | 手动触发一次扣费动画 |
尺寸有 **中杯 340 / 大杯 454（默认）/ 超大杯 624 像素**三档，也能自定义；
声音有开关和五档音量（改完立刻生效并记住，不影响系统音量）。
### 版本历史
| 版本 | 目录 | 状态 | 内容 |
| --- | --- | --- | --- |
| **v3.1** | `windows/` | **当前版本** | 修复红闪时整机鼠标发黏、调小尺寸后旧轮廓残影；说明书改用 Markdown |
| v3 | `大肥鱼桌宠改_D-16BVM` | 保留 | 表情差分 · 铁盆 · 多目标火控雷达 · PDF 说明书 |
| v2 | `大肥鱼桌宠改_D-16B` | 保留