Project Status
2025 · 02 · 10
Overview
嵌入式 Zig 框架/SDK — Trait + HAL 抽象，支持 ESP32 / 桌面 / 服务器
Agent 系统 — 统一 LLM 接口 + TTS/ASR + Luau 插件，vibe-coding AI 产品
类 QUIC 协议 + 公共网络 — Noise 加密，公钥即身份，三语言互操作
终端产品集合 — App / PMS / Web / BFF / 固件，面向最终用户
Product Milestones
合计剩余 ~86k 行 · 8 线并行 · 最长路径 PMS 256h · 约 11 天全部完成
Embedded Framework
| 模块 | 描述 | 状态 | 分支 |
|---|---|---|---|
| lib/trait | 接口契约：Socket, Crypto, RNG, I2C, TLS, Time, Log, Sync, Spawner, IO, Timer | 已合入 | main |
| lib/hal | 硬件抽象：WiFi, Button, LED, Strip, IMU, Mic, Speaker, Temp, RTC, KVS | 已合入 | main |
| lib/platform/esp | ESP-IDF 绑定 + Trait/HAL 实现，多款开发板 BSP | 已合入 | main |
| lib/platform/std | Zig std 平台（桌面/服务器）+ kqueue/epoll IO 后端 | 已合入 | main |
| lib/platform/raysim | Raylib 桌面 GUI 模拟器 | 已合入 | main |
| lib/pkg/tls | 纯 Zig TLS 1.2/1.3 客户端 | 已合入 | main |
| lib/pkg/ntp | 跨平台 NTP，多服务器竞速 | 已合入 | main |
| lib/pkg/http | HTTP 客户端 | 已合入 | main |
| lib/pkg/dns | DNS 解析器 | 已合入 | main |
| lib/pkg/crypto | 加密原语 | 已合入 | main |
| lib/pkg/audio | 音频处理 | 已合入 | main |
| lib/pkg/drivers | 外设驱动（QMI8658 IMU 等） | 已合入 | main |
| lib/pkg/motion | 运动检测系统 | 已合入 | main |
| lib/pkg/input | 输入处理 | 已合入 | main |
| lib/pkg/channel | 跨平台 Channel / WaitGroup / Cancellation 原语 | 已合入 | main |
| lib/pkg/bluetooth | 纯 Zig BLE 协议栈（HCI/GAP/GATT），跨平台 | 已合入 | main |
| lib/pkg/x_proto | BLE READ_X/WRITE_X 分块传输协议 | 已合入 | main |
| lib/pkg/mqtt0 | MQTT 3.1.1 & 5.0 客户端 + Broker（已消除 std 依赖，支持 ESP32） | 已合入 | main |
| lib/pkg/io | IO trait + kqueue/epoll 后端（用于 zgrnet async） | 已合入 | main |
| bazel/esp | Bazel-native esp_zig_app 构建规则 + Opus 集成 | 已合入 | main |
| NFC 驱动 | FM175XX NFC 驱动 | 已合入 | main |
| lib/pkg/opus | Opus 编解码集成 | 已合入 | main |
| Beken 平台 | BK7258 开发板（ADC/KVS/Crypto done，WiFi/BLE 待做） | ~50% | feat/bk-platform |
| Beken 平台 | BK7258 开发板平台支持调研 | 开发中 | feat/bk-platform |
Agent Framework
| 模块 | 描述 | 语言 | 状态 |
|---|---|---|---|
| genx | 统一 LLM 接口 + Agent 框架 + Transformer pipeline | Go, Rust | 已合入 |
| chatgear | 会话管理、设备连接、状态机、端口音频流 | Go, Rust | 已合入 |
| mqtt0 | MQTT 3.1.1 & 5.0 客户端/Broker（含 benchmark） | Go, Rust | 已合入 |
| dashscope | 阿里云 DashScope（通义千问）SDK | Go, Rust | 已合入 |
| minimax | MiniMax（海螺）SDK | Go, Rust | 已合入 |
| doubaospeech | 字节豆包语音 SDK（CLI 已接入全部命令） | Go, Rust | 已合入 |
| openai-realtime | OpenAI Realtime API（WebSocket 流式） | Go | 已合入 |
| audio | 音频处理（Opus/MP3/PCM 编解码、重采样） | Go, Rust | 已合入 |
| buffer | 缓冲区工具 | Go, Rust | 已合入 |
| encoding | 编码工具 | Go, Rust | 已合入 |
| trie | 前缀树 | Go, Rust | 已合入 |
| cli | CLI 通用工具库 | Go, Rust | 已合入 |
| kv | KV 存储接口 + BadgerDB 实现 | Go | 已合入 |
| storage | FileStore 接口 + Local/S3 实现 | Go | 已合入 |
| luau | Luau 脚本运行时 | Go, Rust, C | 已合入 |
| embed | Embedding 接口（DashScope + OpenAI） | Go | 已合入 |
| graph | Entity-Relation 图接口 + KV 后端 | Go | 已合入 |
| vecstore | HNSW 近似最近邻索引 | Go | 已合入 |
| recall | 底层搜索引擎（基于 vecstore） | Go | 已合入 |
| giztoy CLI | 统一 CLI 入口 | Go | 已合入 |
| ncnn | ncnn 推理引擎 CGo 绑定（PR #75） | Go | ~85% |
| voiceprint | 声纹识别 3D-Speaker → ncnn（PR #76） | Go | ~85% |
| memory | 记忆模块（基于 Embed + Graph + Recall） | Go | ~10% |
| chatgear-zig | Zig 版 ChatGear 设备通信 | Zig | ~30% |
| e2e 重构 | 目录重组 + 统一 CLI（PR #79） | Go | ~90% |
| cortex | 高级 Agent 编排（设计文档已有） | Go | 规划中 |
| v2 协议 | 基于 zgrnet 替代 MQTT | Go | 规划中 |
Network Protocol
| 模块 | Go | Rust | Zig | 状态 |
|---|---|---|---|---|
| noise | ✓ | ✓ | ✓ | 已合入 |
| kcp | ✓ | ✓ | ✓ | 已合入 |
| net | ✓ | ✓ | ✓ | 已合入 |
| tun | ✓ | ✓ | ✓ | 已合入 |
| relay | ✓ | ✓ | ✓ | 已合入 |
| host | ✓ | ✓ | ✓ | 已合入 |
| dns | ✓ | ✓ | ✓ | 已合入 |
| dnsmgr | CGo | FFI | ✓ | 已合入 |
| proxy | ✓ | ✓ | ✓ | 已合入 |
| Bazel Zig 构建 | — | — | ✓ | 已合入 |
| config | ✓ | ✓ | ✓ | ~80% |
| async 适配 | — | — | ✓ | ~70% |
| zgrnetd | — | — | — | ~20% |
| agent 对话 | — | — | — | 规划中 |
| 服务部署 | — | — | — | 规划中 |
End-User Products
| 模块 | 描述 | 语言 | 状态 |
|---|---|---|---|
| apps/ninja | 管理后台 CLI（凭据、上下文、组织结构） | Go | 已合入 |
| sdk/go/haivivi | Go SDK（Auth, AIoT, PAL, PMS, Push） | Go | 已合入 |
| embed/lib/haivivi | 嵌入式 API 库（Bazel 集成） | Zig | 已合入 |
| embed/firmware/h106 | H106 设备固件 | Zig | 已合入 |
| embed/firmware/h2xx | H2xx 系列设备固件 | Zig | 已合入 |
| apps/web | Web 前端（React 18 + Tailwind CSS 4 + Vite + pnpm） | TypeScript | 已合入 |
| rust/bff | WebSocket BFF 代理（JSON-RPC + 订阅 + 音频流） | Rust | 已合入 |
| rust/pms | PMS 存储层（KVStore, SQLStore, SearchEngine, BlobStore） | Rust | 已合入 |
| rust/pms/sn | SN 编解码引擎 + 数据模型 | Rust | 已合入 |
| apps/ios | iOS 客户端（SwiftUI + Rust FFI，PR #14） | Swift | ~60% |
| apps/android | Android 客户端（Kotlin + Bazel） | Kotlin | ~20% |
| apps/harmony | 鸿蒙客户端（ArkTS + Bazel） | ArkTS | ~30% |
| pms-api | PMS API 服务 | Rust | ~15% |
| pms-log | 设备日志引擎（Loki-like，PR #17） | Rust | ~70% |
| ffi-spike | FFI 探索（Swift/Kotlin/ArkTS → Rust） | — | ~30% |
| apps/desktop | 桌面客户端 | — | 规划中 |
| apps/cli | 命令行客户端 | — | 规划中 |
| 设计稿实现 | 20 个 feature 设计稿逐步实现 | — | 规划中 |
| embed-zig 集成 | 跟随 embed-zig 上游更新 | Zig | 规划中 |
Meta — This Project