commit cb28bbb49e3c7d898541cf804409761bec18ce52 Author: rong Date: Fri Oct 23 10:12:55 2026 +0800 feat: 围棋在线对战(Rust 服务端 + 零构建前端) - 规则引擎:提子、禁自杀、全局同形(超级劫)、中国规则数子(白贴 7.5 目)、停一手终局 - 服务端:axum + tokio,房间/观战/包干计时/断线重连/语音中继,前端资源内嵌单文件 - 前端:Canvas 木纹棋盘(9/13/19 路、星位、四边坐标、翻转视角)、WebAudio 合成落子声、 本机双人模式、终局数子面板 - 测试:16 组规则断言 + 5 组 e2e(提子/劫/数子/观战/语音/静态资源) - 构建缓存遵循 dev-cache-layout:target/ 留项目内并忽略,前端零构建不产生包缓存 diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..78d833a --- /dev/null +++ b/.gitignore @@ -0,0 +1,10 @@ +# 构建产物留在项目里,target/ 不进仓库(编译中间物不外移,见 dev-cache-layout) +/target/ + +# 系统 / 本地杂项 +.DS_Store +*.log +.env + +# 本机 agent 工作记录,不入库 +.workbuddy/ diff --git a/Cargo.lock b/Cargo.lock new file mode 100644 index 0000000..6716089 --- /dev/null +++ b/Cargo.lock @@ -0,0 +1,753 @@ +# This file is automatically @generated by Cargo. +# It is not intended for manual editing. +version = 4 + +[[package]] +name = "atomic-waker" +version = "1.1.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "1505bd5d3d116872e7271a6d4e16d81d0c8570876c8de68093a09ac269d8aac0" + +[[package]] +name = "axum" +version = "0.8.9" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "31b698c5f9a010f6573133b09e0de5408834d0c82f8d7475a89fc1867a71cd90" +dependencies = [ + "axum-core", + "base64", + "bytes", + "form_urlencoded", + "futures-util", + "http", + "http-body", + "http-body-util", + "hyper", + "hyper-util", + "itoa", + "matchit", + "memchr", + "mime", + "percent-encoding", + "pin-project-lite", + "serde_core", + "serde_json", + "serde_path_to_error", + "serde_urlencoded", + "sha1", + "sync_wrapper", + "tokio", + "tokio-tungstenite", + "tower", + "tower-layer", + "tower-service", + "tracing", +] + +[[package]] +name = "axum-core" +version = "0.5.6" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "08c78f31d7b1291f7ee735c1c6780ccde7785daae9a9206026862dab7d8792d1" +dependencies = [ + "bytes", + "futures-core", + "http", + "http-body", + "http-body-util", + "mime", + "pin-project-lite", + "sync_wrapper", + "tower-layer", + "tower-service", + "tracing", +] + +[[package]] +name = "base64" +version = "0.22.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "72b3254f16251a8381aa12e40e3c4d2f0199f8c6508fbecb9d91f575e0fbb8c6" + +[[package]] +name = "block-buffer" +version = "0.10.4" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "3078c7629b62d3f0439517fa394996acacc5cbc91c5a20d8c658e77abd503a71" +dependencies = [ + "generic-array", +] + +[[package]] +name = "bytes" +version = "1.12.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "fc652a48c352aef3ea3aed32080501cf3ef6ed5da78602a020c991775b0aff04" + +[[package]] +name = "cfg-if" +version = "1.0.5" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "4e7648175b45a9a48536d676f68d918270699102aa8dab5496df06904c914600" + +[[package]] +name = "cngo" +version = "1.0.0" +dependencies = [ + "axum", + "futures-util", + "serde", + "serde_json", + "tokio", + "tokio-tungstenite", +] + +[[package]] +name = "cpufeatures" +version = "0.2.17" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "59ed5838eebb26a2bb2e58f6d5b5316989ae9d08bab10e0e6d103e656d1b0280" +dependencies = [ + "libc", +] + +[[package]] +name = "crypto-common" +version = "0.1.7" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "78c8292055d1c1df0cce5d180393dc8cce0abec0a7102adb6c7b1eef6016d60a" +dependencies = [ + "generic-array", + "typenum", +] + +[[package]] +name = "data-encoding" +version = "2.11.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "4583a4551df46e2792f82ceeac45e850d2e2d5debba0b91f102385cda5b11f06" + +[[package]] +name = "digest" +version = "0.10.7" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "9ed9a281f7bc9b7576e61468ba615a66a5c8cfdff42420a70aa82701a3b1e292" +dependencies = [ + "block-buffer", + "crypto-common", +] + +[[package]] +name = "form_urlencoded" +version = "1.2.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "cb4cb245038516f5f85277875cdaa4f7d2c9a0fa0468de06ed190163b1581fcf" +dependencies = [ + "percent-encoding", +] + +[[package]] +name = "futures-core" +version = "0.3.34" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "92d699e522242e69e3003b94ecc1f960f3a5e015aa7c5d7486e65ad01dd94f5e" + +[[package]] +name = "futures-macro" +version = "0.3.34" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "9fb9654ba8355388abeb8dcb4fc62f511300867002afc858860463bdd9fe0c44" +dependencies = [ + "proc-macro2", + "quote", + "syn 3.0.9", +] + +[[package]] +name = "futures-sink" +version = "0.3.34" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "1944426bf7d03f1d14f708785e4b33efd750b36d48a157b836b3efc15ede8e1d" + +[[package]] +name = "futures-task" +version = "0.3.34" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "cd417de3d1d015fc3bfd2b1ea46dfc7bab72ef86f1cc7cc9c78e728b34a6d1fd" + +[[package]] +name = "futures-util" +version = "0.3.34" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "0d50a92467f8ba5dd6e3ee5d4bd04d73ab2e4e1c44474a0674821dfce14b79bc" +dependencies = [ + "futures-core", + "futures-macro", + "futures-sink", + "futures-task", + "pin-project-lite", + "slab", +] + +[[package]] +name = "generic-array" +version = "0.14.7" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "85649ca51fd72272d7821adaf274ad91c288277713d9c18820d8499a7ff69e9a" +dependencies = [ + "typenum", + "version_check", +] + +[[package]] +name = "getrandom" +version = "0.3.4" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "899def5c37c4fd7b2664648c28120ecec138e4d395b459e5ca34f9cce2dd77fd" +dependencies = [ + "cfg-if", + "libc", + "r-efi", + "wasip2", +] + +[[package]] +name = "http" +version = "1.5.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "918d3568bebf352712bc2ef3d46a8bcf1a75b373be6539de198e9105cbbf9ce0" +dependencies = [ + "bytes", + "itoa", +] + +[[package]] +name = "http-body" +version = "1.1.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "ca2a8f2913ee65f60facd6a5905613afaa448497a0230cc41ce022d93290bc2c" +dependencies = [ + "bytes", + "http", +] + +[[package]] +name = "http-body-util" +version = "0.1.5" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "23169fe34a5fbcdd3f3862e78fb9b6fccd5f02a6dc6f732547005d45631ce71c" +dependencies = [ + "bytes", + "futures-core", + "http", + "http-body", + "pin-project-lite", +] + +[[package]] +name = "httparse" +version = "1.10.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "6dbf3de79e51f3d586ab4cb9d5c3e2c14aa28ed23d180cf89b4df0454a69cc87" + +[[package]] +name = "httpdate" +version = "1.0.3" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "df3b46402a9d5adb4c86a0cf463f42e19994e3ee891101b1841f30a545cb49a9" + +[[package]] +name = "hyper" +version = "1.12.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "2c3e324da4c95177d6291d4c8730197c0d1822f8a9766814a4a44fa5ab797c9c" +dependencies = [ + "atomic-waker", + "bytes", + "futures-core", + "http", + "http-body", + "httparse", + "httpdate", + "itoa", + "pin-project-lite", + "smallvec", + "tokio", +] + +[[package]] +name = "hyper-util" +version = "0.1.21" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "ddc03d96684f9226b8a787cdb71488417b53ab5ea8fdb1dac946cb9431cc8bff" +dependencies = [ + "bytes", + "http", + "http-body", + "hyper", + "pin-project-lite", + "tokio", + "tower-service", +] + +[[package]] +name = "itoa" +version = "1.0.18" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "8f42a60cbdf9a97f5d2305f08a87dc4e09308d1276d28c869c684d7777685682" + +[[package]] +name = "libc" +version = "0.2.191" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "65cd87c9a6d60536580b316ad985726104730a5151c99845f2490428ef91240a" + +[[package]] +name = "log" +version = "0.4.34" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "f9f8bd3e56ce4dfc153cf470fffbfa98c7620958b312ca5c3a4b8d5181fd13c6" + +[[package]] +name = "matchit" +version = "0.8.4" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "47e1ffaa40ddd1f3ed91f717a33c8c0ee23fff369e3aa8772b9605cc1d22f4c3" + +[[package]] +name = "memchr" +version = "2.8.3" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "cf8baf1c55e62ffcace7a9f06f4bd9cd3f0c4beb022d3b367256b91b87513d98" + +[[package]] +name = "mime" +version = "0.3.17" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "6877bb514081ee2a7ff5ef9de3281f14a4dd4bceac4c09388074a6b5df8a139a" + +[[package]] +name = "mio" +version = "1.2.4" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "1788edb87fdc09c7e26304471e2f5be8cdefb1b6930d6e3985fc02ff53bf86ee" +dependencies = [ + "libc", + "wasi", + "windows-sys", +] + +[[package]] +name = "once_cell" +version = "1.21.4" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "9f7c3e4beb33f85d45ae3e3a1792185706c8e16d043238c593331cc7cd313b50" + +[[package]] +name = "percent-encoding" +version = "2.3.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "9b4f627cb1b25917193a259e49bdad08f671f8d9708acfd5fe0a8c1455d87220" + +[[package]] +name = "pin-project-lite" +version = "0.2.17" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "a89322df9ebe1c1578d689c92318e070967d1042b512afbe49518723f4e6d5cd" + +[[package]] +name = "ppv-lite86" +version = "0.2.21" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "85eae3c4ed2f50dcfe72643da4befc30deadb458a9b590d720cde2f2b1e97da9" +dependencies = [ + "zerocopy", +] + +[[package]] +name = "proc-macro2" +version = "1.0.107" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "985e7ec9bb745e6ce6535b544d84d6cd6f7ad8bd711c398938ae983b91a766d9" +dependencies = [ + "unicode-ident", +] + +[[package]] +name = "quote" +version = "1.0.47" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "1fbf4db142a473a8d80c26bbf18454ed458bf8d26c8219c331daecfdbd079001" +dependencies = [ + "proc-macro2", +] + +[[package]] +name = "r-efi" +version = "5.3.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "69cdb34c158ceb288df11e18b4bd39de994f6657d83847bdffdbd7f346754b0f" + +[[package]] +name = "rand" +version = "0.9.5" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "b9ef1d0d795eb7d84685bca4f72f3649f064e6641543d3a8c415898726a57b41" +dependencies = [ + "rand_chacha", + "rand_core", +] + +[[package]] +name = "rand_chacha" +version = "0.9.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "d3022b5f1df60f26e1ffddd6c66e8aa15de382ae63b3a0c1bfc0e4d3e3f325cb" +dependencies = [ + "ppv-lite86", + "rand_core", +] + +[[package]] +name = "rand_core" +version = "0.9.5" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "76afc826de14238e6e8c374ddcc1fa19e374fd8dd986b0d2af0d02377261d83c" +dependencies = [ + "getrandom", +] + +[[package]] +name = "ryu" +version = "1.0.23" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "9774ba4a74de5f7b1c1451ed6cd5285a32eddb5cccb8cc655a4e50009e06477f" + +[[package]] +name = "serde" +version = "1.0.229" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "4148590afebada386688f18773da617792bf2ef03ffc1e4cbd2b1d45b023e0ba" +dependencies = [ + "serde_core", + "serde_derive", +] + +[[package]] +name = "serde_core" +version = "1.0.229" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "67dca2c9c51e58a4791a4b1ed58308b39c64224d349a935ab5039aa360942a48" +dependencies = [ + "serde_derive", +] + +[[package]] +name = "serde_derive" +version = "1.0.229" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "e7a5d71263a5a7d47b41f6b3f06ba276f10cc18b0931f1799f710578e2309348" +dependencies = [ + "proc-macro2", + "quote", + "syn 3.0.9", +] + +[[package]] +name = "serde_json" +version = "1.0.154" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "e7e9cc8b1b85264074fbcc02a88680c4096b1e47df8f739dceb03bf482f04bd6" +dependencies = [ + "itoa", + "memchr", + "serde", + "serde_core", + "zmij", +] + +[[package]] +name = "serde_path_to_error" +version = "0.1.20" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "10a9ff822e371bb5403e391ecd83e182e0e77ba7f6fe0160b795797109d1b457" +dependencies = [ + "itoa", + "serde", + "serde_core", +] + +[[package]] +name = "serde_urlencoded" +version = "0.7.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "d3491c14715ca2294c4d6a88f15e84739788c1d030eed8c110436aafdaa2f3fd" +dependencies = [ + "form_urlencoded", + "itoa", + "ryu", + "serde", +] + +[[package]] +name = "sha1" +version = "0.10.7" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "a978451301f4db1d02937a4ab3ccce137717b81826e79b7d49ffe3244a13c3b8" +dependencies = [ + "cfg-if", + "cpufeatures", + "digest", +] + +[[package]] +name = "slab" +version = "0.4.12" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "0c790de23124f9ab44544d7ac05d60440adc586479ce501c1d6d7da3cd8c9cf5" + +[[package]] +name = "smallvec" +version = "1.16.3" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "5b3dc8af474f516a851ff4bd12db780f948b9250ad37211e4eec0bccea54e01b" + +[[package]] +name = "socket2" +version = "0.6.5" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "c3d1e2c7f27f8d4cb10542a02c49005dbd6e93095799d6f3be745fae9f8fedd4" +dependencies = [ + "libc", + "windows-sys", +] + +[[package]] +name = "syn" +version = "2.0.119" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "872831b642d1a07999a962a351ed35b955ea2cfc8f3862091e2a240a84f17297" +dependencies = [ + "proc-macro2", + "quote", + "unicode-ident", +] + +[[package]] +name = "syn" +version = "3.0.9" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "d78c8dee4c7bf0e14673097256fed6142ce9d3b85a408189d07482442145823b" +dependencies = [ + "proc-macro2", + "quote", + "unicode-ident", +] + +[[package]] +name = "sync_wrapper" +version = "1.0.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "0bf256ce5efdfa370213c1dabab5935a12e49f2c58d15e9eac2870d3b4f27263" + +[[package]] +name = "thiserror" +version = "2.0.21" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "09e52cb86a36cede5cb101bf8908837b3e4c6e5e59fe7fd85c23fb56200d189e" +dependencies = [ + "thiserror-impl", +] + +[[package]] +name = "thiserror-impl" +version = "2.0.21" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "fe5197923287db20a58125f0bc85c062f7f2c892de97b18c356f9efb14b28524" +dependencies = [ + "proc-macro2", + "quote", + "syn 3.0.9", +] + +[[package]] +name = "tokio" +version = "1.54.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "b52fd3255258d26fac7264ab5a76b53c13367136dc011d3d6ad4f8ed070396a3" +dependencies = [ + "bytes", + "libc", + "mio", + "pin-project-lite", + "socket2", + "tokio-macros", + "windows-sys", +] + +[[package]] +name = "tokio-macros" +version = "2.7.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "78773a2a397f451582ce068015985c33193cf6dea8b74d2a639fe457b2f07b0e" +dependencies = [ + "proc-macro2", + "quote", + "syn 3.0.9", +] + +[[package]] +name = "tokio-tungstenite" +version = "0.29.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "8f72a05e828585856dacd553fba484c242c46e391fb0e58917c942ee9202915c" +dependencies = [ + "futures-util", + "log", + "tokio", + "tungstenite", +] + +[[package]] +name = "tower" +version = "0.5.3" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "ebe5ef63511595f1344e2d5cfa636d973292adc0eec1f0ad45fae9f0851ab1d4" +dependencies = [ + "futures-core", + "futures-util", + "pin-project-lite", + "sync_wrapper", + "tokio", + "tower-layer", + "tower-service", + "tracing", +] + +[[package]] +name = "tower-layer" +version = "0.3.3" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "121c2a6cda46980bb0fcd1647ffaf6cd3fc79a013de288782836f6df9c48780e" + +[[package]] +name = "tower-service" +version = "0.3.3" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "8df9b6e13f2d32c91b9bd719c00d1958837bc7dec474d94952798cc8e69eeec3" + +[[package]] +name = "tracing" +version = "0.1.44" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "63e71662fa4b2a2c3a26f570f037eb95bb1f85397f3cd8076caed2f026a6d100" +dependencies = [ + "log", + "pin-project-lite", + "tracing-core", +] + +[[package]] +name = "tracing-core" +version = "0.1.36" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "db97caf9d906fbde555dd62fa95ddba9eecfd14cb388e4f491a66d74cd5fb79a" +dependencies = [ + "once_cell", +] + +[[package]] +name = "tungstenite" +version = "0.29.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "6c01152af293afb9c7c2a57e4b559c5620b421f6d133261c60dd2d0cdb38e6b8" +dependencies = [ + "bytes", + "data-encoding", + "http", + "httparse", + "log", + "rand", + "sha1", + "thiserror", +] + +[[package]] +name = "typenum" +version = "1.20.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "b6f5e870be6c3b371b77fe0ee0bafb859fa4964b4404c27de1d380043c4dda20" + +[[package]] +name = "unicode-ident" +version = "1.0.27" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "a2c754d6c33795a1c324727428e5a7dedb5b06195f9890bdbcba760d3e246563" + +[[package]] +name = "version_check" +version = "0.9.5" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "0b928f33d975fc6ad9f86c8f283853ad26bdd5b10b7f1542aa2fa15e2289105a" + +[[package]] +name = "wasi" +version = "0.11.1+wasi-snapshot-preview1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "ccf3ec651a847eb01de73ccad15eb7d99f80485de043efb2f370cd654f4ea44b" + +[[package]] +name = "wasip2" +version = "1.0.4+wasi-0.2.12" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "b67efb37e106e55ce722a510d6b5f9c17f083e5fc79afc2badeb12cc313d9487" +dependencies = [ + "wit-bindgen", +] + +[[package]] +name = "windows-link" +version = "0.2.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "f0805222e57f7521d6a62e36fa9163bc891acd422f971defe97d64e70d0a4fe5" + +[[package]] +name = "windows-sys" +version = "0.61.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "ae137229bcbd6cdf0f7b80a31df61766145077ddf49416a728b02cb3921ff3fc" +dependencies = [ + "windows-link", +] + +[[package]] +name = "wit-bindgen" +version = "0.57.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "1ebf944e87a7c253233ad6766e082e3cd714b5d03812acc24c318f549614536e" + +[[package]] +name = "zerocopy" +version = "0.8.63" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "e5fe1f8f1b06191a00962174c61aa5005e0bb391a6d80d07e24d115c01a92ed8" +dependencies = [ + "zerocopy-derive", +] + +[[package]] +name = "zerocopy-derive" +version = "0.8.63" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "863ad3ac83293fb4d740aedbfdc9240dd8d1a50c1099acd76ce80ce7c7230c7f" +dependencies = [ + "proc-macro2", + "quote", + "syn 2.0.119", +] + +[[package]] +name = "zmij" +version = "1.0.23" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "29666d0abbfad1e3dc4dcf6144730dd3a3ab225bbbdac83319345b1b44ccfc1b" diff --git a/Cargo.toml b/Cargo.toml new file mode 100644 index 0000000..135e28e --- /dev/null +++ b/Cargo.toml @@ -0,0 +1,22 @@ +[package] +name = "cngo" +version = "1.0.0" +edition = "2021" +description = "围棋在线对战:Rust 服务端 + 纯静态 HTML 前端" +license = "MIT" + +[dependencies] +axum = { version = "0.8", features = ["ws"] } +tokio = { version = "1", features = ["rt-multi-thread", "macros", "net", "time", "sync"] } +serde = { version = "1", features = ["derive"] } +serde_json = "1" +futures-util = "0.3" + +[dev-dependencies] +# 跟 axum 内部用的 tungstenite 同版本,省一次重复编译 +tokio-tungstenite = "0.29" + +[profile.release] +lto = "thin" +codegen-units = 1 +strip = true diff --git a/README.md b/README.md new file mode 100644 index 0000000..1924312 --- /dev/null +++ b/README.md @@ -0,0 +1,185 @@ +# 围棋 · 在线对战 + +两个人用各自的电脑 / 平板打开网页就能下围棋。**Rust 后端 + 纯静态 HTML 前端**,服务端权威校验落子(提子、禁自杀、打劫、数子全在服务端算),不装 App、不注册账号、前端零构建。 + +``` +浏览器 A ──┐ ┌── 规则引擎(提子 / 禁自杀 / 全局同形 / 数子 / 计时) + ├── WebSocket ────┤ +浏览器 B ──┘ └── 房间状态(棋盘 + 棋盘时钟 + 观战者 + 语音) + └── 观战者 + +Rust(axum + tokio) public/ 里的 html/css/js 由同一个进程托管 +``` + +![桌面版对局](docs/shot-desktop.jpg) + +

+ 建房 + 数子终局 + 手机竖屏 +

