前言¶

在 DeepSeek Harness（DSH）裏做智能體或日常開發時，側邊欄和本地 HTTP 服務往往已經夠用，但遊戲王 Master Duel 的查卡、組卡、概率與禁卡表仍要切到外部工具或零散網頁。社區插件 dsh-masterduel（維護者 LOESS16，分類：客戶端）把一塊自包含面板掛進 DSH：查卡、AI 輔助效果檢索、關聯卡、帶收藏與拖放的卡組構建、排行與卡組檢查，數據與推理能力由 master-duel-ai-advisor MCP 服務提供。與「只在瀏覽器裏打開第三方卡組站」相比，面板與 DSH 同進程暴露路由，並在客戶端入口與 /dsh-masterduel/panel 打開同一界面。

這是什麼¶

dsh-masterduel 是 DSH 的 host 插件：在本地提供 /dsh-masterduel/panel 及一組 REST API，內部通過 stdio JSON-RPC 代理 MCP 工具。客戶端腳本註冊在 DSH 側邊欄（設置裏可見「遊戲王 MD」入口），無需單獨前端構建步驟。當前 package 版本爲 0.3.0，許可證 MIT，Node 要求 >=22.13，DSH Desktop 0.2.x。

核心功能¶

面板分爲四個標籤頁，能力均來自項目 README 說明。

查卡¶

支持卡名、密碼、效果檢索；屬性、種族、等級、攻防、稀有度、禁卡表等篩選；網格或列表、排序與搜索歷史；近期卡縮略圖。關聯卡可按文本提及、同卡組、別名等模式一鍵加入卡組。卡圖支持 YGOPRODeck、Master Duel 中文版或 Master Duel Meta 異畫，自動回退與重試。AI 智能查卡支持高亮查詢/加載、中止、對部分查詢做本地卡文校驗重排，以及結果快照命名。

構建¶

主卡組 / 額外 / 副卡組三列構建器，帶卡組統計、類型點、等級與攻防標記、單卡收藏。收藏面板可摺疊，拖入卡組；主 extra side 之間拖放（每次拖放一張）。可按真實卡組收錄率智能補全。先手實測通過 EDOPro 引擎（5 張起手，3/5/10 手或指定手牌，按價值排序與自動 tier）。先後手起手概率由 hand_odds 精確計算（可編輯自動規則）。可對樣本做 AI 復盤；支持導出/導入/差異對比/雙存檔對比、撤銷，以及 YDK / YDKE 導出。

排行¶

卡組類型排行（強度 / 大賽 / 天梯），按發售日排序的系列；真實卡組分解與主 extra 篩選，可點進具體卡組。

卡組檢查¶

YDK / YDKE / 卡表檢查，統計卡片、完整卡表、帶百分比的分佈、禁卡表日期、報告導出；支持 ?tab=deck&deck=… 深鏈。

界面默認中文，頁頭可切英文（beta）；語言寫入 settings.json 的 lang 字段。

依賴與運行環境¶

MCP 腳本默認位於 ~/.dsh/mcp/master-duel-ai-advisor 的 dist/mcp.mjs，或通過環境變量 DSH_MASTERDUEL_MCP 指定其它路徑。
Node 由 DSH resources 目錄發現；必要時用 DSH_MASTERDUEL_NODE 覆蓋。
首次聯網運行：MCP 會下載約 30 MB 卡表數據（路線規劃模塊暫未用於本面板，另需約 60 MB）。
若本機經本地代理上網，DSH host 進程需 NODE_USE_ENV_PROXY=1 以及 HTTPS_PROXY / HTTP_PROXY。
找不到 MCP 或 Node 時，面板頂部紅條提示路徑並提供複製按鈕。

GitHub 不可用時，可使用發行包 dsh-masterduel-0.3.0.zip（旁附 SHA256.txt），按包內 INSTALL.md 安裝。

安裝與啓用¶

插件以當前 DSH 進程權限運行；安裝前請自行閱讀倉庫源碼與 MIT 許可證。官方 README 給出的是手動安裝（無構建步驟），而非 dsh plugin add github:… 形式的命令。

方式一：複製到 desktop profile 的 node_modules

