deepseekplugins

DeepSeek Harness plugin

niulai-pet

牛来桌宠 — 无边框透明置顶的 A股桌面宠物(Electron + DSH bundle)

Just for Fun
Jump to install

Source facts

Repository
xs-java2ai/niulai-pet
Latest update
Aug 19, 2026
Category
Just for Fun
GitHub stars
3
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/xs-java2ai/niulai-pet
Plugin: niulai-pet
Author: xs-java2ai

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer2 files
README.mdSource · read only

牛来桌宠 (Niulai Pet)

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

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

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

效果预览

正常状态点击后(说话)
<img src="assets/niu.png" width="150" alt="正常状态"><img src="assets/niu_speek.png" width="150" alt="说话状态">

---

功能特性

  • ✅ 正常状态显示 ./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 # 白底抠图脚本(可重复执行)
│   └── build.mjs            # 打包脚本(自动配置国内镜像)
├── 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 > # 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 已配置 electron 安装镜像；electron-builder 的打包镜像由 scripts/build.mjs 自动设置。海外网络可删除 .npmrc`。

二、运行

npm start

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

三、打包分发

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

开机自启 在开发模式与打包后均可用；打包后是独立 exe，不依赖源码目录，更稳定。

---

四、作为 DSH 插件安装

本包声明了 dsh.bundle.patch，可作为插件安装进任意 DSH profile（推荐常驻型的 web）：

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

安装成功后，桌宠会随 profile 启动，请按以下步骤操作：

1. 先完全退出正在运行的桌宠（右键托盘图标 →「退出」）。桌宠是单实例应用：已有实例运行时，新启动的实例只会唤起旧窗口，不会重复出现新宠物。 2. 重启该 profile：在运行 dsh web 的终端按 Ctrl+C 停止，再重新执行 dsh web。 3. 重启后桌宠窗口会自动出现在桌面；profile 退出时桌宠一并关闭。

如何确认是否生效：重启 dsh web 后，它的终端里会出现一行日志：

[niulai-pet] 已拉起桌宠进程 (pid=12345)

如果启动失败，会看到 [niulai-pet] 启动失败: ... 或 [niulai-pet] 未找到 electron ... 的警告。

常见问题：

  • 重启 dsh 后没有反应：先看 dsh 终端日志里有没有 [niulai-pet] 警告。最常见原因是 ① 安装后没有重启 profile（必须重启才会加载插件）；② 桌宠实例已在运行（单实例，先「退出」再重启 dsh）。
  • electron 解析失败：插件从项目目录的 node_modules 解析 electron（dsh plugin add . 是软链方式）。确认 npm install 已执行、node_modules\electron\dist\electron.exe 存在。
  • 一次性 profile（headless）：任务结束会立即关闭桌宠，请装在常驻型 profile（如 web）。

> cordis.patch.yml 中的 enabled 可控制是否随 profile 启动；electron 字段留空时自动解析，也可填绝对路径。

---

五、配置

修改追踪的指数 / 股票

编辑 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/getUTF-8 JSON，字段 f43 现价 / f60 昨收
腾讯财经(备)qt.gtimg.cn/q=sh000001GBK 文本，按 ~ 分隔

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

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

---

七、常见问题

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

Q: 开机自启不生效？ 托盘菜单勾选「开机自启」即可（开发模式也已支持，会自动带上应用目录参数）。注意：若之后移动项目目录或重装 electron，开发模式的自启会失效；打包安装（npm run dist）后自启为独立 exe，与源码目录无关。

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

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

Back to searchOpen GitHub repository

More related plugins

View category