+ +## 跑起来 + +需要 Rust 工具链(`cargo` 1.75+)。 + +```bash +cargo run --release # 或 cargo run 走 debug,编译更快 +``` + +然后打开 (默认端口 3100,避开象棋项目的 3000;要改就 `PORT=3200 cargo run`)。 + +首次编译约 2~4 分钟(拉依赖 + 编 axum/tokio),之后增量编译几秒。 + +## 两个人怎么玩 + +**同一个 Wi-Fi(最简单)** + +1. 你在电脑上打开 `http://localhost:3100`,选好棋盘大小(9 / 13 / 19 路)和每方时间,点「创建房间」,屏幕上会出现 4 位房号。 +2. 终端启动服务时会顺便打印局域网地址,比如 `http://192.168.1.8:3100`。 +3. 对方在平板 / 另一台电脑上打开这个地址,输入房号,点「加入」。 +4. 黑先白后,白方看到的棋盘会自动旋转 180°,1 路始终在自己这边。 + +**看别人下棋** + +输入房号点「只看」,就进入观战;两个座位都有人时,点「加入」也会自动变成观战。观战者能看到实时棋局、手数和双方剩余时间,但动不了棋盘。 + +**不在同一个 Wi-Fi** + +把编译出的单文件二进制丢到有公网 IP 的服务器上(见下一节),`PORT=3100 ./cngo`。用 Nginx/Caddy 反代时记得放行 WebSocket 的 `Upgrade` 头: + +```nginx +location / { + proxy_pass http://127.0.0.1:3100; + proxy_http_version 1.1; + proxy_set_header Upgrade $http_upgrade; + proxy_set_header Connection "upgrade"; + proxy_set_header Host $host; +} +``` + +## 编译成单文件程序 + +```bash +cargo build --release +``` + +产物:`target/release/cngo`(自带 HTTP/WS 服务 + 内嵌前端资源,不依赖任何运行时)。 + +`build.rs` 会把 `public/` 整个目录编译进二进制,所以拷到没装任何东西的电脑 / NAS / 树莓派上直接跑; +`/health` 里能看到 `"engine":"rust"`、`"game":"go"`、`"mode":"embedded"`。 + +- 默认只编「当前系统 + 当前架构」。要给 Linux x86_64 用,就在 Linux 上 `cargo build --release`, + 或用 `cargo zigbuild` / 交叉工具链。 +- 前端资源已内嵌,但**程序同目录若存在 `public/`,会优先用磁盘上的版本**,方便临时改页面。 + +## 改前端不用编译 + +`public/` 里的 `index.html`、`style.css`、`js/**/*.js` 就是最终产物,浏览器直接加载 ES module: + +``` +public/ + index.html 页面骨架 + style.css 样式(深色 + 木色棋盘) + js/shared/rules.js 规则引擎的浏览器副本(本地双人模式、落点校验) + js/client/board.js Canvas 棋盘绘制:木板木纹、星位、坐标、棋子高光、落点预览 + js/client/main.js 界面状态、联机逻辑、计时、断线重连、终局数子展示、语音界面 + js/client/sound.js WebAudio 现场合成的落子声(噪声脉冲,无音频文件) + js/client/voice.js 按住说话的录音(MediaRecorder)、base64 编解码、播放 +``` + +改完存盘刷新即可(服务端对静态资源发 `Cache-Control: no-cache`)。 +注意 `js/shared/rules.js` 是 `src/rules.rs` 的 JS 镜像:**改规则要两边一起改**, +服务端才是权威,前端那份只负责「点下去之前先告诉你能不能下」。 + +## 代码结构 + +``` +src/rules.rs 规则引擎:气与棋块、提子、禁自杀、全局同形(超级劫)、数子、坐标记法 +src/protocol.rs WebSocket 消息类型(serde 序列化,与 public/js 里的 JSON 契约一致) +src/server.rs 房间管理 + 权威校验 + 棋盘时钟 + 观战席 + 静态文件服务 +src/main.rs 启动、端口/绑定地址、局域网地址打印 +build.rs 把 public/ 压成资源表编进二进制 +tests/e2e.rs 双客户端联机流程(含提子、观战、停一手数子、认输、再来一局、静态资源、语音) +``` + +## 测试 + +```bash +cargo test +``` + +- `rules::tests` —— 15 组规则断言(提单子/整块、禁自杀、提子优先于自杀、角上提子、超级劫、 + 数子与贴目、坐标记法跳过 I、编码往返、气数计算) +- `tests/e2e.rs` —— 5 组联机断言(建房→加入→落子→抢手被拒→重复落点被拒→观战禁下→停两手数子→再来一局; + 角上提子与认输;未知房号;`/health` 与静态资源;语音收发/历史取回/观战禁发/超长拒绝) + +单跑某一组:`cargo test superko` / `cargo test --test e2e`。 + +## 规则口径 + +按**中国规则(数子 / 面积计算)**实现,够两个人下棋用,不做裁判级抠细节: + +| 事情 | 怎么判 | +| --- | --- | +| 提子 | 落子后对方某块棋气为 0,整块提掉,被提的子计入本方「提子数」 | +| 禁着点 | 落子后自己这块没气、又提不到对方子 → 不合法(自杀禁止) | +| 打劫 | 全局同形禁止(超级劫):任何让局面与之前完全相同的着法都不合法,提示「先到别处应一手」 | +| 停一手 | 右侧「停一手」或按 `P`;双方各停一手即终局 | +| 终局 | 数子:本方活子数 + 只被本方围住的空点;白贴 7.5 目(3 又 3/4 子) | +| 超时 | 时间归零判负;有一方掉线时计时自动暂停,不算他输 | +| 重开 | 双方都点「再来一局」才重开(对手已离开时直接重开) | +| 认输 | 右侧「认输」 | +| 掉线 | 重新打开邀请链接,会回到原来坐的那一边 | + +**数子的简化**:双活(seki)里的空点按「双方都能进」记为中性,不给任何一方; +死子不会自动识别为死子 —— 所以终局前请自己把死子提干净,或者干脆下到没有争议再双方停手。 +真要精确判定死活,得接一个死活判定引擎,见「还没做的」。 + +## 玩法细节 + +| 做的事情 | 怎么操作 | +| --- | --- | +| 落子 | 点交叉点就落;鼠标悬停会先显示一颗半透明的子,点偏了也算最近的交叉点 | +| 提子 | 目标点周围对方棋块没气时自动提,落子声会变成连响,右侧「提 N」会加 | +| 停一手 | 右侧「停一手」或键盘 `P` | +| 计时 | 建房时选 10 / 20 / 40 分钟或不限时;每方各自扣时,落子或停手后换对方 | +| 手数 | 棋谱按手数两列排,带 `提N` 标记;坐标用围棋习惯记法(跳过字母 I) | +| 上一手 | 棋盘上用红点标出最后一手的位置 | +| 观战 | 右侧显示观战人数;观战者不能落子、不能发语音 | + +## 语音互动 + +棋盘右侧面板下方就是语音区,不用切换页面: + +- **按住「按住说话」**(鼠标 / 手指都行)开始录,**松手自动发**;最长 30 秒,到点自动停并发出。 +- 对方收到立刻播放,同时进「互动记录」列表;发的人自己不回放。 +- 点列表里任意一条就放那条,再点一次停。列表带发送方(黑/白)、时长和时刻。 +- 观战者能听、能点历史,但不能发(按钮会提示「观战中只能听」);本地双人模式没有语音。 + +实现上:浏览器 `MediaRecorder` 录成 **webm/opus**(Safari 落到 `audio/mp4`),base64 后走同一条 WebSocket。 +服务端把每条语音的**元信息**放进房间状态,音频本体只在发的那一刻广播一次、点历史时用 `voiceGet` 单独取。 +房间内保留最近 **40 条**、总量约 12MB(base64 后),超出丢最旧的;每局「再来一局」会清空语音记录。 + +> 跨内核播放:Chrome/Firefox 录的是 webm/opus,Safari 播不了 webm,Safari 录的 mp4 反过来 Chrome 能播。 +> 所以跨平台对局可能遇到「对方发的听不见」——需要服务端转码才能彻底解决,目前没做。 + +## 还没做的 + +- 死活判定与死子自动标记(现在的数子只做「子 + 空」的静态统计) +- 让子局 / 贴目自定义(现在固定 7.5 目,黑先) +- 悔棋、棋谱回放、SGF 导入导出 +- 读秒(现在只有一次性包干时间) +- 语音转码(webm ↔ mp4)与语音落盘:目前只在内存里,重启即清 +- 棋局持久化:服务端所有棋局都在内存里,重启就清空(空房 10 分钟回收,有人的房 4 小时) +- 多进程 / 多机部署(房间在进程内存里,要横向扩得先接 Redis 之类的外置状态) + +## 依赖下载 / 编译加速(本机已配,遵循 dev-cache-layout) + +- 依赖走 **USTC sparse 镜像**,包缓存实体集中在 `~/.cache/cargo/registry`(`~/.cargo/registry` 是软链指向它)。 +- 编译包了一层 **sccache**(`rustc-wrapper`,实体 `~/.cache/sccache`),冷启动 / 清 target 重建能省三分之一时间。 +- `jobs = 3`:本机 2 核 4 线程 8G 内存的安全上限,别调 4。 +- 配置都在 `~/.cargo/config.toml`,仓库里**不需要**再放 `.cargo/config.toml`。 +- **`target/` 留在项目目录**(增量编译 + 复查用),已在 `.gitignore`;不要挪到 `~/Library/Caches` 再软链回来 + —— 软链不被 `.gitignore` 的目录型规则匹配,`git status` 会冒 `??`,而且缓存脱离项目生命周期。 +- 前端零构建(原生 ES module),**没有 npm / node_modules / 打包缓存**,不需要给这个项目单独配包缓存。 diff --git a/build.rs b/build.rs new file mode 100644 index 0000000..acc5535 --- /dev/null +++ b/build.rs @@ -0,0 +1,62 @@ +//! 把 public/ 整个目录编译进二进制:`cargo build --release` 出来的是单文件, +//! 拷到别的机器上不用带 public/ 也能跑;同时运行期仍然优先读磁盘,方便改页面。 + +use std::fmt::Write as _; +use std::path::{Path, PathBuf}; +use std::{env, fs}; + +fn mime_of(name: &str) -> &'static str { + match name.rsplit('.').next().unwrap_or("").to_ascii_lowercase().as_str() { + "html" | "htm" => "text/html; charset=utf-8", + "js" | "mjs" => "text/javascript; charset=utf-8", + "css" => "text/css; charset=utf-8", + "json" | "webmanifest" => "application/json; charset=utf-8", + "png" => "image/png", + "jpg" | "jpeg" => "image/jpeg", + "svg" => "image/svg+xml", + "ico" => "image/x-icon", + "woff2" => "font/woff2", + "mp3" => "audio/mpeg", + "webp" => "image/webp", + _ => "application/octet-stream", + } +} + +fn walk(dir: &Path, out: &mut Vec) { + let Ok(rd) = fs::read_dir(dir) else { return }; + for entry in rd.flatten() { + let p = entry.path(); + if p.is_dir() { + walk(&p, out); + } else { + out.push(p); + } + } +} + +fn main() { + let manifest = PathBuf::from(env::var("CARGO_MANIFEST_DIR").unwrap()); + let public = manifest.join("public"); + println!("cargo:rerun-if-changed=public"); + + let mut files = Vec::new(); + walk(&public, &mut files); + files.sort(); + + let mut src = String::from("// 由 build.rs 生成,勿手改\npub static ASSETS: &[(&str, &str, &[u8])] = &[\n"); + for f in &files { + let rel = f.strip_prefix(&public).unwrap().to_string_lossy().replace('\\', "/"); + let key = format!("/{rel}"); + let mime = mime_of(&rel); + writeln!( + src, + " ({key:?}, {mime:?}, include_bytes!({:?})),", + f.to_string_lossy() + ) + .unwrap(); + } + src.push_str("];\n"); + + let out = PathBuf::from(env::var("OUT_DIR").unwrap()).join("assets_gen.rs"); + fs::write(out, src).unwrap(); +} diff --git a/docs/shot-desktop.jpg b/docs/shot-desktop.jpg new file mode 100644 index 0000000..258835f Binary files /dev/null and b/docs/shot-desktop.jpg differ diff --git a/docs/shot-mobile.jpg b/docs/shot-mobile.jpg new file mode 100644 index 0000000..5011f12 Binary files /dev/null and b/docs/shot-mobile.jpg differ diff --git a/docs/shot-room.jpg b/docs/shot-room.jpg new file mode 100644 index 0000000..6571245 Binary files /dev/null and b/docs/shot-room.jpg differ diff --git a/docs/shot-score.jpg b/docs/shot-score.jpg new file mode 100644 index 0000000..c98832c Binary files /dev/null and b/docs/shot-score.jpg differ diff --git a/public/index.html b/public/index.html new file mode 100644 index 0000000..8a1ff86 --- /dev/null +++ b/public/index.html @@ -0,0 +1,187 @@ + + + + + + + 围棋 · 在线对战 + + + + +
+
+
+ 弈 +
+

围棋

+

两台设备 · 在线对战

+
+
+ + + +
+ + 未连接 +
+
+ +
+
+
+ +
+ + +
+ + +
+
+ +
+
+
+ 弈 +

围棋 · 在线对战

+

一个人开房间,另一个人输房号进来。黑先白后,双方各停一手就数子。

+
+ +
+ 棋盘 +
+ + + +
+
+ +
+ 每方时间 +
+ + + + +
+
+ + + +
或者加入朋友的房间
+ +
+ + + +
+

两个座位都有人时会自动变成观战,只能看、不能落子。

+ + + +
    +
  • 点交叉点就落子,鼠标悬停会先给你看一颗半透明的子。
  • +
  • 围住对方一块棋、让它没气,整块提掉;下下去自己没气就是禁着点。
  • +
  • 打劫不能立刻提回,全局同形禁止(超级劫)——先去别处应一手。
  • +
  • 双方各点一次「停一手」即终局,按中国规则数子,白贴 7.5 目。
  • +
  • 白方看到的棋盘会翻过来,1 路始终在自己这边。
  • +
