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