hytime/dsh-companion

DSH Companion 🐋 鲸鱼娘陪伴插件

一只悬浮在 DeepSeek Harness 里的鲸鱼娘,陪伴你的日常:展示旅伴的对话回复与情绪状态,收发定时陪伴提醒。

「hy-companion 陪伴系统」的 DSH 前端,由「插件 + 技能 + CLI」三件套构成:前端插件显示并反馈 Skill/CLI 状态;DSH 技能调用 hyc CLI;hyc 转由线上服务产出结构化 text/emotion/status 响应。前端插件只接收可序列化的状态,不直接访问 DSH Host/Client Service、credentials 或 live runtime 对象。

✨ 功能特性

- 鲸鱼娘悬浮立绘:可拖动、位置记忆,表情帧随状态切换(idle / thinking / replying / error…)
- 对话回复气泡:状态文案和真实回复使用旅伴气泡显示,打字机逐字输出,宽度自适应
- 右键聊天菜单:通过“和旅伴聊聊”进入主对话,不打开状态窗口
- 情绪状态:实时切换旅伴表情帧
- 定时陪伴提醒:buddy 消息弹窗提醒
- 前置自愈:缺失 hyc CLI 或技能时自动安装,开箱即用
- 安全边界:不写入任何凭据,不访问 DSH 内部对象

📸 效果预览

| 悬浮立绘 | 对话回复气泡 |
|---|---|
| 悬浮立绘 | 对话回复气泡 |

| 定时陪伴提醒 |
|---|
| 定时陪伴提醒 |

🚀 快速开始

前置要求:装有 DeepSeek Harness(宿主注入 window.__DSH_BOOT__)。

1) 安装插件(二选一)
dsh plugin add github:hytime/dsh-companion   # 从 GitHub 安装
dsh plugin add @hytime/dsh-companion          # 从 npm 安装

2) 重启 DSH

重启后插件自动检查前置并补齐:

- 缺失 hyc CLI → 自动 npm i -g @hytime/hyc
- 缺失 DSH 技能 → 自动安装技能包并写入 $DSH_HOME/skills

全部就绪后,悬浮鲸鱼娘出现在页面右下角。右键鲸鱼可选择“和旅伴聊聊”,状态与回复会通过气泡显示。

⚙️ 配置插件

DSH 设置 → Plugins → dsh-companion：

- 账号与密码：hyc 账号登录 / 注册 / 登出（页面内完成，凭据存系统 Keychain）
- 基本配置：旅伴名称、用户称呼、好感度 / 回复气泡显示开关
- 事件提醒：buddy 提醒开关与间隔、定时陪伴事件管理（启停 / 删除）

📦 组件构成

| 包 | 说明 | 安装方式 |
| --- | --- | --- |
| @hytime/dsh-companion | DSH 前端插件(鲸鱼娘悬浮窗) | dsh plugin add |
| @hytime/hy-companion-skills | DSH 技能(11 个),安装到 $DSH_HOME/skills | npm i -g + hy-companion-install |
| @hytime/hyc | CLI 入口(平台二进制分包分发,当前提供 darwin-arm64) | npm i -g |

🛠 常用使用

hyc chat --msg "你好啊"                    # 与旅伴对话
hyc personality get                         # 查看人设
hyc affection                               # 查看好感度
hyc buddy list --page-size 1                # 查看最新陪伴提醒
hyc schedule                                # 管理定时陪伴

📚 详细文档

- 开发与发布手册(仓库维护者:构建、测试、发布流程)

📄 License

MIT