# ⚡ OPC Agent
**让每个人都有自己的 AI 员工**
[](https://www.npmjs.com/package/opc-agent)
[](LICENSE)
[](https://nodejs.org/)
[](tests/)
[English](README.md)
---
## 为什么做 OPC Agent？
AI Agent 越来越强，但普通人用不起来：
- **太贵** — 云端 Agent 按 token 收费，聊几句就是钱
- **不记事** — 每次对话都从零开始，不会越用越聪明
- **数据不安全** — 你的聊天记录、文档、知识全在别人的服务器上
- **只会聊天** — 不能读文件、不能搜网页、不能执行代码，什么活都干不了
**OPC Agent 解决这些问题：**
✅ 本地运行，零成本（Ollama 驱动）
✅ 越用越聪明（自动学习和进化）
✅ 数据全在你电脑上
✅ 能读写文件、搜索网页、执行代码、操作工具
---
## 🚀 安装
选择你的系统，**复制一行就够了**：
### macOS / Linux
```bash
curl -fsSL https://raw.githubusercontent.com/Deepleaper/opc-agent/main/install.sh | bash
```
### Windows
```powershell
irm https://raw.githubusercontent.com/Deepleaper/opc-agent/main/install.ps1 | iex
```
> 安装脚本会自动帮你装好 Node.js、OPC Agent、Ollama 和适合你电脑的 AI 模型。全程不需要手动操作。
### 手动安装
如果你是开发者，也可以手动装：
```bash
npm install -g opc-agent@alpha
```
---
## ⚡ 30 秒上手
### 第一步：创建你的 AI 员工
```bash
opc init my-agent
cd my-agent
```
### 第二步：开始对话
```bash
opc chat
```
就这样。你的 AI 员工已经在工作了。
### 更多用法
```bash
opc studio # 打开网页管理后台（localhost:4000）
opc run # 启动所有服务（对话 + Telegram + 网页 + 管理后台）
```
---
## 它能干什么？
OPC Agent 不只是聊天机器人。它是一个**能干活的 AI 员工**：
| 能力 | 说明 |
|------|------|
| 💬 **对话** | 终端聊天、网页聊天 |
| 📁 **读写文件** | 读取你的文档、写报告、整理笔记 |
| 🔍 **搜索互联网** | 实时搜索，获取最新信息 |
| 🌐 **读取网页** | 抓取网页内容并总结 |
| 💻 **执行代码** | 运行 JavaScript、TypeScript、Python |
| 🧠 **记忆** | 自动记住聊过的内容，越用越聪明 |
| 🔧 **MCP 工具扩展** | 接入 GitHub、数据库、飞书等外部工具 |
| 📱 **Telegram 机器人** | 配好 Bot Token 就能在 Telegram 里用 |
| 🎙 **语音合成** | 文字转语音（edge-tts） |
| 👥 **子代理** | 让 Agent 派出多个子任务并行工作 |
| 🔄 **Provider 故障转移** | 熔断器保护，自动重试并切换备用模型 |
| 📋 **20 个工作站角色** | 预置模板：客服、工程师、分析师、高管... |
| ⏰ **定时任务** | 从模板自动注册 Cron 任务 |
---
## 🧠 越用越聪明
这是 OPC Agent 和其他 AI 框架最大的区别：**它会自己进化。**
```
你和 AI 对话
↓
AI 从对话中提取知识 ← 自动的，你不需要操心
↓
知识沉淀到本地数据库 ← 数据在你电脑上
↓
下次对话自动引用知识 ← 它记住了你说过的话
↓
知识逐渐精炼升级 ← 越用越精准
```
所有学习过程用本地 Ollama 模型，**零成本**。
知识分三层组织：**行业 → 岗位 → 工作站**——每个角色都有精准的上下文支撑。
---
## 🎨 Studio 管理后台
```bash
opc studio
```
打开浏览器访问 `localhost:4000`，你可以：
- **模型配置** — 切换 AI 模型，本地或云端都行
- **渠道配置** — 配置 Telegram Bot Token
- **知识库管理** — 查看 Agent 学到了什么
- **Agent 设置** — 修改性格、技能、行为
---
## 📖 模型支持
### 本地（零成本）
安装时自动根据你电脑内存推荐最合适的模型：
| 内存 | 推荐模型 | 下载大小 |
|------|---------|---------|
| ≤3 GB | qwen2.5:0.5b | 400MB |
| ≤7 GB | qwen2.5:1.5b | 1.0GB |
| ≤15 GB | qwen2.5:7b | 4.7GB |
| ≤31 GB | qwen2.5:14b | 9.0GB |
| 32+ GB | qwen2.5:32b | 19GB |
### 云端（可选）
在 Studio 后台添加 API Key 即可使用：OpenAI、DeepSeek、Anthropic、通义千问、Google Gemini
支持熔断器自动故障转移——一个模型挂了，立即切到下一个。
---
## 📋 常用命令
| 命令 | 干什么 |
|------|--------|
| `opc init [名字]` | 创建 AI 员工 |
| `opc chat` | 终端对话 |
| `opc studio` | 打开管理后台 |
| `opc run` | 一键启动所有服务 |
| `opc brain stats` | 查看知识库状态 |
| `opc brain recall "问题"` | 搜索知识库 |
| `opc brain learn 文件.md` | 导入文档到知识库 |
| `opc voice test "你好"` | 测试语音合成 |
| `opc mcp list` | 查看已接入的外部工具 |
| `opc doctor` | 诊断安装问题 |
| `opc init --role <名字>` | 从工作站模板创建 Agent |
| `opc init --list-roles` | 查看可用角色列表 |
| `opc template check <路径>` | 验证模板质量 |
| `opc template test <路径>` | 运行模板测试 |
---
## 🏗 Workstation 模板
用模板可以一键创建特定角色的 AI 员工：
```bash
opc init --template ceo-coach-socratic
```
模板包含：人格定义、技能配置、知识库、测试用例。拿来就能用。
---
## 🔒 隐私
- 所有数据存在你自己的电脑上
- 不上传任何遥测数据
- 本地 Ollama 模型不经过任何云端
- 你的知识库、对话记录、文件全部本地
---
## 🤝 参与开发
```bash
git clone https://github.com/Deepleaper/opc-agent.git
cd opc-agent
npm install
npx tsc # 构建
npx vitest run # 跑测试
```
---
## 📄 开源协议
Apache-2.0 © [跃盟科技 Deepleaper](https://github.com/Deepleaper)
---
**由 [跃盟科技](https://www.deepleaper.com) 出品**
⭐ 如果对你有用，请给个 Star