前言¶
在 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 | 桌面版 0.2.0-rc.1 或 0.2.0-rc.2（README 标明 0.1.7-rc.2 不兼容） |
| 系统 | Windows 优先（桌面小窗与语音朗读依赖 Windows 能力）；其它平台可用浏览器内的宠物 |
| 网络 | 仅首次可能下载 Electron 运行时（约 200MB）；之后可离线使用 |
| Node.js | 不需要单独安装——Release 包内已有构建产物 |
插件在 DSH 进程内加载，权限与当前 DSH 实例相同；安装前建议自行浏览源码与许可证，再决定是否启用。
核心功能¶
README 将新增能力归纳为六组，并与上游命令、菜单并存：
| 功能 | 用法概要 |
|---|---|
| 亲密度 + 喂食养成 | 点击摸头；右键「互动」→ 摸摸头 / 喂小鱼干；/social 查看状态 |
| 番茄钟 | 右键「专注」→ 开始 25 / 10 / 45 分钟；菜单标题显示倒计时 |
| 语音朗读 | 自动朗读宠物台词；右键「偏好 → 语音朗读」开关；/tts status 查看实际提供方 |
| 音效 | 点击、落地、余额、番茄钟结束、升级、喂食等场景；右键「偏好 → 音效」开关 |
| 增强菜单 | 右键新增「互动 / 专注 / 统计 / 偏好」，浏览器内与桌面小窗菜单一致 |
| 每日统计 | 右键「统计」；/stats；HTTP 接口 /dsh-pet-plus-7340/stats?days=7 |
斜杠命令除上表外，仍支持上游风格的 /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 等段。
典型用法¶
互动与专注¶
- 在界面中选中桌宠实例（必要时用
/pet或/pet-plus指定当前宠物）。 - 右键打开增强菜单：「互动」下摸头、喂小鱼干；「专注」下选择 25 / 10 / 45 分钟番茄钟。
- 用
/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 与仓库说明为准。
