FastXpoAgent Showcase

一个基于 AI Agent 架构 的多用户智能助手项目展示版。
本仓库用于面试评估与技术交流，展示系统设计、工程实现与关键技术取舍。

项目定位

• 面向场景：个人知识管理（PKM）、任务管理、AI 助手路由
• 核心目标：展示 Agent 中枢调度 + 前后端分离 + 多用户数据隔离 的工程能力
• 当前仓库属性：Showcase（展示版），非完整商用版本

在线演示

• Demo 地址：https://your-demo-url.com（建议受控访问）
• Demo 账号：demo@example.com / demo-password
• 说明：演示环境已做能力收敛与访问限制，仅用于功能体验

如果你不想公开站点，建议把链接改为“面试中提供临时访问”。

核心亮点

• 分层 Agent 架构：由中心 Agent 进行意图识别与工具路由
• 前后端职责清晰：前端专注交互展示，后端承载业务与数据逻辑
• 多用户数据隔离：后端 CRUD 以 user_id 为边界，保证数据安全
• 跨端支持：基于 Expo/React Native，支持 Web/iOS/Android
• 工程化能力：模块化组织、接口规范、可扩展技能体系

技术栈

Frontend

• Expo
• React Native
• TypeScript
• Zustand
• Expo Router / React Navigation

Backend

• FastAPI
• SQLAlchemy
• PostgreSQL
• Alembic
• OpenAI-Compatible LLM API

系统架构（简化）

flowchart TD
    A[Client: Web / iOS / Android] --> B[API Gateway / FastAPI]
    B --> C[Central Agent Router]
    C --> D[Thought]
    C --> E[Schedule]
    C --> F[Other Skills]
    D --> G[Database]
    E --> G
    F --> G

Loading

我负责的内容

• 设计并实现 Agent 中枢路由与技能调用流程
• 搭建 FastAPI + SQLAlchemy 的后端业务骨架
• 实现多用户鉴权与数据隔离策略
• 设计前端状态管理与接口对接规范
• 完成核心交互链路与异常处理机制

关键技术取舍

• 采用“前后端极致分离”，避免前端承载复杂业务逻辑
• Agent 采用轻量化实现，保证可控性与可维护性
• 技能层使用命名空间组织，降低工具扩展成本
• 对复杂交互采用可降级策略，保障多端一致性

仓库结构（展示版）

.
├─ README.md
├─ ARCHITECTURE.md
├─ DECISIONS.md
├─ DEMO.md
├─ SECURITY.md
├─ assets/
│  ├─ architecture.png
│  ├─ flow.png
│  └─ demo.gif
├─ examples/
│  ├─ api-request.json
│  └─ api-response.json
└─ .env.example

快速查看

• 架构说明：ARCHITECTURE.md
• 设计决策：DECISIONS.md
• 演示说明：DEMO.md
• 安全边界：SECURITY.md

安全与边界声明

• 本仓库不包含生产环境密钥、真实用户数据与完整商用逻辑
• 演示环境已进行限流、能力裁剪与隔离策略
• 请勿用于未授权商用部署

License / 使用说明

本项目仓库内容主要用于 求职展示与技术交流。
未获作者书面授权，禁止将本仓库内容用于商业用途、镜像分发或二次部署。

---

如需查看完整能力（受限版），可在面试沟通中申请演示。