大作业:揭棋对弈程序设计(网络真人对弈 + AI 博弈)。
Unveil/
├── docs/ # 需求、架构、协议 v3.0、分工
├── pom.xml # Maven 父工程
├── jieqi-core/ # 领域、规则、JSON/TCP 协议、UI、棋谱
├── jieqi-server/ # WebSocket 服务器 + TCP 服务器
├── jieqi-client/ # WebSocket 客户端 + TCP 客户端
├── jieqi-ai/ # Alpha-Beta、评估、Agent
└── jieqi-app/ # 统一启动入口
详细说明见 docs/02-design/ARCHITECTURE.md。
- JDK 21
- Maven 3.9+
powershell -File scripts/verify.ps1# 方式 A:脚本(推荐,Windows / 自动构建依赖)
powershell -File scripts/run-app.ps1
# 方式 B:Maven(-f 指向 jieqi-app,-am 自动构建依赖模块)
mvn exec:java -f jieqi-app/pom.xml -am
# 方式 C:Fat JAR
mvn package -pl jieqi-app -am -DskipTests
java -jar jieqi-app/target/unveil-jieqi.jar server-ws 8887# 服务器(端口 8887)——推荐用 Fat JAR,避免 mvn exec 加载 ~/.m2 旧 SNAPSHOT
powershell -File scripts/dev-server.ps1 8887
# 或
mvn package -pl jieqi-app -am -DskipTests
java -jar jieqi-app/target/unveil-jieqi.jar server-ws 8887
# 若坚持用 exec:java,须先 install 刷新本地仓库
mvn install -pl jieqi-app -am -DskipTests
mvn exec:java -f jieqi-app/pom.xml -am "-Dexec.args=server-ws 8887"
# 人机客户端
mvn exec:java -f jieqi-app/pom.xml -am -Dexec.args="client-ws ws://127.0.0.1:8887 player1 123456"
# AI 自动对弈(WS)
mvn exec:java -f jieqi-app/pom.xml -am -Dexec.args="ai-ws ws://127.0.0.1:8887 ai_bot_1 pw123"或菜单选项 3 / 4 / 9(WebSocket 服务器 / 客户端 / AI 自动对弈);6 为本地人机(三档难度可选)。
- 启动 WebSocket 服务器:
mvn exec:java -f jieqi-app/pom.xml -am -Dexec.args="server-ws 8887" - 客户端 1:
mvn exec:java -f jieqi-app/pom.xml -am -Dexec.args="client-ws ws://127.0.0.1:8887 player1 123456" - 客户端 2:
mvn exec:java -f jieqi-app/pom.xml -am -Dexec.args="client-ws ws://127.0.0.1:8887 player2 123456" - 客户端操作:
match→ready→first true/first false→move a 6 a 5走子 - 对局结束后:查看终局摘要 →
replay复盘(n/p/g 12/q)→rematch再来一局
演示脚本:scripts/demo.ps1 一键打开三个终端窗口(服务器 + 两个客户端)。
人机对弈:客户端输入 ai easy|medium|hard;本地菜单选 6 后选择 1–3 档难度。
docker compose up --buildmvn exec:java -f jieqi-app/pom.xml -am -Dexec.args="server 8888"
mvn exec:java -f jieqi-app/pom.xml -am -Dexec.args="client 127.0.0.1 8888 Player1"typst compile docs/INTERFACE.typ docs/INTERFACE.pdf| 文件 | 内容 |
|---|---|
| docs/README.md | 文档总索引(六类 24+ 份) |
| INTERFACE.typ / .pdf | v3.0 WebSocket JSON 权威协议 |
| REQUIREMENTS.md | 需求覆盖度 |
| ARCHITECTURE.md | 架构 |
| INTEROP.md | 组间联调 |
| TEST_REPORT.md | 自动化测试报告 |
- 正文(组间互操作):WebSocket + JSON,
messageType字段,端口 8887 - 附录 B:TCP
msgType|len|payload\n,端口 8888 - 联调前与对方约定使用哪一种,不可混用