higress-group 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 |
每日报告存档 |
工作流程
1. 获取每日数据
# 获取昨日 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
2. 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 reviewin_progress- 修复进行中resolved- 已解决（待关闭）closed- 已关闭wontfix- 不予修复stale- 超过 7 天无活动
3. 知识库结构
知识库 (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 无机会处理
**解决方案**：
1. **推荐**：修改 CORS 插件 stage 从 AUTHZ 改为 AUTHN
2. **Workaround**：创建 OPTIONS 专用路由，不启用认证
3. **Workaround**：使用实例级 CORS 配置
**关联 Issue**：#3398
**学到的经验**：
- 排查跨域问题时，首先确认插件执行顺序
- Higress 阶段优先级由 phase 决定，不是 priority 数值
4. 日报生成规则
报告结构：
# 📊 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，需决定是否关闭）
## 📚 本周知识沉淀
（新增的知识库条目摘要）
5. 智能分析能力
生成日报时，对每个新 issue 进行初步分析：
- 问题分类 - 根据标题和内容判断类别
- 知识库匹配 - 检索相似问题的解决方案
- 优先级评估 - 根据影响范围和紧急程度
- 建议回复 - 基于知识库生成初步回复建议
6. 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
**根因分析**：
（技术原因说明）
**解决方案**：
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 字符，超过则分多条发送