打开最新版下载页，在 Assets 中下载 dsh-dafeiyu-0.1.23.tgz，用对应客户端的命令安装；无需解压。不要选择历史版本，也不要下载 Source code 作为安装包：


# 官方桌面端；必须使用应用自带的 dsh
dsh plugin --profile desktop add "C:\Downloads\dsh-dafeiyu-0.1.23.tgz"

桌面端也可在 添加插件 的输入框填写 .tgz 的完整路径。

余额默认出现在大肥鱼状态气泡底部和设置页，查询逻辑由两个客户端共用。设置页可查看总余额、赠送和充值，并手动刷新。

来源	凭据来自哪里	查询内容
自动（默认）	优先使用 DSH 模型设置中的 DeepSeek API Key；未配置时尝试已登录账户	对应来源的余额
API Key	DSH 的凭据服务；旧 Host 无该服务时读取启动环境	DeepSeek `/user/balance`
已登录账户	DSH 的 DeepSeek 账户服务	账户充值与赠送钱包

账户余额和 API 余额的查询方式参考了 keshing/balance-display 与 DSH 的公开账户服务。插件不会发起模型调用。

设置	作用
启用大肥鱼	开关当前 profile 的原生角色
角色大小 / 气泡大小	独立调整；小气泡保留基本字号
安静 / 标准 / 活泼	每次待机动作结束后，分别休息 45～90 / 25～45 / 12～22 秒
减少动态	固定角色姿势，停止待机与点击动画；状态和提示仍实时更新
提示音	所有提示的总开关（只影响声音）
提示音与通知场景	分别开启“对话完成”“工具出错”“等待审批”提示。取消后该场景不再播放声音；macOS 同时不再弹系统通知横幅，Windows / Linux 只播放声音
气泡显示	常驻、隐藏，或仅在指定状态显示
子 Agent	允许子 Agent 状态参与显示
页面内角色	在 DSH 页面右下角显示轻量角色
打开目标	自动、WebUI 或官方桌面端
显示余额 / 余额来源	开关与选择余额查询来源

设置页修改实时生效。右键菜单可调整大小、减少动态、打开对应 DSH 客户端，或仅在本次运行隐藏／关闭角色。

点击动作会完整播完，再回到当前任务状态；新任务可立即打断装饰动作。拖拽期间只播放悬空姿势，松手后完整落地。具体触发、频率和衔接规则见动作说明。

若 WebUI 使用自定义地址，可在启动 Host 时设置 DSH_DAFEIYU_WEBUI_URL；它优先于自动推断的默认地址。

平台	原生角色
Windows 10 / 11 x64	随包提供 Helper；WSL2 可通过 Windows 互操作启动
Linux x64	随包提供 Qt Helper，需要图形桌面；glibc 2.35+，Ubuntu 24.04 有验收记录
Linux arm64	包里没有随架构 Helper，会自动回退到 Python Helper，需要 `python3` 与 `PySide6>=6.7,` 改日志位置，或设为 `off` 关闭；报告问题时可以附上该日志（只含本地路径与启动错误，不含凭据）。

GitHub issue / PR 处理清单记录已处理和仍需补充证据的问题；验收记录保留实际测试结果。这些记录中的旧版本号用于追溯，不是安装建议。

pnpm install --frozen-lockfile
npm test
npm run test:python
npm run build:helper
npm run test:helper:packaged

开发 Python Helper 需要 requirements.txt 中的依赖；macOS Helper 需要 Xcode Command Line Tools。纯 Swift 核心测试运行 swift test。修改原生代码后应重新构建 Helper，再安装本地打包产物。

CI 还会隔离安装 DSH 0.2.0-rc.2 并运行 scripts/test-dsh-settings.mjs，验证新设置接口。该检查不读取用户 profile 或凭据，文件写入使用测试适配器。

项目通过 GitHub Actions 构建三个平台的 Helper 并发布；维护者操作见发布说明。

当前动态素材来自 PC2005-cloud/dsh-pet，以来源的 24 fps 转成透明 WebP 帧。当前清单含 16 组动作、3,444 帧，帧画布为 412 × 344；清单记录了上游版本、视频校验值和取帧范围。

软件代码与角色素材适用不同授权，请完整阅读 ASSET_LICENSE.md、素材来源许可证和 LICENSE。旧版素材及社区拖拽图片保留于 legacy/，不随当前 npm 包分发。

感谢社区在动画、macOS、WSL 和兼容性方面的贡献。想接收更新通知，请订阅仓库 Watch → Custom → Releases；Star 只收藏项目。

dsh-dafeiyu

同名套件的其他儲存庫