oasis7 docs

Game + Engine Docs Hub

oasis7 文档中心

这里不是首页的替代品,而是给已经决定继续看的人准备的深读入口。当前仍是技术预览(尚不可玩);先在首页看清玩法、玩家位置和公开边界,再按目标进入完整文档与验证链路。

先首页,后深读:这里负责补充阅读,不负责第一次介绍项目 当前仍为技术预览(尚不可玩)

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

按目标开始

如果你已经知道自己想继续看,就按目标选入口;如果你还在判断这是什么游戏,先回首页。

Overview

我已经知道想继续看,先给我完整全貌

适合第一次接触 oasis7 的读者,先用一份白皮书式长说明建立全貌,再决定要不要继续下钻玩法、架构和测试文档。

推荐顺序:白皮书式项目总览 → 文档目录

打开项目总览

Deck

我要按固定顺序快速讲清这个项目

适合路演、合作沟通或内部统一口径时使用:直接打开站内 HTML deck,用一条顺序化叙事讲清项目定位、玩法差异、当前阶段与下一步。

推荐顺序:HTML 路演 Deck → 项目总览 / 首页证据链

打开 HTML 路演 Deck

Preview

我还想先确认现在公开到了哪一步

适合想先看当前公开边界、证据链和下载定位的访客;这部分优先在首页理解,文档中心只负责补充。

推荐顺序:首页公开入口 → 文档中心目录

回到首页公开入口

Validation

我要本地验证 Viewer / Web / API

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

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

打开测试总手册

Builder Path / Skill

我要作为开发者或代理执行者跑 `oasis7` skill 的本地验证链路

这条路适合开发者、operator 或自动化代理,不是第一次认识项目的公开主入口:直接获取原始 Markdown skill 内容,再按其中命令跑本地 Provider 验证。

推荐顺序:原始 Skill Markdown → 本地验证执行

获取原始 Skill Markdown

Development

我要参与开发或继续治理

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

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

打开工程总入口

文档目录

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

Overview

白皮书式项目总览

用一份 Explanation 文档把项目目标、世界模型、玩家边界、两阶段路径和当前技术预览边界收在一起。

状态:对外总览入口(不替代真值规格)

查看文档

Deck

HTML 路演 Deck

一个站内可直接访问的顺序化演示页:把项目问题、产品主张、玩法差异、当前边界和下一阶段按 slide 顺序讲清楚。

状态:公开可访问,不替代首页与 PRD 真值

打开 Deck

Gameplay

游戏可玩性设计总纲

定义玩家动机、三层循环、工业、经济与治理的可玩性约束,是体验设计主文档。

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

查看文档

Engine

游戏性模块化架构设计

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

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

查看文档

Viewer

Viewer 使用手册

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

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

进入手册

Testing

闭环测试与套件矩阵

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

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

查看文档

Skill

`oasis7` Local Provider Skill

公开对外的 Local Provider real-play / parity skill,直接提供可抓取的 raw Markdown 内容。

状态:公开 skill 镜像(raw Markdown)

查看 raw skill

怎么使用这里

  1. 第一次接触 oasis7 时,优先回首页理解“这是什么游戏 / 你扮演谁 / 现在公开到哪一步”。
  2. 当你已经确定想继续看,再用这里进入项目总览、玩法文档、Viewer 手册、测试手册,或直接打开 `oasis7` raw skill。
  3. 如果你需要最完整、最权威的细节,继续沿链接进入仓库内的 canonical 文档。

当前口径:技术预览(Not playable yet)。这里是公开深读入口,首页才是第一次对外介绍的主面。