DeepSeek Harness（DSH）的桌宠与挂件套件 · v0.7.7

小鲸鱼余额挂件 + 桌宠（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（安装、卸载）是正常的。

拿不准就选内置版；AstrBot 版是可选的重型方案，装不上不影响挂件和桌宠。

1. DSH → 插件页 → 添加插件，填 github:louke6572/dsh-Dfy，安装并启用；
2. 完全退出 DSH（托盘图标也要退出）再打开；
3. 浏览器 Ctrl+F5，右下角出现小鲸鱼就完成。QQ、SnowLuma、AstrBot 都不用管。

装完 DSH 打不开了？先别重装、别删 ~/.dsh，直接看下面的「装崩了 / DSH 打不开：照着救」。

1. 只让 DSH / Agent 装 dsh-Dfy；不要让它装 AstrBot、Python、SnowLuma 或系统依赖。
2. 不要把任何东西装进 ~/.dsh/profiles、~/.dsh/plugins、~/.dsh/surfcore（会锁坏正在运行的 DSH）。
3. SnowLuma 仓库已转私有，没有公开下载链接；没有安装包就先只用挂件 / 桌宠。
4. 内置版和 AstrBot 版只能二选一，不能同时接同一个 QQ。
5. 改人格 / 配置后要**完全退出 DSH（托盘也退）**再打开，否则不生效。

违反上面任何一条，最常见的后果就是DSH 打不开——不用重装系统，按下面的「装崩了」救回来。

看不懂下面的词就先查这里，不用去搜：

关掉窗口不算退出，插件和桥接还在后台跑，改了配置也不会生效：

1. 看屏幕右下角托盘（图标可能被收进 ^ 里），找到 DSH 图标 → 右键 → 退出；
2. 按 Ctrl+Shift+Esc 打开任务管理器 → 搜索 DSH → 如果还有进程，右键 → 结束任务；
3. 重新打开 DSH。

QQ → SnowLuma（登录层，扫码 / 注入 QQ 进程）→ AstrBot（接入 + 插件层）
   → dsh_bridge 插件 → DSH（每段对话一个会话）→ 回复回 QQ

• 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 版只留精简的「我的鱼」界面（概览 / 我的鱼 / 桌宠 / 维护）， 两边互不出现对方专属页面。

AstrBot 不是 DSH 插件，也不是 npm 包，是独立的 Python 服务。 dsh-Dfy 只负责把 dsh_bridge 装进 AstrBot、校正 provider；不负责装 Python、不负责装 AstrBot 本体。

正确顺序：

1. 单独装 AstrBot：独立目录 + 独立 Python 环境（例如 %USERPROFILE%\astrbot），按 astrbot.app 官方说明装；不要放进 ~/.dsh/profiles、~/.dsh/plugins 或 ~/.dsh/surfcore。
2. 在该目录跑一次 astrbot init，再启动 AstrBot；浏览器打开它的 WebUI（默认 127.0.0.1:6185）确认能登录。
3. 回到 DSH → dsh-Dfy → 维护 → AstrBot：填/识别 AstrBot 目录、WebUI 端口（6185）和可执行文件；点「初始化/启动」。
4. 让 dsh-Dfy 自动安装 dsh_bridge（或手动在 AstrBot 插件页安装并启用），把 provider 指向 DSH。
5. 概览 → QQ 运行方式 → 切到 AstrBot 版；重启 SnowLuma，让 QQ 走 6199 反向 WS 接进 AstrBot。
6. 跑一遍「诊断体检」：AstrBot 运行、6199 接入、dsh_bridge、SnowLuma、内置桥应停止，五项都要绿。

不要做：

