YangShen-SWE/dsh-plugin-simple-pet

A Windows desktop pet for official DeepSeek API balance, usage, and animated reactions in DSH.

Project Overview项目介绍

dsh-plugin-simple-pet is an unofficial community plugin built specifically for the DeepSeek Harness (DSH) desktop profile on Windows. It is a native plugin in the DSH sense: the repo ships a DSH plugin manifest (bundle-manifest), uses the DSH plugin CLI (dsh plugin --profile desktop add "file:..."), is installed into %USERPROFILE%\.dsh\profiles\desktop\node_modules\dsh-plugin-simple-pet\, and depends entirely on DSH's two official DeepSeek routes — deepseek-official (API key) and deepseek-account (sign-in). No other coding-agent platform or generic MCP host is mentioned or supported. The product exists to add a WPF-rendered, always-on-top, transparent floating pet to the DSH desktop experience.

The pet reacts to model calls: cached input triggers light damage, uncached input triggers a critical reaction, a model reply makes it jump happily, and a balance refill makes it eat white rice. Deductions float upward in event order without bubbles, with separate peak/off-peak poses for the 09:00–12:00 and 14:00–18:00 weekday windows. It shows the balance for whichever official route was last used, the latest call's cache hit rate, a peak/off-peak icon, and a right-click settings window with today's tokens, aggregate cache hit rate, estimated CNY spend, and week/month/year line charts in CNY or tokens. Idle dozing starts after 1–240 minutes (10 by default), and the floating window is single-instance.

To install, the user unpacks the repo into a long-lived folder and runs dsh plugin --profile desktop add "file:C:/path/to/dsh-plugin-simple-pet" from PowerShell, then fully quits and relaunches DSH so the new plugin loads. Older @local/dsh-simpledesktoppet or @local/dsh-deepseek-pet installs should be removed first. If the pet never appears, run pet.ps1 -DshProfile desktop from the installed folder for diagnostics; pet.ps1 -Preview, -PreviewSleep, and -PreviewSettings show synthetic demos that do not touch live balance data. Local state lives under %LOCALAPPDATA%\DshSimpleDesktopPet\ and never stores API keys or prompt text.

The plugin targets only Windows with DSH 0.2.0-rc.1 or 0.2.0-rc.2; rc.1 has not yet had a real-machine regression. It does not handle third-party model prices, custom billing rules, or alerts, and accounts and API-key wallets are never mixed. Source code and docs are MIT licensed, but the four character sprite sheets have a separate [ARTWORK-LICENSE.md] agreement. The bundled price table was last cross-checked against DeepSeek's official pricing page on 2026-09-29 and will need a code update if official rates change. The project is unaffiliated with DeepSeek or its inspiration dsh-damage-pulse, and ships none of that upstream's source or art assets.

dsh-plugin-simple-pet 是面向 DeepSeek Harness(DSH)桌面端的非官方桌宠插件。它通过 PowerShell 与 WPF 在 Windows 上打开一个透明、可拖动、始终置顶的悬浮窗,把最近一次官方 DeepSeek 调用的余额、缓存命中率与峰谷价格状态,以 Q 版角色动画和飘字方式呈现给用户。插件只识别 DSH 内部的两条官方路由 deepseek-official(API Key)与 deepseek-account(账号登录),靠 DSH 插件机制 dsh plugin --profile desktop add "file:..." 加载到 desktop profile,启用时自动开窗,停用时自动关闭。

典型使用流程是先在 DSH 内配置好 API Key 或登录账号,把仓库解压或克隆到长期保留的目录,用上述命令把本地目录装入 desktop profile,必要时移除旧版 @local/dsh-simpledesktoppet 或 @local/dsh-deepseek-pet,完全退出并重新打开 DSH,再在插件管理里启用本插件。它适合希望一眼看到余额扣费、想用峰谷形象区分工作日 09:00–12:00 与 14:00–18:00 价格档、并喜欢用角色动作反馈缓存命中、未命中和回复到达等事件的 Windows 用户。

依赖方面需要 Windows、DSH 0.2.0-rc.1 或 0.2.0-rc.2、PowerShell 与官方 DeepSeek 凭据,源码与文档为 MIT 许可,四张角色图集另有独立美术授权。状态文件存于 %LOCALAPPDATA%\DshSimpleDesktopPet\,不保存 API Key 与对话正文。首次启动若看不到悬浮窗需完全重启 DSH;账单飘字数字偏大时属正常,因为可能包含上下文缓存。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • 12 stars - an early-stage project星标 12,属于早期项目
  • Desktop client: installation downloads an executable - verify the publisher and checksums桌面客户端:安装会下载可执行文件,请核对发布者与校验和
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:YangShen-SWE/dsh-plugin-simple-pet

