
## 用户反馈问题汇总文档结构调整 [刘新玉] - 2026-05-07 10:45

### 变更内容
1. 「用户反馈问题汇总」文档改为按日期创建独立子文档，每天一个
2. 子文档标题格式：`YYYY-MM-DD 问题反馈`
3. 父文档（RaL6whoYMijyYHkSlWrc7OLLnBy）改为索引说明页
4. 子文档 obj_token：
   - 2026-05-06: ISpQdgf6QoIKIyxdZjPcTAa4nEe
   - 2026-04-28: UusFdRBEioSs4ox9JhPcXGfCnzf

### 脚本修改
- `sync_feishu_feedback.py` 中新增 `update_summary_doc_as_children()` 函数
- 逻辑：先 `list_child_nodes()` 查已有子文档 → 存在则更新、不存在才创建
- **核心规则：每天只新增一个对应日期的子文档，绝不重复创建**

### 同步清理
- 数据库中 sender_name='未知' 的3条无效记录已删除
- 「内容测试问题反馈」电子表格中也清理了"未知"发送者的行
- 该电子表格已从"飞书问题反馈-近3天"重命名为"内容测试问题反馈"

### 飞书群信息 [李若松确认] - 2026-05-07 11:23
- 「小葵小葵」群 chat_id: `oc_4171a2188f2554522a4309f2d7c27753`，小葵Bot已在该群中
- 相关负责人需要往此群发消息时，直接用 Bot 身份向该 chat_id 发送

### 知识空间信息
- space_id: 7612229802338045122
- 父节点 node_token: RaL6whoYMijyYHkSlWrc7OLLnBy
- 父节点 obj_token: J8bKd4dbYoofZixxVsCc06bhnFc (docx)

## 用户反馈问题汇总文档结构调整 [刘新玉] - 2026-05-07 10:45

### 变更内容
1. 「用户反馈问题汇总」文档改为按日期创建独立子文档，每天一个
2. 子文档标题格式：`YYYY-MM-DD 问题反馈`
3. 父文档（RaL6whoYMijyYHkSlWrc7OLLnBy）改为索引说明页
4. 子文档 obj_token：
   - 2026-05-06: ISpQdgf6QoIKIyxdZjPcTAa4nEe
   - 2026-04-28: UusFdRBEioSs4ox9JhPcXGfCnzf

### 脚本修改
- `sync_feishu_feedback.py` 中新增 `update_summary_doc_as_children()` 函数
- 逻辑：先 `list_child_nodes()` 查已有子文档 → 存在则更新、不存在才创建
- **核心规则：每天只新增一个对应日期的子文档，绝不重复创建**

### 同步清理
- 数据库中 sender_name='未知' 的3条无效记录已删除
- 「内容测试问题反馈」电子表格中也清理了"未知"发送者的行
- 该电子表格已从"飞书问题反馈-近3天"重命名为"内容测试问题反馈"

### 飞书群信息 [李若松确认] - 2026-05-07 11:23
- 「小葵小葵」群 chat_id: `oc_4171a2188f2554522a4309f2d7c27753`，小葵Bot已在该群中
- 相关负责人需要往此群发消息时，直接用 Bot 身份向该 chat_id 发送

### 知识空间信息
- space_id: 7612229802338045122
- 父节点 node_token: RaL6whoYMijyYHkSlWrc7OLLnBy
- 父节点 obj_token: J8bKd4dbYoofZixxVsCc06bhnFc (docx)

---

## 今日问题归纳增加问题分类 [刘新玉] - 2026-05-07 10:55

### 新增步骤6：问题分类
在优先级判定之后，对每个问题添加分类标签。输出格式：
```
**⚠️ P0级核心问题（需优先处理）**
1. **Loading/加载类**
   - 问题描述...
**⚡ P1级重要问题**
1. **关卡/内容类**
   - 问题描述...
```

