leaper-agent-cn

🧠 瞬知自学习智能体 (Leaper Agent CN)

纯国内、零依赖、自进化的 AI Agent 框架

✨ 特性

• 🇨🇳 纯国内闭环 — 支持 DeepSeek / 通义千问 / 智谱GLM / Moonshot / 百度文心
• 🔌 四大渠道 — 飞书 / 钉钉 / 企业微信 / 微信公众号
• 🧠 六层自进化记忆 — 从短期记忆到长期知识的自动进化
• 🛠️ 28+ 内置工具 — 终端/文件/代码/搜索/记忆/图片/文档...
• 🔄 Tool Calling 循环 — 完整的多轮工具调用 Agent Loop
• 🎭 Mixture of Agents — 多模型并行生成，择优输出
• 📸 视觉理解 — 通义千问 VL 图片分析 + OCR
• 🔒 安全优先 — 隐私脱敏 / 危险命令拦截 / 操作审批
• 📦 零外部依赖 — 纯 Node.js 原生模块，开箱即用
• ⚡ TypeScript — 完整类型系统，编译后 JS 发布

🚀 快速开始

安装

npm install leaper-agent-cn

配置

创建 leaper.yaml：

model: deepseek-chat

providers:
  deepseek:
    apiKey: sk-xxx

gateway:
  feishu:
    appId: cli_xxx
    appSecret: xxx

或使用初始化向导：

npx leaper-cn init

启动

npx leaper-cn start

📊 架构

┌─────────────────────────────────────────────────┐
│                   用户消息                        │
└────────────────────┬────────────────────────────┘
                     ▼
┌─────────────────────────────────────────────────┐
│          渠道层 (Gateway)                        │
│   飞书 │ 钉钉 │ 企业微信 │ 微信公众号            │
└────────────────────┬────────────────────────────┘
                     ▼
┌─────────────────────────────────────────────────┐
│              Agent Loop                          │
│   消息 → LLM → Tool Call → LLM → ... → 响应     │
│                                                  │
│   ┌──────────┐    ┌──────────────┐              │
│   │ 安全层    │    │ MoA 择优     │              │
│   │ 脱敏/审批 │    │ 多模型并行   │              │
│   └──────────┘    └──────────────┘              │
└──────┬──────────────────┬───────────────────────┘
       ▼                  ▼
┌─────────────┐   ┌─────────────────┐
│  LLM 提供商  │   │   工具集 (28+)   │
│  DeepSeek   │   │  终端/文件/代码   │
│  通义千问    │   │  搜索/记忆/图片   │
│  智谱GLM    │   │  飞书/视觉/补丁   │
│  Moonshot   │   └────────┬────────┘
└─────────────┘            ▼
                   ┌─────────────────┐
                   │  LeaperBrain    │
                   │  六层自进化记忆   │
                   │  BM25 + 时间衰减 │
                   └─────────────────┘

🛠️ 工具列表

工具	描述
web_search	多引擎搜索（Bing/百度/DuckDuckGo）
web_fetch	抓取网页提取纯文本
read_file	读取文件内容
write_file	写入文件
list_files	列出目录文件
search_files	正则搜索文件内容
create_dir	创建目录
delete_file	删除文件
move_file	移动/重命名文件
code_execute	执行代码片段
terminal_exec	执行终端命令
terminal_bg	后台执行命令
process_list	查看进程列表
process_kill	终止进程
memory_search	搜索记忆库
memory_store	存储新知识
memory_recall	回忆特定主题
memory_forget	遗忘错误信息
memory_stats	记忆统计
memory_evolve	触发记忆进化
create_diff	生成 diff 补丁
apply_patch	应用补丁
feishu_doc	创建飞书文档
feishu_upload	上传文件到飞书
generate_image	AI 生图
analyze_image	图片分析（视觉）
ocr_image	图片文字识别
delegate_task	委派子任务

🧠 记忆系统

六层自进化架构：

层级	名称	生命周期	说明
L0	对话上下文	会话内	当前对话历史
L1	短期记忆	小时级	最近交互摘要
L2	工作记忆	天级	跨会话知识
L3	长期记忆	周级	稳定知识点
L4	核心知识	月级	高置信事实
L5	元认知	永久	推理模式和策略

特性：

• 4-Gate 质量过滤（相关性/新颖性/置信度/一致性）
• BM25 召回 + 时间衰减 + MMR 去重
• 自动进化：高频访问提升，长期未用衰减

🔒 安全机制

• 隐私脱敏: 手机号/身份证/银行卡/API Key 自动识别并脱敏
• 危险命令拦截: rm -rf /、format C:、Fork bomb 等
• 操作审批: 高危操作需人工确认
• 凭证池: API Key 轮转，耗尽自动切换

🔧 开发

# 编译
npm run build

# 测试
npx tsx tests/test-core.ts

# 开发模式
npm run dev

# 类型检查
npx tsc --noEmit

📁 项目结构

src/
├── agent/          # Agent 核心（循环、安全、调度）
├── brain/          # LeaperBrain 记忆引擎
├── providers/      # LLM 提供商适配器
├── gateway/        # 渠道接入（飞书等）
├── tools/          # 28+ 工具实现
├── cron/           # 定时任务
└── cli.ts          # CLI 入口

📄 License

Apache-2.0