From 242801aab7fd435659527efffa0e88c7c4270fa1 Mon Sep 17 00:00:00 2001 From: cfdaily Date: Sun, 7 Jun 2026 11:46:26 +0800 Subject: [PATCH] auto-sync: 2026-06-07 11:46:26 --- docs/design/13-toolchain-and-dev-workflow.md | 52 +++++++++++++------- 1 file changed, 33 insertions(+), 19 deletions(-) diff --git a/docs/design/13-toolchain-and-dev-workflow.md b/docs/design/13-toolchain-and-dev-workflow.md index e6493d6..f3f5b59 100644 --- a/docs/design/13-toolchain-and-dev-workflow.md +++ b/docs/design/13-toolchain-and-dev-workflow.md @@ -1460,20 +1460,20 @@ Skill 只放共通的、所有项目都能用的技能： 工具链特有的流程（"CI 失败后怎么做"、"Review 通过后怎么做"）全部固化在 Mail 模板里。 -### §15.7 Agent ID ↔ Git 用户名映射 +### §15.7 Agent ID = Git 用户名（已确认一致） -CI workflow 和 Webhook 中的用户标识是 Git 用户名，Mail API 需要 Agent ID： +姜维确认（2026-06-07）：Gitea 注册用户名就是完整 Agent ID，短名用户已删除。 -| Git 用户名 | Agent ID | -|-----------|----------| -| zhangfei | zhangfei-dev | -| jiangwei | jiangwei-infra | -| simayi | simayi-challenger | -| pangtong-fujunshi | pangtong-fujunshi | -| guanyu-dev | guanyu-dev | -| zhaoyun-data | zhaoyun-data | +| Agent ID（= Git 用户名） | +|-------------------------| +| pangtong-fujunshi | +| simayi-challenger | +| zhangfei-dev | +| guanyu-dev | +| zhaoyun-data | +| jiangwei-infra | -daemon Webhook 模块中维护此映射表。 +不需要映射表，`to_agent_id()` 直用。 --- @@ -1567,7 +1567,7 @@ daemon 内部 ───────┘ │ 5. 创建 Mail │ |------|---------|---------| | Gitea Webhook | Gitea 主动 POST | PR opened, Review submitted, Issue assigned, issue_comment | | CI workflow | CI 写 PR comment → 触发 issue_comment Webhook | CI 失败 | -| Deploy workflow | Deploy 写 PR comment → 触发 issue_comment Webhook | 部署成功/失败 | +| Deploy workflow | Deploy 创建 Issue → 触发 issues Webhook | 部署失败 | | daemon 内部 | 内部函数调用 | 预留，当前不走中枢 | ### 2.2 事件处理矩阵 @@ -1746,6 +1746,21 @@ async def handle_gitea_webhook( 每个事件类型一个处理函数，职责：解析 payload → 选模板 → 填充 → 创建 Mail Task。 ```python +async def handle_issues(engine: TemplateEngine, event: dict) -> str: + """issues 事件分发：assigned → 通知被指派人；opened + 标题匹配 → 部署失败通知""" + action = event.get("action") + + if action == "assigned": + return await _handle_issue_assigned(engine, event) + + if action == "opened": + title = event.get("issue", {}).get("title", "") + if "部署失败" in title: + return await _handle_deploy_failure(engine, event) + + return None # 忽略其他 action + + async def handle_pull_request(engine: TemplateEngine, event: dict) -> str: """pull_request 事件分发：只处理 opened，忽略 synchronized/closed/reopened""" if event.get("action") != "opened": @@ -1831,12 +1846,11 @@ async def handle_issue_comment(engine: TemplateEngine, event: dict) -> str: # HANDLERS 注册表 -# pull_request 和 issues 只处理特定 action，在函数内部过滤 HANDLERS = { - "pull_request": handle_pull_request, # 内部只处理 opened，忽略其他 action + "pull_request": handle_pull_request, # 只处理 opened "pull_request_review": handle_review_submitted, - "issues": handle_issues, # 内部只处理 assigned，忽略其他 action - "issue_comment": handle_issue_comment, + "issues": handle_issues, # 处理 assigned + opened(部署失败) + "issue_comment": handle_issue_comment, # 只处理 CI 失败评论 } ``` @@ -1993,7 +2007,7 @@ CI workflow 已有 `notify-on-failure` job（ci.yml），当前格式： |------|------|------| | 1 | `toolchain_routes.py` 骨架 + Gitea Webhook 接收 + 签名验证 | 无 | | 2 | `toolchain_templates.py` 模板引擎 | 无 | -| 3 | 6 个模板文件 | 步骤 2 | +| 3 | 5 个模板文件 | 步骤 2 | | 4 | 4 个事件处理器（PR/Review/Issue/Comment） | 步骤 1+3 | | 5 | 幂等检查（SQLite events 表，保留 7 天） | 步骤 1 | | 6 | `create_mail_task` 共用函数（从 mail_routes.py 提取） | 无 | @@ -2007,11 +2021,11 @@ CI workflow 已有 `notify-on-failure` job（ci.yml），当前格式： |------|------|------| | `src/api/toolchain_routes.py` | ~200 | 新增 | | `src/daemon/toolchain_templates.py` | ~60 | 新增 | -| `templates/toolchain/*.md` | ~200（6个文件） | 新增 | +| `templates/toolchain/*.md` | ~170（5个文件） | 新增 | | `src/api/mail_routes.py` | ~20 | 修改（提取共用函数） | | `.gitea/workflows/ci.yml` | ~15 | 修改（加 comment step） | | `.gitea/workflows/deploy.yml` | ~15 | 修改（加 comment step） | -| **总计** | **~510** | | +| **总计** | **~480** | | ---