dsh-composer-quick-actions 插件介绍

前言¶

在使用 DSH（DeepSeek Harness）开发智能体时，日常对话与「文件 / 目标 / 计划 / 反馈」这四个动作的切换比较频繁。每次都要展开右侧的「+」菜单，再在「添加」小节里点选，对高频操作来说不够直接。DSH 的理念是「一切皆插件」，社区里也出现了不少类似工具，用来把常用动作从菜单中解放出来。

下面介绍的是 xdsT2 维护的 dsh-composer-quick-actions 插件，它把上述四个动作做成 composer 工具栏里常驻的控件，减少一次展开菜单的开销。

是什么¶

这是一个 DSH 客户端插件，作者为 xdsT2。它的核心价值是把 DSH 原生「+」菜单里「添加」小节的四项 —— 文件、目标、计划、反馈 —— 做成 composer 输入框工具栏里的常驻控件，让这些操作可以直接点击，不用每次展开菜单。

插件适用于 DSH 的 Web / Desktop 客户端。

核心功能¶

插件在 composer 工具栏上提供四个控件：文件、目标、计划、反馈。每个控件对应一个底层调用，功能如下：

文件¶

点击后打开当前输入框的原生文件选择器，调用 conversation.input.canPickFiles/pickFiles(sessionId)。

目标¶

点击后在输入框上方弹出原生样式的目标编辑条，直接输入目标内容。编辑条的行为如下：

没有目标：空输入框；按下 Enter 或点击 ✓ 会新建目标
已有目标：预填当前目标内容；按下 Enter 或点击 ✓ 会更新目标
按 Esc 或点击 ✕ 会关闭编辑条，不提交
内容为空时，不发送请求，并提示「目标内容不能为空」
保存失败时，编辑条保持打开，内容不丢失，错误信息内联显示
保存中时，输入框与按键会被禁用，重复按下 Enter 不会重复提交

编辑条只从目标自身取初值，不读取输入框草稿；写入目标也不会改变输入框内容。

计划¶

点击后进入计划模式；再按一下退出。底层调用 /plan ⇄ /plan off。

反馈¶

点击后打开当前会话的反馈对话框，调用 feedbackUi.openSession(sessionId)。

安装与启用¶

在 DSH 的 profile 目录下执行：

dsh plugin --profile <profile> add <本仓库的 clone 路径或包名>

也可以手动登记，步骤如下：

把本仓库 clone 到任意目录，例如 ~/dsh-composer-quick-actions
在 profile 的 node_modules 下建立软链或 junction 指向该目录
在该 profile 的 package.json 里登记：

{
  "dsh": {
    "profile": {
      "bundles": ["…", "dsh-composer-quick-actions"]
    }
  },
  "dependencies": {
    "dsh-composer-quick-actions": "link:~/dsh-composer-quick-actions"
  }
}

改完必须重启 DSH Desktop 才生效。宿主在启动时把 lib/client.js 快照进客户端模块图，运行期改动不会热更新。

典型用法¶

安装并重启后，composer 工具栏会多出三个控件，紧邻官方的「+」与权限下拉：

[ + ] [ ⊘ 工作区内修改 ▾ ] [ ☑ 计划 ]   [ 📎 文件 ] [ 🎯 目标 ] [ ✈ 反馈 ]        …… 输入框
        └── 官方那一格 └─┘            └──── 左侧一组 ────┘

点击「文件」打开文件选择器
点击「目标」在目标栏位置弹出编辑条，输入后按 Enter 或 ✓ 保存
点击「计划」进入计划模式，再按一下退出
点击「反馈」打开反馈对话框

适用场景与注意¶

适合在需要频繁使用「文件 / 目标 / 计划 / 反馈」的场景中使用，以减少操作步骤。

注意以下几点：

接管计划槽位依赖 DSH 的「最低优先级渲染」语义。如果官方将来给 PlanChip 显式指定负优先级，接管会失效（最坏情况会退回官方行为，不会崩溃）。
文件按钮依赖输入框已挂载；未挂载时点击会提示「当前输入框不接受文件」。
控件只在已选中会话的 composer 上出现（「+」与权限下拉本身也只在有会话时渲染）。
插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。

短结尾¶

该插件通过把四个常用动作常驻到 composer 工具栏，降低了操作步骤。更多细节与源码可查看：

GitHub：https://github.com/xdsT2/dsh-composer-quick-actions
插件目录页：https://www.skillhub.cn/plugins/xdsT2/dsh-composer-quick-actions