### 问题分类规则（按匹配优先级从上到下）
| 优先级 | 分类 | 匹配关键词 |
|--------|------|-----------|
| 1 | 启动/运行异常 | 闪退、崩溃、crash、进不去、卡死、黑屏、重启、服务器宕机、服务器挂了 |
| 2 | 版本/更新类 | 更新、升级、新版、版本、安装失败、OTA、热更新、无法更新、下载更新 |
| 3 | Loading/加载类 | 加载、loading、loading卡死、转星星、加载慢、加载超时、loading超时、一直加载 |
| 4 | 数据/进度类 | 数据丢失、数据异常、进度丢失、数据错误、分数异常、进度不对、记录丢失、数据对不上 |
| 5 | 声音/音频类 | 无声、声音、音频、没声音、音效 |
| 6 | 语音识别/判分类 | 判分、识别、语音识别、发音、评分、打分、AI判分 |
| 7 | 关卡/内容类 | 关卡、题目、答案、内容 |
| 8 | UI显示类 | 显示、界面、UI、HUD、动画、层级、图层、渲染 |
| 9 | 用户反馈问题 | 建议、反馈、体验、优化 |
| 10 | 其他问题 | （默认兜底） |

### 脚本修改
- `priority_classifier.py` 新增 `proble m_category(keyword)` 函数和 `CATEGORY_KEYWORDS` 规则
- `sync_feishu_feedback.py` 中 `summarize_cluster()` 新增 `category` 字段
- `generate_summary()` 输出格式改为按优先级+分类分组

---

## 新增步骤7：问题分发 [刘新玉] - 2026-05-07 11:09

### 需求
将每日问题归纳同步到「小葵小葵」群，P0问题@相关负责人跟进。

### 分发规则
1. 将"今日问题归纳"内容发送到指定群（格式：标题+归纳正文+文档链接）
2. P0问题 @相关负责人的 @列表（从 `summarize_cluster` 的 `operators` 字段提取发言人）

### Bot身份问题
- Bot应用名：**小研**（App ID: `cli_a931175d41799cc7`）
- Bot发消息需要已经加入目标群
- 小葵Bot在「小葵小葵」群中发消息报 500 "chat does not exist" → 可能是不同应用
- **待解决**：需要确认"小葵小葵"群里加的是哪个应用，或者把小研Bot加进去

### 脚本修改
- `sync_feishu_feedback.py` 新增 `dispatch_to_group()` 函数
- 新增 `--dispatch` 参数控制是否执行步骤7
- 新增 `--dispatch-chat-id` 参数指定目标群（默认 oc_4171a2188f2554522a4309f2d7c27753）

### 关键配置
- 目标群 chat_id: `oc_4171a2188f2554522a4309f2d7c27753`
- 毋益飞 user_id: `eggbg21g`
- SKILL.md 已从"五步流程"更新为"七步流程"

---

## 当日待跟进事项
1. 「小葵小葵」群Bot发消息报错问题 → 需确认群内有哪个Bot应用，或引入小研Bot

---

## 步骤7格式调整 [刘新玉] - 2026-05-07 11:40

### 最终消息格式（已确认并更新到脚本和SKILL.md）
```
📋 2026-04-28 用户反馈问题归纳

**⚠️ P0级核心问题（需优先处理）** @毋益飞
1. **Loading/加载类**
   - 在iOS 端关卡内（3-2），Loading 耗时约 10 秒...

**⚡ P1级重要问题**
1. **关卡/内容类**
   - 【偶现】在移动端关卡内（11-2），NPC 头上的 HUD...

📄 详细反馈文档：https://makee-interactive.feishu.cn/wiki/CQ0UwjRTZijvvEk6tSecEUTXnFg
```
- @逻辑：P0标题行后面直接@发言人，@列表从 `summarize_cluster` 的 `operators` 提取
- 非P0问题不@

