**DeepAgents** — 基于 DeepSeek 的多角色协作 Agent 平台(Electron 桌面应用)。
| 端 | 技术栈 | 说明 |
|----|--------|------|
| `backend/` | Python 3.14 + FastAPI 0.137 | 核心服务:Agent 循环、工具、记忆、RAG、MCP、计费 |
| `frontend/` | React 19 + TS + Vite 8 + Tailwind 4 + Zustand | SPA(dev :5173 / 打包 file://) |
| `electron/` | Electron 33 | 桌面封装:自动建 venv、spawn 后端、起窗口 |
| 左侧会话栏 | 浅灰背景,会话列表,支持新建/切换/重命名/删除 |
| 右侧聊天区 | 纯白背景,消息渲染(Markdown + 代码高亮),用户消息浅灰底、AI消息白底 |
| 顶部导航栏 | Agent 选择器(芯片式切换),模型选择器(v4-flash / v4-pro) |
| 输入框 | 底部固定,圆角+阴影,聚焦蓝色边框,支持 Enter 发送、Shift+Enter 换行 |
| **思考过程展示** | 灰色小字区域,逐 Token 渲染推理过程(reasoning_tokens),可折叠展开 |
| **回答展示** | 思考过程下方展示完整回答,逐 Token 打字机效果,可独立折叠 |
| 流式输出 | SSE 分两个 Event 推送:`event: reasoning` + `event: content`,前端各自渲染 |
| 多Agent协作视图 | 卡片式展示各Agent状态(思考中/已完成/等待中),支持并行查看 |
| Agent管理弹窗 | 卡片式添加/编辑Agent,配置名称、System Prompt、模型、工具权限 |
| 文件上传区 | 支持拖拽上传图片/视频/音频/代码文件 |
个人开发从0-1的可插拔可自定义角色的Windows端智能体平台。
## 功能特性
- **Chat / Plan 双模式**:Chat 模式只读对话,Plan 模式开放全部工具用于执行任务
- **任务生命周期闭环**:`submit_plan` 提交计划 → 用户审批 → 执行 → `request_review` 申请验收 → 通过归档 / 拒绝继续修改
- **联网搜索**:DeepSeek Responses API 服务端 `web_search`,模型自主决策搜索,零第三方费用(token 计入 DeepSeek 账单)
- **工具集**:8 个技能模块(文件系统 / 命令执行 / 记忆 / 计划 / 对话 / 文件分析 / 浏览器操控 / 工具)
- **命令执行**:Windows 中文输出智能解码(UTF-8 → GBK)、超时杀进程树并返回部分输出、后台任务全生命周期
- **记忆管理**:三层记忆(角色 profile / 段落摘要 / 滑动窗口)+ 压缩器
- **RAG(后端就绪)**:LlamaIndex + ChromaDB 文件解析与向量检索(前端接入待定)
- **MCP 支持**:MCP 服务集成与动态工具注册
- **安全**:API key Windows DPAPI 加密落盘、路径穿越防护、CORS 白名单