GitHub Deep Dive · 1jehuang/jcode

jcode

用 Rust 构建的新一代 AI 编程助手。14ms 冷启动、Swarm 多智能体协作、语义向量记忆系统、内置 Firefox 自动化、自我修改源代码——jcode 将代码助手的边界推向全新维度。

14ms
首帧时间
6.4K
GitHub Stars
Swarm
多智能体协作
语义记忆
向量嵌入 · 自动检索
J
1jehuang / jcode
Rust · v0.12.3 · Latest release May 2026
Rust 94.6% Python Swift (iOS) Shell MIT License
6,400+
⭐ Stars
128K token context
■ 五层架构总览

jcode 采用严格的五层分层架构，从用户入口到持久化存储，每层职责单一、边界清晰。

L1
入口层 · Entry Layer
处理所有外部输入形式——终端 TUI、CLI 参数、语音输入（dictate）、iOS 原生 App、Server/Client 模式连接。
Handterm TUI CLI args Voice dictate iOS App jcode serve jcode connect
▼
L2
Agent 核心层 · Agent Core
主对话循环、上下文窗口管理（128K token）、记忆检索注入、Skill 语义注入。这是 jcode 的大脑。
conversation_loop context_manager memory_retrieval skill_inject session lifecycle
▼
L3
协作层 · Coordination Layer
Swarm 多智能体编排、智能体间消息总线（DM / 广播 / repo channel）、文件冲突解决器。
swarm_coordinator messenger conflict resolver worker spawn
▼
L4
执行层 · Execution Layer
LLM Provider 路由（8+ 提供商）、20+ 工具分发（文件/Shell/浏览器/grep/git/MCP）、Firefox 浏览器自动化、自我开发循环。
provider_registry tool_dispatcher browser_agent self_dev Claude / OpenAI / Gemini
▼
L5
持久化层 · Persistence Layer
SQLite 会话存储、向量数据库（语义嵌入 1536 维）、用户 Profile 系统、跨会话记忆检索。
SQLite sessions vector DB 1536-dim embeddings profile system
■ 文档导航
🚀
搭建 · 部署 · 使用
安装方法（curl / brew / source）、Provider 认证、配置文件详解、TUI / 服务器 / Swarm 运行模式。
阅读 →
🏗️
架构 · 模块 · 文件结构
五层架构详解、10 大核心模块职责、Rust 文件树（color-coded）、crates 子系统边界、命名约定。
阅读 →
⚡
运行时 · 状态机 · 流程
Agent 对话循环状态机、Swarm 协作时序、向量记忆流水线、自我开发热重载循环、System Prompt 构造。
阅读 →
■ 核心特性
⚡
极速启动
14ms 首帧渲染，48.7ms 可交互。全 Rust 实现，无 Node.js 运行时开销，冷启动性能领先同类工具 10-50×。
🧠
语义向量记忆
每轮对话自动生成 1536 维向量嵌入，通过余弦相似度匹配检索历史记忆，后台 ambient 模式每 5 分钟合并去重。
🐝
Swarm 多智能体
Primary Agent 自动派生 Worker，多个 Agent 并行处理同一仓库——功能开发、测试编写、文档更新同时进行。
🌐
内置 Firefox 自动化
通过 Agent Bridge 集成 Firefox，支持页面导航、快照、点击、表单填写、截图、eval 执行，无需外部 Playwright。
🔧
自我开发模式
Agent 可直接修改自身 Rust 源码，自动触发 cargo build，构建成功后热重载二进制——不丢失当前会话状态。
🖥️
Handterm 渲染器
自研终端渲染引擎，1000+ FPS 渲染能力，Mermaid 图表渲染速度比 JS 版快 1800×，支持平滑部分行滚动。
🔌
8+ LLM Provider
原生支持 Claude、OpenAI、Gemini、Copilot、Azure、Ollama、LM Studio，统一 provider_registry 路由，可热切换。
📱
iOS 原生 App（开发中）
Swift 实现的 iOS 客户端，通过 Server 模式连接 jcode 后端，将完整 Agent 能力带到移动端。
■ 性能指标
首帧时间 (Time-to-first-frame)
14ms
首次可输入延迟
48.7ms
基础 RAM（禁用本地 embedding）
27.8 MB
每增加一个并发 Session
+10.4 MB
渲染帧率上限
1000+ FPS
Context Window 上限
128K tokens
■ 30 秒快速开始
macOS · Linux
curl -fsSL https://raw.githubusercontent.com/1jehuang/jcode/master/scripts/install.sh | bash

# 登录 Provider
jcode login --provider claude

# 启动
jcode
安装完成后直接运行 jcode 进入交互式 TUI。更多安装选项（Homebrew、Windows PowerShell、源码编译）、配置文件详解、运行模式说明，请参阅 搭建与部署文档 →