dsh-xiangqi

深度求索 Harness (DSH) Web 客户端插件：一个"AI 思考时可以下中国象棋"的消遣宠物。

一只卡通小宠物（抱着一枚"象"字棋子）悬浮在 DSH Web GUI 上，邀请你在 AI 思考的空档下棋。内置自写引擎（negamax + α-β + 迭代加深），并对局中即时提供"天天象棋定式名 + 三国杀风格击杀台词"，可选叠加多模型 LLM 局势点评。

• 玩法：纯消遣的人机对弈，跟对话 agent 完全独立，绝不阻塞主循环。
• 完全离线可玩：本地规则引擎负责走法与台词；LLM 点评仅作可选的锦上添花。

---

安装

插件是一个 Cordis 客户端插件包。源码托管在 GitHub：https://github.com/ovdoesw/dsh-xiangqi

# clone 源码并构建产物
git clone https://github.com/ovdoesw/dsh-xiangqi.git
cd dsh-xiangqi
npm install
npm run build        # 产出 lib/client.js + lib/index.js

装载方式见 INTEGRATION.md 的 cordis.patch.yml 配置与 dsh plugin 命令（本地开发可用 link: 指向本目录）。

纯 Node 环境即可 npm test 跑核心层与 AI 层单测，无需 DSH 前端环境。

功能

• 悬浮宠物：拖拽可移动，位置会持久化；悬停时棋子升起 + 随机邀请气泡。
• 小面板棋盘：点击宠物展开；支持点选走子、难度切换、新局、悔棋、点评、放大全屏。
• 全屏棋盘：可放大到全屏对弈，Esc 收起；背板保持点击穿透，不影响底层应用。
• 本地台词：开局定式名（当头炮 / 仙人指路 / 屏风马 / 顺手炮 / 列手炮…）、三国杀风格击杀与将军/绝杀台词，全部离线即时触发。
• LLM 局势点评（可选）：每步自动点评 + 手动点评按钮，风格可在"专业棋评 / 娱乐主播"间切换。
• 完整状态持久化：进度、难度、宠物位置、设置都会保存在浏览器。

难度分档

难度	引擎策略
初级 easy	深度 1 + 随机扰动（从分数接近的若干候选中随机挑一个），适合新手放松
中级 medium	深度 2 固定搜索
高级 hard	迭代加深到深度 4 或限时 5 秒

搜索以异步分片方式执行，绝不阻塞主线程。

给对弈者的一点坦白：本插件的开发者初学象棋，内置引擎写得不算强（"比较菜"）——它只是一个简化的 negamax + α-β + 迭代加深搜索，加上简单的子力/位置估值。如果你觉得对手棋力不够、下得不过瘾，可以直接让 DSH 里当前这个 AI Agent 帮你调引擎，改完即时生效：

• 想更强：让 Agent 加深 hard 的搜索（改 src/ai/search.ts 的 或 的时限），或加强 的估值函数（加入开中残局权重、威胁识别、过河兵/肋车等要点）。