DSH Plugin HubDSH 插件市场
miku00039-01/dsh-whale-pet 预览 preview

miku00039-01/dsh-whale-pet

Desktop桌面端 Native原生 ⭐ 3 MIT Pets & Fun桌宠与娱乐

🐋 DSH 桌宠：DeepSeek Harness 的 Windows 桌面宠物，一键启动/停止/监测服务，双击唤起 GUI，零依赖单文件 exe

Project Overview项目介绍

Edited by Zhiwei Agent (zhiwei)由知微Agent(zhiwei)编辑

This repository hosts a native DSH plugin that adds an interactive desktop whale pet for DeepSeek Harness on Windows. The entire functionality is packaged into a zero-dependency executable that handles starting, stopping, and monitoring the DSH service, as well as launching the DSH GUI. Users can install it via two methods: either install it as a DSH plugin using the DSH CLI from npm or GitHub, or download the pre-compiled exe directly from the Releases page. The pet supports one-click startup out of the box once DSH is correctly installed on your system.

After launching, the semi-transparent whale pet floats on your desktop, and you can drag it to any position and it will automatically remember your preferred location on next run. Double-clicking the pet brings up the DSH GUI, while right-clicking opens a context menu with options to minimize to tray, stop the DSH service, or exit the entire application. The pet automatically checks the DSH service status, only displays online/offline states, runs as a single instance to avoid duplicate launches, and automatically logs crashes for debugging.

This tool requires Windows 10 or 11 as the operating system, and depends on a properly installed DeepSeek Harness, Node.js, and .NET Framework 4.x which is already included in the system so no extra installation is needed. Installing Google Chrome gives you an improved experience with a standalone PWA window for DSH, but if Chrome is not installed, the pet will fall back to your default browser. The code for this project is distributed under the MIT license, and the whale pet asset follows a separate attribution license.

dsh-whale-pet 是专为 DeepSeek Harness 打造的原生 Windows 桌面宠物插件，将 DSH 服务的启动、停止、状态监测和 GUI 唤起功能整合到一个零依赖的 exe 文件中。它支持两种安装方式，既可以通过 DSH 插件命令从 npm 或 GitHub 安装，也可以直接从 Release 页面下载预编译 exe 直接运行。

启动后，半透明的鲸鱼桌宠会悬浮在桌面，支持拖动并自动记住位置。用户可以双击桌宠唤起 DSH GUI，右键点击呼出操作菜单，支持最小化到托盘、关闭服务、退出程序等操作。桌宠会自动监测 DSH 服务状态，仅显示在线/离线两种状态，单实例运行避免重复启动，崩溃会自动记录日志方便排查。

本工具要求运行环境为 Windows 10/11，依赖已正确安装的 DeepSeek Harness、Node.js 和 .NET Framework 4.x（.NET 已内置在系统中无需额外安装）。安装 Chrome 可获得更好的 PWA 独立窗口体验，不安装也可使用默认浏览器打开。本项目代码基于 MIT 许可分发，桌宠素材遵循单独的授权要求。

View on GitHub在 GitHub 查看

Recommended强烈推荐 Send to your DSH发给你的 DSH 安装 
请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】，检查通过再动手。

插件：dsh-whale-pet（miku00039-01/dsh-whale-pet）
仓库：https://github.com/miku00039-01/dsh-whale-pet
本站详情页：https://www.yhbd.top/plugins/miku00039-01-dsh-whale-pet/
本站登记：类型 client · 归类 原生 DSH 插件 · 许可证 MIT · ⭐ 3 · 最近提交 2026-10-01 · 主语言 C#

按下面顺序执行，每步先把结论告诉我，再进入下一步：

【1 兼容性检查】
① 我这边：DSH 版本、Node 版本、操作系统、当前 profile（web / desktop）。
② 读它的 README、package.json、插件 manifest，列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对，结论只写「满足 / 不满足 / 未知」三种；不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突：命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。

【2 安全性检查】
① 仓库可信度：和上面「本站登记」是否一致；star / fork 数、创建时间、最近提交，是否归档或长期停更。
② 安装脚本：逐行看 package.json 的 preinstall / install / postinstall，以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名，立刻停下来告诉我，不要继续装。
③ 依赖：列出新增依赖，标出无人维护、或与知名包拼写近似的可疑包（typosquatting）。
④ 权限与副作用：它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限（filesystem / network / shell / clipboard 等），以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限，或权限明显超出功能所需，先停下来问我。

【3 安装】
上面两步没有「不满足」和「高危项」时才执行；用官方推荐方式安装，不要自行提权。

【4 汇报】
用表格输出：检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜，也不要替我决定。

Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH：它会先核对兼容性与安全性（逐条给「满足 / 不满足 / 未知」），确认没问题再安装，有高危项会停下来问你。框内可滚动，复制到的是完整提示词；安装命令不一定准确，发给 DSH 更稳。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意
  • Only 3 stars - very few users, little community feedback星标只有 3，几乎没人在用，遇到问题缺少社区反馈
  • 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 @miku00039-01/dsh-whale-pet

