前言¶
DeepSeek Harness（DSH）里，会话和工作区通常要在主窗口侧边栏里操作。如果你已经装了 dsh-pet 桌面宠物，想在不打开主窗口的情况下选会话、看历史、继续聊，或者随手框选屏幕提问，就需要一个挂在宠物右键菜单上的入口。dsh-pet-assistant 就是为此做的客户端插件：卡片即轻量会话端，能力对齐侧边栏里可见的会话列表与消息流。
这是什么¶
维护者 Chuzhidezhuzhuboy 在 GitHub 开源的 dsh-pet-assistant（当前版本 0.1.0，MIT 许可），分类为客户端插件。它给 dsh-pet 增加一块桌面小卡片：右键宠物 →「进入会话」，即可列出会话、浏览最近历史、继续对话、框选截图提问、新建工作区、归档会话，以及从回答里保存或定位真实文件。
硬依赖：必须先安装 dsh-pet（菜单项通过它的第三方菜单注册表挂载）。插件本身零运行时依赖，只使用 Node 内置模块；Electron 可执行文件路径与 dsh-pet 一致，例如 ~/.dsh/electron/electron.exe。
安装前需要知道的事¶
本插件会向 dsh-pet 写入 2 行补丁（lib/client.js 与 runtime/electron-helper/sprite.js 的菜单组装处），目的是让「进入会话」出现在一级菜单，而不是「更多」子菜单。补丁带 [dsh-pet-assistant] 标记、幂等、可还原，不改 dsh-pet 的其他逻辑；dsh-pet 升级后插件每 30 秒自检并自动补回。若介意对 dsh-pet 文件的改动，请不要安装。插件以当前 DSH 进程权限运行，安装前建议自行查看仓库源码与许可证。
核心功能¶
| 能力 | 说明 |
|---|---|
| 进入会话 | 列出与侧边栏一致的会话（不显示空白/子会话/已归档），运行中会话带绿点 |
| 看历史 | 最近 60 条用户/助手消息；图片点击后才加载，可滚轮缩放 |
| 继续聊 | Enter 发送、Shift+Enter 换行；回答回流同一张卡，显示等待时长与进度片段 |
| 框选截图 | 点「截图」→ 卡片隐藏 → 全屏冻结 → 拖框 → 右键或回车确认；卡片只显示缩略图 |
| 新建工作区 | 选目录注册为工作区（侧边栏出现同名分组）并新建会话 |
| 归档 | 会话行悬停可归档；「显示已归档」里可取消归档 |
| 文件 | 从回答中识别真实存在的文件，可「保存到…」或「文件夹」定位 |
| 调大小 | 右下角拖拽；手动调整后不再自动改尺寸 |
卡片由本地 HTTP 接口支撑，挂在 DSH webServer 的 /pet-assist 前缀下（如 GET /sessions、POST /submit 等，详见仓库 README）。
安装与启用¶
装完后需重启一次 DeepSeek Harness。右键桌面宠物，菜单里出现「进入会话」即表示启用成功。
方式一：插件页安装（推荐，桌面版）
- 打开 DeepSeek Harness → 插件
- 在安装输入框粘贴 release 包链接
- 安装完成后重启 DSH
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
典型用法¶
- 确认
dsh-pet在运行，并已安装本插件且重启过 DSH。 - 在桌面宠物上右键，点「进入会话」。
- 在卡片里选择一条会话，查看历史；在输入框继续聊，Enter 发送。
- 需要带图提问时，点「截图」，按提示框选区域确认；缩略图会出现在输入区附近。
- 要新开目录工程：点「＋ 新建工作区」，选文件夹；侧边栏会出现对应分组与新会话。
- 回答里若提到本机真实路径的文件，卡片会列出，可用系统另存为或打开所在文件夹。
卡片位置按点菜单时的鼠标位置定位；离屏幕边缘过近时会被夹进工作区。
排查与卸载¶
- 菜单没出现：确认 dsh-pet 在跑；插件每 30 秒重注册菜单。
- 点「进入会话」无反应：可查看
~/.dsh/dsh-pet-assistant/card.log（需把lib/index.js里CARD_LOG_ENABLED与lib/helper/main.js里LOG_ENABLED改为true才会写入）。 - 找不到补丁锚点：插件只打日志，功能仍可用，菜单项可能退回到「更多」子菜单。
卸载示例（资料中为 PowerShell 写法）：
pnpm dsh plugin remove dsh-pet-assistant
卸载后 dsh-pet 里补丁行仍可能存在但不影响运行；要彻底还原 dsh-pet，可重装一次 dsh-pet（插件不在时补丁不会自动重打）。
结尾¶
dsh-pet-assistant 把 DSH 会话能力收到桌宠右键菜单的一张卡片里，适合已经用 dsh-pet、又希望少开主窗口的开发者。社区目录与 GitHub 仓库由维护者独立维护，与 DeepSeek / 幻方无官方从属关系。
