连击反馈 QuentinCrane/dsh-combo

dsh-combo

dsh-combo 是 DeepSeek Harness（DSH）的轻量级插件，可在 DSH Web 界面和 DSH Desktop 桌面应用中显示每轮工具调用连击数。每次已提交的 tool/call 加一，到当前 turn 边界时清零。

Countdown demo

功能

- 读取 Host 提供的 dshCombo 会话投影；tool/result 和其他事件不计数。
- 默认按 turn 计数；可通过 expireMs 选择启用空闲超时。
- 显示最近调用的工具、分档视觉反馈、可选音效，并可按会话 pin 连击，在多轮之间累计。
- 在侧栏插件页有独立的配置页，全部设置（含音效开关、音量、起播连击数）保存到 profile 并立即生效。
- 运行在 DSH Web Client 中，也支持内嵌同一 Web 应用的 DSH Desktop。不修改发给模型的内容，也不连接第三方服务。Pin 状态保存在客户端页面的 localStorage。

通过官方 CLI 安装

这是独立开发的社区插件，通过官方 dsh plugin CLI 安装，不代表 DeepSeek 官方出品。代码为可直接运行的 JavaScript，无安装期构建脚本。

按你使用的 profile 安装。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

使用 DSH Desktop 时，先启动一次应用以初始化 profile，再完全退出应用，然后运行 Desktop 附带的 dsh 命令。如果终端里找不到该命令，先在应用的 Manage dsh Command 菜单中启用它。安装后重新打开 Desktop。详见 DSH 官方 Desktop 指南。

如果要安装本地 checkout，请把路径替换为包含 package.json 的目录：

dsh plugin --profile <profile> add link:/absolute/path/to/dsh-combo

启动前可以确认 bundle layer 已加入：

dsh --profile web --dump-config
dsh --profile web

插件由 Host 会话投影和 DSH Client 模块两部分组成。DSH Desktop 内嵌了同一套 Web 应用，因此安装到 desktop profile 后也会运行。DSH 要求 Client 模块声明 platform: web；这是 Client 运行时契约，并不代表插件只能在独立的 Web profile 中使用。安装或修改包文件后，请重启 profile，除非当前 HMR 设置已经应用了修改。

配置

在界面里配置

打开侧栏的插件页，选中 dsh-combo 组合包，使用它页面上的配置区。所有设置都在那里——包括音效开关、音量与起播连击数——保存后写入 profile 的行配置并立即生效，不需要重启，也不需要刷新页面。

HUD 上的齿轮面板仍然保留，作为「本机快速调整」：只对当前浏览器预览，并存在本机存储里。在插件页保存同一个键会清掉该键的本地覆盖，因此以 profile 配置为准；面板上的恢复默认设置会清空全部本地覆盖，回到配置值。

在 profile patch 里配置

cordis.patch.yml 提供可用的默认值。要手动覆盖配置，在 profile 的 cordis.patch.yml 里添加一个更靠后的 dsh-combo 行：

- id: dsh-combo
config:
enabled: true
showToolName: true
animation: normal
particles: true
preset: particles
timerMs: 10000
powerThreshold: 0
effectFrequency: 1
shake: true
shakeIntensity: 3
scale: 1
offsetX: 18
offsetY: 10
barHeight: 7
particleCount: 0
particleSize: 4
particleSpread: 1
effectDurationMs: 820
glow: 1
accentColor: ''
numberColor: ''
showGain: true
showTimer: true
position: top-right
excludeTools: []
expireMs: 0
sound: false
soundVolume: 0.35
soundFrom: 10
pinPromptMs: 5000

DSH patch layer 会替换该行完整的 config 对象。覆盖时，请把想保留的设置一并写上。

| 设置 | 默认值 | 说明 |
| enabled | true | 显示 HUD。 |
| showToolName | true | 在计数器下方显示最近调用的工具。 |
| animation | normal | off、normal 或 strong；strong 使用幅度更大的弹跳动画。系统减少动态效果设置会关闭 CSS 动画。 |
| particles | true | 动画开启时，每次工具调用触发当前预设的特效，连击越高粒子越密。 |
| preset | particles | 默认特效：particles（粒子）、flames（火焰）、fireworks（烟花）、rift（裂隙）。 |
| position | top-right | top-right、top-left、bottom-right 或 bottom-left。 |
| excludeTools | [] | 忽略的工具名，不区分大小写。 |
| expireMs | 0 | 可选的空闲重置时长，单位毫秒；0 表示关闭。最大值：600000。 |
| sound | false | 播放合成短音。 |
| soundVolume | 0.35 | 音量，范围 0–1。 |
| soundFrom | 10 | 从第几次连击开始播放声音，范围 0–1000。 |
| pinPromptMs | 5000 | turn 结束后，至少有 2 次调用的连击可被 pin 的停留时间。最大值：60000；0 表示不提示。 |

无效的枚举值会回退到默认值；数值会被夹在对应范围内。Host 半侧把每项设置都声明为 Schemastery Config 的 volatile 字段，这正是它们出现在插件页、并且写入后无需重启即可生效的原因。

