棋牌游戏 · Chinese Chess & Gomoku (dsh client plugin)
在 DeepSeek Harness (dsh) Web 界面里和 AI 下中国象棋、五子棋与围棋的客户端插件。
A client plugin that brings Xiangqi (Chinese Chess), Gomoku and Go (Weiqi) right into the DeepSeek Harness Web UI.
✨ 特性 Features
- 规则绝对可靠 / Bulletproof rules：所有走法由内置规则引擎强制校验（象棋：将帅照面、马腿、蹩象眼、炮架、过河兵、九宫、将军/将死/困毙、三次重复、吃将判胜；五子棋：连五判胜）。AI 只能从引擎生成的合法走法中落子。
- 可选任意已配置模型对弈 / Play against any configured model：界面直接列出 dsh 已配置的模型；模型只负责从合法走法里选一步，回复会被二次校验，无效自动回退内置引擎。
- AI 博弈模式 / AI vs AI duel mode：双方各用各的 AI（不同模型、或模型 vs 内置引擎），可调速、暂停、单步，对局结束自动开新局，看 AI 自己打架。
- 围棋 / Go：9/13/19 路可选，完整规则（气、提子、禁自杀、劫、双停手、中国规则数目，支持标记死子），内置启发式 AI + 模型选招。
- 内置引擎兜底 / Built-in engine：零依赖、纯本地（象棋 α-β 剪枝 3 层，五子棋模式评分 + 搜索），离线可用。
- 半屏模式 / Half-screen mode：占屏幕下半边，磨砂玻璃、可拖动、透明度可调——Agent 跑任务时边下棋边监督。
- 战场分析 / Battlefield analysis：将军高亮（红圈 + 横幅）、子力对比条、吃子记录、走子箭头。
🚀 安装 Install
一键安装（推荐） —— 直接拉取本仓库并安装：
dsh plugin --profile web add https://github.com/vkxkzsp769-cloud/Chinese-Chess-and-Gomoku
克隆后手动安装：
git clone https://github.com/vkxkzsp769-cloud/Chinese-Chess-and-Gomoku.git
cd Chinese-Chess-and-Gomoku
npm pack # 生成 dsh-local-dsh-client-ui-games-0.1.0.tgz
dsh plugin --profile web add dsh-local-dsh-client-ui-games-0.1.0.tgz
或手动：把 tgz 加入 $DSH_HOME/profiles/web/package.json 的 dependencies，包名加入 dsh.profile.bundles，在该目录执行 pnpm install，重启 dsh web。
插件零依赖、客户端已预构建（lib/client.js），克隆后无需任何编译即可安装。
🎮 使用 Usage
- 启动 dsh web，左侧边栏底部点击 ♟ 棋牌游戏。
- 切换 中国象棋 / 五子棋。
- 「AI 棋手」选择模型（或内置引擎）；「对弈模式」选 人机对战 或 AI 博弈。
- 半屏（⇤ 半屏）可拖动、可调磨砂透明度，边玩边监督 Agent 任务。
🧱 结构 Structure
lib/index.js 服务端：/rpc 通道（games/ai-move、games/health），LLM 选招 + 回复校验（零依赖）
lib/client.js 浏览器端（构建产物）：入口、游戏面板、引擎与 UI
src/engine/ 引擎源码（UMD，Node 可直接 require 测试）
src/client-part.js 客户端主体源码
build-client.mjs 构建脚本：引擎 + 客户端主体 → 单个 lib/client.js
🛠 开发 Dev
node build-client.mjs # 重新生成 lib/client.js（纯 node，无需 pnpm）
# 引擎规则测试：象棋 45 项、五子棋 21 项（Node 直接 require src/engine/*.js）
/sdcard (FUSE) 上 pnpm/git 的文件操作会失败；构建用 node build-client.mjs 即可，git 请在主文件系统副本上操作。
🔖 标签 Topics
dsh · dsh-web · deepseek-harness · plugin · xiangqi · chinese-chess · gomoku · five-in-a-row
📄 License
MIT
