北山模组教程 QZyme/dsh-besson-tools

dsh-besson-tools

北山Besson（BeiShan_Besson）Minecraft 模组开发教程的 DSH 插件：7 个独立组件（每个工具一个组件），覆盖「检索 → 路线规划 → 版本迁移对比 → 环境搭建 → 正文抓取」全流程。

- 教程站：https://beishanair.github.io/
- 主仓库（Skill + MCP + 插件三件套）：https://github.com/QZyme/Besson-Tools
- 数据：站点 207 篇（2026-10-29 同步），202 章节 + 4 独立文章 + 1 教程总汇页

安装（两种方式任选）

方式 1 · DSH 插件栏（推荐）：打开 DSH → 插件栏 → 「添加插件」→ 输入 GitHub 仓库地址

https://github.com/QZyme/dsh-besson-tools

或本仓库源码目录（下载解压后选择该目录即可）。

安装后插件页会显示 7 个组件（besson-tutorial-lookup … besson-tutorial-env，每工具一行），所有会话可用 7 个 besson_tutorial_* 工具。

支持的 DSH 版本：0.2.1-rc.2 及以上（0.2.1 桌面版已实测：GitHub 仓库地址安装、7 组件加载、工具功能全部通过）。

方式 2 · 预设内挂载（只在 Besson 预设里用）：把仓库放进 .dsh 下任意目录，在预设插件列表加 7 行（与 cordis.patch.yml 相同）：

- id: besson-tutorial-lookup
name: dsh-besson-tools/lookup
- id: besson-tutorial-index
name: dsh-besson-tools/index
- id: besson-tutorial-series
name: dsh-besson-tools/series
- id: besson-tutorial-fetch
name: dsh-besson-tools/fetch
- id: besson-tutorial-plan
name: dsh-besson-tools/plan
- id: besson-tutorial-compare
name: dsh-besson-tools/compare
- id: besson-tutorial-env
name: dsh-besson-tools/env

组件与工具

bundle 补丁共 7 个组件（每个工具单独一个组件，互不依赖）：

| 组件 id | 模块 | 工具 | 作用 |
| besson-tutorial-lookup | dsh-besson-tools/lookup | besson_tutorial_lookup | 关键词检索章节（系列/版本/章节号/主题词，limit 1-25） |
| besson-tutorial-index | dsh-besson-tools/index | besson_tutorial_index | 六大系列总览：MC 版本、Java、章节数、缺号、数据健康 |
| besson-tutorial-series | dsh-besson-tools/series | besson_tutorial_series | 列某系列全部章节，或取单章详情（chapter 参数） |
| besson-tutorial-fetch | dsh-besson-tools/fetch | besson_tutorial_fetch | 抓取一篇教程正文（url 或 query 自动解析；仅站内 https） |
| besson-tutorial-plan | dsh-besson-tools/plan | besson_tutorial_plan | 按目标生成学习路线（新手/进阶/neoforge/forge/迁移/26.1） |
| besson-tutorial-compare | dsh-besson-tools/compare | besson_tutorial_compare | 两系列/版本工程与 API 差异对比（11 项） |
| besson-tutorial-env | dsh-besson-tools/env | besson_tutorial_env | 环境搭建清单（JDK/Gradle/模板仓库/命令/坑点） |

兼容说明：lib/index.js（包主入口）仍是「7 个工具一起注册」的单文件版，供旧式「一行挂载」或直接 import 使用；bundle 安装走的是上面的 7 组件。

系列总览

| 系列 | MC | Loader | Java | 章节 |
| A | 1.20.1 | Fabric | 17 | 55 |
| B | 1.21.X | Fabric | 21 | 57 |
| C | 1.20.1 | Forge | 17 | 38 |
| D | 1.21.1 | NeoForge | 21 | 32 |
| E | 26.1 | Fabric | 25 | 20 |
| F | 26.1 | NeoForge | 25 | 待开更 |

版本与许可

- v2.1.0：数据同步 2026-10-29（207 篇）
- v2.0.0：7 工具、bundle 形态、适配 DSH 0.2.1-rc.2（2026-10-19）；组件按工具拆分为 7 个独立组件（安装后插件页显示 7 个组件）
- 许可：CC BY-NC-SA 4.0（教程内容与索引数据来自 BeiShan_Besson；代码同样按该协议提供）