fuyu-jie/dsh-go-plugin

DSH 围棋对弈插件（Go-bloc 围棋）

在 DeepSeek Harness 网页界面里，与一个简单的 AI 一起下一盘 19×19 围棋。

你是黑棋（先手），AI 执白。点棋盘落子，AI 自动回一手。支持吃子、打劫、悔棋、重新开始。

✨ 功能特性

- 完整基础规则：落子合法性、吃子（提子）、打劫（ko）、自杀禁止（自填眼位）
- 防守型启发式 AI：会优先提子、会自救逃跑、不主动自杀
- 实时提子计数：显示黑/白各自提掉对方多少子
- 悔棋：退回上一手（AI 刚下完时连退到你落子前）
- 重新开始：一键开局新的一局
- 星位标记：天元 + 四角星 + 边星，一眼定位

🚀 安装方法（在 DSH 中使用）

go-plugin/ 是一个 DeepSeek Harness web 插件，作为 bundle 挂载到你的 web profile。

方式一：开发中（本机，改代码即生效）

如果你在本机开发这个插件，用 link: 方式直接链接到它的文件夹：

1) 把插件装进 web profile（link 方式，指向本机 go-plugin 文件夹）
dsh plugin --profile web add link:D:\dsh-second-wp\go-plugin

2) 重启 DSH，浏览器打开 web 界面，右下角出现"围棋对弈 🀄"棋盘

link: 适合开发期：改代码即生效；但 D:\dsh-second-wp\go-plugin 是本机私有路径，只有你这台电脑能用。

方式二：正式安装（已发布到 npm，推荐其它用户使用）

插件已发布到 npm，直接用包名安装：

从 npm 官方仓库安装（最标准）
dsh plugin --profile web add @fuyu-jie/dsh-go-plugin

也可以从 GitHub 源安装：
dsh plugin --profile web add github:fuyu-jie/dsh-go-plugin

想用在别的 profile，把 --profile web 换成对应 profile 名即可。

🎮 怎么玩

1. 打开 DSH 网页界面，看右下角棋盘
2. 棋盘下方显示「你（黑）落子」时，点击任意格子落黑子
3. AI（白）会自动回应你的每一手
4. 用「悔棋」「重新开始」掌控对局
5. 「黑提 / 白提」实时告诉你双方吃了多少子

📁 目录结构

dsh-second-wp/
├─ go-plugin/                 ← 围棋插件本体（npm 包）
│  ├─ index.mjs               ← 宿主端 half（当前为空骨架）
│  ├─ client.js               ← 浏览器端 half（棋盘 UI + 内联规则/AI）
│  ├─ src/
│  │  ├─ goban.js             ← 规则引擎（棋盘/落子/吃子/打劫；纯逻辑）
│  │  └─ ai.js                ← AI 策略（启发式）
│  ├─ test-goban.mjs          ← 规则引擎命令行测试
│  ├─ test-ai.mjs             ← AI 命令行测试
│  ├─ package.json            ← 插件包声明（dsh bundle/client）
│  └─ cordis.patch.yml        ← 挂载补丁（插入 go-plugin 行）
├─ README.md                  ← 本文件（项目主页）
└─ LICENSE                    ← MIT 开源许可

🧪 测试

规则引擎与 AI 都带命令行测试，零依赖：

cd go-plugin
node test-goban.mjs   # 规则引擎：落子/吃子/打劫/自杀/悔棋 （26 项）
node test-ai.mjs      # AI：合法着法/提子/自救 （7 项）

🛣️ Roadmap

- [x] 可交互棋盘 + 简单 AI 对弈
- [x] 吃子、打劫、自杀禁止
- [x] 提子计数、悔棋、重新开始
- [ ] 判断输赢（终局数子 / 目数）
- [ ] 更智能的 AI（搜索多步、围地做眼）
- [ ] 联网围棋 API / 更强引擎（如 KataGo）

📜 开源许可

LICENSE — MIT