前言¶

在 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 卡组

前言¶

这是什么¶

核心功能¶

查卡¶

构建¶

排行¶

卡组检查¶

依赖与运行环境¶

安装与启用¶

典型用法¶

适用场景与注意¶

结尾¶

精选优惠券

相关文章