oasis7 docs

Game + Engine Docs Hub

oasis7 文档中心

统一入口访问游戏设计、玩法工程、Viewer 手册与测试流程。当前为技术预览阶段(尚不可玩);建议先从首页预览验证路径判断是否继续进入完整文档与构建链路。

优先级:预览体验入口优先,完整构建与长文档次级 当前仍为技术预览(尚不可玩)

公开说明:正式公告仍在准备中;当前文档中心用于技术预览协作与验证导航,不等同于对外正式发布说明。

按目标开始

如果你不是来通读全部文档,先按当前任务选择入口。

Preview

先确认项目现在公开到了哪一步

适合第一次了解 oasis7 当前状态,先看技术预览边界、验证路径和公开口径。

推荐顺序:站点首页 → 文档中心目录

回到站点首页

Validation

我要本地验证 Viewer / Web / API

适合要跑 smoke、回归或验收的执行者,先选测试层级,再看专项手册。

推荐顺序:`testing-manual` → Viewer/Web manual

打开测试总手册

Development

我要参与开发或继续治理

适合需要进入模块 PRD/project、继续做文档治理或代码开发的协作者。

推荐顺序:仓库 README → `doc/README.md`

打开工程总入口

文档目录

目录用于技术预览阶段的信息公开与开发协作,不代表已开放玩家可玩体验。

Gameplay

游戏可玩性设计总纲

定义玩家动机、三层循环、战争与政治的可玩性约束,是体验设计主文档。

状态:主文档(持续迭代)

查看文档

Engine

游戏性模块化架构设计

定义 Gameplay WASM 分层、Kernel API、生命周期与安全边界,是玩法工程主文档。

状态:主文档(持续迭代)

查看文档

Viewer

Viewer 使用手册

覆盖 active LLM access、`--no-llm` observer/debug 限定、Web step 闭环与常见排查(Viewer 为纯观察服务)。

状态:静态镜像按 canonical 手册滚动同步

进入手册

Testing

闭环测试与套件矩阵

定义 test tier、系统性测试流程、Web 闭环约定与回归矩阵基线。

状态:权威流程文档(仓库主线维护)

查看文档

维护流程

  1. 游戏/引擎主文档基线维护在 `doc/game/*` 与 `README.md`。
  2. Viewer 与闭环测试基线维护在 `doc/world-simulator/viewer/viewer-manual.manual.md`、`doc/testing/manual/web-ui-agent-browser-closure-manual.manual.md` 与 `testing-manual.md`。
  3. 发布时同步摘要到 `site/doc/cn|en` 静态页,并由 Pages 工作流自动发布。

当前口径:技术预览(Not playable yet),手册按游戏、引擎、观测三层持续维护。