前言¶

在 DeepSeek Harness（DSH）里装桌宠插件，常见做法是随机动作、右键点播、偶尔碎碎念或对话——内容多半来自文本模型，和眼前正在做的事关系不大。若希望宠物能「看见」主屏、随口吐槽一两句、又不必像对话那样来回回复，需要在 dsh-pet 能力之上单独做识屏与视觉模型链路。下面介绍社区插件 dsh-pet-read（维护者 yhm0619，GitHub 约 3 stars，社区目录分类为趣味换装）：它是 PC2005-cloud/dsh-pet 0.3.8 的 fork，保留上游桌宠与 pet pack 能力，把「碎碎念」扩展为可选的「互动碎碎念」。

这是什么¶

dsh-pet-read 在 npm 包名上仍叫 dsh-pet（当前版本 0.3.8-read.6）。安装本仓库会替换已存在的同名上游包；原始版权归 PC2005-cloud，修改部分版权归 yhm0619，遵循 MIT 许可。

一句话定位：基于 dsh-pet 的「互动碎碎念」修改版——桌面端按间隔截取主屏，调用视觉模型生成 1～2 句吐槽，经上游统一的 /state 气泡链路显示在宠物头顶；单向输出，不需要回复，不带表情包。

与上游 dsh-pet 的关系¶

上游提供透明置顶桌宠、97 个动画、漫游与物理、随机碎碎念与对话等；本 fork 不删减这些能力，主要增量如下。

1. 互动碎碎念：右键「碎碎念」子菜单在「随机碎碎念」（上游）与「互动碎碎念」（新）之间切换。开启后，桌面 Helper 按 interactiveIntervalSec（默认 30 秒）截主屏 → 宿主调视觉模型 → 写入头顶气泡；再点「互动碎碎念（已开启）」关闭。
2. 人设导入：设置页「人设（可选）」下增加「导入文本」，支持 .txt / .md / .markdown / .json（JSON 可读 whisperPrompt、persona、prompt、text 或 main.whisperPrompt），导入后需点「保存」。
3. 识屏与接话：先让视觉模型把画面归类（写代码、调代码看报错、打游戏、看视频、学习、看文档、逛网页、刷评论、聊天、办公、发呆等），再生成吐槽；带最近 5 条记录做同画面递进，重复会重试或安静一轮。桌面 Helper 每 30 秒算 16×9 画面指纹，连续约 90 秒无明显变化时按「发呆 / 看入神」处理，避免复读画面。
4. 设置页扩展：每只宠物卡片上可配置看屏幕间隔（5～3600 秒，默认 30）、互动风格（软萌 / 毒舌搭子 / 完全跟随人设）、视觉服务商与模型、接口地址、视觉模型 API Key 等。

互动碎碎念仅桌面模式可静默截屏；在浏览器端开启只会提示需要桌面模式。

视觉模型与配置¶

默认视觉配置指向智谱 glm-4.5v（关思考）；README 建议在设置页改为 glm-4.6v，或按延迟与成本选用 glm-4.6v-flashx、glm-4.6v-flash。服务商还可选豆包 / 火山方舟、OpenAI、自定义 OpenAI 兼容接口。

本 fork 新增的配置字段包括（节选，完整以 README 为准）：

• interactiveIntervalSec、interactiveMaxChars、interactiveStyle
• interactiveVisionProvider、interactiveVisionModel、interactiveVisionBaseUrl、interactiveVisionApiKey、interactiveVisionEnvFile

API Key 优先级：设置页输入（明文写入本机 main-config.jsonc）> 环境变量 > 本地 .env。仓库内不含 Key；也可在启动前设置 ZHIPU_API_KEY，或将 interactiveVisionEnvFile 指向本地 .env。

安装与启用¶

在 dsh web 侧安装 fork（命令以 README 原文为准）：

dsh plugin --profile web add github:yhm0619/dsh-pet-read

桌面应用的插件管理页若支持 GitHub 地址，也可填写 github:yhm0619/dsh-pet-read。

安装前若已装上游 dsh-pet，建议备份 $DSH_HOME/dsh-pet/main-config.jsonc（旧版可能是 main-config.json，上游首次启动会自动迁移）。装完后重启桌面应用或重启 dsh web 才生效。

互动碎碎念需要视觉模型 Key：重启后在设置页填写「视觉模型 API Key」，或按上文设置环境变量 / .env。

典型用法¶

1. 按上一节完成安装并重启 DSH；确认桌宠在桌面模式可用（默认 display: "both" 时，浏览器与桌面各有一只，可在设置或右键「显示位置」里只留桌面）。
2. 在宠物上右键 → 碎碎念 → 互动碎碎念，开启识屏吐槽；再次进入同一菜单项（显示为已开启）可关闭。
3. 打开设置页，为对应宠物配置看屏幕间隔、互动风格、视觉服务商与 API Key，保存后桌面 Helper 会按新间隔重排定时器。
4. 若只需上游那种与屏幕无关的随机碎碎念，仍选子菜单里的「随机碎碎念」即可。

上游快速安装命令是 dsh plugin --profile web add dsh-pet；本 fork 必须使用 github:yhm0619/dsh-pet-read，否则会装到 npm 上游而非识屏版。

适用场景与注意¶

适合：已在 DSH 使用 dsh-pet、希望桌宠偶尔根据主屏内容单向吐槽、且能接受视觉模型 API 成本的开发者。

注意：

• 插件以当前 DSH / 桌面 Helper 进程权限运行；静默截屏仅发生在桌面模式，安装前应阅读 GitHub 仓库 源码与 MIT 许可，自行评估隐私与 Key 存放方式（main-config.jsonc 明文 Key）。
• 包名与上游相同，安装即替换；误装或回退上游时需重新安装官方 dsh-pet 并恢复配置备份。
• 社区目录 skillhub.cn 为独立站点，与 DeepSeek / 幻方无官方从属关系；星标与分类以目录与 GitHub 当时信息为准（资料中 GitHub 约 3 stars）。

结尾¶

dsh-pet-read 在完整保留 dsh-pet 桌宠体验的前提下，用定时识屏和视觉模型把碎碎念改成「看着屏幕随口说两句」——配置集中在设置页与右键菜单，默认 30 秒一轮、可调间隔与语气风格。

• 社区目录：https://www.skillhub.cn/plugins/yhm0619/dsh-pet-read
• 源码与说明：https://github.com/yhm0619/dsh-pet-read