68 lines
3.2 KiB
Markdown
68 lines
3.2 KiB
Markdown
# 2026-05-11 工作日志
|
||
|
||
## AI 问题归纳接入脚本流程 [刘新玉]
|
||
|
||
### 背景
|
||
脚本 `generate_problem_description()` 是纯规则关键词匹配引擎，当问题类型不在预定义关键词列表中时（如今天 L1 单元名称显示问题），会退化为原文拼贴兜底，描述质量差。
|
||
|
||
虽然 4 月 30 日已有架构决策「脚本输出元数据，AI 负责归纳描述」，但一直未落地到代码。
|
||
|
||
### 实现方案
|
||
|
||
**新增 `--ai-placeholders` 标志：**
|
||
- `generate_problem_description()` 返回 `[待AI归纳:#N]` 编号占位符
|
||
- `generate_summary()` 保存 `cluster_context_{date}.json` 到 `output/daily_feedback/`
|
||
- 占位符编号确保多问题簇时精确匹配
|
||
|
||
**新增 `--apply-ai <descriptions.json>` 模式：**
|
||
- 读取 AI 描述 JSON → 重新生成 markdown → 替换占位符 → 覆盖写入知识库文档
|
||
- AI 描述 JSON 格式：`{"date": "...", "descriptions": [{"index": 1, "description": "..."}]}`
|
||
|
||
**自动化链路：**
|
||
1. 定时任务 `--ai-placeholders` → 生成占位符文档 + 上下文 JSON
|
||
2. 心跳检测到上下文 JSON → AI 读取并生成描述 → `--apply-ai` 回写
|
||
|
||
### 修复的 Bug
|
||
- **markdown 内联传递转义问题**：`subprocess.run([..., "--markdown", content])` 内联传递会导致飞书 rich text 元素（如 `<lark-table>`）被错误转义。改用 `@file` 相对路径方式传递。
|
||
- **`update_summary_doc_as_children()`** 同样修复为 `@file` 方式
|
||
|
||
### 清理
|
||
- 移除 crontab 中两个无用的每分钟任务：`sync_feishu_feedback_summary.sh` 和 `sync_feishu_feedback_dispatch_p0.sh`
|
||
|
||
### 文件变更
|
||
- `skills/feishu-feedback-sync/scripts/sync_feishu_feedback.py` — 核心修改
|
||
- `skills/feishu-feedback-sync/SKILL.md` — 新增步骤 8 文档
|
||
- `HEARTBEAT.md` — 新增 AI 归纳心跳任务
|
||
- `output/daily_feedback/ai_descriptions_2026-05-11.json` — 示例 AI 描述
|
||
|
||
## merge_forward（多条转发）消息处理 [李若松]
|
||
|
||
### 需求
|
||
飞书群消息同步中，`merge_forward`（多条转发）类型消息原本无法处理（content 显示"无法提取资源key"），需要完整记录转发内容。
|
||
|
||
### 实现方案（方案B+）
|
||
1. **新增字段 `forward_detail` (LONGTEXT)**：存储转发详情，媒体已替换为COS链接
|
||
2. **新增函数 `process_merge_forward_message()`**：解析 `<forwarded_messages>` XML → 下载子消息中的图片/视频/封面 → 上传COS → 生成含URL的完整内容
|
||
3. **`content` 字段**存储可读摘要：`[转发N条] 发送者: 首行文本 | ...`
|
||
|
||
### 媒体下载验证
|
||
- ✅ 转发消息中引用的图片 key（`img_v3_xxx`）可通过 merge_forward 的 message_id 正常下载
|
||
- ✅ 视频 key（`file_v3_xxx`）也可正常下载
|
||
- ✅ 视频封面图支持
|
||
|
||
### 产出
|
||
- DDL: `ALTER TABLE lark_group_message ADD COLUMN forward_detail LONGTEXT`
|
||
- 脚本改动: `skills/feishu-group-msg-sync/scripts/sync_group_to_mysql.py`
|
||
- 文档更新: `skills/feishu-group-msg-sync/SKILL.md`
|
||
- 历史数据修复: id=216 记录已重新处理，6个媒体全部上传COS
|
||
|
||
### forward_detail 格式
|
||
```
|
||
[2026-04-20 17:14] 黄敏:
|
||
[图片1](https://cos.xxx/img1.png)
|
||
L1 9-5,关卡图标显示异常...
|
||
[2026-04-23 19:08] 胡陈辰:
|
||
[视频1 时长77s](https://cos.xxx/video.mov)
|
||
[封面](https://cos.xxx/cover.png)
|
||
```
|