MIT 许可的 DSH 插件:用设置页和九个 `whalegirl_*` Agent 工具托管与配置自建的微信 / QQ 机器人,机器人本体、资源与 GPU 依赖仍留在 Python 侧。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-11-18
许可证
MIT
01它能帮你完成什么?
在 DSH 里启停自建的微信 / QQ 机器人
进程托管按固定序列启动(热激活微信 UIA → 起 web 服务 → 连微信),重启前检查队列、不打断在途回复,并把状态回给对话
自建 deepseekgirl 系机器人、不想为了重启 Python 侧车来回切终端的运维者
不用手改 YAML 就能调机器人的人设与话痨程度
设置页提供 22 项功能开关、人设表单(显示名 / 描述 / 提示词 / 温度 / token 上限 / 示例对话,保存即热更新)和三档回复频率预设加 12 项细调
每天都要微调人设与回复频率、希望改完立刻生效的机器人主人
让 DSH 里的 Agent 直接用工具操作机器人,而不是切到面板点按钮
九个 `whalegirl_*` 工具——status / start / stop / restart / say / image / cover / divination / config——可以在对话里调用
想在对话里直接让 Agent 用已配置的账号发消息或发图的使用者
02如何接入 DeepSeek Harness?
前置条件
- Windows 加已登录的微信桌面版(走 UI 自动化,窗口不能最小化)
- 机器人目录里有 `.venv\Scripts\python.exe` 与 `web_main.py`
- 机器人内部的 HTTP API 只监听 `127.0.0.1:<port>`
- 机器人要提供 `/api/settings*`、`/api/style*`、`/api/capabilities`、`/api/divination`;上游原版 `linxisama/deepseekgirl` 需要先补这几个接口
安装步骤
- 01
$ dsh plugin --profile web add github:gzyy111/dsh-we-whalegirl
- 02
也可以用本地目录安装:`dsh plugin --profile web add /path/to/dsh-we-whalegirl`,或在 DSH 桌面版「插件」页的本地安装入口指向该目录。
$ dsh plugin --profile web add /path/to/dsh-we-whalegirl
- 03
重启一次 DSH(bundle 层要重启才组装)。
- 04
在 profile 的 `cordis.patch.yml` 里补 `botRoot`(含 `web_main.py` 的目录),否则点「启动」会提示未配置。
验证接入成功
作者未说明
03DSH 适配与能力边界
原生 DSH 插件,分 Host + Client 两半:Host 半边拉起 / 停掉机器人进程、把 `/dsh-we-whalegirl/*` 同源代理到 `127.0.0.1:8080/api/*` 并注册九个 `whalegirl_*` 工具;Client 半边渲染 设置 → 鲸鱼娘 页面。
进程托管
设置页或 `whalegirl_*` 工具发出的启动 / 停止 / 重启指令→按固定启动序列跑起来的 Python 侧车;每次重启前先检查队列
以子进程方式拉起 `web_main.py`写自己的日志到 `%USERPROFILE%\.dsh\dsh-we-whalegirl\plugin.log`(2 MB 轮转)22 项功能开关
设置 → 鲸鱼娘 里的开关→直接改机器人自己的 `config.yaml`,插件不复制一份状态
写进机器人的 `config.yaml`多数开关要重启机器人才生效人设编辑与热更新
显示名、描述、提示词、温度、token 上限、示例对话→保存即生效的人设——不重启、不重连微信;另有「锁定出厂人设」开关
通过机器人的 `/api/style*` 接口写入人设字段九个 Agent 工具
DSH 对话里的工具调用→读状态、控制进程、用已配置账号发消息或发图、抽一次卦,以及只读查看插件配置
通过已配置的微信或 QQ 账号真实发出消息 / 图片平台设置与可选总览面板
微信通道控制、监听群列表、QQ 开放平台凭证;`enablePanel: true`→在设置页完成平台配置;打开 `enablePanel` 后侧栏出现「鲸鱼娘」总览(统计、能力自检、消息流、日志)
QQ Secret 由机器人本体的 Fernet 密钥加密后存储
04适合谁?何时不该用?
适合
- 自建 deepseekgirl 系机器人、不想为了重启 Python 侧车来回切终端的运维者
- 每天都要微调人设与回复频率、希望改完立刻生效的机器人主人
- 想在对话里直接让 Agent 用已配置的账号发消息或发图的使用者
不适合
- 多数功能开关要重启机器人才生效(handler 的开关在启动时一次性注入);人设是例外,保存即热更新。
- 微信通道要求 Windows 加已登录的微信桌面版,因为它走 UI 自动化:窗口不能最小化,机器人必须在交互式桌面会话里跑。
- 插件依赖机器人新增的接口 `/api/settings*`、`/api/style*`、`/api/capabilities` 与 `/api/divination`;用上游原版 `linxisama/deepseekgirl` 需要先补上这些接口,而且机器人目录里必须有 `.venv\Scripts\python.exe` 与 `web_main.py`。
- 曲库、表情包、模型权重都在机器人侧,插件不含这些资源;设置页能改哪些字段也由机器人侧的 `settings_api.py` 决定。
05兼容性、维护与安全提示
- 多数功能开关要重启机器人才生效(handler 的开关在启动时一次性注入);人设是例外,保存即热更新。
- 微信通道要求 Windows 加已登录的微信桌面版,因为它走 UI 自动化:窗口不能最小化,机器人必须在交互式桌面会话里跑。
- 插件依赖机器人新增的接口 `/api/settings*`、`/api/style*`、`/api/capabilities` 与 `/api/divination`;用上游原版 `linxisama/deepseekgirl` 需要先补上这些接口,而且机器人目录里必须有 `.venv\Scripts\python.exe` 与 `web_main.py`。
- 曲库、表情包、模型权重都在机器人侧,插件不含这些资源;设置页能改哪些字段也由机器人侧的 `settings_api.py` 决定。
MIT(仅插件代码)· README 分支 main · 无 tagged release,最后推送 2026-10-20
06常见问题
这个插件包含机器人本体吗?
不包含。README 写得很清楚:它是 DSH 插件(Host + Client 两半),不是机器人。微信 UI 自动化、faster-whisper、edge-tts、SoulX-Singer / ACE-Step 这些 GPU 依赖仍在 Python 侧,插件既不包含也不重写。
点「启动」之前要先满足什么?
要先在 profile 的 `cordis.patch.yml` 里补 `botRoot`,否则会提示未配置。机器人目录里要有 `.venv\Scripts\python.exe` 与 `web_main.py`,它的 HTTP API 只监听 `127.0.0.1:<port>`,并且要提供 `/api/settings*`、`/api/style*`、`/api/capabilities`、`/api/divination`。
改人设需要重启机器人吗?
不需要。人设保存即热更新,不重启、不重连微信。多数功能开关则需要重启,因为 handler 的开关在启动时一次性注入。
Agent 能调用哪些工具?
九个:`whalegirl_status`、`start`、`stop`、`restart`、`say`、`image`、`cover`、`divination`、`config`。其中 `say` 与 `image` 会通过已配置的账号真实发出消息或图片。
插件出问题会拖垮 DSH 吗?
README 的设计取舍是失效不拖垮宿主:所有 Promise 都挂 catch,代理对 req / res / upstream 全挂 error,`apply` 整体 try/catch,页面有错误边界,注册失败只降级。它自己的日志写在 `%USERPROFILE%\.dsh\dsh-we-whalegirl\plugin.log`,2 MB 轮转。
07相关的 DSH 工作流
dsh-im
作者 xmanrui
通过扫码或机器人凭据把IM机器人接入DeepSeek Harness(支持飞书、微信、钉钉、企业微信、QQ、Slack、Telegram、Discord和WhatsApp)。 Connect IM bots to DeepSeek Harness via QR code or credentials (9 channels).
dsh-aurabot-qq
作者 aureth-labs
让 DeepSeek Harness 里的 AI 以「大肥鱼」住进 QQ:会聊天、发表情、发语音、记事、发空间、刷 B 站、唱歌。功能都是模块,能开关、能自己写,还能从模块市场装更多(SnowLuma / OneBot v11)。
dsh-qqbot
作者 tencent-connect
让 QQ Bot 接入 DeepSeek Harness(dsh)的官方插件
dsh-wechat
作者 xcisxc29
DeepSeek Harness 微信频道
08数据与来源
**是**:一个 DSH 插件(Host + Client 两半)。Host 半边负责拉起/停掉机器人进程、把浏览器请求同源代理到本机 8080、并注册 9 个 Agent 工具;Client 半边在 **设置 → 鲸鱼娘** 提供完整设置…
或者用 DSH 桌面版「插件」页的本地安装入口指向本目录。装完**重启一次 DSH**(bundle 层要重启才组装)。
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-18。发现错误?提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。
