前言¶
在 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
