main
docs: - docs/roadmap.md: 设计目标回顾 / 进展盘点 / 里程碑与任务清单(仓库内 推断,未知任务显式标注待补)/ 下一步建议 - AGENTS.md/README.md 同步补全与指针;bench/README、benchmarking.md 随 TQCQ-10 落地更新 TQCQ-10 (QuickJS spike, benchmarking.md §2 item #1 / §6.3): - quickjs 双分支 vendored: bellard 2026-06-04(官方 tarball,手建静态库, _GNU_SOURCE/CONFIG_VERSION 对齐上游 Makefile)+ quickjs-ng v0.16.2 (上游 CMake);cmake/quickjs.cmake 统一别名 sbx::quickjs, SBX_QUICKJS_VARIANT 切换,比较树 build/ng/ - bench/sandbox_runtime_bench.cpp: BM_SandboxRuntimeRebuild/RealmReset/ Resident 三档生命周期阶梯 + peak_rss_kb(bench/proc_rss.hpp),内嵌 starter-bot 纯 JS 负载;基线 dev-02 / dev-02-ng - 实测: rebuild/resident = 1.27x(bellard)/ 1.17x(ng)—— 每 tick 全量 重建在预算上可承受,策略定版留模块 D;同负载 bellard 快 ~1.5x 机制修复(TQCQ-10 过程中发现): - CPM pin 改显式 URL_HASH:多参数形式下 URL#hash 后缀不触发校验, 全仓 pin 此前从未生效(含 gtest/benchmark,一并修正) - bench.py run_suite:多 *_bench 可执行文件 + family 过滤器时,零匹配 的空 stdout 不再误报 bad json 另含: .gitignore 常规工具条目、.env.example 模板、.taskmaster 任务工具状态 Co-Authored-By: Claude Code <noreply@anthropic.com>
screeps-sandbox
高性能、单机自托管的 Screeps 对战沙盒服务器:多 bot 同世界实时对战, 官方 Screeps 客户端直连 live 观战与回放。C++ + QuickJS(每 bot 独立 runtime)+ teles(事件循环 / 网关 / 可观测),单二进制、零外部中间件(无 Node/Mongo/Redis)。
状态:骨架期(TQCQ-11)。当前入库:构建骨架(CMake/CTest/CPM 离线依赖)、 持续基准体系(首版基准目标 + 基线工具 + 设计文档)。核心模块(JS 沙盒 / 世界引擎 / 网关 / 历史)随子任务陆续落地 —— 见
AGENTS.md的目录规划与docs/roadmap.md的进展盘点与任务清单。
快速开始
cmake -B build -DSBX_BUILD_TESTS=ON -DSBX_BUILD_BENCH=ON . # 零网络,Release
cmake --build build -j$(nproc)
ctest --test-dir build --output-on-failure # 含基准机制自检
# 跑基准(正式流程:基线感知)
python3 tools/bench/bench.py run
python3 tools/bench/bench.py compare --baseline bench/baselines/dev-01.json --markdown
文档
docs/roadmap.md— 设计目标回顾 / 进展盘点 / 任务规划(骨架期定位锚点)docs/benchmarking.md— 基准与性能守护体系(设计 + G5 定标方法)bench/README.md— 基准编写约定速查AGENTS.md— 仓库工程约定(依赖 / 构建 / 格式 / 目录规划)
项目边界
单机部署、性能第一(G5 由持续基准体系定标守护);不做 Steam 认证、分布式、 官方 mod 生态兼容。完整目标与模块清单见 Multica 项目《启动文档》(TQCQ-8)。
Languages
CMake
44%
C++
33.8%
Python
22.2%