灵枢 · 智能任务平台

多智能体 AI 任务调度与编排平台。支持定时任务调度、Agent 自主执行、Multi-Agent 工作流编排、知识库语义检索、团队协作。

快速开始

git clone <仓库地址>
cd lingshu
chmod +x start.sh
./start.sh

浏览器访问 http://localhost，登录后即可使用。

默认账号：wangpai / admin123

---

部署方式

方式	命令	适用场景
全 Docker 模式	./start.sh	服务器部署
本地开发模式	./start_local.sh	个人电脑 / 调试

全 Docker 模式

一键启动 3 个容器（MySQL + LingshuClaw 调度引擎 + Flask 后端），无需安装 Python 环境。

./start.sh
# 或手动: docker compose up -d --build

停止：

docker compose down          # 保留数据
docker compose down -v       # 清空数据库

本地开发模式

MySQL 用 Docker 跑，Flask 和 Scheduler 在宿主机直接跑，支持热重载。

chmod +x start_local.sh
./start_local.sh

访问 http://localhost:5000。

停止：Ctrl+C，然后 docker compose -f docker-compose.db-only.yml down

---

配置 AI 引擎

部署后无需修改 .env 文件。登录 Web 界面配置：

设置 → AI 引擎 → 添加引擎

支持 DeepSeek、千问、GLM、OpenAI、Ollama 等任意厂商。Agent 执行任务时自动从引擎配置获取 API Key 和 Endpoint。

如需通过环境变量配置（可选）：

# .env
AI_PROVIDER=deepseek
DEEPSEEK_API_KEY=sk-xxx

---

功能概览

模块	说明
工作台	任务 KPI 统计、执行趋势图、Agent 用量、状态分布
任务中心	定时/手动任务，三种模式：Skill 直调 / Agent 自主 / Multi-Agent 编排
我的智能体	创建和管理 AI 智能体，配置角色定位（Soul）、Memory 规则、绑定引擎
我的工作流	Multi-Agent Commander/Workers 编排，任务拆解 → 派发 → 汇总
技能装配	管理内置技能和上传自定义插件技能，启用/禁用、查看源码
知识库	上传文档（PDF/DOCX/TXT），自动分块 + 向量化，Agent 可语义检索
智能体广场	浏览和复制公共智能体，管理员审核发布
模板广场	任务模板市场，分类筛选、标签云、精选推荐、一键导入
团队空间	多团队协作，成员管理、共享资源、审计日志、团队知识库、团队任务
核心配置	数据源管理、AI 引擎管理
管理中心	用户管理、模板审核、智能体审核

---

目录结构

lingshu/
├── backend/
│   ├── app.py                      # Flask 入口
│   ├── db.py                       # 数据库连接
│   ├── lingshuclaw_client.py       # 调度引擎客户端
│   ├── lingshuclaw/
│   │   ├── scheduler/              # APScheduler 定时调度 + Executor 进程管理
│   │   ├── executor/               # Agent 执行引擎
│   │   │   ├── agent_loop.py       # ReAct 自主循环（LLM + Tool Calling）
│   │   │   ├── multi_agent/        # Commander/Workers 编排器
│   │   │   ├── tools/              # 6 个工具（call_skill / search_knowledge / shell_exec 等）
│   │   │   ├── skills/             # 内置技能 + 插件技能
│   │   │   └── provider/           # AI Provider（DeepSeek / Ollama / OpenAI 兼容）
│   │   └── shared/                 # 配置与协议
│   ├── knowledge/                  # 知识库（分块 / 嵌入 / 搜索）
│   └── routes/                     # 14 个 API Blueprint 路由
├── frontend/                       # Vue 3 + Vite SPA 源码
├── static/dist/                    # 前端构建产物
├── Dockerfile                      # 多阶段构建（Node + Python）
├── docker-compose.yml              # 全 Docker 模式（db + scheduler + app）
├── docker-compose.db-only.yml      # 本地开发模式（仅 MySQL）
├── .env.example                    # 环境变量模板
├── start.sh                        # 生产模式启动脚本
├── start_local.sh                  # 开发模式启动脚本
└── sql/
    ├── schema/                     # 完整数据库设计
    ├── migrations/                 # 增量迁移脚本
    └── demo/                       # 演示/种子数据

---

常见问题

Q: 启动后无法执行任务？

检查是否配置了 AI 引擎：设置 → AI 引擎 → 添加引擎。Agent 需要 AI Provider 才能执行任务。

Q: pip 安装依赖失败？

pip3 install -r backend/requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

Q: 端口冲突？

• 5000：编辑 start_local.sh 最后一行 --port=5000
• 3307：编辑 docker-compose.db-only.yml 的端口映射，同步更新 .env 的 DB_PORT
• 18789：编辑 .env 的 LINGSHUCLAW_PORT

Q: 重置数据库？

docker compose down -v && docker compose up -d