本地优先的 AI 个人助理 —— 多模型对话 + 智能任务规划 + 后台定时执行，安全可控。
Agix 是一款跨平台桌面应用，把「日常对话」和「任务自动化」合二为一：你可以像聊天一样向它下达需求，它会对需求做智能分类、拆解成可执行步骤，并在后台按计划（含定时 / 周期）执行；执行过程中涉及的危险命令会被权限系统拦截，敏感信息（如 API Key）以 AES-256-GCM 加密后存储在本机。
- 多模型自由切换：内置 DeepSeek、OpenAI、Kimi、MiniMax、阶跃星辰、硅基流动、Groq、通义千问、智谱 GLM 等 10 个供应商，统一走 OpenAI 兼容接口，还支持自定义
base_url接入任意兼容服务。 - 对话即任务：输入自然语言需求，Planner 自动分类（软件开发 / 数据分析 / 计划任务 / 其他）并拆解子任务，Executor 后台 worker 负责扫描、执行与周期推进，支持「每 N 分钟 / 指定时间点」这类定时任务。
- 安全权限系统：内置敏感命令黑名单，覆盖 Linux / Windows / macOS / PowerShell 四类共 19 条规则（
rm -rf、sudo、dd、format、Remove-Item -Recurse -Force等），命中即拦截，交互模式下弹窗二次确认。 - 本地加密存储：API Key 等敏感配置用 AES-256-GCM 认证加密，密钥由本机磁盘序列号经 SHA-256 派生，换机无法解密。
- 丰富的工具调用：文件读写、Shell 执行、
file_patch精确改代码、任务管理、计划更新、用户交互等，Agent 可完整落地「写代码 → 跑测试 → 交付」闭环。 - 可扩展生态：支持技能（Skill）系统与 MCP 服务（高德地图、Bing 搜索等），并管理 SSH 站点，能力可按需接入。
- 跨平台 + 自动升级：Windows / macOS / Linux 三端桌面应用，GitHub Actions 一键多平台构建，客户端支持版本检测与在线升级。
| 层 | 技术 |
|---|---|
| 前端 | Flet 0.85（桌面 UI，多面板） |
| 后端 | Python 3.12 |
| 打包 | PyInstaller 6.21 + Cython 3.0（源码保护） |
| 认证服务 | Flask + Gunicorn + SQLite |
| CI/CD | GitHub Actions 多平台矩阵 |
- 桌面端：Windows 10+ / macOS 11+ / Linux（主流发行版），无需预装 Python。
- 认证服务（自建时）：Ubuntu / Debian + Python 3.10+，需可访问的公网域名与 80/443 端口。
从发布页下载对应平台的可执行文件（agix-{version}-{platform}）：
https://www.agix.cc/agix/
- 启动应用，登录认证服务（首次需短信验证码 / 账号登录）。
- 进入「设置 → 模型设置」，选择供应商并填入 API Key。
- 返回对话页，即可开始使用。
API Key 仅保存在本机，经 AES-256-GCM 加密，不会上传到认证服务器。
所有敏感命令在执行前经过规则引擎检查，命中黑名单即拦截：
- Linux / macOS：
rm -rf、sudo、chmod、chown、mkfs、dd、kill -9、iptables、wget | sh等。 - Windows：
del /f、format、reg、diskpart、net user、shutdown、takeown、icacls等。 - PowerShell：
Remove-Item -Recurse -Force、Set-ExecutionPolicy、Invoke-Expression、Stop-Computer、Set-Acl等。
交互模式下会弹窗请求用户确认，非交互模式直接拒绝。
API Key 采用 AES-256-GCM 认证加密，密钥由本机磁盘序列号 SHA-256 派生，保证敏感信息不落明文、换机不可解密。
src/ # 核心源码
├── agent.py # 配置中枢，初始化各组件
├── chater.py # Chat 对话管理
├── executor.py # 后台任务调度（定时/周期）
├── planner.py # 任务分类 + 规划
├── tools.py # 工具调用（文件/Shell/任务/计划）
├── auth.py # 权限规则引擎
├── aes_crypto.py # AES-256-GCM 加密
├── llm_client.py # 多供应商 LLM 客户端
├── config.py # 配置管理（供应商/路径/认证）
├── flet_ui/ # Flet 桌面 UI（对话/任务/设置等面板）
└── version.py # 唯一版本号来源
server/ # 认证服务（Flask + SQLite）
inner_space/ # 技能、MCP、SSH 等扩展资源
.github/workflows/ # 多平台构建 + 产物分发
打 tag（v*）或在 Actions 手动触发，即自动完成三平台构建：
git tag v0.1.4
git push github v0.1.4构建流程：读取 tag 版本号 → PyInstaller 打包裸二进制 → 生成 zip 产物与 SHA256 → 生成 latest.json 供客户端检测升级。
- 技能系统：
skill-creator（创建技能）、skill-finder（搜索技能），可按需扩展 Agent 能力。 - MCP 服务：
amap（高德地图 12 个工具）、bing-search（Bing 搜索 + 网页抓取）。 - SSH 站点：管理远程主机，Agent 可直接操作远端环境。
客户端登录依赖认证服务（短信验证码 / 账号）。仓库 deploy/ 提供一键部署脚本（Ubuntu / Debian）：
cd deploy
./deploy.sh脚本自动完成：安装依赖 → 建目录 → 复制代码 → 创建 venv → 配置 systemd → 配置 Nginx 反代 → 开放防火墙。
部署前需通过环境变量注入配置（写入 agix-auth.service 或系统环境变量）：
| 变量 | 说明 |
|---|---|
AGIX_SECRET_KEY |
Flask 会话密钥，生产环境必须设置 |
AGIX_ADMIN_PASSWORD |
管理后台登录密码 |
AGIX_TOKEN_EXPIRE_SECONDS |
登录令牌有效期（秒），默认 30 天 |
AGIX_DB_PATH |
SQLite 数据库路径 |
ALIYUN_ACCESS_KEY_ID / ALIYUN_ACCESS_KEY_SECRET |
阿里云短信验证码凭证（可选） |
ALIYUN_SMS_SIGN_NAME / ALIYUN_SMS_TEMPLATE_CODE |
短信签名与模板（可选） |
服务默认通过 Gunicorn（4 workers，绑定 127.0.0.1:8000）+ Nginx 反向代理对外提供 HTTP，systemd 托管并崩溃自动拉起。客户端通过 AGIX_AUTH_SERVER 指向自建服务地址。
本仓库代码仅供学习与内部使用。