前言¶
DeepSeek Harness（DSH）是「一切皆插件」的智能体开发环境。开发者需要在右侧边栏同时处理代码、终端、文档等，再额外打开一个棋盘或查阅评估往往要切换窗口、打断思路。dsh-chess-board 把国际象棋功能直接嵌入 DSH 的右侧边栏，和文件树、终端平级，用标签页的形式组织。它不依赖外部应用，内置完整规则、八档对手、lichess 云端评估，支持复盘、战术题，也支持与 lichess 引擎在线对局。
插件定位¶
dsh-chess-board 是一个客户端插件，由维护者 tomandpotato 开发，星标数为 0。它为 DSH 用户在编辑区旁边提供一个国际象棋标签页，既能本地练习，也能接入 lichess 的云端评估与引擎对局。插件本身只处理棋盘与交互，宿主的主题与布局由 DSH 提供。
核心功能¶
完整规则判定¶
棋盘内置完整的国际象棋规则判定，包括：
- 王车易位（含「不能穿过被攻击格」「被将时不能易位」）
- 吃过路兵
- 兵升变（可选后、车、象、马）
- 将死与逼和
- 五十步和棋
- 合法着法提示
规则判定与公开的 perft 测试结果一致，不依赖外部引擎。
八档内置对手¶
内置 alpha-beta 搜索 + 子力位置表，提供八档难度（Level 1…Level 8），编号与 lichess 保持一致。难度由「搜索深度 + 可接受着法带宽 + 失误率」共同决定，不只是调整搜索深度。
操作方式支持两种：
- 点选棋子 → 点目标格
- 直接拖拽棋子到目标格
支持执白/执黑选择、悔棋（一次退回一整个回合，即把引擎的应手与用户的着法一起收回）、翻转棋盘，着法记录使用 SAN 格式。
lichess 云端评估¶
每个局面自动查询 lichess 的 cloud-eval，返回：
- 优势条（表示白方或黑方优势的长度）
- 一句话结论（如「白方略优」）
- 带回合数的最佳着法线路
- 备选着法及其与最佳线的差距
当 lichess 限流（429）时，会切换到本地引擎兜底，并在界面中标注来源。
复盘与战术题¶
支持导入自己的 PGN 对局进行逐步复盘，也可以从任意局面接着下。同时提供每日/随机战术题训练。
与 lichess 引擎对局¶
与 lichess 引擎对局需要提供 lichess token。引擎应手由服务器推送返回，支持认输、求和、中止。云端评估、残局库、PGN 回放、战术题无需登录账号。
交互手感¶
- 落子有滑行动画（默认 190ms）
- 支持点击两步或直接拖拽
- 棋盘采用熟悉的棕色木色，坐标画在格子内部
- 可走点用半透明墨绿圆点，吃子目标用圆环
- 被将的国王有红色径向光晕
- 白子/黑子用同一枚实心字形 + 对比描边
安装与启用¶
在终端中执行以下命令安装：
dsh plugin add dsh-chess-board
安装后重启 DSH（bundle 列表只在宿主启动时组装一次）。在右侧边栏标签条的「添加」控件里选择 Chess 即可打开。
不登录也能使用云端评估、残局库、PGN 回放、战术题。只有「与 lichess 引擎对局」需要 token——账号页会提供一个已勾好所需权限的建 token 链接。
界面位置与拖拽¶
棋盘是右侧边栏中的一个标签页，与文件树、终端平级。可以通过标签条上的「添加」控件或会话中文件/链接旁的侧栏入口打开。
标签页支持拖拽：
- 拖标签胶囊左右移动：在同栏内换位
- 拖到分栏边缘：与该格并排分栏（最多两格）
- 拖出边栏：变成浮窗，可拖到屏幕任意位置、调整尺寸
- 浮窗右键菜单：可收回到侧边栏
拖拽能力来自 DSH 的停靠系统（dockkit），插件只需注册好标签页类型即可自动获得。
适用场景¶
适合需要在开发间隙练习棋艺、分析局面、或者借助 lichess 引擎进行对弈与复盘的 DSH 用户。插件以当前 dsh 进程权限运行，建议在安装前查看源码与许可证（MIT）。
总结¶
dsh-chess-board 在 DSH 右侧边栏提供了一个完整的国际象棋标签页，包含规则判定、八档内置对手、lichess 云端评估、复盘与战术题，以及与 lichess 引擎的对局能力。它不需要额外应用，通过插件机制集成到编辑环境，减少切换窗口的打断。
- 目录页：https://www.skillhub.cn/plugins/tomandpotato/dsh-chess-board
- GitHub：https://github.com/tomandpotato/dsh-chess-board
