M4-07 Hermes Agent Module #41

New Issue

wangdl · 2026-05-22T21:09:51+08:00

wangdl commented

2026-05-22 21:09:51 +08:00

目标

在已有 Hermes Agent 能力之上深化，补全 AgentTask 管理、Issue 草稿生成、里程碑整理、对话总结、人工审批和写入 Gitea 的完整工作流。

本 Issue 只做深化设计。当前 Hermes 已能通过 API 操作 Gitea，本模块是将这些能力系统化、审计化、可追溯化的深化。

模块深化内容

AgentTask 管理：
- 任务创建、执行、完成状态机
- 任务运行日志（AgentTaskRun）
- 失败重试机制
Agent 产出物管理：
- Issue 草稿生成和暂存
- 里程碑简介生成
- 对话总结提取
- 发布说明草稿
- 决策记录提取
人工审批流程：
- Agent 产出物提交审批
- Admin 审核（通过/驳回/修改）
- 审批通过后自动写入 Gitea
审计和日志：
- Agent 所有操作记录 AuditLog
- 失败任务重试审计

候选数据对象

AgentTask
AgentTaskRun
AgentArtifact
AgentApproval
DecisionDraft
IssueDraft

禁止事项

禁止 Agent 绕过人工审批直接写入 Gitea
禁止 Agent 操作不经审计
禁止从零重做 Hermes（在已有能力上深化）

验收标准

AgentTask 状态机设计
Agent 产出物管理方案
人工审批流程设计
Agent 操作审计方案

## 目标在已有 Hermes Agent 能力之上深化，补全 AgentTask 管理、Issue 草稿生成、里程碑整理、对话总结、人工审批和写入 Gitea 的完整工作流。本 Issue 只做深化设计。当前 Hermes 已能通过 API 操作 Gitea，本模块是将这些能力系统化、审计化、可追溯化的深化。 ## 模块深化内容 1. AgentTask 管理： - 任务创建、执行、完成状态机 - 任务运行日志（AgentTaskRun） - 失败重试机制 2. Agent 产出物管理： - Issue 草稿生成和暂存 - 里程碑简介生成 - 对话总结提取 - 发布说明草稿 - 决策记录提取 3. 人工审批流程： - Agent 产出物提交审批 - Admin 审核（通过/驳回/修改） - 审批通过后自动写入 Gitea 4. 审计和日志： - Agent 所有操作记录 AuditLog - 失败任务重试审计 ## 候选数据对象 - AgentTask - AgentTaskRun - AgentArtifact - AgentApproval - DecisionDraft - IssueDraft ## 禁止事项 - 禁止 Agent 绕过人工审批直接写入 Gitea - 禁止 Agent 操作不经审计 - 禁止从零重做 Hermes（在已有能力上深化） ## 验收标准 1. AgentTask 状态机设计 2. Agent 产出物管理方案 3. 人工审批流程设计 4. Agent 操作审计方案

wangdl added this to the M4：Admin 生产级运维深化（P3） milestone 2026-05-22 21:09:51 +08:00

wangdl self-assigned this 2026-05-22 21:09:51 +08:00

wangdl commented

2026-05-24 18:11:15 +08:00

✅ M4-07 实施完成

已有基础

HermesSettings iframe 页面，admin-ai-chat 模块已有 Hermes API 集成，admin-conversation 已有对话管理。

本 Issue 新增

模块	说明
AgentTask Prisma 模型	任务记录（type/status/input/output/approvedBy/giteaUrl）
AgentArtifact Prisma 模型	产出物（Issue 草稿/里程碑总结/发布说明/决策记录）
HermesAgentController	任务列表、审批通过/驳回、产出物列表
HermesSettings 页面	3 个 Tab：Agent 任务（含审批按钮）、产出物、Hermes 面板

AAPI 端点

端点	方法	说明
/admin-api/hermes/tasks	GET	Agent 任务列表
/admin-api/hermes/tasks/:id/approve	POST	审批通过
/admin-api/hermes/tasks/:id/reject	POST	驳回任务
/admin-api/hermes/artifacts	GET	产出物列表

审批流程

Agent 生成任务 → status=pending → Admin 审批（通过/驳回）→ 通过后可由 Hermes 写入 Gitea

## ✅ M4-07 实施完成 ### 已有基础 HermesSettings iframe 页面，admin-ai-chat 模块已有 Hermes API 集成，admin-conversation 已有对话管理。 ### 本 Issue 新增 | 模块 | 说明 | |------|------| | AgentTask Prisma 模型 | 任务记录（type/status/input/output/approvedBy/giteaUrl） | | AgentArtifact Prisma 模型 | 产出物（Issue 草稿/里程碑总结/发布说明/决策记录） | | HermesAgentController | 任务列表、审批通过/驳回、产出物列表 | | HermesSettings 页面 | 3 个 Tab：Agent 任务（含审批按钮）、产出物、Hermes 面板 | ### AAPI 端点 | 端点 | 方法 | 说明 | |------|------|------| | /admin-api/hermes/tasks | GET | Agent 任务列表 | | /admin-api/hermes/tasks/:id/approve | POST | 审批通过 | | /admin-api/hermes/tasks/:id/reject | POST | 驳回任务 | | /admin-api/hermes/artifacts | GET | 产出物列表 | ### 审批流程 Agent 生成任务 → status=pending → Admin 审批（通过/驳回）→ 通过后可由 Hermes 写入 Gitea

wangdl closed this issue

2026-06-05 20:17:12 +08:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: wangdl/api-server#41