使用

1. 打开 dsh web(如 http://127.0.0.1:3080)
2. 进入 设置 → 插件 → 快捷命令
3. 添加命令:填写命令名与提示词(如 subagent / 使用subagent_agy_ui,model=gemini-3.7-flash-high委派任务:)
4. 在对话输入栏输入 / ,选中你的命令,回车发送

同时删除 ~/.dsh/settings.yaml 中的 quick-commands 配置段(可选)

## 四、配置

配置位于 **设置 → 插件 → 快捷命令**,对应 settings namespace `quick-commands`:

| 配置项 | 类型 | 说明 |
| --- | --- | --- |
| `commands[].name` | string | 命令名,输入栏以 `/名称` 触发 |
| `commands[].prompt` | string | 选中命令后,发送时展开为完整提示词的文本 |

也可直接编辑 `~/.dsh/settings.yaml`:

```yaml
quick-commands:
  commands:
    - name: subagent
      prompt: 使用subagent_agy_ui,model=gemini-3.7-flash-high委派任务:

五、权限与数据

• 配置数据:仅读写 dsh settings 文档(quick-commands namespace),不落盘其他文件
• 网络:无任何网络请求
• 凭据:不存储、不读取任何密钥或凭据
• 本地执行:不 spawn 任何外部进程

六、常见问题

输入 / 后菜单里没有我的命令

确认命令已保存(设置面板有防抖 400ms 自动保存;保存后 settings.yaml 应出现 quick-commands 段)。若确认已保存仍不出现,刷新页面(浏览器缓存旧 bundle)。

发送时报 no serializer for reference source

通常是浏览器缓存了旧版本 bundle。强制刷新页面(如 Ctrl+Shift+R)后重试。

配置丢失

配置持久化在 ~/.dsh/settings.yaml 的 quick-commands 段。若删除该段或手动改动后未重启,请重启 dsh 服务。

七、开发

pnpm install
pnpm build     # tsc 编译服务端 + 拷贝客户端 bundle
pnpm typecheck # 类型检查
pnpm test      # 运行测试(vitest)

结构:

src/
├─ index.ts          # 服务端:settings namespace 注册
├─ settings.ts       # schema + 默认配置
└─ client/index.js   # 浏览器半:input-trigger source + 设置面板卡片

八、许可与安全

• 许可证:MIT(见 LICENSE)
• 安全:安全问题请勿公开提交 issue,通过仓库页面联系维护者(见 SECURITY.md)

四、配置

配置位于 设置 → 插件 → 快捷命令,对应 settings namespace quick-commands:

配置项	类型	说明
commands[].name	string	命令名,输入栏以 /名称 触发
commands[].prompt	string	选中命令后,发送时展开为完整提示词的文本

也可直接编辑 ~/.dsh/settings.yaml:

quick-commands:
  commands:
    - name: subagent
      prompt: 使用subagent_agy_ui,model=gemini-3.7-flash-high委派任务:

配置丢失

配置持久化在 ~/.dsh/settings.yaml 的 quick-commands 段。若删除该段或手动改动后未重启,请重启 dsh 服务。