# Encre-Agent
**Repository Path**: dunimd-experimental/encre-agent
## Basic Information
- **Project Name**: Encre-Agent
- **Description**: Encre Agent — 强大的 AI Agent 平台,支持 31 个主流 LLM 提供商、84+ 个内置工具以及 26+ 个聊天平台集成。无论是编程开发、桌面自动化、跨平台消息,还是多智能体协作,Encre Agent 都能胜任。
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-10-25
- **Last Updated**: 2026-10-25
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
🤖 什么是 Encre Agent?
### 一句话简介
Encre Agent 是一个 AI Agent 平台 —— 告诉它你想做什么,它会自动分析、调用工具、执行任务并将结果交付给你。
### 核心能力
| 能力 | 说明 |
|:------|:------|
| 🧠 **51 个 AI 模型** | 支持 OpenAI、Anthropic Claude、Google Gemini、DeepSeek、Qwen、GLM 以及本地模型等,自由切换 |
| 🛠️ **74 个内置工具** | 文件操作、Shell 执行、浏览器自动化(CDP 引擎)、代码编辑、网页搜索、数据库、调度、Docker、Git、图片生成、邮件,开箱即用 |
| 💬 **24 个聊天平台** | 接入 Telegram、Discord、Slack、钉钉、微信、WhatsApp、QQ Bot、Matrix、邮件,随时随地与 Agent 对话 |
| 🖥️ **桌面自动化** | 控制桌面应用、操作浏览器、读取屏幕截图,模拟人工操作 |
| 🤝 **多智能体协作** | 多个 Agent 同时运行,分工协作完成复杂项目 |
| 💾 **持久化记忆** | Agent 会记住你的偏好、习惯与项目信息,越用越聪明 |
| 🛡️ **安全与控制** | 7 种权限模式,精确控制 Agent 的能力边界 |
### 应用场景
- **代码开发助手** — 拿到一段代码,发现一个 bug → 告诉 Encre Agent → 它自动读代码、跑 LSP 诊断、打补丁、跑测试,告诉你怎么修好的
- **浏览器调研** — 给它一句提示词 "调研一下现在最好的 AI 编程工具" → 它自己打开浏览器、搜 Google、翻结果、点链接、读文章、最后给你一张对比表
- **桌面自动化** — 批量文件处理、自动填表、截图归档
- **跨平台聊天机器人** — 同时接入微信、Telegram、钉钉、Slack,从一个平台跟 Agent 对话
- **数据分析** — "读一下这份 PDF / Excel,帮我总结关键数据"
- **长期任务调度** — "每小时检查一次服务器,CPU 超过 80% 就在微信上通知我"
- **多智能体协作** — 架构师 Agent 规划、程序员 Agent 写代码、评审 Agent 审查,共享黑板一起干活
⭐ 核心特性
#### 🧠 51 个 AI 后端,自由切换
支持 **51 个主流 AI 提供商**,包括 OpenAI、Anthropic Claude、Google Gemini、DeepSeek、阿里 Qwen、腾讯混元、小米 MiMo、月之暗面 Kimi、智谱 GLM、MiniMax 等。
- **全球领先**:OpenAI、Anthropic、Google、Groq、AWS Bedrock、GitHub Copilot
- **中文与区域**:阿里 Qwen、腾讯、小米 MiMo、月之暗面、智谱、MiniMax
- **自托管**:Ollama、LM Studio、HuggingFace Transformers
- **聚合服务**:OpenRouter、AI Gateway、Kilocode、OpenCode
- **高级特性**:自动故障转移、按成本路由、透明重试
#### 🤖 6 个内置 Agent 角色
Encre Agent 内置了专用角色,每个角色都配有专属的提示词与能力:
- **通用模式**:`coder`、`researcher`、`critic`
- **工作区模式**:`architect`、`planner`
- **计划 / 规范模式**:`spec-writer`
#### 🛠️ 74 个开箱即用的工具
| 类别 | 工具 |
|:------|:------|
| **文件** | 读取、写入、编辑、补丁、搜索、PDF / Excel 处理 |
| **终端** | Shell 命令、后台任务、Docker、部署 |
| **网络** | 网页抓取、网页搜索(基于 MCP)、浏览器自动化(CDP) |
| **开发辅助** | LSP 诊断、IPython Notebook、数据库查询 |
| **任务** | 创建 / 获取 / 列出 / 更新 / 停止任务,含 bash / agent / workflow 执行器 |
| **调度与记忆** | 定时任务、待办清单、记忆管理 |
| **桌面** | 桌面控制(pyautogui)、图像识别(OCR)、浏览器自动化 |
| **集成** | Git、REST API、MCP 外部协议 |
#### 💬 24 个聊天平台集成
将 Encre Agent 接入你常用的消息平台:
**国际**:Discord、Slack、Telegram、WhatsApp、Signal、Matrix、Microsoft Teams、Google Chat、Mattermost、Line、IRC、ntfy、SimpleX、Photon、Raft、Home Assistant
**中国**:钉钉、企业微信、微信、QQ Bot
**通用**:邮件(IMAP + SMTP)、短信、Webhook、iMessage(BlueBubbles)
每个平台都有专属的适配器,在消息送达 Agent 前进行归一化处理。
#### 🛡️ 7 级安全控制
| 模式 | 说明 |
|:------|:------|
| `bypass` | 无检查(完全开放) |
| `dont_ask` | 自动允许(无需确认) |
| `accept_edits` | 自动允许文件编辑 |
| `plan` | 先规划再执行 |
| `spec` | 先写规范文档再实现 |
| `auto` | AI 智能判断 |
| `default` | **推荐** —— 每次操作前询问 |
额外保护:
- **SSRF 防护**:DNS 解析 + CIDR 黑名单
- **沙箱隔离**:Docker 容器沙箱 + Linux Landlock 内核级限制
- **AI 安全分类器**:Agent 自主评估操作风险等级
- **限流**:防止 API 调用失控
#### 💾 持久化 Agent 记忆
Encre Agent 拥有独立的记忆系统 —— 随着使用愈加了解你:
- 记忆以带权知识图谱存储 —— 情节、事实、偏好、决策、教训,每个节点都带置信度
- **置信度衰减与强化**:久未使用的记忆自动衰减,任务结果会强化或修正既有信念
- **语义检索**:通过语义理解快速定位相关记忆
- **实体枢纽与交叉关联**:相关记忆按共现与语义相似度自动连线,支持一跳召回
#### 🎯 9 个专业技能
Agent 提供 9 个可调用的技能:
`debug`、`loop`、`stuck`、`code-review`、`refactor`、`gen-test`、`verify`、`write-docs`、`chart-visualization`
**优先级覆盖**:托管(managed)> 用户 > 项目 > 内置 —— 满足你的个性化需求。
#### 🤝 多智能体协作
- **Swarm 系统**:多个 Agent 并发执行,互不干扰
- **共享黑板**:所有 Agent 共享状态,完全透明
- **共识协议**:多个 Agent 对提案投票,选出最佳方案
- **任务规划器**:自动将复杂任务拆解为子任务树
- **6 个内置角色**:每个角色都有专属的提示词与能力
#### 🧱 Encre Agent Core(Rust 原生)
Encre Agent Core —— 性能关键模块由 Rust 实现,带来极致速度与内存安全:
- 极速文件 I/O,支持 offset / limit
- 正则搜索与 Glob 快速定位内容
- SIMD 加速文本匹配(硬件级)
- Unified Diff 精确计算代码差异
- 在安全环境中沙箱化执行 Shell
- 通过 Linux Landlock 进行内核级文件系统限制
- 智能 Token 计数(英文 / 中文 / 数字 / 代码)
- 文本语义相似度比较
- LSP 协议解析(JSON-RPC 2.0)
#### 🖥️ Encre Agent Desktop
基于 Electron + React 19 构建的全功能 AI 聊天桌面应用:
- **聊天界面**:Markdown 渲染、代码高亮、文件附件
- **多会话**:并发聊天,支持分支与模糊搜索
- **设置面板**:模型配置、网关、Agent、MCP 服务器、技能、规则、记忆
- **iClaw 模式**:自动化运行器,支持批量操作
- **内嵌终端**:xterm.js + node-pty,带工作目录浏览
- **代码编辑器**:Monaco Editor,支持 16+ 种语言(TypeScript、JavaScript、Python、Rust、Go、Java、C/C++、PHP、Ruby、Swift、Kotlin、SQL 等)
- **11 种界面语言**:英文、简体中文、繁体中文、日语、韩语、德语、西班牙语、葡萄牙语、土耳其语、阿拉伯语、希伯来语,支持运行时切换
- **Git 集成**:状态与 diff,带缓存
- **系统托盘**:通知 + 语音输入支持
- **加密存储**:AES-256-GCM 加密的浏览器 Cookie
- **跨平台**:Windows(NSIS)、macOS(.pkg)、Linux(.deb / .rpm)
#### 🧩 插件市场与中央仓库
基于 PyPI 中央仓库的开放插件生态——可直接在内置市场安装技能与工具:
- **一个 Wheel,全版本兼容**:所有市场包都是通用纯 Python wheel,支持 **Python 3.11+**——一次构建,处处安装
- **ea-plugin-cli**:插件统一工具链,覆盖脚手架、构建、验证、发布全流程——[ea-plugin-cli](https://github.com/mf2023/ea-plugin-cli)
- **ea-cwh 中央仓库**:以 PyPI 数据包形式分发的权威插件目录,市场 UI 完全离线读取——[ea-cwh](https://github.com/mf2023/ea-cwh)
- **256 个官方插件**:`ea-skill-*` / `ea-tool-*` / `ea-connector-*` 包覆盖数据、媒体、网页、开发、出行、金融与消息平台等领域
- **全链路校验**:sha256 摘要核验、沙箱化安装验证、CI 门禁合并——插件必须经过验证管线才能上架
#### ⚙️ 开发者工具链
- **上下文压缩**:9 种策略,智能管理对话上下文
- **LSP 客户端**:16+ 种语言服务器自动发现,提供实时代码诊断
- **会话记忆索引**:BM25 检索,快速召回历史会话
- **进化系统**:元认知、反射循环、策略优化
- **反馈学习器**:基于 Jaccard 相似度的错误修正
- **交互式 Notebook**:IPython 内核,支持实时执行代码
- **插件系统**:市场驱动的可扩展架构,配备经 CI 校验的插件中央仓库
- **用户画像**:人格推断与灵魂系统
- **规范引擎**:结构化规范文档管理
- **WebSocket 服务器**:实时通信 + 管理 HTTP API
🚀 快速开始
### 3 步开始使用
**步骤 1:克隆仓库**
```bash
git clone https://github.com/Dunimd/encre-agent.git
cd encre-agent
```
**步骤 2:一键构建**
```bash
python build.py
```
一条命令即可构建 Rust 扩展、安装 Python 包并打包桌面应用。
**步骤 3:启动**
```bash
# 桌面应用
cd desktop && npm start
# 或使用 CLI(iClaw 模式)
python -m encre.iclaw --help
```
### 基础用法
通过桌面应用开始与 Agent 对话,或将其接入你常用的聊天平台。配置好 AI 模型提供商和权限模式,即可立即使用。
### 配置
配置以加密 JSON 文件的形式存储在数据目录(`~/.dunimd/encre/config/`)下,通常通过 Encre Agent Desktop 的设置面板管理:
```json
{
"providers": [
{
"backend_type": "openai",
"name": "OpenAI",
"api_key": "",
"models": [
{ "name": "GPT-6 Astra", "model_id": "gpt-6-astra", "enabled": true },
{ "name": "GPT-6 Luna", "model_id": "gpt-6-luna", "enabled": true },
{ "name": "GPT-6 Sol", "model_id": "gpt-6-sol", "enabled": true }
]
}
]
}
```
`/config/` 下的配置文件:
1. `models.json` —— 模型端点、当前模型、故障转移
2. `agents.json` —— 智能体人格、子智能体、系统提示词、技能
3. `adapters.json` —— 平台适配器凭据
4. `mcp.json` —— MCP 服务器定义
5. `ui.json` —— 界面偏好
6. `runtime.json` —— 行为开关、权限及其它运行时字段
环境变量使用 `ENCRE_` 前缀(如 `ENCRE_DATA_DIR`、`ENCRE_PROFILE`),可覆盖数据目录与配置档案的选择。
❓ 常见问题
**问:Encre Agent 支持哪些 AI 模型?**
答:**51 个提供商**,包括 OpenAI、Anthropic Claude、Google Gemini、DeepSeek、阿里 Qwen、腾讯混元、小米 MiMo、月之暗面 Kimi、智谱 GLM、MiniMax、Ollama、LM Studio、HuggingFace、AWS Bedrock、OpenRouter 等。Encre Agent 是完全原生开发的,不是任何项目的套壳(如 Codex)。
**问:Encre Agent 能做什么?**
答:熟练助手能做的一切 —— 读写编辑代码、运行 shell 命令、打开浏览器做调研、自动化桌面、管理文件、调度任务、与其他 Agent 协作,等等。它内置 **74 个工具**和 **185 个技能包**,几乎可以处理任何任务。
**问:能否在喜欢的聊天平台上使用 Encre Agent?**
答:可以!Encre Agent 支持 **24 个聊天平台**,包括 Telegram、Discord、Slack、钉钉、企业微信、微信、WhatsApp、QQ Bot、邮件、Matrix 等。每个平台都有专属的适配器。
**问:Encre Agent 使用起来安全吗?**
答:安全是头等大事。Encre Agent 提供 **7 种权限模式**,从完全开放到每次操作都需要确认。额外保护还包括 SSRF 防护、Docker 沙箱、Landlock 内核限制以及 AI 风险分类。
**问:Encre Agent 会在会话之间记忆信息吗?**
答:是的。Encre Agent 拥有 **持久化记忆系统**,可存储重要信息、学习你的偏好,并在对话间保持上下文。随着时间推移,它会变得更聪明、更个性化。
**问:多个 Agent 能否协同工作?**
答:当然。Encre Agent 通过 Swarm 系统支持 **多智能体协作**。你可以派生出多个不同角色的 Agent(coder、researcher、critic 等),它们共享信息并协同完成复杂任务。
**问:有桌面应用吗?**
答:有!**Encre Agent Desktop** 是一个全功能的 Electron + React 应用,包含聊天界面、代码编辑器(Monaco)、内嵌终端、文件浏览器、设置面板等。支持 Windows、macOS 和 Linux。
**问:能使用自己的 AI 模型吗?**
答:可以。你可以使用任何 OpenAI 兼容的 API,通过 Ollama / LM Studio 自托管模型,或接入自定义后端。Encre Agent 设计为后端无关。
🌏 社区与许可
- 欢迎提交 Issue 和 PR!
- GitHub:https://github.com/Dunimd/encre-agent
- Gitee:https://gitee.com/dunimd/encre-agent
- GitCode:https://gitcode.com/dunimd/encre-agent
## 📄 许可证与开源协议
### 项目许可证
本项目采用 **Apache License 2.0**。完整文本请参见 [LICENSE](LICENSE) 文件。
### 依赖许可协议
下表汇总了 **Python 框架**、**Encre Agent Core**(Rust 原生引擎)与 **Encre Agent Desktop**(Electron 应用)所使用的依赖包。版本号与精确的许可文本不在此处固定,请以各上游项目为准。
| 包名 | 协议 | 包名 | 协议 |
|:-----------|:-----------|:-----------|:-----------|
| httpx | BSD-3-Clause | pydantic | MIT |
| beautifulsoup4 | MIT | markdownify | MIT |
| lxml | BSD-3-Clause | tomli | MIT |
| tomli-w | MIT | pyyaml | MIT |
| cryptography | Apache-2.0 / BSD | zero-api-key-web-search | Apache-2.0 |
| pathspec | MPL-2.0 | websockets | BSD-3-Clause |
| Pillow | Historical | (built-in) | CDP 浏览器引擎 |
| tiktoken | MIT | numpy | BSD-3-Clause |
| loguru | MIT | openai | Apache-2.0 |
| anthropic | MIT | google-generativeai | Apache-2.0 |
| ollama | MIT | groq | MIT |
| aiohttp | Apache-2.0 | discord.py | MIT |
| slack_bolt | MIT | slack_sdk | MIT |
| python-telegram-bot | GPL-3.0 | dingtalk-stream | MIT |
| aioimaplib | BSD-3-Clause | aiosmtplib | MIT |
| torch | BSD-3-Clause | transformers | Apache-2.0 |
| boto3 | Apache-2.0 | pytest | MIT |
| pytest-asyncio | Apache-2.0 | ruff | MIT |
| mypy | MIT | pre-commit | MIT |
| mss | MIT | openpyxl | MIT |
| pdfplumber | MIT | pyautogui | BSD-3-Clause |
| pypdf | BSD-3-Clause | PyPDF2 | BSD-3-Clause |
| pytesseract | Apache-2.0 | uiautomation | MIT |
| watchfiles | MIT | | |
| serde | MIT/Apache-2.0 | serde_json | MIT/Apache-2.0 |
| regex | MIT/Apache-2.0 | walkdir | MIT/Apache-2.0 |
| similar | MIT | glob | MIT/Apache-2.0 |
| tempfile | MIT/Apache-2.0 | candle-core | Apache-2.0 |
| tokenizers | Apache-2.0 | wide | MIT/Apache-2.0 |
| pyo3 | MIT/Apache-2.0 | | |
| electron | MIT | electron-builder | MIT |
| esbuild | MIT | typescript | Apache-2.0 |
| @xterm/xterm | MIT | @xterm/addon-fit | MIT |
| @xterm/addon-webgl | MIT | node-pty | MIT |
| markdown-it | MIT | highlight.js | BSD-3-Clause |
| minisearch | MIT | monaco-editor | MIT |
| react | MIT | react-dom | MIT |
| simple-icons | CC0-1.0 | | |