LeCai AI · 政府采购协同智能体

面向电子卖场与项目采购的本地 Agent 工作台
多会话协同 · 长期记忆 · 工具调用 · 子代理 · MCP · Scheduler · 桌面端

LeCai AI 是一个本地运行的 Python 智能体系统，面向政府采购、电子卖场和项目采购场景设计。它不是单纯的聊天机器人，也不是一次性的 demo，而是一套可长期使用、可恢复、可审计、可扩展的本地 Agent 运行时。

它可以把采购需求梳理、招采材料整理、电子卖场信息比对、流程跟进、任务拆解、工具调用、子代理协作和长期提醒放进同一个工作台里持续推进。

---

产品定位

LeCai AI 的默认角色是“采购协同总控”：

• 面向电子卖场、政府采购、项目采购等日常业务
• 支持问答、规划、执行、复核和长期跟进
• 强调本地运行、本地存储和过程可追溯
• 通过多会话、记忆、工具、子代理和 MCP 提升复杂任务处理能力

系统内置三类核心使用方式：

模式	用途	典型场景
chat	通用问答与协同处理	采购咨询、材料整理、信息汇总
build	绑定具体工作目录或项目目录	项目采购材料、文档、清单、代码或流程文件
scheduler	长期自动检查与周期任务	到期提醒、定时巡检、主动跟进

---

适用场景

LeCai AI 首版重点覆盖这些业务方向：

• 采购需求梳理与任务拆解
• 电子卖场商品信息收集、比价和差异整理
• 项目采购材料清单整理、缺项核验和风险提示
• 采购方案、说明、答疑、纪要等文本辅助生成
• 多步骤任务执行、阶段验收和长期跟进

---

快速开始

1. 安装 Python 依赖

cd /Users/luliangliang/openSources/le-ai-agent
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
pip install -e .

2. 初始化模型配置

le-ai-agent init

这一步会生成本地私有配置，例如：

• model_config.json
• lecai.local.json
• templates/USER.local.md
• memory/

3. 启动后端 UI

le-ai-agent web --host 127.0.0.1 --port 8765 --open

启动成功后可直接访问：

• http://127.0.0.1:8765

4. 启动桌面端界面

cd desktop
npm install
npm run dev

说明：

• desktop/ 是 Electron + Vue 前端工程
• 开发模式会启动 renderer dev server，并拉起 Electron 壳
• 如果只想先用 Web 版本，可直接使用 le-ai-agent web

---

常用命令

le-ai-agent init
le-ai-agent chat
le-ai-agent status
le-ai-agent doctor
le-ai-agent web --host 127.0.0.1 --port 8765 --open

质量检查：

.venv/bin/python -m pip install -r requirements-dev.txt
make check

---

核心能力

1. 多会话与工作区隔离

• 每个会话独立保存 history.jsonl、checkpoint 和 runtime events
• chat 适合通用协同
• build 可绑定某个项目目录、采购目录或工作资料目录

2. 分层记忆

• 全局长期记忆：memory/MEMORY.local.md
• 用户画像档案：templates/USER.local.md
• 项目级记忆：项目目录中的 AGENTS.md 托管区块
• 支持记忆快照、diff 和恢复

3. 工具调用

内置工具覆盖常见执行路径：

• read_file / write_file / edit_file
• glob / grep
• run_command
• web_fetch
• weather
• load_skill
• update_todos
• scheduler
• dispatch_subagent

4. 子代理协作

当前子代理体系已改造成业务型角色：

• rapid_researcher：快速检索与事实确认
• document_analyst：文档、制度、材料分析
• market_researcher：网页查访与外部信息对比
• compliance_checker：清单核验、缺项检查
• execution_specialist：文件改写、命令执行、结果验收
• verification_reviewer：独立复核与风险检查

5. Ask / Plan / 权限控制

• ask_before_edit：默认模式，高风险操作先审批
• plan：只允许只读探索、提问和提交计划
• auto：更高自动化

6. MCP 扩展

• 支持 stdio / SSE 方式接入 MCP Server
• 外部工具会自动注册为 mcp_{server}_{tool}
• 与内置工具统一调度

7. Scheduler 与主动跟进

• 支持 at / every / cron
• 支持长期任务、周期巡检和定时触发
• 可作为采购进度提醒、周期检查或主动跟进入口

---

技能系统

技能位于 skills/，按需加载，不会在启动时全部塞进上下文。

当前与采购相关的技能占位包括：

• skills/procurement-analysis
• skills/e-market-research
• skills/bid-document-check

通用技能还包括：

• skills/weather
• skills/ddg-web-search-1.0.0
• 其他扩展能力包

---

目录结构

agent.py                        CLI 兼容入口
webui.py                        API 启动入口

agent/
├── loop.py                     主循环与系统装配
├── cli.py                      CLI 命令入口
├── onboarding.py               初始化向导与 doctor
├── model_router.py             主/次模型路由
├── runner.py                   单轮执行、工具循环、恢复逻辑
├── memory.py                   记忆与历史持久化
├── memory_versions.py          记忆快照与恢复
├── tools/                      内置工具
├── subagents/                  子代理定义与 registry
├── scheduler/                  定时任务系统
├── mcp/                        MCP 客户端
├── web/                        aiohttp Web 后端
├── sessions/                   多会话存储
├── projects/                   Build 项目索引与项目记忆
├── team/                       持久 Team 协作
└── desktop_pet/                可选桌宠管理

desktop/                        Electron + Vue 桌面前端
desktop-pet/                    桌宠 companion
templates/                      Prompt 与初始化模板
skills/                         能力包
assets/                         品牌与前端素材
tests/                          单元测试与集成测试
memory/                         本地运行产物（gitignore）

---

配置文件

文件	作用
model_config.json	本地模型配置
lecai.local.json	本地 WebUI / 桌宠偏好
mcp_config.json	MCP 配置
templates/USER.local.md	本地用户档案
memory/MEMORY.local.md	全局长期记忆

这些文件都属于本地私有数据，不应提交到 Git。

---

WebUI 与桌面端

前端位于 desktop/，当前采用：

• Electron
• electron-vite
• Vue 3
• TypeScript
• Tailwind
• vue-router

主要界面特性：

• Codex 风格单侧栏
• 多会话与项目分组
• 流式消息、工具事件、子代理事件展示
• 模型、记忆、Token、MCP、配置统一进入设置页

欢迎页品牌图与文案当前由这些文件控制：

• desktop/src/renderer/src/components/chat/MessageList.vue
• assets/generated/lecai-ai-wordmark.png

---

协作建议

如果你要继续扩展这个项目，建议优先按这个顺序阅读：

1. README.md
2. AGENTS.md
3. agent/cli.py
4. agent/loop.py
5. agent/runner.py
6. agent/tools/
7. agent/subagents/
8. agent/web/
9. desktop/src/renderer/src/

---

许可

本项目沿用仓库根目录的 LICENSE。