OriCore

强大的 AI 引擎库，5 行代码构建智能助手

English | 中文文档

什么是 OriCore？

OriCore 是一个功能完整的 AI 引擎库，让你可以轻松地在任何应用中集成强大的 AI 能力。

• 支持 40+ AI 厂商（OpenAI、Claude、DeepSeek、智谱等）
• 内置 完整工具系统（文件读写、代码搜索、Shell 命令、网络请求）
• 会话管理 + 上下文压缩
• MCP 协议 + Skill 系统 无限扩展
• 5 种专业交互模式（头脑风暴、规划、审查、调试、默认）

只需要 5 行代码，就能给你的产品加上 AI：

import { createEngine } from 'oricore';

const engine = createEngine({ productName: 'MyApp', version: '1.0.0' });
await engine.initialize({
  model: 'deepseek/deepseek-chat',
  provider: {
    deepseek: {
      options: { apiKey: 'your-key' }
    }
  }
});

const result = await engine.sendMessage({ message: '帮我分析这个项目的结构', write: true });
console.log(result.data.text);

快速开始

npm install oricore ai

import { createEngine } from 'oricore';

const engine = createEngine({ productName: 'MyAIAssistant', version: '1.0.0' });
await engine.initialize({
  model: 'deepseek/deepseek-chat',
  provider: {
    deepseek: {
      options: { apiKey: 'your-api-key' }
    }
  },
});

const result = await engine.sendMessage({
  message: '创建一个 TypeScript 函数来计算斐波那契数列',
  write: true,
});

console.log(result.data.text);
await engine.shutdown();

📖 5分钟上手指南

为什么选择 OriCore？

| 你的需求 | OriCore | 其他方案 | |---------|---------|----------| | 快速构建 AI 助手 | ✅ 5 行代码 | ❌ 100+ 行配置 | | 对接任意 AI 厂商 | ✅ 40+ 厂商统一接口 | ⚠️ 各自独立的 SDK | | 开箱即用的工具 | ✅ 文件、Shell、搜索、网络 | ❌ 全部自己实现 | | 节省 API 成本 | ✅ 自动上下文压缩 | ❌ 每次都传完整上下文 | | 插件扩展能力 | ✅ MCP + Skills | ❌ 复杂或无法实现 | | 切换 AI 厂商 | ✅ 改一行代码 | ❌ 重写集成代码 |

为需要快速交付 AI 功能的开发者打造：

• 5 分钟上手 - 立即获得具备文件访问、代码搜索、Shell 命令的 AI 助手
• 无厂商锁定 - 随时在 OpenAI、Claude、DeepSeek 等之间切换
• 生产就绪 - 内置会话持久化、成本追踪、错误处理
• 易于扩展 - 通过 MCP 服务器或本地技能文件添加自定义工具
• AI 智能优化 - 上下文压缩和针对不同任务的专业模式

内置工具

| 工具 | 功能 | |------|------| | read | 读取文件（支持文本、图片、PDF） | | write | 写入文件 | | edit | 编辑文件（搜索替换） | | glob | 按模式查找文件 | | grep | 搜索文件内容 | | bash | 执行 Shell 命令 | | fetch | 发起 HTTP 请求 | | task | 启动专用 Agent | | todo | 跟踪任务进度 | | askUserQuestion | 与用户交互问答 |

📖 工具系统详解

使用场景

• 构建自定义 AI 助手 - 聊天机器人、客服系统
• IDE 集成 - 代码助手、智能补全
• 代码审查 - 自动化代码审查系统
• 调试工具 - 智能错误诊断
• 教育平台 - 编程教学助手
• 文档生成 - 自动化文档生成

文档导航

新手入门

• 5分钟上手 - 快速了解 OriCore
• 场景教程 - 实战示例

核心功能

• API 参考 - 完整的 API 文档
• 配置详解 - 所有配置选项
• 工具系统 - 内置工具详解
• 交互模式 - 5 种专业模式

高级功能

• 会话管理 - 持久化与上下文压缩
• 事件系统 - 消息总线与事件
• MCP 集成 - MCP 协议支持
• Skill 系统 - 自定义技能加载
• 审批系统 - 工具执行权限控制

致谢

本项目参考了以下优秀项目的核心架构：

neovate-code - 核心 AI 引擎架构

OriCore 在此基础上进行了重构和精简，移除了 UI、CLI 等外围功能，专注于提供一个功能强大且独立的 AI 引擎库，可以轻松集成到任何项目中。

许可证

MIT © lyw405

支持

• GitHub: lyw405/oricore
• 问题反馈: Issues