DeepSeek Harness - 对话快捷栏插件 (@rooode/dsh-plugin-quickbar)

本插件为 DeepSeek Harness (DSH) 与 WorkBuddy 对话界面提供了常驻输入框正上方的工作空间快捷指令栏，支持工作空间独立绑定、自定义提示词创建/编辑、以及点击一键在会话中触发提示词。

---

🌟 核心特性 (Features)

1. 📌 对话框上方常驻对齐：
   • 挂载于官方 conversation.input.dock 插槽，与输入卡片左右边框及居中位置像素级对齐。
2. ➕ 纯自定义快捷项创建：
   • 默认纯净空白状态，点击右侧「+」图标即可快速新建；
   • 弹窗支持配置 快捷项名称、提示词 (Prompt)、快捷 Emoji 图标 与 触发行为（直接发送 / 填入输入框）。
3. 📁 工作空间独立绑定 (Workspace Scoped)：
   • 快捷项与当前工作空间路径严格隔离存储，切换工作空间时自动切换对应快捷列表。
4. ⚡ 一键触发对话：
   • 点击快捷项胶囊，自动将提示词注入对话输入框并自动触发发送。
5. 🛠️ 快捷项管理面板：
   • 支持列表管理、编辑修改、单项删除与批量清空。

---

📦 快速安装 (Installation)

在终端中执行以下命令，将插件一键安装到 DSH 的 web profile 中：

方式 1：标准 npx 安装（推荐，无需全局安装）

# 1. 一键从 npm 下载并安装插件
npx @deepseek-ai/dsh plugin --profile web add @rooode/dsh-plugin-quickbar

# 2. 启动 DSH Web 界面
npx @deepseek-ai/dsh web

方式 2：全局 dsh CLI 安装

如果您已全局安装了 npm install -g @deepseek-ai/dsh：

# 1. 安装插件
dsh plugin --profile web add @rooode/dsh-plugin-quickbar

# 2. 启动
dsh web

方式 3：离线 Tarball 安装（适合内网/断网环境）

# 下载或拷贝 rooode-dsh-plugin-quickbar-*.tgz 后执行：
npx @deepseek-ai/dsh plugin --profile web add ./rooode-dsh-plugin-quickbar-0.1.2.tgz

---

⚙️ 配置项说明 (Configuration)

可在 cordis.patch.yml 中自定义配置以下参数：

- insert:
    - id: ui-quickbar
      name: '@rooode/dsh-plugin-quickbar'
      config:
        allowCustomIcons: true
        # storageFilePath: '~/.dsh/storages/quickbar.json'

配置参数列表

配置项	类型	默认值	说明
allowCustomIcons	boolean	true	是否允许为快捷项自定义 Emoji 或图标
storageFilePath	string	~/.dsh/storages/quickbar.json	自定义持久化数据文件存储路径

---

📁 项目结构 (Directory Structure)

dsh-plugin-quickbar/
├── package.json              # 插件元信息、dsh.bundle/client 声明与 npm scripts
├── cordis.patch.yml          # DSH 组合包 patch 描述文件
├── tsconfig.json             # TypeScript 严格编译与类型输出配置
├── README.md                 # 插件技术说明与安装文档
├── src/
│   ├── types.ts              # 快捷项数据结构与配置类型定义
│   ├── service.ts            # Node 端 QuickBarService (持久化存取与 REST API)
│   ├── index.ts              # Node 端入口：服务初始化与 Schema 校验
│   └── client.js             # 前端 React 快捷栏组件、Dock 插槽挂载与触发器
├── lib/
│   ├── index.js              # ESM 导出产物
│   ├── index.d.ts            # 类型定义声明
│   └── client.js             # Web 客户端 ModuleLoader Bundle
└── scripts/
    └── build.js              # 编译与本地分发脚本

---

🛠️ 本地开发与二次构建 (Development)

在本项目根目录下执行：

# 1. 编译并将最新产物同步至本地 DSH 运行环境
npm run build

# 2. 执行 TypeScript 类型检查
npm run typecheck

# 3. 打包生成离线分发 tarball 压缩包
npm pack

---

📄 开源许可证 (License)

MIT License © 2026 rooode