# @qzsy/dsh-quick-commands 中文文档

规范地址：https://npmcn.com/package/%40qzsy/dsh-quick-commands/

版本：0\.3\.1
npm 元数据更新时间：2026-11-02T04:25:09.755Z
中文译文更新时间：2026-11-02T06:43:32.318Z
软件包许可：MIT

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40qzsy/dsh-quick-commands
原文对照：https://npmcn.com/package/%40qzsy/dsh-quick-commands/?lang=original
项目主页：https://codeup.aliyun.com/qzsy/dshmarket/deepseek-harness-market
源码仓库：https://codeup.aliyun.com/qzsy/dshmarket/deepseek-harness-market

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：57 kB，9 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20\.9\.0
- 运行依赖：0 个
- 首次发布：2026-11-01T11:40:15.756Z
- 最新版本发布：2026-11-02T04:25:09.586Z
- 已发布版本数：5（近 12 个月 5 个）

## 中文简介

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

## 安装

```sh
npm install @qzsy/dsh-quick-commands
```

也可以使用：`pnpm add @qzsy/dsh-quick-commands`、`yarn add @qzsy/dsh-quick-commands`、`bun add @qzsy/dsh-quick-commands`

## README

# @qzsy/dsh-quick-commands

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

## 安装

```bash
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 暴露给其他设备时才会被外部访问。

## 开发

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

## 常见问题

### @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 和提交记录判断。