GrokBot in DeepseekHarness
> 把 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 源码树内联调试）
桌面宠物最初以内置客户端插件形态开发。若要在源码树内联调试：
- 将
src/与tests/、package.json同步到/packages/client/ui-pet/； - 在
/packages/bundle/web-app/cordis.patch.yml与package.json注册ui-pet（或自定义 id）依赖； - 在 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。
