前言¶

在 DeepSeek Harness 里同时跑多个会话时，侧边栏里的状态往往要来回切才能知道「哪条在等你点批准、哪条正在改文件、哪条已经跑完」。窗口被别的应用挡住时，更难一眼看到进度。下面介绍 white-source 维护的 dsh-xiaoqi-pet（Xiaoqi Desk Pet）：它在 DSH Web UI 里提供全帧 overlay 桌宠与会话看板，并可选 macOS 原生或 Windows/Linux Electron 桌面伴侣，与页面侧读取同一份 live session 状态。

这是什么¶

dsh-xiaoqi-pet 是 DSH 的 companion 插件，当前 npm 包版本 1.5.4，许可证 MIT。社区目录分类为「趣味换装」；仓库：white-source/dsh-xiaoqi-pet，目录页：skillhub.cn 插件页。

插件提供两个界面，状态同源：

• DSH Web UI 内（全平台）：注册在 shell.overlay 的全帧桌宠与会话看板。
• Harness 窗口外（可选）：macOS 为 Swift 原生 always-on-top 透明窗；Windows/Linux 为仓库内 desktop/electron 伴侣（含源码与构建脚本）。

原生桌宠连接成功后，页面内桌宠会隐藏，避免两个 Xiaoqi 同时出现；退出原生应用后，页面内桌宠恢复。

核心功能¶

会话看板¶

看板按 Needs you、In progress、Just finished 分组，展示标题、项目文件夹、状态与更新时间。每条任务独立卡片：细边框、着色底、稳定任务色，多任务不会糊成一条列表。

看板展示当前 checklist 项、进行中的具体 action（例如 修改 client.js、运行：Build the macOS app、读取 README.md）、已用时间与最近三条 action。页面侧通过 DSH 提供给 shell.overlay 的 Session 列表与状态快照更新；不读取消息正文，bridge 只传会话标题、项目文件夹名、checklist 文本、工具/action 标签与派生计时信息。

单任务与多任务展示¶

• 单个活跃会话：桌宠下方紧凑气泡以任务名开头，显示当前 action 与 elapsed time。
• 两个及以上活跃会话：底部气泡收起，桌宠旁按任务展开 drawer 卡片（各任务颜色稳定）；卡片显示 checklist/action、时间与近期 trail；点击卡片将 DSH 带到前台并打开对应会话（页面内行直接打开，原生看板通过本地命令队列）。

通知、账户与交互¶

新批准、提问、计划审阅或后台会话完成时会 notice；原生应用里以独立非阻塞桌面气泡呈现。

已登录 DSH 账户时，桌宠腹部显示钱包余额（充值 + bonus）紧凑徽章，约每分钟刷新；未登录隐藏。页面内桌宠可右键关闭，下次加载页面再出现。

桌宠可拖拽并 pin 位置（页面用视口相对坐标，原生用屏幕坐标，均本地持久化）。支持中英文与系统浅/深色，SVG 原画，无外链图或字体。

实时与兼容¶

• 页面看板：live，非轮询 Session 列表。
• 原生 app：约每 1.2 秒 轮询 token 保护的本地 bridge。
• DSH：0.2.1-rc.1 至 0.2.1-rc.3；页面桌宠需基于 Chromium 的 DSH Web UI；macOS 13+ 用于 Swift 桌宠；Windows/Linux 用 Electron 伴侣。README 写明无运行时依赖、无安装脚本、无出站网络调用。

安装与启用¶

安装 DSH 插件¶

本地 checkout：

dsh plugin --profile web add /absolute/path/to/dsh-xiaoqi-pet

npm 发布后：

dsh plugin --profile web add dsh-xiaoqi-pet

然后重新打开或 reload DSH Web UI；页面内桌宠默认出现在左下附近。

安装桌面桌宠¶

macOS 原生¶

需要 macOS 13+ 与 Xcode 命令行工具：

cd desktop
./build.sh --install
open -a "$HOME/Applications/Xiaoqi Pet.app"

应用为菜单栏附属（LSUIElement，无 Dock 图标）；爪印菜单含显示/隐藏、pin、打开看板、重连、退出。若原生未运行，页面看板的 monitor 按钮会尝试从 ~/Applications/Xiaoqi Pet.app 或 /Applications/Xiaoqi Pet.app 启动。构建与 bridge 契约见仓库 desktop/README.md。

Windows / Linux（Electron）¶

cd desktop/electron
npm install
npm start

打包：

npm run dist:win     # Windows zip
npm run dist:linux   # Linux AppImage

详见 desktop/electron/README.md。README 注明：Windows/Linux 包已配置，但维护环境未在对应系统上跑通验证，发布前请在各目标 OS 上自行 build 与验证。

典型用法¶

1. 按上一节安装 web 插件并 reload Web UI，确认左下 overlay 桌宠与看板出现。
2. 在 macOS 上按需 ./build.sh --install 并启动 Xiaoqi Pet.app；连接后页面内桌宠自动隐藏，桌面侧跟随当前任务/action 标题。
3. 多会话并行时点击桌宠旁着色 drawer 卡片，DSH 前台并打开该会话。
4. 开发改动后可用 README 建议检查：

node --check client.js
node --check index.js

本地 bridge 状态调试（macOS，需已有 bridge.json 与端口）：

TOKEN=$(python3 -c 'import json,os; print(json.load(open(os.path.expanduser("~/Library/Application Support/XiaoqiPet/bridge.json")))["token"])')
curl -sS -H "Authorization: Bearer $TOKEN" http://127.0.0.1:PORT/xiaoqi-pet/api/state

适用场景与注意¶

适合希望在 DSH 外也能扫一眼多会话进度、并需要点击直达某条会话的 Harness 用户；macOS 用户可优先用原生透明置顶窗，其他桌面用 Electron 伴侣。

DSH 生态是「一切皆插件」；skillhub.cn 为社区目录，与 DeepSeek / 幻方无官方从属关系。插件随当前 dsh 进程权限 运行，安装前请阅读源码与 MIT 许可证，确认 bridge 与本地命令队列行为符合你的安全预期。

结尾¶

dsh-xiaoqi-pet 把会话分组、任务色卡片、进度与通知接到同一桌宠体验上，Web 与桌面共享状态。进一步了解与 issue 见 GitHub：https://github.com/white-source/dsh-xiaoqi-pet；目录入口：https://www.skillhub.cn/plugins/white-source/dsh-xiaoqi-pet。