dsh-mcwiki-search

在 DeepSeek Harness (DSH) 生态中，直接对接维基数据常面临噪声问题：原始的 MediaWiki 返回结果包含大量模板、HTML 标签、引用和跨语言链接，难以直接投喂给模型。dsh-mcwiki-search 是一个联网工具插件，它通过 MediaWiki API 查询 Minecraft Wiki（中文/英文），并将搜索结果与页面全文清洗为干净的文本。

核心功能¶

该插件注册了三个模型工具，并配套一个 Web 设置页面。

模型工具¶

工具名	功能	返回内容
`mcwiki_search`	全文搜索	清洗后的标题、摘要（命中词加粗）、URL、更新时间
`mcwiki_get_page`	抓取页面	纯文本引言（默认）；或全文（Markdown/纯文本/Wikitext）。默认完整输出，不截断（除非显式传 `maxChars`）
`mcwiki_random`	随机条目	条目标题 + 引言纯文本（完整、不截断）

Web 设置页面¶

在 DSH 的 Web 界面中，进入「设置 → Minecraft Wiki 搜索」：

数据源状态：检测 API 连接是否正常。
配置管理：修改 API 端点、超时时间、搜索条数、全文/引言上限。配置直接写入 settings.yaml，修改即时生效。
测试功能：提供搜索测试和页面转换测试，直接预览转换后的文本。

安装¶

使用官方安装命令即可完成注册，无需手动修改配置文件。

dsh plugin --profile web add github:Yinxe/dsh-mcwiki-search
dsh web

安装完成后，重启 dsh web 服务。验证方式：在 Web 界面「设置」中看到「Minecraft Wiki 搜索」卡片，或直接对模型使用 mcwiki_search 工具。

使用示例¶

在对话中调用工具：

用 mcwiki_search 查一下「苦力怕」

或在终端中自测转换效果：

node lib/self-test.js
node lib/self-test.js 苦力怕
node lib/self-test.js "Ancient City" en

配置说明¶

插件的配置持久化在 settings.yaml 的 dshp-inx-mcwiki-search 命名空间下。默认配置为不截断输出（maxChars: 0），以确保 AI 获得完整信息。

- id: dshp-inx-mcwiki-search
  name: "@dshp-inx/mcwiki-search"
  config:
    apiBase: https://zh.minecraft.wiki/api.php
    timeoutMs: 15000
    maxChars: 0          # 全文输出上限：0 = 不截断
    introMaxChars: 0     # 引言上限：0 = 不截断
    searchMaxResults: 8  # 搜索默认条数

注意事项¶

数据来源：内容基于 zh.minecraft.wiki / minecraft.wiki，按 CC BY-NC-SA 3.0 授权。
无门槛：使用公开 MediaWiki API，无需申请密钥或配额。
文件保护：不要直接编辑 node_modules/@dshp-inx/mcwiki-search/ 下的文件。源码修改建议使用本地 Link 方式。
默认行为：除非显式设置 maxChars 或在配置中修改，否则默认完整输出、绝不截断。