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 或在配置中修改，否則默認完整輸出、絕不截斷。