Copy-Item -Recurse .\dsh-masterduel "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\dsh-masterduel"

在 ~/.dsh/profiles/desktop/cordis.patch.yml 中插入條目（操作前建議備份；desktop profile 由 Electron 應用管理）：

- insert:
    - id: dsh-masterduel
      name: 'dsh-masterduel'

完全重啓 DSH 後，打開 設置 → 遊戲王 MD，或在瀏覽器訪問：

http://127.0.0.1:<當前端口>/dsh-masterduel/panel

端口以 DSH 運行時上下文裏顯示的 GUI URL 爲準。

方式二：profile 非 Electron 管理時

dsh plugin --profile desktop add <absolute path to this directory>

將 <absolute path to this directory> 換成本地解壓後的插件目錄絕對路徑。

典型用法¶

健康檢查：確認 MCP 與路由正常。

GET /dsh-masterduel/api/health

返回形如 { ok, script, error? }。

按關鍵詞查卡：

GET /dsh-masterduel/api/lookup?q=<卡名或密碼>

帶篩選的搜索（面板默認展示約 60 條，可「顯示更多」至 limit ≤ 200）：

GET /dsh-masterduel/api/search?q=<關鍵詞>&limit=60

自然語言效果檢索：

GET /dsh-masterduel/api/semantic?q=<效果描述>

AI 查卡（兩次 LLM 調用，消耗 token）：

POST /dsh-masterduel/api/ai-search
Content-Type: application/json

{"q": "<自然語言問題>"}

提交卡組做統計與禁卡檢查：

POST /dsh-masterduel/api/deck-graph
Content-Type: application/json

{"deck": "<YDK/YDKE 或插件接受的 deck 結構>"}

先後手起手概率：

POST /dsh-masterduel/api/hand-odds
Content-Type: application/json

{"deck": { ... }, "rules": []}

rules 爲空時可從主卡組文本自動生成起手規則；也可用 POST /dsh-masterduel/api/generate-hand-rules 由模型生成規則（消耗 token，並校驗卡名在卡組內）。

日常操作建議：在側邊欄打開面板，在「查卡」完成檢索與關聯卡加入，在「構建」拖放組卡並導出 YDK/YDKE，在「卡組檢查」粘貼表列或使用深鏈 ?tab=deck&deck=… 分享檢查視圖。

適用場景與注意¶

適合：已在用 DSH Desktop、需要在本機一站式查 MD 卡表、組卡、看排行與禁卡表，並願意部署 master-duel-ai-advisor MCP 的用戶。
不適合：無法聯網完成首次卡表下載、或無法提供 Node 22.13+ 與 MCP 路徑的環境。
安全：插件與 MCP 子進程以 DSH 同一用戶權限運行；AI 相關接口會調用配置的 LLM 並消耗 token。代理與路徑類敏感配置通過環境變量注入，勿在未審閱源碼的情況下在生產賬號上盲目安裝。
生態：DSH 社區插件目錄（如 SkillHub 上的條目頁）爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；星標與目錄元數據以各站點爲準（GitHub 上該倉庫當前星標爲 0）。

結尾¶

dsh-masterduel 把 Master Duel 查卡、構建、排行與卡組檢查收進 DSH 的一塊麪板，並用 MCP 統一卡數據與部分 AI 能力。進一步瞭解可查看目錄頁與源碼倉庫：

目錄頁：https://www.skillhub.cn/plugins/LOESS16/dsh-masterduel
GitHub：https://github.com/LOESS16/dsh-masterduel

dsh-masterduel：在 DSH 裏查卡、組卡與檢查 Master Duel 卡組

前言¶

這是什麼¶

核心功能¶

查卡¶

構建¶

排行¶

卡組檢查¶

依賴與運行環境¶

安裝與啓用¶

典型用法¶

適用場景與注意¶

結尾¶

精选优惠券

dsh-masterduel：在 DSH 裏查卡、組卡與檢查 Master Duel 卡組

前言¶

這是什麼¶

核心功能¶

查卡¶

構建¶

排行¶

卡組檢查¶

依賴與運行環境¶

安裝與啓用¶

典型用法¶

適用場景與注意¶

結尾¶

精选优惠券

相關文章