Linden Engine
PRD v1.4

文档手册

1. 简介与概述

1.1 什么是 Linden？

Linden 是一个 AI 原生游戏开发平台，能够将自然语言提示词转化为确定性、生产级游戏资源与节点场景树。系统通过 5 个专业智能体集群协同工作，实现确定性输出与零代码覆盖。

AgentSpecialization
Game ArchitectScene hierarchy, node tree, lifecycle management
ProgrammerGDScript 2.0, C# 12, Rust bindings, AST diffing
Technical ArtistGLSL/HLSL/WGSL shaders, sprite atlases, normal maps
QA InspectorHeadless simulation, collision testing, performance profiling
Level SynthesizerProcedural level generation, difficulty pacing, biome design

1.2 核心特性

  • 提示词即玩 – 自然语言直接生成可运行原型
  • <100ms 热重载 – 实时内存增量补丁，无需重启引擎
  • 多目标导出 – 支持 WebGPU、Windows、macOS、Linux
  • AST 语法级保护 – 绝不覆盖手动编写的代码

1.3 系统需求

ComponentMinimumRecommended
BrowserChrome 113+, Safari 18+, Firefox 120+Chrome 132+ (WebGPU)
RAM4 GB8 GB
GPUWebGL 2.0 supportWebGPU / Vulkan 1.3
OSWindows 10, macOS 12, Linux (Ubuntu 22.04)Windows 11 / macOS 14+
Internet10 Mbps50 Mbps (for live agent streaming)

2. 快速上手

2.1 注册与登录

访问 Linden Studio，通过 GitHub 或 Google 账号快速登录，即可进入专属云端工作台。

2.3 首个项目: "Hello Platformer"

Create a 2D platformer with a blue character who can jump and
collect yellow coins. Add a red enemy that moves back and forth.

3. 核心概念

3.1 五大专业智能体

Game Architect: 负责场景层级与实体组件设计。

Programmer: 负责严格类型化的 GDScript 2.0 / C# 脚本生成。

Technical Artist: 负责着色器与精灵表图集生成。

QA Inspector: 负责无头物理仿真与碰撞检测。

Level Synthesizer: 负责过程式关卡生成与难度控制。

3.3 计算代币

ActivityCompute Tokens
1 prompt parsing~100-500 tokens
Generate full platformer~12,000 tokens
Shader generation~2,400 tokens
Physics tweak~800 tokens
Level generation~3,500 tokens

4. 进阶使用

4.1 智能体定向指令

@architect: "在玩家节点下添加 Area2D 用于拾取金币"
@programmer: "编写 collect_coin() 增加分数"
@artist: "生成角色的4帧行走精灵动画"
@qa: "运行1000次跳跃碰撞物理测试"

4.4 CLI 工具

npm install -g @linden/cli
linden generate -f prompt.txt -o ./game
linden test --ticks=1000 --headless

5. 高级指南与导出

5.4 多目标发布

TargetFormatPrimary Use Case
WebHTML5 + WASMBrowser play, instant sharing
Windows.exe (portable)Steam, Itch.io distribution
macOS.app (universal)Mac App Store, standalone
LinuxAppImageSteam Deck, Linux gamers
Android.apk / .aabGoogle Play Store
iOS.ipa (preview)Apple App Store
ConsolesCustom SDKPlayStation, Xbox, Switch (NDA)

6. 企业级安全与微虚拟机

6.4 Firecracker 微虚拟机沙箱

所有动态代码在独立的轻量微虚拟机内执行，限制 512MB 内存、2 vCPU，阻断外部网络套接字，确保完全隔离。

7. API 与 SDK 参考

7.1 REST 接口

POST   /api/v1/projects          - 创建项目
POST   /api/v1/generate          - 启动生成流程
POST   /api/v1/export            - 编译发布包

8. 疑难解答与排错

8.1 常见问题

IssueProbable CauseRecommended Solution
Error 400Malformed prompt syntax or JSONInspect JSON headers, test with curl -v
TimeoutProject scope too complexBatch prompt, enable async streaming, or upgrade tier
Tokens ExhaustedQuota exceededUpgrade tier or acquire pay-as-you-go token packs
Code Build FailAST Parse ErrorReview QA Inspector logs, use more constrained prompt
Low FramerateGPU / Shader loadTarget WebGPU, enable caching, or use self-hosted runner

8.3 错误码

CodeDescriptionRecommended Action
400Bad RequestVerify JSON schema & syntax
401UnauthorizedVerify API Key or re-authenticate
403ForbiddenCheck tier permissions
404Not FoundInvalid project ID specified
429Rate Limit ExceededThrottle calls or upgrade token concurrency
500Internal Engine ErrorContact Linden developer support

9. 常见问题 (FAQ)

9.1 常见问答

Q: 生成游戏需要多长时间？

标准 2D 平台跳跃类游戏仅需 30-60 秒即可完成全套逻辑与资源生成。