【架构优化】从 Engine.applyObservation 中拆出节点活动文案推导 observationActivity

未关闭
#453 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

@fx-kurumi 已经在做这个了。

开始于 2026年11月13日。

  • #456 来自 @fx-kurumi —— 未关闭

评估

难度
2/5
预计耗时
1-3 小时
新手友好度
15/100
Issue 类型
重构
描述清晰度
描述清楚
活跃度
停滞
技术栈
go
领域
backend

调研方向

The activity-text switch sits inside Engine.applyObservation in internal/engine/engine_observe.go; start by reading that switch and the branches the issue lists. Move it unchanged into a package-level observationActivity function and add a table-driven test file in the same package. Done means gofmt, go vet ./internal/engine/ and go test ./internal/engine/ pass. Note that PR #456 is already open against this issue, so the work is claimed.

由索引模型根据 Issue 内容生成。

描述

现状问题

internal/engine/engine_observe.go 中 Engine.applyObservation 约 120 行,同时负责:幂等去重、字段补全、日志记录、节点属性回填、节点活动文案推导、工具调用计数、用量累计、遥测合并与截断。

其中根据 observation.Category/Name/Phase/Level 推导节点 Activity 文案的 switch 有 6 个分支、约 35 行,内含多层嵌套(tool/sandbox 分支在某些条件下不更新文案,process 分支要拼接 provider/model 标签),是一段纯计算逻辑却嵌在有副作用的大函数里,目前也没有直接的单元测试。

重构方案

  • 把该 switch 原样抽成包级纯函数 observationActivity(observation domain.TelemetryEvent) (string, bool),返回新的活动文案以及是否需要更新(对应原来 tool 非匹配、sandbox.closed 不更新文案的情形)。
  • applyObservation 中改为:if activity, ok := observationActivity(observation); ok { nr.Activity = activity }。
  • 分支逻辑、文案逐字不变,不改其它代码。

影响范围

仅 internal/engine/engine_observe.go 一个函数内部,加一个新测试文件;无对外接口、无行为变化。

验证方式

  • 新增表驱动单测覆盖每个分支(reasoning/output/tool 开始、结束、结束报错/sandbox 普通与 closed/process.started 含与不含 provider、model/其它 process/default 有无 message)。
  • gofmt、go vet ./internal/engine/、go test ./internal/engine/ 通过。
主要语言
Go
星标
141
派生
28
平均合并
1 天 15 小时
30 天内合并 PR
113

环境准备

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

Tencent/LoopForge 的其他 Issue

查看 Tencent/LoopForge 的全部 Issue

相似的 Issue

更多 Go Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。