Skip to content
bosprimigeniousPublic

About

No description, website, or topics provided.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

Unveil — 揭棋对弈程序

大作业:揭棋对弈程序设计(网络真人对弈 + 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

WebSocket + JSON(课程公共接口,默认)

# 服务器(端口 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 为本地人机(三档难度可选)。

演示流程

  1. 启动 WebSocket 服务器:mvn exec:java -f jieqi-app/pom.xml -am -Dexec.args="server-ws 8887"
  2. 客户端 1:mvn exec:java -f jieqi-app/pom.xml -am -Dexec.args="client-ws ws://127.0.0.1:8887 player1 123456"
  3. 客户端 2:mvn exec:java -f jieqi-app/pom.xml -am -Dexec.args="client-ws ws://127.0.0.1:8887 player2 123456"
  4. 客户端操作:match → ready → first true / first false → move a 6 a 5 走子
  5. 对局结束后:查看终局摘要 → replay 复盘(n/p/g 12/q)→ rematch 再来一局

演示脚本:scripts/demo.ps1 一键打开三个终端窗口(服务器 + 两个客户端)。

人机对弈:客户端输入 ai easy|medium|hard;本地菜单选 6 后选择 1–3 档难度。

Docker(WS 8887)

docker compose up --build

TCP 文本帧 v2.0(附录 B,兼容调试,端口 8888)

mvn 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"

编译协议 PDF

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
  • 联调前与对方约定使用哪一种,不可混用

About

No description, website, or topics provided.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages