Name: dsh-dfy
Author: d70w

Installazione

dsh plugin --profile web add github:d70w/dsh-dfy

README

dsh-dfy 标志

dsh-dfy

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

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

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

鲸鱼娘桌宠立绘

她能做什么

像桌宠一样互动	有情绪地回应	在 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

dsh plugin --profile web add dsh-dfy

安装后启动 DSH：

dsh web --port 3088

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

npm install dsh-dfy

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

本地包验收

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/ 运行资源。

开发与验证

完整检查：

corepack pnpm install
corepack pnpm run verify

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

真实浏览器验收：

python tests/run_browser_e2e.py --dsh-home <isolated-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。默认角色是“鲸鱼娘形象”的获批 chibi-maid 衍生资源，角色栅格素材遵循 CC BY-NC-SA 4.0。作者、来源、改动链和再分发说明见 ASSETS_LICENSE.md 与 character-packs/default-whale/SOURCE.md。

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