dsh-xiangqi-mate：DeepSeek Harness 的人機對弈中國象棋插件

DeepSeek Harness (DSH) 側重於智能體構建，但開發者常有特定場景需求，如即時對弈。現有的社區中國象棋插件要麼僅提供工具，要麼在模型異常時中斷。需要一個能在會話內流暢進行遊戲，並在模型故障時自動降級到本地引擎的方案。

dsh-xiangqi-mate 是一個人機對弈中國象棋插件。插件所有者爲 lpeixin。它讓用戶（執紅）與當前 DSH 會話配置的模型（執黑）對弈。若模型出現超時、限速或違規移動，內置的本地引擎將接管遊戲。

核心功能¶

零依賴，無構建步驟：宿主端僅使用 Node 內置模塊，瀏覽器端爲手寫單文件，安裝即用。
本地引擎回退機制：處理模型超時、限速或返回非法着法時，自動切換至本地引擎繼續對弈。
通用記譜法：支持 ICCS（如 h2e2）和中國記譜法（如 炮二平五）。
多語言 UI：支持中文和英文，隨 DSH 語言設置自動切換。
獨立引擎庫：lib/engine/** 是純函數庫，不依賴 DSH，可複用於其他項目。

安裝與啓用¶

使用 plugin_manager 安裝：

plugin_manager { action: "install_bundle", target: "github:lpeixin/dsh-xiangqi-mate" }

安裝後需確保狀態爲 applied。若提示 restart-required，請重啓 DSH。

典型用法¶

界面操作：點擊棋子 → 合法目標高亮 → 點擊目標落子。拖拽也支持。
對話觸發：在對話中輸入 “let’s play chess”，模型調用 xiangqi_new 即可開局。
命令行：

/xiangqi new | state | move 炮二平五 | undo | hint | resign | review

配置說明¶

編輯 cordis.patch.yml。注意：補丁會替換整個配置對象，而非合併。

配置項包括：

- id: xiangqi
  config:
    opponent:
      mode: model          # 模型執黑 | local 爲純本地引擎
      timeoutMs: 60000
      maxRetries: 2
      maxTokensPerMove: 256
      maxTokensPerGame: 20000
    local:
      depth: 4
      timeMs: 300
    rules:
      fiftyMovePlies: 120
      perpetualCheckLoses: true
    ui:
      showCoordinates: true
      showEval: false
      animation: true
      clock: off           # off | perMove | total

適用場景與注意¶

該插件適合需要在 DSH 會話中直接進行中國象棋對弈的開發者。它不會將棋譜填滿聊天曆史，而是獨立在右側面板進行。插件以當前 DSH 進程權限運行，安裝前建議檢查源碼與許可證。

結語¶

該插件解決了“工具型插件”與“純本地引擎”之間的空白，提供了一個健壯的人機對弈環境。

目錄頁: https://www.skillhub.cn/plugins/lpeixin/dsh-xiangqi-mate
源碼: https://github.com/lpeixin/dsh-xiangqi-mate