dsh-dfy

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-03），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

[图片: dsh-dfy 标志]

dsh-dfy

住进 DeepSeek Harness 工作台的鲸鱼娘桌宠

  会呼吸、会摇晃、能抓起来玩，也会用表情和对话陪你工作。

  English
  · 安装
  · 实机画面
  · 功能
  · 原理

  [图片: npm version]

  [图片: npm downloads]

  [图片: GitHub stars]

  [图片: DeepSeek Harness plugin]

  [图片: Node 22.19 or newer]

  [图片: MIT license]

  [图片: 鲸鱼娘桌宠立绘]

---

## 她能做什么

| 像桌宠一样互动 | 有情绪地回应 | 在 DSH 内对话 | 看得懂你的消耗 |
| --- | --- | --- | --- |
| 点击 Q 弹、抓取摇晃、缩放与位置记忆 | 16 种情绪、独立眼眉嘴变形与专属特效 | 离线台词或自定义 OpenAI 兼容模型 | 官方余额刷新与本地 Token 小账单 |

> 当前稳定互动入口只有：**摸摸她、给她白饭、和她说话、让她表演**。开发中的实验动作不会混入正式功能说明。

## 实机画面

> 以下画面直接截取自最新版 DSH Web Profile 中正在运行的插件，不是测试页或概念图。

  [图片: dsh-dfy 在 DSH 工作台中的实际运行画面]

桌宠与 DSH 工作台自然共存 · 不遮挡主要操作区域

    [图片: 桌宠互动菜单实机画面]

    [图片: 桌宠对话模型设置实机画面]

    互动菜单
常用动作与最近互动记录
    对话设置
离线模式与自定义在线模型

### 情绪瞬间

表情不只是换一句台词：眼睛、眉毛、嘴型、身体姿态和周围特效会一起变化。

    [图片: 鲸鱼娘喜欢表情与爱心特效实机画面]

    [图片: 鲸鱼娘生气表情与怒气特效实机画面]

    喜欢
闭眼微笑、腮红与漂浮爱心
    生气
压眉撇嘴、怒气符号与专属台词

## 功能

### Live2D 风格桌宠

- 透明 Canvas 分层渲染，统一使用 1280×1280 设计坐标系。
- 头发、呆毛、眼睛、眉毛、耳朵、身体、裙子、腿、尾巴和服装附件分别驱动。
- 呼吸、眨眼、视线、身体关节与次级部件持续运动。
- 支持抓取点物理：离抓取点越远，惯性摆动越明显。
- 点击会触发 QQ 弹、局部跟随、随机表情和可持续腮红。
- 桌宠大小、位置、安静模式和减少动态设置保存在当前设备。

### 表情与演出

- 喜欢、害羞、生气、惊讶、难过、开心、困惑、委屈、困倦、得意、期待、坏笑、安心、认真、紧张和馋嘴等情绪。
- 每种情绪使用不同的眼眉嘴变形、身体姿态与粒子效果。
- 爱心、怒气、问号、眼泪、汗滴、`Z` 和白饭均为视觉特效，不是文字占位。
- 可随机播放已校准的一次性演出视频；播放期间与实时桌宠无缝交接。

### 对话与记忆

- 头顶气泡只显示鲸鱼娘说的话，独立输入框位于角色下方并可拖动。
- 支持符合角色设定的离线台词，也可接入 OpenAI 兼容接口。
- 可保存多个模型配置、检测连接并读取模型列表。
- 本地保存有限的对话历史与轻量记忆，在线模型会参考最近上下文。
- 在线调用失败时会清晰回退到离线回应，不会让角色失去反应。

### 余额与本地账单

- Host 端代理 DeepSeek 官方余额接口，浏览器端不会接触 Host 凭据。
- 可设置定时刷新，默认每 10 分钟更新一次官方余额。
- 根据 DSH 提供的输入、缓存命中、缓存写入和输出 Token 统计本地消耗。
- 可按天和按小时查看用量；官方余额与本地估算始终明确区分。

## 安装

### 推荐：安装到 DSH Web Profile

```sh
dsh plugin --profile web add dsh-dfy
```

安装后启动 DSH：

```sh
dsh web --port 3088
```

也可以在普通 npm 项目中安装：

```sh
npm install dsh-dfy
```

> 插件运行依赖由 DSH Web Profile 提供。如果普通 npm 项目自动解析整套 DSH peer 依赖时出现 `ERESOLVE`，可使用 `npm install --legacy-peer-deps dsh-dfy`。

### 本地包验收

```sh
corepack pnpm install
corepack pnpm run build
npm pack
dsh plugin --profile web add ./dsh-dfy-0.1.5.tgz
```

## 和 DSH 如何协作

`dsh-dfy` 以一个 Host/Browser Cordis 插件运行：

- 界面挂载到 `shell.overlay` 与 `settings.section`，不会替换 DSH 主页面。
- Host 端只向浏览器投影有限状态，不传递提示词、工具参数、文件路径或输出正文。
- 角色设置和位置保存在当前设备，不会跨设备同步。
- 正式安装包只分发 `character-packs/default-whale/runtime/production-v1/` 运行资源。

开发与验证

完整检查：

```sh
corepack pnpm install
corepack pnpm run verify
```

`verify` 包含 TypeScript 类型检查、273 个 Vitest 测试、正式构建和 npm 包内容预览。

真实浏览器验收：

```sh
python tests/run_browser_e2e.py --dsh-home  --port 3088
```

视觉调试面板仅在 URL 带 `?whaleDebug=1` 时启用。

仓库与 npm 包边界

仓库保留源码、测试、正式运行资源、许可证以及归档开发文档。npm 正式包只包含构建产物、运行资源、README 和许可证，不包含：

- `node_modules/`、构建缓存和测试输出；
- `artifacts/` 中的历史预览、视频分析与验收截图原件；
- PSD、临时抠图源和 E2E 临时 DSH Home；
- `character-packs/default-whale/source/` 下的开发期源素材；
- `docs/archive/` 中的体验、设计和后续规划文档。

## 已知限制

- 大角度肘部表演、跳跃落地、更丰富的嘴型和更多语义表情仍需要新的局部素材与网格权重。
- 当前白饭互动不会真正扣减库存。
- 八小时长时间运行、低端设备性能测试和完整屏幕阅读器验收仍属于后续发布门槛。
- 思考状态资源作为上线后的开发方向保留，正式运行不启用思考态移动动画。

## 许可证与素材

插件代码采用 [MIT License](./LICENSE)。默认角色是“鲸鱼娘形象”的获批 chibi-maid 衍生资源，角色栅格素材遵循 CC BY-NC-SA 4.0。作者、来源、改动链和再分发说明见 [ASSETS_LICENSE.md](./ASSETS_LICENSE.md) 与 [character-packs/default-whale/SOURCE.md](./character-packs/default-whale/SOURCE.md)。

  让工作台里真的住着一位会回应你的鲸鱼娘。