starsinc1708/dsh-presentation

DeepSeek Harness × Claude：插件与演讲

为 DeepSeek Harness（dsh）0.1.5-rc.2 编写的八个插件，以及为它们所写演讲的演示文稿——AI Club 第 4 期，萨马拉，2026 年 9 月 16 日。

这些插件展示了 harness 可以向各个方向扩展：为模型添加工具、自定义命令、会话窗口中的整个标签页、系统提示词片段以及多智能体场景。每一个都是可用的，而非演示性的：它们是为日常工作而编写的。

什么放在哪里

| 路径 | 那里有什么 |
|---|---|
| examples/ | 八个插件，每个都有自己的 README |
| slides/index.html | 演讲的演示文稿，可直接从磁盘打开 |
| setup/ | 安装脚本和配置文件示例 |

插件

| 文件夹 | 作用 | 出现位置 |
|---|---|---|
| dsh-prompt-studio | 按片段显示组装好的系统提示词：自定义片段、替换、禁用 | Prompt 标签页、/prompt、设置 |
| dsh-git-panel | 无需终端的 git：状态、差异、索引、由模型生成的提交信息、分支、stash、同步 | Git 标签页、/git、/commit |
| dsh-sdd-bmad | 以 BMAD 风格进行规范驱动开发：角色、四个阶段、以文件形式保存的文档和故事 | SDD 标签页、/sdd、工具 |
| dsh-plan-studio | 由两个模型制定计划：DeepSeek 侦察和检查，Claude Code 编写和修改 | 工具、Plan 标签页、输入框上方的栏 |
| dsh-tool-tandem | 将想法落地为代码：Claude 规划并检查每一步，全新的 DeepSeek 智能体负责实现 | 工具 tandem 和 ask_claude |
| dsh-house-rules | 用一个系统提示词片段承载团队规则，可在配置中更改而无需重启 | 提示词片段 |
| dsh-cmd-ticket | /ticket  —— 任务链接和标题，无需访问模型 | 命令 |
| dsh-hide-width-handle | 移除聊天栏两侧的宽度调节手柄，它们在插件标签页上会造成干扰 | 浏览器中的一条样式规则 |

每个插件的内部原理分析见演示文稿附录，第 18–24 页。

需要提前准备什么

- Node.js 22 或更高版本及 npm。已在 Node 24.19 和 npm 11.17 上验证。
- pnpm 11：npm i -g pnpm。dsh 通过它将插件安装到配置文件中。
- DeepSeek Harness 0.1.5-rc.2：npm i -g @deepseek-ai/dsh@0.1.5-rc.2。建议锁定版本：dsh 会在不同发布版本之间更改插件 API。
- 模型密钥（用于 dsh），例如 DeepSeek：在模型设置中或通过 DEEPSEEK_API_KEY 环境变量设置。
- git —— 用于 Git 标签页。
- Claude Code 2.1.251 或更高版本，并已完成 claude login —— 仅用于 Plan Studio 和 tandem。通过订阅运行，无需 API 密钥。
- Chrome 或 Edge —— 用于 dsh web 和演示文稿。

一切均在 Windows 11 上验证；在 macOS 和 Linux 上步骤相同。
安装

git clone https://github.com/starsinc1708/dsh-presentation.git
cd dsh-presentation
powershell -ExecutionPolicy Bypass -File setup\install.ps1

bash setup/install.sh            # macOS、Linux、Git Bash
bash setup/install.sh tui        # 另一个 dsh 配置文件

该脚本通过一次 npm install 和 npm run build --workspaces 构建全部八个插件，然后用一条命令将它们添加到 dsh 配置文件中。手动操作也是一样：

cd examples
npm install && npm run build --workspaces
dsh plugin --profile web add file:/examples/dsh-house-rules …

file: 后面的路径必须是完整路径。dsh 安装的是插件文件夹的副本，因此每次重新构建后都要重复执行 add 命令并重启 dsh web。

配置

配置位于 ~/.dsh/profiles//cordis.patch.yml —— 这是一个 YAML 列表，条目形如 - id: 。包含所有字段的示例：setup/cordis.patch.example.yml。dsh 会实时读取该文件的修改。

| 插件 | 需要设置什么 |
|---|---|
| Plan Studio、tandem | 如果 PATH 中的 claude --version 低于 2.1.251，则设置 command。在 Windows 上请指定 claude.exe 的路径，而不是 claude.cmd：dsh 启动程序时不经过 shell |
| /ticket | 跟踪器的 baseUrl 和 tickets 列表 |
| House rules | rules 文本 |

密钥和路径只保存在此文件中，不要放在插件文件夹里。

启动

dsh web                           # 启动服务器并打开浏览器
dsh web --no-open --port 8777     # 固定端口，不打开浏览器

界面只能通过带有 ?token=… 的地址打开；每次启动时令牌都是新的。Prompt 和 SDD 选项卡会在会话中的第一条消息之后激活 —— 在此之前会话中没有活跃的代理。

插件路由只监听回环接口，并且对来自其他 Origin 的请求、非 JSON 的 POST 以及其他 Host 返回 403。

演示文稿

在 Chrome 或 Edge 中打开 slides/index.html —— 不需要服务器，字体和截图就在旁边。幻灯片 1–17 是报告本身，18–24 是插件指南附录。

| 按键 | 功能 |
|---|---|
| P | 开始放映 |
| → ← 空格 | 翻页 |
| N | 演讲者备注 |
| R | 重放幻灯片动画 |
| F | 全屏 |
| T | 浅色或深色主题 |
| Esc | 退出放映 |

这里没有什么

- Redmine 插件。 它在报告中是第六个示例，但依赖于公司的内部跟踪器，因此不包含在仓库中。出于同样的原因，演示文稿中 Board 选项卡的截图数据已被遮盖。
- Council —— 报告中的代理委员会 —— 位于单独的仓库：starsinc1708/dsh-tool-council。安装方式相同：dsh plugin --profile web add file:。
- 构建好的 lib/ —— 它们由 npm run build 生成，仓库中只存放源代码。

许可证

MIT —— 见 LICENSE。