把 YangShen-SWE/dsh-plugin-simple-pet 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-plugin-simple-pet

最新版本:v0.2.4。 启动后即查询已登录 DeepSeek 账号的钱包,不必等待第一次模型调用;之后若使用 API Key 路由则切换显示对应余额。详见 更新记录。

Windows 桌面上的 Q 版 DeepSeek API 桌宠:看余额、用量和峰谷价格,用角色动作反馈每次调用。A small native Windows pet for DeepSeek API balance and usage in DeepSeek Harness (DSH).

兼容 / Compatibility: 面向 DSH 0.2.0-rc.1、0.2.0-rc.2;已在 Windows + 0.2.0-rc.2 实机验证,rc.1 尚待实机回归。支持 DSH 的 deepseek-official(API Key)与 deepseek-account(账号登录)两条官方路由。This is an unofficial community project, not a DeepSeek product.

中文使用说明

功能与特色

  • 轻量悬浮窗: 透明、可拖动、始终置顶;角色位于余额卡边缘,文字保持可读。右键可选小/中/大尺寸及两套可替换形象:默认海蓝鲸鱼娘、夜航科技娘。
  • 峰谷形象: 根据北京时间工作日 09:00–12:00、14:00–18:00 区分峰价与谷价,卡片显示相应图标;两套形象都有不同的峰谷姿态。
  • 按调用反馈: 缓存命中轻微受伤,未命中暴击,模型返回时开心弹跳,余额充值恢复时吃白米饭;连续消费与余额耗尽也有独立反馈。扣费数字按事件顺序上飘,无气泡。
  • 打瞌睡待机: 连续一段时间没有官方 DeepSeek 调用时进入睡眠动作;峰价站姿与谷价趴姿各有待机动作。默认 10 分钟,可在设置中调整为 1–240 分钟。
  • 余额与统计: 卡片显示最近使用的 DeepSeek 路由对应的余额及最近一次调用的缓存命中率;API Key 与账号钱包不会混扣。右键「设置与统计…」可看今日 Token、今日整体缓存命中率、今日估算人民币消耗,并切换本周/本月/本年折线图及 Token/人民币单位。
  • 简化范围: 只处理 DSH 的两条官方 DeepSeek 模型路由;没有通知、其他模型计价或自定义价格规则。扣费飘字可选 Token 或人民币;今日总量集中在设置窗口。动作由 WPF 原生动画播放,状态轮询不限制动作帧率。

安装(推荐:保留本地源码目录)

  1. 在 Windows 上安装 DSH 0.2.0-rc.1 或 0.2.0-rc.2,在 DSH 中配置官方 DeepSeek API Key,或登录 DeepSeek 账号。凭据由 DSH 管理,无需填入本插件。

  2. 从本仓库下载 ZIP 并解压到长期保留的目录,或运行 git clone https://github.com/YangShen-SWE/dsh-plugin-simple-pet.git。不要只复制 pet.ps1;assets/、index.js、stats.js、settings-window.ps1 和清单文件都需要保留。

  3. 在 PowerShell 中安装本地目录,将示例路径换成你的实际解压路径:

    dsh plugin --profile desktop add "file:C:/path/to/dsh-plugin-simple-pet"
    
  4. 如果以前安装过 @local/dsh-simpledesktoppet 或 @local/dsh-deepseek-pet,先在 DSH 的插件管理界面禁用/移除旧插件,避免重复处理同一事件。完全退出并重新打开 DSH,让新插件加载。

  5. 启动 DSH 并在插件管理中启用 dsh-plugin-simple-pet。插件启动时会自动打开 Windows 桌宠悬浮窗;停用插件时会关闭由插件启动的窗口。右键悬浮窗可进入设置。如果首次启用后没有出现,完全退出并重新打开 DSH。

如需单独排查窗口,也可以在解压目录运行:

powershell.exe -NoProfile -ExecutionPolicy Bypass -STA -File .\pet.ps1 -DshProfile desktop
  1. 拖动角色或卡片调整位置;右键打开「设置与统计…」、切换形象/尺寸/飘字单位,或选择「退出桌宠」。运行期间不要移动或删除已安装的源码目录。

通过市场/GitHub 安装到 Windows 的 DSH desktop profile 后,桌宠会随插件启用自动启动。start-pet.cmd 仅供故障排查时手动启动;默认安装位置通常是 %USERPROFILE%\.dsh\profiles\desktop\node_modules\dsh-plugin-simple-pet\。桌宠为单实例,重复启用不会打开多个窗口。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-web-billing 下一个 Next DeepSeek-Harness-for-VS-Code →