前言¶
在 DeepSeek Harness（DSH）里做 Agent 开发时，界面往往以对话和工具调用为主，缺少常驻、可互动的视觉反馈。独立项目 DaiMeow 已经把 Live2D 模型、动作和交互做得比较完整，但它是另一套运行形态。DaiMeow DSH（yubdey/daimeow-dsh）由维护者 yubdey 发布，归类为趣味换装类插件，把 DaiMeow 的模型与交互接到 DSH 宿主上，并在桌面上以透明置顶窗口显示呆喵，同时提供 Agent 工具和截屏识图点评。下面按安装、配置和日常用法说明其实际能力，均以仓库 README 为准。
这是什么¶
DaiMeow DSH 是面向 DSH Desktop 的桌宠插件，简介表述为：DaiMeow Monster Hunter Palico desktop pet plugin for DeepSeek Harness。当前唯一运行形态是桌面全屏模式：启用插件后宿主会启动独立的 Electron helper，在主显示器工作区创建透明、无边框、置顶、默认点击穿透的窗口，Live2D 呆喵显示在桌面上，而不是嵌在 DSH 网页里。DSH 页面只保留一个在桌宠隐藏时出现的「显示呆喵」入口。桌宠与 DSH 通过 stdout 状态回报、本机回环 HTTP 控制通道和本地路由通信。
插件版本在 package.json 中为 1.0.0，源代码采用 MIT 许可；Live2D Cubism Core、模型素材及《怪物猎人》相关权利另有说明，见仓库 THIRD_PARTY_NOTICES.md。GitHub 仓库当前星标为 1。
核心功能¶
Live2D 与桌面交互¶
- Live2D 模型与 21 个动作，含站姿、坐姿和随机待机状态机。
- 点击互动、拖动、鼠标视线跟随、气泡台词和右键菜单。
- 鼠标穿透由渲染端上报命中区域，主进程按真实光标位置切换
setIgnoreMouseEvents；菜单打开时临时锁定完整交互，关闭后恢复穿透。 - 窗口置顶、隐藏/显示、托盘菜单和「恢复交互」；位置、大小、透明度、固定位置、穿透、置顶和显隐状态会持久化。
截屏识图点评¶
左键点击呆喵时会截取主屏画面，调用 DSH 当前多模态模型识别内容，并以「元气随从喵」人格生成不超过 25 字的短回复；连续触发有 5 秒内置冷却。视觉请求在模型声明支持时默认使用 reasoningEffort: off，不支持关闭思考的服务商会省略该参数。截图经压缩为 480×270 JPEG，写入 DSH 附件服务后走 ctx.llm.stream()；插件自身不保存 API Key，原 DaiMeow 的 AI 服务商配置与聊天历史面板不属于本插件。
Agent 联动¶
宿主提供三个 Agent 工具：
pet_say(text, action?, durationMs?)：让呆喵说短话。pet_control(action)：播放动作、坐下/站起、显示/隐藏、截屏识图或恢复默认等。pet_status()：读取连接数、helper 状态、最近反应和动作列表。
Agent 开始工作、调用工具和结束轮次时，可依据配置自动播放动作及短台词。可用动作示例包括 nod、happy、cheer、hello、thinking、idea、sit、stand_up、capture_screen 等。
运行架构（简述）¶
DSH Web UI 侧的 daimeow-dsh client 只渲染「显示呆喵」启动胶囊；index.js 注册 SSE 与 detached 相关路由，启动 Electron helper。helper 通过 stdout 公布本机控制地址，Host 将 daimeow/reaction 等帧 POST 到该地址（仅绑定 127.0.0.1，路径带每次启动的随机令牌）。页面轮询 /daimeow/detached/status，在窗口隐藏时显示恢复入口；左键截屏识图流程在 helper 与 Host 之间协作完成。更细的模块划分见仓库 README 中的目录树说明。
环境要求¶
- 已安装并可运行的 DSH Desktop。
- 独立 Electron 运行时，按顺序解析：环境变量
DSH_PET_ELECTRON_PATH，或%USERPROFILE%\.dsh\electron\electron.exe。若后者不存在，可设置环境变量，或安装提供该运行时的dsh-pet。
插件分发包不需要安装 npm 依赖；Node.js（>=22.12.0）主要用于本地构建与语法检查。
安装与启用¶
插件以当前 DSH 进程权限运行。安装前应自行查看仓库源码与许可证，确认可接受第三方素材与网络调用（截屏识图会使用当前配置的模型服务商）。
在 DSH 插件管理器的「添加插件」中填写仓库地址：
https://github.com/yubdey/daimeow-dsh.git
也可以将本地绝对路径作为插件来源（需先自行取得仓库目录）。插件的安装、启用和停用应通过 DSH 插件管理界面完成，不要手工修改 profile 的 package.json 或 profile 级 cordis.patch.yml。
从源码开发时，可在插件根目录执行：
npm run build
npm run check
npm test
npm run build 会生成 client.js 以及 runtime/electron-helper/assets.js、runtime.js，不要直接编辑这些生成文件。
配置¶
插件在 bundle 自带的 cordis.patch.yml 中声明默认配置，例如：
- insert:
- id: daimeow-dsh
name: 'daimeow-dsh'
config:
autoReactions: true
desktop: true
| 字段 | 默认值 | 说明 |
|---|---|---|
autoReactions |
true |
根据 Agent 轮次和工具事件自动播放反应 |
reactionThrottleMs |
1200 |
同类自动反应的节流时间（毫秒） |
desktop |
true |
插件启用时自动启动桌面 helper |
启停与改配置应通过 DSH 插件管理界面或该 bundle 自己的 patch 完成。
典型用法¶
- 在插件管理界面安装并启用
daimeow-dsh，确认 Electron 运行时可用后，桌面应出现透明覆盖层上的呆喵。 - 左键点击：触发互动并截屏识图生成一句短评（5 秒内重复点击不会再次请求模型）；需 DSH 当前模型支持图片输入。
- 拖动：改变位置并保存。
- 右键：打开动作、缩放（0.75x / 1.0x / 1.25x）、透明度、固定位置、鼠标穿透和置顶等菜单。
- 托盘：显示、隐藏、恢复交互；「退出呆喵」与右键「关闭呆喵」共用停用流程，会同步关闭 DSH 插件。
- 在 Agent 对话中调用
pet_say、pet_control、pet_status，观察自动反应与手动指令下的动作和台词。
若开启鼠标穿透后无法再点到呆喵，可从托盘选择「恢复交互」。
适用场景与注意¶
适合谁：希望在 DSH 开发或日常使用的同时，桌面上有 Live2D 桌宠反馈，并让 Agent 通过工具控制呆喵台词与动作；趣味换装类展示场景下也适用。
局限（仓库已说明）：仅覆盖主显示器工作区，不含任务栏；helper 崩溃后不会自动重启；截屏识图依赖多模态模型与宿主附件服务，纯文本模型会提示无法看图；多显示器尚未支持。关闭呆喵会经 DSH Remote 停用整个插件 bundle，与在插件页关开关走同一路径。
排查提示：桌面窗口未出现时，先确认 Electron 路径或 DSH_PET_ELECTRON_PATH，再停用并重新启用插件，并查看 Host 控制台 [daimeow-helper] 日志。页面无恢复入口时，重载插件并刷新；/daimeow/detached/status 在隐藏状态下应体现 visible: false 等字段。
结尾¶
DaiMeow DSH 把 DaiMeow 的 Live2D 桌宠接到 DSH 宿主：桌面透明窗口承载模型与交互，页面只保留显隐入口，Agent 侧有 Say/Control/Status 三工具，点击呆喵还可借用当前视觉模型做短评。DSH 生态强调「一切皆插件」；社区目录站点与 DeepSeek / 幻方无官方从属关系，本插件信息以维护者仓库为准。
- 目录页：https://www.skillhub.cn/plugins/yubdey/daimeow-dsh
- GitHub：https://github.com/yubdey/daimeow-dsh
