在 DSH（DeepSeek Harness）开发环境中，频繁在终端中切换目录来执行脚本（如 npm run lint 或 pytest）会打断工作流。dsh-quick-commands 插件通过在工作区头部提供快捷命令入口，解决了这一问题。
这是什么¶
dsh-quick-commands 是一个 DSH Web 插件，由 fonlan 维护。它允许为每个 DSH 工作区配置命名 shell 命令。用户无需在终端中切换目录，只需点击会话头部的图标即可运行命令，并通过浮动弹窗实时查看输出。
核心功能¶
- 按工作区管理命令：为每个工作区配置独立的命名命令。
- 会话头部执行：从 Session log 左侧的
▶快捷运行图标点击执行。 - 实时输出弹窗：约 200ms 频率流式输出 stdout/stderr，纯文本显示，自动跟随滚动，支持分页签。
- 设置卡片管理：在插件设置中列出所有工作区，支持新增、重命名和删除命令。
- 远程 SSH 支持：通过 SSH 在远程主机上执行命令，需加载
@dsh-ssh/dsh-ssh宿主插件。 - 串行执行：同一工作区同时只运行一个命令。
安装与启用¶
在终端中执行以下命令安装插件：
dsh plugin --profile web add @fonlan/dsh-quick-commands
安装完成后，重启 DSH (dsh web) 即可生效。
典型用法¶
- 配置命令：进入设置 → 插件配置 → Quick commands，为特定工作区添加命令（例如
npm run lint）。 - 运行命令：在会话头部点击
▶图标，选择对应命令。 - 使用占位符：命令文本中可使用
{workspace}、{cwd}、{title}等占位符，插件会自动替换为实际路径或标题。 - 调整弹窗：拖动弹窗边框或角手柄调整大小，尺寸会自动保存。
适用场景与注意¶
- 远程工作区：使用远程工作区时，必须加载
@dsh-ssh/dsh-ssh宿主插件，否则无法执行远程命令。 - 权限与安全：命令由用户配置并点击执行，不涉及模型请求或审批提示。插件以宿主进程自身的环境变量和 PATH，在工作区目录下执行命令。本地 macOS/Linux 使用
bash -c，本地 Windows 使用pwsh -c。远程命令以远程用户权限执行。请只配置信任的命令。
该插件为 DSH 工作区提供了标准化的脚本执行层。更多细节可参考 GitHub 仓库。
