Higress Daily Report
驱动 Higress 社区问题处理的智能工作流。
核心目标
-
每日感知 - 追踪新 issues/PRs 和评论动态
-
进度跟踪 - 确保每个 issue 被持续跟进直到关闭
-
知识沉淀 - 积累问题分析和解决方案，提升处理能力
-
闭环驱动 - 通过日报推动问题解决，避免遗忘
数据文件
文件 用途
/root/clawd/memory/higress-issue-tracking.json
Issue 追踪状态（评论数、跟进状态）
/root/clawd/memory/higress-knowledge-base.md
知识库：问题模式、解决方案、经验教训
/root/clawd/reports/report_YYYY-MM-DD.md
每日报告存档
工作流程
- 获取每日数据
获取昨日 issues
gh search issues --repo alibaba/higress --created yesterday --json number,title,author,url,body,state,labels --limit 50
获取昨日 PRs
gh search prs --repo alibaba/higress --created yesterday --json number,title,author,url,body,state,additions,deletions,reviewDecision --limit 50
- Issue 追踪状态管理
追踪数据结构 (higress-issue-tracking.json )：
{ "date": "2026-01-28", "issues": [ { "number": 3398, "title": "Issue 标题", "state": "open", "author": "username", "url": "https://github.com/...", "created_at": "2026-01-27", "comment_count": 11, "last_comment_by": "johnlanni", "last_comment_at": "2026-01-28", "follow_up_status": "waiting_user", "follow_up_note": "等待用户提供请求日志", "priority": "high", "category": "cors", "solution_ref": "KB-001" } ] }
跟进状态枚举：
-
new
-
新 issue，待分析
-
analyzing
-
正在分析中
-
waiting_user
-
等待用户反馈
-
waiting_review
-
等待 PR review
-
in_progress
-
修复进行中
-
resolved
-
已解决（待关闭）
-
closed
-
已关闭
-
wontfix
-
不予修复
-
stale
-
超过 7 天无活动
- 知识库结构
知识库 (higress-knowledge-base.md ) 用于沉淀经验：
Higress 问题知识库
问题模式索引
认证与跨域类
- KB-001: OPTIONS 预检请求被认证拦截
- KB-002: CORS 配置不生效
路由配置类
- KB-010: 路由状态 address 为空
- KB-011: 服务发现失败
部署运维类
- KB-020: Helm 安装问题
- KB-021: 升级兼容性问题
KB-001: OPTIONS 预检请求被认证拦截
问题特征：
- 浏览器 OPTIONS 请求返回 401
- 已配置 CORS 和认证插件
根因分析： Higress 插件执行阶段优先级：AUTHN (310) > AUTHZ (340) > STATS
- key-auth 在 AUTHN 阶段执行
- CORS 在 AUTHZ 阶段执行
- OPTIONS 请求先被 key-auth 拦截，CORS 无机会处理
解决方案：
- 推荐：修改 CORS 插件 stage 从 AUTHZ 改为 AUTHN
- Workaround：创建 OPTIONS 专用路由，不启用认证
- Workaround：使用实例级 CORS 配置
关联 Issue：#3398
学到的经验：
- 排查跨域问题时，首先确认插件执行顺序
- Higress 阶段优先级由 phase 决定，不是 priority 数值
- 日报生成规则
报告结构：
📊 Higress 项目每日报告 - YYYY-MM-DD
📋 概览
- 统计时间: YYYY-MM-DD
- 新增 Issues: X 个
- 新增 PRs: X 个
- 待跟进 Issues: X 个
- 本周关闭: X 个
📌 新增 Issues
（按优先级排序，包含分类标签）
🔀 新增 PRs
（包含代码变更量和 review 状态）
🔔 Issue 动态
（有新评论的 issues，标注最新进展）
⏰ 跟进提醒
🔴 需要立即处理
（等待我方回复超过 24h 的 issues）
🟡 等待用户反馈
（等待用户回复的 issues，标注等待天数）
🟢 进行中
（正在处理的 issues）
⚪ 已过期
（超过 7 天无活动的 issues，需决定是否关闭）
📚 本周知识沉淀
（新增的知识库条目摘要）
- 智能分析能力
生成日报时，对每个新 issue 进行初步分析：
-
问题分类 - 根据标题和内容判断类别
-
知识库匹配 - 检索相似问题的解决方案
-
优先级评估 - 根据影响范围和紧急程度
-
建议回复 - 基于知识库生成初步回复建议
- Issue 跟进触发
当用户在 Discord 中提到以下关键词时触发跟进记录：
完成跟进：
-
"已跟进 #xxx"
-
"已回复 #xxx"
-
"issue #xxx 已处理"
记录解决方案：
-
"issue #xxx 的问题是..."
-
"#xxx 根因是..."
-
"#xxx 解决方案..."
触发后更新追踪状态和知识库。
执行检查清单
每次生成日报时：
-
获取昨日新 issues 和 PRs
-
加载追踪数据，检查评论变化
-
对比 last_comment_by 判断是等待用户还是等待我方
-
超过 7 天无活动的 issue 标记为 stale
-
检索知识库，为新 issue 匹配相似问题
-
生成报告并保存到 /root/clawd/reports/
-
更新追踪数据
-
发送到 Discord channel:1465549185632702591
-
格式：使用列表而非表格（Discord 不支持 Markdown 表格）
知识库维护
新增条目时机
-
Issue 被成功解决后
-
发现新的问题模式
-
踩坑后的经验总结
条目模板
KB-XXX: 问题简述
问题特征：
- 症状1
- 症状2
根因分析： （技术原因说明）
解决方案：
- 推荐方案
- 备选方案
关联 Issue：#xxx
学到的经验：
- 经验1
- 经验2
命令参考
查看 issue 详情和评论
gh issue view <number> --repo alibaba/higress --json number,title,state,comments,author,createdAt,labels,url
查看 issue 评论
gh issue view <number> --repo alibaba/higress --comments
发送 issue 评论
gh issue comment <number> --repo alibaba/higress --body "评论内容"
关闭 issue
gh issue close <number> --repo alibaba/higress --reason completed
添加标签
gh issue edit <number> --repo alibaba/higress --add-label "bug"
Discord 输出
-
频道: channel:1465549185632702591
-
格式: 纯文本 + emoji + 链接（用 <url> 抑制预览）
-
长度: 单条消息不超过 2000 字符，超过则分多条发送