Auraxis 是一个基于 Electron + React 19 + TypeScript 的桌面端 AI 智能体工作台，提供统一的 ReAct 步进引擎、多智能体调度、Code / Work 模式、MCP 连接器、文档处理、终端、插件扩展和持久化项目记忆。
- 统一聊天、多 Agent 与 Code Mode 执行链路
- 71+ 模型工具与完整权限、审批、沙箱管线
- Chat / Work / Code 三种工作模式
- MCP、飞书/Lark、DeepSeek Harness 等连接器
- Word、Excel、PPT、PDF 文档技能
- TypeScript 与 Python 两套 SDK
- Windows / macOS / Linux 三平台构建与 E2E
- 本地账户、加密凭据、记忆与全文检索
- Node.js
>=22.12 - npm
>=10 - Python
>=3.9（仅使用 Python SDK 时需要；Windows 可用winget install Python.Python.3.10）
git clone https://github.com/yth1120/Auraxis-Agent.git
cd Auraxis
npm install
Copy-Item .env.example .env
npm run electron:dev首次运行前请在 .env 中填写 DEEPSEEK_API_KEY，也可以在应用设置页中配置模型密钥。
| 命令 | 作用 |
|---|---|
npm run electron:dev |
启动 Electron 开发环境 |
npm run electron:compile |
编译主进程 |
npm run sdk:build |
编译 TypeScript SDK |
npm run sdk:test |
运行 TypeScript SDK 单元测试 |
npm run sdk:test:py |
运行 Python SDK 单元测试 |
npm run sdk:smoke |
启动真实无头 runtime 并验证 SDK 连通性 |
npm run test |
运行全量单元测试 |
npm run check |
Lint、编译、类型检查和全量测试 |
npm run build |
全量构建并打包 |
- TypeScript：packages/auraxis-sdk
- Python：python/auraxis_sdk
SDK 通过换行分隔的 JSON-RPC 2.0 协议驱动 Auraxis 无头 runtime，支持 ping、agent.run 和 session.search。
模型编写的任意代码执行默认关闭。工具执行必须经过权限配置、沙箱门、审批与路径边界校验；只有显式设置 AURAXIS_ALLOW_UNSAFE_CODE=1 的受信开发环境才会启用不安全代码执行。
项目目录内的规则文件与 hooks 默认不授权，需分别显式设置 AURAXIS_TRUST_PROJECT_RULES=1 和 AURAXIS_TRUST_PROJECT_HOOKS=1。