oneinitAI/dsh-thunderforge

⚡ ThunderForge · 宇宙无敌雷霆霹雳炫光

励志做

0 元以内最 nb 的 DSH 插件\*

注*：「0 元以内最 nb 的 DSH 插件」为产品目标，非质量承诺，亦不暗示"已 nb""正在 nb"或"即将 nb"。"0 元以内"指本插件定价区间，不代表 0.01 元档位存在竞品。解释权归雷雨天气。

一站式 DeepSeek Harness (DSH) 插件开发套件 · 单一 Bundle

中文 · English

CI
Tests
License: MIT
Node
dsh
npm

创建 → 开发 → 调试 → 环境验证 → 发布，dsh plugin add 一次，锻造炉全开 ⚡

梦想还是要有的，万一雷霆劈中你了呢

🔥 五大锻造引擎

| 引擎 | 形态 | 一句话 |
|---|---|---|
| ⚡ thunderforge-capture | 插件 | LLM 载荷捕获：透明代理 + 密钥掩码 + 轮转 + index.jsonl 索引流（清洁室自研） |
| 🧠 thunderforge-skills | 技能 ×4 | 四层知识库：入口索引 + 架构标准 + 坑点手册 + 画像自适应表达（实时评估用户水平，动态匹配回答深度） |
| 🔨 thunderforge-scaffold | 模型工具 | 对话式脚手架：三类零依赖模板，生成即冒烟 |
| 🔍 thunderforge-debugger | 模型工具 | 双数据源轨迹瀑布：会话日志 × capture 载荷按毫秒对齐 |
| 🧰 thunderforge-profile | 模型工具 | profile 管理 + 一键 dev preset（只新建、绝不碰既有环境） |

🗣️ dsh-buddy 画像自适应表达（独立项目 oneinitAI/dsh-buddy）：agent 从对话中被动观察，实时构建用户画像——熟练度、偏好、领域差异（十年后端也可能是 DSH 一年级）、当前状态——并按画像现场生成合适深度的回答；画像每轮更新，用户开始说术语就立刻升级表达。没有预设话术、没有术语对照表；拿不准时宁可略高估。轻梗每会话至多一句（first day to vibecoding: who is JSON?）。

🚀 安装

从 npm（推荐）
dsh plugin --profile  add dsh-thunderforge
或从 GitHub
dsh plugin --profile  add github:oneinitAI/dsh-thunderforge
或本地目录（开发者）
dsh plugin --profile  add /path/to/dsh-thunderforge

装完重启对应应用（profile 在启动时组合；web 即重启 dsh web），然后验证：

dsh --profile  --dump-config    # 应出现 "# == dsh-thunderforge" 层

移除随时可逆：dsh plugin --profile  remove dsh-thunderforge

⚠️ 层序提示（capture 生效的关键）：装进已有 profile 后，请把 dsh-thunderforge 挪到该 profile package.json 的 dsh.profile.bundles 数组最前（先于 @deepseek-ai/dsh-base）——capture 靠包装适配器注册工作，晚于 base 内适配器行应用就会静默落空。经 thunderforge_profile 生成的 dev preset 已自动排好。

装好之后，对你的 agent 说：

帮我建一个带 webui 的 DSH 插件 —— 它会调用 thunderforge_scaffold，骨架自带调试埋点与冒烟测试，生成即验证。

一键干净开发环境（被测插件装进隔离 profile）：

你: 帮我生成一个 dev preset，短名 demo
AI: (thunderforge_profile) → tf-dev-demo 已就绪
dsh plugin --profile tf-dev-demo add  && dsh --profile tf-dev-demo

🛠️ 锻造之旅

创建 ────► 开发 ────► 调试 ───────► 环境验证 ────► 发布
脚手架   技能     捕获 +      开发预设      CI 模板随
生成即     三层知识    调试器        干净 profile     骨架产出
冒烟 ✅    按需加载    双源瀑布 ⚡    只新建不动旧 ✅

- 每步产物是下一步的输入：骨架的 thunderforge.debug.json 埋点声明 capture 索引流与事件前缀，debugger 直接消费
- 真机验收：dsh 0.1.1-rc.2 CLI plugin add + --dump-config 五行全部加载 ✅（含一个被真机抓住并修复的 patch 格式 bug）
- 上手示例：examples/ 内含真实由 scaffold 生成的最小插件骨架

📦 状态

- ✅ node --test 31/31（含真机契约测试）；三模板生成即冒烟
- ✅ 真机验收：dsh plugin add + --dump-config 全行加载（含对真实 boot 报错的修复，见 CHANGELOG）
- 🙋 live 端到端（对话 → 工具调用 → capture 落盘 → 瀑布对齐）欢迎你亲手试：dsh --profile  "调用 thunderforge_scaffold ..."

📚 文档索引

| 文档 | 内容 |
|---|---|
| HANDOFF | 交接文档：项目全貌、架构约束、发布流程、遗留任务（接手人先读） |
| DEVELOPMENT | 开发文档：架构决策 + 代码地图 + 测试哲学 + 技能写作规范（贡献者深度阅读） |
| ROADMAP | 开发路线图：改进与拓展候选（P0 真机坑 / P1 闭环缺口 / P2 拓展） |
| PRD | 分阶段产品计划与验收记录 |
| RELEASE | 发布清单与一键发布 |
| NETWORK-NOTES | 网络问题手册（443 重置/TLS/大包/peer 警告） |
| CONFIGURATION | 配置指南：六引擎与 buddy 的全部配置键、覆盖方法、常见场景 |
| CHANGELOG | 版本变更记录（含真 bug 因果） |

🙏 致谢与上游协议（必读）

ThunderForge 站在社区巨人的肩膀上，尊重并严格遵守每一个上游仓库的开源协议：

| 上游项目 | 协议 | 在 ThunderForge 中的角色 |
|---|---|---|
| deepseek-harness | MIT | 运行底座与官方规范依据 |
| dsh-plugin-dev-skills | MIT | 原样 vendor → skills/arch-standard/（含其协议原文） |
| dsh-plugin-guide | Apache-2.0 | 原样 vendor → skills/pitfalls/（协议与 NOTICE 原文保留） |
| dsh-replay | MIT | 原样 vendor → src/debugger/session-log.js（文件头标注来源） |
| dshp | MIT | 已吸收并入 → src/profile/store.js 等自有模块（MIT 归属保留于文件头与台账） |
| dsh-trajectory-debug | MIT | 概念参考（未 vendor 代码），台账已记 |

- 全部 vendor 文件未修改实现，仅前置来源声明头；各上游许可证原文随包分发（见 LICENSES/）
- Apache-2.0 组件按其协议要求文件级保留原协议与 NOTICE
- 生态中存在一个无许可证的同类捕获组件，ThunderForge 明确不予引入，其功能为清洁室自研——未使用、未参考其任何代码

📄 许可证

MIT © 2026 ThunderForge Contributors

本项目按"原样"提供；对上游组件的权利主张始终以各上游协议原文为准。完整台账见 LICENSES/README.md。