返回目录

dsh-we-whalegirl

精选清单收录维护状态: 活跃

gzyy111/dsh-we-whalegirl

DSH 插件:自建微信/QQ「鲸鱼娘」机器人的控制面 —— 启停 Python 侧车、逐个开关功能、改人设、调回复频率,并可用 whalegirl_* 工具在对话里指挥她

前往 GitHub项目主页
$ dsh plugin --profile web add github:gzyy111/dsh-we-whalegirl

14

星标

2

Fork

JavaScript

语言

MIT

许可证

2026-10-20

创建于

2026-10-20

最近推送

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` 需要先补这几个接口

安装步骤

  1. 01

    $ dsh plugin --profile web add github:gzyy111/dsh-we-whalegirl

  2. 02

    也可以用本地目录安装:`dsh plugin --profile web add /path/to/dsh-we-whalegirl`,或在 DSH 桌面版「插件」页的本地安装入口指向该目录。

    $ dsh plugin --profile web add /path/to/dsh-we-whalegirl

  3. 03

    重启一次 DSH(bundle 层要重启才组装)。

  4. 04

    在 profile 的 `cordis.patch.yml` 里补 `botRoot`(含 `web_main.py` 的目录),否则点「启动」会提示未配置。

验证接入成功

作者未说明

03DSH 适配与能力边界

DSH 适配原生运行时

原生 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` 决定。
2026-10-202026-10-20作者未说明

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 轮转。

08数据与来源

  • 作者声明github.com1c6b50320628…

    **是**:一个 DSH 插件(Host + Client 两半)。Host 半边负责拉起/停掉机器人进程、把浏览器请求同源代理到本机 8080、并注册 9 个 Agent 工具;Client 半边在 **设置 → 鲸鱼娘** 提供完整设置…

  • 作者声明github.com1c6b50320628…

    或者用 DSH 桌面版「插件」页的本地安装入口指向本目录。装完**重启一次 DSH**(bundle 层要重启才组装)。

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-18。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。