SuperAPI AI 工具集

1k-architecture

通用与其它

查看项目

更新于 10-15 21:09

技能介绍

用途:帮助开发者理解 OneKey 多平台钱包 monorepo 的整体架构与代码组织,适用于阅读项目结构、梳理包依赖、判断导入规则或安排组件位置时参考。

平台结构:apps/desktop 为 Electron 桌面应用(Windows、macOS、Linux);apps/mobile 为 React Native 移动应用(iOS、Android);apps/ext 为浏览器扩展(Chrome、Firefox、Edge、Brave);apps/web 为渐进式 Web 应用;apps/web-embed 为可嵌入钱包组件。

核心包:packages/core 负责区块链协议实现、密码学与硬件钱包通信;packages/kit 负责应用逻辑、状态管理与 API 集成;packages/kit-bg 为后台服务与 worker;packages/components 为基于 Tamagui 的跨平台 UI 组件;packages/shared 为平台抽象、工具与构建配置;packages/qr-wallet-sdk 负责气隙钱包二维码通信。

主要模式:支持 40 多条区块链的可插拔实现;用 Tamagui 做跨平台 UI;平台专属文件使用 .native.ts、.desktop.ts、.web.ts、.ext.ts 后缀;硬件钱包通过自定义 @onekeyfe/hd-* SDK 集成;状态管理使用 Jotai。

导入层级(严格强制):shared 不得导入其他 OneKey 包;components 只能导入 shared;kit-bg 只能导入 shared 与 core;kit 可导入 shared、components、kit-bg;各 app 可导入所有包。禁止任何向上导入,否则会破坏构建并产生循环依赖。

使用方式:新增导入前先核对层级、检查是否造成循环依赖;新增功能时先搜索相似实现并沿用既有命名与结构;修改代码时保持既有架构决策与风格。提交前检查导入层级、平台后缀、安全模式、错误处理、状态管理、UI 组件、翻译与测试模式是否一致。

限制:资料未提供具体安装命令、版本要求、许可与收费信息,暂未提供。