KnowledgeBase/docs/QUICK-REFERENCE.md

飞书机器人快速参考

一、当前状态

飞书机器人知识库对接

• 现状：使用默认知识库（用户所有文件）
• 原因：selectedFiles 和 selectedGroups 参数为 undefined
• 文件：server/src/feishu/feishu.service.ts (line 311-331)

人才测评模块

• 位置：server/src/assessment/
• 功能：基于知识库生成问题、评估答案、生成报告
• 接口：REST API + SSE 流式更新

---

二、快速命令

飞书机器人命令

/assessment start [kbId|templateId]  # 开始测评
/assessment answer [answer]          # 提交答案
/assessment status                   # 查看状态
/assessment result                   # 获取结果
/assessment help                     # 帮助信息

直接回复（无需命令前缀）

# 直接回复答案，系统自动识别

---

三、配置示例

创建带知识库配置的机器人

POST /feishu/bots
{
    "appId": "cli_xxx",
    "appSecret": "xxx",
    "botName": "测评机器人",
    "knowledgeBaseId": "kb_xxx",      # 特定知识库
    "knowledgeGroupId": "group_xxx"   # 或知识组
}

更新知识库配置

PATCH /feishu/bots/:id/knowledge
{
    "knowledgeBaseId": "kb_xxx",
    "knowledgeGroupId": null
}

---

四、文件位置

核心文件

server/src/feishu/
├── feishu.service.ts              # 主服务
├── feishu.controller.ts            # 控制器
├── feishu-ws.manager.ts           # WebSocket 管理
├── entities/
│   ├── feishu-bot.entity.ts       # 机器人实体
│   └── feishu-assessment-session.entity.ts  # 测评会话实体
├── dto/
│   ├── create-bot.dto.ts          # 创建机器人 DTO
│   └── assessment-command.dto.ts  # 命令 DTO
└── services/
    ├── assessment-command.parser.ts  # 命令解析器
    └── feishu-assessment.service.ts  # 测评服务

数据库迁移

server/src/migrations/
├── XXXXXX-AddFeishuBotKnowledgeFields.ts      # 添加知识库字段
└── XXXXXX-CreateFeishuAssessmentSessionTable.ts  # 创建测评会话表

---

五、实施检查清单

阶段 1：基础架构

• 创建数据库迁移脚本
• 更新 FeishuBot 实体
• 更新 CreateFeishuBotDto
• 修改 FeishuService.processChatMessage()

阶段 2：测评集成

• 创建 FeishuAssessmentSession 实体
• 实现命令解析器
• 实现 FeishuAssessmentService
• 集成到 FeishuService
• 设计飞书卡片模板

阶段 3：测试

• 单元测试
• 集成测试
• 文档更新

---

六、常见问题

Q1: 如何让飞书机器人只搜索特定知识库？

A: 在创建机器人时设置 knowledgeBaseId 字段

Q2: 如何切换知识库？

A: 使用 PATCH /feishu/bots/:id/knowledge 接口更新配置

Q3: 测评命令不生效怎么办？

A: 检查命令格式是否正确，确保以 /assessment 或 /测评 开头

Q4: 如何查看测评进度？

A: 发送 /assessment status 或 /assessment result

---

七、参考文档

• 完整设计文档: feishu-assessment-integration-design.md
• 设计摘要: feishu-assessment-integration-summary.md
• 飞书开放平台: https://open.feishu.cn/document