dsh-we-whalegirl
DSH 插件：自建微信/QQ「鲸鱼娘」机器人的控制面 —— 启停 Python 侧车、逐个开关功能、改人设、调回复频率，并可用 whalegirl_* 工具在对话里指挥她
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:gzyy111/dsh-we-whalegirl#1c6b50320628f733ea6d0ad512d42534a1aa7e74
We Whalegirl 以 dsh-we-whalegirl 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DeepSeek Harness（DSH）插件：给自建的微信 / QQ「鲸鱼娘」机器人装一个原生控制面。 启停 Python 侧车、逐个开关功能、改人设、调回复频率，还能在对话里用
whalegirl_*工具指挥她。
是：一个 DSH 插件（Host + Client 两半）。Host 半边负责拉起/停掉机器人进程、把浏览器请求同源代理到本机 8080、并注册 9 个 Agent 工具；Client 半边在 设置 → 鲸鱼娘 提供完整设置页。
不是：机器人本体。微信 UI 自动化、faster-whisper、edge-tts、SoulX-Singer / ACE-Step（conda + GPU）这些仍然留在 Python 侧，插件只做控制面，不包含也不重写它们。
| 区域 | 内容 |
|---|---|
| 进程 | 启动 / 停止 / 重启；启动序列固定为「热激活微信 UIA → 起 web 服务 → 连微信」；重启前检查队列，不打断在途回复 |
| 功能开关 | 22 项：聊天核心、媒体与表情包、点歌三级后端、算命五术数、笑话、开机补消息、频率参数…… |
| 人设 | 显示名 / 描述 / 提示词 / 温度 / token 上限 / 示例对话；保存即热更新（不重启、不重连微信）；带「锁定出厂人设」开关 |
| 回复频率 | 三档预设（安静 / 正常 / 话痨）+ 12 项细调；明确区分「@ 必回」与「概率参与」 |
| 平台 | 微信通道控制、监听群列表、QQ 开放平台凭证（Secret 走机器人本体 Fernet 加密） |
| 语音与点歌 | 音色 / 音调 / 语速、真唱音色版本、混音配比、三级后端开关 |
| 模型与高级 | AI 接口、日志级别、读取日志尾、清空上下文、插件自身配置只读展示 |
| Agent 工具 | whalegirl_status / start / stop / restart / say / image / cover / divination / config |
| 可选面板 | enablePanel: true 后在侧栏出现「鲸鱼娘」总览（统计、能力自检、消息流、日志） |
dsh plugin --profile web add github:gzyy111/dsh-we-whalegirl
dsh plugin --profile web add /path/to/dsh-we-whalegirl
或者用 DSH 桌面版「插件」页的本地安装入口指向本目录。装完重启一次 DSH（bundle 层要重启才组装）。
装完在 profile 的 cordis.patch.yml 里补 botRoot，否则点「启动」会提示未配置：
- id: whalegirl
name: dsh-we-whalegirl
config:
botRoot: 'D:/bots/deepseekgirl' # 含 web_main.py 的目录
pythonExe: '' # 留空 = <botRoot>\.venv\Scripts\python.exe
port: 8080
mode: auto # auto | attach | manual
autoStart: false
stopOnExit: false
allowAnyRoom: false
automaticRestart: false
enablePanel: false
机器人本体需要满足：
.venv\Scripts\python.exe 与 web_main.py127.0.0.1:<port>本插件依赖机器人新增的三个接口：/api/settings*、/api/style*、/api/capabilities、/api/divination。如果你用的是上游原版（linxisama/deepseekgirl），需要先补这几个接口（本仓库的「设置页」依赖它们）。
DSH Desktop ── Host 插件 ──┬─ supervisor：subprocess 拉起 web_main.py
├─ 同源代理：/dsh-we-whalegirl/* → 127.0.0.1:8080/api/*
└─ 9 个 whalegirl_* 工具
浏览器页面（设置 → 鲸鱼娘）──fetch──> /dsh-we-whalegirl/api/*（同源，无 CORS）
设计取舍：
config.yaml，插件不复制一份状态。apply 整体 try/catch、页面有错误边界、注册失败只降级。%USERPROFILE%\.dsh\dsh-we-whalegirl\plugin.log（2 MB 轮转）。settings_api.py 决定。index.js Host 半边：配置、代理、工具注册、自动启动
client.js Client 半边：设置页 + 可选仪表盘（单文件，自带内联 CSS）
lib/bot.js 机器人 API 客户端
lib/supervisor.js 进程托管（spawn / 停止 / 重启 + UIA 热激活）
lib/tools.js 9 个 Agent 工具
lib/log.js 自有日志
lib/util.js HTTP 小工具
ui/theme.css 唯一 CSS 源（由 tools/build-theme.mjs 内联进 client.js）
tools/ 构建与本地预检脚本（不参与运行）
preview/ 设计预览页与截图
改完 ui/theme.css 后跑一次 node tools/build-theme.mjs 把样式内联进 client.js；
改完代码可以跑 node tools/preflight-client.cjs client.js 与 node tools/preflight-host.mjs 做本地自检（不接触 DSH）。
插件代码 MIT。机器人本体不在本仓库内，其许可与来源见机器人项目自身；本插件不声明对它的任何权利。详见 NOTICE.md。