用户画像
本章根据不同读者的技术背景与角色需求，提供相应的阅读路径。各路径之间相互引用，便于横向查阅。
初次接触者
如果您初步了解 Nimi，并希望快速评估平台的技术定位与适用场景：
- 平台 → 愿景：了解项目的核心目标与架构定位。
- 平台 → 六条基础协议：了解跨越不同“世界”的核心技术契约，这是 Nimi 作为平台的基础。
- 平台 → 架构：查看跨越核心层的架构全景图，明确组件的权责归属。
- Nimi Coding → 概览：了解 Nimi Coding 这一套 AI 驱动的开发方法论。
- 参考 → 术语表：阅读过程中的术语对照表。
通过此路径，您将能够清晰概述 Nimi 平台的核心功能与架构理念。
世界创作者
如果您的目标是架构并发布一个数字世界（包括规则、设定、Agent 及场景）：
- 平台 → 愿景：了解 Nimi 架构中“世界”的定义。
- Realm：掌握数字世界底座的三大核心要素：语义真相、世界状态及历史轨迹。
- 参考 → 世界字段：在数据字段层面查看规范对“世界”的具体定义。
- 参考 → 六条基础协议：理解您的世界在跨域交互时必须遵守的基础契约。
- Realm → 创作者经济：了解跨世界的创作者经济模型与价值流转规则。
Mod 开发者
如果您希望利用受限接口，为官方桌面端提供扩展功能：
- 桌面端：了解桌面端外壳的底层逻辑，以及 Mod 作为一等扩展的机制。
- 桌面端 → Mod 体系：明确各类 Hook 回调的核心能力与边界。
- SDK → 边界：了解开发过程中必须遵守的代码隔离底线。
- 参考 → 权威域：明确 Mod 组件运行时的权限归属与限制。
应用开发者
如果您计划使用 Nimi SDK 构建应用：
- SDK → 概览：了解应用代码与平台交互的标准公开入口。
- SDK → 边界：明确应用逻辑允许触达的范围及不可跨越的安全边界。
- SDK → Runtime 客户端：掌握应用调用 Runtime 底层能力的标准路径。
- SDK → Realm 与世界客户端：了解如何将世界真相的读取与 Runtime 的动态生成能力相结合。
- 参考 → 状态机：了解应用在运行过程中需要处理的各类状态机流转。
AI Agent 接入方
如果您计划将外部或本地的 AI 宿主接入为 Nimi 世界中的独立参与者：
- 平台 → 愿景：了解将 AI Agent 视作平台“参与者”的设计理念。
- 平台 → AI Agent 安全接口：查阅针对外部第三方 Agent 接入的安全模型规范。
- Runtime → 委派能力：了解接入网关架构及相关输出防火墙机制。
- 参考 → Agent 字段：查看 Agent 的内部数据结构及涉外的核心属性。
- 参考 → 状态机：掌握委派 Provider 机制及委派会话状态机模型。
Nimi Coding 采用者
如果您希望将 Nimi Coding 方法论引入自有开发流程中：
- Nimi Coding → 概览：宏观了解该方法论及其对应的 npm 软件包。
- Nimi Coding → 白皮书：查阅支撑该方法论的工程治理理论基础。
- Nimi Coding → 议题工作流：了解从 Topic 创建、Wave 发起，历经 Packet 编排、Preflight 预检，至最终 Closeout 的完整闭环流程。
- 参考 → 禁止主张：了解开发规范中对“反模式”与“走捷径”做法的严格限制。
- 参考 → 状态机：了解保障协作流程有序推进的 Topic 及 Wave 状态机机制。
审计与评审人员
如果您负责依据权威基准对平台代码或主张进行评审和溯源：
- 参考 → 规范地图：查看公开文档与底层技术契约之间的映射关系。
- 参考 → 权威域：核查系统中各项数据与权力的最终归属。
- 参考 → 术语表：利用统一的术语体系对齐技术语义。
- Nimi Coding → 议题工作流：审查工作产物（如
topic.yaml、Packet 存档、预检及审计报告）的组织标准与约束条件。