dsh-codex-pet

5Star0Fork0Issue0Watching
机审证据安装命令仓库已核验dsh-plugin Topic许可证READMEAI 百科
语言
JavaScript
License
MIT
分支
main
deepseek-harnessdsh-externaldsh-plugin

安装

$ dsh plugin --profile web add github:skr311/dsh-codex-pet

在终端中运行以上命令,通过 dsh CLI 安装此插件。可在右上角切换 Profile。 第一次用 dsh?看这篇新手教程

对话式安装

帮我安装 DeepSeek Harness 插件 skr311/dsh-codex-pet:先查看仓库 https://github.com/skr311/dsh-codex-pet 确认安全性,然后执行安装命令并验证插件加载成功。

把这段指令粘贴给 DSH Web GUI 里的助手,由它代你完成安装与验证。

English · 简体中文

dsh-codex-pet

DeepSeek Harness(DSH)桌面宠物插件:导入/上传 codex 风格的精灵图序列帧宠物,在 DSH Web GUI 以 shell.overlay 悬浮浮层渲染,含图库管理、基础交互与 Agent 状态联动。

Awesome DSH Plugin npm downloads License: MIT

📸 预览

✨ 核心特性

  • 序列帧播放:单 WebP 精灵图(格式 A),逐帧毫秒时长,行=动画(idle / running / waiting / review / failed / 移动 / 挥手 / 跳跃)。
  • 悬浮浮层交互:左下角常驻(贴着侧边栏),可拖拽(视口钳制 + 位置持久化)、点击挥手、空闲随机小动作。
  • 图库管理:设置 → 宠物图库——zip 上传 / URL 导入 / 启用 / 停用 / 删除 / 首帧预览。
  • Agent 状态联动:订阅 DSH 会话状态——工作中→跑动(常驻);审批/提问→等待(脉冲一次);任务完成→得意(脉冲一次);任务失败→沮丧(脉冲一次)。
  • 深/浅主题:全部样式走 --dsw-* 主题令牌,自动适配 DSH 主题。

🎮 操作指南

  1. 打开 DSH Web GUI(默认 http://127.0.0.1:3080)。
  2. 设置 → 宠物图库 → 上传/导入宠物 zip(或从 URL 导入)→ 点「启用」。
  3. 左下角出现宠物浮层(贴着侧边栏):
    • 拖拽:按住移动,松手后位置自动保存。
    • 点击:宠物挥手。
    • Agent 联动:Agent 干活时宠物跑动;等你确认/回答时发呆一次;任务完成得意一次;失败沮丧一次。
  4. 想隐藏宠物:图库页点「停用宠物」。

📦 安装

方式一:pnpm(推荐)

dsh plugin --profile web add dsh-codex-pet

方式二:GitHub clone

git clone https://github.com/skr311/dsh-codex-pet.git
cd dsh-codex-pet
dsh plugin --profile web add ./packages/dsh-codex-pet

安装后重启 DSH Web GUI(宿主半改动需重启;客户端 bundle 改完热更免重启),再刷新页面。

🛠️ 开发

  • 项目结构packages/dsh-codex-pet/(宿主半 lib/index.js + pet-library.js;客户端半 lib/client.js;vendored lib/vendor/fflate.mjs)。

  • 测试(零依赖,纯 Node + vendored fflate):

    node scripts/test-m2.js
    node scripts/test-m2-routes.js
    
  • 开发流程:客户端 bundle 改完 HMR 热更、免重启;宿主半改动需重启 DSH Web GUI。开发规范见 docs/development-spec.md,工作指引见 AGENTS.md

  • 参与贡献:见 CONTRIBUTING.md

📚 文档

License

MIT

收录徽章

Listed on deepseek-plugin.org
[![Listed on deepseek-plugin.org](https://img.shields.io/badge/listed_on-deepseek--plugin.org-007EC6)](https://deepseek-plugin.org/plugins/skr311/dsh-codex-pet)

把这段 markdown 粘贴到你的 GitHub README,链接回本插件详情页。徽章只声明已被本站收录,不代表安全认证。

返回插件目录
dsh-codex-pet — DeepSeek Harness 插件 | deepseek-plugin.org