机器人有问题，还得摇人吧！ 帮助解决问题，打怪升级赚钱！沉淀行业知识库，共建第一个开源机器人服务平台。 —— 微信搜索并关注服务号 「摇人吧」，即刻开始。
无需任何部署，微信扫码关注服务号 摇人吧，即刻开始使用：
微信扫一扫，关注「摇人吧」
关注后，底部三个菜单覆盖你的三种视角：
- 🆘 我要摇人（需求）—— 一键报障提单；AI 在线咨询先帮你初步诊断、自助解决，搞不定再自动打包成工单转人工
- 📥 系统任务（供给）—— 统一任务收件箱：派给你的工单 / bug / 需求等，AI 辅助生成处理草稿，人工校验后提交
- 📊 后台管理（管理）—— 跨项目看板、风险红黄灯、项目/日报、机器人故障与运行统计，AI 给出风险提示与优化建议
- 🔔 消息通知 —— 处理进展通过微信模板消息实时推送，不错过任何回复
三个菜单对所有人统一开放——因为每个人都同时有"需求 / 供给 / 管理"三种视角；页面内容按你的角色动态呈现。
「摇人吧」是本项目的官方公共服务实例，由项目维护者运营，开箱即用、持续更新。 这就是大多数用户需要的全部——扫码关注即可，下方的部署内容仅面向想自建实例的开发者。
OpenRobotService（公共实例：「摇人吧」）是一个面向工业移动机器人（AGV / AMR）项目交付场景的微信服务号平台，目标是高效"摇人"解决问题、加快项目交付：现场遇到问题 → 微信里 AI 咨询/提交工单 → 自动派给对应工程师/项目经理 → 工单内协作讨论 → 疑难一键上报领导 → 闭环解决，并把处理经验沉淀进知识库。
它不仅是工单系统，更覆盖项目交付管理（项目 / 风险 / 日报 / 授权）与机器人运行数据（由 USP 调度平台上传的故障与任务统计），并由 AI 沿"需求 / 供给 / 管理"三种视角全流程深度参与，配合**专业知识库（RAG）**持续提升响应效率与处理质量。
完整产品形态见 docs/PRODUCT.md，技术架构见 docs/ARCHITECTURE.md。
用户(任意角色) ──微信服务号菜单 / H5──> 咨询问题 / 提交工单
│
▼
工单进入系统，自动/手动派单
│
┌───────────────────────┼───────────────────────┐
▼ ▼ ▼
转发给处理人员 工单内多方讨论 上报上级领导
(微信模板消息通知) (评论时间线留痕) (升级 escalation)
│ │ │
└───────────────────────┴───────────────────────┘
▼
工单关闭 / 交付完成
提交工单、参与讨论是所有角色的通用能力；角色差异体现在派单、上报接收范围、可见工单范围和管理权限上。
| 角色 | 说明 | 主要能力 |
|---|---|---|
customer |
客户 / 现场人员 | 提交工单、咨询、参与讨论、查看自己提交的工单 |
engineer |
实施工程师 | 提交工单、接单处理、转派、讨论、上报、查看指派给自己的工单 |
manager |
项目经理 | 提交工单、派单/转发、处理、讨论、上报、查看本项目工单 |
leader |
上级领导 | 提交工单、接收上报、决策、讨论、查看全局工单 |
admin |
系统管理员 | 全部权限、用户与项目管理 |
以下内容仅面向开发者——如果你想私有化部署、用自己的微信服务号运行、或二次开发。 普通使用者请直接关注上方的 「摇人吧」 服务号，无需阅读本节。
本项目以 AGPL v3 开源，支持完全自托管。
| 层次 | 技术 |
|---|---|
| 后端 | Python 3.11+ · FastAPI · SQLAlchemy 2.0 · Alembic |
| 数据库 | MySQL 8.x (utf8mb4) |
| 知识库 | Qdrant 向量库 · Embedding · RAG 检索 |
| AI | 在线商用大模型 API（默认 DeepSeek，可切换）· 三视角 Agent |
| 微信对接 | wechatpy（消息回调 / 自定义菜单 / OAuth 网页授权 / 模板消息） |
| 前端 | Vue 3 · Vite · Vant（移动端 H5，微信内打开） |
| 缓存/队列 | Redis |
| 认证 | 微信 OAuth + JWT · RBAC |
| 部署 | Docker Compose · Nginx |
OpenRobotService/
├── backend/ # FastAPI 后端
│ ├── app/
│ │ ├── api/ # 路由层
│ │ ├── core/ # 配置、安全、依赖、USP 接缝
│ │ ├── models/ # SQLAlchemy 模型
│ │ ├── schemas/ # Pydantic 模型
│ │ ├── services/ # 业务逻辑层（任务状态机等）
│ │ ├── wechat/ # 微信服务号对接（菜单/鉴权/对话/通知）
│ │ ├── kb/ # 知识库（摄取 / RAG 检索 / 动态总结）
│ │ ├── ai/ # AI 算法（三视角 Agent + LLM 基础层）
│ │ └── main.py
│ ├── alembic/ # 数据库迁移
│ ├── tests/ # pytest 测试
│ └── requirements.txt
├── frontend/ # Vue3 H5 前端（我要摇人 / 系统任务 / 后台管理）
├── docs/ # 文档（产品 / 架构 / 微信配置 / 部署）
├── scripts/ # 运维脚本
└── README.md
详细步骤见 docs/SETUP.md。简要：
# 1. 后端
cd backend
python -m venv .venv && source .venv/Scripts/activate # Windows Git Bash
pip install -r requirements.txt
cp .env.example .env # 填写数据库与微信配置
alembic upgrade head # 建表
uvicorn app.main:app --reload # 启动，访问 http://127.0.0.1:8000/docs
# 2. 前端
cd frontend
npm install
npm run dev欢迎贡献！请阅读 CONTRIBUTING.md。
本项目采用 GNU AGPL v3 协议开源。
任何基于本项目的修改和衍生作品都必须以 AGPL v3 协议开源——即使只是把它部署成网络服务（SaaS）对外提供，也必须向用户公开完整源代码。
AGPL v3 © 2026 dhualai