---

什么是 OriCore？

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

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

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

``typescript
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);
`

---

快速开始

`bash
npm install oricore ai
`

`typescript
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 集成 - 代码助手、智能补全
- 代码审查 - 自动化代码审查系统
- 调试工具 - 智能错误诊断
- 教育平台 - 编程教学助手
- 文档生成 - 自动化文档生成

---

文档导航

$3

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

$3

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

$3

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

---

致谢

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

neovate-code - 核心 AI 引擎架构

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

---

许可证

MIT © lyw405

---

支持

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