前言¶

在 DeepSeek Harness（DSH）里跑智能体时，界面往往偏「工具向」：对话、命令、状态面板占满注意力。社区里的桌宠插件 dsh-pet 把动画、漫游、对话和桌面小窗接到同一套 Cordis 架构上，但若要亲密度、专注计时、朗读和统计，通常得自己叠脚本或换别的工具。

dsh-pet-plus 是维护者 youhuangqing 基于上游 dsh-pet 0.3.6（作者 PC2005-cloud，MIT）做的二次创作：保留上游列出的基础能力，并新增六组功能；通过 -plus 命名与原版 可以并存。分类上属于 DSH 社区目录里的「趣味换装」类插件。下文按安装、用法和注意点说明，事实以 GitHub 仓库 README 为准。

这是什么¶

dsh-pet-plus 是 DSH 的桌面宠物插件包，版本 0.1.0（见 package.json）。它在不替换上游的前提下扩展交互：亲密度与喂食、番茄钟、Windows 侧语音朗读（含可选 Edge 联网音色）、音效、分组右键菜单，以及每日统计与记账相关入口。

上游保留的能力包括：动画、漫游、拖拽抛掷物理、余额、碎碎念、对话与记忆、系统通知、工作状态联动、多开与布局、透明置顶桌面小窗等（README 功能表与声明一致）。本仓库新增与修改部分同样以 MIT 释出；动画 / 提示词 / 源视频沿用上游「允许开源使用、禁止商用」的素材约定，详见仓库内 THIRD_PARTY_NOTICES.md。

环境与前置条件¶

安装前请核对 DSH 桌面版版本与系统：

插件在 DSH 进程内加载，权限与当前 DSH 实例相同；安装前建议自行浏览源码与许可证，再决定是否启用。

核心功能¶

README 将新增能力归纳为六组，并与上游命令、菜单并存：

斜杠命令除上表外，仍支持上游风格的 /pet、/chat、/balance 等；若与原版 dsh-pet 同时安装，短名 /pet、/chat、/balance 归先加载的原版，本插件自动改用 /pet-plus、/chat-plus、/balance-plus。

安装与启用¶

假设 DSH 档案名为 desktop（桌面版默认）。<DSH安装目录> 表示你本机 DeepSeek Harness 的安装根目录（非固定路径）；dsh.cmd 通常位于 <DSH安装目录>\resources\runtime\cli\bin\dsh.cmd。

方式 1：从 Release 安装（推荐）¶

在 PowerShell 中执行：

dsh plugin --profile desktop add https://github.com/youhuangqing/dsh-pet-plus/releases/download/v0.1.0/dsh-pet-plus-0.1.0.tgz

若 dsh 不在 PATH，改用全路径调用，例如：

& '<DSH安装目录>\resources\runtime\cli\bin\dsh.cmd' plugin --profile desktop add https://github.com/youhuangqing/dsh-pet-plus/releases/download/v0.1.0/dsh-pet-plus-0.1.0.tgz

方式 2：本地 tgz¶

& '<DSH安装目录>\resources\runtime\cli\bin\dsh.cmd' plugin --profile desktop add file:C:\path\to\dsh-pet-plus-0.1.0.tgz

README 注明：DSH 在启动时组合插件树，运行中不热加载第三方插件，因此安装完成后需要重启 DeepSeek Harness。

确认是否加载成功¶

可在浏览器开发者工具（Ctrl+Shift+I）控制台搜索 dsh-pet-plus，查看就绪日志；或访问：

http://127.0.0.1:19387/dsh-pet-plus-7340/state

返回 JSON 的 sections 中应包含 social、pomodoro、stats、sfx、tts 等段。

典型用法¶

互动与专注¶

1. 在界面中选中桌宠实例（必要时用 /pet 或 /pet-plus 指定当前宠物）。
2. 右键打开增强菜单：「互动」下摸头、喂小鱼干；「专注」下选择 25 / 10 / 45 分钟番茄钟。
3. 用 /social、/pomodoro（含 start / stop / status 等子命令）在对话里查状态，与菜单操作等价。

语音与音效¶

首次运行后，用户配置位于：

C:\Users\<你>\.dsh\dsh-pet-plus\main-config.jsonc

修改后 README 说明为每个请求重读，无需重启 DSH。包内 assets/config.jsonc 带完整注释，可对照所有可配项。

常见调整是在 tts 段指定提供方与音色，例如：

{
  "tts": {
    "enabled": true,
    "provider": "edge",
    "voice": "zh-CN-XiaoyiNeural",
    "rate": 0,
    "volume": 100
  }
}

provider 可取 auto（Windows 上倾向系统语音）、sapi、edge、stub（静音链路排查）。Edge 音色为联网未公开接口，README 说明失败时会回落系统语音；以 /tts status 显示的实际提供方为准。试听可直接 /tts 跟一句文本。

与原版并存¶

两套插件同时安装时，全局标识均带 -plus 隔离：包名、Cordis id、路由前缀 /dsh-pet-plus-7340、用户目录 ~/.dsh/dsh-pet-plus/、Electron 应用名、斜杠命令等。界面可能出现两只宠物、设置页两个分区；若只想保留一套，卸载另一个即可。~/.dsh/electron/ 运行时目录两套共用，避免重复下载约 200MB。

适用场景与注意¶

适合谁：已在 DSH 桌面版使用或打算使用 dsh-pet 一类桌宠，希望在同一插件里完成轻量养成、专注计时、朗读反馈和简单统计，且接受 Windows 优先的桌面小窗体验。

务必知晓的限制（README「已知限制」）：

• 悬停快捷条尚未实现。
• Edge 联网音色协议未公开，虽有三重保护，仍可能随微软侧变化失效并退回系统语音。
• 部分统计字段（如 token 用量）因上游事件是否携带 usage 未核实而留空。

卸载：

& '<DSH安装目录>\resources\runtime\cli\bin\dsh.cmd' plugin --profile desktop remove dsh-pet-plus

重启 DSH 后插件不再加载；~/.dsh/dsh-pet-plus/ 用户数据不会自动删除，需自行清理。

结尾¶

dsh-pet-plus 把上游桌宠的动画与对话能力保留下来，在同一 DSH 插件形态里补上养成、番茄钟、TTS、音效和统计入口，并通过命名隔离与原版共存。DeepSeek Harness 社区插件目录与 DeepSeek / 幻方无官方从属关系，安装与升级请以维护者发布的 Release 与仓库说明为准。

• 目录页：https://www.skillhub.cn/plugins/youhuangqing/dsh-pet-plus
• 源码与文档：https://github.com/youhuangqing/dsh-pet-plus