DoloresCaritasAngelus/SeekMaid-pet

README 摘要

SeekMaid 女仆（DeepSeek 娘桌宠） 一个运行在 Windows 11 上的可爱桌面宠物。使用你提供的 DEEPSEEK 娘形象， 常驻桌面/系统托盘，并连接本机 DSH（DeepSeek Harness）终端： - 监控 DSH 会话状态：任务开始、任务完成、新消息、工具调用、任务清单变化时，桌宠会用气泡提示你。 - 双向通信：双击桌宠或右键菜单，可以直接给当前 DSH 会话发送消息；DSH 的回复会出现在桌宠气泡里。 - 长久运行：无控制台窗口（ pythonw ）、单实例、关闭窗口只隐藏到托盘、可设置开机自启。 - DSH 插件模式：这个目录本身也是一个 DSH 插件包，DSH 启动时自动拉起桌宠，DSH 停止时自动关闭桌宠。 架构说明：WSL + Windows 11 本项目设计为： - DSH 跑在 WSL 里 ：提供 API / WebSocket，桌宠从这里获取任务状态、授权、QA 等事件。 - 桌宠跑在 Windows 11 原生侧 ：不走 WSLg，所以窗口置顶、任务栏图标、拖动、提示音都更稳定。 - 通信 ：Windows 通过 http://localhost:3080 访问 WSL 里的 DSH（WSL2 自动转发 localhost）。 如果你的 DSH 直接跑在 Windows 上，也可以使用同一套代码， dsh url 保持 http://localhost:3080 即可。 效果预览 待机动画 任务开始 任务完成 需要授权 DSH 提问 出错提示 克隆后能否直接获得同等能力？ 基本可以，但不是“克隆完立刻就能用” ，需要几步初始化： 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 缓存 所以别人克隆后，需要先执行初始化脚本，才能获得和当前一样的桌宠能力。 项目结构 DSH 插件安装（推荐） 这个项目同时是一个 DSH 插件，包名 seekmaid-pet 。安装后，DSH 每次启动都会自动启动桌宠；DSH 退出…

分类