• 不要让 DSH Agent 在 ~/.dsh 或插件目录里 pip install / npm install 装 AstrBot：DSH 正在运行，Windows 会锁 node_modules，装到一半 DSH 可能直接起不来。
• 不要把 AstrBot 目录设到 ~/.dsh/profiles、~/.dsh/plugins、~/.dsh/surfcore 里面；插件会拒绝从这些目录拉起 AstrBot。
• 不要同时让内置桥和 AstrBot 接同一个 QQ：会双回复/抢消息。二选一。
• 不要把 6185（WebUI）和 6199（OneBot 反向 WS）搞混：前者是 AstrBot 面板，后者才是 QQ 接入。

如果不需要 AstrBot 的插件生态（表情包、拟人插件等），直接用默认的内置版，少一层 Python、少一半故障点。

不接 QQ / B站也能用：小鲸鱼与桌宠不依赖 SnowLuma。

• 插件在 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-Dfy，点安装；或在命令行装包：

dsh plugin --profile <profile> add github:louke6572/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，或在 <profile>/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，但它的仓库已经转私有，插件不再自动下载：需要你自己准备安装包，解压后在设置页「维护 → SnowLuma → 手动选择已安装的 SnowLuma」指定目录。没有 SnowLuma 也可以先用内置版挂件 / 桌宠。

powershell -ExecutionPolicy Bypass -c "irm https://raw.githubusercontent.com/louke6572/dsh-Dfy/main/scripts/bootstrap.ps1 | iex"

这一条会依次完成：下载到 %USERPROFILE%\dsh-Dfy → npm install（失败自动换国内镜像）→ 写入 DSH profile → 检测本机有没有 SnowLuma → 生成 config.json。

SnowLuma 仓库已转私有，脚本不会也不能再下载它。没装 SnowLuma 时这一步会提示你手动准备， 不影响挂件 / 桌宠；要接 QQ 再按下面「SnowLuma 安装包」处理。

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

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

SnowLuma 是第三方专有 QQ 运行时，仓库已转私有，不再有公开 Releases 可自动下载。接 QQ 时需要：

1. 从你原来的渠道 / 作者那里拿到 SnowLuma 安装包（zip 或已解压目录）；
2. 解压到独立目录（例如 %USERPROFILE%\SnowLuma2，里面有 app）；
3. DSH → dsh-Dfy → 维护 → SnowLuma → 手动选择已安装的 SnowLuma，选 SnowLuma.exe、app\launcher.bat 或根目录；
4. 启动 SnowLuma，用手机 QQ 扫码登录。

没有安装包时：直接用内置版挂件 / 桌宠；或者切到「直连」模式，用你自己的 OneBot 实现（NapCat 等）接 6199。

可选环境变量（写在命令前面）：

帮我安装 https://github.com/louke6572/dsh-Dfy ，按仓库里的 AGENT.md 执行，需要我做的事直接说。

Agent 会跑同一套流程并自己处理报错；你仍然只做「重启 + 扫码」。重启必须由你做： Agent 通常就跑在 DSH 里，它自己重启会中断当前任务。

只让 Agent 装 dsh-Dfy 插件。不要让它安装 AstrBot / Python 依赖，也不要在 ~/.dsh/profiles、~/.dsh/plugins、~/.dsh/surfcore 里跑 pip / npm / pnpm—— 那会把正在运行的 DSH 依赖装坏。AstrBot 请按上面的「AstrBot 版」自己装到独立目录。

git clone --depth 1 https://github.com/louke6572/dsh-Dfy.git
cd dsh-Dfy
npm install
node scripts/setup-dsh.mjs
node scripts/install-snowluma.mjs   # 接 QQ 才需要；只检测，不再下载

clone 安装与方式一使用同一个数据目录（$DSH_HOME/surfcore/qq/），所以两种安装可以互相切换， 配置不会分叉。

curl -s -o NUL -w "%{http_code}" http://127.0.0.1:3080/dsh-whale/widget.js

