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。 +- [ ] 测试系统日志读取接口。 验收证据: