Besson-Tools
Health Warn
- No license — Repository has no license file
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 6 GitHub stars
Code Warn
- network request — Outbound network request in dsh-plugin/besson-tools.mjs
- process.env — Environment variable access in mcp/mcp-server.mjs
- network request — Outbound network request in mcp/mcp-server.mjs
Permissions Pass
- Permissions — No dangerous permissions requested
No AI report is available for this listing yet.
北山Besson 教程 skill·mcp·plugin 三件套(7 工具 lookup/index/series/fetch/plan/compare/env)· v2.2.0 · 站点 217 篇索引(2026-11-07)· 适配 DSH 0.2.2-rc.1 · CC BY-NC-SA 4.0 · 插件仓库 QZyme/dsh-besson-tools
北山Besson 教程检索 · skill · mcp · plugin
北山Besson(BeiShan_Besson)Minecraft 模组开发教程站 Tomorrow-Land 的检索体系:
DSH 技能(skill)· MCP 服务器(mcp)· DSH 插件(plugin) 三件套(v2.3.0,适配 DeepSeek Harness 0.2.2-rc.1+)
数据同步日期:2026-11-07(站点文章 217 篇全覆盖:章节 212 + 独立文章 4 + 总汇页 1)
站点:https://beishanair.github.io/ · 作者 B站:@北山Besson · GitHub:BeiShanair
目录结构
Besson-Tools/
├── README.md # 本文件
├── LICENSE # CC BY-NC-SA 4.0
├── skill/ # ① DSH 技能(SKILL 技能文件,也可作为其他工具的知识库)
│ ├── SKILL.md # 技能主文件:快速路由 + 环境矩阵 + 迁移指南 + 坑点 + FAQ + 217 篇索引
│ └── references/
│ └── version-matrix.md # 版本矩阵(JDK/Loader/构建系统,官方源核实)
├── mcp/ # ② MCP 服务器(任何支持 MCP 的客户端都能用)
│ ├── mcp-server.mjs # stdio(默认)或 HTTP(--http)双模式,9 个工具
│ ├── test-client.mjs # stdio 端到端测试
│ ├── test-http.mjs # HTTP 冒烟测试
│ └── package.json # 依赖清单(Release 的 mcp 包已自带)
├── dsh-plugin/ # ③ DeepSeek Harness(DSH)插件
│ ├── besson-tools.mjs # 插件本体(零依赖,注册 9 个工具,v2.3.0)
│ ├── preset-files/ # 整预设安装时需要的文件
│ │ └── preset.yml # 预设元数据(名称/描述)
│ └── agent.cordis.yml.snippet # 往现有预设追加插件行时复制此片段
├── client.js # ④ Web UI 左栏入口面板(bundle 客户端模块,v2.3.0 新增)
└── tools/
├── index_data.json # 教程索引数据(脚本与 MCP 服务器共用)
├── sync-data.mjs # 站点数据更新脚本(重新生成 index_data.json / besson-tools.mjs)
├── epic_skill.js # 技能史诗化脚本(把增强章节注入 SKILL.md,保留 217 条链接)
└── plugin-test.mjs # 插件全工具冒烟测试(模拟 DSH registry)
① 作为 DSH 技能使用(skill)
适用 DSH 0.2.2-rc.1+(技能发现根:用户级
~/.dsh/skills/、项目级<workspace>/.dsh/skills/)
# 把 skill/ 安装到用户级技能目录(推荐,DSH 会自动发现)
cp -r skill ~/.dsh/skills/besson-tutorials
# 或安装到某个预设/项目目录:
# cp -r skill <workspace>/.dsh/skills/besson-tutorials
v2.3.0 技能内容(史诗级):
- 快速路由:按「入门/1.21.1/最新版/专题/迁移」直接给出路线与章节锚点
- 版本环境矩阵:MC 版本 × Loader × JDK × 构建插件 × mod 清单 × 注册/事件方式
- 迁移指南:Forge→NeoForge、1.20.1→1.21.1、1.21.1→26.1 的包名/清单/构建/注册差异
- 标准工作流 + 高频坑点 Top 10 + 生态速查 + FAQ + 9 工具用法
- 保留完整 217 篇文章索引(A-F 六系列 + 4 篇独立文章 + 总汇页)
使用效果:加载后直接掌握教程站全部 217 篇文章的索引,能按"版本 + 主题"给出教程链接、
按目标生成学习路线、对比不同版本工程差异、生成环境搭建清单,并抓取文章正文。
② 作为 MCP 服务器使用(mcp)
cd mcp
node mcp-server.mjs # stdio 模式(默认;Release 的 besson-mcp 包已自带依赖,解压即用)
node mcp-server.mjs --http # HTTP 模式(环境变量 PORT,默认 3987)
MCP 服务器提供 9 个工具:
| 工具 | 作用 | 示例参数 |
|---|---|---|
besson_tutorial_lookup |
关键词检索章节 | query: "NeoForge 生物群系", limit: 8 |
besson_tutorial_index |
系列总览 + 生态现状 + 数据健康 | 无参数 |
besson_tutorial_series |
单系列全部章节 / 单章详情 | series: "D" 或 series: "D", chapter: "44" |
besson_tutorial_fetch |
抓取正文(可按关键词自动解析) | query: "流体" 或 url: "…/nf121/33fluid/",maxChars: 6000 |
besson_tutorial_plan |
按目标生成学习路线(新手/进阶/迁移/26.1) | goal: "NeoForge 进阶 网络包" |
besson_tutorial_compare |
两系列/版本工程与 API 差异对比 | a: "A", b: "D" |
besson_tutorial_env |
环境搭建清单与命令(JDK/Gradle/模板/坑) | mcVersion: "1.21.1", loader: "neoforge" |
besson_mod_project |
本地工程体检(加载器/版本/清单/主类/问题) | path: "C:/my-mod" |
besson_mod_migrate |
跨系列迁移清单(构建/清单/映射/注册/事件) | from: "A", to: "D" |
besson_tutorial_fetch 例:传 query 时按本地索引自动解析最匹配的一篇并抓取;传 url 时直接抓取该页。
返回标题、正文纯文本(含代码块)与字节数;仅接受 beishanair.github.io 站内 https 链接,可用 maxChars 限制返回长度。
客户端配置示例(stdio):
{
"mcpServers": {
"besson-tutorials": {
"command": "node",
"args": ["/path/to/Besson-Tools/mcp/mcp-server.mjs"],
"env": { "BESSON_DATA_PATH": "/path/to/Besson-Tools/tools/index_data.json" }
}
}
}
HTTP 模式接入地址:http://127.0.0.1:3987/mcp(Streamable HTTP,会话由 mcp-session-id 头管理)。
自带测试:node test-client.mjs(stdio 端到端)与 node test-http.mjs(HTTP 冒烟)。
③ 作为 DeepSeek Harness(DSH)插件使用(plugin)
v2.0.0 起同时支持 DSH 0.1.x(预设目录内
.agent-presets) 与 0.2.2-rc.1+ 的声明式预设(profile 内cordis.yml的 preset 行 + 本地包)。
方式 0:插件栏一键安装(推荐,DSH 0.2.1+)
插件已发布为独立 bundle 包仓库(插件栏可识别):https://github.com/QZyme/dsh-besson-tools
- DSH → 插件栏 → 「添加插件」
- 输入 GitHub 仓库地址:
https://github.com/QZyme/dsh-besson-tools
(或本仓库源码目录、或本包解压目录) - 安装后(bundle 形态)重启或新开会话即可使用 9 个
besson_*工具(7 个教程 + 2 个开发辅助),左上栏会出现「北山 Besson 模组助手」入口面板
注意:插件栏安装为全局挂载(所有会话可用)。若只想在 Besson 预设里使用,请用方式 B(预设行挂载);两种方式不要同时启用,避免重复注册。
方式 A:整预设安装(整套预设,开箱即用)
把 dsh-plugin/preset-files/preset.yml 与 dsh-plugin/besson-tools.mjs 放入:
~/.dsh/.agent-presets/<你的预设id>/
├── agent.cordis.yml # 在文件末尾追加 agent.cordis.yml.snippet 的内容
├── preset.yml # ← 来自本包 preset-files/
└── besson-tools.mjs # ← 来自本包
在 DSH Web 新建会话时选择该预设即可。
方式 B:0.2.1+ 声明式预设(本地包挂载)
- 新建本地包目录(如
~/dsh-besson-tools/或任意目录),放入:
package.json # name: dsh-besson-tools, version: 2.0.0, type: module, main: besson-tools.mjs
besson-tools.mjs # ← 来自本包 dsh-plugin/
- 在 DSH profile(
~/.dsh/profiles/<profile>/)的package.json依赖里声明本地包:
"dsh-besson-tools": "file:<本地包目录>"
然后在 DSH 中重新安装该 profile 的依赖(DSH 插件管理里会有提示)。
- 在 profile 的
cordis.yml中给预设加一行(示例,与 preset-besson 一致):
- id: besson-tools
name: dsh-besson-tools
- 重启 DSH,在会话预设中选择
besson。工具注册名会以besson_tutorial_*出现(0.2.1 的按会话隔离工具作用域)。
方式 C:只给现有预设加工具(0.1.x 旧式预设)
- 把
besson-tools.mjs复制到你的预设目录(与agent.cordis.yml同级) - 在
agent.cordis.yml末尾追加agent.cordis.yml.snippet中的内容 - 重启会话即可拥有 9 个工具(v2.3.0)
工具清单(插件与 MCP 完全一致,9 个)
| 工具 | 作用 |
|---|---|
besson_tutorial_lookup |
关键词检索章节(版本/Loader/章节号/主题) |
besson_tutorial_index |
六大系列总览 + 版本 + Java + 缺号 + 生态现状(数据健康) |
besson_tutorial_series |
单系列(A-F)全部章节列表 / 单章详情 |
besson_tutorial_fetch |
抓取教程正文(关键词自动解析或直接 url,仅限站内 https) |
besson_tutorial_plan |
按目标生成学习路线(新手/进阶/neoforge/forge/迁移/26.1) |
besson_tutorial_compare |
两系列/版本工程与 API 差异对比 |
besson_tutorial_env |
某 MC 版本 + Loader 的环境搭建清单与命令 |
besson_mod_project |
本地模组工程体检:加载器/版本/清单/主类/问题清单 |
besson_mod_migrate |
跨系列迁移清单:构建/清单/映射/注册/事件/数据生成 |
系列字母:A=Fabric 1.20.1(Java 17)、B=Fabric 1.21.X(Java 21)、C=Forge 1.20.1(Java 17)、
D=NeoForge 1.21.1(Java 21)、E=Fabric 26.1(Java 25)、F=NeoForge 26.1(待开)。
提示:
besson_tutorial_index返回version字段(当前 2.0.0)与dataHealth(正常totalChapters=190),可确认运行版本与数据完好。
数据维护(站点更新后)
node tools/sync-data.mjs # 从站点重新抓取 → 重新生成 index_data.json / besson-tools.mjs
node tools/epic_skill.js # 重新生成技能史诗章节(保留链接),同步日期从 index_data.json 读取
脚本会自动抓取站点归档页/标签页,重建完整索引并注入插件模块。技能文件 skill/SKILL.md
的 217 条链接表格保持不变,史诗章节由 epic_skill.js 注入。
故障排查(插件"检索不到内容/返回 0 条")
- 用仓库
dsh-plugin/besson-tools.mjs(或 Release 最新besson-plugin-v2.3.0.zip)
覆盖安装位置的文件:- 0.1.x 旧式预设:
~/.dsh/.agent-presets/<你的预设id>/besson-tools.mjs - 0.2.1+ 本地包:
<本地包目录>/besson-tools.mjs(profile 内dsh.profile.bundles/dependencies 安装的副本)
- 0.1.x 旧式预设:
- 重启 DSH(预设常驻挂载会缓存旧文件,必须重启才加载新文件)
- 新会话 → 调
besson_tutorial_index,看返回的dataHealth:totalChapters = 190且sampleTitle是正常中文 → 数据完好totalChapters = 0或sampleTitle乱码(如寮€鍙戠幆澧?)→ 安装时文件编码被破坏,覆盖上面的文件即可修复
- 再调
besson_tutorial_lookup(如query: "流体")→ 应命中 4 条
提示:
besson_tutorial_lookup返回含indexed字段(正常应为 194),可即时确认数据是否加载。
已知站点注意事项(内置在数据中)
- 站点「教程总汇」页部分章节列表滞后,以实际文章为准
- 章节编号存在空缺:Forge C 缺 #22~#27;NeoForge D 缺 #13~#24;Fabric B 无 #54
- D39「矿物的世界生成」站点标题误标 1.20.1,实为 1.21.1
- F 系列(NeoForge 26.1)站内尚未开更(Fabric 26.1 的 E 系列已开 30 篇:#1~#8、#22~#43)
- 最新版本:MC 26.2(26.1.1/26.1.2 已发);Fabric Loader 0.19.3;NeoForge 26.1 于 2026-03 适配
版本历史
- v2.3.0:新增「模组开发辅助」——
besson_mod_project(本地工程体检)+besson_mod_migrate(跨系列迁移清单),工具 7→9;Web 左栏入口面板(client.js,bundle 自带客户端模块);SKILL.md 去重(497 行)并新增「模组开发辅助」小节;预设描述精简;适配 DSH 0.2.2-rc.1 - v2.2.0:站点数据同步 2026-11-07(站点 217 篇)—— E 系列(Fabric 26.1)新增 #34~#43 共 10 章(流体/木头/树/世界生成/花/矿物/结构/生物群系/维度);版本号 2.2.0,适配 DSH 0.2.2-rc.1
- v2.1.0:站点数据同步 2026-10-29(站点 207 篇)—— E 系列(Fabric 26.1)新增 #22~#33 共 12 章;数据、版本号全面对齐
- v2.0.0:史诗级增强 —— 插件与 MCP 各 7 工具(新增 plan/compare/env);技能新增快速路由、环境矩阵、迁移指南、坑点 Top 10、FAQ、工具链;适配 DSH 0.2.1-rc.2(声明式预设 + 本地包挂载 + skill-filesystem 技能目录);数据同步 2026-10-19(195 篇)
- v1.1.1:版本号统一、数据同步 2026-10-03
- v1.1.0:MCP/插件新增
besson_tutorial_fetch正文抓取 - v1.0.0:首版(lookup/index/series)
许可
本包数据源自 Tomorrow-Land,遵循站点声明的
CC BY-NC-SA 4.0(署名-非商业性使用-相同方式共享),见 LICENSE。
转载/分发请保留来源署名。
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found