服务模式

​

启动 worker

blockscope serve --client-jar client.jar --threads 4 --cache 2

• --threads：请求未指定 threads 时使用的默认线程数；最多 256
• --cache：缓存的 scene/mesh 条数上限
• --cache-bytes：缓存预算（估算字节）；0 使用可用内存的一半。超出预算时按最旧优先淘汰，单个超大条目仍允许单独保留。由 supervise 启动时，若未显式指定，supervisor 会按每个 worker 的内存上限派生并传入该值
• --greedy-mesh：合并同材质、同光照的共面单位面；默认关闭
• --force-limits：提高资源上限；只应对可信输入使用
• --ignore-block-entity-nbt：跳过容器 NBT

​

请求示例

{
  "type": "render",
  "id": "job-1",
  "input": {
    "path": "/data/model.litematic"
  },
  "views": [45, 225],
  "width": 1024,
  "height": 1024,
  "supersample": 2,
  "outputDir": "/data/out"
}

• input.path 和 outputDir 必须是绝对路径
• 输入必须是普通文件
• input.hash 可选，是调用方声明的 SHA-256 身份；命中缓存时 worker 信任该值并不再读取文件，未命中时才重新计算并校验
• supervise 会把为路由计算出的 hash 注入请求，因此经 supervisor 的重复输入也能走免读缓存路径
• views 为空时默认 [45]，最多 64 个角度；有完整 mesh 时多视角并行渲染
• 输出文件为 {id}.png 或 {id}-{yaw}.png；调用方必须保证 id 和 outputDir 在并发任务中唯一，重复 id 或重复视角会覆盖同一路径
• 完整字段、结果和错误码见 引擎协议 v3

​

Supervisor

blockscope supervise \
  --client-jar client.jar \
  --workers 2 \
  --threads 4 \
  --timeout 120 \
  --memory 2048 \
  --queue 4 \
  --cache 2

​

安全边界

​

相关文档

• 引擎协议 v3
• Docker
• 故障排查
• English