DeepSeek Harness - 一键全功能增强套件 (@rooode/dsh-suite)

@rooode/dsh-suite 是 DeepSeek Harness (DSH) 的一键全功能聚合增强套件与多模态启动器。通过聚合 4 大生产级核心插件，为用户提供对齐 WorkBuddy 与 WebStorm 的完整交互体验。

无需繁琐地逐个安装插件，任何机器只需 一条 npx 命令，即可自动装配全套插件，支持直接运行 web 浏览器模式、cli 终端模式或 headless 无头后台模式！

---

🎁 套件包含的插件 (Bundled Plugins)

插件名称	说明	核心能力
@rooode/dsh-plugin-automation	自动化任务与调度中心	⚡ 24/7 Node.js 服务端常驻后台周期/定时调度、Headless 会话执行引擎、模型/模式选择器、全量审计历史
@rooode/dsh-plugin-git	WebStorm 风格 Git 提交插件	🌿 变更文件分层目录树、三态复选框、双栏 (Side-by-Side) 与单栏 (Unified) Diff 视窗、Conventional Commits 智能生成
@rooode/dsh-plugin-preview	代码与文档多标签预览插件	📝 参考 WorkBuddy FileTabs 的右侧抽屉、工作空间文件树、多语言代码高亮与符号大纲、JSON 交互树、GFM 渲染
@rooode/dsh-plugin-quickbar	对话输入框快捷指令栏	📌 常驻输入框正上方 Dock 栏、工作空间隔离绑定、自定义提示词创建/编辑、一键触发对话

---

🚀 快速使用 (Quick Start)

1. 启动 Web 界面 (默认模式)

支持直接运行，或传入参数自定义端口、主机及工作空间路径：

# 默认启动 Web 界面 (http://localhost:3080)
npx @rooode/dsh-suite

# 显式使用 web 子命令
npx @rooode/dsh-suite web

# 指定自定义端口与工作空间
npx @rooode/dsh-suite web --port 8080 --workspace C:/Users/user/Documents/wb

# 指定监听所有网卡并在启动后自动打开浏览器
npx @rooode/dsh-suite web --host 0.0.0.0 --port 3080 --open

---

2. 启动终端命令行模式 (CLI Mode)

除了 Web 模式外，亦可直接拉起具备全套套件能力的终端交互对话会话：

# 启动 CLI 对话模式
npx @rooode/dsh-suite cli

# 启动 Headless 后台模式
npx @rooode/dsh-suite headless

---

3. 固化安装到本地 Profile (可选)

如果您希望将套件永久固化安装到本地 DSH 的 web profile 中：

# 方式 A：使用套件内置一键安装指令
npx @rooode/dsh-suite install

# 方式 B：使用 DSH 官方 CLI 安装
npx @deepseek-ai/dsh plugin --profile web add @rooode/dsh-suite

# 安装后，后续启动常规 dsh web 均会自动携带全套插件：
npx @deepseek-ai/dsh web

---

4. 离线分发包安装（内网/断网环境）

# 下载或打包 rooode-dsh-suite-*.tgz 后执行：
npx @deepseek-ai/dsh plugin --profile web add ./rooode-dsh-suite-0.1.0.tgz

---

⚙️ 套件聚合配置 (Configuration)

本套件内置了各子插件的最佳实践默认配置。如需个性化自定义，可在项目的 cordis.patch.yml 中覆盖对应配置：

- insert:
    # 1. 对话快捷栏配置
    - id: ui-quickbar
      name: '@rooode/dsh-plugin-quickbar'
      config:
        allowCustomIcons: true

    # 2. 自动化调度配置
    - id: ui-automation
      name: '@rooode/dsh-plugin-automation'
      config:
        defaultPollingIntervalMs: 5000
        maxStoredRecords: 100

    # 3. 预览面板配置
    - id: ui-preview
      name: '@rooode/dsh-plugin-preview'
      config:
        defaultViewMode: 'preview'
        defaultPanelWidth: 560
        maxFileSizeMb: 10

    # 4. Git 提交配置
    - id: ui-git
      name: '@rooode/dsh-plugin-git'
      config:
        enableCommitDockButton: true
        autoRefreshIntervalMs: 10000
        defaultDiffViewMode: 'split'
        commitAiStyle: 'conventional'

---

📁 项目结构 (Directory Structure)

dsh-suite/
├── package.json              # 套件元信息、bin 可执行命令与 dependencies 依赖声明
├── cordis.patch.yml          # DSH 组合包聚合 patch 描述文件
├── README.md                 # 套件使用与快速启动文档
├── bin/
│   └── cli.js                # 多模态启动器 (支持 web / cli / headless / install)
├── lib/
│   ├── index.js              # Bundle 模块导出入口
│   └── index.d.ts            # 类型声明
├── src/
│   └── index.ts              # 组合包源码入口
└── scripts/
    └── build.js              # 编译与本地 Profile 自动同步脚本

---

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

# 1. 构建套件并同步至本地 DSH 运行环境
npm run build

# 2. 本地调试启动
npm run dev

# 3. 打包生成离线 tarball 压缩包
npm run package

---

📄 开源许可证 (License)

MIT License © 2026 rooode