tqcqandClaude Code 5035520d37 docs+bench: roadmap 现状盘点 + QuickJS spike 双分支基准 (TQCQ-10)
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>
2026-09-06 14:59:38 +08:00

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)。

S
Description
No description provided
Readme
2.8 MiB
Languages
CMake 44%
C++ 33.8%
Python 22.2%