DoloresCaritasAngelus/SeekMaid-pet

安装

- **DSH 跑在 WSL 里**：提供 API / WebSocket，桌宠从这里获取任务状态、授权、QA 等事件。
- **桌宠跑在 Windows 11 原生侧**：不走 WSLg，所以窗口置顶、任务栏图标、拖动、提示音都更稳定。
- **通信**：Windows 通过 `http://localhost:3080` 访问 WSL 里的 DSH（WSL2 自动转发 localhost）。

> 如果你的 DSH 直接跑在 Windows 上，也可以使用同一套代码，`dsh_url` 保持 `http://localhost:3080` 即可。

## 效果预览

**待机动画**

![idle](docs/screenshots/idle.gif)

**任务开始**

![task_start](docs/screenshots/task_start.png)

**任务完成**

![task_finish](docs/screenshots/task_finish.png)

**需要授权**

![approval](docs/screenshots/approval.png)

**DSH 提问**

![question](docs/screenshots/question.png)

**出错提示**

![error](docs/screenshots/error.png)

## 克隆后能否直接获得同等能力？

**基本可以，但不是“克隆完立刻就能用”**，需要几步初始化：

1. 在 Windows 侧克隆本仓库。
2. 运行 `setup_windows.bat`：自动创建 `.venv` 并安装 PySide6。
3. 运行 `run_pet.bat`：即可手动启动 Windows 原生桌宠。
4. 如果希望 DSH 启动时自动拉起桌宠：
   - 在 WSL 的 DSH 中安装本插件；
   - 插件会自动检测/复制 Windows 项目并自动初始化（零配置模式）；
   - 如果路径不同，可在插件配置里把 `windowsProject` 指向你 Windows 侧的仓库路径；
   - 重启 DSH。

仓库不会包含以下本地环境内容（已在 `.gitignore` 中排除）：

- `.venv/`：每个人的 Python 虚拟环境不同
- `wslg-xcb-libs/`：WSLg 本地运行库
- `*.log`：运行日志
- `__pycache__/`：Python 缓存

所以别人克隆后，需要先执行初始化脚本，才能获得和当前一样的桌宠能力。

## 项目结构

把 DoloresCaritasAngelus/SeekMaid-pet 加入你的 DSH 配置（web profile）即可启用。