把 miku00039-01/dsh-whale-pet 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

11.3 KB · 缓存于 2026-10-01 22:12:33 · 11.3 KB

🐋 DSH 桌宠 (DSH Whale Pet)

Awesome DSH Plugin

一个 Windows 桌面宠物程序,把 DeepSeek Harness 的服务启动、停止、状态监测和 GUI 唤起整合到一个零依赖的 .exe 里。

English: README.en.md · 版本记录: CHANGELOG.md · 安全: SECURITY.md

whale

✨ 功能

功能 说明
一键启动 双击 exe = 检测 DSH 服务 → 未运行则后台拉起 → 就绪后打开 GUI → 鲸鱼娘出现
两种模式自动识别 桌面端模式(Electron 应用):只做伴侣——唤起它的窗口、看它状态,不再另起实例;CLI 模式:沿用下面的完整服务管理
人形桌宠 逐像素透明悬浮窗,按图片原形状显示,可拖动、记住位置
双击唤起 桌面端模式 = 把桌面端窗口置顶;CLI 模式 = 打开 GUI(复用同一 PWA 窗口,不堆标签页)
右键菜单 打开程序 / 最小化至托盘 / 关闭程序 / 查看状态 / 退出
最小化至托盘 选「🗕 最小化至托盘」隐藏鲸鱼娘(仅留托盘图标);单击托盘图标即可唤起,再次运行 exe 同样能唤回(位置不变)
关闭程序 桌面端模式 = 只关桌面端窗口(不动服务进程);CLI 模式 = 停服务 + 关 GUI 窗口(不影响其他浏览器页面)
退出 确认框后退出(CLI 模式连服务一起退;桌面端模式不动桌面端进程)
托盘图标 常驻;鲸鱼娘已隐藏时左键单击 = 唤起,未隐藏时左键单击 = 打开 GUI;右键菜单(兜底入口)
状态监测 仅绿/红两态(无黄色中间态),自适应频率:在线 5 秒 / 离线 2 秒
状态卡片 悬浮卡片显示服务状态/地址/PID/运行时长 + 桌宠内存/GDI 句柄(自检防泄漏)
单实例 重复双击不会开第二个,只会唤起已有实例
崩溃日志 未捕获异常自动写入 dsh-whale-pet-crash.log,方便排查

📦 依赖(前置条件)

依赖 必选? 说明
Windows 10 / 11 ✅ 必选 使用了 WinForms / 分层窗口 / netstat 等 Windows 能力
.NET Framework 4.x ✅ 必选 系统自带,无需安装;exe 由系统自带 csc.exe 编译,目标框架 4.x
DeepSeek Harness ✅ 必选 需要正确安装:① Node.js(提供 node 运行环境)② dsh CLI 全局安装(npm i -g @deepseek-ai/dsh)③ 已配置 API 凭证(~/.dsh/.credentials.yaml 中的 DEEPSEEK_API_KEY)。桌宠通过 node <https://github.com/miku00039-01/dsh-whale-pet/blob/HEAD/dsh的bin.js> web 拉起服务,监听 127.0.0.1:3080
Chrome ⚪ 可选 用于 PWA 独立窗口模式(由 DSH GUI 生成 DeepSeek Harness.lnk 快捷方式)。未安装/未找到时自动回落到默认浏览器打开

简言之:装好 DeepSeek Harness 就能跑;装 Chrome 并获得 PWA 快捷方式可获得最佳体验。

🚀 快速开始

方式一:作为 DSH 插件安装(推荐)

# 从 npm 安装(推荐,npm 包名为 @miku00039-01/dsh-whale-pet)
dsh plugin --profile web add @miku00039-01/dsh-whale-pet

# 或直接从 GitHub 安装(无需 npm)
dsh plugin --profile web add github:miku00039-01/dsh-whale-pet

安装后在 DSH 里输入 /whalepet 即可启动鲸鱼娘桌宠。插件市场(dsh-market)里搜索 dsh-whale-pet 也能一键安装。

关于包名:npm 上 dsh-whale-pet 已被他人占用,因此本插件发布在作用域下 @miku00039-01/dsh-whale-pet。 package.json 的 name、cordis.patch.yml 的 name 与 profile 里的依赖键必须三处一致。

关于宿主要求:插件市场卡片上的"宿主要求"读自 npm manifest 的 engines.dsh(本包声明 >=0.1.0-rc.6); 只从 GitHub 安装、未发布到 npm 的插件,市场读不到 manifest,会显示"宿主要求未知"——这是市场刻意不猜测的设计。

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

渲染基于仓库 miku00039-01/dsh-whale-pet 的 README.md。 在 GitHub 查看原文 →

Related相关推荐

← 上一个 Prev dsh-local-vector-memory 下一个 Next dsh-claude-oauth →