Skip to content

Platform Kit ​

@nimiplatform/kit 为 Nimi App 提供可复用 UI 与宿主接入构件。真实 consumer 可以共享视觉语言、无障碍行为、shell adapter 与常用交互 primitive, 产品真相不会因此进入 Kit。

当前职责 ​

Kit surface职责
ui共享 token、theme 与 UI primitive
auth可复用 authentication presentation 与 adapter
core宿主无关 utility 与 capability helper
telemetryRenderer telemetry 与 error-boundary helper
shell/tauri有界 native-host glue

Kit 按真实需求扩展。只有真实 App 或宿主需要复用同一行为,而且产品 owner 已经明确时,才增加 reusable surface。Kit 不为“生态完整”预建公共功能目录。

Owner 边界 ​

Kit 可以持有可复用呈现与宿主无关交互行为,但不持有:

  • App 特有产品流程或布局;
  • Runtime 的 LocalAgent、Conversation、Memory、Knowledge 或 readiness;
  • Realm 的世界、Character、账户或社交真相;
  • Avatar 执行或渲染权威;
  • Provider 路由、后端执行或 authorization truth。

App 通过公共 subpath 引入 Kit,并在本地组合 primitive。App 不导入 Kit 私有路径,也不在 App 本地重复建立共享 primitive owner。

读者场景:复用共享 Dialog ​

一个 App 需要使用第一方表面已有的无障碍确认 Dialog。

  1. App 引入 Kit 的公共 Dialog 与共享 semantic token。
  2. App 提供自己的产品文案与 action handler。
  3. Kit 负责焦点管理、键盘行为与共享视觉语义。
  4. 产品决策仍归 App,可复用交互 primitive 仍归 Kit。

视觉系统细节见设计模式,App 接入方式见 在 App 中使用 Kit。

来源依据 ​

Nimi 文档:可安装、开源、本地优先的个人 AI 产品。