@qzsy/dsh-quick-commands

中文文档
0.3.1发布于 2026/11/02MITES Module零依赖

DSH编曲器的快速命令(存储在主机磁盘上,跨设备共享):输入旁边的闪电按钮打开预设提示(桌面弹出窗口,移动端底部抽屉);在内置编辑器和设置页面中管理您自己的列表。

中文使用文档
文档目录6 节
  1. 安装
  2. 使用
  3. 内置指令
  4. 移动端
  5. 数据存储
  6. 开发

@qzsy/dsh-quick-commands

DeepSeek Harness 客户端插件:在聊天输入框左侧增加一个闪电按钮,点击后选择预设的快捷指令,一键写入(或直接发送)。

安装

dsh plugin add @qzsy/dsh-quick-commands

安装后刷新 GUI 页面即可生效。卸载:dsh plugin remove @qzsy/dsh-quick-commands。

使用

  • 点击输入框左侧的闪电按钮,选择一条指令。
    • 默认只把指令写入输入框(追加在已输入内容之后),方便你补充细节再发送。
    • 指令开启“选择后立即发送”时,选中即发送。
  • 菜单底部的“管理快捷指令”,或 设置 → 快捷指令,可以新建、编辑、上下移动、删除指令,也可以恢复被删除的内置指令。
  • 删除需要点两次(第二次确认),不会弹出系统对话框。

内置指令

名称内容
git commit push remote检查改动、按项目风格生成提交信息、提交并推送,禁止 --force / --no-verify
部署发布到服务器查找部署方式、本地构建测试、列出步骤并确认后执行、健康检查、失败给回滚方案
发布新版本按语义化版本建议版本号、更新版本和 CHANGELOG、构建测试、打 tag、推送并发布

内置指令按界面语言显示中文或英文。内置指令的内容也可以编辑。

移动端

屏幕宽度不超过 720px,或触屏设备(粗指针且宽度不超过 1024px)时:

  • 菜单和管理界面使用底部抽屉:顶部有拖动条,下滑关闭,点击遮罩或按 Esc 也可关闭。
  • 抽屉适配安全区(刘海屏底部)和软键盘弹出后的可视高度。
  • 按钮和列表的点击区域放大,输入框字号为 16px,避免 iOS Safari 聚焦时自动缩放页面。

桌面端菜单是贴着按钮的弹层,管理界面是居中的对话框。

数据存储

指令保存在运行 DSH 的电脑磁盘上,手机和电脑浏览器共用同一份:

  • 文件位置:<DSH_HOME 或 ~/.dsh>/plugin-data/qzsy-quick-commands/commands.json,写入时先写临时文件再重命名。
  • 读写接口:Host 用 ctx.webServer 注册的精确路由 /api/qzsy-quick-commands/commands(GET 读取、POST 保存),页面用同源 fetch 调用。编辑后约 0.3 秒保存,页面重新获得焦点时会重新读取。
  • 浏览器的 localStorage 只作离线缓存:断开连接时先暂存在本地,恢复后自动同步到电脑;电脑上还没有文件时,会把本机已有的指令迁移上去。
  • 保存失败时,设置页会显示具体原因(HTTP 状态或返回的错误码),并每 8 秒重试一次。
  • 多设备同时编辑时,后保存的一方覆盖先保存的一方。
  • 该路由与 GUI 同源、无需额外鉴权(与 GenUI 插件一致);默认只监听本机,只有你主动把 GUI 暴露给其他设备时才会被外部访问。

开发

bun run build      # 构建到 dist/
bun run typecheck
bun run test       # jsdom 冒烟测试

版本与发布记录

@qzsy/dsh-quick-commands 共发布 5 个版本,首次发布于 2026/11/01;过去 12 个月发布了 5 个版本。

版本发布日期距今
0.3.1latest2026/11/021 天前
0.3.02026/11/021 天前
0.2.02026/11/011 天前
0.1.02026/11/011 天前
0.0.0-stage2026/11/011 天前

关于 @qzsy/dsh-quick-commands 的常见问题

@qzsy/dsh-quick-commands 是什么?

DSH编曲器的快速命令(存储在主机磁盘上,跨设备共享):输入旁边的闪电按钮打开预设提示(桌面弹出窗口,移动端底部抽屉);在内置编辑器和设置页面中管理您自己的列表。

如何安装 @qzsy/dsh-quick-commands?

在项目目录运行 npm install @qzsy/dsh-quick-commands,或使用 pnpm add / yarn add / bun add。

@qzsy/dsh-quick-commands 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/qzsy__dsh-quick-commands 是否存在。

@qzsy/dsh-quick-commands 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@qzsy/dsh-quick-commands 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20.9.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@qzsy/dsh-quick-commands 可以商用吗?

@qzsy/dsh-quick-commands 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@qzsy/dsh-quick-commands 还在维护吗?

最新版本 0.3.1 发布于 2026/11/02(1 天前);至今共发布 5 个版本,其中过去 12 个月发布了 5 个;首次发布于 2026/11/01。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。