# CodeTank **Repository Path**: escms/codetank ## Basic Information - **Project Name**: CodeTank - **Description**: 在浏览器里用 JavaScript 写坦克 AI,让它们在同一片战场上对战。 创意来源于腾讯 AlloyTeam 的 **CodeTank(代码坦克)**。本项目为独立重制开发:玩法与 API 命名参照公开资料还原,物理规则参照 Robocode 体系重新实现,与原版并非逐字节一致。 前端为原生 HTML / CSS / JavaScript,服务端只用 Node 内置模块,无需安装依赖。 - **Primary Language**: NodeJS - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-18 - **Last Updated**: 2026-11-18 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # CodeTank 代码坦克对战平台:左侧写机器人代码,右侧战场实时对战。创意来源于腾讯 AlloyTeam CodeTank(原项目源码未公开),本项目使用WorkBuddy重制开发。 且增加了针对小朋友的图形化编程模式,增加趣味性的同时还可以学习编程。 **在线演示**:https://codetank.escms.cn ## 功能 - 确定性帧仿真引擎,浏览器 / Node / 联机服务端 / 积木页共用 - 11 张地图、6 类随机道具、26 块图形化积木课 - 混战 / 1v1 / 红蓝对抗 / 循环赛四种模式,0.5× / 1× / 2× 速度 - ELO 排行榜、逐帧回放、音效、可选云端存档与微信登录(需自行配置云服务和 OAuth) - 测试运行:单坦克实时调试代码,不判胜负、不计分 ## 快速开始 ```bash # 静态演示(本地 HTTP 服务) python -m http.server 8787 # 打开 http://localhost:8787 # 完整后端(联机 + 可写后台 + SQLite) node server/server.js # 打开 http://localhost:8787 ``` 请勿用 `file://` 直接打开:浏览器会禁用 Worker,玩家代码不会执行。 ## 目录 ``` index.html 主站(编辑器 + 战场 + 帮助) blocks.html 积木乐园(少儿图形化编程) api-help.html 完整 API 文档与对战规则 admin.html 管理后台(本地服务端模式) js/core/ 引擎、地图、渲染、沙箱、代码安全审查 js/ui/ 编辑器、战斗控制器、账号、音效 js/blocks/ 积木 DSL 与课程 server/ 可选 Node 服务端(零 npm 依赖) dist/ 静态发布包(由 build-static.sh 生成) ``` ## 云端配置(可选) 默认使用本机 localStorage。如需接入自定义云服务,在 HTML 中注入: ```html ``` 本项目不包含任何云服务配置、密钥或账号。静态托管版本为演示模式:对局存档带 `[demo]` 标记,不计入 ELO / 胜场 / 积分;可信排名需部署自带权威结算的 Node 服务端。 ## 安全说明 - 用户代码在 Worker 沙箱运行,编译前做词法审查;这是语言级隔离,不是形式化安全边界 - 公开坦克代码按需拉取并审查后才会执行 - 默认没有管理员口令;部署时请通过环境变量 `CODE_TANK_ADMIN_KEY` 设置 - 坦克代码上传采用 `ct1:` 可逆编码规避内容检测误判,不是加密 ## 截图 ![输入图片说明](docs/1.png) ![输入图片说明](docs/2.png) ![输入图片说明](docs/3.png) ![输入图片说明](docs/4.png) ![输入图片说明](docs/5.png) ## 许可 MIT — 见 [LICENSE](LICENSE)。