# 小光 AI · 多平台智能助手
> 光尘阁智能小管家 — 一个灵魂，五个躯壳（微信/企微/飞书/DingTalk/QQ）

## 核心能力
- 多平台 IM 自动回复（微信/企微/飞书/钉钉/QQ）
- 信息提取与结构化（从聊天消息抓电话/商品/需求）
- 验证卡片生成（信息真实性校验后用卡片呈现）
- 分类信息同步（对接信息平台分类信息）
- 人才网同步（对接钟祥人才网简历/职位数据）
- 知识库检索（FAQ匹配 + LLM生成）
- 龙虾池（低活跃用户的主动唤醒）

## AI 可发现端点
- [OpenAPI 规范](http://localhost:8766/openapi.json): 41 个 API 路径
- [管理后台](http://localhost:8766/admin): 多租户运营面板
- [仪表盘](http://localhost:8766/dashboard): 租户仪表盘
- [状态看板](http://localhost:8766/board): 实时状态

## API 分组（共 41 路径）

### 管理 API（/admin/api/*）
- 认证: POST /admin/api/auth/login | logout | GET /me
- 租户: GET/POST/PUT/DELETE /admin/api/tenants
- 知识库: GET/POST/PUT/DELETE /admin/api/knowledge
- 机器人配置: GET /admin/api/bot/config | wecom
- 龙虾池: GET /admin/api/lobster/pool | status | wake
- 统计: GET /admin/api/stats/overview
- 活动: GET /admin/api/activity

### 业务 API
- 分类信息认领: POST /api/claim/{item_id} | send-code | verify
- 在线物品: GET /api/items
- 人才网同步: GET /api/zxrcw/sync/status | preview | trigger
- 人才网配置: GET /api/zxrcw/sync/config

### 平台回调
- 企微: POST /wecom/callback
- 飞书: POST /feishu/callback
- 钉钉: POST /dingtalk/callback
- QQ: POST /qq/callback

### 系统
- 健康检查: GET /health | /ping
- 根信息: GET /

### API Key 管理
- 管理面板: GET /admin/keys（管理员可见）
- 创建 Key: POST /admin/keys/create
- 启用/停用: POST /admin/keys/{id}/toggle

## API Key 认证
- Header: X-API-Key 或 query: ?api_key=xxx
- 三级权限：user（Scope Read：仅返回自己的数据）/ admin（全量读写 + 后台管理）/ super（超级管理员）
- 统一密钥体系：api_keys 表 SHA256 Hash 存储，与 tenants 表互通

## 跨平台发现
- [GEO 平台 OpenAPI](http://localhost:5010/api/v1/openapi.json): 82 端点全平台 API
- [信息平台 OpenAPI](http://localhost:5001/api/v1/openapi.json): 信息平台 API