dsh-combo

English | 简体中文

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

功能

• 读取 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	播放柔和短促的轻击音；60 ms 内密集调用合并为一次。
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 会话投影实现，完整模型输出与工具调用共同驱动反馈。

显示规则

一次思考按模型的一轮完整输出计数，即使模型不提供显式推理文本也适用，标签显示为「思考」。流式片段、失败重试、中断输出、历史替换和同一 turn/step 的重复结算不计数。思考与工具调用都会补满倒计时。

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

HUD 使用 PowerMode 风格的「数字 × + 顶部亮条」，无卡片底色。计数器下方的样式下拉框可即时切换四种特效，并预览一次动画。选择保存在本机 localStorage，优先于配置中的默认 preset，不改变连击计数。所有预设统一随 combo 数量变色：1–9 绿色、10–19 黄绿、20–49 黄色、50+ 橙色。预设只改变动画形态；手动指定的颜色仍优先。

点击 📌 可将当前会话的连击保持为 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。