自定义外观与节奏

点击计数器旁的齿轮可即时调整外观、倒计时与特效。选择保存在本机；“恢复默认设置”清除本机覆盖并恢复配置文件的值。

倒计时归零后，默认保留本轮计数；如需像 PowerMode 一样空闲后清零，请将配置中的 expireMs 设为所需时长。未 pin 的连击会使用相同的时长显示进度条。Pin 继续保留跨轮 streak。

| 设置 | 默认值 | 范围 | 说明 |
| timerMs | 10000 | 1000–60000 ms | 倒计时时长；每次工具调用重新补满。开启空闲清零时，未 pin 的连击使用 expireMs。 |
| powerThreshold | 0 | 0–1000 | 从第几次连击开始启用反馈和特效。 |
| effectFrequency | 1 | 1–20 | 每几次调用触发一次粒子特效；批量调用跨过触发点时也会触发。 |
| shake | true | 布尔值 | 独立开关连击抖动。 |
| shakeIntensity | 3 | 0–12 px | 抖动幅度。 |
| scale | 1 | 0.5–2 | 计数器和粒子整体缩放。 |
| offsetX | 18 | 0–240 px | 距左右边缘的距离。 |
| offsetY | 10 | 0–240 px | 垂直边距；顶部避开窗口栏。 |
| barHeight | 7 | 2–16 px | 倒计时条高度。 |
| particleCount | 0 | 0–80 | 每次爆发的粒子数量；0 按连击分档自动增长。 |
| particleSize | 4 | 1–12 px | 粒子大小。 |
| particleSpread | 1 | 0.25–2 | 扩散距离倍率。 |
| effectDurationMs | 820 | 200–2500 ms | 粒子动画持续时间。 |
| glow | 1 | 0–2 | 光晕强度；0 关闭光晕。 |
| accentColor | '' | #RRGGBB 或空字符串 | 自定义光晕与粒子颜色；空字符串沿用预设配色。 |
| numberColor | '' | #RRGGBB 或空字符串 | 自定义数字与进度条颜色；空字符串跟随界面主题。 |
| showGain | true | 布尔值 | 显示 +N 增量提示。 |
| showTimer | true | 布尔值 | 显示倒计时条。 |

设计参考 VS Code PowerMode：用剩余时间表示连击节奏，以触发门槛和频率调节特效，预设与独立自定义参数组合使用。本插件使用 CSS 动画与 DSH 会话投影实现，工具调用是反馈来源。

显示规则

| 连击数 | 显示效果 |
| 1–9 | 白色粗体倍率、顶部亮条、绿色微光和像素粒子 |
| 10–19 | 更大倍率、黄绿色光晕和更多粒子 |
| 20–49 | 黄色光晕、轻微抖动和更密集的粒子 |
| 50+ | 橙色光晕、最大倍率和最密集的粒子 |

HUD 使用 PowerMode 风格的「数字 × + 顶部亮条」，无卡片底色。计数器下方的样式下拉框可即时切换四种特效，并预览一次动画。选择保存在本机 localStorage，优先于配置中的默认 preset，不改变连击计数。其他预设使用各自的配色：火焰为橙色、烟花为蓝色、裂隙为紫色。

点击 📌 可将当前会话的连击保持为 streak。未 pin 的 turn 结束后，至少 2 次调用的连击会按 pinPromptMs 暗色停留；在这段时间内 pin，即可在后续 turn 继续累计。Pin 状态会保存到本地存储，刷新页面后仍然保留。

仓库结构

dsh-combo/
├── index.js # Host 会话投影和配置路由 ├── client.js # DSH Client 模块和悬浮 HUD ├── cordis.patch.yml # 可安装的 DSH bundle layer ├── package.json # Bundle 与 Client 模块清单 ├── test/ # 使用本地运行时替身的 Host / Client 单元测试 ├── docs/ # 开发、发布与故障排查说明 ├── README.md ├── README.zh-CN.md ├── CONTRIBUTING.md ├── CHANGELOG.md └── LICENSE

开发

运行本地单元测试：

npm test

Client 从 uiSession.adapter.current 读取当前 binding，再通过 sessions.binding(id).session.projections.faceOf('dshCombo') 订阅投影。Host 负责折叠已提交的会话事件。dsh.client.inject 声明包之间的关系；Client 插件导出的 Cordis inject 数组声明运行时需要等待的服务。

发布与 npm 分发说明见 docs/publishing.md：release workflow 会先跑测试，配置 NPM_TOKEN 后把当前版本发布到 npm，并始终创建带 tarball 的 GitHub Release。

官方 bundle 和 Client 规范：DSH 插件发布指南、Client Modules 参考、Session Projections 参考、官方 Client 包规范和 Desktop 指南。DSH 目前处于 developer preview，后续版本可能引入破坏性 API 变更。

如需在 GitHub 上被 DSH 插件目录发现，请为仓库添加 dsh-plugin topic。