前言¶
在 DeepSeek Harness(DSH)里跑 Agent、看模型流式输出和工具调用时,界面往往偏「安静」:token 在走、工具在调,但缺少一种可感知的节奏反馈。有些开发者会在编辑器里开 PowerMode 一类打字特效;DSH Web 与 Desktop 本身并不自带同类体验。
下面介绍的 dsh-combo(维护者 QuentinCrane,仓库 QuentinCrane/dsh-combo)是社区插件目录里归类为「趣味换装」的 DSH 插件:在 Web 与 Desktop 客户端做轻量级连击 HUD,把流式 token 与工具调用回合映射成倒计时、动效与可选音效,且不改动模型上下文。社区目录页:skillhub.cn 上的 dsh-combo。
这是什么¶
dsh-combo 是 DSH 的客户端呈现插件(npm 包名 dsh-combo,当前资料中版本 0.7.0,许可 MIT)。它监听 DSH 的流式与会话信号(例如 assistant/live-chunk),并兼容 Host 提供的 dshCombo 会话投影与持久化工具调用,在界面上显示连击数、进度与视觉反馈。
插件声明兼容 DSH Web | Desktop;逻辑在浏览器/桌面端本地运行,README 说明不修改模型上下文、不发起第三方网络请求,Pin 状态可在本地跨会话持久化。
核心功能¶
连击模式与信号来源¶
连击统计支持三种模式(可在配置中切换):
- hybrid:混合流式 token 与工具回合。
- tokens:仅按打字/流式 token 计连击。
- tools:经典工具调用回合计连击。
可通过 tokensPerCombo 调整「多少次 token 比例算一次连击」;默认还可按 turn 计数。空闲倒计时由 expireMs 控制:0 表示无限模式(空闲不归零);配置页提供一键预设(∞、5 秒、10 秒、30 秒、60 秒)。timerMs 为倒计时基准时长(毫秒)。
视觉与音效¶
5 种视觉动效预设:particles(晶莹粒子)、fireworks(烟花)、slash(光刃斩击)、aura(气焰)、glitch(赛博故障)。
5 套调色板:classic、cyberpunk、sunset、matrix、frost。连击升高时段位会从 Calm 一路演进到 500+ 的 Prismatic(README 中有完整段位表)。
6 种 Web Audio 合成音色(无外部音频文件):blip、keyboard、bubble、arcade、laser、melodic;默认音效关闭,需显式打开 sound。
可选增强包括屏幕边缘晕影、里程碑称号、高吞吐时的 CRIT 角标、战绩结算卡等。
配置入口¶
- 侧栏 插件 → dsh-combo → 配置(推荐):保存写入 profile,即时生效,无需重启或整页刷新。
- 连击 HUD 旁齿轮面板:快速调参、切换预设。
- Profile 补丁
cordis.patch.yml:声明全局缺省(完整字段见仓库 配置参考指南,资料称共 38 项)。
内置交互式迷你 HUD 模拟器与音效试听,便于安装后先「试手感」再开真实会话。
安装与启用¶
通过官方 dsh plugin CLI 安装;Web 与 Desktop 使用不同 profile:
# DSH Web 界面
dsh plugin --profile web add github:QuentinCrane/dsh-combo
# DSH Desktop 桌面端
dsh plugin --profile desktop add github:QuentinCrane/dsh-combo
Desktop 提示:首次使用 DSH Desktop 时,先启动一次应用以初始化 profile,退出后在终端使用 Desktop 附带的 dsh(若未识别,可在应用 Manage dsh Command 中启用)。详见 官方 Desktop 指南。
本地开发目录可链式安装(路径需为含 package.json 的绝对路径):
dsh plugin --profile <profile> add link:/absolute/path/to/dsh-combo
安装完成后,在侧栏打开插件配置页,确认 enabled: true,再按需要选 comboMode、预设与主题。
典型配置示例¶
无需手改散落配置文件时,仍可用 profile 补丁声明缺省。下面片段来自 README,展示常用字段(更多项见配置文档):
- id: dsh-combo
config:
enabled: true
comboMode: hybrid # hybrid | tokens | tools
preset: particles # particles | fireworks | slash | aura | glitch
colorTheme: classic # classic | cyberpunk | sunset | matrix | frost
position: top-right # top-right | top-left | bottom-right | bottom-left
sound: false # 音效开关 (默认关闭)
soundTheme: blip # blip | keyboard | bubble | arcade | laser | melodic
soundVolume: 0.35
timerMs: 10000
expireMs: 0 # 0 = 无限模式
典型用法流程:
- 按 profile 安装插件并打开配置页,选
hybrid或tools以匹配你 mainly 看流式输出还是工具链。 - 选
preset与colorTheme,设置 HUDposition;需要反馈声时设sound: true并调soundVolume。 - 在真实对话中观察连击 HUD;需要跨 turn 累积时,点击连击窗上的 Pin(📌)锁定 Streak。
HUD 不显示、无声或配置不生效时,可查阅仓库 问题排查指南。
适用场景与注意¶
适合谁:希望在 DSH Web/Desktop 里给 Agent 开发、演示或长时间对话增加轻量「节奏感」的开发者;偏好 PowerMode 式反馈、又希望留在 Harness 统一界面内的人。
生态说明:DSH 社区插件目录(如 skillhub.cn、dsh-plugin.org listing)是独立站点,与 DeepSeek / 幻方无官方从属关系;安装前建议自行查看 GitHub 源码 与 MIT 许可证。插件随当前 DSH 进程/客户端权限运行,安装即信任其客户端注入与本地存储行为。
动效与音效会增加界面动效与 CPU/音频开销;共享屏幕或录屏场景请先自测是否干扰。默认关闭音效,避免在开放办公环境误开。
结尾¶
dsh-combo 把流式 token 与工具调用转成可配置的连击 HUD:五种动效预设、五种配色、可选六种合成音效与倒计时/Pin,纯客户端、可即时改配置。需要细节参数与开发说明时,以仓库 README 与 docs/configuration.zh-CN.md 为准。
- 目录页:https://www.skillhub.cn/plugins/QuentinCrane/dsh-combo
- GitHub:https://github.com/QuentinCrane/dsh-combo