• 200 / 401：插件已加载（401 是路由要求会话凭据，正常）。挂件侧共 38 个 /dsh-whale/* 路由。
• 连不上：DSH 没起来或插件没挂上，看下面的「常见问题」。

浏览器 Ctrl+F5 后，右下角出现小鲸鱼即成功。

• 市场 / dsh plugin 安装：重新执行一次 dsh plugin --profile <profile> add github:louke6572/dsh-Dfy；
• 一行命令安装：重跑方式二那条命令（自动 git pull + 依赖 + 重写 profile）。

然后重启 DSH。数据在数据目录，升级不会覆盖。

dsh plugin --profile <profile> remove dsh-dfy    # 推荐
node scripts/uninstall.mjs                       # 或脚本：默认只演练
node scripts/uninstall.mjs --yes                 # 真删（保留 ~/.dsh/surfcore 里的配置 / 记忆）
node scripts/uninstall.mjs --yes --purge-state   # 连配置、记忆、日志一起删

按顺序看，停在哪一步就修哪一步，不要一次改很多地方：

1. DSH 插件页：能看到 dsh-Dfy，且状态是「已启用」。看不到 → 回安装步骤，装完重启。
2. 浏览器 Ctrl+F5：右下角出现小鲸鱼。没有 → 插件没加载，先看插件页和 DSH 是否重启。
3. 设置 → dsh-Dfy → 维护 → 诊断体检：点「重新体检」，红色项就是下一步要修的。
4. 只要挂件 / 桌宠：到这里就完成了，不需要 SnowLuma、不需要 AstrBot。
5. 要接 QQ（内置版）：维护 → SnowLuma，安装目录不能是「未设置」，并且能看到已登录的 QQ 号；没有 → 手动选择 SnowLuma 目录，再扫码。
6. 要 AstrBot 版：再加三项都绿——AstrBot 在线、6199 已接入、dsh_bridge 已启用。

1. 余额：配 DEEPSEEK_API_KEY，或在 DSH「设置 → 账号与余额」登录；鲸鱼旁出现数字即成功。
2. QQ（可选）：自行准备 SnowLuma 安装包并在设置页手动指定，扫码登录后，打开 DSH 会自动拉起对应接入层（内置版直接连内置桥；AstrBot 版会拉起 AstrBot 并装好 dsh_bridge）；在 QQ 私聊发一句即可，回复会进 DSH 侧栏 agents 工作区的独立会话。设置页「维护 → 安装与维护」可看状态与体检。
3. B站（可选）：设置 → dsh-Dfy → 平台 → 养鱼（B站）→ 扫码；设互动频率与鱼群保护。不接就不会请求 B站接口。
4. 记忆（可选）：设置 → dsh-Dfy → 角色 → 记忆同步（记忆卡内置，不需要装第三方记忆插件）；模板在 roles/、examples/。

QQ 消息先经过 AstrBot、再交给 DSH，所以 AstrBot 的插件照常生效：

• 管理：设置 → 我的鱼 → 能力与插件（搜索官方插件市场，一键安装 / 启停 / 卸载）。
• dsh_bridge：把 QQ 消息按会话转给 DSH 的桥接插件，随 dsh-Dfy 自动安装 / 更新；临时没装时会退回 provider 路线（所有对话挤在固定会话）。
• 能生效 / 不能生效：改「结果或发送」的插件（表情包、延时、收尾）照常生效；改「AstrBot 发给模型的 prompt」的插件（如认主注入）在插件桥接下不生效——LLM 由 DSH 调，人格与上下文在 DSH 会话里。
• 贴吧：内置平台（BDUSS 登录 + 手机扫码），不依赖外部插件；旧插件 dsh-tieba-dive 如仍安装可自行卸载。
• 抖音：内置模块（默认启用），在「平台 → 抖音」配置观看时段/额度与 IM。

• 打开菜单：点小鲸鱼；按钮被隐藏时，电脑端右键角色、手机端长按 1.5 秒。
• 切换形态：菜单或控制台顶部的 小鲸鱼 / 桌宠 / 共存，三者互斥（共存 = 两只同时显示）。
• QQ 消息卡：点信封角标 → 最新消息 / 记录 / 写消息；Enter 发送，Shift + Enter 换行。
• 余额：点鲸鱼立即刷新；气泡里看今日已用、每轮消耗、近 7 天、按日明细。
• 心情与音效：卡片头像旁循环切换；音量在控制台「音效与提示」按四路调。
• 保存：挂件控制台的改动即时生效；「保存配置」只是关闭面板，「恢复默认」是恢复出厂默认（不可撤销）。DSH 设置页底部的「保存」会写配置，QQ 相关参数需再点 QQ 页「保存并热重载」（或重启 DSH）才对桥接生效。

DSH「设置 → dsh-Dfy」与挂件内控制台是同一插件的两个入口：设置页管平台/角色/记忆/对话/系统；挂件控制台只管外观、音效、桌宠动作与呈现（少量外观键是重叠的）。

「设置 → 语音 → 音源」六选一，语音条、卡片朗读、试听共用同一路：

设置页导航随「QQ 运行方式」整套切换（概览 → QQ 运行方式）：

• 内置版（默认）：运行（概览）/ 平台（养鱼 B站、贴吧、抖音、QQ）/ 角色（角色与记忆卡、记忆同步）/ 对话（桌宠、模型）/ 系统（额度、语音设置、安装与维护、模块与能力）。
• AstrBot 版：运行（概览）/ 我的鱼（启动与连接、人格与语气、能力与插件）/ 桌宠（桌宠、朗读与语音）/ 维护（安装与维护）。 插件不会下载任何 TTS 模型；要 Key 的两条填自己的凭证，回读时按掩码处理。 「在线免费模型」会把待合成文字发往 HuggingFace 的公开 Space。

三个平台（QQ / B站 / 抖音）共用一张记忆卡：

• 全平台可见：初次相遇、被钉住的锚点、和主人相关的身份记忆。
• 只在该通道可见：QQ 私聊流水（受 includeQqInBili 控制）、桌宠私下对话（scope='pet' 永不进公开平台）。
• 抖音群聊按「公开场合」口径注入，只带身份记忆，避免把私聊细节带进群里。

泡泡配置文件（$DSH_HOME/.dshw-bubble.json）是「全量替换」语义：文件里的 items 就是整条泡泡序列， 出厂快照只在读不到文件时兜底。照源码手写一份「最小配置」会把出厂序列整体替换掉（峰谷状态、谷价倒计时、 choice 步骤都会一起消失，而且不报错）。想恢复默认泡泡：删掉该文件后刷新页面即可。

安全边界：

• 所有接口只允许回环来源，跨站请求拒绝；写请求必须来自本机。
• 凭据只发往内置端点；自定义地址需在本机面板逐个放行。
• 不下发通配 CORS，响应带 nosniff；仓库不含真实账号数据。
• 记忆在写入前做双向脱敏（QQ 号、手机号、证件号、长令牌等），不把原始聊天写进记忆卡。

先别做：不要重装 DSH、不要删整个 %USERPROFILE%\.dsh、不要在打不开的情况下再装第二遍。

配置、记忆、聊天记录都在 %USERPROFILE%\.dsh\surfcore\，下面的操作都不会动它。

第 1 步：彻底退干净

按上面「什么叫完全退出 DSH」做一遍，确认任务管理器里没有 DSH 进程。

第 2 步：看是哪个 profile 坏了

打开 %USERPROFILE%\.dsh\profiles\，里面通常有一到两个文件夹（如 desktop、web）。 你平时用桌面版就是 desktop，用命令行 dsh web 就是 web。

第 3 步：把 dsh-Dfy 从 profile 里摘掉

用记事本打开 %USERPROFILE%\.dsh\profiles\<profile>\package.json，找到下面这两处，删掉 dsh-dfy 这一项（只删这一项，其它字段保持原样，别删错逗号）：

{
  "dependencies": { "dsh-dfy": "..." },
  "dsh": { "profile": { "bundles": ["dsh-dfy"] } }
}

上面只是示意片段。你的文件里还有 name、version 等别的字段，都不用动；只把 dsh-dfy 这个键 / 这一项删掉。

保存后重新打开 DSH。能起来 → 就是插件装坏了，按「方式一」重装一次即可（配置和记忆都还在）。

不想手改，也可以在 PowerShell 里跑（只会移除 dsh-Dfy，不碰配置和记忆）：

dsh plugin --profile <profile> remove dsh-dfy

第 4 步：还打不开，就换一个干净 profile

说明被改坏的不只 dsh-Dfy（通常是有人往 profile 里装过 AstrBot / Python / 别的包）：

1. 把 %USERPROFILE%\.dsh\profiles\<profile> 整个文件夹改名，例如 desktop-bak；
2. 重新打开 DSH，它会自己建一个新的 desktop（少数版本可能要重新登录一次账号）；
3. 插件页里把 dsh-Dfy 重新装回来。此 profile 里的其它插件需要重新启用，但 surfcore 里的配置、记忆、聊天记录一条没丢；
4. 旧文件夹先别删，确认没事了再删。

第 5 步：提醒自己

这次为什么崩：多半是让 Agent 在 DSH 目录里跑了 npm / pip / pnpm。下次只让它装 dsh-Dfy，AstrBot 和 Python 一律装到独立目录。

不要一上来就说「装不上」，先按顺序回答：

1. 右下角有小鲸鱼吗？ 没有 → 插件没装好或没重启，先别管 QQ。
2. 设置页有 dsh-Dfy 吗？ 没有 → 插件没启用，去插件页启用后完全退出 DSH 再打开。
3. 你选的是内置版还是 AstrBot 版？ 不知道 → 默认内置版就够了。
4. SnowLuma 检测到了吗？ 没有 → 自己准备安装包后「手动选择」；没有包就先不接 QQ。
5. 诊断体检哪一项是红的？ 只修那一项，改完再体检一次。

把这 5 个答案一起发出来，基本能直接定位问题。

求助模板（直接复制填空）

1. 右下角有小鲸鱼吗：
2. 设置页有 dsh-Dfy 且已启用吗：
3. 内置版还是 AstrBot 版：
4. SnowLuma 检测到了吗 / 有没有安装包：
5. 诊断体检哪一项是红的：
6. 报错原文（截图或文字）：

先看报错里最像英文错误码的那一段，对上下表直接处理；对不上再看下一张表。

不用描述，直接复制下面几样，别人一眼就能定位：

1. 上面的「5 个问题」答案；
2. 报错原文（截图或复制文字，不要只写「报错了」）；
3. 日志文件 %USERPROFILE%\.dsh\surfcore\qq\state\bridge.log（最后 50 行就够）；
4. 你的 DSH 是桌面版还是 dsh web，以及 %USERPROFILE%\.dsh\profiles\ 下有哪几个文件夹。

发之前先删掉里面的 QQ 号、手机号、API Key。

node build.mjs                              # lib/ui/*.js → lib/client.js（产物入库，必须重建）
node build.mjs --check                      # 只校验产物与源一致（不一致 exit 1）
node scripts/build-agent-preset-patches.mjs # dsh/agent-presets/* → presets/*.patch.yml
                                            # 若存在 dsh/agent-presets/persona.system.md（插件自动生成的
                                            # 人格快照，不入库），会把它烘进三个预设的 system prompt；
                                            # 这两个产物都是运行期文件，不进 git（postinstall 会自动生成，
                                            # 所以 git 安装/干净 clone 也不会缺）
node scripts/build-agent-preset-patches.mjs --check

node scripts/version.mjs check              # 版本一致性（package.json / README / AGENT / CHANGELOG / tag）
node scripts/privacy-scan.mjs --strict      # 隐私闸门（本机路径 / 账号 / 令牌 / 私钥）
node scripts/publish-guard.mjs              # 发布守卫：本地人设生成物不许被 npm pack 带走（prepublishOnly 自动跑）

node widget/tools/ci-audit.mjs --no-pack    # 路由安全 / 接口对等 / 注入面 / CI
node widget/tools/ci-audit-selftest.mjs     # 审计脚本自检（防止断言空转）
node widget/tools/bubble-config-audit.mjs   # 泡泡配置「全量替换」语义回归
node widget/tools/choice-options-audit.mjs  # 并列步骤候选不被静默裁掉
node widget/tools/check-dead-settings.mjs   # 「控件有值、没有消费方」初筛
node widget/tools/expr-smoke.mjs            # 表情包清单 / 图片路由 / 配置键冒烟
node widget/tools/z-layer-audit.mjs         # 浮层层级（z-index）登记检查
node widget/tools/outbound-safety-audit.mjs # 出站安全：发送收口 / 群聊路径脱敏 / 图片行剥离 / 表情引用 / 工具白名单对账
node widget/tools/outbound-pipeline-audit.mjs # 出站管道回归：真实报过的每个问题各一条用例（换模型前后必跑）
node widget/tools/divergence-audit.mjs        # 跨模块口径：数据目录 / 「今天」/ 出站清洗 / 配置路径只能有一个实现
node widget/tools/module-audit.mjs            # 功能模块：状态原子写 / 网络超时 / 循环出口 / 记忆可见性 / 模块清单 / B站 Cookie 头
node widget/tools/config-fuzz-audit.mjs     # 配置 normalize 模糊测试：毒值组合不抛错且幂等
node widget/tools/token-guard-audit.mjs     # Token 防爆破守卫的边界与竞态不变式
node widget/tools/live-endpoint-sweep.mjs   # 对运行中的服务做全端点真实巡检（需 DSH 在跑）

除 ci-audit.mjs 完整版（会跑一次 npm pack）外，以上都是 0 依赖脚本，npm install 之前也能跑。 CI（.github/workflows/ci.yml）跑的就是这一组，外加全量 node --check。

目录：

lib/       宿主与设置界面（lib/ui/* 是源码，lib/client.js 是构建产物）
backend/   SurfCore 后端：配置 / 调度 / 记账 / 更新 / 宠物 API
widget/    小鲸鱼与桌宠：lib/ 是宿主路由，assets/ 是前端单文件
src/       QQ 桥接、B站、记忆、语音、MCP
presets/   Agent 预设（由 dsh/agent-presets/* 生成）
shims/     qq-mode 转发垫片
scripts/   安装、更新、自检、发布

改动生效范围：

版本号只有一个来源：仓库根 package.json（README / AGENT / CHANGELOG / tag 由 scripts/version.mjs check 校验）。

• 月匠 MeteorNOX：官方挂件 DeepSeek-Balance-Whale-Widget， 余额 / 记账 / 峰谷 / 泡泡 / 音效与安全边界源自该项目。
• PC2005-cloud：dsh-pet（MIT），106 段动画、动作链与桌宠物理交互源自该项目。
• SurfCore（Mieksido/surfcore）：QQ / B站桥接、双向脱敏记忆、身份对齐。
• SnowLuma：第三方 QQ 运行时，负责 QQ 登录与收发消息；专有软件，不随本仓库分发。仓库已转私有，插件不再提供自动下载，安装包需自行准备。
• DSH：插件宿主，提供 bundle / patch / client / MCP。
• 社区贡献：Yang-huai406（Codex 迁移）、1llysviel（macOS）、0Sakura721、yybai25、Jy-EggRoll、 VaeKaras、MengLs1620、ELFsay、ztzpro、under-the-ocean、21253soursweetlemon、fangbm、xiaolinnnnnnn。

代码基于 MIT License，见 LICENSE。widget/assets/ 与 assets/ 下的美术素材不在 MIT 覆盖范围内， 按「原样」分发，来源与权利主张见 PROVENANCE.md。