Edge-HH/GrokBot_in_DeepseekHerness

把 LaoA-GrokBot 的 GrokBot 宠物带进 DeepSeek Harness Web GUI 的浏览器客户端插件（dsh.client + dsh.bundle）：可换装、可拖拽甩出、带惯性物理与碰撞反弹的桌宠，随 dsh web 一起启动。

本仓库同时是：

• 可安装的 dsh 插件包：根 package.json 声明 dsh.bundle（cordis.patch.yml 作为一层 patch 插入浏览器客户端行）与 dsh.client（platform: web）；
• 一个独立的 npm 包源码（@edge-hh/dsh-grokbot-pet），pnpm install && pnpm bundle 即可本地产出 lib/ 产物。

---

安装

前置：装有 DeepSeek Harness（dsh CLI），并准备一个 web profile。

方式一：npm 包（发布后，推荐）

dsh plugin --profile web add @edge-hh/dsh-grokbot-pet

方式二：直接从本仓库安装（源码构建）

dsh plugin --profile web add git+https://github.com/Edge-HH/GrokBot_in_DeepseekHerness.git

从源码安装会在 profile 内执行本包的 prepare 构建（tsdown），需要能访问 npm registry 拉取构建依赖。预构建发布（npm 包或 Release .tgz）可跳过构建步骤。

安装完成后重启 dsh web 服务并刷新浏览器（Ctrl+Shift+R），桌宠出现在对话输入框右上方。卸载：dsh plugin --profile web remove @edge-hh/dsh-grokbot-pet（或对应安装源），再重启。

本插件的运行依赖（react、cordis、@deepseek-ai/* 官方包）由 dsh web 自带提供，声明为 peerDependencies，安装时不会重复下载。

---

✨ 功能

• GrokBot 渲染（移植自 LaoA-GrokBot）：6 组官方表情环（待机/思考/工作/开心/倾听/惊讶）、原版眼睛多边形 + 3D 注视 + 眨眼 + 弹簧变形；bounce / tilt / scan / glitch 状态动画
• 外观自定义：10 种颜色（官方 hex，0.22s 过渡）、8 种形状（官方 SVG path）、4 件身体部件 + 4 件趣味配饰，可多选叠穿；右键菜单整合「换装 + 控制」，设置页带实时预览
• 拖拽物理：甩出速度 = 松手瞬间鼠标速度（默认阈值 120 px/s），带惯性滑行、动态模糊、残影与边界/输入框碰撞反弹；拖拽不足 24px 视为移动、不甩出
• 眼睛跟随鼠标：「始终注视」默认开启（可在设置关闭），鼠标不悬停也看向鼠标
• 6 种快捷动作（开心/惊讶/倾听/思考/工作/待机）：点击随机触发，设置页可手动触发（带预览）
• 改名：设置里修改宠物名字，气泡标题、提示文字同步替换
• 用量气泡：每轮对话结束后弹出，显示该轮 provider 上报的 tokens 用量与估算金额（DeepSeek 官方定价近似值：输入 ¥2 / 输出 ¥8 / 缓存读 ¥0.5 / 缓存写 ¥2，每百万 tokens —— 仅供参考，非精确账单）
• 进度气泡：工具名、请求次数、步数、用时、进度条
• 音效（请求/工具/回合/弹跳），可关
• 桌面通知（Chrome → Windows），右键菜单 → 控制 → 通知授权，可关
• 隐藏/显示：右键菜单即时生效

---

构建与发布

pnpm install     # 安装构建依赖（devDependencies）
pnpm bundle      # tsdown：产出 lib/index.js + lib/invariant.js（node 半段）与 lib/client.js（浏览器半段）
pnpm typecheck   # tsc --noEmit（浏览器侧类型检查）

• lib/ 为构建产物，已 gitignore，不入库；
• 发布 npm 包时 package.json 的 repository 已指向本仓库，market/storefront 会自动建立映射；
• 不发 npm 也可把 pnpm pack 产出的 .tgz 附加到 GitHub Release（资产名请勿携带版本号，如 dsh-grokbot-pet.tgz）。

---

📁 文件结构

├── package.json           # dsh.bundle + dsh.client 清单、依赖区间（本插件包即仓库根）
├── cordis.patch.yml       # bundle patch 层：向组合树插入 dsh.client 浏览器客户端行
├── tsdown.config.ts       # 独立构建：node 半段 + 浏览器 client bundle（对齐 harness 客户端加载契约）
├── tsconfig.json          # 独立类型检查（不依赖 deepseek-harness monorepo）
├── src/
│   ├── index.ts           # 宿主侧（node）入口：无行为（Loader 挂载根包所需）
│   ├── invariant.ts       # invariant 伴生注册（无运行时不变量）
│   └── client/
│       ├── index.ts       # 客户端入口：向 shell.overlay / settings.section 槽注入
│       ├── pet.tsx        # PetView + GrokbotFigure（主组件/渲染/物理/音效/通知）
│       ├── store.ts       # 会话快照 → 宠物状态桥接（PetUsage 等）
│       ├── data.ts        # 颜色/形状/部件/配饰/设置
│       ├── pet.module.css # 样式（CSS Modules，构建时内联）
│       └── expressions.json # 原版表情环数据（构建时内联）
└── tests/                 # node-plugin 冒烟测试（随 deepseek-harness 开发环境运行）

---

🔧 本地开发（在 deepseek-harness 源码树内联调试）

桌面宠物最初以内置客户端插件形态开发。若要在源码树内联调试：

1. 将 src/ 与 tests/、package.json 同步到 <harness根>/packages/client/ui-pet/；
2. 在 <harness根>/packages/bundle/web-app/cordis.patch.yml 与 package.json 注册 ui-pet（或自定义 id）依赖；
3. 在 harness 根执行 corepack pnpm install、corepack pnpm exec tsc -b packages/client/ui-pet、corepack pnpm --filter ... run bundle、corepack pnpm run build:web 后重启。

对外发布形态（本仓库）与之等价：cordis.patch.yml 插入的行、dsh.client 清单与构建产物契约完全一致，只是不再需要改动官方源码。

---

📜 许可

MIT License — 宠物造型数据来自 LaoA-GrokBot（作者：老A玩AI，MIT）。完整署名见 THIRD_PARTY_NOTICES.md。