跳转到主要内容

来源与公开范围

本手册写了什么

本手册是静态重编译实践的独立知识层,整理三种材料:

  1. 本项目在重写器、HLE、内存、NVN、Metal/Vulkan、Android 和 Mac bring-up 中得到的可迁移经验;
  2. GitHub 公开仓库的 README、Markdown、许可证和源码结构所能直接支持的事实;
  3. 基于上述事实重新推导的排障方法、实验模板和不可推广边界。

“本项目经验”不表示所有原始实验材料都会公开。公开版只保留方法、证据类型、结论等级和必要的抽象案例。

目标架构与当前状态分开记录。20-target-architecture.md 是根据本项目经验和公开项目设计抽象出的未来目标,不是 对当前 nxnative 实现完成度的声明;完成度仍以各项目的代码、测试和 profile 证据为准。

明确没有复制的内容

  • 没有复制外部项目的游戏专用地址、shader binary、资源、重放表或设备日志;
  • 没有复制私有仓库、私有会话、未公开附件、用户设备数据或未授权补丁;
  • 没有把外部 GPL/许可证不明实现直接搬进本项目的 MIT 代码;
  • 没有把任何游戏本体、密钥、NSP/XCI、RomFS、存档或用户数据放进手册。

外部代码即使许可证允许复用,也必须在目标项目中保留相应版权和许可证,并单独做 ABI、对象布局、线程和生命周期 审查。本手册默认提供“设计参考”和“独立重实现方向”,不是代码复制许可。

来源状态

外部来源的 URL、许可证、访问日期、HEAD/tag 和阅读范围登记在 10-source-register.md。 如果一个仓库只读到 README,就只记录 README 支持的事实;“可能解决过同类问题”必须标为推断或候选,不写成已验证 事实。无法固定公开版本的来源继续保持待核对状态。

基线

当前工作树从 nxnative 的干净提交建立手册分支;手册新增内容集中在 docs/handbook/,根目录已有源码和项目 许可证仍遵循原项目的发布范围。若将来导出为独立知识库,必须按 14-publishing-checklist.md 重新检查历史、第三方目录、根 README 和许可证,而不能只复制一个目录就宣称完成发布审计。