kidgame-sdk

少儿围棋 AI SDK：基于棋型匹配的落子生成（AI + boardMatcher）。

由 kidgame-react 重构而来，棋盘依赖 goboard-sdk，演示页面放在 examples/，不随 npm 包导出。

安装

pnpm add kidgame-sdk goboard-sdk

最小用法

import { Go, Color } from 'goboard-sdk'
import { AI, parseAIConfig } from 'kidgame-sdk'

const go = new Go(13)
const ai = new AI({
  go,
  boardSize: 13,
  rules: parseAIConfig({}),
  aiColor: Color.WHITE,
})

const [col, row] = ai.autoPlay()

运行 Examples

pnpm install
pnpm dev     # http://localhost:5174

examples 通过 Vite + React 演示，默认 alias 到 src/ 源码。

导出

• AI — 核心引擎（autoPlay / analyze）
• parseAIConfig — 技能权重配置
• matchPattern / getSymmetries 等 — 棋型匹配

页面、棋盘 Player、GnuGo 仅用于 examples，不进入 npm 包。

发版

推送 v* tag 触发 GitHub Actions 发布到 npm，不要本地 pnpm publish（首次发布除外，见 RELEASE.md）。先改 package.json 的 version，再（以 0.1.1 为例）：

git checkout main
git pull
git add -A
git commit -m "chore: release v0.1.1"
git push origin main

git tag v0.1.1
git push origin v0.1.1

tag 必须是 v + package.json 里的版本号。完整流程见 RELEASE.md。

目录

src/           # 库源码（ai + boardmatcher）
examples/      # Vite 演示（不进入 npm 包）
dist/          # 构建产物（npm 发布内容）