dsh-pet-assistant · 桌宠助手

给 dsh-pet 加一个桌面小卡片：右键宠物 →「进入会话」， 就能看历史、继续聊、框选截图提问、新建工作区、归档会话、收下我发你的文件。

不需要打开 DeepSeek Harness 主窗口——卡片本身就是个轻量会话端。

⚠️ 依赖：必须先安装 dsh-pet（菜单入口由它提供）。

⚠️ 会改动 dsh-pet：本插件会把 2 行补丁写进 dsh-pet 的菜单组装处 （lib/client.js 与 runtime/electron-helper/sprite.js），目的是让菜单项出现在一级菜单 而不是「更多」子菜单里。补丁带 [dsh-pet-assistant] 标记、幂等、可还原， 不改 dsh-pet 的其他任何逻辑；dsh-pet 升级后补丁会每 30 秒自动补回。 介意这一点的话请不要安装。

它长什么样

右键桌面宠物
   ↓
   ┌ 桌宠助手 ──────────────── ×
   │ 选择会话
   │ ● 优化桌宠为快捷会话入口讨论   dsh-pet
   │ ○ 问候                     宠物
   │ [＋ 新建工作区]  [显示已归档]
   └
   ↓ 点一条
   ┌ 桌宠助手 ‹ 优化桌宠为… ─── ×
   │ 你：xxx
   │ 助手：……
   │ ── 以上是历史 · 继续聊吧 ──
   │ [缩略图]
   │ [想说什么…（Enter 发送）]
   │ [截图]          [关闭] [发送]
   └

功能

功能	说明
进入会话	列出会话（和侧边栏一致：不显示空白/子会话/已归档），带运行中绿点
看历史	最近 60 条用户/助手消息；图片点了才加载，点开可滚轮缩放看大图
继续聊	Enter 发送、Shift+Enter 换行；回答回流到同一张卡，带已等待时长和进度片段
框选截图	点「截图」→ 卡片消失 → 全屏冻结 → 拖框 → 右键/回车确认；卡片只显示小缩略图
新建工作区	选一个目录 → 注册成工作区（侧边栏会出现同名分组）+ 建一条会话
归档	会话行悬停出现「归档」；「显示已归档」里可以取消归档
文件	回答里提到的真实文件列出来，可「保存到…」（系统另存为框）或「文件夹」定位
调大小	右下角小把手拖拽；手动调过之后不再自动改尺寸

依赖

• dsh-pet 必须已安装（菜单项是通过它的第三方菜单注册表挂上去的）
• Electron 可执行文件：~/.dsh/electron/electron.exe（dsh-pet 也会下载这一份）

插件本身零运行时依赖，只 import Node 内置模块。

安装

方式一：插件页安装（推荐，桌面版）

1. 打开 DeepSeek Harness → 插件
2. 在安装输入框里粘贴下面这个链接
3. 安装完成后重启 DeepSeek Harness
4. 右键桌面宠物，菜单里出现「进入会话」即成功

https://github.com/Chuzhidezhuzhuboy/dsh-pet-assistant/releases/download/v0.1.0/dsh-pet-assistant-0.1.0.tgz

方式二：命令行（需要装了 dsh CLI；桌面版请用方式一）

下载 dsh-pet-assistant-0.1.0.tgz，在它所在的目录里执行：

dsh plugin install ./dsh-pet-assistant-0.1.0.tgz

方式三：从源码装（需要本机有 git）

dsh plugin install github:Chuzhidezhuzhuboy/dsh-pet-assistant

装完都要重启一次 DeepSeek Harness。

它动过 dsh-pet 的哪里

只有两处，都是为了让菜单项出现在一级菜单而不是「更多」子菜单里：

文件	改动
lib/client.js（网页端菜单）	把 owner === 'dsh-pet-assistant' 的项摊平到一级
runtime/electron-helper/sprite.js（桌面端菜单）	同上

• 改动带 [dsh-pet-assistant] 标记，幂等：已打过就跳过
• 插件每 30 秒自检一次，dsh-pet 升级/重装后补丁会自动补回来
• 找不到锚点就只打日志，功能仍然可用（菜单项退回到「更多」里）

接口（本地 HTTP，挂在 webServer 的 /pet-assist 前缀下）

方法	路径	作用
GET	/sessions?archived=1	会话列表（可选包含已归档）
GET	/history?sessionId=&max=	最近若干条历史消息
GET	/attachment?sessionId=&id=	按需取一张历史图片
POST	/submit	提交（文字 + 可选 dataURL 图片）到会话
GET	/answer?sessionId=&since=	取这一轮的回答 / 等待进度
POST	/new-session	注册工作区 + 建会话
POST	/archive	归档 / 取消归档
POST	/files	从回答文本里认出真实存在的文件
POST	/capture	（旧路径）抓一张整屏，卡片里框选，已被桌面选区取代

排查

• 菜单没出现：看 dsh-pet 是否在跑；插件每 30 秒重注册一次菜单
• 点「进入会话」没反应：看 ~/.dsh/dsh-pet-assistant/card.log（把 lib/index.js 里 CARD_LOG_ENABLED 和 lib/helper/main.js 里 LOG_ENABLED 改成 true 才会写）
• 卡片位置怪：卡片按"点菜单时的鼠标位置"定位，鼠标离屏幕边缘太近会被夹进工作区
• Electron 相关：这台机器上 electron.exe app.js --任意参数 会让 Chromium 初始化崩溃， 所以所有参数都走环境变量传，命令行只给 app 路径

卸载

pnpm dsh plugin remove dsh-pet-assistant

菜单补丁是 dsh-pet 里的几行，卸载后不影响 dsh-pet 运行（只是它会把这几行当成普通代码）。 要彻底还原 dsh-pet，重装一次 dsh-pet 即可（补丁不会自动重打，除非插件还在）。

许可

MIT