# NOTICE · 星芽五子棋

## 上游项目与固定版本

本项目是以下开源项目的二次开发版本：

- 仓库：[justa-cai/gomoku](https://github.com/justa-cai/gomoku)
- 固定提交：[`e8994c03eceda77190c1e88d33a5b4666eeafa5f`](https://github.com/justa-cai/gomoku/commit/e8994c03eceda77190c1e88d33a5b4666eeafa5f)
- 上游许可：MIT License
- 上游版权：Copyright (c) 2026 justa-cai
- 上游许可证全文保留在仓库根目录的 [`LICENSE`](LICENSE)，未作修改。

上游自带 NOTICE 说明其引擎、规则、UI 与样式为原创、无第三方版权代码，整体以 MIT 许可发布；本文件在上游声明的基础上，补充本衍生项目的归属和改动范围。

## 本项目名称与定位

- 产品名：**星芽五子棋**
- 定位：面向儿童与家庭的本地五子棋教学、训练、陪练与复盘 MVP
- 运行方式：纯静态前端，零构建依赖，使用仓库原有 `python3 server.py` 启动
- 数据：教学进度和棋谱只保存在当前浏览器的 `localStorage`，不上传服务器

## 本项目改动

在上游固定提交的基础上，本项目完成了以下改动：

1. **品牌与界面**：产品更名为「星芽五子棋」，增加全站导航、儿童友好的浅色主题、中文文案与响应式布局；保留上游木色 Canvas 棋盘、引擎侧栏与对局流程。
2. **新手学堂**：新增 `teach.html` / `js/teach.js`，用五步图文课程和九路 SVG 互动小棋盘讲清落子、轮流、五连、挡棋与活四。
3. **20 道自编训练题**：新增 `training.html` / `js/training.js` / `js/training-data.js`。题目、提示、答案与解释均为本项目原创，覆盖连五、挡五、活四和双四；进度写入本地浏览器。
4. **本地 AI 陪练**：复用上游自研的迭代加深 α-β + VCF 引擎（Web Worker）。未引入任何付费或远程 AI API，未修改引擎搜索算法。
5. **棋谱保存与复盘**：新增 `records.html` / `js/records.js` / `js/record-store.js`。终局自动保存、可中途保存、可逐手浏览、自动播放和删除；棋谱经过规则层重新推演。
6. **家庭房间入口**：新增 `room.html`，提供可直接使用的同屏双人入口，并明确说明跨设备联机尚未实现。未依赖任何付费房间服务。
7. **测试与文档**：新增 `test/` 下的 Node 单元测试、`package.json` 测试脚本，以及更新后的项目 README。更新 Canvas 棋盘视图，增加训练用的正确/错误/提示标记；未改动引擎搜索与评估代码。
8. **手机触控与发布准备**：Canvas 棋盘使用 Pointer 事件并区分点按/拖动，扩大 15 路棋盘的最近交叉点命中范围（含单元测试）；新增 `deploy/` 下的静态部署说明、Nginx/Caddy 样例和只在本机运行的发布前检查脚本。当前未执行部署，也未连接任何服务器。

## 第三方依赖与远程服务

- 运行时无第三方 JavaScript 库、无 CDN、无远程字体、无图片素材。
- 不调用付费或远程 AI API。
- 不包含后端数据库、账号系统或云房间服务。
- 单元测试仅使用 Node.js 内置的 `node:test` 和 `node:assert`。

## 许可

本项目在 MIT License 下发布，完整文本见 [`LICENSE`](LICENSE)。再分发时请保留上游版权声明、MIT 许可文本以及本 NOTICE。