dsh-Dfy

dsh-Dfy DeepSeek Harness（DSH）的桌宠与挂件套件 · v0.7.6

小鲸鱼余额挂件 + 桌宠（106 段透明动画）+ QQ 消息卡，QQ / B站 / 双向脱敏记忆由包内自带的 SurfCore 提供。 English: an all-in-one DeepSeek Harness (DSH) plugin — balance whale widget, transparent desktop pet, QQ chat through AstrBot (plugins) with every conversation mirrored into its own DSH session, Bilibili dynamics/comments, and local redacted memory. One plugin for the DSH web GUI; data stays on this machine. 在 DSH「添加插件」里怎么填：粘贴 github:louke6572/dsh-Dfy（或完整地址 https://github.com/louke6572/dsh-Dfy）。不要输入 dsh-Dfy —— 那是显示名，不是包名； 而 npm 上的 dsh-dfy 是别人的包（同名不同项目），输入它只会装错。

只有一个插件 dsh-Dfy。以前分开安装的 surfcore、surfcore-next、whale-widget 已经合并进这一个包， 不需要也不应该再单独安装它们。 命名：界面、文档、仓库名统一写 dsh-Dfy；包名与目录名是全小写 dsh-dfy（npm / Node 的硬性要求）， 所以命令里出现 dsh-dfy（安装、卸载）是正常的。 能做什么 QQ 接入架构（2026-11 起） SnowLuma 只负责 QQ 登录；AstrBot 负责消息接入和插件；DSH 负责「想和说」。 DSH 侧每段 QQ 对话一个会话（侧栏 agents 工作区可见），可切模型、看思考、看上下文。 首次安装后 dsh-Dfy 会自动完成：识别 / 拉起 SnowLuma、写接入配置、把 dsh_bridge 装进 AstrBot、校正 provider 指向。 QQ 运行方式二选一（概览 → QQ 运行方式），默认是内置版： 内置版（默认）：QQ → SnowLuma → dsh-Dfy 内置桥 → DSH，少一跳、回复更快；AstrBot 不接 QQ。 AstrBot 版：QQ → SnowLuma → AstrBot（插件层）→ dsh_bridge → DSH，可用 AstrBot 的插件效果（表情包等），回复会多一跳。 回退方案（provider 直连，所有对话挤在一个固定会话）只在 AstrBot 版且 dsh_bridge 未安装时使用，日常不需要。 切换会自动改配置、停/起对应进程并重启 SnowLuma 让连接生效；设置页导航也会整套切换： 内置版用 0.7.4/0.7.5 的原版界面（平台/角色/对话/系统，含 QQ 旧桥页），AstrBot 版只留精简的「我的鱼」界面（概览 / 我的鱼 / 桌宠 / 维护）， 两边互不出现对方专属页面。 环境要求 不接 QQ / B站也能用：小鲸鱼与桌宠不依赖 SnowLuma。 兼容性（最低 DSH 版本） 插件在 package.json 的 engines.dsh 声明 >=0.2.1-rc.2：DSH 的插件市场与安装器会按这个范围在安装前拒绝过旧的 DSH，不会出现"装完才发现打不开"。 已在 DSH 0.2.2-rc.1（桌面版，Electron 44 / Node 24.21）实测通过；dsh web 与桌面端共用同一套宿主代码。 低于最低版本：先升级 DSH 再安装，不要用旧版强行解包。 插件加载是 fail-open 的：缺少可选服务或可选 API 时只关闭对应功能（如桌宠、B站、抖音），不会让 DSH 启动失败。 安装

四种方式选一种，不要都做。配置与会话状态统一写在数据目录 $DSH_HOME/surfcore/qq/，不写插件包目录。 方式一：在 DSH 里装（推荐）

DSH「插件」页 → 发现（插件市场）搜索 dsh-Dfy，点安装；或在命令行装包： 发现页搜不到？ 那是市场索引还没收录。本仓库自带一份索引，可以直接添加： 插件 → 发现 → 添加索引源，粘贴 https://cdn.jsdelivr.net/gh/louke6572/dsh-Dfy@main/market/dsh-index.json 之后搜索 dsh-Dfy 即可安装（来源是 GitHub 仓库 + 固定 commit）。 也可以不添加索引，直接在「添加插件」输入 github:louke6572/dsh-Dfy。 命令行装包后还要在 DSH「插件」页把 dsh-Dfy 启用：命令行只装包，不会登记到 profile 的 dsh.profile.bundles；插件页安装会自动登记。若页面提示「构建脚本待批准」，点允许即可 （Git 安装要跑一次 postinstall，修 @snowluma/sdk 的 ESM 打包 bug）。 命令行若报 ERR_PNPM_IGNORED_BUILDS：在 profile 目录运行 pnpm approve-builds，或在 /pnpm-workspace.yaml 的 allowBuilds 里加 dsh-dfy: true，然后重跑安装。

装好启用后完全退出 DSH（托盘图标也要退出）再打开。首次启动会自动： 建数据目录 $DSH_HOME/surfcore/qq/（config.json / state/ / roles/ / pet/）； 从包内 config.example.json 生成初始配置、补齐 roles/ 模板； 如果检测到旧版 clone 安装在仓库根留下的 config.json / state/ / roles/ / pet/， 只复制、不删除到数据目录（升级不丢配置）。

QQ 功能仍需要 SnowLuma（方式二会自动装；标准安装则在设置页或运行包内 scripts/install-snowluma.mjs 安装）。 方式二：一行命令（Windows，含 SnowLuma）

这一条会依次完成：下载到 %USERPROFILE%\dsh-Dfy → npm install（失败自动换国内镜像）→ 写入 DSH profile → 安装 SnowLuma（官方 Releases）→ 生成 config.json。

跑完只剩两步，都需你亲手做：

1. 完全退出 DSH（托盘图标也要退出），再打开； 2. 设置 → dsh-Dfy → 一键开始；第一次用 QQ 时在 SnowLuma 窗口扫码登录。

可选环境变量（写在命令前面）： 方式三：交给 Agent