前言¶

DeepSeek Harness（DSH）的核心理念是“一切皆插件”，开发者可以通过扩展来定制工作流。对于习惯长时间在终端或 Web 界面工作的开发者而言，屏幕上的反馈往往只有文字输出，缺乏交互感。dsh-ds-vpet 插件旨在通过仿《虚拟桌宠模拟器》的交互体验，为 DSH Web 界面提供一个可视化的陪伴对象，同时兼顾实用功能。

插件简介¶

dsh-ds-vpet（DSH 虚拟桌宠）由开发者 Kotegawa-Chisa 维护。这是一款基于 DSH Web 环境的客户端插件，不涉及 DSH 核心逻辑的修改。它通过立绘切换、气泡对话和桌面交互，模拟虚拟桌宠的行为模式，支持通过 API 查询账户余额并提供视觉反馈。

核心功能¶

1. 多状态立绘与交互

   • 立绘切换：支持常态、等待（随机 2 选 1）、思考完成庆祝三种状态，立绘会随状态自动变化。
   • 点击互动：点击人物可触发连击喵叫。
   • 拖拽与缩放：支持按住鼠标拖拽移动（拖拽时人物会有变形效果），使用鼠标滚轮可调整大小（30% 至 300%）。

2. 定时与对话系统

   • 按时说话：内置 8 个时间段（早晨、午休、深夜等）的专属台词。
   • 双语支持：所有台词支持中英文实时切换。
   • 思考检测：当 DSH 模型处于思考状态时，插件会监听状态变化；思考结束后，立绘会自动切换至庆祝状态并发表评论。

3. 实用工具

   • 余额计数器：通过 DEEPSEEK_API_KEY 凭据查询账户余额，实时显示在界面上。当余额低于设定的预警值时，计数器会变红。
   • 齿轮设置：提供深蓝色主题的设置面板，可配置最上层显示、余额计数器开关、隐藏/唤出桌宠、说话频率以及语言偏好。

4. 自定义

   • 立绘替换：插件依赖 assets/ 目录下的 PNG 文件。用户可自行替换 1.png（常态）、2.png 和 3.png（等待）、4.png（庆祝）来更换立绘形象。

安装与启用¶

在安装前，请确保已正确安装 DeepSeek Harness，且 dsh web 服务能够正常启动。

1. 本地路径安装（推荐）

将仓库克隆或下载到本地后，使用绝对路径添加插件：

dsh plugin --profile web add /绝对路径/dsh-ds-vpet

2. GitHub 子路径安装

dsh plugin --profile web add 'github:<你的用户名>/dsh-ds-vpet#path:/'

3. 安装后配置

1. 重启服务：新增插件必须重启 dsh web 才能加载。
2. 刷新页面：在浏览器中刷新页面（Ctrl+F5），桌宠通常会出现在页面右下角。
3. 进入设置：打开 DSH 设置，找到「桌宠」选项卡，根据需要调整立绘大小、说话频率、语言等参数。

典型用法¶

• 日常陪伴：插件会根据当前时间自动触发问候或提醒台词。
• 余额监控：在设置中开启余额计数器，实时关注 API 使用额度。
• 更换形象：将准备好的透明背景 PNG 图片放入插件目录的 assets/ 文件夹，保持文件名不变（如 1.png），刷新页面即可生效。

注意事项¶

• 纯展示层插件：该插件属于客户端插件，仅负责界面展示和交互，不修改 DSH 核心代码。
• API 依赖：余额计数器功能依赖于环境变量 DEEPSEEK_API_KEY，若未配置该凭据，余额显示将不可用。
• 素材来源：内置立绘素材来源于网络，用户自行替换时需注意素材版权。
• 缓存机制：余额查询结果有 30 秒的缓存刷新周期。

总结¶

dsh-ds-vpet 是一款结合了娱乐性与实用性的 DSH 插件。它通过模拟虚拟桌宠的交互方式，解决了长时间使用命令行工具的单调感，同时通过余额监控等功能辅助开发决策。开发者可以根据自身需求，通过替换素材和调整配置，将其打造为专属的代码伴侣。

GitHub 仓库 | 社区目录