Skip to content
Back to search

dsh-mixer

调音台视图:把多个 DeepSeek Harness 会话并排一屏,等待审批 / 提问的通道即时亮灯。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dtdths--dsh-mixer/badge.svg)](/listings/dtdths--dsh-mixer)

HTML

<a href="/listings/dtdths--dsh-mixer"><img src="/api/listings/dtdths--dsh-mixer/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

需要 **DSH 0.2.1 或更新的 Web 端**(`dsh web`;本版在 `0.2.1-rc.2` 上验证通过)。

# 一行装好(Web profile)
dsh plugin --profile web add github:dtdths/dsh-mixer#v1.6.1

> `dsh` 不在 PATH 里(从源码 checkout 跑)就用 `pnpm dsh plugin --profile web add …`,见下面折叠。

然后重启 DSH,并在浏览器里**硬刷新**一次(`Cmd/Ctrl + Shift + R` —— 插件改动必须走冷启动,热重载会骗人):

dsh web            # 或你平时启动 DSH 的方式

看到会话头部多出一个 **调音台** 按钮,就装好了;也可以在输入框里敲 `/mixer` 进入。

<details> <summary>从源码 checkout 运行 / 装在 Desktop / 完全离线</summary>

**从 DSH 源码 checkout 运行**(仓库根目录):

pnpm dsh plugin --profile web add github:dtdths/dsh-mixer#v1.6.1

**装在 Desktop 版**(先完整退出 Desktop,否则 profile 被占用):

dsh plugin --profile desktop add github:dtdths/dsh-mixer#v1.6.1

**改代码 / 开发调试**(`link:` 本地目录,改完刷新即生效):

dsh plugin --profile web add /绝对路径/dsh-mixer

**完全离线**(打包成 tgz 传过去):

npm pack --cache /tmp/npm-cache        # 产出 dsh-mixer-1.6.1.tgz
dsh plugin --profile web add /绝对路径/dsh-mixer-1.6.1.tgz

**不想敲命令**:如果你的 DSH 里有 `plugin_manager` 工具,直接在会话里说一句「安装插件 `github:dtdths/dsh-mixer#v1.6.1`」即可。

