dsh-whalegirl
由 DeepSeek Harness 会话事件驱动的原生桌面版 WhaleGirl 伴侣。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:KLnormal/dsh_whalegirl#6cf1b30e151e7a3c5f849860acf0a5c010b47fbf
Whalegirl 以 dsh-whalegirl 发布，当前版本为 0.1.0-alpha.7。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
住在 Windows 桌面上、由 DeepSeek Harness 真实工作状态驱动的 Agent 伴侣。
入口属于 DSH，生命周期属于 DSH，显示层属于桌面。
DSH 鲸鱼女孩不是一个需要单独启动的桌宠应用。它由 DSH 插件启用，跟随 DSH 一起启动和退出，并以透明、无边框、始终置顶的原生窗口显示在桌面上。即使切换到 VS Code、浏览器或文件管理器，也能知道 DSH 当前在思考、修改、测试、等待还是已经完成。
当前版本：
0.1.0-alpha.7· Windows MVP Alpha本项目由 dsh-dafeiyu（大肥鱼桌宠） 改造而来，角色形象与品牌已替换为鲸鱼女孩；插件代码与生命周期机制继承自上游。
如果 DSH 没有提供待办清单，鲸鱼女孩只显示“分析阶段”“实现阶段”“验证阶段”等可靠信息， 不会编造完成百分比。
| 思考 | 工作 |
|---|---|
| 鲸鱼女孩思考状态 | 鲸鱼女孩工作状态 |
| 等待确认 | 完成 |
|---|---|
| 鲸鱼女孩等待用户确认 | 鲸鱼女孩任务完成 |
| 遇到问题 |
|---|
| 鲸鱼女孩错误状态 |
状态大致按照下面的流程变化：
stateDiagram-v2
[*] --> 空闲
空闲 --> 思考: DSH 开始一轮任务
思考 --> 工作: 搜索、读取、修改、执行或测试
工作 --> 思考: 整理工具结果
思考 --> 等待: 需要用户确认
工作 --> 等待: 需要用户确认
思考 --> 完成: 本轮任务完成
工作 --> 完成: 本轮任务完成
思考 --> 错误: 任务异常结束
工作 --> 错误: 工具或任务失败
等待 --> 思考: 用户继续任务
错误 --> 思考: 用户重试
完成 --> 空闲
多个 DSH Session 同时运行时，默认优先展示最需要注意的顶层任务：
等待确认 > 错误 > 工作 > 思考 > 空闲
plugin --profile web 命令dsh-whalegirl@alpha，或 GitHub Release 中的 .tgz 安装包普通用户不需要安装 Python、PySide6 或单独运行
dsh-whalegirl-helper.exe。Windows Helper 已经包含在发布包里。
当前 Alpha 版的设置与桌面状态文案使用简体中文。
先关闭 DSH Host，而不只是关闭浏览器标签页。安装或更新时不要让旧版插件继续运行。
在 PowerShell 中进入你的 DSH 安装目录，例如：
cd D:\DSH
然后从 npm 安装当前 Alpha：
pnpm exec dsh plugin --profile web add dsh-whalegirl@alpha
如果你的系统已经能直接使用全局 dsh 命令，只需要：
dsh plugin --profile web add dsh-whalegirl@alpha
进入 GitHub Releases，下载最新的：
dsh-whalegirl-<version>.tgz
不要解压这个文件。
不解压，在 DSH 目录中直接安装下载的插件包：
pnpm exec dsh plugin --profile web add "C:\Users\you\Downloads\dsh-whalegirl-<version>.tgz"
照常启动 DSH WebUI。插件默认启用，鲸鱼女孩会由 DSH 自动拉起；不要手动打开 Helper。
在 DSH WebUI 中进入：
设置 → 插件 → 插件配置 → 鲸鱼女孩桌面伴侣
安装后不需要额外操作：
状态卡可能显示：
dsh-whalegirl鲸鱼女孩不会监听 VS Code、浏览器或其他应用，也不会截图。只有 DSH Agent 的事件能够 改变它的工作状态。
| 设置 | 作用 |
|---|---|
| 启用鲸鱼女孩 | 立即显示或关闭桌面伴侣 |
| 角色大小 | 在 70%～140% 之间调整 |
| 活跃程度 | 控制空闲时眨眼、观察等微动作频率 |
| 减少动态效果 | 减少走动、循环帧和程序化晃动 |
| 响应子 Agent | 允许子 Agent 状态参与优先级选择；默认关闭 |
设置由 DSH 保存，更新插件后通常不需要重新配置。
GitHub 仓库出现新提交后，已经安装的插件不会自动变化。新版本发布后，完全退出 DSH，然后更新 npm Alpha 包：
cd D:\DSH
pnpm exec dsh plugin --profile web update dsh-whalegirl@alpha
也可以再次执行安装命令，它会解析 alpha 标签指向的新版本：
pnpm exec dsh plugin --profile web add dsh-whalegirl@alpha
使用 GitHub Release 安装的用户，可以下载新 .tgz 后覆盖安装：
pnpm exec dsh plugin --profile web add "C:\Users\you\Downloads\dsh-whalegirl-<new-version>.tgz"
以上方式都会替换插件及随包携带的 Windows Helper，并保留 DSH 已保存的设置。详细 说明见 插件更新与回退。
完全退出 DSH，重新安装之前保留的旧版 .tgz：
cd D:\DSH
pnpm exec dsh plugin --profile web add "C:\Users\you\Downloads\dsh-whalegirl-<old-version>.tgz"
完全退出 DSH 后运行：
cd D:\DSH
pnpm exec dsh plugin --profile web remove dsh-whalegirl
然后重新启动 DSH。插件代码和 Helper 会从 web profile 中移除。DSH 可能保留一份
不会再生效的历史设置，这不会启动进程或占用额外端口。
--profile web。鲸鱼女孩绑定的是 DSH Host 生命周期，而不是浏览器标签页。只要 DSH 后台仍在运行， 鲸鱼女孩就会继续显示；真正退出 DSH Host 后它会自动关闭。
只有 DSH 写入了结构化待办时，插件才能可靠计算“已完成 3/5 步”。没有真实待办数据时， 状态卡只显示当前工作阶段，避免制造虚假的百分比。
这是预期行为。“本次关闭”会抑制当前 DSH 运行期间的自动重启；完全退出并重新启动 DSH 后会恢复。若想永久关闭，请在 DSH 设置中取消“启用鲸鱼女孩”。
pnpm install
npm test
py -3 -m unittest discover -s runtime/tests -t .
开发时可以从源码运行 Helper，但正式用户不应手动启动它：
py -3 -m pip install -r requirements.txt
py -3 runtime\helper.py
构建 Windows Helper：
python -m pip install -r requirements.txt pyinstaller
$env:DSH_WHALEGIRL_BUILD_PYTHON = (Get-Command python).Source
npm run build:helper:windows
相关项目：QCYTSN/ds-local-pet 是独立桌宠版本； 本仓库是只服务于 DSH 状态的插件版本。
代码采用 MIT License。角色视觉资产不适用 MIT 代码许可证，来源和使用边界 见 ASSET_LICENSE.md。