Ovasabi Foundation（进行中 - 版本 0.0.1）用于高性能、事件驱动系统的全栈应用基础。Ovasabi Foundation 是一个集成工具包，旨在帮助希望演变代码的团队。它提供平台模块、脚手架、强制检查和文档，以启动和维护生产系统，包括：租户隔离的事件驱动架构 —— 每个操作都携带元数据：请求者是谁，哪个组织，相关ID 性能阶梯 —— 从纳秒直接调度到微秒JSON兼容的七个层面 Hermes 热平面 —— 有限的节点本地投影，适用于亚微秒操作读取 工作者编排 —— 有限的后台处理，具有重试策略和进度跟踪 内置可观察性 —— 日志、指标和痕迹通过相关ID自动链接 不是无代码平台。不是零DevOps。不是适合那些想通过削减角落来快速发展的团队。Foundation 是为那些拥抱托管基础设施、理解性能并期望其代码库演变的团队准备的。组件概述 组件 技术栈 目的 server-kit Go 后端：事件总线、工作者、Hermes、数据库、弹性、可观察性 runtime-transport TypeScript 客户端线：命令总线、信封创建、元数据存储、WebSocket/HTTP回退 runtime-sdk Rust/WASM 高性能内核：4KB控制缓冲区，无零拷贝通信 ui-minimal TypeScript/React 共享UI原语，语义主题令牌，运动助手 frontend-kit TypeScript IndexedDB 存储，元数据助手，运行时适配器，传输进度 runtime-native Tauri/Rust 原生外壳桥：安全存储，GPU句柄，设备访问 config-contracts Go/TypeScript 跨语言配置模式 数据层：PostgreSQL（持久真理），Redis（协调），协议缓冲（合同），Cap'n Proto（零拷贝边界） 性能阶梯 Foundation使用七种性能层面。每个层面的成本都经过测量和强制执行： 1. 直接调度 10–30 ns/op（同一进程，零分配） 2. 二进制帧 20–80 ns/op（借用视图） 3. 生成的protobuf ~370 ns/op（类型化的跨进程） 4. gRPC 20–30 µs/op（网络机器） 5. JSON ~30 µs/op（兼容性） 6. 原生FFI/SHM（变化）（受信计算） 7. 浏览器 + WASM + SAB（平台）（在支持的地方） 关键规则：最快的路径不能承担兼容性路径的成本。这会自动测量；回归在它们落地之前被捕获。 阅读更多：docs/foundation_benchmarks.md 第一天能力 从Foundation生成的每个项目都获得：多租户隔离——组织范围来自经过身份验证的上下文，而非客户端数据 事件驱动神经系统——规范请求→成功/失败生命周期，带有相关元数据 Hermes 热平面——节点本地、内存有限、索引读取模型，实时投影数据库变更 可恢复的文件传输——具有进度承载的基于块的上传/下载，可恢复性 有限的工作者处理——后台作业，具有指数退避、重试策略和有限队列 统一可观察性——OpenTelemetry 跟踪、结构化日志、断路器、错误分类 为开发人员提供的快速路径 从这里开始 → docs/foundation_quick_start.md（15分钟） → docs/foundation_tour.md（逐步指导） → docs/foundation_architecture_contract.md（平台/项目分离） 为架构师和评审人员提供的快速路径 从这里开始 → docs/PHILOSOPHY.md（Foundation存在的原因） → docs/foundation_architecture_contract.md → docs/foundation_nervous_system.md → docs/practice_controls.md 为AI代理和合作伙伴（代理原生工作流）提供的快速路径 从这里开始 → AGENTS.md → docs/foundation_glossary.md → docs/agent_operating_contract.md → docs/ai_threat_model.md 仓库地图 路径 目的 server-kit/ Go后端：注册、元数据、事件、工作者、弹性、可观察性、Hermes、事件日志、Redis、数据库、传输、投影网关、对象存储、大规模操作、智能信号 runtime-transport/ 协议合同、命令总线、路由注册表、二进制编解码器、Hermes投影模式 runtime-sdk/ WASM/Rust/Go 内核，4KB控制缓冲区，共享区域，运行时通道助手 runtime-native/ Tauri外壳，安全存储，原生帧，设备调度 frontend-kit/ IndexedDB存储，元数据，运行时工件，传输进度 ui-minimal/ 共享UI原语，主题令牌，运动助手 config-contracts/ 生成的配置模式 templates/ 脚手架模板复制到生成的项目 docs/ 架构、实践、指南、安全、性能、测试 tooling/ 强制脚本、清单、lint配置 核心命令 make generate-contracts # 代码生成（Protos → Go/TS） make lint # 所有linter make test # 所有测试 make check-rust # Rust格式化，clippy，测试 make verify # 完整的CI套件 make check-practice-controls # 实践矩阵 make check-doc-references # 链接验证 make docker-up # 启动本地基础设施 make test-service-backed # 使用实时DB/Redis的测试