dsh-pet 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；基本兼容但装前注意：npm 同名包「dsh-pet」归属 pc2005-cloud/dsh-pet，装到的可能不是本插件

dsh-pet 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

dsh-pet 还在维护吗？

GitHub 12 星。最近一次上游提交在 2026/9/5。

鲸鱼桌宠 FlytoMAYDAY80/dsh-pet

DeepSeek Harnessv0.3.8

FlytoMAYDAY8059 天前有提交已提供中文文档扫描：含敏感能力

在 GitHub 查看 ↗

🐋 DSH 有声桌宠：悬浮桌面的 DeepSeek 小鲸鱼，不打开 DSH 也能实时感知会话状态（需要确认/工作中/完成/空闲/离线），支持音效提醒与零代码定制素材

37.8/100

综合分

GitHub 星标

—

npm 周下载

—/5

用户评分

数据截至 2026/9/17 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

自动兼容检查有告警：npm 同名包「dsh-pet」归属 pc2005-cloud/dsh-pet，装到的可能不是本插件。

安装命令 · 需先装 dsh CLI 引擎

dsh plugin --profile web add FlytoMAYDAY80/dsh-pet

该包不可直接 npm 安装，改从 GitHub 源安装（明细见下方安装检查）

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态

信任档位：已验证

是什么

dsh 原生插件 · desktop

装得上吗

本站已在 dsh 0.2.1-rc.2 下真实安装成功

非静态推断

L4 · 真实安装等级说明 →

安全吗

本站尚未对该插件做风险分级

暂未覆盖，不等同于无风险

还在维护吗

更新放缓：最近一次提交在 59 天前

档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。

验证判据与等级说明 →

社区实装还没有人打卡 · 装过的第一个就是你

安装兼容性检查⚠ 装前注意

npm 同名包「dsh-pet」归属 pc2005-cloud/dsh-pet，装到的可能不是本插件

展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。

✓npm 包dsh-pet @ 0.3.8

✓Node 引擎未声明 engines.node

✓dsh CLI 依赖未声明 dsh 版本约束

✓入口文件main/exports/bin 已声明

验证方式：npm registry 存在性 + package.json 静态校验 · 最后检查 2026/10/30 06:18:38

安全扫描自动 · 静态分析源码

v2.7.0

🔵 扫描：含敏感能力尚无人工评估

展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力：执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量（至少其一）。这是能力清单，不是危险判定——具体能力项与证据见下方，安装前请自行判断是否需要。

可执行外部命令读写/删除本地文件发起外部网络请求

查看扫描证据（共 9 处，展示前 9 条）

