Nova 是 Solotopia 基于 Unity 深度定制的一套游戏客户端通用解决方案，把资源、UI、网络、热更、配置、存档、多语言、SDK 接入等通用底座统一收敛、持续维护，让业务团队只需聚焦玩法本身。

• Unity 6000.4.2f1 或更高版本。
• Built-in Render Pipeline、IL2CPP、.NET Standard 2.1、C# 9。
• 可访问 Solotopia UPM Registry；EDM 与默认 Unity MCP Provider 通过 OpenUPM 解析。
• Android / iOS 构建仍需安装相应平台模块、SDK 与签名环境。

flowchart LR
    Business[业务代码] --> Nova[Nova.* 静态门面]
    Nova --> Components[Runtime Components]
    Components --> Managers[Managers / 生命周期]
    Components --> Services[资源 · 网络 · UI · 配置 · 存档]
    Editor[Editor 工具] --> Pipeline[配置与构建流水线]
    Pipeline --> Components
    Packages[Kit / SDK 子包] --> Nova

Nova 以场景中的 Nova 根节点为统一入口，所有子系统经 Nova.* 静态门面暴露，调用契约一致、风格统一：

1. 下载火种脚本 NovaSpark.cs，放入消费项目的 Assets/Editor/。
2. Unity 编译完成后，在弹窗中确认“引入框架”。脚本会补齐 Framework、EDM、所需 Registry、PlugPals 配置与 Android 发布设置，并触发 UPM Resolve。
3. 等待包解析和编译完成；PlugPals 窗口成功打开后，火种脚本会自动删除自身。

NovaSpark 会修改项目配置。已有 Nova 项目重复导入时，它会先列出待矫正项并等待确认；本仓这类使用本地 file: Framework 的源码工程会自动跳过。

首次接触 Nova 时，建议先在 Unity Package Manager 中导入 Nova Framework / MainDemo，按提示确认旧 Sample 检测与启动场景设置，然后进入 Play Mode。MainDemo 是可运行参考，不是强制项目模板；详细步骤见 MainDemo README。

自建项目应先阅读 Nova Agent 快速入口，根据项目现有拓扑接入完整的 canonical Nova.prefab，并完成所需配置、资源与数据初始化后再调用 Nova.* API。

using NovaFramework.Runtime;

var handle = await Nova.Asset.LoadAsync<Sprite>("icons/hero");
image.sprite = handle.Asset;
handle.Release();

var instance = await Nova.Prefab.InstantiateAsync("prefabs/bullet", parent);
Nova.Prefab.Destroy(instance);

var serialId = Nova.UI.OpenUIViewAsync<MyView>();

void OnEnable()  => Nova.Event.Subscribe<MyEvent>(OnEvent);
void OnDisable() => Nova.Event.Unsubscribe<MyEvent>(OnEvent);

var evt = ReferencePool.Get<MyEvent>();
Nova.Event.Fire(this, evt);

var row = Nova.Table.GetTable<TbItem>().Get(itemId);

Assets/Framework/Scripts/Runtime/  # 运行时核心与业务模块
Assets/Framework/Scripts/Editor/   # 编辑器工具 / Inspector / 窗口 / 流水线
Assets/Framework/Docs/             # 事实层文档
Assets/Framework/Minds/            # 知识层文档（Obsidian Vault）
Assets/Samples/                    # 示例与演示（MainDemo 等）
UPMPackages/com.solotopia.*/       # 配套基础库 / Kit / SDK 包
Packages/manifest.json             # 工程依赖入口

Nova 采用双层文档体系，团队多年沉淀持续累积：

Assets/Framework/
├── Docs/                # 事实层：当前 API、字段、调用步骤（随代码同步）
│   ├── INDEX.md         # 按任务类型导航
│   ├── ARCHITECTURE.md  # 总体架构
│   ├── Runtime/         # 运行时模块文档
│   └── Editor/          # 编辑器扩展文档
└── Minds/               # 知识层：架构决策、术语、模式、踩坑结论（Obsidian Vault）

• Docs（事实层）回答"如何使用" —— 日常实现任务与业务开发的优先入口。
• Minds（知识层）回答"为何如此设计" —— 调整 public API / 命名 / 架构边界时查阅。
• 冲突时以 Docs + 源码为基线；未命中时如实说明，禁止凭印象编造。

常用入口：Start Here · Docs Index · Architecture · Nova Project Skills

将两层文档提供给 AI Agent，助手即可同时具备"会用 API + 知晓边界 + 沿用既有模式 + 避开已知坑"——这是最快上手的路径，也是项目长期可持续维护的保障。

• 版本变化与升级注意事项见 CHANGELOG。
• 贡献代码或提交问题前请阅读 CONTRIBUTING 与 Code of Conduct。
• 安全漏洞请按 SECURITY 提供的私密渠道报告，不要提交公开 Issue。

本项目基于 MIT License 开源。

Copyright © 2026 Solotopia