前言¶
在 DSH Web 的會話標籤裏，通常看到的是對話、工具調用和會話日誌。dsh-auto-chess 把一張簡化自走棋棋桌放進這個標籤欄：你可以執藍方與 AI 對戰，也可以旁觀兩個 AI 對弈。每次 AI 決策後，還能在思考記錄面板查看完整推理文本，適合用來觀察模型在固定規則下如何給出動作。
這是什麼¶
omdsh-dev/dsh-auto-chess 是 omdsh-dev 維護的 DSH Web 插件，許可證爲 MIT。它提供一個簡化自走棋界面，支持人機對戰或雙 AI 對弈。
核心功能¶
對戰模式¶
- 人機對戰：用戶執藍方。
- 雙 AI 對戰：藍方和紅方由 AI 分別操作，用戶旁觀。
模型與思考設置¶
- 藍方、紅方可從模型目錄中分別選擇模型並獨立設置。
- 支持
Off、High、Max思考檔位。 - 模型不支持所選檔位時，自動回落到默認檔位。
決策限制¶
- 單次 AI 決策超時默認
300000ms。 - 輸出 token 上限默認
32000。 - 這兩項由部署配置決定，界面不再提供修改入口。
提示詞與推理記錄¶
- 藍方、紅方可分別編輯提示詞，並一鍵恢復默認。
- 每次 AI 決策後，可在左右思考記錄面板查看完整推理文本。
失敗與重試¶
- AI 給出非法操作時，會提示原因並提供重試。
- 瞬時流式傳輸故障會在嘗試預算內自動重試。
會話切換¶
- 切換會話、關閉會話標籤不會中斷 AI 思考與戰鬥進程。
安裝與啓用¶
先在插件目錄構建，再安裝到 web profile：
pnpm run build
dsh plugin --profile web add /Users/yejiming/Desktop/OpenSource/dsh-auto-chess
安裝後檢查配置層：
dsh --profile web --dump-config # 輸出中應出現 auto-chess 層
啓動或重啓 Web 界面：
dsh web # 重啓後會話標籤欄出現「自走棋」標籤
Web 進程需重啓，纔會掃描到新的 dshClient 包並注入客戶端標籤。
移除插件：
dsh plugin --profile web remove @deepseek-ai/dsh-auto-chess
典型用法¶
下面是已覈實的開發與驗證命令。
構建：
pnpm run build
類型檢查與測試：
pnpm run typecheck
pnpm test
node tests/e2e/gui-round.spec.mjs
這裏的 node tests/e2e/gui-round.spec.mjs 用於端到端測試。
適用場景與注意¶
適合在 DSH Web 中查看不同模型、不同提示詞、不同思考檔位下的自走棋決策與推理文本，也可以讓兩個 AI 對局，觀察兩側輸出差異。
使用前注意：
- 棋局狀態只存在於頁面內存中，刷新或關閉瀏覽器頁面會重置對局。
- 遊戲規則爲簡化版本：無裝備系統，戰鬥爲低精度模擬。
- 輔助請求與任何 agent 對話相互獨立，絕不寫入會話日誌。
- 插件以當前
dsh進程權限運行，安裝前應檢查源碼與許可證。 - 許可證爲 MIT，源碼見 GitHub 倉庫。
結尾¶
dsh-auto-chess 的價值在於把模型決策放進一個可見、可比較、可重試的自走棋場景裏：勝負在棋盤上，推理文本留在記錄面板中。
目錄頁：https://www.skillhub.cn/plugins/omdsh-dev/dsh-auto-chess
GitHub：https://github.com/omdsh-dev/dsh-auto-chess
