From 7a3feb14a0b750c1352f17f38f7deecb3a0dd550 Mon Sep 17 00:00:00 2001 From: caoxiaozhu Date: Fri, 15 May 2026 09:33:18 +0000 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0Hermes=20MVP=E5=BC=80?= =?UTF-8?q?=E5=8F=91=E8=AE=A1=E5=88=92=E6=96=87=E6=A1=A3=EF=BC=8C=E4=BC=98?= =?UTF-8?q?=E5=8C=96=E7=AC=AC=E5=85=AD=E5=A4=A9=E6=99=BA=E8=83=BD=E4=BD=93?= =?UTF-8?q?=E5=BC=80=E5=8F=91=E4=BB=BB=E5=8A=A1=E6=8F=8F=E8=BF=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../agent/agent week plan/day_6_hermes_mvp.md | 31 ++++++++++++++++++- 1 file changed, 30 insertions(+), 1 deletion(-) diff --git a/document/development/agent/agent week plan/day_6_hermes_mvp.md b/document/development/agent/agent week plan/day_6_hermes_mvp.md index 92eabda..522cf5c 100644 --- a/document/development/agent/agent week plan/day_6_hermes_mvp.md +++ b/document/development/agent/agent week plan/day_6_hermes_mvp.md @@ -115,13 +115,35 @@ Hermes 不允许自由生成任意结构的规则。 以下内容为合并后的详细执行清单。 +## 本轮追加范围（2026-05-15） + +本轮不扩散到新的业务能力，先把已经落地的 LLM Wiki 归纳链路收紧成可运维、可追踪、可持续运行的形态。 + +本轮目标： + +- 把知识管理中的 Hermes 归纳从同步请求改成后台异步任务。 +- 用户关闭或切走页面后，归纳任务仍继续执行，不因前端页面生命周期被误判失败。 +- 归纳过程中的状态、进度、摘要、异常统一写入 `AgentRun.route_json` 与 `result_summary`。 +- 知识管理页轮询真实任务状态，任务完成后立刻把文档状态从“正归纳”切到最终状态。 +- 右侧侧边栏新增“日志管理”入口。 +- 日志管理页拆成两类日志： + - Hermes 调用日志：查看归纳任务运行状态、当前阶段、文档进度、ToolCall、错误信息。 + - 系统运行日志：直接查看 `server/logs` 下的系统日志文本。 + +本轮边界： + +- 仍然使用系统 Hermes CLI 入口，不虚构不存在的 gateway 推理接口。 +- 不引入完整消息队列或 Celery 集群，先用后端受控后台任务管理器落地。 +- 不把日志页做成审计替代品，重点只覆盖 Hermes 运行日志和系统运行日志。 +- 不把普通用户开放为日志管理员，日志查看仍属于管理员能力。 + ## 0. 开始前检查 - [x] ~~确认任务资产 `asset_type=task` 可查询。~~ - [x] ~~确认 Orchestrator 能处理 `source=schedule`。~~ - [x] ~~确认系统 Hermes CLI 或等价后台 Hermes 进程可被调用。~~ - [x] ~~确认 AgentRun 和 ToolCall 可记录。~~ -- [ ] 确认是否已有后台任务框架。 +- [x] ~~确认是否已有后台任务框架。~~ - [ ] 如果没有后台任务框架，先用手动触发 API 模拟定时执行。 ## 1. Hermes 输入输出 @@ -270,6 +292,10 @@ Hermes 不允许自由生成任意结构的规则。 - [ ] 任务详情能看到规则草稿数量。 - [ ] 运行 Trace 能看到 Hermes 步骤。 - [x] ~~错误时展示错误原因。~~ +- [ ] 日志管理页能查看 Hermes 归纳任务的实时状态。 +- [ ] 日志管理页能查看 Hermes ToolCall 请求与结果。 +- [ ] 日志管理页能查看系统运行日志文本。 +- [ ] 知识管理页能在后台任务完成后自动刷新归纳状态。 验收证据： @@ -285,6 +311,9 @@ Hermes 不允许自由生成任意结构的规则。 - [x] ~~测试知识候选写入。~~ - [x] ~~测试规则草稿生成。~~ - [ ] 测试 Hermes 异常写入 AgentRun。 +- [ ] 测试知识归纳异步任务在接口返回后仍能继续执行。 +- [ ] 测试归纳进度能持续写入 AgentRun。 +- [ ] 测试系统日志读取接口。 验收证据：