本地环境映射
状态：已准入，正在构建中
本地环境映射合同已在 SDK 内核级别被准入。面向开发者的完整呈现表面正处于积极构建中。
本页面涵盖的内容
本地环境映射合同规定了 应用开发者如何消费 Runtime 投影出的本地环境状态 —— 以及他们不能推断或绕过什么。公开导出准入是封闭的；任何偏离都将被视为封闭失败。
导出边界
已准入的 SDK 公开导出位于 TypeScript target export map 中。每个条目声明如下：
| 字段 | 目的 |
|---|---|
| 导出 ID | 稳定身份 |
| 公开入口 | 明确准入的导入路径或 root-client surface |
| Owner 边界 | 该导出归属的 SDK surface |
| 理由 | 该边界存在的原因 |
目录是封闭的。应用不能通过约定发明新的导出。
关键禁止路径
| 禁止 | 原因 |
|---|---|
runtime/internal/** | 运行时私有表面；应用只能使用已准入的 SDK 客户端 |
kit/internal/** | Kit 私有表面 |
其他 App 的应用层代码 (apps/**) | App 不依赖其他 App 的应用层代码 |
读者场景：应用读取本地环境计划
应用作者希望展示 Runtime 解析出的本地 setup 计划。
- 应用创建 client。 使用 SDK root client 或
@nimiplatform/sdk/runtime。 - 应用调用投影。 通过已准入的 Runtime 本地环境 helper 读取 plan、 selected sources、activation gate 或 dependency jobs。
- SDK 保留 Runtime 真值。 Helper 返回类型化 Runtime 投影状态；它不从 文件系统、Python、PATH、endpoint、包管理器或本地引擎细节推断 ready。
- 已删除兼容路径 fail closed。 除非 TypeScript target export map 明确准入， 否则不存在公开的
local-envSDK 子路径。
如果应用尝试 import { internal } from '@nimiplatform/sdk/runtime/internal'，边界检查将拒绝。
本机制不做的事情
- 它不允许应用访问
runtime/internal/**。 - 它不允许应用绕过 Runtime 私有边界。
- 它不允许应用通过应用层代码分叉本地环境访问。
- 它不允许通过约定创建新的边界。