6.5 KiB
6.5 KiB
2026-05-06 工作日志
刘新玉:飞书反馈优先级判定(步骤5)落地
需求背景
- 刘新玉发来「用户反馈问题优先级判断文档」PDF,要求将优先级判定集成到飞书反馈同步流程的第5步
- 前四步骤已完成:数据同步→写入表格→对话链排序→问题归纳
- 刘新玉确认"需要"两个方案(脚本自动判定 + 知识库文档标注),全自动判定无需人工确认
完成内容
1. 新增 priority_classifier.py
- 路径:
skills/feishu-feedback-sync/scripts/priority_classifier.py - P0-P3 基础优先级判定:基于关键词匹配(崩溃/闪退/数据丢失/无音频等)
- 动态调整:出现概率(必现/高概率/中概率/低概率/偶现)× 影响范围(全部用户/大部分/部分/极少数)
- 最终排序:P0→P1→P2→P3,同级按最早消息时间
2. 集成到 sync_feishu_feedback.py
summarize_cluster()增加 priority 参数,输出带优先级标签generate_summary()调用compute_final_priority()+sort_by_priority()排序- 新增
--skip-priorityCLI 参数 - 修复了推断引用算法的孤立簇问题:在 sort_threads Union-Find 后增加合并单条孤立消息到有发送者重叠的大簇的逻辑
3. 更新 SKILL.md 文档
- 增加了步骤5的完整文档说明
- 增加了优先级判定规则速查表
4. 真实数据验证结果
- 2026-04-28 数据:2个问题
- P0:iOS端Loading超时致数据丢失/无音频(15条)
- P1:移动端NPC HUD偶尔变成一小条(8条)
待确认
- 步骤5的优先级标注目前仅在脚本输出中展示,尚未写入「用户反馈问题汇总」文档(RaL6whoYMijyYHkSlWrc7OLLnBy)
- 刘新玉需确认是否需要增加文档自动写入能力
刘新玉:PDF文件处理
- 刘新玉于11:02发送PDF(用户反馈问题优先级判断文档),8页A4
- 已用pdftotext解析并完整阅读
- 内容:P0-P3四级优先级定义、动态调整规则、三大判断问题
- 已基于此文档实现优先级判定规则
2026-05-06 工作日志
刘新玉:飞书反馈优先级判定(步骤5)落地
需求背景
- 刘新玉发来「用户反馈问题优先级判断文档」PDF,要求将优先级判定集成到飞书反馈同步流程的第5步
- 前四步骤已完成:数据同步→写入表格→对话链排序→问题归纳
- 刘新玉确认"需要"两个方案(脚本自动判定 + 知识库文档标注),全自动判定无需人工确认
完成内容
1. 新增 priority_classifier.py
- 路径:
skills/feishu-feedback-sync/scripts/priority_classifier.py - P0-P3 基础优先级判定:基于关键词匹配(崩溃/闪退/数据丢失/无音频等)
- 动态调整:出现概率(必现/高概率/中概率/低概率/偶现)× 影响范围(全部用户/大部分/部分/极少数)
- 最终排序:P0→P1→P2→P3,同级按最早消息时间
2. 集成到 sync_feishu_feedback.py
summarize_cluster()增加 priority 参数,输出带优先级标签generate_summary()调用compute_final_priority()+sort_by_priority()排序- 新增
--skip-priorityCLI 参数 - 修复了推断引用算法的孤立簇问题:在 sort_threads Union-Find 后增加合并单条孤立消息到有发送者重叠的大簇的逻辑
3. 更新 SKILL.md 文档
- 增加了步骤5的完整文档说明
- 增加了优先级判定规则速查表
4. 真实数据验证结果
- 2026-04-28 数据:2个问题
- P0:iOS端Loading超时致数据丢失/无音频(15条)
- P1:移动端NPC HUD偶尔变成一小条(8条)
5. 刘新玉要求简化文档格式(~11:46)
- 反馈文档太繁琐,只要在原有格式把"问题 1"改成"P0-问题 1"
- 去掉了优先级分布汇总、额外信息行,只保留标题前缀 + 一行判定依据
- 最终格式:
### P0-问题 1+**优先级判定:** 规则... - 知识库文档已更新为简洁版
6. 修复推断引用算法 Bug
- 策略2的 else 分支(同发送者无引用时往前找不同发送者)缺少时间限制
- 导致胡陈辰 20:45 的媒体消息被推断引用到徐思清 12:29(跨8小时)
- 修复:加了
GAP_THRESHOLD_MIN检查
7. 文档写入方式改进
- 从
insert_before+replace_range改为append模式 - 每次同步在文档末尾追加当日归纳(含优先级),不去动旧内容
- 函数:
update_summary_doc(markdown_content, day_label) - 目标文档:
RaL6whoYMijyYHkSlWrc7OLLnBy(用户反馈问题汇总)
关键文件路径
- 主脚本:
skills/feishu-feedback-sync/scripts/sync_feishu_feedback.py - 分类器:
skills/feishu-feedback-sync/scripts/priority_classifier.py - 技能文档:
skills/feishu-feedback-sync/SKILL.md - 目标知识库文档 token:
RaL6whoYMijyYHkSlWrc7OLLnBy
已知限制
- 文档更新用
append模式,多次同步会产生重复内容(可后续加去重逻辑) - 优先级分类器仅处理中文文本
下午更新(13:13)— 文档格式持续迭代
刘新玉今日格式调整汇总(feishu-feedback-sync 步骤4+5输出)
-
问题描述改为自动规则提取(不再用
[AI归纳中]占位)- 函数:
generate_problem_description() - 格式:
在{端}端{环节}({课程}),{具体表现} - Loading + 数据丢失关联描述:
Loading 耗时约10秒(正常3秒),导致组件数据丢失、无音频 - 频率标签前缀:
【偶现】/【频繁】,通过关键词匹配
- 函数:
-
排查结论简化为状态(按4.3规则)
- 规则4:解释性分析 + 日志上传 + 排查中 →
疑似{原因}导致,已上传日志,排查中 - 规则5:日志已上传 →
已上传日志,排查中 - 默认:
暂无结论排查中
- 规则4:解释性分析 + 日志上传 + 排查中 →
-
文档结构新增"今日问题归纳"顶层索引
- 按
**【P0问题】**/**【P1问题】**分组,每个问题一行索引 - 后接
## 今日问题拆解含详细内容
- 按
-
今日问题拆解标题格式
### 【P0】/### 【P1】(不含编号和问题名)- 内容行:
**1,问题描述:** {描述}
-
Bug修复:多天overwrite互覆盖
- 多天循环时第一天用
overwrite,后续天用append update_summary_doc()新增mode参数
- 多天循环时第一天用
关键文件
- 主脚本:
skills/feishu-feedback-sync/scripts/sync_feishu_feedback.py - 新函数:
generate_problem_description() - 修改函数:
summarize_cluster()、extract_conclusion()、generate_summary()、update_summary_doc()