发起网络请求
main.js:52
const res = await fetch(`${DSH_URL}/api/${method}`, {
读取本地文件
main.js:383
if (!fs.existsSync(f)) return null
读取本地文件
main.js:384
const data = JSON.parse(fs.readFileSync(f, 'utf8'))
读取本地文件
main.js:469
const f = candidates.find((p) => fs.existsSync(p))
执行外部命令固定命令
main.js:477
const proc = spawn('afplay', [target])
删除本地文件
main.js:493
try { fs.unlinkSync(f) } catch { }
写入本地文件
main.js:502
fs.copyFileSync(f, tmp)
写入本地文件
main.js:699
fs.mkdirSync(outDir, { recursive: true })
写入本地文件
main.js:730
fs.writeFileSync(path.join(outDir, name), img.toPNG())

扫描于 2026/11/3（0 天前） · 范围入口闭包 + 全包扫描 · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

给这个插件打分还没有人投票↓

用户评分

还没有人投票，来当第一个

广告精选好物

飞利浦 TAH6519 主动降噪耳机 ¥299

头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。

·anc 主动降噪 · 头戴式无线
·价格与库存以商品页实时为准

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

Cursor、Claude Code、VS Code 逐个核对：能不能装、配置怎么写、装不上是什么原因。

·按客户端逐格核对
·结论标注依据与风险等级

查 MCP 兼容性→

界面预览

2 张 · 点击查看大图

功能亮点

悬浮桌面显示
实时感知会话状态
音效提醒

README

由 DeepSeek 最新模型翻译生成

五种状态预览 DSH 桌宠是一只独立的桌面应用：你在浏览器、IDE、文档里工作时，鲸鱼始终悬浮在桌面一角，用表情、气泡和音效告诉你——有会话在跑、需要你去审批、任务做完了。把「任务状态」从需要主动查看的页面，变成余光即得的实时信号。 📦 本项目随 DeepSeek Harness 发布而开源（原托管于 dsh-external 组织仓库，现以个人账号仓库作为公开源）。欢迎使用、定制与贡献。 ✨ 核心特性 - 离屏状态感知：独立置顶悬浮窗，跨全屏 App 可见，不打开 DSH 也能看见状态 - 人工介入零遗漏：「需要确认」（审批/提问）最高优先级呈现 + 专属音效，不会错过需要你的节点 - 毫秒级实时：双 WebSocket 通道（审批/提问推送 + 运行状态翻转推送），状态变化即时响应 - 跨会话聚合：多会话并行时气泡逐行列出每个会话，数量再多也可滚动查看 - 低打扰：只在状态真正变化时动画/发声，不刷存在感 - 精准点击穿透：仅鲸鱼当前帧的可见像素与可见气泡响应鼠标，其余透明区域不遮挡后方应用 - 对 DSH 零侵入：纯只读 HTTP/WebSocket 接口，不写入任何数据，卸载即消失 - 零代码定制：custom/ 目录一键换图案、配色、音效（见下方「定制」） 📊 五种状态 | 状态 | 鲸鱼表现 | 含义 |

展开完整文档（README 剩余 1 节）

五种状态预览

DSH 桌宠是一只独立的桌面应用：你在浏览器、IDE、文档里工作时，鲸鱼始终悬浮在桌面一角，用表情、气泡和音效告诉你——有会话在跑、需要你去审批、任务做完了。把「任务状态」从需要主动查看的页面，变成余光即得的实时信号。

📦 本项目随 DeepSeek Harness 发布而开源（原托管于 dsh-external 组织仓库，现以个人账号仓库作为公开源）。欢迎使用、定制与贡献。

✨ 核心特性

- 离屏状态感知：独立置顶悬浮窗，跨全屏 App 可见，不打开 DSH 也能看见状态
- 人工介入零遗漏：「需要确认」（审批/提问）最高优先级呈现 + 专属音效，不会错过需要你的节点
- 毫秒级实时：双 WebSocket 通道（审批/提问推送 + 运行状态翻转推送），状态变化即时响应
- 跨会话聚合：多会话并行时气泡逐行列出每个会话，数量再多也可滚动查看
- 低打扰：只在状态真正变化时动画/发声，不刷存在感
- 精准点击穿透：仅鲸鱼当前帧的可见像素与可见气泡响应鼠标，其余透明区域不遮挡后方应用
- 对 DSH 零侵入：纯只读 HTTP/WebSocket 接口，不写入任何数据，卸载即消失
- 零代码定制：custom/ 目录一键换图案、配色、音效（见下方「定制」）

📊 五种状态

| 状态 | 鲸鱼表现 | 含义 |
| 🔴 需要确认 | 瞪眼 + 眉毛 + o 嘴 + 提示音 | 有审批/提问等你处理 |
| 🔵 工作中 | 专注眼 + 喷水动画 | 有会话正在运行 |
| 🟢 完成待查看 | 开心眯眼 ^^ + 星星 | 任务刚完成，去看结果 |
| 💤 空闲 | 睡觉 + zzz | 无任务，安心休息 |
| 😵 离线 | 灰度 + X 眼 | 连不上 DSH，自动重试 |

优先级：需要确认 > 工作中 > 完成待查看 > 空闲 > 离线。

⬇️ 下载与安装

方式一：下载安装包（推荐） — 从 GitHub Releases 下载：

| 平台 | 安装包 | 说明 |
| macOS Apple Silicon | dsh-pet-<版本>-arm64.dmg | 双击打开，把鲸鱼拖入 Applications |
| macOS Apple Silicon | dsh-pet-<版本>-arm64-mac.zip | 便携版，解压即用；删文件夹即卸载 |

方式二：从源码运行 — 需要 Node.js 18+ 与 pnpm：

pnpm install # 安装依赖（Electron）
pnpm start # 启动桌宠（默认右下角）

可选：DSH_PET_URL=http://127.0.0.1:3080 指定 DSH GUI 地址（默认 3080）。

🖱️ 使用

| 操作 | 行为 |
| 单击鲸鱼/气泡 | 打开 DSH GUI（系统浏览器，可切换桌宠窗口直达会话） |
| 按住拖拽 | 移动位置 |
| 右键鲸鱼/气泡（或托盘图标） | 菜单：气泡开关、音效开关、大小调节、打开方式 |
| 滚轮（气泡内） | 滚动查看多会话列表 |

🎨 定制（零代码）

把文件放进 custom/ 目录，重启即生效：

custom/
├── sprites.json ← 像素图案 + 配色（可用脚本从参考图生成） ├── attention.m4a ← 「需要确认」音效 └── done.m4a ← 「任务完成」音效

从参考图生成图案：

python3 scripts/ref_to_sprites.py <你的参考图.png>

详细格式见 custom/README.md 与 产品说明.md。

❓ 常见问题

Q：桌宠没出现在桌面上？ 先确认 DSH GUI 已在 http://127.0.0.1:3080 运行；桌宠离线状态（灰度 X 眼）会自动重试连接。

Q：听不到提示音？ 右键鲸鱼 → 菜单里打开「音效」，并确认系统音量；「需要确认」与「任务完成」各有专属音效。

Q：桌宠会不会把数据传到云端？ 不会。桌宠只读取本地 DSH 接口（HTTP/WebSocket），无任何云端上报，卸载即消失。

🛠️ 开发与自检

pnpm smoke # 状态引擎冒烟测试（连接/轮询/WebSocket/状态推导）
pnpm shot # 两种皮肤 × 5 状态截图到 .shots/
pnpm hittest # 透明区、鲸鱼像素、气泡显隐与换帧热区回归测试
python3 scripts/verify_pixel_src.py # 素材规格与参考图一致性校验bash
python3 scripts/gen_icon.py # 重新生成应用图标

📁 目录结构

main.js 主进程：窗口/托盘 + DSH 状态引擎（轮询 + 双 WebSocket）+ 素材包加载 preload.js contextBridge IPC app/ 渲染层：index.html + styles.css + renderer.js + 像素素材 + 音效 custom/ 自定义素材包（用户定制入口） pixel-src-hd/ 像素素材源（JSON + PNG） scripts/ 生成/自检脚本 docs/ 截图与演示素材

📄 License

MIT © FlytoMAYDAY80

免责声明

本仓库是独立的第三方工具，与 DeepSeek / DeepSeek AI 官方无关。DeepSeek Harness（dsh）是官方项目（MIT）。鲸鱼形象与"DeepSeek"名称用于指代所对接的官方产品，版权归其各自所有者。

A floating desktop whale for DeepSeek Harness — know your session status at a glance without opening the DSH page.

DSH 桌宠 (dsh-pet) 是独立桌面应用：一只小鲸鱼浮在屏幕角落，实时反映你的 DSH 会话状态——需要你批准 / 工作中 / 已完成 / 空闲 / 离线——用表情、气泡和音效来表现。

- 下载：GitHub Releases（macOS Apple Silicon，DMG 或 ZIP）
- 从源码运行：pnpm install && pnpm start（Node.js 18+，pnpm）
- 自定义：把你自己的精灵图/颜色/音效放进 custom/，重启即可生效
- 隐私：只读取本地 DSH HTTP/WebSocket 接口，不上传云端
- License：MIT

DSH 桌宠只读取本地 DSH 接口，无任何云端上报。