前言¶
在 DeepSeek Harness（DSH）里，模型多半承担写代码、改配置、跑任务。若要直观感受某模型的推理与战术判断，往往缺少一个可重复、可对比的「小战场」。五子棋规则简单、局面可读，每一步又依赖对威胁与机会的权衡，适合作为旁路观测窗口。
omdsh-dev/dsh-gomoku 是社区维护的 DSH 插件：在 Harness 侧边栏摆上一盘 15×15 棋盘，让你与 DeepSeek 或任意已配置模型对弈，也可让两个模型同台厮杀，对比棋力差异。
这是什么¶
插件 npm 包名为 @yejiming/dsh-gomoku，源码仓库由 omdsh-dev 维护，GitHub 地址为 omdsh-dev/dsh-gomoku。SkillHub 目录将其归类为「趣味换装」。
插件不提供搜索算法或启发式剪枝：每一步落子均来自 LLM 的推理与判断。棋局状态、回合与胜负判定在浏览器端完成；服务端仅仲裁 AI 落子，非法回复会被拒绝，不会破坏前端棋盘。
核心功能¶
对弈模式¶
棋盘下方提供模式切换与新开局。支持三种玩法：
- 人机对弈：你为黑或白，AI 执另一方。
- 双 AI 对弈：黑、白各选一个模型，旁观整局。
- 暂停与手动接管：点击【暂停】可中断 AI 思考，为双方轮流落子；再次点击【继续】后 AI 恢复。暂停期间按钮呈琥珀色高亮。
规则为自由式五子棋（无禁手）：双三、双四、长连均合法，任意方向连续五子及以上即胜；棋盘满且无人获胜则为和棋。
模型与思考档位¶
黑、白方可分别选择模型与思考档位（Off / High / Max），互不影响。所选模型不支持某档位时，自动回落到该模型默认档位，不会导致请求失败。
思考过程与提示词¶
黑、白两方的思考记录分列棋盘左右，默认折叠；点击某一手可展开该步完整推理文本。推理块随落子、和棋或错误结果以 reasoning 字段返回。
黑、白系统提示词分别在左右侧面板常驻展示、随时编辑，各自可一键恢复默认。默认提示词包含规则、术语（活二、活三、眠三、双活三、四三等）、强制思考流程与 Few-shot 示例；修改后的文本会原样作为系统提示词发送。
后台对局与容错¶
关闭棋盘弹窗不会重置棋局，也不会中断正在进行的 AI 思考；棋局保存在浏览器端 store，可一边使用 Harness 主功能一边对弈。
单次落子端到端超时固定为 3000000 毫秒（3000 秒），输出 token 上限固定为 32000，由浏览器端每次请求发送，界面不提供调整。流式响应因连接断开、限流等瞬时故障中断时，会在尝试预算内自动重试。
安装与启用¶
插件仓库已提交构建产物 lib/，安装时无需本地构建。要求 dsh ≥ 0.1.0-rc.6：插件依赖 @deepseek-ai/dsh-host-webserver 的 webServer 服务，更早版本会导致插件行一直处于 pending。
方式一：npm 安装（推荐）¶
dsh plugin --profile demo add @yejiming/dsh-gomoku
方式二：GitHub 源码安装¶
dsh plugin --profile demo add github:omdsh-dev/dsh-gomoku
方式三：本地或 tarball 安装¶
# 在插件目录内
dsh plugin --profile demo add .
# 或先打包再安装
pnpm pack
dsh plugin --profile demo add ./yejiming-dsh-gomoku-0.0.1.tgz
首次使用 dsh plugin 会初始化该 profile。安装后用 --dump-config 确认层已写入，再启动：
dsh --profile demo --dump-config # 输出中应出现 gomoku 层
dsh --profile demo
移除插件：
dsh plugin --profile demo remove @yejiming/dsh-gomoku
若 pnpm 提示 peer 依赖警告，可忽略：所需服务由宿主 dsh 在运行时提供。
典型用法¶
- 安装并启动带 demo profile 的 DSH，在侧边栏打开五子棋棋盘。
- 选择「执黑」「执白」或「双 AI」模式，点击新开局。
- 在左右侧面板为黑、白分别挑选模型与思考档位；需要时可编辑系统提示词，观察棋力变化。
- 人机模式下点击空交叉点落子，等待 AI 回应；双 AI 模式下旁观双方推理与落子。
- 需要插手时点【暂停】，手动为双方落子后再【继续】；处理其他任务时可关闭弹窗，对局在后台继续。
每次 AI 落子是一次独立的辅助请求：用户消息包含带行列标注的 15×15 棋盘文本、执子方，以及（重试时）上一次非法回复与拒绝原因。模型须严格返回 JSON，例如 {"move": [row, col]}、{"draw": true} 或 {"error": "原因"}。该请求不写入 agent 会话日志。
配置项¶
所有字段均有 loader 默认值，无库级默认值：
| 键 | 说明 |
|---|---|
moveTimeoutMs |
单次 AI 落子端到端截止时间，默认 3000000 毫秒 |
maxMoveOutputTokens |
单次落子回复输出 token 上限，默认 32000 |
maxMoveAttempts |
每次落子请求的 AI 尝试总次数，默认 3；最后一次附带纠正反馈 |
浏览器端对超时与输出上限发送固定值，界面不提供调整。
适用场景与注意¶
适合希望在 DSH 工作流旁路观测模型推理、对比不同模型或提示词战术表现的开发者。双 AI 模式便于在同一局内比较推理缜密程度，而非依赖主观对话印象。
安装前建议阅读源码与许可证（MIT）。插件以当前 dsh 进程权限运行，模型调用走你已配置的 provider 路由，会产生与主对话独立的 token 消耗。SkillHub 为社区目录站点，与 DeepSeek、幻方无官方从属关系。
链接¶
- 目录页：https://www.skillhub.cn/plugins/omdsh-dev/dsh-gomoku
- GitHub：https://github.com/omdsh-dev/dsh-gomoku
