dsh-gomoku 使用指南

在 DSH 对话面板里与任意已配置模型对弈 15×15 五子棋，支持人机、双 AI、暂停手动接管，并可分别编辑黑白双方提示词。

本文为派生内容（基于 wiki / faq / compatibility_json 自动组装），非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

— 源: plugin_wiki.wiki_content

dsh plugin --profile web add @yejiming/dsh-gomoku

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

人机与双 AI 对弈：支持执黑、执白、双 AI 对弈三种模式，15×15 无禁手规则（双三、双四、长连均合法，连成五子及以上即胜）。对弈模式与新开局按钮位于棋盘下方。
黑白 AI 分别设置：黑、白两方可分别选择模型与思考档位（Off / High / Max），互不影响；模型不支持所选档位时自动回落其默认档位。
思考过程分侧展示：黑、白两方的思考记录分别列在棋盘左右两侧（与各自的 AI 设置同侧），默认折叠，点击某手可展开该步的完整推理文本。
暂停与手动接管：棋盘下方【新开局】按钮右侧的【暂停】按钮可随时中断 AI 思考（两者均为「图标 + 文字」的胶囊按钮：⟳ 新开局、⏸ 暂停、▶ 继续，暂停中按钮转为琥珀色高亮）；暂停期间你可为黑白双方轮流落子，没有步数限制，再次点击【继续】后 AI 恢复思考。
固定超时与输出上限：单次落子的端到端超时固定为 3000000 毫秒（3000 秒）、输出 token 上限固定为 32000，随每次落子请求发送，不在界面中暴露。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

这个插件会消耗我的模型额度吗？

会。每次 AI 落子都是一次独立的 LLM 请求，包含棋盘文本（约 530 字符）和思考档位对应的推理输出，按你选择的模型计费；该请求与你的 agent 会话相互独立，不写入会话日志。

黑方第一手必须落在哪里？

必须落在天元 (7,7)。这是插件内置的强制开局规则，无论人机还是双 AI 对弈都一样；其他位置的第一手会被棋盘直接拒绝。

我能在对弈中切换模型或修改提示词吗？

可以。棋盘两侧分别有黑、白 AI 的模型下拉、思考档位（Off / High / Max）和提示词编辑器，切换或保存后下一手即生效，已下出的棋局不会被重置。

AI 思考卡住或被截断怎么办？

棋盘状态栏会显示"AI 思考已中断"或具体错误信息，右侧出现"重试"按钮，点击会重发当前那一步的请求。默认允许 3 次尝试，含一次纠正反馈。

关闭棋盘弹窗会中断对局吗？

不会。棋局状态保存在浏览器模块级 store 中，关闭或切换 tab 既不会重置棋盘，也不会中断正在进行中的 AI 思考。

怎么彻底卸载这个插件？

运行 dsh plugin --profile web remove @yejiming/dsh-gomoku，会同时移除依赖与对应的 gomoku 层。

— 源: plugin_wiki.faq_json

— 源: plugin_wiki.compatibility_json

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则