思考小伙伴 dsh-plugins/dsh-thought-buddy

dsh-thought-buddy

一个 DeepSeek Harness Web 插件，把一只动态小伙伴——GrokBot 风格的动画头像，配一条同步的打字机状态行——直接放在「Deep diving...」提示前面。

dsh-thought-buddy 是 DeepSeek Harness Web GUI 的 Web 插件，配置由配置档提供。模型干活时，那条写着 Deep diving... 的状态胶囊会长出一只 Grok 风格的小机器人头像：它会眨眼、带弹性地切换表情、目光游移，还会轻轻上下浮动——全部用 SVG 配合 requestAnimationFrame 实时绘制，不依赖任何额外的动画库。头像每切换一次表情，状态文字就用打字机效果重写一遍（逐字删除，再打出下一个词）。

头像动画从 nasawz/GrokBot（一个纯 Flutter CustomPaint 组件）移植到 Web：25 种表情 × 2 只眼睛 × 48 点眼环、18 种身体形状、39 种状态及其表情/眨眼节奏，全部保留。

效果预览——「Deep diving...」状态前的动态 GrokBot 头像

功能

| 功能 | 说明 |
| GrokBot 头像 | 思考状态的表情池 [8,16,14,17,5] 自动循环；表情之间带弹性过渡；320 ms 眨眼（随机间隔 3.5–7 s）；球面转头投影 + 目光游移；1.7 s 的轻柔呼吸浮动 |
| 表情同步打字机 | 每次切换表情，状态文字都会用打字机效果离开 Deep diving...（逐字删除、停顿，再打出下一个词），在 55 个候选词（Accomplishing…Working）之间循环，例如 Reticulating...；React 重渲染不会覆盖它（文本 fiber 的 children 字符串始终不变，React 会跳过更新） |
| Emoji 模式 | 降级模式，循环一组 emoji（默认 🤿 🫧 🌊 🐙 🔍 🧠 💭），每次切换都带弹出效果 |
| 主题感知 | 跟随 prefers-color-scheme：浅色 #5b7fe5/#fffdf7，深色 #6689ea/#181a15（与 DSH 主题一致） |
| 减少动效 | 在 prefers-reduced-motion: reduce 下，上下浮动和转头摇摆停用；表情变化和眨眼保留 |
| 自动清理 | 状态胶囊一离开 DOM，动画立即停止；插入的节点在 React 重新渲染后仍然存在，若被移除，会在下一次变更时重新插入 |

安装

复制下面的内容，粘贴给你的 DSH 智能体（也就是这个 Web GUI 里的助手）。智能体会替你完成安装和验证——不需要手动操作 npm，也不用改配置档：

Install the @dsh-plugin/dsh-thought-buddy plugin into the profile I specify (or ask me if I didn't name one). The npm package name is @dsh-plugin/dsh-thought-buddy; use the GitHub source github:dsh-plugins/dsh-thought-buddy, or file:<path> / link:<path> for local development.

Steps:
1. Add the plugin dependency: dsh plugin --profile <PROFILE> add @dsh-plugin/dsh-thought-buddy (or the equivalent plugin-manager command for my profile).
2. Verify node_modules/@dsh-plugin/dsh-thought-buddy resolves and holds a built lib/ directory (at least lib/index.js and lib/client.js). Install dsh-loader 2.x alongside this plugin; building the TypeScript sources needs the typescript devDependency (npm ci/npm install once). If the artifacts are missing, run npm run build in the plugin directory and re-add.
3. Make sure the profile manifest's dsh.profile.bundles includes @dsh-plugin/dsh-thought-buddy — the bundle patch (cordis.patch.yml) inserts the plugin row automatically at boot.
4. Do not start the profile — install and verify only, then report what you changed.

然后重启 dsh web，刷新页面，给模型发一条消息——小伙伴会出现在 Deep diving... 前面。运行时偏好使用 loader 托管的配置表单，立即生效。

从本地检出安装（link:）

本地开发时，用 link: 依赖把插件接入 web 配置档（示例：C:\Users\Administrator\.dsh\profiles\web）：

// package.json (profile)
"dependencies": { "@dsh-plugin/dsh-thought-buddy": "link:C:/path/to/dsh-thought-buddy" },
"dsh": { "profile": { "bundles": [ /* ... */, "@dsh-plugin/dsh-thought-buddy" ] } }

1. 构建产物：npm run build → 编译 TypeScript，生成 lib/client.js + lib/index.js
2. 在配置档里运行 pnpm install（离线也能用）
3. 重启 dsh web——客户端模块清单在启动时组装，新增 bundle 必须重启
4. 刷新页面，给模型发一条消息

2.0.0 配置与迁移

需要 Node.js 24.9+ 和 dsh-loader 2.x。支持 loader 显式声明的 0.1.5、0.1.6、0.1.7、0.2.0、0.2.1、0.2.2 发行系列，预发行版也包含在内。
Loader 的 config-api 把偏好设置存放在 <profile>/config/dsh-thought-buddy/config.json。0.1.6-alpha.2 之前，打开 Settings → Plugin configuration；从这个版本起，改用插件详情页。卡片默认折叠。保存后立即刷新动画。重置只改动草稿，保存后才生效。

| 字段 | 默认值 | 含义 |
| enabled | true | 显示 buddy |
| mode | avatar | 动画 avatar 或循环 emoji |
| size | 18 | 尺寸，8–64 px |
| emojis | 🤿 🫧 🌊 🐙 🔍 🧠 💭 | 非空 emoji 字符串数组 |

1.x 的 localStorage 键不再读取，也不会自动导入。请在表单里重新填写旧偏好。每个配置档有各自的配置；卸载会保留文件。卸载会取消订阅和动画，包括稍后才完成的配置读取。

开发与架构

npm ci
npm run gen # regenerate when upstream GrokBot data changes
npm run typecheck
npm run build
npm run verify

宿主入口注册一个 config-api 模板。客户端读取并订阅偏好设置，用 dshLoaderUi.mount 挂载 SVG/打字机，并在更新或卸载时清理。

src/config.ts 存放浏览器安全的默认值和类型；src/config-template.ts 仅限宿主使用。tsdown 把客户端 ESM 打包成 __ModuleLoader__.load 工厂。客户端声明 dshLoaderUi 服务依赖；包元数据声明 loader 客户端模块依赖。

test/verify.mjs 检查构建产物的 SVG、动画节奏、打字机、实时配置变更，以及异步读取期间的卸载。原始几何与动画引擎保留不变。

链接

- 仓库：https://github.com/dsh-plugins/dsh-thought-buddy
- npm：https://www.npmjs.com/package/@dsh-plugin/dsh-thought-buddy

许可证

BSD-3-Clause。眼环几何、身体形状和状态节奏源自 nasawz/GrokBot（BSD-3-Clause，Copyright (c) 2026 nasawz），已在 LICENSE 文件中署名。