docs(runtime): internal/runtime/loop 44 个文件注释改中文（逐行 1:1，代码零字节改动）

主人 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 改动前即未格式化，按铁律保留原样未动。

internal/runtime/loop/spanlog.go

@@ -8,26 +8,26 @@ import (
 	"git.yeij.top/AskaEth/Cyrene_v2/internal/runtime/trace"
 )
 
-// Log event types recorded on a span so the flow graph's node log[] shows what
-// happened at each step (design/19 §1 节点实时日志). An event is appended only when
-// the step really finished, so the log never announces work that did not run.
+// 记录在 span 上的日志事件类型，使 flow 图的节点 log[] 展示
+// 每一步发生了什么（design/19 §1 节点实时日志）。仅当该步真正
+// 完成时才追加事件，因此日志绝不宣告未运行的工作。
 const (
-	// EventLLMDone is recorded on an llm_call span once the model call returned.
+	// EventLLMDone 在模型调用返回后记录到 llm_call span 上。
 	EventLLMDone = "llm.done"
-	// EventToolDone is recorded on a tool_call span once the tool call settled.
+	// EventToolDone 在工具调用落定后记录到 tool_call span 上。
 	EventToolDone = "tool.done"
 )
 
-// maxLogSummaryRunes bounds a log value before publication. The graph redacts and
-// truncates again on the way out; this only keeps an individual span small.
+// maxLogSummaryRunes 在发布前限制日志取值的长度。图在
+// 输出时还会再次脱敏与截断；这里只是让单个 span 保持小。
 const maxLogSummaryRunes = 240
 
-// recordLLMDone appends a desensitized summary of a finished model call to its
-// span: the model that served the turn, both stop reasons, how many tool calls were
-// requested and how long the call took. No prompt or completion text is recorded,
-// so an llm node's log can never carry conversation content. ag is the turn's agent
-// (the per-role pool entry), so a multi-role process reports the model that actually
-// served the call rather than the default role's.
+// recordLLMDone 把一次已完成模型调用的脱敏摘要追加到其
+// span：服务该 turn 的模型、两个 stop reason、请求了多少工具调用
+// 以及该调用耗时。不记录任何提示词或补全文本，
+// 因此 llm 节点的日志绝不携带对话内容。ag 是该 turn 的 agent
+// （按角色池条目），因此多角色进程上报的是实际
+// 服务该调用的模型，而不是默认角色的模型。
 func (l *Loop) recordLLMDone(span *trace.Span, out *stepOutcome, ag *agent.Agent) {
 	if span == nil || out == nil {
 		return
@@ -46,12 +46,12 @@ func (l *Loop) recordLLMDone(span *trace.Span, out *stepOutcome, ag *agent.Agent
 	_ = span.Record(trace.Event{Type: EventLLMDone, Props: props})
 }
 
-// recordToolDone appends a desensitized summary of one tool call to its span: the
-// tool name, whether it succeeded, the argument NAMES (never their values), the
-// error kind on failure, and a truncated result summary. Argument values are
-// deliberately omitted — a tool argument is exactly where a credential, a message
-// body or a file path with a secret would appear — and everything recorded here is
-// scrubbed again by the graph before publication.
+// recordToolDone 把一次工具调用的脱敏摘要追加到其 span：工具
+// 名、是否成功、参数名（绝不记录其值）、失败时的
+// 错误种类，以及截断后的结果摘要。参数值被
+// 刻意省略 —— 工具参数正是凭据、消息正文
+// 或含机密的文件路径会出现的地方 —— 且这里记录的一切
+// 在发布前都会由图再次清洗。
 func (l *Loop) recordToolDone(span *trace.Span, tc agent.ToolCall, out ToolOutcome) {
 	if span == nil {
 		return
@@ -73,9 +73,9 @@ func (l *Loop) recordToolDone(span *trace.Span, tc agent.ToolCall, out ToolOutco
 	_ = span.Record(trace.Event{Type: EventToolDone, Props: props})
 }
 
-// modelName reports the model that served a step: the routed request model when
-// the streaming path knows it, else the turn's agent's configured model. It is
-// empty when neither is available.
+// modelName 报告服务某步的模型：流式路径知道时用路由出的
+// 请求模型，否则用该 turn 的 agent 配置的模型。两者
+// 都不可用时为空。
 func modelName(out *stepOutcome, ag *agent.Agent) string {
 	if out.model != "" {
 		return out.model
@@ -86,8 +86,8 @@ func modelName(out *stepOutcome, ag *agent.Agent) string {
 	return ag.Model()
 }
 
-// elapsedMS reports how long a span has been open so far. A span's Duration is
-// only stamped by Finish, so a log event recorded before Finish measures it here.
+// elapsedMS 报告 span 迄今已打开多久。span 的 Duration 仅由
+// Finish 打上，因此在 Finish 之前记录的日志事件在此测量它。
 func elapsedMS(span *trace.Span) int64 {
 	if span == nil || span.StartedAt.IsZero() {
 		return 0
@@ -95,8 +95,8 @@ func elapsedMS(span *trace.Span) int64 {
 	return time.Since(span.StartedAt).Milliseconds()
 }
 
-// argKeys returns a tool call's argument names in sorted order. Only the names are
-// logged; the values stay out of the trace (see recordToolDone).
+// argKeys 按排序返回工具调用的参数名。只记录
+// 参数名；值留在 trace 之外（见 recordToolDone）。
 func argKeys(args map[string]any) []string {
 	if len(args) == 0 {
 		return nil
@@ -109,8 +109,8 @@ func argKeys(args map[string]any) []string {
 	return keys
 }
 
-// trimSummary shortens a log value to maxLogSummaryRunes runes without splitting a
-// multi-byte rune.
+// trimSummary 把日志取值缩短到 maxLogSummaryRunes 个 rune，
+// 且不切开多字节 rune。
 func trimSummary(s string) string {
 	r := []rune(s)
 	if len(r) <= maxLogSummaryRunes {