@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 冒烟测试