CLICGGER-TYPES/dsh-piggy

Desktop桌面端 Native原生 ⭐ 11 NOASSERTION Pets & Fun桌宠与娱乐Clients & Launchers客户端与启动器

🐖 DeepSeek Harness 养成插件,也可作为 Windows/Linux/macOS 桌面宠物运行;支持成长、学习、打工、钓鱼、图鉴与换肤

Project Overview项目介绍

dsh-piggy is a DeepSeek Harness-native plugin built around raising a virtual pig, and the same package also ships as an Electron desktop application that runs independently on Windows, Linux, and macOS. Inside DSH it is installed with dsh plugin --profile web add dsh-piggy, or by cloning the repository and pointing the same command at a local path before restarting and refreshing the harness; the standalone builds are distributed from GitHub Releases as Windows setup.exe and portable.exe installers, a Linux AppImage, and macOS arm64 or x64 dmg images. The project uses a bundle-manifest and does not register any model tool, inject pet state into conversations, or spend tokens, so the pig remains a self-contained ambient companion.

Gameplay is driven by an Animal-Crossing-style App main menu opened with a right-click: left-click pets the pig, dragging repositions it on the desktop, and clicking the cardboard box three times in a row adopts the animal on first encounter. The pig grows through stages that include school, part-time work, travel, fishing, and illness, while finishing jobs such as chef or astronaut unlocks corresponding career outfits. Built-in skins ship with the package, and players can also author or import their own SVG skin packs following the dedicated creating-skins guide, with reference art contributions credited to @1nuooiscute.

Development depends on esbuild 0.28.2, typescript 5.9.3, and @types/node 20.19.43, and exposes build, test, and typecheck npm scripts described in docs/DEVELOPMENT.md. The macOS build is unsigned, so first launch requires right-clicking the app in Finder and choosing Open; in-app self-update from v0.2.0 covers the Windows installer and the Linux AppImage, while the Windows portable build and macOS bundles must be replaced manually from the release page. The v0.2.1 desktop shell fixes a security issue in an update dependency, which existing desktop users must upgrade. The repository is released under the MIT License.

dsh-piggy 是一款以养成小猪为核心的 DSH 原生插件,同时提供可在 Windows、Linux 与 macOS 上独立运行的 Electron 桌面版。DSH 安装方式为 dsh plugin --profile web add dsh-piggy,也支持从本地 GitHub 源码目录加载;桌面版则在 GitHub Releases 下载 setup.exe、AppImage 或对应架构的 dmg。它不依赖任何模型工具,不向对话注入宠物状态,也不消耗 token。游戏以动森风格的 App 主菜单呈现全部玩法。

养成流程围绕右键主菜单展开:左键可抚摸小猪,拖动可调整位置,首次遇到纸箱时连续点击三次即可把小猪接回家。猪会经历成长、上学、打工、旅行、钓鱼和生病等阶段,完成厨师或宇航员等工作还能解锁职业外观。玩家既可使用内置免费皮肤,也能按照自定义皮肤制作教程导入自己的 SVG 皮肤包。商店与背包中的装扮入口暂被隐藏,但已有装扮和穿戴记录会保留。

开发环境使用 npm 安装 esbuild、typescript 与 @types/node,提供 build、test 与 typecheck 脚本。macOS 包未签名,首次启动需在访达中右键选择"打开"。从 v0.2.0 起,Windows 安装版与 Linux AppImage 支持在 App 内更新外壳,而便携版与 macOS 版仍需手动替换。v0.2.1 的桌面外壳修复了更新依赖的安全问题。项目采用 MIT 许可,美术风格参考 animal-island-ui。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • 11 stars - an early-stage project星标 11,属于早期项目
  • 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 dsh-piggy

把 CLICGGER-TYPES/dsh-piggy 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-piggy 的小猪

dsh-piggy

一只住在 DeepSeek Harness 里,也能独立住在桌面上的猪。

它会长大、上学、打工、旅行、钓鱼、生病,也会跟你搭话。界面采用动森风格的 App 主菜单,全部玩法都能用鼠标完成。

欢迎一起画猪。 目前项目还缺形态、动作和皮肤等美术资源;如果你有喜欢的猪猪形象,欢迎提交 Pull Request,我会认真看并合并合适的作品。也欢迎 Fork 项目,做一只完全符合自己喜好的猪。自定义皮肤可从制作教程开始。

  • 完整养成:照顾、成长、学习、工作、旅行、收藏和晋升形态
  • 桌面版:Windows、Linux 和 macOS 可独立运行
  • 角色外观:完成厨师或宇航员工作解锁职业外观,另有免费内置皮肤,也可导入自己的 SVG 皮肤包
  • 零 token:不注册模型工具,不向对话注入宠物状态

主菜单 图鉴 换肤

安装

DSH 插件

dsh plugin --profile web add dsh-piggy

安装后重启 DSH,再刷新页面。

在按 dsh-plugin-* 搜索的社区目录中,也可安装 dsh-plugin-piggy:dsh plugin --profile web add dsh-plugin-piggy。它加载同一个游戏,每个 profile 安装其中一个即可。

如果想直接使用 GitHub 源码,可以克隆本仓库,再执行 dsh plugin --profile web add /path/to/dsh-piggy。

桌面版

从 GitHub Releases 下载对应系统的文件:

  • Windows:setup.exe 安装版或 portable.exe 便携版
  • Linux:AppImage
  • macOS:按芯片选择 arm64.dmg 或 x64.dmg

macOS 包暂未签名,第一次打开请在访达中右键应用并选择“打开”。更多安装与存档说明见桌面版指南。

主菜单「更新」会分别显示游戏版本和桌面外壳版本。游戏包可在 App 内更新;桌面外壳从 v0.2.0 起,Windows 安装版和 Linux AppImage 可在 App 内下载并重启安装。Windows 便携版、未签名 macOS 版需到发布页手动替换;旧版外壳需先手动升级一次。详见更新说明。

v0.27.1 的桌面外壳 v0.2.1 修复了更新依赖的安全问题;已有桌面版需要升级外壳,单独更新游戏包不会替换该依赖。

商店和背包中的「装扮」入口暂时隐藏,已有装扮和穿戴记录会保留;后续会重新设计展示方式。

开始玩

右键小猪打开主菜单,左键摸摸它,拖动可以换位置。第一次见到纸盒时连续点三下,把猪接回家。

详细玩法、体型、美术图标设置和命令见玩法指南。换肤可直接阅读玩家换肤教程,制作皮肤从自定义皮肤制作教程开始。

文档

开发

npm install --no-save --package-lock=false esbuild@0.28.2 typescript@5.9.3 @types/node@20.19.43
npm run build
npm test
npm run typecheck

开发环境、桌面打包、HTTP 接口和目录说明见开发指南。

致谢与许可

特别感谢 @1nuoiscute 贡献猪猪王原型、恶魔猪、肥猪体型与胖胖猪动作立绘。视觉风格参考 animal-island-ui,玩法数值参考资料见 THIRD-PARTY.md。项目采用 MIT License。

← 上一个 Prev dsh-session-pin 下一个 Next dsh-global-rules →