Community编程与开发github.com

Kong-lh-rgb/vesta

一个为长时间运行的智能体设计的Agent宿主,支持记忆、延续以及从实际工作中学习。

vesta 是什么?

Kong-lh-rgb/vesta 是一个专门为需要持久运行的 AI Agent 设计的宿主框架。它的核心价值在于让 Agent 能够像人类一样,在长时间的工作中保持上下文记忆、从中断处继续执行任务,并且从之前的操作中积累经验并优化行为。该框架支持多种 Agent 平台,包括 Claude Code、Cursor 和 Codex 等,通过标准化的 API 和插件机制,开发者可以轻松地集成和定制 Agent 的持久化逻辑。简而言之,Vesta 让 AI Agent 不再是一次性的对话工具,而是能够参与长期项目、持续学习和改进的智能工作伙伴。它通过文件系统或数据库保存 Agent 的状态和记忆,在每次启动时自动加载,确保工作流不会因 Agent 重启而丢失。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add Kong-lh-rgb/vesta

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

vesta 是做什么的?

一个为长时间运行的智能体设计的Agent宿主,支持记忆、延续以及从实际工作中学习。

概述

Vesta 是一个轻量级的 Agent 宿主框架,旨在解决 AI Agent 在长期任务中面临的关键挑战——上下文丢失、任务中断以及缺乏学习能力。通过 Vesta,Agent 可以无缝地在多个会话中保持状态,从上次中断的地方继续,并从历史交互中提取教训以改进未来表现。

核心特性

  • 持久化记忆:自动保存 Agent 的会话状态、决策记录和中间结果到本地存储或数据库。
  • 工作延续:支持 Agent 在重启后自动恢复上次的工作上下文,无需重复相同的对话或配置。
  • 经验学习:记录成功和失败的案例,Agent 可以在后续任务中参考这些经验,优化策略。
  • 平台无关:兼容 Claude Code、Cursor、Codex 等主流 Agent 环境,通过适配器轻松集成。
  • 可扩展插件:提供插件 API,允许开发者自定义记忆存储后端、日志格式和重放策略。

快速开始

安装

npm install @kong-lh-rgb/vesta

基本用法

在你的 Agent 工作流中引入 Vesta:

import { Vesta } from '@kong-lh-rgb/vesta';

const agent = new Vesta({
  name: 'my-agent',
  storage: 'filesystem', // 可选: 'filesystem', 'sqlite', 'memory'
  memoryPath: './vesta-memory'
});

await agent.start();

恢复工作

在后续的会话中,Agent 会自动检查之前的记忆:

const agent = new Vesta({ name: 'my-agent' });
const previousSession = await agent.load();
if (previousSession) {
  console.log('已恢复上次的工作上下文:', previousSession.context);
}

配置选项

参数类型默认值描述
namestring必填Agent 的唯一标识,用于区分不同的工作流
storagestring'filesystem'记忆存储后端,支持 filesystem、sqlite、memory
memoryPathstring'./vesta-memory'持久化记忆的存储路径
autoSavebooleantrue是否在每个步骤后自动保存状态
learningbooleanfalse是否启用经验学习功能

经验学习

启用 learning 后,Vesta 会记录每次交互的结果,并在下一次任务中提供上下文建议:

const agent = new Vesta({ name: 'my-agent', learning: true });
const lessons = await agent.getLessons();
console.log('从历史任务中学到的经验:', lessons);

平台支持

Vesta 通过适配器模式支持以下 AI Agent 平台:

  • Claude Code:通过 ClaudeCodeAdapter 适配 Claude 的对话 API。
  • Cursor:通过 CursorAdapter 适配 Cursor 的编辑和生成 API。
  • Codex:通过 CodexAdapter 适配 OpenAI Codex 的补全 API。
  • 自定义平台:实现 Adapter 接口即可集成到任何 Agent 环境。

架构概览

Vesta 采用三层架构:

  1. 适配层:负责与不同 Agent 平台通信。
  2. 核心层:管理记忆存储、状态恢复和经验学习。
  3. 存储层:提供可插拔的持久化后端。

贡献指南

欢迎贡献!请阅读 CONTRIBUTING.md 了解如何开始。所有 PR 必须包含测试和文档更新。

许可

MIT License

相关技能