ambiguous-pointer commented on PR #1618:
URL: https://github.com/apache/dubbo-admin/pull/1618#issuecomment-6568115098

   ## 评审意见的处理结果
   
   感谢 @copilot-pull-request-reviewer 的评审。12 条意见我逐条复核过,**全部成立、无误报**,已按 P0 → P1 → 
P2 处理完毕(修复见 `aba9033`)。另外从评审正文的逐文件说明里又找出 3 处没有单列行内评论的问题,一并处理了。
   
   复核时把每条都落到了代码与上游行为上,下面按优先级列出「结论 → 依据 → 处理」。
   
   ### P0-1 编译失败(#2)+ 死代码(#10)+ 策略绕过(#1)—— 一并处理
   
   这三条指向同一个动作:**把 `ai/component/hooks/reasoning.go` 与 `reasoning_test.go` 整体移回 
#1616**。
   
   - 复核依据:本 PR 的这两个文件是从 #1616 那条线拿过来的,但没有带上 
`TracingSpec.CaptureReasoning`、`Registration.CaptureReasoning`、`Manager.ReasoningPolicy`
 的接线——那部分在 #1616 的 `d695d80` 里。在 #1616 分支上 `go vet ./component/hooks/...` 
是绿的,在本分支上报 `TracingSpec has no field or method CaptureReasoning`。
   - 处理:本 PR 删除这两个文件。#1616 那边才是它们的位置,那边已经把策略真正接进 manager 与 tracing hook。
   - 顺带说明 #1:`rewriteReasoningParts` 原本先用 `strings.Contains(document, 
"reasoning")` 早退,而 JSON 转义后的原文(`"type":"reasoning"`)在字节层面不含 `reasoning` 
这个词,早退命中后整份文档原样返回,`CaptureNone` 形同虚设。**这个绕过修在 #1616**(本 PR 已不含该文件),改成先解码再判定 
type,并补了 
`TestApplyReasoningPolicyRemovesEscapedReasoningParts`——已验证:改回旧代码该用例会失败,报错里 
escaped 的 reasoning part 原样保留。
   
   ### P0-2 `minDuration` 缺单位(#4、#5)—— 真实 Jaeger 上必然 400
   
   - 复核依据:Jaeger v1.38.0 `cmd/query/app/query_parser.go` 里 `minDuration` 走 
`newDurationStringParser()`,即 `time.ParseDuration(s)`;裸数字 `250000` 会得到 `time: 
missing unit in duration` → 400。本 PR 发出的正是 `strconv.FormatInt(Microseconds(), 
10)`,无单位。
   - 处理:改为发 duration 字符串(`query.MinDuration.String()` → `250ms`)。Jaeger v1 与 
v3(`durationMin`)都用 `time.ParseDuration`,字符串形式两边都兼容。
   - 断言同步改为 `"250ms"`,并额外加了 `time.ParseDuration` 往返校验——原来的 httptest stub 
不校验参数,加了这条以后同类问题不会再被 stub 掩盖。
   
   ### P0-3 凭据进入模型上下文(#3)
   
   - 复核依据:`newJaegerProvider` 对 endpoint 只做 `url.Parse`,不带 query 的校验,`baseURL` 
可以带 `?api_key=...`;`GetTraceByID` 复制 URL 时保留了 RawQuery,`*url.Error` 的 message 
内嵌完整 URL,而 `sanitizeTransportError()` 只用在失败日志上(L622/L640),返回值是直接 `%w` 进工具结果的。
   - 处理,两层:
     1. **源头**:`newJaegerProvider` 现在校验 scheme 必须是 http/https、host 非空,并**拒绝带 
query / fragment 的 endpoint**,凭据只允许走 `bearerToken`。拒绝信息里不回显 endpoint(endpoint 
本身才可能是密钥所在)。
     2. **出口**:工具返回路径也过 `sanitizeTransportError`。按原设计意图保留了可诊断性——错误里仍带 
traceId(模型自己选的,需要能向用户复述)和 `dial tcp ...: connection refused` 这类诊断信息,去掉的是请求 
URL(endpoint 路径 + 全部检索条件 + 可能内嵌的凭据)。对应地更新了原设计文档 §10 与那条 TODO。
     3. **评审未覆盖的补充**:原 `SearchTraces` 里 `endpoint.RawQuery = values.Encode()` 
会**覆盖** endpoint 自带的 query——也就是同一份配置,search 路径把凭据**丢了**(401),by-id 
路径把凭据**泄漏了**。源头拒绝之后这两条路径行为一致了。
   
   ### P1 正确性
   
   | 意见 | 处理 |
   |---|---|
   | #6 裁剪后总时长用错 | `analysisEnvelope` 优先用 provider 的 
`trace.DurationMicros`(它在**全部**原始 span 上算),只在没有 provider 值时回退到保留 span 
的包络。否则被裁剪的链路会用更短的总时长做分母,把各服务延迟占比整体虚高。补了 
`TestBuildTraceAnalysisUsesProviderEnvelopeForClippedSpans` |
   | #8 token 被科学计数法吞掉 | `genAIIntAttribute` 改走 `parseIntegralAttribute`,先 
`Atoi`,失败再按 float 解析并要求是整数值。已实测 `1000000 → "1e+06" → Atoi 失败 → 0`,阈值恰为 
≥1e6(999999 正常) |
   | #9 触达后端 limit 时 `truncated` 误报 false | Provider 侧按调用方条数**再多取一条**做探测,命中即 
`truncated=true` 并裁回调用方条数。这样「刚好装满」不再被误读为「已看全」,同时避免了「达到上限就报截断」带来的假阳性。补了 
`TestJaegerProviderSearchTracesReportsTruncationAtTheBackendLimit` |
   | #7 slowSpans 排名截断误置 `truncated` | 排名结果不丢分析数据,因此不再置位。与同文件 critical path 
的既有规则一致(`TestBuildCriticalPathStopsAtBudgetWithoutTruncation`:链条正好在预算处结束不算截断)。补了
 `TestBuildTraceAnalysisDoesNotReportTruncationForTheSlowSpanRanking` |
   
   ### P2 一致性
   
   - #11 文档限额:`DEVELOPMENT.md` 与设计文档 §5.2 的限额表改成与常量一致(摘要 100 / 错误 span 20 / 
GenAI 20),并补上搜索侧 `truncated` 的新语义。
   - #12 文档注释名:`requestContext` → `traceRequestContext`;顺带把 `tools.go` 里重复的 
context 回退换成调用同一个 helper——原来那处还少了 `ctx == nil` 判断。
   
   ### 额外发现(评审未提)
   
   1. **CI 从不在 `ai` 分支上跑**。`.github/workflows/ci.yml` 与 `riscv-build.yml` 
的触发分支只有 `develop`,PR 目标分支是 `ai`,所以这两个 workflow 都不会触发——这也是编译失败能进到 PR 的直接原因。`make 
test` 本身已经覆盖 `ai` 模块(`cd ai && go test ./... -short`),只是没机会执行。本 PR 已把 `ai` 加入 
ci.yml 的触发分支。
   2. **PR 描述里的验证口径漏了 `ai` 模块**。`ai/` 是独立 go.mod,`go build ./... && go vet 
