Skip to content

v0.1.0

Choose a tag to compare

View all tags
@LINNoot LINNoot released this 16 Aug 17:04
· 23 commits to main since this release
v0.1.0
8044d13

🐱 DSH 桌宠 v0.1.0

让桌面宠物实时响应 DeepSeek Harness 的工作状态：任务运行时卖力干活、思考时托腮、等待授权时翘首以盼、任务完成时蹦跳庆祝......

部分沿用 codex 桌宠设计思路，调整触发逻辑，重构了部分设定，使之更加符合直觉，为 DSH 重新实现状态检测，开箱即用。

✨ 特性

  • 实时状态感知：细粒度事件（turn/step/tool/chunk/approval/goal）+ agent/status + agents 服务轮询校正
  • 完成判定二选一：普通任务回合结束 → 庆祝；有 goal 的会话 → 只认目标完成；均带 8s 静默去抖
  • 气泡：会话标题 + 状态短语 + AI 总结第二行 + 右侧状态圆圈（hover 光晕，完成时绿勾）
  • 中断圆圈：任务进行中鼠标划过气泡出现灰方块，点击中断当前任务（DSH 无暂停 API，中断保留输入消息）
  • Web GUI 电源开关：侧边栏按钮，关闭=退出进程、开启=重新拉起，状态持久化
  • 完整交互：拖拽、悬浮、托盘菜单（宠物/大小/置顶/气泡开关）
  • 零网络零 LLM 成本：状态 → 动画全确定性推导
  • 自定义桌宠：高度兼容 codex 及其开源社区桌宠，桌宠格式可参考 codex

📦 安装

前置：Windows 10/11 + DeepSeek Harness（dsh web，需已运行过一次）。

方式一：一键脚本（推荐，无需 Python）

# ① 下载本 Release 的附件 DshPet.exe（存到任意位置，如 D:\Downloads\）
# ② clone 仓库并一键安装（脚本会自动使用你下载的 exe）：
git clone https://github.com/LINNoot/dsh-co-pet.git
cd dsh-co-pet
powershell -ExecutionPolicy Bypass -File scripts/install.ps1 
# 重启 DSH（dsh web）后桌宠随 DSH 自动启动

没有 Python 也能装：-PetExe 直接指定下载好的 exe，跳过构建。
有 Python 3.11+ 的话可以不带 -PetExe 跑，脚本会自动构建（较慢，首次要装 PyInstaller）。

方式二：自己构建 exe（需要 Python 3.11+）

git clone https://github.com/LINNoot/dsh-co-pet.git
cd dsh-co-pet
powershell -ExecutionPolicy Bypass -File scripts/install.ps1
# 脚本检测到没有 exe 时自动调用 scripts/build.ps1 构建

方式三：手动装插件

dsh plugin --profile web add C:\path\to\dsh-co-pet\plugin

🎮 状态 → 桌宠行为

DSH 信号 桌宠行为
用户提交消息 / 推理 / 工具执行 running，气泡显示会话标题 · 思考中/回复中 + AI 总结
产出代码变更（diff） review 循环等待审阅
请求授权 jumping → 等待（授权通过自动恢复运行）
任务完成 waving 庆祝 + 绿勾圆圈 + 完成气泡（10s）
长时间无活动（5 分钟） idle

🐱 宠物包

  • pet/pets/yuexinmiao/（月薪喵）已随仓库分发，clone 即用，仅作为效果演示
    （注：此宠物来源：codex-pet.org 开源社区）
  • pet/pets/deepseek/（ds）已随仓库分发，clone 即用，仅作为效果演示
    （注：此宠物来源：codex-pet.org 开源社区）
  • 自定义宠物：按 Codex 契约放入 pet/pets/<名称>/（8 列 × 9 行精灵图）

⚠️ 已知限制

  • 桌宠窗口与脚本为 Windows 优先（Linux/macOS 未做适配工作，后续会跟进，暂时不确定效果）
  • 中断功能为"停当前回合"（DSH 无 agent 级暂停/恢复 API，中断后保留输入消息，可再发消息继续）
  • 若 npx dsh web 启动很慢（>1 分钟），检查 ~/.npmrc 是否残留死代理配置（见 README 故障排查）（可以丢给 AI 修复 :D）

📜 License

MIT（代码）。宠物素材 pet/pets/yuexinmiao/ 来自开源社区，仅供学习交流（见包内说明）。

Assets 3
Loading