前言¶
DeepSeek Harness (DSH) Web Composer 采用「一切皆插件」的架构。在开发与调试智能体时，开发者需要清晰地感知模型当前的推理状态与工具调用情况。dsh-thinkbar 插件填补了这一视觉反馈的空白，为 DSH 的 Web Composer 提供了一套非侵入式的状态指示方案。
插件定位¶
dsh-thinkbar 是由维护者 tower1229 开发的动态推理等待可视化指示器。它通过 Web UI 插件的形式，在模型思考窗口填充动态的热力色板，并在工具执行时叠加独立的工具活动视图，完全在客户端运行。
核心功能¶
该插件提供以下核心能力：
- 热力色板 (Thermal Iron Scale Palette): 在推理过程中，指示器会呈现从初始蓝（0秒）过渡到红（约6.7秒）、橙（约13.3秒）直至发光金（20秒）的平滑渐变。
- 零侵入门户适配 (Zero-Intrusion Portal Adapter): 通过 DSH 的公共生命周期接口
conversation.input.right注入，无需修改 DSH 内部代码或生成自定义的模型标签字符串。 - 模型兼容的每步状态机 (Model-Compatible Per-Step State Machine): 插件能独立追踪每个步骤的推理状态，并在检测到工具调用时切换至工具活动模式。
- 可见工具活动 (Visible Tool Activity): 在工具执行期间，显示紫青色的扫描动画并暂时叠加当前正在运行的工具名称。
- 流体排空动画 (Fluid Drain Animation): 推理或工具执行结束后，指示器会在 240ms 内平滑消退。
- 无障碍支持 (Accessibility Ready): 自动检测并尊重系统的
prefers-reduced-motion设置。 - 100% 客户端私有 (100% Client-Side & Private): 零后端修改、零遥测、零外部网络流量。
安装与启用¶
请确保你的环境满足前置要求后再执行以下步骤。
前置要求¶
- DeepSeek Harness: 版本
0.1.2-alpha.4（仅支持此版本，早期构建不兼容）。 - Node.js:
^22.19.0或>=24.0.0。 - pnpm: 版本
>= 9.0。
安装步骤¶
- 通过 npm 注册表安装：
pnpm dsh plugin --profile web add dsh-thinkbar
- 若需测试本地构建的 tarball：
pnpm dsh plugin --profile web add ./dsh-thinkbar-<version>.tgz
- 重启 Web Profile 以加载插件：
pnpm dsh web
- 验证插件是否正确加载：
pnpm dsh --profile web --dump-config
检查输出中是否包含 `dsh-thinkbar` 行。
典型用法¶
安装并重启 Profile 后，插件会自动生效。
- 当模型开始推理时，模型选择器区域会出现热力色板填充，颜色随时间推移发生变化。
- 当模型调用工具时，色板停止，并切换为紫青色的工具活动视图。
- 推理结束或工具调用完成后，视图会在 240ms 内平滑消退。
适用场景与注意¶
- 适用场景: 需要 Web Composer 实时反馈模型内部状态（思考进度、工具执行）的开发者与调试人员。
- 注意: 插件完全运行在客户端，不会将数据发送至外部服务，但需要依赖 DSH 的特定版本（0.1.2-alpha.4）提供的公共接口。安装前请检查源码与许可证（MIT）。
总结¶
dsh-thinkbar 为 DeepSeek Harness Web Composer 提供了直观、流畅且私有的状态可视化能力。通过非侵入式的适配与精确的状态机控制，它让开发者能更清晰地观察智能体的运行逻辑。
- 目录页: https://www.skillhub.cn/plugins/tower1229/dsh-thinkbar
- 源码仓库: https://github.com/tower1229/dsh-thinkbar