./pkg/... && go test ./pkg/...` 只覆盖根模块,所以「全绿」是假象。本 PR 补充验证为两个模块分别 `go build` / 
`go vet` / `go test -short`。
   
   ### 评审正文里另外提到、但没有单列行内评论的三处
   
   评审正文的「What changed in this PR」逐文件说明里还提到了三处,本 PR 一并处理:
   
   - **`jaeger_logging_test.go` 的 import 遮蔽 nit**:`errors := 
traceLogErrorFields(t, lines)` 遮蔽了 `errors` 包。已改名为 `recordedErrors`。
   - **设计文档的实现状态过期**:§14.2 的 T7 
仍写着「工具返回按设计保留上游错误原文」,与本次对传输错误的净化不符。已更新为「传输错误已净化(请求 URL 不进入工具返回),仍未净化的是上游响应体与 
span 内容」。
   - **设计文档对关键路径的保证说过头**:§5.3.3 原写「恰好满足……链尾的 `end` 等于 trace 的墙钟终点。链路上的 
`selfMicros` 之和是这条 trace 的不可压缩耗时」。两处都收紧了:span 列表被 `maxTraceSpans` 裁剪时关键路径只在保留的 
span 上计算,链尾可能早于 provider 的墙钟终点;`selfMicros` 之和是**这条关键路径上**的不可压缩耗时,并行分支的 self 
time 不计入,是工作量的下界而非上界。§14.3 的 `maxTraceSpans` 风险行同步更新(裁剪不再让占比虚高,但关键路径仍只在保留的 span 
上计算)。
   
   评审正文还提到 `genai.go` 的「token 重复计数」与 `analyzer.go` 的「环 / 服务计时 / 
错误分类」,这两处复核后确认**实现本身是对的**,无需改动:
   
   - token 重复计数:`gen_ai.usage.total_tokens` 是非标准属性,设计上只作为单次调用的参考值出现在明细里,聚合的 
total 恒等于 input + output,避免出现两种 total 定义;已有用例 
`TestBuildGenAISummaryKeepsProviderTokenTotalAsCallDetailOnly` 覆盖。
   - 环:`computeSelfTimes` 是迭代实现,`hasFailedDescendant` 用显式栈 + 
visited,`buildCriticalPath` 用 visited 集合,三处都不会在父子引用成环时挂死;已有用例 
`TestBuildTraceAnalysisSurvivesCyclicReferences` 覆盖。
   - 服务计时 / 错误分类:与 §5.3.2、§5.4 的设计一致,`error.type` 优先级与根因规则(无失败后代)均按文档实现。
   
   ### 验证
   
   两个模块均通过:
   
   ```
   go build ./... && go vet ./... && go test ./... -short -gcflags=-l   # 根模块
   cd ai && go build ./... && go vet ./... && go test ./... -short -gcflags=-l
   ```
   
   本 PR 新增 6 个回归用例(endpoint 校验 2、`minDuration` wire format、后端 limit 截断、provider 
包络、slow span 排名、科学计数法 token),#1616 另加 1 个(JSON 转义绕过),每个都在对应修复前会失败。
   
   ### 未处理
   
   - `ai` 模块有 24 个文件未通过 gofmt(属于 #1616 那条线)。把 `cd ai && go fmt ./...` 加进 `make 
fmt` 会让 CI 因这些既有文件变红,所以本 PR 没动,留给 #1616 收敛。
   - 设计文档 §14.2 记录的「工具结果中 span 内容未过滤」仍然开放,本次只处理了请求 URL 这一段。
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to