+
+
+ +
+ + + + diff --git a/public/js/client/board.js b/public/js/client/board.js new file mode 100644 index 0000000..498d4fc --- /dev/null +++ b/public/js/client/board.js @@ -0,0 +1,208 @@ +import { BLACK, COLS, WHITE, starPoints } from '../shared/rules.js'; + +/** + * 棋盘绘制:木板 + 网格 + 星位 + 棋子。 + * 坐标换算都收在这里,main.js 只管「点到第几个交叉点」。 + */ + +/** 让棋盘在给定宽度内铺满,同时留出坐标标签的位置 */ +export function computeView(cssWidth, size) { + const cell = Math.max(11, Math.floor(cssWidth / (size + 0.6))); + const margin = Math.round(cell * 0.8); + const width = cell * (size - 1) + margin * 2; + return { cell, margin, size, width, height: width, flipped: false }; +} + +/** 棋盘交叉点 -> 画布坐标(含黑白翻转) */ +export function toScreen(v, x, y) { + const bx = v.flipped ? v.size - 1 - x : x; + const by = v.flipped ? v.size - 1 - y : y; + return [v.margin + bx * v.cell, v.margin + by * v.cell]; +} + +/** 画布坐标 -> 棋盘上的浮点坐标(取整交给 nearestPoint) */ +export function toBoard(v, px, py) { + const bx = (px - v.margin) / v.cell; + const by = (py - v.margin) / v.cell; + const x = v.flipped ? v.size - 1 - bx : bx; + const y = v.flipped ? v.size - 1 - by : by; + return [x, y]; +} + +export function draw(ctx, v, st) { + const { cell } = v; + ctx.clearRect(0, 0, v.width, v.height); + drawBoardBase(ctx, v); + + // 棋子 + for (let i = 0; i < st.board.length; i++) { + const stone = st.board[i]; + if (!stone) continue; + const [sx, sy] = toScreen(v, i % v.size, Math.floor(i / v.size)); + drawStone(ctx, v, sx, sy, stone); + } + + // 上一手 + if (st.last != null && st.last >= 0) { + const [sx, sy] = toScreen(v, st.last % v.size, Math.floor(st.last / v.size)); + ctx.beginPath(); + ctx.arc(sx, sy, Math.max(2, cell * 0.13), 0, Math.PI * 2); + ctx.fillStyle = 'rgba(214, 62, 48, 0.95)'; + ctx.fill(); + ctx.beginPath(); + ctx.arc(sx, sy, Math.max(3.5, cell * 0.2), 0, Math.PI * 2); + ctx.strokeStyle = 'rgba(214, 62, 48, 0.55)'; + ctx.lineWidth = Math.max(1, cell * 0.045); + ctx.stroke(); + } + + // 落点预览 + if (st.hover != null && st.hover >= 0 && st.board[st.hover] === 0 && st.ghost) { + const [sx, sy] = toScreen(v, st.hover % v.size, Math.floor(st.hover / v.size)); + ctx.save(); + ctx.globalAlpha = 0.45; + drawStone(ctx, v, sx, sy, st.ghost === 'b' ? BLACK : WHITE); + ctx.restore(); + ctx.beginPath(); + ctx.arc(sx, sy, cell * 0.47, 0, Math.PI * 2); + ctx.strokeStyle = st.ghost === 'b' ? 'rgba(30,30,30,0.5)' : 'rgba(255,255,255,0.65)'; + ctx.lineWidth = Math.max(1, cell * 0.05); + ctx.stroke(); + } +} + +/* ------------------------------- 木板与网格 ------------------------------- */ + +function drawBoardBase(ctx, v) { + const { cell, margin, size } = v; + const x0 = margin; + const y0 = margin; + const x1 = margin + (size - 1) * cell; + const y1 = margin + (size - 1) * cell; + + // 木色底 + const g = ctx.createLinearGradient(0, 0, v.width, v.height); + g.addColorStop(0, '#e9c88f'); + g.addColorStop(0.45, '#dfb877'); + g.addColorStop(1, '#cfa361'); + ctx.fillStyle = g; + ctx.fillRect(0, 0, v.width, v.height); + + // 木纹 + ctx.save(); + ctx.globalAlpha = 0.07; + ctx.strokeStyle = '#7a5628'; + for (let i = 0; i < 22; i++) { + const yy = (i / 22) * v.height + Math.sin(i * 1.9) * 5; + ctx.beginPath(); + ctx.moveTo(0, yy); + ctx.bezierCurveTo(v.width * 0.3, yy + 8, v.width * 0.7, yy - 8, v.width, yy + 2); + ctx.lineWidth = 1 + (i % 3) * 0.5; + ctx.stroke(); + } + ctx.restore(); + + // 外框(比网格线粗一点) + const pad = cell * 0.34; + ctx.strokeStyle = 'rgba(88,58,22,0.8)'; + ctx.lineWidth = Math.max(1.5, cell * 0.05); + ctx.strokeRect(x0 - pad, y0 - pad, x1 - x0 + pad * 2, y1 - y0 + pad * 2); + + // 网格 + ctx.strokeStyle = 'rgba(74,48,16,0.82)'; + ctx.lineWidth = Math.max(1, cell * 0.035); + ctx.beginPath(); + for (let i = 0; i < size; i++) { + const p = margin + i * cell; + ctx.moveTo(x0, p); + ctx.lineTo(x1, p); + ctx.moveTo(p, y0); + ctx.lineTo(p, y1); + } + ctx.stroke(); + + // 星位 + const star = starPoints(size); + if (star.length) { + ctx.fillStyle = 'rgba(62,40,14,0.9)'; + const r = Math.max(1.6, cell * 0.075); + for (const i of star) { + const [sx, sy] = toScreen(v, i % size, Math.floor(i / size)); + ctx.beginPath(); + ctx.arc(sx, sy, r, 0, Math.PI * 2); + ctx.fill(); + } + } + + // 坐标(太小就不画,免得糊成一团) + // 标签按「画布边缘」定位:翻转视角时棋盘坐标会跑到画布外 + const fs = Math.round(cell * 0.36); + if (cell >= 13 && fs >= 7) { + const band = Math.round(cell * 0.24); // 画布边缘到标签中心 + const right = v.width - band; + const bottom = v.height - band; + ctx.save(); + ctx.fillStyle = 'rgba(84,56,22,0.72)'; + ctx.font = `${fs}px -apple-system, system-ui, sans-serif`; + ctx.textAlign = 'center'; + ctx.textBaseline = 'middle'; + for (let i = 0; i < size; i++) { + const [sx] = toScreen(v, i, 0); + ctx.fillText(COLS[i], sx, band); + ctx.fillText(COLS[i], sx, bottom); + const [, sy] = toScreen(v, 0, i); + const row = String(size - i); + ctx.fillText(row, band, sy); + ctx.fillText(row, right, sy); + } + ctx.restore(); + } +} + +/* --------------------------------- 棋子 --------------------------------- */ + +function drawStone(ctx, v, sx, sy, stone) { + const r = v.cell * 0.47; + const isBlack = stone === BLACK; + + // 投影 + ctx.save(); + ctx.shadowColor = 'rgba(50,30,8,0.42)'; + ctx.shadowBlur = v.cell * 0.14; + ctx.shadowOffsetY = v.cell * 0.06; + ctx.beginPath(); + ctx.arc(sx, sy, r, 0, Math.PI * 2); + ctx.fillStyle = isBlack ? '#141414' : '#f7f3e9'; + ctx.fill(); + ctx.restore(); + + // 本体(一点高光,做出蛤碁石 / 那智黑的感觉) + const grd = ctx.createRadialGradient( + sx - r * 0.34, + sy - r * 0.38, + r * 0.12, + sx, + sy, + r * 1.02, + ); + if (isBlack) { + grd.addColorStop(0, '#6b6b6b'); + grd.addColorStop(0.42, '#2b2b2b'); + grd.addColorStop(1, '#08080a'); + } else { + grd.addColorStop(0, '#ffffff'); + grd.addColorStop(0.58, '#f5f1e6'); + grd.addColorStop(1, '#cdc4b2'); + } + ctx.beginPath(); + ctx.arc(sx, sy, r, 0, Math.PI * 2); + ctx.fillStyle = grd; + ctx.fill(); + + // 边缘 + ctx.beginPath(); + ctx.arc(sx, sy, r, 0, Math.PI * 2); + ctx.strokeStyle = isBlack ? 'rgba(0,0,0,0.7)' : 'rgba(120,105,80,0.55)'; + ctx.lineWidth = Math.max(0.6, v.cell * 0.025); + ctx.stroke(); +} diff --git a/public/js/client/main.js b/public/js/client/main.js new file mode 100644 index 0000000..fe0cdfa --- /dev/null +++ b/public/js/client/main.js @@ -0,0 +1,1154 @@ +import { + KOMI, + coordName, + decodeBoard, + isSuperko, + nearestPoint, + other, + play, + positionKey, + scoreArea, +} from '../shared/rules.js'; +import { computeView, draw, toBoard } from './board.js'; +import { sfx, unlockAudio } from './sound.js'; +import { Recorder, blobToBase64, base64ToUrl, isSupported, MAX_SECONDS } from './voice.js'; + +/* ------------------------------- DOM 快捷方式 ------------------------------- */ +const $ = (id) => { + const el = document.getElementById(id); + if (!el) throw new Error('missing element: ' + id); + return el; +}; +const canvas = $('board'); +const holder = $('holder'); +const ctx = canvas.getContext('2d'); + +/* -------------------------------- 状态 -------------------------------- */ +let mode = null; // 'online' | 'local' | null +let game = null; +let you = null; +let spec = false; +let code = null; +let hover = null; +let view = computeView(360, 19); +let totalMs = 0; +let spectatorCount = 0; +let clockBase = { b: 0, w: 0 }; +let clockStamp = 0; +let clockRunning = false; +let selectedMinutes = 20; +let selectedSize = 19; +let localKeys = []; + +/* -------------------------------- 语音互动 -------------------------------- */ +let voiceList = []; +let voiceRoom = null; +const voiceCache = new Map(); +let audioEl = null; +let playingId = null; +let pendingPlay = null; +let rec = null; +let recording = false; +let pressing = false; +let recStart = 0; +let recTimer = null; +let recLimit = null; + +/* -------------------------------- 网络层 -------------------------------- */ +let ws = null; +let conn = 'idle'; +let wantRoom = null; +let reconnectTimer = null; +let reconnectAttempts = 0; +let queue = []; + +function wsUrl() { + const proto = location.protocol === 'https:' ? 'wss:' : 'ws:'; + return `${proto}//${location.host}/ws`; +} + +function setConn(next) { + conn = next; + const dot = $('status').querySelector('.dot'); + dot.className = 'dot ' + next; + const label = + next === 'open' + ? '已连接' + : next === 'connecting' + ? '连接中…' + : next === 'closed' + ? '断开' + : '未连接'; + $('statusText').textContent = label; +} + +function connect() { + if (ws && (ws.readyState === WebSocket.OPEN || ws.readyState === WebSocket.CONNECTING)) return; + setConn('connecting'); + let sock; + try { + sock = new WebSocket(wsUrl()); + } catch { + setConn('closed'); + return; + } + ws = sock; + sock.onopen = () => { + setConn('open'); + reconnectAttempts = 0; + const pending = queue.slice(); + queue = []; + pending.forEach(send); + if (wantRoom) send(roomRequest()); + }; + sock.onmessage = (ev) => { + let msg; + try { + msg = JSON.parse(String(ev.data)); + } catch { + return; + } + handleServer(msg); + }; + sock.onclose = () => { + setConn('closed'); + if (mode === 'online' && wantRoom) scheduleReconnect(); + }; +} + +function roomRequest() { + if (!wantRoom) return { t: 'ping' }; + if (wantRoom.code) return { t: 'join', code: wantRoom.code, spectate: wantRoom.spectate }; + return { + t: 'create', + minutes: wantRoom.minutes ?? selectedMinutes, + size: wantRoom.size ?? selectedSize, + }; +} + +function scheduleReconnect() { + if (reconnectTimer !== null) return; + if (reconnectAttempts >= 12) { + toast('连接断开太久了,先回大厅吧'); + return; + } + const delay = Math.min(5000, 700 * Math.pow(1.5, reconnectAttempts)); + reconnectAttempts++; + reconnectTimer = window.setTimeout(() => { + reconnectTimer = null; + connect(); + }, delay); +} + +function send(msg) { + if (ws && ws.readyState === WebSocket.OPEN) ws.send(JSON.stringify(msg)); + else queue.push(msg); +} + +function handleServer(msg) { + if (msg.t === 'error') { + toast(msg.msg); + return; + } + if (msg.t === 'left') { + toLobby(); + return; + } + if (msg.t === 'clock') { + clockBase = { b: msg.clocks.b, w: msg.clocks.w }; + clockStamp = performance.now(); + updateClocks(); + return; + } + if (msg.t === 'voice') { + onVoice(msg); + return; + } + if (msg.t === 'voiceData') { + onVoiceData(msg); + return; + } + applyState(msg); +} + +/* ------------------------------ 状态 -> 界面 ------------------------------ */ +function lastAt(history) { + for (let i = history.length - 1; i >= 0; i--) { + if (history[i].at != null) return history[i].at; + } + return null; +} + +function applyState(m) { + const prevHistoryLen = game?.history.length ?? 0; + mode = 'online'; + code = m.code; + you = m.you; + spec = m.spectating; + wantRoom = { code: m.code, spectate: m.spectating }; + totalMs = m.totalMs; + spectatorCount = m.spectators; + + if (voiceRoom !== m.code) { + clearVoiceCache(); + voiceRoom = m.code; + } + voiceList = Array.isArray(m.voices) ? m.voices.slice() : []; + + game = { + size: m.size, + board: decodeBoard(m.board, m.size), + turn: m.turn, + over: m.over, + winner: m.winner, + reason: m.reason, + history: m.history, + players: m.players, + rematch: m.rematch, + captures: m.captures ?? { b: 0, w: 0 }, + score: m.score ?? null, + passes: m.passes ?? 0, + }; + clockBase = { b: m.clocks.b, w: m.clocks.w }; + clockStamp = performance.now(); + clockRunning = + !m.over && m.totalMs > 0 && m.players.b.connected && m.players.w.connected; + hover = null; + + if (m.history.length > prevHistoryLen) { + const last = m.history[m.history.length - 1]; + if (m.over) { + sfx(you && m.winner !== you ? 'lose' : 'win'); + } else if (last.cap > 0) sfx('capture'); + else if (last.at == null) sfx('pass'); + else sfx('move'); + } + + $('lobby').hidden = true; + if (location.hash.toUpperCase() !== '#' + m.code) { + try { + history.replaceState(null, '', '#' + m.code); + } catch { + /* ignore */ + } + } + render(); +} + +function toLobby() { + mode = null; + game = null; + you = null; + spec = false; + code = null; + wantRoom = null; + hover = null; + clockRunning = false; + totalMs = 0; + spectatorCount = 0; + cancelRecording(); + voiceList = []; + voiceRoom = null; + clearVoiceCache(); + stopAudio(); + if (location.hash) { + try { + history.replaceState(null, '', location.pathname); + } catch { + /* ignore */ + } + } + $('lobby').hidden = false; + $('overlay').hidden = true; + $('roomline').hidden = true; + $('moves').innerHTML = ''; + $('notice').hidden = true; + updateChips(); + render(); +} + +function render() { + layout(); + paint(); + if (!game) { + $('roomline').hidden = true; + $('overlay').hidden = true; + renderVoice(); + return; + } + $('roomline').hidden = false; + $('roomTag').textContent = code ? `房号 ${code}` : '本机双人'; + $('copyBtn').hidden = !code; + const opp = you ? other(you) : null; + paintPlayer('pBlack', 'b', you === 'b', opp === 'b'); + paintPlayer('pWhite', 'w', you === 'w', opp === 'w'); + $('capBlack').textContent = `提 ${game.captures.b ?? 0}`; + $('capWhite').textContent = `提 ${game.captures.w ?? 0}`; + + const bar = $('turnbar'); + const who = game.turn === 'b' ? '黑方' : '白方'; + if (game.over) { + bar.className = 'turnbar done'; + bar.textContent = resultTitle(); + } else if (spec) { + bar.className = 'turnbar'; + bar.textContent = `观战中 · ${who}思考中`; + } else if (mode === 'online' && you && game.turn === you) { + bar.className = 'turnbar mine'; + bar.textContent = `轮到你落子(${you === 'b' ? '黑' : '白'})`; + } else if (mode === 'local') { + bar.className = 'turnbar mine'; + bar.textContent = `${who}落子(本机双人)`; + } else { + bar.className = 'turnbar'; + bar.textContent = `${who}思考中…`; + } + + const notice = $('notice'); + if (!game.over && game.passes === 1) { + notice.hidden = false; + notice.textContent = '对方停了一手 —— 你再停一手,双方就终局数子'; + } else { + notice.hidden = true; + } + + paintMoves(); + updateClocks(); + renderVoice(); + + const badge = $('specBadge'); + badge.hidden = !spec && spectatorCount === 0; + badge.textContent = spec + ? `观战中 · ${spectatorCount} 人在看` + : `${spectatorCount} 人观战`; + + $('resignBtn').disabled = game.over || spec; + $('passBtn').disabled = game.over || spec || !myTurn(); + + const opponentMissing = + mode === 'online' && !spec && you !== null && game.players[other(you)].connected === false; + if (game.over) showResultOverlay(); + else if (opponentMissing) showWaitOverlay(); + else $('overlay').hidden = true; +} + +function paintPlayer(id, color, isYou, isOpp) { + const card = $(id); + const g = game; + const connected = g.players[color].connected; + const turnNow = !g.over && g.turn === color; + card.classList.toggle('active', turnNow); + card.classList.toggle('you', isYou); + const tag = isYou ? '你' : isOpp ? '对手' : ''; + card.querySelector('.pname').textContent = + (color === 'b' ? '黑方' : '白方') + (tag ? ` · ${tag}` : ''); + const st = card.querySelector('.pstate'); + st.textContent = g.over + ? g.winner === color + ? '胜' + : g.winner + ? '负' + : '和' + : mode === 'local' + ? turnNow + ? '该落子' + : '等待' + : connected + ? turnNow + ? '该落子' + : '在线' + : '离线'; + card.classList.toggle('offline', mode === 'online' && !connected); +} + +function paintMoves() { + const box = $('moves'); + const h = game?.history ?? []; + if (!h.length) { + box.innerHTML = '
还没有落子记录
'; + return; + } + const rows = []; + for (let i = 0; i < h.length; i += 2) { + const a = h[i]; + const b = h[i + 1]; + const cell = (mv) => { + if (!mv) return ''; + const cap = mv.cap ? `提${mv.cap}` : ''; + return `${mv.note}${cap}`; + }; + rows.push( + `
${i / 2 + 1}` + + `${cell(a)}` + + `${cell(b)}
`, + ); + } + box.innerHTML = rows.join(''); + box.scrollTop = box.scrollHeight; +} + +/* -------------------------------- 计时 -------------------------------- */ +function displayClocks() { + const out = { b: clockBase.b, w: clockBase.w }; + if (clockRunning && game) { + const el = performance.now() - clockStamp; + out[game.turn] = Math.max(0, out[game.turn] - el); + } + return out; +} + +function fmtClock(ms) { + if (totalMs <= 0) return '—'; + const t = Math.max(0, Math.ceil(ms / 1000)); + const h = Math.floor(t / 3600); + const m = Math.floor((t % 3600) / 60); + const s = t % 60; + if (h > 0) return `${h}:${String(m).padStart(2, '0')}:${String(s).padStart(2, '0')}`; + return `${m}:${String(s).padStart(2, '0')}`; +} + +function updateClocks() { + const d = displayClocks(); + const black = $('timeBlack'); + const white = $('timeWhite'); + black.textContent = fmtClock(d.b); + white.textContent = fmtClock(d.w); + const low = (ms) => totalMs > 0 && clockRunning && ms <= 60000; + black.classList.toggle('low', low(d.b)); + white.classList.toggle('low', low(d.w)); +} + +function tick() { + if (!game) return; + if (mode === 'local' && clockRunning && !game.over && totalMs > 0) { + const d = displayClocks(); + if (d[game.turn] <= 0) { + clockRunning = false; + game.over = true; + game.winner = other(game.turn); + game.reason = 'timeout'; + sfx('lose'); + render(); + return; + } + } + updateClocks(); +} + +/* ------------------------------- 结果展示 ------------------------------- */ +const REASON_TEXT = { + scored: '双方停手,数子终局', + resign: '认输', + timeout: '超时', +}; + +function sideName(c) { + return c === 'b' ? '黑方' : c === 'w' ? '白方' : ''; +} + +function resultTitle() { + const g = game; + if (!g.winner) return '和棋'; + if (mode === 'local' || !you) return `${sideName(g.winner)}胜`; + return g.winner === you ? '你赢了' : '你输了'; +} + +function showResultOverlay() { + const g = game; + $('ovWait').hidden = true; + $('ovResult').hidden = false; + $('overlay').hidden = false; + const reason = g.reason ? REASON_TEXT[g.reason] ?? g.reason : ''; + $('ovTitle').textContent = resultTitle(); + $('ovTitle').className = g.winner === 'b' ? 'win-b' : g.winner === 'w' ? 'win-w' : 'win-draw'; + + const bits = []; + if (g.winner) bits.push(`${sideName(g.winner)}获胜`); + if (reason) bits.push(reason); + if (g.captures) { + const total = (g.captures.b ?? 0) + (g.captures.w ?? 0); + if (total > 0) bits.push(`共提 ${total} 子`); + } + $('ovText').textContent = bits.join(' · '); + + const line = $('ovScore'); + if (g.score) { + const s = g.score; + line.hidden = false; + line.innerHTML = + `黑 ${fmtScore(s.black)}` + + `:` + + `白 ${fmtScore(s.white)}` + + `贴 ${s.komi} 目 · ${sideName(s.winner ?? g.winner)}胜 ${fmtScore(s.margin)} 目`; + } else { + line.hidden = true; + } + + const btn = $('ovRematch'); + if (spec) { + btn.hidden = true; + $('ovLobby').textContent = '退出观战'; + return; + } + btn.hidden = false; + $('ovLobby').textContent = '返回大厅'; + const voted = you ? g.rematch.indexOf(you) >= 0 : false; + btn.disabled = voted; + btn.textContent = voted ? '等待对手确认…' : '再来一局'; +} + +function fmtScore(v) { + const n = Number(v) || 0; + return Number.isInteger(n) ? String(n) : n.toFixed(1); +} + +function showWaitOverlay() { + $('ovResult').hidden = true; + $('ovWait').hidden = false; + $('overlay').hidden = false; + $('ovCode').textContent = code ?? '----'; +} + +function toast(text) { + const el = $('toast'); + el.textContent = text; + el.classList.add('show'); + window.clearTimeout(toast._t); + toast._t = window.setTimeout(() => el.classList.remove('show'), 2400); +} + +/* -------------------------------- 画布 -------------------------------- */ +function layout() { + const w = holder.clientWidth || 320; + const size = game?.size ?? selectedSize; + const flipped = mode === 'online' && you === 'w'; + view = computeView(w, size); + view.flipped = flipped; + const dpr = Math.min(window.devicePixelRatio || 1, 3); + canvas.width = Math.round(view.width * dpr); + canvas.height = Math.round(view.height * dpr); + canvas.style.width = view.width + 'px'; + canvas.style.height = view.height + 'px'; + ctx.setTransform(dpr, 0, 0, dpr, 0, 0); +} + +function paint() { + const size = game?.size ?? selectedSize; + const board = game?.board ?? new Uint8Array(size * size); + draw(ctx, view, { + board, + last: game ? lastAt(game.history) : null, + hover, + ghost: myTurn() ? game.turn : null, + }); +} + +/* ------------------------------ 交互逻辑 ------------------------------ */ +function myTurn() { + if (!game || game.over || spec) return false; + if (mode === 'local') return true; + return you !== null && game.turn === you; +} + +function attempt(at) { + if (!game || game.over) return; + if (!myTurn()) { + if (spec) toast('你在观战,不能落子'); + else if (mode === 'online') toast('等一下,还没轮到你'); + return; + } + // 本地先挡一次明显不合法(服务端还会再判一次) + if (game.board[at] !== 0) { + toast('这里已经有子了'); + return; + } + if (mode === 'online') { + send({ t: 'move', at }); + hover = null; + paint(); + } else { + doLocalMove(at); + } +} + +function doPass() { + if (!game || game.over) return; + if (!myTurn()) { + toast('还没轮到你'); + return; + } + if (mode === 'online') { + send({ t: 'pass' }); + return; + } + // 本地双人 + const g = game; + g.passes = (g.passes ?? 0) + 1; + g.history.push({ at: null, note: '停一手', color: g.turn, cap: 0 }); + localKeys.push(positionKey(g.board, other(g.turn))); + g.turn = other(g.turn); + sfx('pass'); + if (g.passes >= 2) { + const s = scoreArea(g.board, g.size, KOMI); + g.over = true; + g.score = s; + g.winner = s.winner; + g.reason = 'scored'; + clockRunning = false; + sfx('win'); + } + render(); +} + +function doLocalMove(at) { + const g = game; + const res = play(g.board, g.size, at, g.turn); + if (!res) { + toast('这里不能下(有子或者是禁着点)'); + return; + } + const key = positionKey(res.board, other(g.turn)); + if (isSuperko(localKeys, key)) { + toast('打劫:不能立刻下回同一个局面,先到别处应一手'); + return; + } + if (totalMs > 0 && clockRunning) { + clockBase = displayClocks(); + clockStamp = performance.now(); + } + g.board = res.board; + g.captures[g.turn] = (g.captures[g.turn] ?? 0) + res.captured.length; + g.history.push({ + at, + note: coordName(g.size, at), + color: g.turn, + cap: res.captured.length, + }); + g.passes = 0; + localKeys.push(key); + g.turn = other(g.turn); + hover = null; + if (res.captured.length) sfx('capture'); + else sfx('move'); + render(); +} + +function pointAt(ev) { + const rect = canvas.getBoundingClientRect(); + const px = ((ev.clientX - rect.left) / rect.width) * view.width; + const py = ((ev.clientY - rect.top) / rect.height) * view.height; + const [bx, by] = toBoard(view, px, py); + return nearestPoint(view.size, bx, by, 0.55); +} + +function onPointerDown(ev) { + ev.preventDefault(); + unlockAudio(); + if (!game || game.over) return; + const at = pointAt(ev); + if (at == null) return; + attempt(at); +} + +function onPointerMove(ev) { + if (ev.pointerType !== 'mouse' || !game || game.over || !myTurn()) { + if (hover !== null) { + hover = null; + paint(); + } + return; + } + const at = pointAt(ev); + const next = at != null && game.board[at] === 0 ? at : null; + if (next !== hover) { + hover = next; + paint(); + } +} + +function onPointerLeave() { + if (hover !== null) { + hover = null; + paint(); + } +} + +/* ------------------------------- 本地双人 ------------------------------- */ +function startLocal() { + unlockAudio(); + mode = 'local'; + you = null; + spec = false; + code = null; + wantRoom = null; + hover = null; + totalMs = selectedMinutes > 0 ? selectedMinutes * 60 * 1000 : 0; + clockBase = { b: totalMs, w: totalMs }; + clockStamp = performance.now(); + clockRunning = totalMs > 0; + spectatorCount = 0; + const size = selectedSize; + const board = new Uint8Array(size * size); + localKeys = [positionKey(board, 'b')]; + game = { + size, + board, + turn: 'b', + over: false, + history: [], + players: { + b: { connected: true, name: '黑方' }, + w: { connected: true, name: '白方' }, + }, + rematch: [], + captures: { b: 0, w: 0 }, + passes: 0, + score: null, + }; + $('lobby').hidden = true; + $('overlay').hidden = true; + render(); +} + +/* -------------------------------- 大厅 -------------------------------- */ +function createRoom() { + unlockAudio(); + mode = 'online'; + requestRoom({ minutes: selectedMinutes, size: selectedSize, spectate: false }); +} + +function joinRoom(raw, spectate = false) { + const c = raw.replace(/[^0-9a-zA-Z]/g, '').toUpperCase(); + if (c.length < 4) { + toast('房号是 4 位,检查一下'); + return; + } + unlockAudio(); + mode = 'online'; + requestRoom({ code: c, spectate }); +} + +/** 统一入口:记住想去哪个房间,连上就自动发请求(断线重连也走这条路) */ +function requestRoom(req) { + wantRoom = req; + if (conn === 'open') send(roomRequest()); + else connect(); +} + +function updateChips() { + document.querySelectorAll('#tcRow .chip').forEach((el) => { + el.classList.toggle('on', Number(el.dataset.min) === selectedMinutes); + }); + document.querySelectorAll('#sizeRow .chip').forEach((el) => { + el.classList.toggle('on', Number(el.dataset.size) === selectedSize); + }); +} + +function inviteLink() { + return `${location.origin}${location.pathname}#${code ?? ''}`; +} + +async function copyInvite() { + const text = inviteLink(); + try { + await navigator.clipboard.writeText(text); + toast('邀请链接已复制'); + } catch { + const ta = document.createElement('textarea'); + ta.value = text; + document.body.appendChild(ta); + ta.select(); + try { + document.execCommand('copy'); + toast('邀请链接已复制'); + } catch { + toast(text); + } + ta.remove(); + } +} + +/* -------------------------------- 绑定 -------------------------------- */ +function bind() { + canvas.addEventListener('pointerdown', onPointerDown); + canvas.addEventListener('pointermove', onPointerMove); + canvas.addEventListener('pointerleave', onPointerLeave); + $('createBtn').addEventListener('click', createRoom); + $('joinBtn').addEventListener('click', () => joinRoom($('codeInput').value)); + $('watchBtn').addEventListener('click', () => joinRoom($('codeInput').value, true)); + $('codeInput').addEventListener('keydown', (e) => { + if (e.key === 'Enter') joinRoom($('codeInput').value); + }); + $('codeInput').addEventListener('input', (e) => { + const el = e.target; + el.value = el.value.toUpperCase().replace(/[^0-9A-Z]/g, '').slice(0, 4); + }); + $('localBtn').addEventListener('click', startLocal); + $('tcRow').addEventListener('click', (e) => { + const el = e.target.closest('.chip'); + if (!el) return; + selectedMinutes = Number(el.dataset.min) || 0; + updateChips(); + }); + $('sizeRow').addEventListener('click', (e) => { + const el = e.target.closest('.chip'); + if (!el) return; + selectedSize = Number(el.dataset.size) || 19; + updateChips(); + render(); + }); + $('copyBtn').addEventListener('click', copyInvite); + $('ovCopy').addEventListener('click', copyInvite); + + const leave = () => { + send({ t: 'leave' }); + toLobby(); + }; + $('lobbyBtn').addEventListener('click', leave); + $('ovLobby').addEventListener('click', leave); + $('ovLobby2').addEventListener('click', leave); + + $('passBtn').addEventListener('click', doPass); + $('resignBtn').addEventListener('click', () => { + if (!game || game.over) return; + if (mode === 'local') { + if (!confirm('认输?')) return; + game.over = true; + game.winner = other(game.turn); + game.reason = 'resign'; + clockRunning = false; + sfx('lose'); + render(); + return; + } + if (!confirm('确定认输?')) return; + send({ t: 'resign' }); + }); + $('ovRematch').addEventListener('click', () => { + if (!game) return; + if (mode === 'local') { + startLocal(); + return; + } + send({ t: 'rematch' }); + }); + + window.addEventListener('resize', render); + window.addEventListener('orientationchange', () => window.setTimeout(render, 120)); + document.addEventListener('visibilitychange', () => { + if (document.visibilityState === 'visible' && mode === 'online' && wantRoom && conn !== 'open') { + connect(); + } + }); + window.addEventListener('hashchange', () => { + const c = location.hash.replace('#', '').toUpperCase(); + if (c && c !== code) joinRoom(c); + }); + window.addEventListener('keydown', (e) => { + if (e.key === 'p' || e.key === 'P') { + if (game && !game.over && myTurn() && document.activeElement !== $('codeInput')) doPass(); + } + }); + window.setInterval(tick, 250); + bindVoice(); +} + +/* -------------------------------- 启动 -------------------------------- */ +function boot() { + bind(); + setConn('idle'); + $('codeInput').setAttribute('autocomplete', 'off'); + $('codeInput').setAttribute('inputmode', 'latin'); + updateChips(); + const fromHash = location.hash.replace('#', '').toUpperCase(); + if (/^[0-9A-Z]{4}$/.test(fromHash)) { + $('codeInput').value = fromHash; + joinRoom(fromHash); + } else { + render(); + } +} +boot(); + +/* -------------------------------- 语音互动 -------------------------------- */ + +function clearVoiceCache() { + for (const url of voiceCache.values()) { + try { + URL.revokeObjectURL(url); + } catch { + /* ignore */ + } + } + voiceCache.clear(); +} + +function stopAudio() { + if (audioEl) { + try { + audioEl.pause(); + } catch { + /* ignore */ + } + audioEl = null; + } + playingId = null; +} + +function upsertVoice(meta) { + if (!meta || !meta.id) return; + const i = voiceList.findIndex((v) => v.id === meta.id); + if (i >= 0) voiceList[i] = meta; + else voiceList.push(meta); + voiceList.sort((a, b) => a.id - b.id); +} + +function voiceTime(at) { + try { + return new Date(at).toLocaleTimeString('zh-CN', { hour: '2-digit', minute: '2-digit' }); + } catch { + return ''; + } +} + +function voiceSecs(ms) { + const s = Math.max(0.1, (ms || 0) / 1000); + return s < 10 ? s.toFixed(1) : String(Math.round(s)); +} + +function renderVoice() { + const btn = document.getElementById('pttBtn'); + const list = document.getElementById('voiceList'); + if (!btn || !list) return; + const canTalk = mode === 'online' && !!you && !spec; + const label = btn.querySelector('.ptt-label'); + btn.classList.toggle('rec', recording); + btn.disabled = !canTalk && !recording; + if (label) { + label.textContent = recording + ? `松手发送 · ${((performance.now() - recStart) / 1000).toFixed(1)}s` + : '按住说话'; + } + const hint = $('voiceHint'); + if (recording) hint.textContent = `录音中 · 最长 ${MAX_SECONDS} 秒`; + else if (mode !== 'online') hint.textContent = '联机对局里才能用'; + else if (spec) hint.textContent = '观战中只能听'; + else if (canTalk) hint.textContent = '按住说话,松手自动发'; + else hint.textContent = '还没连上服务端'; + + if (!voiceList.length) { + list.innerHTML = '
还没有语音留言
'; + return; + } + const fromBottom = list.scrollHeight - list.scrollTop - list.clientHeight < 24; + list.innerHTML = voiceList + .map((v) => { + const mine = !!you && v.from === you; + const playing = v.id === playingId; + return ( + `` + ); + }) + .join(''); + if (fromBottom) list.scrollTop = list.scrollHeight; +} + +function playUrl(url, id) { + stopAudio(); + const a = new Audio(url); + a.preload = 'auto'; + audioEl = a; + playingId = id; + renderVoice(); + a.onended = () => { + if (playingId === id) { + playingId = null; + audioEl = null; + renderVoice(); + } + }; + const p = a.play(); + if (p && typeof p.catch === 'function') { + p.catch(() => { + if (playingId === id) { + playingId = null; + audioEl = null; + renderVoice(); + } + toast('浏览器拦了自动播放,点一下那条记录'); + }); + } +} + +function playVoice(id) { + const url = voiceCache.get(id); + if (url) { + playUrl(url, id); + return; + } + pendingPlay = id; + send({ t: 'voiceGet', id }); +} + +function onVoice(msg) { + let url = voiceCache.get(msg.id); + if (!url) { + url = base64ToUrl(msg.data, msg.mime); + voiceCache.set(msg.id, url); + } + upsertVoice({ id: msg.id, from: msg.from, at: msg.at, durationMs: msg.durationMs }); + if (msg.from !== you) playUrl(url, msg.id); + else renderVoice(); +} + +function onVoiceData(msg) { + if (!voiceCache.has(msg.id)) voiceCache.set(msg.id, base64ToUrl(msg.data, msg.mime)); + const url = voiceCache.get(msg.id); + if (pendingPlay === msg.id) { + pendingPlay = null; + playUrl(url, msg.id); + } +} + +async function startRecording() { + if (recording) return; + if (mode !== 'online') { + toast('语音只在联机对局里可用'); + return; + } + if (!you) { + toast('观战中只能听,不能发'); + return; + } + if (conn !== 'open') { + toast('还没连上服务端,稍等一下'); + return; + } + if (!isSupported()) { + toast('这个浏览器不支持录音'); + return; + } + unlockAudio(); + const r = new Recorder(); + rec = r; + try { + await r.start(); + } catch (e) { + if (rec === r) rec = null; + const name = e && e.name; + toast( + name === 'NotAllowedError' + ? '麦克风没给权限' + : name === 'NotFoundError' + ? '没找到麦克风' + : '麦克风打不开', + ); + return; + } + if (rec !== r || !pressing) { + r.cancel(); + if (rec === r) rec = null; + return; + } + recording = true; + recStart = performance.now(); + renderVoice(); + recTimer = window.setInterval(renderVoice, 100); + recLimit = window.setTimeout(() => { + stopRecording(); + }, MAX_SECONDS * 1000); +} + +async function stopRecording() { + if (!recording || !rec) return; + window.clearInterval(recTimer); + recTimer = null; + window.clearTimeout(recLimit); + recLimit = null; + const r = rec; + rec = null; + recording = false; + const result = await r.stop(); + renderVoice(); + if (!result) return; + if (result.durationMs < 300) { + toast('说得太快了,按住多说一会儿'); + return; + } + let b64 = ''; + try { + b64 = await blobToBase64(result.blob); + } catch { + toast('录音处理失败'); + return; + } + if (!b64) return; + if (b64.length > 640 * 1024) { + toast('这段太长,说短一点'); + return; + } + send({ t: 'voice', mime: result.mime, durationMs: result.durationMs, data: b64 }); +} + +function cancelRecording() { + window.clearInterval(recTimer); + recTimer = null; + window.clearTimeout(recLimit); + recLimit = null; + const r = rec; + rec = null; + recording = false; + if (r) r.cancel(); + renderVoice(); +} + +function bindVoice() { + const btn = $('pttBtn'); + const list = $('voiceList'); + btn.addEventListener('pointerdown', (e) => { + e.preventDefault(); + if (btn.disabled || recording) return; + pressing = true; + try { + btn.setPointerCapture(e.pointerId); + } catch { + /* ignore */ + } + startRecording(); + }); + btn.addEventListener('pointerup', (e) => { + e.preventDefault(); + if (!pressing) return; + pressing = false; + stopRecording(); + }); + btn.addEventListener('pointercancel', () => { + pressing = false; + cancelRecording(); + }); + btn.addEventListener('contextmenu', (e) => e.preventDefault()); + window.addEventListener('blur', () => { + if (recording || pressing) { + pressing = false; + cancelRecording(); + } + }); + list.addEventListener('click', (e) => { + const el = e.target.closest('.vitem'); + if (!el) return; + const id = Number(el.dataset.id); + if (!id) return; + if (playingId === id) { + stopAudio(); + renderVoice(); + return; + } + playVoice(id); + }); + renderVoice(); +} diff --git a/public/js/client/sound.js b/public/js/client/sound.js new file mode 100644 index 0000000..f598b9d --- /dev/null +++ b/public/js/client/sound.js @@ -0,0 +1,110 @@ +/** + * 音效:全部用 WebAudio 现场合成,不加载任何音频文件。 + * 落子是「木头碰木头」的短促噪声脉冲,比纯正弦更像棋盘上的声音。 + */ + +let ac = null; +let noiseBuf = null; + +function audio() { + try { + if (!ac) { + const Ctor = window.AudioContext || window.webkitAudioContext; + if (!Ctor) return null; + ac = new Ctor(); + } + if (ac.state === 'suspended') void ac.resume(); + return ac; + } catch { + return null; + } +} + +export function unlockAudio() { + audio(); +} + +function noiseBuffer(ctx) { + if (noiseBuf && noiseBuf.sampleRate === ctx.sampleRate) return noiseBuf; + const len = Math.floor(ctx.sampleRate * 0.3); + const buf = ctx.createBuffer(1, len, ctx.sampleRate); + const data = buf.getChannelData(0); + for (let i = 0; i < len; i++) data[i] = Math.random() * 2 - 1; + noiseBuf = buf; + return buf; +} + +/** 木石相击的一下 */ +function knock(freq, gain, dur = 0.06, when = 0) { + const ctx = audio(); + if (!ctx) return; + const t0 = ctx.currentTime + when; + const src = ctx.createBufferSource(); + src.buffer = noiseBuffer(ctx); + const bp = ctx.createBiquadFilter(); + bp.type = 'bandpass'; + bp.frequency.setValueAtTime(freq, t0); + bp.frequency.exponentialRampToValueAtTime(Math.max(200, freq * 0.45), t0 + dur); + bp.Q.value = 2.6; + const g = ctx.createGain(); + g.gain.setValueAtTime(0.0001, t0); + g.gain.exponentialRampToValueAtTime(gain, t0 + 0.003); + g.gain.exponentialRampToValueAtTime(0.0001, t0 + dur); + src.connect(bp).connect(g).connect(ctx.destination); + src.start(t0); + src.stop(t0 + dur + 0.02); + + // 低频「咚」让它有点分量 + const osc = ctx.createOscillator(); + const og = ctx.createGain(); + osc.type = 'sine'; + osc.frequency.setValueAtTime(freq * 0.16, t0); + osc.frequency.exponentialRampToValueAtTime(Math.max(60, freq * 0.1), t0 + dur * 1.2); + og.gain.setValueAtTime(0.0001, t0); + og.gain.exponentialRampToValueAtTime(gain * 0.55, t0 + 0.005); + og.gain.exponentialRampToValueAtTime(0.0001, t0 + dur * 1.3); + osc.connect(og).connect(ctx.destination); + osc.start(t0); + osc.stop(t0 + dur * 1.4 + 0.02); +} + +function tone(freq, start, dur, type, gain) { + const ctx = audio(); + if (!ctx) return; + const t0 = ctx.currentTime + start; + const osc = ctx.createOscillator(); + const g = ctx.createGain(); + osc.type = type; + osc.frequency.setValueAtTime(freq, t0); + osc.frequency.exponentialRampToValueAtTime(Math.max(60, freq * 0.75), t0 + dur); + g.gain.setValueAtTime(0.0001, t0); + g.gain.exponentialRampToValueAtTime(gain, t0 + 0.012); + g.gain.exponentialRampToValueAtTime(0.0001, t0 + dur); + osc.connect(g).connect(ctx.destination); + osc.start(t0); + osc.stop(t0 + dur + 0.02); +} + +export function sfx(kind) { + switch (kind) { + case 'move': + knock(2400, 0.16, 0.055); + break; + case 'capture': + // 连提几子:一串渐弱的响声 + knock(2200, 0.16, 0.055, 0); + knock(1900, 0.13, 0.05, 0.07); + knock(2600, 0.1, 0.045, 0.14); + break; + case 'pass': + tone(520, 0, 0.1, 'sine', 0.05); + tone(390, 0.09, 0.14, 'sine', 0.045); + break; + case 'win': + [523, 659, 784, 1046].forEach((f, i) => tone(f, i * 0.1, 0.18, 'sine', 0.06)); + break; + case 'lose': + [440, 392, 330, 262].forEach((f, i) => tone(f, i * 0.12, 0.2, 'sine', 0.05)); + break; + } +} diff --git a/public/js/client/voice.js b/public/js/client/voice.js new file mode 100644 index 0000000..30a8970 --- /dev/null +++ b/public/js/client/voice.js @@ -0,0 +1,136 @@ +/** + * 语音互动:录音(MediaRecorder)+ base64 编解码 + 播放 + * + * 约束:单条最长 30 秒;编码优先 webm/opus(Chrome/Firefox/Edge), + * Safari 自动落到 audio/mp4。跨内核播放能力取决于对方浏览器的解码支持。 + */ + +export const MAX_SECONDS = 30; + +const MIME_CANDIDATES = [ + 'audio/webm;codecs=opus', + 'audio/webm', + 'audio/mp4', + 'audio/ogg;codecs=opus', +]; + +export function isSupported() { + return !!( + typeof window !== 'undefined' && + window.MediaRecorder && + navigator.mediaDevices && + typeof navigator.mediaDevices.getUserMedia === 'function' + ); +} + +function pickMimeType() { + if (typeof MediaRecorder === 'undefined') return ''; + for (const t of MIME_CANDIDATES) { + try { + if (MediaRecorder.isTypeSupported(t)) return t; + } catch { + /* ignore */ + } + } + return ''; +} + +export class Recorder { + constructor() { + this.stream = null; + this.mr = null; + this.chunks = []; + this.mime = ''; + this.startedAt = 0; + this.recording = false; + } + + async start() { + if (this.recording) return; + this.stream = await navigator.mediaDevices.getUserMedia({ + audio: { + echoCancellation: true, + noiseSuppression: true, + autoGainControl: true, + }, + }); + const mime = pickMimeType(); + const opts = mime ? { mimeType: mime, audioBitsPerSecond: 32000 } : {}; + this.mr = new MediaRecorder(this.stream, opts); + this.mime = this.mr.mimeType || mime || 'audio/webm'; + this.chunks = []; + this.mr.ondataavailable = (e) => { + if (e.data && e.data.size > 0) this.chunks.push(e.data); + }; + this.startedAt = performance.now(); + this.mr.start(); + this.recording = true; + } + + /** 停止录音,返回 { blob, mime, durationMs };没录到东西返回 null */ + async stop() { + if (!this.recording || !this.mr) return null; + const dur = Math.min(MAX_SECONDS * 1000, performance.now() - this.startedAt); + const mr = this.mr; + const stopped = new Promise((resolve) => { + mr.onstop = () => resolve(); + // 有些实现 onstop 迟迟不来,兜底 + setTimeout(resolve, 800); + }); + try { + mr.stop(); + } catch { + /* ignore */ + } + await stopped; + this.recording = false; + this.release(); + const blob = new Blob(this.chunks, { type: this.mime || 'audio/webm' }); + this.chunks = []; + if (!blob.size) return null; + return { blob, mime: this.mime || blob.type || 'audio/webm', durationMs: Math.round(dur) }; + } + + /** 放弃这次录音(手指划走、页面切走等) */ + cancel() { + try { + if (this.mr && this.recording) this.mr.stop(); + } catch { + /* ignore */ + } + this.recording = false; + this.chunks = []; + this.release(); + } + + release() { + if (this.stream) { + this.stream.getTracks().forEach((t) => t.stop()); + this.stream = null; + } + this.mr = null; + } +} + +/** Blob -> base64(不带 data: 前缀) */ +export function blobToBase64(blob) { + return new Promise((resolve, reject) => { + const fr = new FileReader(); + fr.onload = () => { + const s = String(fr.result || ''); + const comma = s.indexOf(','); + resolve(comma >= 0 ? s.slice(comma + 1) : ''); + }; + fr.onerror = () => reject(fr.error || new Error('read failed')); + fr.readAsDataURL(blob); + }); +} + +/** base64 -> Blob URL(记得 revoke) */ +export function base64ToUrl(b64, mime) { + const bin = atob(b64); + const len = bin.length; + const bytes = new Uint8Array(len); + for (let i = 0; i < len; i++) bytes[i] = bin.charCodeAt(i); + return URL.createObjectURL(new Blob([bytes], { type: mime || 'audio/webm' })); +} diff --git a/public/js/shared/rules.js b/public/js/shared/rules.js new file mode 100644 index 0000000..30cb6d6 --- /dev/null +++ b/public/js/shared/rules.js @@ -0,0 +1,239 @@ +/** + * 围棋规则的浏览器副本(`src/rules.rs` 的 JS 镜像) + * + * 只负责两件事:本地双人模式的即时判定、联机模式下「点一下就知道能不能下」的提示。 + * 服务端才是权威 —— 改规则一定要两边一起改。 + */ + +export const MAX_SIZE = 19; +/** 中国规则贴目:黑贴 3又3/4 子 = 7.5 目 */ +export const KOMI = 7.5; + +export const EMPTY = 0; +export const BLACK = 1; +export const WHITE = 2; + +export function other(c) { + return c === 'b' ? 'w' : 'b'; +} + +export function stoneOf(c) { + return c === 'b' ? BLACK : WHITE; +} + +export function colorOf(v) { + return v === BLACK ? 'b' : v === WHITE ? 'w' : null; +} + +export function newBoard(size) { + return new Uint8Array(size * size); +} + +export function idxOf(size, x, y) { + return y * size + x; +} + +export function xOf(size, i) { + return i % size; +} + +export function yOf(size, i) { + return Math.floor(i / size); +} + +export function neighbors(size, i) { + const x = xOf(size, i); + const y = yOf(size, i); + const out = []; + if (x > 0) out.push(i - 1); + if (x + 1 < size) out.push(i + 1); + if (y > 0) out.push(i - size); + if (y + 1 < size) out.push(i + size); + return out; +} + +/** 一块棋的所有子 + 气数(气按空点去重) */ +export function groupInfo(board, size, start) { + const color = board[start]; + if (!color) return { stones: [], libs: 0 }; + const seen = new Uint8Array(board.length); + const libSeen = new Uint8Array(board.length); + const stack = [start]; + seen[start] = 1; + const stones = []; + let libs = 0; + while (stack.length) { + const p = stack.pop(); + stones.push(p); + for (const q of neighbors(size, p)) { + if (board[q] === EMPTY) { + if (!libSeen[q]) { + libSeen[q] = 1; + libs++; + } + } else if (board[q] === color && !seen[q]) { + seen[q] = 1; + stack.push(q); + } + } + } + return { stones, libs }; +} + +/** + * 最基础的落子判定:只判禁着点与自杀,不管劫。 + * @returns {{board: Uint8Array, captured: number[]} | null} null = 不合法 + */ +export function play(board, size, at, color) { + if (at < 0 || at >= board.length) return null; + if (board[at] !== EMPTY) return null; + const mine = stoneOf(color); + const theirs = stoneOf(other(color)); + const nb = board.slice(); + nb[at] = mine; + + const captured = []; + for (const q of neighbors(size, at)) { + if (nb[q] === theirs) { + const g = groupInfo(nb, size, q); + if (g.libs === 0) { + for (const s of g.stones) { + nb[s] = EMPTY; + captured.push(s); + } + } + } + } + if (groupInfo(nb, size, at).libs === 0) return null; // 禁自杀 + return { board: nb, captured }; +} + +export function isSuicide(board, size, at, color) { + if (board[at] !== EMPTY) return false; + return play(board, size, at, color) === null; +} + +/** 中国规则数子:活子 + 只被本方围住的空点 */ +export function scoreArea(board, size, komi = KOMI) { + const seen = new Uint8Array(board.length); + let blackTerr = 0; + let whiteTerr = 0; + let neutral = 0; + + for (let i = 0; i < board.length; i++) { + if (board[i] !== EMPTY || seen[i]) continue; + const stack = [i]; + seen[i] = 1; + let region = 0; + let touchB = false; + let touchW = false; + while (stack.length) { + const p = stack.pop(); + region++; + for (const q of neighbors(size, p)) { + const v = board[q]; + if (v === EMPTY) { + if (!seen[q]) { + seen[q] = 1; + stack.push(q); + } + } else if (v === BLACK) touchB = true; + else touchW = true; + } + } + if (touchB && !touchW) blackTerr += region; + else if (touchW && !touchB) whiteTerr += region; + else neutral += region; + } + + let blackStones = 0; + let whiteStones = 0; + for (let i = 0; i < board.length; i++) { + if (board[i] === BLACK) blackStones++; + else if (board[i] === WHITE) whiteStones++; + } + const black = blackStones + blackTerr; + const white = whiteStones + whiteTerr + komi; + return { + black, + white, + blackStones, + whiteStones, + blackTerr, + whiteTerr, + neutral, + komi, + winner: black >= white ? 'b' : 'w', + margin: Math.abs(black - white), + }; +} + +/* ------------------------------ 坐标与编码 ------------------------------ */ + +/** 围棋习惯用法:跳过字母 I */ +export const COLS = 'ABCDEFGHJKLMNOPQRST'; + +export function coordName(size, i) { + return COLS[xOf(size, i)] + String(size - yOf(size, i)); +} + +export function encodeBoard(board) { + let s = ''; + for (let i = 0; i < board.length; i++) { + s += board[i] === BLACK ? 'b' : board[i] === WHITE ? 'w' : '.'; + } + return s; +} + +export function decodeBoard(str, size) { + const b = new Uint8Array(size * size); + for (let i = 0; i < b.length; i++) { + const c = str[i]; + b[i] = c === 'b' || c === 'B' ? BLACK : c === 'w' || c === 'W' ? WHITE : EMPTY; + } + return b; +} + +export function positionKey(board, turn) { + return encodeBoard(board) + turn; +} + +export function isSuperko(keys, key) { + return keys.indexOf(key) >= 0; +} + +/* ------------------------------ 让子 / 星位 ------------------------------ */ + +/** 星位(含天元),按棋盘大小取 */ +export function starPoints(size) { + if (size === 19) { + const e = [3, 9, 15]; + const out = []; + for (const y of e) for (const x of e) out.push(idxOf(size, x, y)); + return out; + } + if (size === 13) { + const e = [3, 6, 9]; + const out = []; + for (const y of e) for (const x of e) out.push(idxOf(size, x, y)); + return out; + } + if (size === 9) { + const e = [2, 4, 6]; + const out = []; + for (const y of e) for (const x of e) out.push(idxOf(size, x, y)); + return out; + } + return []; +} + +/** 附近最近的交叉点(点击容差) */ +export function nearestPoint(size, x, y, radius) { + if (x < -radius || y < -radius || x > size - 1 + radius || y > size - 1 + radius) return null; + const cx = Math.min(size - 1, Math.max(0, Math.round(x))); + const cy = Math.min(size - 1, Math.max(0, Math.round(y))); + const dx = x - cx; + const dy = y - cy; + if (Math.hypot(dx, dy) > radius) return null; + return idxOf(size, cx, cy); +} diff --git a/public/style.css b/public/style.css new file mode 100644 index 0000000..b71ef9a --- /dev/null +++ b/public/style.css @@ -0,0 +1,1164 @@ +:root { + --bg: #0e1116; + --bg-2: #141a21; + --card: rgba(255, 255, 255, 0.055); + --card-2: rgba(255, 255, 255, 0.085); + --line: rgba(255, 255, 255, 0.1); + --line-soft: rgba(255, 255, 255, 0.06); + --text: #e9edf3; + --muted: #94a1b2; + --jade: #57c08c; + --jade-deep: #2f7f5a; + --gold: #e2b355; + --red: #d9554c; + --shadow: 0 24px 60px rgba(0, 0, 0, 0.45); + --r-lg: 20px; + --r-md: 14px; + --r-sm: 10px; +} + +* { + box-sizing: border-box; + -webkit-tap-highlight-color: transparent; +} + +[hidden] { + display: none !important; +} + +html, +body { + margin: 0; + padding: 0; + min-height: 100%; +} + +body { + background: + radial-gradient(1200px 620px at 8% -12%, rgba(47, 127, 90, 0.22), transparent 62%), + radial-gradient(900px 520px at 100% 0%, rgba(226, 179, 85, 0.1), transparent 55%), + linear-gradient(180deg, #10151b 0%, #0b0e12 100%); + background-attachment: fixed; + color: var(--text); + font-family: -apple-system, BlinkMacSystemFont, 'PingFang SC', 'Hiragino Sans GB', + 'Microsoft YaHei', system-ui, sans-serif; + -webkit-font-smoothing: antialiased; + min-height: 100dvh; +} + +.app { + min-height: 100dvh; + display: flex; + flex-direction: column; +} + +/* ------------------------------- 顶栏 ------------------------------- */ + +.topbar { + display: flex; + align-items: center; + gap: 16px; + padding: 16px 22px 12px; + max-width: 1200px; + width: 100%; + margin: 0 auto; +} + +.brand { + display: flex; + align-items: center; + gap: 12px; + min-width: 0; +} + +.seal { + display: grid; + place-items: center; + width: 40px; + height: 40px; + border-radius: 11px; + background: linear-gradient(155deg, #3d9c72, #22614a); + color: #eafaf1; + font-family: 'Songti SC', 'STSong', serif; + font-size: 23px; + font-weight: 700; + box-shadow: 0 6px 18px rgba(47, 127, 90, 0.42), inset 0 1px 0 rgba(255, 255, 255, 0.22); + flex: none; +} + +.seal.big { + width: 58px; + height: 58px; + font-size: 33px; + border-radius: 16px; +} + +.brand-text h1 { + font-size: 17px; + margin: 0; + letter-spacing: 0.5px; + font-weight: 650; +} + +.brand-text p { + margin: 2px 0 0; + font-size: 11.5px; + color: var(--muted); + letter-spacing: 0.4px; +} + +.roomline { + display: flex; + align-items: center; + gap: 8px; + margin-left: auto; +} + +.tag { + font-size: 12.5px; + letter-spacing: 1.5px; + padding: 7px 12px; + border-radius: 999px; + background: rgba(226, 179, 85, 0.12); + border: 1px solid rgba(226, 179, 85, 0.28); + color: #f0cf8d; + font-variant-numeric: tabular-nums; +} + +.status { + display: flex; + align-items: center; + gap: 7px; + font-size: 12px; + color: var(--muted); + margin-left: auto; + flex: none; +} + +.roomline:not([hidden]) ~ .status { + margin-left: 14px; +} + +.dot { + width: 8px; + height: 8px; + border-radius: 50%; + background: #5b6472; + box-shadow: 0 0 0 3px rgba(255, 255, 255, 0.03); + transition: background 0.25s; +} + +.dot.open { + background: var(--jade); + box-shadow: 0 0 10px rgba(87, 192, 140, 0.7); +} + +.dot.connecting { + background: var(--gold); + animation: blink 1s infinite; +} + +.dot.closed { + background: var(--red); +} + +@keyframes blink { + 50% { + opacity: 0.35; + } +} + +/* ------------------------------- 主区域 ------------------------------- */ + +.stage { + flex: 1; + display: grid; + grid-template-columns: minmax(0, 1fr) 300px; + gap: 18px; + align-items: start; + width: 100%; + max-width: 1200px; + margin: 0 auto; + padding: 0 22px 24px; +} + +.board-wrap { + position: relative; + padding: 12px; + border-radius: var(--r-lg); + background: linear-gradient(165deg, #1c232b, #141920); + border: 1px solid var(--line); + box-shadow: var(--shadow); + width: min(100%, calc(100dvh - 168px)); + justify-self: center; +} + +.canvas-holder { + position: relative; + width: 100%; + aspect-ratio: 1 / 1; + border-radius: 12px; + overflow: hidden; +} + +canvas#board { + display: block; + width: 100%; + height: 100%; + border-radius: 12px; + touch-action: none; + cursor: pointer; +} + +/* ------------------------------- 面板 ------------------------------- */ + +.panel { + display: flex; + flex-direction: column; + gap: 10px; + padding-top: 12px; +} + +.players { + display: flex; + flex-direction: column; + gap: 8px; +} + +.pcard { + display: flex; + align-items: center; + gap: 10px; + padding: 10px 12px; + border-radius: var(--r-md); + background: var(--card); + border: 1px solid var(--line-soft); + transition: border-color 0.2s, background 0.2s, transform 0.2s; +} + +.pcard .pdot { + width: 14px; + height: 14px; + border-radius: 50%; + flex: none; +} + +.pcard.black .pdot { + background: radial-gradient(circle at 34% 32%, #6b6b6b, #0b0b0d 72%); + box-shadow: 0 0 0 3px rgba(255, 255, 255, 0.06); +} + +.pcard.white .pdot { + background: radial-gradient(circle at 34% 32%, #ffffff, #cfc6b4 78%); + box-shadow: 0 0 0 3px rgba(255, 255, 255, 0.04); +} + +.pinfo { + min-width: 0; +} + +.pname { + font-size: 13.5px; + font-weight: 600; +} + +.pstate { + font-size: 11.5px; + color: var(--muted); + margin-top: 2px; +} + +.pcap { + margin-left: auto; + font-size: 11.5px; + color: #8b97a7; + font-variant-numeric: tabular-nums; + white-space: nowrap; +} + +.pcard.active { + border-color: rgba(226, 179, 85, 0.5); + background: linear-gradient(100deg, rgba(226, 179, 85, 0.14), rgba(226, 179, 85, 0.03)); +} + +.pcard.active .pstate { + color: #f0cf8d; +} + +.pcard.offline { + opacity: 0.55; +} + +.ptime { + font-family: 'SF Mono', ui-monospace, Menlo, monospace; + font-size: 15px; + font-variant-numeric: tabular-nums; + color: #cfd8e4; + letter-spacing: 0.5px; + padding-left: 6px; + min-width: 52px; + text-align: right; +} + +.ptime.low { + color: #ff8d84; + animation: tickpulse 1s ease-in-out infinite; +} + +@keyframes tickpulse { + 50% { + opacity: 0.55; + } +} + +.turnbar { + padding: 10px 12px; + border-radius: var(--r-sm); + font-size: 13px; + font-weight: 600; + text-align: center; + background: var(--card); + border: 1px solid var(--line-soft); + color: var(--muted); + transition: all 0.2s; +} + +.turnbar.mine { + color: #d7f5e5; + background: linear-gradient(100deg, rgba(87, 192, 140, 0.24), rgba(87, 192, 140, 0.07)); + border-color: rgba(87, 192, 140, 0.45); +} + +.turnbar.done { + color: #f0cf8d; + background: rgba(226, 179, 85, 0.12); + border-color: rgba(226, 179, 85, 0.3); +} + +.moves { + flex: 1; + min-height: 150px; + max-height: min(40dvh, 320px); + overflow-y: auto; + border-radius: var(--r-md); + background: rgba(0, 0, 0, 0.22); + border: 1px solid var(--line-soft); + padding: 6px; + font-size: 13px; + scrollbar-width: thin; +} + +.moves::-webkit-scrollbar { + width: 6px; +} + +.moves::-webkit-scrollbar-thumb { + background: rgba(255, 255, 255, 0.14); + border-radius: 99px; +} + +.moves .empty { + color: var(--muted); + font-size: 12px; + text-align: center; + padding: 22px 0; +} + +.mvrow { + display: grid; + grid-template-columns: 30px 1fr 1fr; + align-items: center; + padding: 4px 6px; + border-radius: 7px; + font-variant-numeric: tabular-nums; +} + +.mvrow:nth-child(odd) { + background: rgba(255, 255, 255, 0.028); +} + +.mvrow .no { + color: #5f6b7a; + font-size: 11.5px; +} + +.mvb, +.mvw { + font-size: 12.5px; + letter-spacing: 0.4px; + color: #c9d2de; + white-space: nowrap; + overflow: hidden; + text-overflow: ellipsis; +} + +.mvb.hl { + color: #e9edf3; + font-weight: 600; +} + +.mvw.hl { + color: #f3e7c9; + font-weight: 600; +} + +.mvb em, +.mvw em { + font-style: normal; + font-size: 10.5px; + color: #d98a5a; + margin-left: 3px; +} + +.actions { + display: flex; + gap: 8px; +} + +.actions .btn { + flex: 1; + padding-left: 6px; + padding-right: 6px; +} + +/* ------------------------------- 按钮 ------------------------------- */ + +.btn { + appearance: none; + border: 1px solid var(--line); + background: var(--card); + color: var(--text); + font-family: inherit; + font-size: 13.5px; + font-weight: 600; + padding: 10px 16px; + border-radius: var(--r-sm); + cursor: pointer; + transition: transform 0.12s, background 0.18s, border-color 0.18s, opacity 0.18s; + letter-spacing: 0.3px; +} + +.btn:hover { + background: var(--card-2); +} + +.btn:active { + transform: scale(0.975); +} + +.btn:disabled { + opacity: 0.45; + cursor: default; +} + +.btn.primary { + background: linear-gradient(160deg, #3fa87a, #256b4f); + border-color: rgba(255, 255, 255, 0.14); + color: #f0fdf6; + box-shadow: 0 8px 22px rgba(37, 107, 79, 0.34), inset 0 1px 0 rgba(255, 255, 255, 0.18); +} + +.btn.primary:hover { + background: linear-gradient(160deg, #47b886, #2a7a59); +} + +.btn.ghost { + background: transparent; + border-color: var(--line); + color: #cfd8e4; +} + +.btn.ghost:hover { + background: rgba(255, 255, 255, 0.05); +} + +.btn.text { + background: none; + border: none; + color: var(--muted); + font-weight: 500; + text-decoration: underline; + text-decoration-color: rgba(255, 255, 255, 0.2); + text-underline-offset: 4px; +} + +.btn.text:hover { + color: #cfd8e4; +} + +.btn.sm { + padding: 7px 12px; + font-size: 12px; +} + +.btn.block { + width: 100%; + display: block; +} + +/* ------------------------------- 遮罩 ------------------------------- */ + +.overlay { + position: absolute; + inset: 0; + display: flex; + align-items: center; + justify-content: center; + padding: 18px; + border-radius: var(--r-lg); + background: rgba(8, 10, 13, 0.62); + backdrop-filter: blur(6px); + -webkit-backdrop-filter: blur(6px); + z-index: 5; + animation: fade 0.22s ease; +} + +@keyframes fade { + from { + opacity: 0; + } +} + +.overlay-card { + width: 100%; + max-width: 330px; + padding: 24px 22px; + border-radius: 18px; + background: linear-gradient(170deg, #1b2229, #12161c); + border: 1px solid var(--line); + box-shadow: 0 26px 60px rgba(0, 0, 0, 0.55); + text-align: center; +} + +.kicker { + margin: 0 0 10px; + font-size: 11.5px; + letter-spacing: 2px; + color: var(--muted); + text-transform: uppercase; +} + +.code-big { + font-family: 'SF Mono', ui-monospace, Menlo, monospace; + font-size: 34px; + letter-spacing: 10px; + margin: 4px 0 14px 0; + padding-left: 10px; + color: #f2d391; + text-shadow: 0 0 26px rgba(226, 179, 85, 0.35); +} + +.hint { + margin: 0 0 18px; + font-size: 12.5px; + line-height: 1.75; + color: var(--muted); +} + +.overlay-card h2 { + margin: 0 0 8px; + font-size: 25px; + letter-spacing: 1px; +} + +.overlay-card h2.win-b { + color: #dfe7f2; +} + +.overlay-card h2.win-w { + color: #f6ecd8; +} + +.overlay-card h2.win-draw { + color: #f0cf8d; +} + +.scoreline { + display: flex; + flex-wrap: wrap; + justify-content: center; + align-items: baseline; + gap: 6px; + margin: 0 0 16px; + padding: 10px 12px; + border-radius: var(--r-sm); + background: rgba(226, 179, 85, 0.08); + border: 1px solid rgba(226, 179, 85, 0.2); +} + +.scoreline .sc { + font-variant-numeric: tabular-nums; + font-size: 15px; + font-weight: 600; +} + +.scoreline .sc.black { + color: #e6ebf2; +} + +.scoreline .sc.white { + color: #f3e7c9; +} + +.scoreline .sc.vs { + color: #6d7887; +} + +.scoreline .sc.note { + flex-basis: 100%; + font-size: 11.5px; + font-weight: 500; + color: #a6b1c0; + margin-top: 2px; +} + +.ov-actions { + display: flex; + flex-direction: column; + gap: 8px; +} + +.waiting { + display: flex; + justify-content: center; + gap: 6px; + margin-top: 16px; +} + +.waiting span { + width: 6px; + height: 6px; + border-radius: 50%; + background: var(--gold); + opacity: 0.35; + animation: bounce 1.3s infinite; +} + +.waiting span:nth-child(2) { + animation-delay: 0.18s; +} + +.waiting span:nth-child(3) { + animation-delay: 0.36s; +} + +@keyframes bounce { + 0%, + 60%, + 100% { + transform: translateY(0); + opacity: 0.3; + } + 30% { + transform: translateY(-6px); + opacity: 1; + } +} + +/* ------------------------------- 大厅 ------------------------------- */ + +.lobby { + position: fixed; + inset: 0; + z-index: 30; + display: flex; + align-items: center; + justify-content: center; + padding: 22px; + overflow-y: auto; + background: rgba(7, 9, 12, 0.72); + backdrop-filter: blur(10px); + -webkit-backdrop-filter: blur(10px); + animation: fade 0.25s ease; +} + +.lobby-card { + width: 100%; + max-width: 440px; + padding: 30px 28px 24px; + border-radius: 24px; + background: linear-gradient(170deg, #1a2128, #111519); + border: 1px solid var(--line); + box-shadow: 0 34px 80px rgba(0, 0, 0, 0.6); + margin: auto; +} + +.lobby-head { + text-align: center; + margin-bottom: 18px; +} + +.lobby-head .seal { + margin: 0 auto 14px; +} + +.lobby-head h2 { + margin: 0 0 8px; + font-size: 21px; + letter-spacing: 0.5px; +} + +.lobby-head p { + margin: 0; + font-size: 12.5px; + color: var(--muted); + line-height: 1.7; +} + +.or { + display: flex; + align-items: center; + gap: 12px; + margin: 18px 0 14px; + color: #6d7887; + font-size: 11.5px; +} + +.or::before, +.or::after { + content: ''; + flex: 1; + height: 1px; + background: var(--line-soft); +} + +.join-row { + display: flex; + gap: 8px; +} + +.code-input { + flex: 1; + min-width: 0; + background: rgba(0, 0, 0, 0.3); + border: 1px solid var(--line); + border-radius: var(--r-sm); + color: #f2d391; + font-family: 'SF Mono', ui-monospace, Menlo, monospace; + font-size: 19px; + letter-spacing: 8px; + text-align: center; + text-transform: uppercase; + padding: 10px 8px 10px 16px; + outline: none; + transition: border-color 0.2s, box-shadow 0.2s; +} + +.code-input::placeholder { + color: #4d5766; + letter-spacing: 2px; + font-size: 14px; +} + +.code-input:focus { + border-color: rgba(226, 179, 85, 0.55); + box-shadow: 0 0 0 3px rgba(226, 179, 85, 0.12); +} + +.tips { + margin: 20px 0 0; + padding: 16px 18px 16px 30px; + border-radius: var(--r-md); + background: rgba(255, 255, 255, 0.03); + border: 1px solid var(--line-soft); + color: #8b97a7; + font-size: 12px; + line-height: 1.8; +} + +.tips li + li { + margin-top: 4px; +} + +/* ------------------------------- Toast ------------------------------- */ + +.toast { + position: fixed; + left: 50%; + bottom: 26px; + transform: translate(-50%, 14px); + padding: 11px 20px; + border-radius: 999px; + background: rgba(24, 30, 38, 0.96); + border: 1px solid var(--line); + color: #e6ecf4; + font-size: 13px; + box-shadow: 0 14px 36px rgba(0, 0, 0, 0.5); + opacity: 0; + pointer-events: none; + transition: opacity 0.22s, transform 0.22s; + z-index: 60; + max-width: min(86vw, 420px); + text-align: center; +} + +.toast.show { + opacity: 1; + transform: translate(-50%, 0); +} + +/* ------------------------------- 计时 / 观战 ------------------------------- */ + +.badge { + font-size: 11.5px; + padding: 5px 10px; + border-radius: 999px; + background: rgba(87, 192, 140, 0.14); + border: 1px solid rgba(87, 192, 140, 0.35); + color: #8fe0b8; + letter-spacing: 0.5px; + white-space: nowrap; +} + +.notice { + padding: 8px 11px; + border-radius: var(--r-sm); + font-size: 12px; + line-height: 1.6; + color: #f3d79a; + background: rgba(226, 179, 85, 0.1); + border: 1px solid rgba(226, 179, 85, 0.28); +} + +.tc { + display: flex; + align-items: center; + gap: 10px; + margin-bottom: 12px; +} + +.tc-label { + font-size: 12px; + color: var(--muted); + flex: none; + width: 56px; +} + +.chips { + display: flex; + gap: 6px; + flex: 1; +} + +.chip { + flex: 1; + appearance: none; + font-family: inherit; + font-size: 12px; + padding: 7px 4px; + border-radius: 9px; + border: 1px solid var(--line); + background: rgba(255, 255, 255, 0.03); + color: #b6c0cd; + cursor: pointer; + transition: all 0.16s; + white-space: nowrap; +} + +.chip:hover { + background: rgba(255, 255, 255, 0.07); +} + +.chip.on { + background: rgba(87, 192, 140, 0.16); + border-color: rgba(87, 192, 140, 0.5); + color: #a9e8c6; + font-weight: 600; +} + +.join-row .btn { + flex: none; + padding-left: 12px; + padding-right: 12px; +} + +.tiny { + margin: 10px 2px 0; + font-size: 11.5px; + color: #6d7887; + line-height: 1.6; +} + +/* ------------------------------- 语音互动 ------------------------------- */ + +.voice { + display: flex; + flex-direction: column; + gap: 8px; +} + +.voice-head { + display: flex; + align-items: baseline; + justify-content: space-between; + gap: 8px; + padding: 0 2px; +} + +.voice-title { + font-size: 12px; + letter-spacing: 0.6px; + color: #aab6c6; +} + +.voice-hint { + font-size: 11px; + color: #6d7887; + white-space: nowrap; + overflow: hidden; + text-overflow: ellipsis; +} + +.ptt { + display: flex; + align-items: center; + justify-content: center; + gap: 9px; + width: 100%; + padding: 12px 14px; + border-radius: 12px; + border: 1px solid rgba(87, 192, 140, 0.38); + background: linear-gradient(180deg, rgba(87, 192, 140, 0.18), rgba(87, 192, 140, 0.06)); + color: #a9e8c6; + font: inherit; + font-size: 13.5px; + font-weight: 600; + letter-spacing: 0.5px; + cursor: pointer; + user-select: none; + -webkit-user-select: none; + touch-action: none; + transition: background 0.16s, border-color 0.16s, color 0.16s, transform 0.1s; +} + +.ptt:hover { + background: linear-gradient(180deg, rgba(87, 192, 140, 0.26), rgba(87, 192, 140, 0.1)); +} + +.ptt:active { + transform: scale(0.99); +} + +.ptt:disabled { + opacity: 0.42; + cursor: not-allowed; +} + +.ptt .ptt-ico { + width: 9px; + height: 9px; + border-radius: 50%; + background: #57c08c; + box-shadow: 0 0 0 3px rgba(87, 192, 140, 0.16); + flex: none; +} + +.ptt.rec { + border-color: rgba(217, 85, 76, 0.7); + background: linear-gradient(180deg, rgba(217, 85, 76, 0.36), rgba(217, 85, 76, 0.12)); + color: #ffd9d4; +} + +.ptt.rec .ptt-ico { + background: #ff6f63; + animation: recpulse 1s ease-in-out infinite; +} + +@keyframes recpulse { + 50% { + box-shadow: 0 0 0 9px rgba(255, 111, 99, 0.1); + } +} + +.voice-list { + max-height: 126px; + overflow-y: auto; + border-radius: 12px; + background: rgba(0, 0, 0, 0.22); + border: 1px solid var(--line-soft); + padding: 5px; + display: flex; + flex-direction: column; + gap: 4px; + scrollbar-width: thin; +} + +.voice-list::-webkit-scrollbar { + width: 6px; +} + +.voice-list::-webkit-scrollbar-thumb { + background: rgba(255, 255, 255, 0.14); + border-radius: 99px; +} + +.voice-list .empty { + color: var(--muted); + font-size: 12px; + text-align: center; + padding: 14px 0; +} + +.vitem { + display: grid; + grid-template-columns: 20px 1fr auto auto; + align-items: center; + gap: 8px; + width: 100%; + padding: 7px 9px; + border-radius: 8px; + border: 1px solid transparent; + background: rgba(255, 255, 255, 0.03); + color: #c9d2de; + font: inherit; + font-size: 12.5px; + text-align: left; + cursor: pointer; + transition: background 0.14s, border-color 0.14s, color 0.14s; +} + +.vitem:hover { + background: rgba(255, 255, 255, 0.075); +} + +.vitem.mine { + background: rgba(87, 192, 140, 0.08); + border-color: rgba(87, 192, 140, 0.18); +} + +.vitem.playing { + border-color: rgba(226, 179, 85, 0.55); + color: #f3d79a; +} + +.vitem .vico { + font-size: 10.5px; + line-height: 1; + text-align: center; + color: #8fe0b8; +} + +.vitem.playing .vico { + color: #f0cf8d; +} + +.vitem .vwho { + overflow: hidden; + white-space: nowrap; + text-overflow: ellipsis; +} + +.vitem .vdur { + font-variant-numeric: tabular-nums; + font-size: 11.5px; + color: #9aa7b7; +} + +.vitem .vtime { + font-variant-numeric: tabular-nums; + font-size: 11px; + color: #5f6b7a; +} + +/* ------------------------------- 响应式 ------------------------------- */ + +@media (max-width: 980px) { + .stage { + grid-template-columns: minmax(0, 1fr); + padding: 0 14px 18px; + gap: 12px; + } + + .board-wrap { + width: min(100%, calc(100dvh - 210px)); + padding: 9px; + border-radius: 16px; + } + + .panel { + padding-top: 0; + } + + .moves { + min-height: 96px; + max-height: 24dvh; + } + + .topbar { + padding: 12px 14px 8px; + gap: 10px; + } + + .brand-text p { + display: none; + } + + .roomline { + gap: 6px; + } + + .tag { + letter-spacing: 1px; + font-size: 11.5px; + padding: 6px 10px; + } +} + +@media (max-width: 560px) { + .brand-text h1 { + font-size: 15px; + } + + .seal { + width: 34px; + height: 34px; + font-size: 20px; + } + + .board-wrap { + width: 100%; + } + + .status span:last-child { + display: none; + } + + .lobby-card { + padding: 24px 20px 18px; + } + + .code-big { + font-size: 28px; + letter-spacing: 8px; + } + + .tc { + flex-direction: column; + align-items: stretch; + gap: 8px; + } + + .tc-label { + width: auto; + text-align: center; + } + + .ptime { + font-size: 13.5px; + min-width: 44px; + } + + .voice-list { + max-height: 112px; + } +} + +@media (min-width: 981px) and (max-height: 760px) { + .moves { + max-height: 190px; + } + + .voice-list { + max-height: 90px; + } +} diff --git a/src/lib.rs b/src/lib.rs new file mode 100644 index 0000000..1c262cc --- /dev/null +++ b/src/lib.rs @@ -0,0 +1,9 @@ +//! 围棋在线对战:Rust 服务端 + 纯静态 HTML 前端 +//! +//! - [`rules`] 规则引擎(提子、禁自杀、打劫、数子、坐标记法) +//! - [`protocol`] WebSocket 消息契约 +//! - [`server`] 房间管理、时钟、观战、静态资源服务 + +pub mod protocol; +pub mod rules; +pub mod server; diff --git a/src/main.rs b/src/main.rs new file mode 100644 index 0000000..fc7e499 --- /dev/null +++ b/src/main.rs @@ -0,0 +1,44 @@ +use std::net::SocketAddr; + +use tokio::net::TcpListener; + +use cngo::server::{self, App}; + +#[tokio::main] +async fn main() { + let port: u16 = std::env::var("PORT") + .ok() + .and_then(|v| v.parse().ok()) + .unwrap_or(3100); + let host = std::env::var("HOST").unwrap_or_else(|_| "0.0.0.0".to_string()); + let addr: SocketAddr = match format!("{host}:{port}").parse() { + Ok(a) => a, + Err(_) => { + eprintln!("地址不合法:{host}:{port}"); + std::process::exit(1); + } + }; + + let app = App::new(); + let listener = match TcpListener::bind(addr).await { + Ok(l) => l, + Err(e) => { + eprintln!("端口 {port} 起不来:{e}"); + std::process::exit(1); + } + }; + + println!(); + println!(" 围棋 · 在线对战 已启动"); + println!(" 运行方式 Rust(单文件二进制,前端资源已内嵌)"); + println!(" 本机访问 http://localhost:{port}"); + for ip in server::lan_addrs() { + println!(" 同一局域网 http://{ip}:{port}"); + } + println!(); + + if let Err(e) = server::serve(listener, app).await { + eprintln!("服务异常退出:{e}"); + std::process::exit(1); + } +} diff --git a/src/protocol.rs b/src/protocol.rs new file mode 100644 index 0000000..ffab789 --- /dev/null +++ b/src/protocol.rs @@ -0,0 +1,204 @@ +//! WebSocket 消息(前后端共用的 JSON 契约,见 public/js/client/main.js) + +use serde::{Deserialize, Serialize}; + +use crate::rules::{Color, Score}; + +/// 客户端 -> 服务端 +#[derive(Debug, Deserialize)] +#[serde(tag = "t", rename_all = "lowercase")] +pub enum ClientMsg { + /// 建房:minutes = 0 表示不限时,size = 9 / 13 / 19 + Create { + minutes: Option, + size: Option, + }, + Join { + code: String, + spectate: Option, + }, + /// 落子:at = y * size + x + Move { + at: i64, + }, + /// 停一手(虚手);双方各停一手即终局数子 + Pass, + Resign, + Rematch, + Leave, + Ping, + /// 按住说话录完就发:音频以 base64 传输(30 秒以内,体积可控) + #[serde(rename_all = "camelCase")] + Voice { + mime: Option, + duration_ms: Option, + data: String, + }, + /// 点历史记录时按需取音频 + #[serde(rename = "voiceGet")] + VoiceGet { + id: u64, + }, +} + +#[derive(Clone, Copy, Debug, Serialize, Deserialize)] +pub struct ClockState { + pub b: u64, + pub w: u64, +} + +impl ClockState { + #[inline] + pub fn get(&self, c: Color) -> u64 { + if c == Color::B { + self.b + } else { + self.w + } + } + + #[inline] + pub fn set(&mut self, c: Color, v: u64) { + if c == Color::B { + self.b = v; + } else { + self.w = v; + } + } +} + +#[derive(Clone, Debug, Serialize)] +#[serde(rename_all = "camelCase")] +pub struct HistoryItem { + /// 落点索引;停一手是 null + pub at: Option, + pub note: String, + pub color: Color, + /// 这一手提掉对方几个子 + pub cap: usize, +} + +#[derive(Clone, Debug, Serialize)] +pub struct PlayerSlot { + pub connected: bool, + pub name: &'static str, +} + +#[derive(Clone, Debug, Serialize)] +#[serde(rename_all = "camelCase")] +pub struct Players { + pub b: PlayerSlot, + pub w: PlayerSlot, +} + +/// 双方提子数(键是本方颜色:b = 黑提掉的子) +#[derive(Clone, Copy, Debug, Serialize)] +pub struct Captures { + pub b: usize, + pub w: usize, +} + +impl Captures { + #[inline] + pub fn get(&self, c: Color) -> usize { + if c == Color::B { + self.b + } else { + self.w + } + } + + #[inline] + pub fn add(&mut self, c: Color, n: usize) { + if c == Color::B { + self.b += n; + } else { + self.w += n; + } + } +} + +/// 一条语音的元信息(state 里只带它,音频按需再取) +#[derive(Clone, Debug, Serialize)] +#[serde(rename_all = "camelCase")] +pub struct VoiceMeta { + pub id: u64, + pub from: Color, + /// 服务端时间戳(毫秒),前端只用来显示时刻 + pub at: u64, + pub duration_ms: u32, +} + +#[derive(Clone, Debug, Serialize)] +#[serde(rename_all = "camelCase")] +pub struct StateMsg { + pub code: String, + pub size: usize, + pub board: String, + pub turn: Color, + pub you: Option, + pub spectating: bool, + pub over: bool, + #[serde(skip_serializing_if = "Option::is_none")] + pub winner: Option, + #[serde(skip_serializing_if = "Option::is_none")] + pub reason: Option, + pub history: Vec, + pub players: Players, + pub rematch: Vec, + pub clocks: ClockState, + pub total_ms: u64, + pub spectators: usize, + pub captures: Captures, + /// 连续停了几手(1 = 一方已停,再停一手就数子) + pub passes: u32, + pub komi: f64, + /// 终局数子结果(只有 over 且是数子结束时才有) + #[serde(skip_serializing_if = "Option::is_none")] + pub score: Option, + pub voices: Vec, +} + +/// 实时语音(发出去就直接播) +#[derive(Clone, Debug, Serialize)] +#[serde(rename_all = "camelCase")] +pub struct VoiceMsg { + pub id: u64, + pub from: Color, + pub at: u64, + pub mime: String, + pub duration_ms: u32, + pub data: String, +} + +/// 服务端 -> 客户端 +#[derive(Clone, Debug, Serialize)] +#[serde(tag = "t", rename_all = "lowercase")] +pub enum ServerMsg { + State(Box), + Clock { + clocks: ClockState, + turn: Color, + }, + Voice(VoiceMsg), + #[serde(rename = "voiceData")] + VoiceData { + id: u64, + mime: String, + data: String, + }, + Error { + msg: String, + }, + Left, +} + +impl ServerMsg { + pub fn error(msg: impl Into) -> ServerMsg { + ServerMsg::Error { msg: msg.into() } + } + + pub fn to_json(&self) -> String { + serde_json::to_string(self).unwrap_or_else(|_| "{}".to_string()) + } +} diff --git a/src/rules.rs b/src/rules.rs new file mode 100644 index 0000000..fe67a1e --- /dev/null +++ b/src/rules.rs @@ -0,0 +1,651 @@ +//! 围棋规则引擎(纯函数,无副作用,服务端权威校验) +//! +//! 坐标:x = 0..size-1(列,从左到右),y = 0..size-1(行,从上到下) +//! 索引:idx = y * size + x +//! +//! 规则口径:中国规则(数子 / 面积计算) +//! - 落子后被围住、无气的对方棋块整块提掉 +//! - 落子后自己无气、又提不到对方子 → 禁着点(禁自杀) +//! - 全局同形(超级劫)禁止:任何导致局面与之前完全相同的着法都不合法 +//! - 双方各停一手即终局,按「子 + 空」数子,白贴 7.5 目 + +use serde::{Deserialize, Serialize}; + +/// 棋盘最大边长(只做 19 路;9 / 13 路用同一套代码) +pub const MAX_SIZE: usize = 19; +/// 标准贴目(中国规则数子:黑贴 3又3/4 子 = 7.5 目) +pub const KOMI: f64 = 7.5; + +#[derive(Clone, Copy, PartialEq, Eq, Debug, Serialize, Deserialize)] +#[serde(rename_all = "lowercase")] +pub enum Color { + B, + W, +} + +impl Color { + pub const ALL: [Color; 2] = [Color::B, Color::W]; + + #[inline] + pub fn ix(self) -> usize { + if self == Color::B { + 0 + } else { + 1 + } + } + + #[inline] + pub fn other(self) -> Color { + if self == Color::B { + Color::W + } else { + Color::B + } + } + + /// 棋盘内的存储值 + #[inline] + pub fn stone(self) -> u8 { + if self == Color::B { + 1 + } else { + 2 + } + } + + #[inline] + pub fn from_stone(v: u8) -> Option { + match v { + 1 => Some(Color::B), + 2 => Some(Color::W), + _ => None, + } + } + + /// 编码用的字符('.' 空 / 'b' 黑 / 'w' 白) + pub fn ch(self) -> char { + if self == Color::B { + 'b' + } else { + 'w' + } + } +} + +/* --------------------------------- 棋盘 --------------------------------- */ + +#[derive(Clone, PartialEq, Eq, Debug)] +pub struct Board { + pub size: usize, + /// 0 = 空,1 = 黑,2 = 白 + pub cells: Vec, +} + +impl Board { + pub fn new(size: usize) -> Board { + let size = size.clamp(2, MAX_SIZE); + Board { + size, + cells: vec![0; size * size], + } + } + + #[inline] + pub fn len(&self) -> usize { + self.cells.len() + } + + #[inline] + pub fn is_empty(&self) -> bool { + self.cells.iter().all(|&c| c == 0) + } + + #[inline] + pub fn get(&self, i: usize) -> u8 { + self.cells[i] + } + + #[inline] + pub fn x_of(&self, i: usize) -> usize { + i % self.size + } + + #[inline] + pub fn y_of(&self, i: usize) -> usize { + i / self.size + } + + #[inline] + pub fn idx(&self, x: usize, y: usize) -> usize { + y * self.size + x + } + + pub fn stones(&self, c: Color) -> usize { + let s = c.stone(); + self.cells.iter().filter(|&&v| v == s).count() + } +} + +#[inline] +pub fn idx(size: usize, x: usize, y: usize) -> usize { + y * size + x +} + +/// 四个邻点(越界的丢掉) +#[inline] +pub fn neighbors(size: usize, i: usize) -> ([usize; 4], usize) { + let x = i % size; + let y = i / size; + let mut out = [0usize; 4]; + let mut n = 0; + if x > 0 { + out[n] = i - 1; + n += 1; + } + if x + 1 < size { + out[n] = i + 1; + n += 1; + } + if y > 0 { + out[n] = i - size; + n += 1; + } + if y + 1 < size { + out[n] = i + size; + n += 1; + } + (out, n) +} + +/// 一块棋:所有子的位置 + 气数(气按空点去重计数) +pub fn group_info(b: &Board, start: usize) -> (Vec, usize) { + let color = b.cells[start]; + if color == 0 { + return (Vec::new(), 0); + } + let n = b.cells.len(); + let mut seen = vec![false; n]; + let mut lib_seen = vec![false; n]; + let mut stack = vec![start]; + seen[start] = true; + let mut stones = Vec::new(); + let mut libs = 0usize; + + while let Some(p) = stack.pop() { + stones.push(p); + let (nb, cnt) = neighbors(b.size, p); + for k in 0..cnt { + let q = nb[k]; + if b.cells[q] == 0 { + if !lib_seen[q] { + lib_seen[q] = true; + libs += 1; + } + } else if b.cells[q] == color && !seen[q] { + seen[q] = true; + stack.push(q); + } + } + } + (stones, libs) +} + +#[derive(Clone, Copy, Debug, PartialEq, Eq, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub enum Illegal { + OutOfBoard, + Occupied, + Suicide, + Ko, +} + +impl Illegal { + pub fn text(self) -> &'static str { + match self { + Illegal::OutOfBoard => "这个点不在棋盘上", + Illegal::Occupied => "这里已经有子了", + Illegal::Suicide => "禁着点:下下去自己没气,也提不到对方子", + Illegal::Ko => "打劫:不能立刻下回同一个局面,先到别处应一手", + } + } +} + +/// 落子的结果:新棋盘 + 被提掉的子 +#[derive(Clone, Debug)] +pub struct Placed { + pub board: Board, + pub captured: Vec, +} + +/// 在最基础的层面试着落子:只判禁着点与自杀,不管劫(劫要结合历史局面)。 +pub fn play(b: &Board, i: usize, c: Color) -> Result { + if i >= b.cells.len() { + return Err(Illegal::OutOfBoard); + } + if b.cells[i] != 0 { + return Err(Illegal::Occupied); + } + let mut nb = b.clone(); + nb.cells[i] = c.stone(); + + let mut captured = Vec::new(); + let (nb_list, cnt) = neighbors(b.size, i); + for k in 0..cnt { + let q = nb_list[k]; + if nb.cells[q] == c.other().stone() { + let (stones, libs) = group_info(&nb, q); + if libs == 0 { + for s in stones { + nb.cells[s] = 0; + captured.push(s); + } + } + } + } + // 提完之后自己这块还得有气 + let (_, libs) = group_info(&nb, i); + if libs == 0 { + return Err(Illegal::Suicide); + } + Ok(Placed { + board: nb, + captured, + }) +} + +/// 终局原因 +#[derive(Clone, Copy, Debug, PartialEq, Eq, Serialize, Deserialize)] +#[serde(rename_all = "lowercase")] +pub enum EndReason { + /// 双方各停一手,数子终局 + Scored, + Resign, + Timeout, +} + +/* --------------------------------- 数子 --------------------------------- */ + +#[derive(Clone, Debug, PartialEq, Serialize)] +#[serde(rename_all = "camelCase")] +pub struct Score { + pub black: f64, + pub white: f64, + pub black_stones: usize, + pub white_stones: usize, + pub black_terr: usize, + pub white_terr: usize, + /// 双方都能进、不算任何一方的空点 + pub neutral: usize, + pub komi: f64, +} + +impl Score { + pub fn winner(&self) -> Color { + if self.black >= self.white { + Color::B + } else { + Color::W + } + } + + /// 目差(黑 - 白,白方视角取负) + pub fn margin(&self) -> f64 { + (self.black - self.white).abs() + } +} + +/// 中国规则数子:本方活子数 + 只被本方包围的空点。 +/// 双活的空点会算成 neutral —— 这是简化口径(真双活要人工判定棋块死活)。 +pub fn score_area(b: &Board, komi: f64) -> Score { + let n = b.cells.len(); + let mut seen = vec![false; n]; + let mut black_terr = 0usize; + let mut white_terr = 0usize; + let mut neutral = 0usize; + + for i in 0..n { + if b.cells[i] != 0 || seen[i] { + continue; + } + let mut region = Vec::new(); + let mut stack = vec![i]; + seen[i] = true; + let mut touch_b = false; + let mut touch_w = false; + + while let Some(p) = stack.pop() { + region.push(p); + let (nb, cnt) = neighbors(b.size, p); + for k in 0..cnt { + let q = nb[k]; + match b.cells[q] { + 0 => { + if !seen[q] { + seen[q] = true; + stack.push(q); + } + } + 1 => touch_b = true, + _ => touch_w = true, + } + } + } + match (touch_b, touch_w) { + (true, false) => black_terr += region.len(), + (false, true) => white_terr += region.len(), + _ => neutral += region.len(), + } + } + + let black_stones = b.stones(Color::B); + let white_stones = b.stones(Color::W); + Score { + black: (black_stones + black_terr) as f64, + white: (white_stones + white_terr) as f64 + komi, + black_stones, + white_stones, + black_terr, + white_terr, + neutral, + komi, + } +} + +/* ------------------------------ 坐标与编码 ------------------------------ */ + +/// 围棋习惯用法:跳过字母 I +const COLS: [char; MAX_SIZE] = [ + 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', +]; + +/// 点位 -> 人类记法,如 "Q16"(行号从下往上数) +pub fn coord_name(b: &Board, i: usize) -> String { + let (x, y) = (b.x_of(i), b.y_of(i)); + format!("{}{}", COLS[x], b.size - y) +} + +/// size*size 个字符:'.' 空 / 'b' 黑 / 'w' 白 +pub fn encode_board(b: &Board) -> String { + let mut s = String::with_capacity(b.cells.len()); + for &c in &b.cells { + s.push(match c { + 1 => 'b', + 2 => 'w', + _ => '.', + }); + } + s +} + +pub fn decode_board(s: &str, size: usize) -> Board { + let size = size.clamp(2, MAX_SIZE); + let mut b = Board::new(size); + for (i, ch) in s.chars().take(b.cells.len()).enumerate() { + b.cells[i] = match ch { + 'b' | 'B' | '1' => 1, + 'w' | 'W' | '2' => 2, + _ => 0, + }; + } + b +} + +/// 局面指纹(棋盘 + 该谁走)。全局同形禁止用它做去重。 +pub fn position_key(b: &Board, turn: Color) -> String { + let mut s = encode_board(b); + s.push(turn.ch()); + s +} + +/// 同形禁着(超级劫):新局面对手要下,只要历史里出现过就判打劫。 +pub fn is_superko(keys: &[String], next: &str) -> bool { + keys.iter().any(|k| k == next) +} + +/* --------------------------------- 测试 --------------------------------- */ + +#[cfg(test)] +mod tests { + use super::*; + + /// 用 (x, y, 'b'|'w') 拼棋盘,空白处为 0 + fn board(size: usize, stones: &[(usize, usize, char)]) -> Board { + let mut b = Board::new(size); + for &(x, y, c) in stones { + b.cells[idx(size, x, y)] = if c == 'b' { 1 } else { 2 }; + } + b + } + + #[test] + fn empty_board() { + let b = Board::new(19); + assert_eq!(b.cells.len(), 361); + assert!(b.is_empty()); + assert_eq!(encode_board(&b).len(), 361); + assert_eq!(encode_board(&b).chars().filter(|c| *c == '.').count(), 361); + } + + #[test] + fn capture_single_stone() { + // 白子在中央,黑三面包围,第四手提掉 + let mut b = board(5, &[(2, 2, 'w'), (1, 2, 'b'), (3, 2, 'b'), (2, 1, 'b')]); + assert_eq!(group_info(&b, idx(5, 2, 2)).1, 1, "白子只剩一口气"); + let r = play(&b, idx(5, 2, 3), Color::B).expect("合法的一手"); + assert_eq!(r.captured, vec![idx(5, 2, 2)]); + assert_eq!(r.board.get(idx(5, 2, 2)), 0); + b = r.board; + assert_eq!(b.stones(Color::W), 0); + assert_eq!(b.stones(Color::B), 4); + } + + #[test] + fn capture_whole_group() { + // 白二子连成一块,被黑四面包住 + let b = board( + 5, + &[ + (1, 1, 'w'), + (2, 1, 'w'), + (1, 0, 'b'), + (2, 0, 'b'), + (0, 1, 'b'), + (3, 1, 'b'), + (1, 2, 'b'), + ], + ); + let (stones, libs) = group_info(&b, idx(5, 1, 1)); + assert_eq!(stones.len(), 2); + assert_eq!(libs, 1, "唯一的气在 (2,2)"); + let r = play(&b, idx(5, 2, 2), Color::B).unwrap(); + assert_eq!(r.captured.len(), 2); + assert!(r.captured.contains(&idx(5, 1, 1)) && r.captured.contains(&idx(5, 2, 1))); + } + + #[test] + fn suicide_is_illegal() { + // 白子把中央围死,黑下中间就是自杀 + let b = board(5, &[(1, 2, 'w'), (3, 2, 'w'), (2, 1, 'w'), (2, 3, 'w')]); + assert_eq!(play(&b, idx(5, 2, 2), Color::B).unwrap_err(), Illegal::Suicide); + } + + #[test] + fn capture_beats_suicide() { + // 中间这一手自己没气,但能提掉白子 —— 合法 + // (2,3) 四周全是白子:黑下这里自己没气,但能提掉 (2,2) 这颗白子 + let b = board( + 5, + &[ + (2, 2, 'w'), + (1, 3, 'w'), + (3, 3, 'w'), + (2, 4, 'w'), + (1, 2, 'b'), + (3, 2, 'b'), + (2, 1, 'b'), + ], + ); + assert_eq!(group_info(&b, idx(5, 2, 2)).1, 1, "白子只剩 (2,3) 一口气"); + let r = play(&b, idx(5, 2, 3), Color::B).expect("提子优先于自杀判定"); + assert_eq!(r.captured, vec![idx(5, 2, 2)]); + assert_eq!(group_info(&r.board, idx(5, 2, 3)).1, 1, "提完之后自己有了气"); + } + + #[test] + fn occupied_point() { + let b = board(9, &[(4, 4, 'b')]); + assert_eq!(play(&b, idx(9, 4, 4), Color::W).unwrap_err(), Illegal::Occupied); + } + + #[test] + fn corner_capture() { + // 角上的白子只有两口气 + let b = board(5, &[(0, 0, 'w'), (1, 0, 'b')]); + assert_eq!(group_info(&b, 0).1, 1); + let r = play(&b, idx(5, 0, 1), Color::B).unwrap(); + assert_eq!(r.captured, vec![0]); + } + + #[test] + fn superko_catches_recapture() { + // 经典劫形(5 路局部): + // . B W . + // B W . W + // . B W . + let start = board( + 5, + &[ + (1, 0, 'b'), + (2, 0, 'w'), + (0, 1, 'b'), + (1, 1, 'w'), + (3, 1, 'w'), + (1, 2, 'b'), + (2, 2, 'w'), + ], + ); + assert_eq!(group_info(&start, idx(5, 1, 1)).1, 1, "白子只有一口气"); + + let keys = vec![position_key(&start, Color::B)]; + let black_takes = play(&start, idx(5, 2, 1), Color::B).expect("黑提白一子"); + assert_eq!(black_takes.captured, vec![idx(5, 1, 1)]); + assert!(!is_superko(&keys, &position_key(&black_takes.board, Color::W))); + + // 白若立刻提回,局面就与开局完全相同 → 全局同形,禁止 + let white_back = play(&black_takes.board, idx(5, 1, 1), Color::W).expect("基本规则上可提"); + assert_eq!(white_back.captured, vec![idx(5, 2, 1)]); + assert_eq!(white_back.board, start, "提回后回到原局面"); + assert!(is_superko(&keys, &position_key(&white_back.board, Color::B))); + } + + #[test] + fn superko_helper() { + let keys = vec!["abcw".to_string(), "defb".to_string()]; + assert!(is_superko(&keys, "abcw")); + assert!(!is_superko(&keys, "zzzw")); + assert!(!is_superko(&[], "abcw")); + } + + #[test] + fn scoring_counts_stones_and_territory() { + // 5x5:黑占左边两条线,白占右边两条线,中间空 + let mut b = Board::new(5); + for y in 0..5 { + b.cells[idx(5, 0, y)] = 1; + b.cells[idx(5, 1, y)] = 1; + b.cells[idx(5, 3, y)] = 2; + b.cells[idx(5, 4, y)] = 2; + } + let s = score_area(&b, 7.5); + assert_eq!(s.black_stones, 10); + assert_eq!(s.white_stones, 10); + assert_eq!(s.black_terr, 0); + assert_eq!(s.white_terr, 0); + assert_eq!(s.neutral, 5, "中间一条是双方都能进的公共空点"); + assert_eq!(s.black, 10.0); + assert_eq!(s.white, 17.5); + assert_eq!(s.winner(), Color::W); + } + + #[test] + fn territory_enclosed_by_one_color() { + // 黑围住 3x3 中间的一点 + let b = board( + 5, + &[ + (1, 1, 'b'), + (2, 1, 'b'), + (3, 1, 'b'), + (1, 2, 'b'), + (3, 2, 'b'), + (1, 3, 'b'), + (2, 3, 'b'), + (3, 3, 'b'), + ], + ); + let s = score_area(&b, 7.5); + // 围住 1 个点 + 盘外空区(只挨着黑子)16 个点,按面积规则都算黑的地 + assert_eq!(s.black_terr, 17); + assert_eq!(s.black_stones, 8); + assert_eq!(s.black, 25.0); + assert_eq!(s.white_terr, 0); + assert_eq!(s.white, 7.5); + assert_eq!(s.neutral, 0); + } + + #[test] + fn komi_breaks_ties() { + let b = Board::new(9); + let s = score_area(&b, KOMI); + assert_eq!(s.black, 0.0); + assert_eq!(s.white, KOMI); + assert_eq!(s.winner(), Color::W); + } + + #[test] + fn coord_naming() { + let b = Board::new(19); + assert_eq!(coord_name(&b, idx(19, 15, 3)), "Q16"); + assert_eq!(coord_name(&b, idx(19, 3, 15)), "D4"); + assert_eq!(coord_name(&b, idx(19, 8, 18)), "J1"); + // 跳过 I + assert_eq!(coord_name(&b, idx(19, 8, 0)), "J19"); + assert_eq!(coord_name(&b, idx(19, 9, 0)), "K19"); + } + + #[test] + fn board_roundtrip() { + let mut b = Board::new(9); + b.cells[idx(9, 2, 2)] = 1; + b.cells[idx(9, 6, 7)] = 2; + let s = encode_board(&b); + assert_eq!(s.len(), 81); + assert_eq!(decode_board(&s, 9), b); + } + + #[test] + fn group_liberties() { + let b = board(9, &[(4, 4, 'b'), (5, 4, 'b')]); + let (stones, libs) = group_info(&b, idx(9, 4, 4)); + assert_eq!(stones.len(), 2); + assert_eq!(libs, 6, "两块连一起,气是 3+3"); + } + + #[test] + fn play_sequence_keeps_state_consistent() { + // 黑白轮流下,手里的棋子数不能凭空变化(除提子) + let mut b = Board::new(9); + let seq = [(2, 2, Color::B), (6, 6, Color::W), (3, 3, Color::B), (5, 5, Color::W)]; + let mut caps = 0; + for (x, y, c) in seq { + let r = play(&b, idx(9, x, y), c).unwrap(); + caps += r.captured.len(); + b = r.board; + } + assert_eq!(caps, 0); + assert_eq!(b.stones(Color::B), 2); + assert_eq!(b.stones(Color::W), 2); + assert_eq!(b.cells.iter().filter(|&&v| v == 0).count(), 81 - 4); + } +} diff --git a/src/server.rs b/src/server.rs new file mode 100644 index 0000000..376b83d --- /dev/null +++ b/src/server.rs @@ -0,0 +1,1048 @@ +//! 房间管理 + 权威校验 + 棋盘时钟 + 观战席 + 静态文件服务 + +use std::collections::HashMap; +use std::path::PathBuf; +use std::sync::atomic::{AtomicBool, Ordering}; +use std::sync::{Arc, Mutex}; +use std::time::{Duration, Instant}; + +use axum::extract::ws::{Message, WebSocket, WebSocketUpgrade}; +use axum::extract::State; +use axum::http::{header, StatusCode, Uri}; +use axum::response::{IntoResponse, Response}; +use axum::routing::get; +use axum::Router; +use futures_util::{SinkExt, StreamExt}; +use tokio::net::TcpListener; +use tokio::sync::mpsc::UnboundedSender; + +use crate::protocol::*; +use crate::rules::{ + coord_name, encode_board, is_superko, play, position_key, score_area, Board, Color, EndReason, + Illegal, KOMI, MAX_SIZE, +}; + +// 编译期把 public/ 打进来的资源表(build.rs 生成) +include!(concat!(env!("OUT_DIR"), "/assets_gen.rs")); + +pub const DEFAULT_MINUTES: f64 = 20.0; +pub const MAX_MINUTES: f64 = 240.0; +pub const DEFAULT_SIZE: usize = 19; + +const CODE_CHARS: &[u8] = b"ACDEFGHJKLMNPQRTUVWXY34679"; // 去掉了容易看错的字符 +const EMPTY_ROOM_TTL: Duration = Duration::from_secs(10 * 60); +const IDLE_ROOM_TTL: Duration = Duration::from_secs(4 * 60 * 60); + +/// 房间内最多留几条语音 +const MAX_VOICES: usize = 40; +/// 房间语音总量上限(base64 字符数,约 8MB 原始音频) +const MAX_VOICE_BYTES: usize = 12 * 1024 * 1024; +/// 单条语音上限(base64 字符数,30 秒 opus 约 250K,留足余量) +const MAX_VOICE_B64: usize = 640 * 1024; +/// 单条语音最长时长(毫秒) +const MAX_VOICE_MS: u32 = 60_000; + +/* --------------------------------- 房间 --------------------------------- */ + +#[derive(Clone, Copy, Debug)] +pub struct Seat { + pub conn: u64, +} + +pub struct Room { + pub code: String, + pub size: usize, + pub board: Board, + pub turn: Color, + pub over: bool, + pub winner: Option, + pub reason: Option, + pub history: Vec, + /// 每手之后的局面指纹,keys[0] 是开局(用于全局同形判定) + pub keys: Vec, + pub clocks: ClockState, + pub total_ms: u64, + pub clock_at: Instant, + pub players: [Option; 2], + pub spectators: Vec, + pub rematch: Vec, + pub touched_at: Instant, + pub voices: Vec, + pub next_voice_id: u64, + pub captures: Captures, + /// 连续停了几手 + pub passes: u32, + pub score: Option, +} + +/// 一条语音:音频以 base64 存内存(30 秒 opus 大约 100~250KB) +#[derive(Clone, Debug)] +pub struct VoiceClip { + pub id: u64, + pub from: Color, + pub at: u64, + pub mime: String, + pub duration_ms: u32, + pub data: String, + pub bytes: usize, +} + +impl Room { + pub fn new(code: &str, minutes: f64, size: usize) -> Room { + let total_ms = if minutes > 0.0 { + (minutes * 60_000.0).round() as u64 + } else { + 0 + }; + let size = clamp_size(Some(size)); + let board = Board::new(size); + let now = Instant::now(); + Room { + code: code.to_string(), + size, + keys: vec![position_key(&board, Color::B)], + board, + turn: Color::B, + over: false, + winner: None, + reason: None, + history: Vec::new(), + clocks: ClockState { + b: total_ms, + w: total_ms, + }, + total_ms, + clock_at: now, + players: [None, None], + spectators: Vec::new(), + rematch: Vec::new(), + touched_at: now, + voices: Vec::new(), + next_voice_id: 0, + captures: Captures { b: 0, w: 0 }, + passes: 0, + score: None, + } + } + + fn seat(&self, c: Color) -> Option { + self.players[c.ix()] + } + + /// 两个座位都有人(计时才推进) + fn seated(&self) -> bool { + self.players[0].is_some() && self.players[1].is_some() + } + + /// 当前剩余时间(把正在进行中的那一手算进去,但不改动存储值) + pub fn remaining(&self) -> ClockState { + let mut out = self.clocks; + if self.total_ms > 0 && !self.over { + let elapsed = self.clock_at.elapsed().as_millis() as u64; + out.set(self.turn, out.get(self.turn).saturating_sub(elapsed)); + } + out + } + + /// 落子前把这一手花掉的时间结算掉,并把时钟基准推到现在 + fn settle_clock(&mut self) { + if self.total_ms == 0 { + return; + } + let now = Instant::now(); + let elapsed = now.duration_since(self.clock_at).as_millis() as u64; + let left = self.clocks.get(self.turn).saturating_sub(elapsed); + self.clocks.set(self.turn, left); + self.clock_at = now; + } + + fn reset(&mut self) { + let board = Board::new(self.size); + self.keys = vec![position_key(&board, Color::B)]; + self.board = board; + self.turn = Color::B; + self.over = false; + self.winner = None; + self.reason = None; + self.history.clear(); + self.clocks = ClockState { + b: self.total_ms, + w: self.total_ms, + }; + self.clock_at = Instant::now(); + self.rematch.clear(); + self.captures = Captures { b: 0, w: 0 }; + self.passes = 0; + self.score = None; + // 新的一局,语音记录也从头开始(id 继续递增,前端缓存不会串) + self.voices.clear(); + } + + fn state_msg(&self, you: Option) -> StateMsg { + let slot = |c: Color, name: &'static str| PlayerSlot { + connected: self.seat(c).is_some(), + name, + }; + StateMsg { + code: self.code.clone(), + size: self.size, + board: encode_board(&self.board), + turn: self.turn, + you, + spectating: you.is_none(), + over: self.over, + winner: self.winner, + reason: self.reason, + history: self.history.iter().rev().take(240).rev().cloned().collect(), + players: Players { + b: slot(Color::B, "黑方"), + w: slot(Color::W, "白方"), + }, + rematch: self.rematch.clone(), + clocks: self.remaining(), + total_ms: self.total_ms, + spectators: self.spectators.len(), + captures: self.captures, + passes: self.passes, + komi: KOMI, + score: self.score.clone(), + voices: self + .voices + .iter() + .map(|v| VoiceMeta { + id: v.id, + from: v.from, + at: v.at, + duration_ms: v.duration_ms, + }) + .collect(), + } + } + + /// 终局:数子 + fn finish_by_score(&mut self) { + let s = score_area(&self.board, KOMI); + self.winner = Some(s.winner()); + self.reason = Some(EndReason::Scored); + self.score = Some(s); + self.over = true; + } + + /// 存一条语音,超过条数/体积上限就丢最旧的 + fn push_voice(&mut self, from: Color, mime: String, duration_ms: u32, data: String) -> u64 { + self.next_voice_id += 1; + let id = self.next_voice_id; + let bytes = data.len(); + self.voices.push(VoiceClip { + id, + from, + at: now_ms(), + mime, + duration_ms, + data, + bytes, + }); + while self.voices.len() > MAX_VOICES { + self.voices.remove(0); + } + let mut total: usize = self.voices.iter().map(|v| v.bytes).sum(); + while total > MAX_VOICE_BYTES && self.voices.len() > 1 { + if let Some(dropped) = self.voices.first() { + total -= dropped.bytes; + } + self.voices.remove(0); + } + id + } +} + +/* -------------------------------- 连接与状态 -------------------------------- */ + +pub struct Conn { + pub tx: UnboundedSender, + pub alive: Arc, +} + +#[derive(Clone, Debug)] +struct Meta { + room: Option, + color: Option, +} + +impl Default for Meta { + fn default() -> Self { + Meta { + room: None, + color: None, + } + } +} + +#[derive(Default)] +pub struct Inner { + pub rooms: HashMap, + pub conns: HashMap, + metas: HashMap, + next_id: u64, +} + +pub struct App { + inner: Mutex, +} + +impl App { + pub fn new() -> Arc { + Arc::new(App { + inner: Mutex::new(Inner::default()), + }) + } + + pub fn room_count(&self) -> usize { + self.inner.lock().unwrap().rooms.len() + } + + pub fn conn_count(&self) -> usize { + self.inner.lock().unwrap().conns.len() + } + + fn register(&self, tx: UnboundedSender, alive: Arc) -> u64 { + let mut inner = self.inner.lock().unwrap(); + inner.next_id += 1; + let id = inner.next_id; + inner.conns.insert(id, Conn { tx, alive }); + inner.metas.insert(id, Meta::default()); + id + } + + fn detach(&self, id: u64) { + let mut inner = self.inner.lock().unwrap(); + let inner = &mut *inner; + leave_room(inner, id, false); + inner.conns.remove(&id); + inner.metas.remove(&id); + } +} + +/* --------------------------------- 工具 --------------------------------- */ + +fn now_iface() -> Instant { + Instant::now() +} + +fn now_ms() -> u64 { + std::time::SystemTime::now() + .duration_since(std::time::UNIX_EPOCH) + .map(|d| d.as_millis() as u64) + .unwrap_or(0) +} + +fn make_code(rooms: &HashMap) -> String { + // 小 PRNG 就够:房号只有 4 位,不涉及安全 + let mut state = { + let t = std::time::SystemTime::now() + .duration_since(std::time::UNIX_EPOCH) + .map(|d| d.subsec_nanos() as u64) + .unwrap_or(12345); + (t ^ ((rooms.len() as u64) << 7)) | 1 + }; + loop { + let mut code = String::with_capacity(4); + for _ in 0..4 { + state ^= state << 13; + state ^= state >> 7; + state ^= state << 17; + code.push(CODE_CHARS[(state % CODE_CHARS.len() as u64) as usize] as char); + } + if !rooms.contains_key(&code) { + return code; + } + } +} + +fn clamp_minutes(v: Option) -> f64 { + match v { + Some(n) if n.is_finite() && n > 0.0 => { + let m = (n * 100.0).round() / 100.0; + m.min(MAX_MINUTES) + } + _ => 0.0, // 0 = 不限时;缺省时用 DEFAULT_MINUTES(见调用处) + } +} + +fn clamp_size(v: Option) -> usize { + match v { + Some(9) => 9, + Some(13) => 13, + Some(n) if n > MAX_SIZE => MAX_SIZE, + Some(n) if n >= 5 => n, + _ => DEFAULT_SIZE, + } +} + +fn send(conns: &HashMap, id: u64, msg: &ServerMsg) { + if let Some(c) = conns.get(&id) { + let _ = c.tx.send(Message::Text(msg.to_json().into())); + } +} + +fn broadcast_state(conns: &HashMap, room: &Room) { + for c in Color::ALL { + if let Some(seat) = room.seat(c) { + send( + conns, + seat.conn, + &ServerMsg::State(Box::new(room.state_msg(Some(c)))), + ); + } + } + for &sid in &room.spectators { + send( + conns, + sid, + &ServerMsg::State(Box::new(room.state_msg(None))), + ); + } +} + +fn broadcast_clock(conns: &HashMap, room: &Room) { + let msg = ServerMsg::Clock { + clocks: room.remaining(), + turn: room.turn, + }; + let json = msg.to_json(); + for c in Color::ALL { + if let Some(seat) = room.seat(c) { + if let Some(conn) = conns.get(&seat.conn) { + let _ = conn.tx.send(Message::Text(json.clone().into())); + } + } + } + for &sid in &room.spectators { + if let Some(conn) = conns.get(&sid) { + let _ = conn.tx.send(Message::Text(json.clone().into())); + } + } +} + +/// 房间里发一次全量状态 +fn broadcast(inner: &mut Inner, code: &str) { + let Inner { rooms, conns, .. } = inner; + if let Some(room) = rooms.get(code) { + broadcast_state(conns, room); + } +} + +/// 把同一条消息发给房间里的所有人(两个座位 + 观战者) +fn broadcast_all(conns: &HashMap, room: &Room, msg: &ServerMsg) { + let json = msg.to_json(); + for c in Color::ALL { + if let Some(seat) = room.seat(c) { + if let Some(conn) = conns.get(&seat.conn) { + let _ = conn.tx.send(Message::Text(json.clone().into())); + } + } + } + for &sid in &room.spectators { + if let Some(conn) = conns.get(&sid) { + let _ = conn.tx.send(Message::Text(json.clone().into())); + } + } +} + +/// 只认 audio/* 的 mime,别的一律按 webm 处理,避免前端拿去当别的类型播 +fn sanitize_mime(mime: Option) -> String { + match mime { + Some(m) if m.to_ascii_lowercase().starts_with("audio/") && m.len() <= 64 => m, + _ => "audio/webm".to_string(), + } +} + +fn leave_room(inner: &mut Inner, id: u64, notify: bool) { + let Inner { + rooms, conns, metas, .. + } = inner; + let Some(meta) = metas.get(&id).cloned() else { + return; + }; + let mut touched: Option = None; + if let Some(code) = &meta.room { + if let Some(room) = rooms.get_mut(code) { + if let Some(c) = meta.color { + if room.seat(c).map(|s| s.conn) == Some(id) { + room.players[c.ix()] = None; + room.clock_at = now_iface(); // 有人离开时暂停计时 + } + } + room.spectators.retain(|&s| s != id); + room.touched_at = now_iface(); + touched = Some(code.clone()); + } + } + if let Some(m) = metas.get_mut(&id) { + m.room = None; + m.color = None; + } + if let Some(code) = touched { + if let Some(room) = rooms.get(&code) { + broadcast_state(conns, room); + } + } + if notify { + send(conns, id, &ServerMsg::Left); + } +} + +/* -------------------------------- 消息处理 -------------------------------- */ + +fn handle(app: &App, id: u64, msg: ClientMsg) { + let mut guard = app.inner.lock().unwrap(); + let inner = &mut *guard; + let meta = inner.metas.get(&id).cloned().unwrap_or_default(); + + match msg { + ClientMsg::Create { minutes, size } => { + leave_room(inner, id, false); + let code = make_code(&inner.rooms); + let mins = match minutes { + None => DEFAULT_MINUTES, + Some(n) => clamp_minutes(Some(n)), + }; + let board_size = clamp_size(size); + let mut room = Room::new(&code, mins, board_size); + room.players[Color::B.ix()] = Some(Seat { conn: id }); + inner.rooms.insert(code.clone(), room); + if let Some(m) = inner.metas.get_mut(&id) { + m.room = Some(code.clone()); + m.color = Some(Color::B); + } + broadcast(inner, &code); + } + + ClientMsg::Join { code, spectate } => { + let code = code.trim().to_uppercase(); + if !inner.rooms.contains_key(&code) { + send(&inner.conns, id, &ServerMsg::error("房间不存在,检查一下房号?")); + return; + } + if let Some(prev) = meta.room.clone() { + if prev != code { + leave_room(inner, id, false); + } + } + let want_spectate = spectate.unwrap_or(false); + + // 已经在座位上(重连/重复 join)就留在原座位 + let mut slot: Option = None; + if !want_spectate { + let room = &inner.rooms[&code]; + for c in Color::ALL { + if room.seat(c).map(|s| s.conn) == Some(id) { + slot = Some(c); + } + } + if slot.is_none() { + if room.seat(Color::B).is_none() { + slot = Some(Color::B); + } else if room.seat(Color::W).is_none() { + slot = Some(Color::W); + } + } + } + + { + let room = inner.rooms.get_mut(&code).unwrap(); + match slot { + Some(c) => { + room.players[c.ix()] = Some(Seat { conn: id }); + room.clock_at = now_iface(); + } + None => { + if !room.spectators.contains(&id) { + room.spectators.push(id); + } + } + } + room.touched_at = now_iface(); + } + + if let Some(m) = inner.metas.get_mut(&id) { + m.room = Some(code.clone()); + m.color = slot; + } + if slot.is_none() && !want_spectate { + send( + &inner.conns, + id, + &ServerMsg::error("两个座位都有人了,你先观战"), + ); + } + broadcast(inner, &code); + } + + ClientMsg::Move { at } => { + let Some(code) = meta.room.clone() else { return }; + let Some(room) = inner.rooms.get_mut(&code) else { + return; + }; + let Some(color) = meta.color else { + send(&inner.conns, id, &ServerMsg::error("你在观战,不能落子")); + return; + }; + if room.over { + send(&inner.conns, id, &ServerMsg::error("这一局已经结束了")); + return; + } + if room.turn != color { + send(&inner.conns, id, &ServerMsg::error("还没轮到你落子")); + return; + } + if at < 0 || at as usize >= room.size * room.size { + send(&inner.conns, id, &ServerMsg::error(Illegal::OutOfBoard.text())); + return; + } + let at = at as usize; + + let placed = match play(&room.board, at, color) { + Ok(p) => p, + Err(e) => { + let msg = e.text(); + send(&inner.conns, id, &ServerMsg::error(msg)); + return; + } + }; + + // 全局同形(超级劫) + let next_key = position_key(&placed.board, color.other()); + if is_superko(&room.keys, &next_key) { + send(&inner.conns, id, &ServerMsg::error(Illegal::Ko.text())); + return; + } + + room.settle_clock(); + let note = coord_name(&room.board, at); + room.captures.add(color, placed.captured.len()); + room.board = placed.board; + room.keys.push(next_key); + room.passes = 0; + room.history.push(HistoryItem { + at: Some(at), + note, + color, + cap: placed.captured.len(), + }); + room.turn = color.other(); + room.clock_at = now_iface(); + room.rematch.clear(); + + broadcast(inner, &code); + } + + ClientMsg::Pass => { + let Some(code) = meta.room.clone() else { return }; + let Some(room) = inner.rooms.get_mut(&code) else { + return; + }; + let Some(color) = meta.color else { + send(&inner.conns, id, &ServerMsg::error("你在观战,不能停手")); + return; + }; + if room.over { + send(&inner.conns, id, &ServerMsg::error("这一局已经结束了")); + return; + } + if room.turn != color { + send(&inner.conns, id, &ServerMsg::error("还没轮到你")); + return; + } + room.settle_clock(); + room.passes += 1; + room.keys.push(position_key(&room.board, color.other())); + room.history.push(HistoryItem { + at: None, + note: "停一手".to_string(), + color, + cap: 0, + }); + room.turn = color.other(); + room.clock_at = now_iface(); + room.rematch.clear(); + if room.passes >= 2 { + room.finish_by_score(); + } + broadcast(inner, &code); + } + + ClientMsg::Resign => { + let Some(code) = meta.room.clone() else { return }; + let Some(color) = meta.color else { return }; + let Some(room) = inner.rooms.get_mut(&code) else { + return; + }; + if room.over { + return; + } + room.over = true; + room.winner = Some(color.other()); + room.reason = Some(EndReason::Resign); + broadcast(inner, &code); + } + + ClientMsg::Rematch => { + let Some(code) = meta.room.clone() else { return }; + let Some(color) = meta.color else { return }; + let Some(room) = inner.rooms.get_mut(&code) else { + return; + }; + if !room.over { + send( + &inner.conns, + id, + &ServerMsg::error("还没下完,先别急着再来一局"), + ); + return; + } + if !room.rematch.contains(&color) { + room.rematch.push(color); + } + // 对手已经离开就不用等了,直接重开 + let opponent_gone = room.seat(color.other()).is_none(); + if room.rematch.len() >= 2 || opponent_gone { + room.reset(); + } + broadcast(inner, &code); + } + + ClientMsg::Leave => { + leave_room(inner, id, true); + } + + ClientMsg::Voice { + mime, + duration_ms, + data, + } => { + let Some(code) = meta.room.clone() else { return }; + let Some(color) = meta.color else { + send(&inner.conns, id, &ServerMsg::error("观战不能发语音")); + return; + }; + if data.is_empty() { + return; + } + if data.len() > MAX_VOICE_B64 { + send( + &inner.conns, + id, + &ServerMsg::error("这段语音太长了,说短一点再发"), + ); + return; + } + let mime = sanitize_mime(mime); + let duration_ms = duration_ms.unwrap_or(0).min(MAX_VOICE_MS); + let Some(room) = inner.rooms.get_mut(&code) else { + return; + }; + let vid = room.push_voice(color, mime.clone(), duration_ms, data.clone()); + room.touched_at = now_iface(); + + let msg = ServerMsg::Voice(VoiceMsg { + id: vid, + from: color, + at: now_ms(), + mime, + duration_ms, + data, + }); + broadcast_all(&inner.conns, room, &msg); + } + + ClientMsg::VoiceGet { id: vid } => { + let Some(code) = meta.room.clone() else { return }; + let Some(room) = inner.rooms.get(&code) else { + return; + }; + if let Some(clip) = room.voices.iter().find(|v| v.id == vid) { + send( + &inner.conns, + id, + &ServerMsg::VoiceData { + id: clip.id, + mime: clip.mime.clone(), + data: clip.data.clone(), + }, + ); + } else { + send( + &inner.conns, + id, + &ServerMsg::error("这条语音已经过期了"), + ); + } + } + + ClientMsg::Ping => {} + } +} + +/* -------------------------------- HTTP / WS -------------------------------- */ + +fn mime_of(name: &str) -> &'static str { + let ext = name.rsplit('.').next().unwrap_or("").to_ascii_lowercase(); + match ext.as_str() { + "html" | "htm" => "text/html; charset=utf-8", + "js" | "mjs" => "text/javascript; charset=utf-8", + "css" => "text/css; charset=utf-8", + "json" | "webmanifest" => "application/json; charset=utf-8", + "png" => "image/png", + "jpg" | "jpeg" => "image/jpeg", + "svg" => "image/svg+xml", + "ico" => "image/x-icon", + "woff2" => "font/woff2", + "mp3" => "audio/mpeg", + "webp" => "image/webp", + _ => "application/octet-stream", + } +} + +/// 开发时优先用磁盘上的 public/(改了文件立刻生效) +fn public_dir() -> Option { + if let Ok(p) = std::env::var("PUBLIC_DIR") { + let p = PathBuf::from(p); + if p.is_dir() { + return Some(p); + } + } + let cwd = PathBuf::from("public"); + if cwd.is_dir() { + return Some(cwd); + } + let exe = std::env::current_exe().ok()?; + let near = exe.parent()?.join("public"); + if near.is_dir() { + Some(near) + } else { + None + } +} + +fn disk_asset(key: &str) -> Option<(String, Vec)> { + if key.contains("..") { + return None; + } + let dir = public_dir()?; + let path = dir.join(key.trim_start_matches('/')); + let body = std::fs::read(&path).ok()?; + Some((mime_of(&path.to_string_lossy()).to_string(), body)) +} + +fn embedded_asset(key: &str) -> Option<(&'static str, &'static [u8])> { + ASSETS + .iter() + .find(|(k, _, _)| *k == key) + .map(|(_, mime, body)| (*mime, *body)) +} + +async fn static_handler(State(app): State>, uri: Uri) -> Response { + let path = uri.path(); + if path == "/health" || path == "/healthz" { + let body = format!( + r#"{{"ok":true,"rooms":{},"conns":{},"engine":"rust","game":"go","mode":"{}"}}"#, + app.room_count(), + app.conn_count(), + if public_dir().is_some() { "disk" } else { "embedded" } + ); + return ( + [(header::CONTENT_TYPE, "application/json; charset=utf-8")], + body, + ) + .into_response(); + } + + let key = if path == "/" { "/index.html" } else { path }; + // 顺序:磁盘 → 内置;找不到具体文件就回退到首页(支持 #房号 邀请链接) + if let Some((mime, body)) = disk_asset(key) { + return ( + [ + (header::CONTENT_TYPE, mime), + (header::CACHE_CONTROL, "no-cache".to_string()), + ], + body, + ) + .into_response(); + } + if let Some((mime, body)) = embedded_asset(key) { + return ( + [ + (header::CONTENT_TYPE, mime.to_string()), + (header::CACHE_CONTROL, "no-cache".to_string()), + ], + body, + ) + .into_response(); + } + if let Some((mime, body)) = disk_asset("/index.html") { + return ( + [ + (header::CONTENT_TYPE, mime), + (header::CACHE_CONTROL, "no-cache".to_string()), + ], + body, + ) + .into_response(); + } + if let Some((mime, body)) = embedded_asset("/index.html") { + return ( + [ + (header::CONTENT_TYPE, mime.to_string()), + (header::CACHE_CONTROL, "no-cache".to_string()), + ], + body, + ) + .into_response(); + } + (StatusCode::NOT_FOUND, "not found").into_response() +} + +async fn ws_handler(ws: WebSocketUpgrade, State(app): State>) -> Response { + // 语音走 base64,单条最大 ~640KB,留一倍余量 + ws.max_message_size(2 * 1024 * 1024) + .max_frame_size(2 * 1024 * 1024) + .on_upgrade(move |socket| handle_socket(app, socket)) +} + +async fn handle_socket(app: Arc, socket: WebSocket) { + let (mut sender, mut receiver) = socket.split(); + let (tx, mut rx) = tokio::sync::mpsc::unbounded_channel::(); + let alive = Arc::new(AtomicBool::new(true)); + let id = app.register(tx, alive.clone()); + + let writer = tokio::spawn(async move { + while let Some(msg) = rx.recv().await { + if sender.send(msg).await.is_err() { + break; + } + } + let _ = sender.close().await; + }); + + while let Some(next) = receiver.next().await { + let Ok(msg) = next else { break }; + alive.store(true, Ordering::Relaxed); + let text = match msg { + Message::Text(t) => t.as_str().to_string(), + Message::Close(_) => break, + _ => continue, + }; + let Ok(cmsg) = serde_json::from_str::(&text) else { + continue; + }; + handle(&app, id, cmsg); + } + + app.detach(id); + let _ = writer.await; +} + +/// 心跳:发 ping 探活,睡死过去的连接直接清掉 +async fn heartbeat(app: Arc) { + let mut tick = tokio::time::interval(Duration::from_secs(30)); + tick.set_missed_tick_behavior(tokio::time::MissedTickBehavior::Delay); + loop { + tick.tick().await; + let dead: Vec = { + let mut inner = app.inner.lock().unwrap(); + let mut dead = Vec::new(); + let inner = &mut *inner; + for (id, conn) in inner.conns.iter_mut() { + if !conn.alive.swap(false, Ordering::Relaxed) { + dead.push(*id); + } else { + let _ = conn.tx.send(Message::Ping(Vec::new().into())); + } + } + for id in &dead { + leave_room(inner, *id, false); + inner.conns.remove(id); + inner.metas.remove(id); + } + dead + }; + if !dead.is_empty() { + println!("[heartbeat] 清理 {} 条失活连接", dead.len()); + } + } +} + +/// 时钟:每 500ms 推进一次并广播;同时回收空房间 +async fn ticker(app: Arc) { + let mut tick = tokio::time::interval(Duration::from_millis(500)); + tick.set_missed_tick_behavior(tokio::time::MissedTickBehavior::Delay); + loop { + tick.tick().await; + let mut inner = app.inner.lock().unwrap(); + let Inner { rooms, conns, .. } = &mut *inner; + let now = Instant::now(); + let mut expired: Vec = Vec::new(); + let mut timed_out: Vec = Vec::new(); + + for (code, room) in rooms.iter_mut() { + if !room.over && room.total_ms > 0 { + if !room.seated() { + room.clock_at = now; // 有一方不在,暂停计时 + } else if room.remaining().get(room.turn) == 0 { + room.clocks.set(room.turn, 0); + room.over = true; + room.winner = Some(room.turn.other()); + room.reason = Some(EndReason::Timeout); + timed_out.push(code.clone()); + } else { + broadcast_clock(conns, room); + } + } + let empty = !room.seated(); + if empty && now.duration_since(room.touched_at) > EMPTY_ROOM_TTL { + expired.push(code.clone()); + } else if now.duration_since(room.touched_at) > IDLE_ROOM_TTL { + expired.push(code.clone()); + } + } + for code in timed_out { + if let Some(room) = rooms.get(&code) { + broadcast_state(conns, room); + } + } + for code in expired { + rooms.remove(&code); + } + } +} + +pub fn router(app: Arc) -> Router { + Router::new() + .route("/ws", get(ws_handler)) + .fallback(get(static_handler)) + .with_state(app) +} + +/// 启动服务(ticker / heartbeat 跟着一起起来) +pub async fn serve(listener: TcpListener, app: Arc) -> std::io::Result<()> { + tokio::spawn(ticker(app.clone())); + tokio::spawn(heartbeat(app.clone())); + axum::serve(listener, router(app)) + .await + .map_err(std::io::Error::other) +} + +/// 本机 IPv4 地址(打印局域网访问地址用) +pub fn lan_addrs() -> Vec { + let mut out = Vec::new(); + // 不引第三方依赖:用一个 UDP connect 探出出口地址即可 + if let Ok(sock) = std::net::UdpSocket::bind("0.0.0.0:0") { + if sock.connect("8.8.8.8:80").is_ok() { + if let Ok(addr) = sock.local_addr() { + out.push(addr.ip().to_string()); + } + } + } + out +} diff --git a/tests/e2e.rs b/tests/e2e.rs new file mode 100644 index 0000000..2c8fc41 --- /dev/null +++ b/tests/e2e.rs @@ -0,0 +1,330 @@ +//! 联机 e2e:双客户端 + 观战 + 落子 + 提子 + 停一手数子 + 认输 + 再来一局 + HTTP 静态资源 + +use std::time::Duration; + +use futures_util::{SinkExt, StreamExt}; +use serde_json::{json, Value}; +use tokio::io::{AsyncReadExt, AsyncWriteExt}; +use tokio::net::{TcpListener, TcpStream}; +use tokio_tungstenite::tungstenite::Message; +use tokio_tungstenite::{connect_async, MaybeTlsStream, WebSocketStream}; + +use cngo::server::{self, App}; + +type Ws = WebSocketStream>; + +const TIMEOUT: Duration = Duration::from_secs(5); + +async fn start() -> u16 { + let app = App::new(); + let listener = TcpListener::bind("127.0.0.1:0").await.unwrap(); + let port = listener.local_addr().unwrap().port(); + tokio::spawn(async move { + let _ = server::serve(listener, app).await; + }); + port +} + +async fn conn(port: u16) -> Ws { + let (ws, _) = connect_async(format!("ws://127.0.0.1:{port}/ws")) + .await + .expect("连不上 websocket"); + ws +} + +async fn send(ws: &mut Ws, v: Value) { + ws.send(Message::Text(v.to_string().into())) + .await + .expect("发送失败"); +} + +async fn recv_json(ws: &mut Ws) -> Value { + loop { + let next = tokio::time::timeout(TIMEOUT, ws.next()) + .await + .expect("等服务端消息超时") + .expect("连接已关闭") + .expect("websocket 错误"); + if let Message::Text(t) = next { + return serde_json::from_str(&t).expect("服务端返回的不是 JSON"); + } + } +} + +/// 跳过 clock 心跳,只取全量 state +async fn recv_state(ws: &mut Ws) -> Value { + loop { + let v = recv_json(ws).await; + if v["t"] == "state" { + return v; + } + } +} + +/// 一直读到满足条件的 state(广播会积压,用条件筛而不是按顺序数) +async fn state_where(ws: &mut Ws, mut f: impl FnMut(&Value) -> bool) -> Value { + loop { + let v = recv_state(ws).await; + if f(&v) { + return v; + } + } +} + +/// 一直读到指定类型的消息 +async fn msg_of(ws: &mut Ws, tag: &str) -> Value { + loop { + let v = recv_json(ws).await; + if v["t"] == tag { + return v; + } + } +} + +fn idx(x: i64, y: i64) -> i64 { + y * 9 + x +} + +#[tokio::test] +async fn two_players_play_a_short_game() { + let port = start().await; + let mut black = conn(port).await; + let mut white = conn(port).await; + + // 黑方建房(9 路,5 分钟) + send(&mut black, json!({"t": "create", "minutes": 5, "size": 9})).await; + let s = recv_state(&mut black).await; + let code = s["code"].as_str().unwrap().to_string(); + assert_eq!(code.len(), 4); + assert_eq!(s["size"], 9); + assert_eq!(s["you"], "b"); + assert_eq!(s["turn"], "b"); + assert_eq!(s["totalMs"], 300_000); + assert_eq!(s["board"].as_str().unwrap().len(), 81); + assert_eq!(s["spectating"], false); + assert_eq!(s["passes"], 0); + assert_eq!(s["komi"], 7.5); + + // 白方加入 + send(&mut white, json!({"t": "join", "code": code})).await; + let s = recv_state(&mut white).await; + assert_eq!(s["you"], "w"); + assert_eq!(s["players"]["b"]["connected"], true); + assert_eq!(s["players"]["w"]["connected"], true); + let _ = state_where(&mut black, |v| v["players"]["w"]["connected"] == true).await; + + // 黑落天元 E5 + send(&mut black, json!({"t": "move", "at": idx(4, 4)})).await; + let s = state_where(&mut black, |v| { + v["history"].as_array().is_some_and(|h| !h.is_empty()) + }) + .await; + assert_eq!(s["turn"], "w"); + assert_eq!(s["history"][0]["note"], "E5"); + assert_eq!(s["history"][0]["at"], idx(4, 4)); + assert_eq!(s["history"][0]["color"], "b"); + + // 黑连着走两手:第二手会被挡回来 + send(&mut black, json!({"t": "move", "at": idx(2, 2)})).await; + let e = msg_of(&mut black, "error").await; + assert_eq!(e["msg"], "还没轮到你落子"); + + // 白走 D7,黑再走同一个点 → 已经有子 + send(&mut white, json!({"t": "move", "at": idx(3, 2)})).await; + let _ = state_where(&mut white, |v| v["turn"] == "b").await; + send(&mut black, json!({"t": "move", "at": idx(4, 4)})).await; + let e = msg_of(&mut black, "error").await; + assert_eq!(e["msg"], "这里已经有子了"); + + // 观战者 + let mut spec = conn(port).await; + send(&mut spec, json!({"t": "join", "code": code, "spectate": true})).await; + let s = recv_state(&mut spec).await; + assert_eq!(s["spectating"], true); + assert!(s["you"].is_null()); + assert_eq!(s["spectators"], 1); + + send(&mut spec, json!({"t": "move", "at": idx(0, 0)})).await; + let e = msg_of(&mut spec, "error").await; + assert_eq!(e["msg"], "你在观战,不能落子"); + + // 黑停一手,白也停一手 → 数子终局 + send(&mut black, json!({"t": "pass"})).await; + let _ = state_where(&mut black, |v| v["passes"] == 1).await; + send(&mut white, json!({"t": "pass"})).await; + let s = state_where(&mut black, |v| v["over"] == true).await; + assert_eq!(s["reason"], "scored"); + assert!(s["score"].is_object(), "数子结果要带出来"); + assert_eq!(s["score"]["komi"], 7.5); + assert_eq!(s["history"].as_array().unwrap().len(), 4); + assert_eq!(s["history"][3]["note"], "停一手"); + assert!(s["history"][3]["at"].is_null()); + + // 双方都点再来一局 → 重置 + send(&mut black, json!({"t": "rematch"})).await; + let _ = state_where(&mut black, |v| { + v["rematch"].as_array().is_some_and(|r| !r.is_empty()) + }) + .await; + send(&mut white, json!({"t": "rematch"})).await; + let s = state_where(&mut black, |v| v["over"] == false).await; + assert_eq!(s["turn"], "b"); + assert_eq!(s["history"].as_array().unwrap().len(), 0); + assert_eq!(s["clocks"]["b"], 300_000); + assert!(s["score"].is_null()); + assert_eq!(s["passes"], 0); + + // 离开 + send(&mut white, json!({"t": "leave"})).await; + let v = msg_of(&mut white, "left").await; + assert_eq!(v["t"], "left"); +} + +#[tokio::test] +async fn capture_and_resign() { + let port = start().await; + let mut black = conn(port).await; + let mut white = conn(port).await; + + send(&mut black, json!({"t": "create", "minutes": 0, "size": 9})).await; + let s = recv_state(&mut black).await; + let code = s["code"].as_str().unwrap().to_string(); + send(&mut white, json!({"t": "join", "code": code})).await; + let _ = recv_state(&mut white).await; + + // 黑 B9 → 白 A9(角上)→ 黑 A8 提掉角上一子 + send(&mut black, json!({"t": "move", "at": idx(1, 0)})).await; + let _ = state_where(&mut white, |v| v["turn"] == "w").await; + send(&mut white, json!({"t": "move", "at": idx(0, 0)})).await; + let _ = state_where(&mut black, |v| v["turn"] == "b").await; + send(&mut black, json!({"t": "move", "at": idx(0, 1)})).await; + + let s = state_where(&mut black, |v| { + v["history"].as_array().is_some_and(|h| h.len() == 3) + }) + .await; + assert_eq!(s["history"][2]["cap"], 1, "角上一子被提"); + assert_eq!(s["captures"]["b"], 1); + assert_eq!(s["captures"]["w"], 0); + let board = s["board"].as_str().unwrap(); + assert_eq!(board.as_bytes()[0], b'.', "提掉之后 A9 应该空出来"); + assert_eq!(s["history"][2]["note"], "A8"); + + // 白认输 + send(&mut white, json!({"t": "resign"})).await; + let s = state_where(&mut black, |v| v["over"] == true).await; + assert_eq!(s["winner"], "b"); + assert_eq!(s["reason"], "resign"); + assert!(s["score"].is_null(), "认输不数子"); +} + +#[tokio::test] +async fn join_unknown_room_reports_error() { + let port = start().await; + let mut ws = conn(port).await; + send(&mut ws, json!({"t": "join", "code": "ZZZZ"})).await; + let v = recv_json(&mut ws).await; + assert_eq!(v["t"], "error"); + assert!(v["msg"].as_str().unwrap().contains("房间不存在")); +} + +#[tokio::test] +async fn static_and_health_endpoints() { + let port = start().await; + + let body = http_get(port, "/health").await; + assert!(body.contains(r#""ok":true"#), "health 返回:{body}"); + assert!(body.contains(r#""engine":"rust""#)); + assert!(body.contains(r#""game":"go""#)); + + let html = http_get(port, "/").await; + assert!(html.contains("围棋"), "首页没内嵌进来"); + assert!(html.contains("/js/client/main.js"), "首页没引用静态模块"); + + let js = http_get(port, "/js/client/main.js").await; + assert!(js.contains("from '../shared/rules.js'"), "静态 JS 没被服务"); + let rules = http_get(port, "/js/shared/rules.js").await; + assert!(rules.contains("scoreArea"), "规则镜像没被服务"); + + // 未知路径回退首页(支持 #房号 邀请链接) + let fallback = http_get(port, "/some/deep/link").await; + assert!(fallback.contains("围棋")); +} + +async fn http_get(port: u16, path: &str) -> String { + let mut stream = TcpStream::connect(("127.0.0.1", port)).await.unwrap(); + let req = format!("GET {path} HTTP/1.1\r\nHost: 127.0.0.1\r\nConnection: close\r\n\r\n"); + stream.write_all(req.as_bytes()).await.unwrap(); + let mut buf = Vec::new(); + tokio::time::timeout(TIMEOUT, stream.read_to_end(&mut buf)) + .await + .expect("HTTP 读取超时") + .unwrap(); + String::from_utf8_lossy(&buf).to_string() +} + +#[tokio::test] +async fn voice_clips_roundtrip() { + let port = start().await; + let mut black = conn(port).await; + let mut white = conn(port).await; + + send(&mut black, json!({"t": "create", "minutes": 0, "size": 13})).await; + let s = recv_state(&mut black).await; + let code = s["code"].as_str().unwrap().to_string(); + assert_eq!(s["size"], 13); + assert!(s["voices"].as_array().unwrap().is_empty()); + + send(&mut white, json!({"t": "join", "code": code})).await; + let _ = recv_state(&mut white).await; + + // 黑方按住说话发一条(这里只验证传输链路,data 是占位字节) + send( + &mut black, + json!({"t": "voice", "mime": "audio/webm", "durationMs": 1200, "data": "QUJDRA=="}), + ) + .await; + let a = msg_of(&mut black, "voice").await; + let b = msg_of(&mut white, "voice").await; + assert_eq!(a["id"], 1); + assert_eq!(b["id"], 1, "对方也要收到同一条"); + assert_eq!(a["from"], "b"); + assert_eq!(a["durationMs"], 1200); + assert_eq!(a["mime"], "audio/webm"); + assert_eq!(a["data"], "QUJDRA=="); + + // 观战者进房间:state 里只带元信息,不带音频本体 + let mut spec = conn(port).await; + send(&mut spec, json!({"t": "join", "code": code, "spectate": true})).await; + let s = recv_state(&mut spec).await; + let voices = s["voices"].as_array().unwrap(); + assert_eq!(voices.len(), 1); + assert_eq!(voices[0]["id"], 1); + assert_eq!(voices[0]["from"], "b"); + assert!(voices[0].get("data").is_none(), "state 不该塞音频本体"); + + // 点历史记录才单独取音频 + send(&mut spec, json!({"t": "voiceGet", "id": 1})).await; + let d = msg_of(&mut spec, "voiceData").await; + assert_eq!(d["id"], 1); + assert_eq!(d["data"], "QUJDRA=="); + + // 观战只能听不能发 + send( + &mut spec, + json!({"t": "voice", "mime": "audio/webm", "durationMs": 800, "data": "QUJDRA=="}), + ) + .await; + let e = msg_of(&mut spec, "error").await; + assert_eq!(e["msg"], "观战不能发语音"); + + // 超长语音被拒 + let big = "A".repeat(700 * 1024); + send( + &mut black, + json!({"t": "voice", "mime": "audio/webm", "durationMs": 30000, "data": big}), + ) + .await; + let e = msg_of(&mut black, "error").await; + assert!(e["msg"].as_str().unwrap().contains("太长")); +}