DeepSeek Harness (DSH) 的核心设计理念是「一切皆插件」。对于开发者而言，从零构建一个插件涉及脚手架搭建、调试、环境验证等多个环节，流程较为碎片化。dsh-thunderforge 旨在将这些环节整合到一个单一 Bundle 中，提供一站式的开发支持。
核心能力¶
该插件包含五大核心模块：
- thunderforge-capture：负责 LLM 载荷捕获。通过透明代理、密钥掩码、密钥轮转以及
index.jsonl索引流，提供数据采集能力。 - thunderforge-skills：构建四层知识库，包括入口索引、架构标准、坑点手册以及画像自适应表达。
- thunderforge-scaffold：提供对话式脚手架功能。包含三类零依赖模板，生成的骨架自带冒烟测试，可直接验证。
- thunderforge-debugger：实现双数据源轨迹瀑布。将会话日志与 capture 载荷按毫秒级对齐，便于调试。
- thunderforge-profile：提供 profile 管理与一键 dev preset 功能。该功能只新建环境，绝不触碰既有配置。
安装与启用¶
通过官方 CLI 进行安装：
dsh plugin --profile <profile名> add dsh-thunderforge
安装完成后，需要重启对应的应用（profile 在启动时组合；如果是 Web 界面，需重启 dsh web）以使插件生效。可以通过以下命令验证是否加载成功：
dsh --profile <profile名> --dump-config
若需移除，可随时执行：
dsh plugin --profile <profile名> remove dsh-thunderforge
典型用法¶
使用 dsh-thunderforge 可以串联起完整的开发与调试流程：创建 → 开发 → 调试 → 环境验证 → 发布。
- 生成脚手架：通过对话式工具调用
thunderforge_scaffold，即可获得带有调试埋点与冒烟测试的插件骨架。 - 一键开发环境：生成一个 dev preset，将待测插件安装进该隔离 profile 中，保证开发环境纯净。
示例对话指令：
dsh --profile <你的profile> 调用 thunderforge_scaffold ...
生成开发预设示例：
# 对话指令
帮我生成一个 dev preset，短名 demo
注意事项¶
- 层序提示：若将
dsh-thunderforge装入已有的 profile，请务必将其放在该 profile 的package.json文件中dsh.profile.bundles数组的最前面（优先级高于@deepseek-ai/dsh-base）。这是capture模块生效的关键。 - 上游协议：插件集成了多个上游组件（如
dsh-plugin-dev-skills、dsh-plugin-guide等）。对上游组件的权利主张始终以各上游协议原文为准。特别是 Apache-2.0 组件，按协议要求需在文件级保留原协议与 NOTICE。
总结¶
dsh-thunderforge 提供了一套完整的 DSH 插件开发工具链，通过统一的 Bundle 解决了开发、调试与验证的割裂问题。适合需要快速构建、调试和验证 DeepSeek Harness 插件的开发者。
