AskaEth
91e8d7a029
主人 2026-10-03 拍板「注释一律中文」；本模块按长期分批协议（一个模块一次派工）执行。 注释行数 1329 → 1329 逐行 1:1（含中文 33 → 1304）；行尾注释 5 条一并译。 校验：机械校验（非注释改动行）= 空；独立 Go AST 程序（剥注释复渲）证明 44/44 文件代码全等； 全树 go test ./... 58 包 ok / 0 FAIL；交叉编译绿。 gofmt：capacity_loop_test.go / flow.go 改动前即未格式化，按铁律保留原样未动。
52 lines
1.6 KiB
Go
52 lines
1.6 KiB
Go
package loop
|
|
|
|
import (
|
|
"context"
|
|
|
|
"git.yeij.top/AskaEth/Cyrene_v2/internal/runtime/trace"
|
|
)
|
|
|
|
// span 在配置了 Tracer 时启动一个给定 kind 的具名 span，否则
|
|
// 返回 nil 空操作 span。返回的 context 把该 span 作为当前 span 携带，
|
|
// 使嵌套 span 作为子节点串链。配置了 FlowPublisher 时，
|
|
// span 的 flow owner（子代理 Run 取分支父级，否则取 Run 自身的
|
|
// session，两者都经 ctx 传递）会被打为 prop，并立即发布一个
|
|
// 运行中的占位节点，使 flow 图能显示在途工作。
|
|
func (l *Loop) span(ctx context.Context, name string, kind trace.SpanKind) (context.Context, *trace.Span) {
|
|
if l.tracer == nil {
|
|
return ctx, nil
|
|
}
|
|
sctx, sp := l.tracer.StartSpan(ctx, name, kind)
|
|
if sid := flowOwner(ctx, loopSession(ctx)); sid != "" {
|
|
_ = sp.SetProp("session", sid)
|
|
if l.flow != nil {
|
|
l.flow.SpanStarted(sid, sp)
|
|
}
|
|
}
|
|
return sctx, sp
|
|
}
|
|
|
|
// finishSpan 以给定状态关闭 span，忽略 nil span。span 关闭
|
|
// （不可变）后，完成记录被并入 flow 图并
|
|
// 发布，把该节点翻转为最终状态。
|
|
func (l *Loop) finishSpan(sp *trace.Span, status trace.SpanStatus) {
|
|
if sp == nil {
|
|
return
|
|
}
|
|
sp.Finish(status)
|
|
if l.flow != nil {
|
|
if sid, ok := sp.Props["session"].(string); ok && sid != "" {
|
|
l.flow.SpanFinished(sid, sp)
|
|
}
|
|
}
|
|
}
|
|
|
|
// spanProp 给 span 附加一个结构化属性，忽略 nil span 以及
|
|
// 关闭后变更所返回的错误。
|
|
func (l *Loop) spanProp(sp *trace.Span, key string, value any) {
|
|
if sp == nil {
|
|
return
|
|
}
|
|
_ = sp.SetProp(key, value)
|
|
}
|