AI SynapseOS
智能工作空间的人工智能操作系统
SynapseOS是下一代本地优先、高度可扩展的后端引擎，使多个AI代理能够同时执行协调的任务。利用统一的事件网格（MCP over Redis），复杂的推理循环可以动态地适应传入的Webhook、自然语言工作流和深度知识图查询。把它想象成Zapier，但模块实际上是独立思考的。
______________________________________________________________________
🔥 主要特征和功能
- 模型上下文协议（MCP）基础：类似微服务的AI工具功能隔离。代理直接与标准功能自主交互。
- 自主工作流React Flow可视化构建器将自然语言（通过Gemini）转换为严格的执行节点（“如果发票>10天→ 通往财务代理的路线”）。
- 代理智能网格：通过计划-执行-验证推理循环执行的专业内部代理（财务、支持、销售）。
- 矢量RAG知识库：集成文档矢量化，允许代理即时调用自定义工作区文件，并为人类提供高级Omnisearch索引。
- 企业循环人（HITL）：未达到75%置信阈值的操作验证会自动停止，在RBAC角色验证的审批队列中排队。
- 实时活动Websockets：与Redis Pub/Sub的深度集成提供了对流入统一执行仪表板UI的代理工作流的亚秒级延迟跟踪。
______________________________________________________________________
🏗 架构说明
技术栈:
- 后端核心：FastAPI（Python）、SQLAlchemy异步、Pydantic、Uvicorn/Gunicorn。
- 前端仪表板Next.js 14、React、Zustand、React Flow、TailwindCSS、Shadcn/ui。
- 数据库和状态：PostgreSQL（w/
pgvector用于嵌入）、Redis（用于Streams/PubSub）。 - 人工智能:
google-generativeai（双子座1.5）。
*真正的魔法发生在事件引擎中。* mcp/router.py 拦截传入的Webhook，根据工作流编译器实例化的动态规则对其进行验证，并将原始执行计划分配给本地化的专用代理。
______________________________________________________________________
🚀 本地快速入门（Docker）
git clone https://github.com/mh-hanzla/SynapseOS.git
cd SynapseOS
# Configure Environment
cp .env.example .env
# Boot the isolated containers
docker-compose up --build导航至 http://localhost:3000 查看Executive edge。FastAPI Swagger文档可在 http://localhost:8000/docs.
______________________________________________________________________
🌐 生产部署
SynapseOS MVP是完全容器化的，为高可用边缘PaaS解决方案做好了生产准备。 查看综合 部署指导 编排健壮的堆栈：
- 前端边缘路由: 维塞尔
- FastAPI核心引擎: 渲染 （Web服务，自动扩展的Docker运行时）
- 数据库保险库: 速贝 （提供优化的pgvector托管）
- 消息传递管道: 升级版无服务器Redis
______________________________________________________________________
🛡️ 审计与安全
所有外部突变都是被迫通过的 PerformanceAndAuditMiddleware 记录高保真不可变性轨迹。应用程序范围的路由限制会立即删除未经身份验证的异常。所有秘密都严格限于CI/CD库注入。
______________________________________________________________________
*作为投资组合的顶点构建|2026*