### H5链接
- 尝试生成公开H5链接失败，Bot无 `drive:permission` 权限
- 当前使用飞书wiki链接，飞书App内可直接打开
- 若需外部浏览器访问，需在知识空间设置"互联网上可查看"

### 小葵Bot身份确认
- xiaokui 凭证目录：`/root/.openclaw/credentials/xiaokui`
- xiaoyan 凭证目录：`/root/.openclaw/credentials/xiaoyan`
- 发「小葵小葵」群消息用 xiaokui 身份成功

---

## 当前定时任务清单 [刘新玉] - 2026-05-07 14:59

| 时间 | 任务 | 
|------|------|
| 每天 02:00 | vala_skill_auto_push.sh（技能推送） |
| 每天 08:00-22:00 每2小时 | run_lark_group_sync.sh（反馈群消息同步到数据库） |
| 每天 08:10 | backup.sh（工作区Git备份） |
| 每分钟 | sync_wechat_feedback_minutely.py（微信用户反馈实时同步） |
| 每天 09:30 | daily_feedback_report.sh（每日反馈报告） |
| 每天 09:00 | run_export_lark_feedback.sh（飞书反馈数据导出） |
| **每天 10:00** | **sync_feishu_feedback_wrapper.sh（飞书问题反馈同步，含7步+分发到群）** |

---

## 定时任务演化记录 [刘新玉] - 2026-05-07 15:03~15:56

### 已移除的任务
- `sync_wechat_feedback_minutely.py`（微信用户反馈实时同步）— 已删除
- `daily_feedback_report.sh`（每日反馈报告）— 已删除

### 最终定时任务清单（2026-05-07 15:56）

| 频率 | 脚本 | 步骤 | 说明 |
|------|------|------|------|
| 每天 02:00 | `vala_skill_auto_push.sh` | — | 技能推送到 SkillHub |
| 每分钟 | `run_lark_group_sync.sh` | — | 群消息同步到数据库 |
| 每天 08:10 | `backup.sh` | — | Git 工作区备份 |
| 每分钟 | `run_export_lark_feedback.sh` | — | 当天数据实时导出 Excel |
| 每分钟 | `sync_feishu_feedback_realtime.sh` | 1-3 | 实时写入电子表格 |
| 每分钟 | `sync_feishu_feedback_summary.sh` | 4-6 | 归纳+分类 → 子文档 |
| 每分钟 | `sync_feishu_feedback_dispatch_p0.sh` | 7（仅P0） | P0问题实时分发到群 |
| 每天 10:00 | `sync_feishu_feedback_wrapper.sh` | 7（全部） | 全量分发到群 |

### 完整数据流
```
群消息 → 每1分钟入MySQL → 每1分钟刷新表格 → 每1分钟归纳+分类 → P0实时发群 / 每天10:00全量发群
```

### 关键技术细节
- **拆分方式**：`sync_feishu_feedback.py` 新增 `--steps` 参数（如 `--steps 1-3`、`--steps 4-6`、`--steps 7`）
- **分发模式**：新增 `--dispatch-mode` 参数，`p0` 只发P0级，`all` 发全部
- **电子表格**：`TVivwmzqXiW3YakDUzucFMRenvf`（"内容测试问题反馈"）
- **归纳子文档父节点**：`RaL6whoYMijyYHkSlWrc7OLLnBy`（space_id: 7612229802338045122）
- **分发目标群**：`oc_4171a2188f2554522a4309f2d7c27753`（「小葵小葵」群）
- **分发Bot**：xiaokui（`/root/.openclaw/credentials/xiaokui`）
- **新 wrapper 脚本**：
  - `scripts/sync_feishu_feedback_realtime.sh`（步骤1-3）
  - `scripts/sync_feishu_feedback_summary.sh`（步骤4-6）
  - `scripts/sync_feishu_feedback_dispatch_p0.sh`（步骤7 P0）
  - `scripts/sync_feishu_feedback_wrapper.sh`（步骤7 全量，每天10:00）
