牛来桌宠 (Niulai Pet)

一个无边框、透明、置顶的 A股桌面宠物。点击桌宠即可获取 A股实时涨跌幅：

上涨 → 播放 niulai.mp3（牛来了！🔴）
下跌 → 播放 mama.mp3（妈呀！🟢）

基于 Electron 构建，同时以 DSH bundle 形式打包，可作为插件安装进任意 DSH profile。

功能特性

✅ 正常状态显示 ./assets/niu.png，点击切换为 ./assets/niu_speek.png（带弹跳动画）
✅ 调用免费财经 API 获取 A股实时涨跌幅（上证指数，可配置）
✅ 点击后弹出气泡展示名称 / 涨跌幅 / 现价 / 涨跌额（A股红涨绿跌）
✅ 上涨 / 下跌播放不同音效，音频异步预加载
✅ 无边框 + 透明窗口，只显示宠物剪影
✅ 支持拖拽到桌面任意位置，位置自动记忆
✅ 窗口置顶，常驻其他窗口之上
✅ 最小化到系统托盘（单击托盘图标切换显示/隐藏）
✅ 可选开机自启（打包后生效）

目录结构

niulai/
├── assets/                 # 素材(打包进 asar，路径自动解析)
│   ├── niu.png             # 正常表情(已转透明)
│   ├── niu_speek.png       # 说话表情(已转透明)
│   ├── niulai.mp3          # 上涨音效
│   ├── mama.mp3            # 下跌音效
│   └── original/           # 原始(白底)图片备份
├── build/
│   └── icon.png            # 应用图标(由透明图自动生成)
├── scripts/
│   └── make-transparent.cjs # 白底抠图脚本(可重复执行)
├── src/
│   ├── main.js             # Electron 主进程(窗口/托盘/拖拽/自启/IPC)
│   ├── preload.cjs         # contextBridge 安全桥接
│   ├── stock.js            # A股行情获取(东方财富 + 腾讯备用)
│   ├── renderer/           # 渲染进程(UI/动画/音效)
│   └── pet/index.js        # DSH/Cordis 插件入口(拉起桌宠)
├── cordis.patch.yml        # DSH bundle patch 清单
├── package.json
└── README.md

环境要求

Node.js ≥ 20（推荐 20/22/24）
npm 或 pnpm
Windows 10/11、macOS、Linux（桌面环境）

一、依赖安装

# 在项目根目录
npm install

国内网络建议配置 Electron 镜像加速（项目已内置 .npmrc，也可用环境变量）：
# PowerShell（等价于 .npmrc 配置；npm 11 已不接受 `npm config set` 写自定义键）
$env:ELECTRON_MIRROR = "https://npmmirror.com/mirrors/electron/"
$env:ELECTRON_BUILDER_BINARIES_MIRROR = "https://npmmirror.com/mirrors/electron-builder-binaries/"
npm install
项目内 .npmrc 已写入同样的镜像地址，海外网络可直接删除该文件。

二、运行

npm start

启动后宠物出现在屏幕右下角，可拖动；点击宠物查看行情并播放音效；右键托盘图标可隐藏/刷新/退出。

三、打包分发

npm run pack     # 免安装目录版 → release/win-unpacked/
npm run dist     # 安装包(NSIS) → release/*.exe

打包后 开机自启 才会真正写入系统登录项（开发模式下写入的是 electron.exe，无实际意义）。

四、作为 DSH 插件安装

本包同时声明了 dsh.bundle.patch，可作为插件安装进任意 DSH profile：

# 在项目根目录执行(相对路径会锚定到当前目录)
dsh plugin --profile web add .

此后每次启动该 profile（例如 dsh web）都会自动拉起桌宠窗口；profile 退出时桌宠一并关闭。

通过 cordis.patch.yml 中的 enabled 可控制是否随 profile 启动
electron 字段留空时自动解析 profile 内已安装的 electron；也可填绝对路径

建议安装到常驻型 profile（如 web）。一次性 profile（headless）会在任务结束后立即关闭桌宠。

五、配置

修改追踪的指数 / 股票

编辑 src/stock.js 顶部的 INDEX：

const INDEX = {
  name: '上证指数',
  code: '000001',
  secid: '1.000001',   // 东方财富: 1=沪市 0=深市
  tencent: 'sh000001'  // 腾讯: sh/sz + 代码
}

例如追踪深证成指改为 secid: '0.399001'、tencent: 'sz399001'。

更换素材

直接用同名文件替换 assets/ 下的图片/音效即可。若新图片是白底 PNG，重新执行抠图脚本：

npm run transparent   # 需要 sharp 依赖(项目已装或走 DSH 环境回退)

六、行情数据说明

源	接口	说明
东方财富(主)	`push2.eastmoney.com/api/qt/stock/get`	UTF-8 JSON，字段 `f43` 现价 / `f60` 昨收
腾讯财经(备)	`qt.gtimg.cn/q=sh000001`	GBK 文本，按 `~` 分隔

涨跌幅统一按 (现价 - 昨收) / 昨收 计算，不依赖各家涨跌幅字段的缩放差异，保证一致性。主源失败自动切换备用源。请求在主进程完成，规避浏览器 CORS 限制。

免费接口不保证 SLA，行情可能有延迟；仅用于桌面宠物展示，不构成投资建议。

七、常见问题

Q: 宠物显示成白色方块？ 图片必须是带透明通道的 PNG。仓库已内置转透明后的素材；若自行替换请确保透明，或执行 npm run transparent。

Q: 开机自启不生效？ 自启依赖已打包的应用。开发模式下 app.setLoginItemSettings 指向 electron.exe，请先 npm run dist 安装后再勾选。

Q: 窗口挡住了桌面的点击？ 透明窗口本身会拦截鼠标事件（用于拖拽）。窗口已压缩到「宠物 + 顶部气泡区」的最小矩形，宠物本体约占下半部分。

Q: 音效没声音？ 音效在启动时已预加载；若仍无声音，检查系统音量及 Electron 是否被静音。涨跌各对应 niulai.mp3 / mama.mp3。

niulai-pet