用户画像
本章根据不同读者的技术背景与角色需求，提供相应的阅读路径。各路径之间相互引用，便于横向查阅。
初次接触者
如果您初步了解 Nimi，并希望快速评估平台的技术定位与适用场景：
- 平台 → 愿景：了解项目的核心目标与架构定位。
- 平台 → 六条基础协议：了解跨越不同“世界”的核心技术契约，这是 Nimi 作为平台的基础。
- 平台 → 架构：查看跨越核心层的架构全景图，明确组件的权责归属。
- Nimi Coding → 概览：了解仓库使用的 canonical-authority 工具。
- 参考 → 术语表：阅读过程中的术语对照表。
通过此路径，您将能够清晰概述 Nimi 平台的核心功能与架构理念。
世界创作者
如果您的目标是架构并发布一个数字世界（包括规则、设定、Character 及场景）：
- 平台 → 愿景：了解 Nimi 架构中“世界”的定义。
- Realm：掌握数字世界底座的三大核心要素：语义真相、世界状态及历史轨迹。
- 参考 → 世界字段：在数据字段层面查看规范对“世界”的具体定义。
- 参考 → 六条基础协议：理解您的世界在跨域交互时必须遵守的基础契约。
- Realm → 创作者经济：了解跨世界的创作者经济模型与价值流转规则。
应用开发者
如果您计划使用 Nimi SDK 构建应用：
- Start → 创建 Nimi App：用 app-tools scaffold 一个开发者 App，或把同样的所有权规则映射到已有 App。
- SDK → 第一次 AI 调用：使用 owner 能力意图发起 Runtime-backed 文本生成，具体执行实现由 Runtime 选择。
- SDK → 概览 与 SDK → 边界：在导入 SDK module 前理解公开 App 边界。
- 平台 → 在 App 中使用 Kit：复用共享 UI、shell、auth、telemetry、AIConfig composition 与 feature surfaces。
- Start → 使用 Nimi Lab：研究能力集成 App 与 App Tools 已收录的切片。
- Start → 故障排查：理解 Runtime、SDK、Nimi Lab 与 scaffold 失败。
AI Agent 接入方
如果您计划将外部或本地的 AI 宿主接入为 Nimi 世界中的独立参与者：
- 平台 → 愿景：了解将 AI Agent 视作平台“参与者”的设计理念。
- 平台 → 外部 Agent 与 平台 → 参与权限：查阅外部第三方 Agent 接入的安全与参与模型。
- Runtime → 委派能力：了解接入网关架构及相关输出防火墙机制。
- 参考 → Agent 字段：查看 Agent 的内部数据结构及涉外的核心属性。
- 参考 → 状态机：掌握委派 Provider 机制及委派会话状态机模型。
Nimi Coding 采用者
如果您希望将 Nimi Coding canonical-authority 工具引入自有开发流程中：
- Nimi Coding → 概览：了解权威工具及其仓库边界。
- Nimi Coding → 宿主集成：了解受管宿主文件和同步流程。
- Nimi Coding → CLI 参考：了解受支持的 authority 命令。
- 参考 → 禁止主张：了解开发规范中对“反模式”与“走捷径”做法的严格限制。
审计与评审人员
如果您负责依据权威基准对平台代码或主张进行评审和溯源：
- 参考 → 权威域：核查系统中各项数据与权力的最终归属。
- 参考 → 术语表：利用统一的术语体系对齐技术语义。
- Nimi Coding → CLI 参考：审查受支持的 authority 诊断与验证命令。