vcode — 手搓一个能真干活的 AI Agent

BlueLeap Pro 配套课程项目：从 0 写出你自己的 Claude Code。 每个 package 对应课程的一个部分，每节课一个里程碑。

架构

vwork (Web 前端)      vcode (TUI)
        ↘              ↙
      vcode-agent-sdk (SDK)
              ↓
        vagent (内核)
   agent loop · 工具 · 权限 · 上下文

Package	是什么	课程部分
vagent	内核：agent loop、OpenAI 兼容 provider、read/write/bash 三件套、权限闸门、迷你 compact	Part 1 手搓内核
vcode-agent-sdk	SDK：query() / createAgent()，给应用开发者	Part 2 封 SDK
vcode	终端客户端：渲染事件流 + 交互式权限确认	Part 3 客户端
vwork	Web 客户端（规划中）	Part 3 客户端

快速开始

npm install
npm run build
npm test                      # 内核测试（scripted provider，不需要 API key）

# 接真模型（任何 OpenAI 兼容端点）
export VAGENT_BASE_URL=https://api.deepseek.com   # 默认
export VAGENT_API_KEY=sk-...
export VAGENT_MODEL=deepseek-chat                 # 默认
node packages/vcode/dist/cli.js

设计原则

1. 零运行时依赖 — 整个内核只用 Node 20+ 标准库，node_modules 里没有魔法
2. 每个文件一节课 — types / provider / tools / agent 各管一件事，单文件能读完
3. 安全默认 — 文件操作锁 cwd、危险工具过权限、单轮上限防失控