> 装过早期原型 `dsh-mixer-spike` 的话请先卸掉 —— 它和正式版会抢同一个视图入口。 </details>

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 182 lines
  1. <div align="center">
  2. <img src="icon.svg" width="88" height="88" alt="dsh-mixer">
  3. <h1>dsh-mixer · 调音台</h1>
  4. <p><b>把多个 DSH 会话并排摆到一屏。谁在等你,一眼就看见。</b></p>
  5. <p>
  6. <img alt="release" src="https://img.shields.io/github/v/release/dtdths/dsh-mixer?color=3b82f6&label=release">
  7. <img alt="checks" src="https://img.shields.io/badge/checks-97%20tests%20%2B%20cold%20boot-2ea043">
  8. <img alt="license" src="https://img.shields.io/badge/license-MIT-6b7280">
  9. <img alt="DSH" src="https://img.shields.io/badge/DSH-0.2.x-8b95a5">
  10. </p>
  11. </div>
  12. ![调音台视图:三格并排 —— 空对话 / 等待审批 / 正在执行](docs/assets/mixer.png)
  13. > 同一屏里三种状态并存:一个是空对话,一个是正在跑(转圈 + 工具调用),一个卡在**等待审批**(审批卡就在那一格里,顶栏同步计数)。
  14. > 截图由真实 DSH 宿主驱动,工作区与会话均为虚构演示数据。
  15. ---
  16. ## 为什么需要它
  17. 并行推进三四个需求时,你一次只能看一个会话。切走的那几格如果卡在**等待审批**、**等待计划确认**、或者**有一个问题要你回答**,它们就安静地空等 —— 你不知道,机器也停在那儿。
  18. 调音台把这件事摊平:多个会话横着摆开,每个一格,等待你的那一格会亮。
  19. ## 它做什么
  20. - **一屏多路,真并排** —— 每格是一个真实会话:完整对话记录 + 官方输入框,草稿互不干扰。不是缩略图,也不是只读快照。
  21. - **亮灯** —— 卡在审批 / 计划确认 / 提问的通道,头部亮一条琥珀竖条;顶栏汇总成「N 个通道在等你」,点一下全部放回。状态点与左侧会话行**同源同判据**:等待、执行中、子代理运行中、已完成未读,一格一格对得上。
  22. - **solo** —— 临时只看一个通道,其余压成 64px 窄条:还在跑、还亮灯,只是不抢注意力。退出后宽度原样回来。
  23. - **归档可撤销** —— 在调音台里归档一个会话,顶栏会出现 6 秒的「已归档「…」撤销」,撤销后通道回到原位置、原宽度。
  24. - **跳转快捷键** —— `Cmd/Ctrl + Alt + 1..9` 跳第 N 个通道,`]` / `[` 上下切换,`S` solo。走 DSH 自己的快捷键服务,可以在设置里改键。
  25. - **排布随你** —— 拖通道头部排序(虚影是整格),拖格间分界线调宽,宽度和通道集合刷新后仍在。
  26. ## 安装
  27. 需要 **DSH 0.2.1 或更新的 Web 端**(`dsh web`;本版在 `0.2.1-rc.2` 上验证通过)。
  28. ```bash
  29. # 一行装好(Web profile)
  30. dsh plugin --profile web add github:dtdths/dsh-mixer#v1.6.1
  31. ```
  32. > `dsh` 不在 PATH 里(从源码 checkout 跑)就用 `pnpm dsh plugin --profile web add …`,见下面折叠。
  33. 然后重启 DSH,并在浏览器里**硬刷新**一次(`Cmd/Ctrl + Shift + R` —— 插件改动必须走冷启动,热重载会骗人):
  34. ```bash
  35. dsh web # 或你平时启动 DSH 的方式
  36. ```
  37. 看到会话头部多出一个 **调音台** 按钮,就装好了;也可以在输入框里敲 `/mixer` 进入。
  38. <details>
  39. <summary>从源码 checkout 运行 / 装在 Desktop / 完全离线</summary>
  40. **从 DSH 源码 checkout 运行**(仓库根目录):
  41. ```bash
  42. pnpm dsh plugin --profile web add github:dtdths/dsh-mixer#v1.6.1
  43. ```
  44. **装在 Desktop 版**(先完整退出 Desktop,否则 profile 被占用):
  45. ```bash
  46. dsh plugin --profile desktop add github:dtdths/dsh-mixer#v1.6.1
  47. ```
  48. **改代码 / 开发调试**(`link:` 本地目录,改完刷新即生效):
  49. ```bash
  50. dsh plugin --profile web add /绝对路径/dsh-mixer
  51. ```
  52. **完全离线**(打包成 tgz 传过去):
  53. ```bash
  54. npm pack --cache /tmp/npm-cache # 产出 dsh-mixer-1.6.1.tgz
  55. dsh plugin --profile web add /绝对路径/dsh-mixer-1.6.1.tgz
  56. ```
  57. **不想敲命令**:如果你的 DSH 里有 `plugin_manager` 工具,直接在会话里说一句「安装插件 `github:dtdths/dsh-mixer#v1.6.1`」即可。
  58. > 装过早期原型 `dsh-mixer-spike` 的话请先卸掉 —— 它和正式版会抢同一个视图入口。
  59. </details>
  60. ## 上手
  61. **1. 加通道** —— 顶栏的 `会话` 浮层里勾选会话,勾上即入、取消即出。浮层左列每个工作区行 hover 会出 `+会话`,点它就在那个工作区新建一个会话,并直接成为第 0 个通道。
  62. **2. 等你的通道会亮** —— 某个通道的会话在等你处理时,头部左侧出现琥珀竖条,顶栏同步累加计数;点顶栏的汇总条可以把移出的通道全部放回。
  63. <img src="docs/assets/waiting.png" width="520" alt="通道内等待审批:拒绝 · 允许一次">
  64. *通道里的审批卡:拒绝 / 允许一次就在这一格完成,不用切走。*
  65. **3. solo 一下** —— 通道头部的 `solo`、顶栏的 `solo:… 退出`、或 `Cmd/Ctrl + Alt + S`,三处进出。其余通道压成窄条,状态点仍然准确。
  66. ![solo:一个通道占满,其余压成窄条](docs/assets/mixer-solo.png)
  67. **4. 排布** —— 拖通道头部换位置;拖格与格之间的分界线调宽(单格最小 380px,超宽就横向滚动);`×` 把通道移出屏幕,顶栏可再放回。
  68. **5. 回常规视图** —— 顶栏「常规视图」,或点左侧栏的会话行。侧栏恢复原状,原来那格的滚动位置与草稿都还在。
  69. ## 快捷键
  70. | 动作 | 默认键位 |
  71. | --- | --- |
  72. | 跳到第 1–9 个通道 | `Cmd/Ctrl + Alt + 1..9` |
  73. | 下一个 / 上一个通道 | `Cmd/Ctrl + Alt + ]` / `[` |
  74. | solo 光标所在通道 | `Cmd/Ctrl + Alt + S` |
  75. 全部注册在 DSH 的快捷键设置里,可以改成你自己的。跳过去时光标落在该格草稿的**末尾**,接着写就行。
  76. ## 设计上的取舍
  77. - **左侧栏折成 56px 轨道** —— 宿主没有「完全隐藏」的选项,接管侧栏又会连带弄丢设置入口,所以左边永远留一条窄轨。
  78. - **单格最小 380px** —— 不够宽就横向滚动,而不是把每格挤到没法用。
  79. - **solo 与「移出」不持久化** —— 它们属于「这一次坐着」的临时状态,刷新即回到并排;**通道集合与每格宽度是持久化的**。
  80. - **归档撤销只留 6 秒** —— 与侧栏归档 toast 同一个窗口,不长不短。
  81. - **主题跟随宿主** —— 浅色/深色都用宿主 alias token,不另造一套颜色。
  82. - **纯客户端** —— Host half 保持为空,全部逻辑在视图层:不发网络请求、不写宿主的 `mainView`、不碰模型配置。
  83. - **调音台视图里点文件链接 = 离开调音台去看它** —— 宿主右栏只在没有面板占主列时才认「在屏会话」,所以在调音台里直接开文件会弹「无法打开文件 `sidebarRight: no session surface is mounted`」。从 v1.6 起插件接管这一类点击:点消息 / 工具行里的文件链接、交付物卡片的预览,会**落到那一格对应的会话**并把文件开在右栏(`docs/spec.md` §7.4、[ADR-0004](docs/adr/0004-file-links-leave-the-mixer-and-replay-the-host-handler.md))。代价是调音台不再保持 —— 板子还在,再进一次即可。**输入框里正在编辑的 `@` 引用**同样接管(v1.6.1 起):点它也会先落到那一格,再把同一个引用在输入框里点一次。
  84. - **「常规视图」落到你正在用的那一格** —— 在调音台里明确动过某一格(点它、用跳转键落到它、或在它里面新建)后,退出时常规视图显示的就是那个会话;进来后什么都没动则落回进调音台前的会话。
  85. ## 开发与自检
  86. ```bash
  87. npm run check # 语法 + 97 个用例 + 冷启动守卫
  88. DSH_REPO=/另一个/DSH/checkout npm run check # 换宿主重验:契约漂移会指到具体断言
  89. ```
  90. `npm run check` 里的**冷启动守卫**不是可选项:本插件踩过「服务边写错 → 整页启动失败、而热重载看起来一切正常」的坑,所以任何 `apply()` / `inject` 改动都要走这条。
  91. 客户端全部逻辑在单文件 [`client.js`](client.js)(`React.createElement`,非 JSX);判断逻辑抽成纯函数并经 `__test` 暴露给 `tests/`。换宿主时最该读的是 [`tests/host-contract.test.mjs`](tests/host-contract.test.mjs) —— 它把插件依赖的每一条宿主契约都钉成了会失败的断言。
  92. ## 文档
  93. | 想知道什么 | 看哪里 |
  94. | --- | --- |
  95. | 需求、决策、验收判据、实现红线、内部缝 | [`docs/spec.md`](docs/spec.md)(**§11 是实现状态与缝表**) |
  96. | 三条不改的架构决策 | [`docs/adr/`](docs/adr/) |
  97. | 插件开发踩过的坑(服务边、冷启动、拖拽、键位校验) | [`docs/plugin-gotchas.md`](docs/plugin-gotchas.md) |
  98. | 术语 | [`CONTEXT.md`](CONTEXT.md)、[`docs/naming.md`](docs/naming.md) |
  99. | README 里的截图怎么来的(宿主版本、复现步骤、演示数据说明) | [`docs/assets/PROVENANCE.md`](docs/assets/PROVENANCE.md) |
  100. | 待办增强 | [issue #12](https://github.com/dtdths/dsh-mixer/issues/12) |
  101. 报 bug、提需求都走 [GitHub issues](https://github.com/dtdths/dsh-mixer/issues)(带一张截图最好)。
  102. <details>
  103. <summary>目录结构</summary>
  104. ```
  105. dsh-mixer/
  106. ├── package.json # bundle 清单 + dsh.client.external / inject
  107. ├── cordis.patch.yml # 插入行 id=dsh-mixer
  108. ├── index.js # Host half(保持为空)
  109. ├── client.js # Client half:全部 UI 与状态,单文件
  110. ├── boot-check.mjs # 冷启动守卫(真实 Cordis Context + 对照项)
  111. ├── tests/ # 纯函数缝 / 真 React 静态渲染 / jsdom 交互 / 宿主契约
  112. ├── locale/{en,zh}.json # meta.title / meta.description
  113. ├── icon.svg # 三路推子,其中一路亮灯
  114. ├── docs/ # spec / ADR / 踩坑 / 命名 / 调研
  115. │ └── assets/ # README 截图 + 出处记录
  116. └── LICENSE
  117. ```
  118. </details>
  119. ## English
  120. **dsh-mixer** is a mixer-style multi-session view for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness): several independent conversations side by side, each with its own history and composer, with the channels blocked on an approval or a question lit up — so nothing waits for you silently.
  121. ```bash
  122. dsh plugin --profile web add github:dtdths/dsh-mixer#v1.6.1
  123. ```
  124. Restart DSH, hard-refresh the page, then press the **Mixer** button in the session header (or type `/mixer`). Requires DSH 0.2.1+ web. Screenshots use fabricated demo data.
  125. ## License
  126. MIT,见 [LICENSE](LICENSE)。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.