AegisAl - AegisAl：基于 Tauri 2、FastAPI 与 LangGraph 的跨平台桌面安全智能体

项目说明

<p align="center">
<strong>扫码
</p>
<p align="center">
<a href="
<img src=" width="420" alt="微信群二维码">
</a>
</p>

AegisAl

<p align="center">
<img src="docs/assets/aegisal-logo.png" width="168" alt="神盾 AegisAl Logo">
</p>

面向安全研发、漏洞知识库与代码审计场景的桌面安全智能体。当前主客户端采用 Tauri 2 + React/TypeScript，本地后端采用 FastAPI + LangGraph + Python Worker。

> 作者：ShenSiQi
> 许可证：AegisAl Source-A Commercial Non-Redistribution License
> 本仓库源码可用于审阅、学习和评估，但未经书面商业授权，不得再分发、转售、SaaS 包装或商用交付。

当前版本

源码版本 v1.3.4 支持以下桌面构建目标：

> 版本说明： 本次 macOS 14 天试用客户端是 1.3.4 的实际二进制构建，二进制源码提交为 6e849b92b5b483ff9082c33cc39e4，构建时工作树为干净状态。

| 平台 | 架构 | 构建入口 |
| --- | --- | --- |
| macOS | Intel x86_64 | scripts/build_tauri_macos.sh |
| macOS | Apple Silicon arm64 | scripts/build_tauri_macos.sh |
| Windows 10/11 | x86_64 | scripts/build_tauri_windows.ps1 |

跨平台正式包由 GitHub Actions 在原生 Intel macOS 和 Windows runner 上构建。桌面包内置本地 API、任务 Worker、Semgrep 规则、Tree-sitter 语义分析依赖和所需许可证文件。

本次修复与优化

完整变更、试用包边界与校验值见 v1.3.4 发布说明。

本次发布验证基线：前端 27 个测试文件、200 项测试通过；MCP 与翻译链路 71 项测试及 16 项子测试通过；试用授权与打包版本 12 项测试通过；生产前端依赖审计未发现已知漏洞；TypeScript 检查、Vite 生产构建以及 ARM64/Intel Rust 检查通过。

14 天试用版

试用期从首次成功启动起连续计算 336 小时。两个安装包均为 ad-hoc 签名且未进行 Apple 公证；首次打开时可能需要在 macOS“隐私与安全性”中确认。Release 只提供试用版，不提供正式版安装包。

| 平台 | 客户端构建 | 安装包 | SHA-256 |
| --- | --- | --- | --- |
| macOS Apple Silicon (arm64) | 1.3.4 | AegisAl-v1.3.4-macOS-ARM64-Trial-14Days.dmg | 6ae341e9dcbc4a2a1d302f38131055ad8d4a1bf0bce18731b794ea6da77fd674 |
| macOS Intel (x86_64) | 1.3.4 | AegisAl-v1.3.4-macOS-x86_64-Trial-14Days.dmg | 01a9a28fb26e9640cfac8c89e4849ee5a55ba318dc2ac8c4b0b66 |

安装包及对应校验文件见 v1.3.4 macOS 14 天试用客户端 Release。

> 发布调整： 这是 AegisAl 在 GitHub 的最后一次公开源码更新和公开试用版发布。后续产品更新不再开源，也不再同步至 GitHub；后续试用版仅在微信群发布。本仓库保留为 v1.3.4 历史公开快照。

功能演示

普通问答

表情策略、折叠思考过程、工具调用时间线与 AegisAl 状态 Logo：

!神盾 AegisAl 普通问答演示

项目扫描

风险概览、扫描结果与工具执行过程：

!神盾 AegisAl 项目扫描演示

漏洞情报与漏洞库

漏洞情报总览、完整检索与详情查看：

!神盾 AegisAl 漏洞情报与漏洞库演示

核心功能

