前言¶
DeepSeek Harness（DSH）采用插件化架构，通过扩展组件丰富 Web GUI 的功能。dsh-pet-liangzi 是其中一款桌面宠物插件，它为界面增加了一个拟人化的角色形象。该插件旨在通过交互式动画和语音反馈，缓解长时间使用工具的视觉疲劳，同时提供一种轻量级的个性化体验。
插件定位¶
- 名称：dsh-pet-liangzi（梁子桌面宠物）
- 维护者：bauerelizabeth07139
- 分类：趣味换装
- 许可证：MIT
- 定位：一个自包含的桌面宠物，无需网络请求或外部服务即可运行。它包含 16 种绘制的角色状态、物理交互效果、语音对话以及跨插件的联动能力。
核心能力¶
该插件的核心价值体现在动画细节、交互反馈与生态联动三个方面。
1. 动画与物理表现¶
- 16 种绘制的状态：角色拥有包括待机、眨眼、行走（左右脚交替）、欢呼、说话、思考、比心、难过、生气、惊讶、睡觉、挥手、「嘘」手势在内的 16 种独立姿态。这些姿态通过图像生成技术保留原作细节，仅改变动作。
- 三帧走动循环：实现了真实的角色走动效果，包含接触、过步、接触三个帧，地面速度由步频决定，而非自由设定，确保双脚与地面的贴合。
- 物理交互：支持重力、挤压与拉伸等物理效果。被拖拽时，角色会跟随拖拽方向；松开后会受重力下落，落地时伴随挤压和闪光粒子效果。
2. 交互与自主行为¶
- 环境感知：角色会自动监测鼠标指针位置，靠近时转头注视。
- 自主微动作：在无人交互时，角色会随机进行思考、「嘘」手势、欢呼、比心或生气的自发性动作。
- 反应机制：点击角色可唤醒并触发对话；快速连续点击 3 次会让角色感到恼火。
3. 跨插件联动¶
- 父女联动：当同时安装
dsh-pet-dafeiyu（大肥鱼）插件时，两者会产生互动。它们会互相问候、搭话，并在设定中开启「父女小剧场」时共同演一段共享的交互场景。
4. 音频与资源¶
- 语音对话：所有台词均包含预渲染的语音和字幕气泡。
- 独立音轨：对话语音、音效和背景音乐均设有独立的开关和音量控制。
- 资源独立性：所有素材（精灵图、音频文件）均打包在插件包内，不依赖 CDN 或外部网络服务。
安装与启用¶
安装过程需要使用 DSH 的命令行工具。请确保已安装 DSH 并配置好 desktop profile。
安装命令¶
在终端中执行以下命令以安装插件：
dsh plugin --profile desktop add bauerelizabeth07139/dsh-pet-liangzi
启用插件¶
- 安装完成后，在 DSH 的插件管理页面启用
dsh-pet-liangzi。 - 进入 设置 → 桌宠 · 梁子。
- 根据需要调整角色大小、不透明度以及走动、小动作等开关。
无 Git 环境¶
如果在机器上未安装 Git，直接运行上述命令可能会因 pnpm 无法解析远程仓库而失败。此时需要将 Git 仓库的 tarball 固定链接并使用 HTTPS 下载：
cd "$HOME/.dsh/profiles/desktop"
node /path/to/dsh/runtime/pnpm.mjs add \
"https://codeload.github.com/bauerelizabeth07139/dsh-pet-liangzi/tar.gz/<commit-sha>"
典型用法¶
安装并启用后，角色会出现在浏览器窗口的底部边缘。
- 唤醒与对话：点击角色，它会被唤醒并说出台词，同时显示字幕气泡。
- 移动与放置：按住角色可以拖拽到屏幕任意位置，松开后位置会被记忆。
- 工具栏控制：将鼠标悬停在角色上，会出现工具栏，可快速切换对话语音、音效、背景音乐和显示开关。
- 闲置休眠：若长时间不与角色互动，它会自动进入睡眠状态；再次点击即可唤醒。
- 父女小剧场：在设置中开启「父女小剧场」，并确保已安装
dsh-pet-dafeiyu，即可触发两者的互动场景。
注意事项¶
- 浏览器音频策略：现代浏览器禁止页面自动播放音频。在用户首次点击页面或角色之前，界面上会出现 「点一下开启声音」 的提示，点击任意位置后音频播放才会解锁。
- 资源完整性：该插件不依赖任何网络资源，所有资产均内置，确保离线环境也能正常使用。
结语¶
dsh-pet-liangzi 通过精细的动画帧和物理反馈，为 DeepSeek Harness 增添了生动的角色属性。它不仅是一个视觉装饰，更是一个具备自主行为和跨插件联动的交互组件。对于追求界面个性化或希望为开发环境增加趣味性的用户，这是一个实用的补充。