| 功能 | 实现 |
| --- | --- |
| 安全问答 | LangGraph 分类、记忆召回、能力路由、模型调用、结构化结果与记忆持久化 |
| Multi-Agent Supervisor | Project Context、Code Scan、Component、SBOM、Intelligence、Report、Con Agent 的显式 handoff 与结果聚合 |
| 工作区代码审计 | Java、Python、Go、C、C++、C#、Rust、Solidity 的 Semgrep 与 Tree-sitter AST/CFG/DFG/taint 分析 |
| 漏洞库 | 本地加密目录、CVE/GHSA 聚合、完整 CVE 搜索、严重度筛选、漏洞详情和公开信息跳转 |
| 组件与 SBOM | Maven、Gradle、npm、pip、Go Modules、Cargo、NuGet、Conan、vcpkg 等依赖识别和 CycloneDX 输出 |
| 公开安全资讯 | 聚合公开 RSS/API，缓存、去重、分类、搜索并直接展示源站原文 |
| 报告 | Markdown、Word、PDF、Excel、SARIF、Mermaid 和图表制品 |
| 长期记忆 | 按 user_id 本地隔离、摘要压缩、重要性评分和跨会话召回 |
| 插件与 Skills | 内置神盾 Skills、插件注册表、MCP 工具协议、权限与副作用边界 |
| 桌面安全 | 回环 API、加密状态、系统凭证库、路径边界、符号链接隔离、包完整性检查 |

架构

!神盾 AegisAl v1.3.4 源码架构图

架构图提供 SVG、PNG 和可审阅的 Graphviz 源文件。完整的组件边界、数据流和安全设计见 架构文档。

主要目录：

更完整的边界见 架构文档、产品功能 和 API 参考。

本地开发

后端

独立安全问答服务：

Tauri 前端

测试

正式版打包

macOS

必须使用与目标一致的 Python 和 Rust 架构。Intel 包应在 x86_64 runner 或 Intel Mac 上构建：

Apple Silicon：

Windows x86_64

在 Windows PowerShell 中执行：

构建脚本会验证后端、Worker、静态分析运行时、翻译资源完整性以及产物架构。CI 正式构建可在 GitHub Actions 中手动运行 Cross-platform formal desktop build。

离线翻译模型不直接写入 Git 历史。开发和 CI 使用 scripts/fetch_translation_model.py
从清单固定的官方地址下载，并依次校验上游归档和模型文件的 SHA-256；校验通过后才允许打包。

Agent、Skills 与 MCP

内置 Skills 位于 app/resources/skills/：

Supervisor 根据意图和前置制品选择最小能力集合，专业 Agent 通过显式 handoff 交换结构化结果。MCP Runtime 负责工具输入校验、调用审计、制品登记与错误隔离。报告、SBOM 和组件目录等需要用户确认的流程使用 LangGraph interrupt/resume，避免在未确认时生成或覆盖制品。

翻译边界

安全设计

许可证

本项目采用 AegisAl Source-A Commercial Non-Redistribution License，第三方声明见 NOTICE。GitHub 仓库公开不代表允许再分发或商业使用；生产部署、企业内部非评估用途、SaaS、客户交付、转售及其他商业使用均须获得作者书面商业授权。

项目信息

开发语言：Python

Star 数：8

技术要点

该项目属于安全软件方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕AegisAl：基于 Tauri 2、FastAPI 与 LangGraph 的跨平台桌面安全智能体展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

从技术实现角度看，此类项目的核心在于对底层原理的深入理解与工程化落地。开发者在研究过程中可以结合官方文档与社区讨论，梳理项目的初始化流程、核心模块职责与数据流转，逐步掌握其中的技术细节与设计思路。

使用与学习建议

1. 下载源码压缩包，解压到本地环境。

2. 根据项目类型准备对应的运行环境与依赖。

3. 按照 README 中的步骤完成配置与部署。

4. 在隔离的测试环境中运行验证，避免影响生产系统。

免责声明

本资源来源于开源社区，仅供安全研究、技术学习与合法授权范围内的攻防演练使用，请勿用于任何非法或侵害他人权益的用途。使用本项目产生的一切后果由使用者自行承担。