From 02858f486b54316c58d4f8ebcabfac4a02448ee1 Mon Sep 17 00:00:00 2001 From: weichen Date: Sun, 11 Oct 2026 16:45:49 +0000 Subject: [PATCH] Add deterministic material-intake background path for attachment sends Why: the dual-speed entry hint is advisory only; real runs (MiniMax, 3 attachments, no text) end with a clarifying question and zero delegation, so background cards and result backfill never start. Evidence: new unit tests in runmgr/material_test.go and runtime/material_flow_test.go all pass; full go test ./... exit 0 (local, SELF). Impact: attachment-carrying runs now guarantee a material-organization background task (pre-spawn on attachment-only/heavy sends, stop-hook backstop otherwise when the model did not delegate); subagent receives inline parsed text with budget plus knowledge_search guidance; content-key dedup prevents duplicate spawns (in-flight, completed, resend); model-authored delegate_task gains a materials appendix; settings runtime.materialIntake (default on) and runtime.materialIntakeChars added. Refs: Dev task .task/feature-material-intake-flow.md I1; user ruling 2026-10-11. --- internal/runmgr/material.go | 260 +++++++++++++++++++++++++ internal/runmgr/material_test.go | 180 +++++++++++++++++ internal/runmgr/runmgr.go | 92 +++++++-- internal/runtime/llm_direct.go | 45 ++++- internal/runtime/material_flow_test.go | 121 ++++++++++++ internal/runtime/sub_loop.go | 34 ++++ internal/runtime/verify.go | 5 + internal/settings/settings.go | 20 +- 8 files changed, 723 insertions(+), 34 deletions(-) create mode 100644 internal/runmgr/material.go create mode 100644 internal/runmgr/material_test.go create mode 100644 internal/runtime/material_flow_test.go diff --git a/internal/runmgr/material.go b/internal/runmgr/material.go new file mode 100644 index 0000000..93dbc90 --- /dev/null +++ b/internal/runmgr/material.go @@ -0,0 +1,260 @@ +// 材料整理入口（附件即保证）：带附件的回合由系统确定性启动一个「材料整理」 +// 后台子任务——不再依赖模型自觉调用 delegate_task（实测 MiniMax 对入口提示 +// 无视、问一句就收场，快慢双速从未真正启动）。规则（用户 2026-10-11 裁定）： +// - 无文字发送或材料总量达阈值 → 发送瞬间预启动（先建卡再跑快通道）； +// - 文字+小材料 → 模型先答；回合结束（runtime stop 钩子）仍未启动则兜底启动； +// - 模型自己已委派后台任务（delegatedBackground）时尊重模型判断，不重复兜底； +// - 同一批材料按内容键去重：进行中不重建，已完成不重跑（失败可重试）。 +package runmgr + +import ( + "crypto/sha256" + "encoding/hex" + "fmt" + "log" + "sort" + "strings" + "unicode/utf8" + + core "agent-system-core" +) + +const ( + materialSubagentID = "agent.sub.material" + materialCardTitle = "材料整理" + materialKVKey = "材料键" + materialCharsKey = "runtime.materialIntakeChars" + materialCharsDefaut = 12000 + // 单文档内联上限沿用父回合同款附件预算；三份上限内的典型材料可全文直达。 + materialPerDocKey = "context.maxAttachmentChars" + materialPerDocDef = 48000 + // 全部材料内联总预算（rune）：超出部分截断，子代理用 knowledge_search 补齐 + // （上传时解析文本已进检索索引）。 + materialInlineTotal = 120000 +) + +const materialStartedNote = "系统已自动启动材料整理后台任务（收件箱进度卡「材料整理」已创建，完成后结果自动回投该卡并发起汇报）。你负责快通道：立即给用户即时反馈——每份材料一句话概览、初步判断、需要澄清的问题；不要等待整理完成，也不要用 delegate_task 重复派发这批材料的整理。整理结果回投后，再基于它推进正式交付物。" + +const materialPendingNote = "系统此前已为这批材料启动材料整理后台任务（见收件箱进度卡「材料整理」），完成后自动回投并汇报；不要重复派发整理任务，现在给用户即时反馈即可。" + +const materialDoneNote = "这批材料此前已整理完成（见收件箱「材料整理」卡片的结果）。不要重复派发整理任务；如需正式交付物（摘要/评审/需求文档/方案等），基于已有整理结果直接推进。" + +// materialKey 内容去重键：排序后的 文件名+解析字符数 参与哈希——同一批文件 +// 重发（新的消息、新的附件切片）得到同键；内容变化则视为新材料。 +func materialKey(docs []core.ParsedDocument) string { + parts := make([]string, 0, len(docs)) + for _, d := range docs { + parts = append(parts, fmt.Sprintf("%s|%d", d.Meta.Filename, utf8.RuneCountInString(d.PlainText()))) + } + sort.Strings(parts) + sum := sha256.Sum256([]byte(strings.Join(parts, "\n"))) + return hex.EncodeToString(sum[:]) +} + +func materialChars(docs []core.ParsedDocument) int { + total := 0 + for _, d := range docs { + total += utf8.RuneCountInString(d.PlainText()) + } + return total +} + +// messageText 提取消息的纯文本部分（判断「无文字发送」）。 +func messageText(m core.Message) string { + var b strings.Builder + for _, p := range m.Parts { + if p.Type == core.PartText { + b.WriteString(p.Text) + } + } + return strings.TrimSpace(b.String()) +} + +// buildMaterialTask 组装材料整理子任务正文：清单（文件名/字数/解析器/警告）+ +// 按预算内联的解析全文 + 整理指令（事实/结论/冲突/待办 + 用途建议，供交付物 +// 选择卡取材）。子代理只有 knowledge_search 一个材料通道（fs 工具是预留能力， +// 默认关），超预算部分靠检索补齐。 +func buildMaterialTask(eff core.EffectiveSettings, docs []core.ParsedDocument) string { + perDoc := int(eff.GetNumber(materialPerDocKey, materialPerDocDef)) + if perDoc <= 0 { + perDoc = materialPerDocDef + } + var b strings.Builder + fmt.Fprintf(&b, "整理用户上传的 %d 份材料并输出结构化摘要。\n\n", len(docs)) + b.WriteString("要求：\n") + b.WriteString("1. 逐文档输出：核心事实（数字/日期/决定事项逐条）、该文档的结论、与其他文档的冲突（如有）、待办或未决事项。\n") + b.WriteString("2. 整体输出：跨文档摘要（不超过 200 字），以及「建议后续处理」3-4 项（按材料实际内容，如会议摘要/评审报告/需求文档/架构方案），每项附一句依据——用户将从中选择正式交付物。\n") + b.WriteString("3. 所有引用标注来源文件名与章节；材料中找不到的信息不要编造。\n") + b.WriteString("4. 下面被截断的材料可用 knowledge_search 按文件名检索补齐。\n") + b.WriteString("\n=== 材料清单 ===\n") + left := materialInlineTotal + for _, d := range docs { + text := strings.TrimSpace(d.PlainText()) + runes := utf8.RuneCountInString(text) + fmt.Fprintf(&b, "\n### %s（%d 字，解析器 %s）\n", d.Meta.Filename, runes, d.Meta.Parser) + for _, w := range d.Warnings { + fmt.Fprintf(&b, "⚠ %s\n", w) + } + if runes == 0 { + b.WriteString("（无可解析文本）\n") + continue + } + cap := perDoc + if cap > left { + cap = left + } + if runes <= cap { + b.WriteString(text) + b.WriteString("\n") + left -= runes + continue + } + b.WriteString(string([]rune(text)[:cap])) + b.WriteString("\n…（超长截断，余下部分用 knowledge_search 检索本文件名）\n") + left -= cap + if left <= 0 { + left = 0 + } + } + return b.String() +} + +// materialIntake 预启动决策：附件即保证的「发送瞬间」分支。 +// 返回注入第 0 回合提示的系统说明；空串 = 本回合不预启动（留给 stop 兜底）。 +func (m *Manager) materialIntake(rc *runCtx) string { + if !rc.eff.GetBool("runtime.materialIntake", true) || len(rc.attachments) == 0 { + return "" + } + if note, existing := m.materialExisting(rc, materialKey(rc.attachments)); existing { + return note + } + userText := messageText(rc.userMessage) + threshold := int(rc.eff.GetNumber(materialCharsKey, materialCharsDefaut)) + if userText != "" && materialChars(rc.attachments) < threshold { + return "" // 文字+小材料：模型先答，回合结束兜底 + } + return m.materialSpawn(rc, materialKey(rc.attachments)) +} + +// ensureMaterial stop 兜底入口（幂等：只在首个调用实际派发并返回说明）。 +// runtime 侧在「模型未自己委派」时调用；是否真的启动由内容键去重决定。 +func (c *runCtx) ensureMaterial() string { + if c.materialEnsured { + return "" + } + c.materialEnsured = true + if len(c.attachments) == 0 || !c.eff.GetBool("runtime.materialIntake", true) { + return "" + } + key := materialKey(c.attachments) + if note, existing := c.mgr.materialExisting(c, key); existing { + c.materialNote = note + return note + } + if note := c.mgr.materialSpawn(c, key); note != "" { + c.materialNote = note + return note + } + return "" +} + +// MaterialNote 供 runtime 第 0 回合注入（预启动或去重命中时的既有说明）。 +func (c *runCtx) MaterialNote() string { return c.materialNote } + +// materialExisting 按内容键查既有任务：进行中 → 待回投说明；已成功完成 → +// 已完成说明；失败 → 允许重试（视为不存在）。先查内存注册表，再扫卡片 +// （重启后注册表丢失，卡片 KV 是持久凭据）。 +func (m *Manager) materialExisting(rc *runCtx, key string) (string, bool) { + convID := string(rc.run.ConversationID) + m.materialMu.Lock() + if m.materialActive != nil && m.materialActive[convID][key] { + m.materialMu.Unlock() + return materialPendingNote, true + } + m.materialMu.Unlock() + if m.cards == nil { + return "", false + } + cards, err := m.cards.List(rc.run.Owner, rc.run.ConversationID) + if err != nil { + return "", false + } + for _, card := range cards { + if card.Kind != core.CardKindProgress { + continue + } + // 卡片 KV 存材料键前缀（UI 友好），与全键做前缀匹配。 + if kv := materialKVOf(card); kv == "" || !strings.HasPrefix(key, kv) { + continue + } + switch card.Status { + case core.CardActive: + return materialPendingNote, true + case core.CardDone: + if card.Tone == "danger" { + continue // 失败可重试 + } + return materialDoneNote, true + } + } + return "", false +} + +func materialKVOf(card core.ActivityCard) string { + for _, node := range card.Body { + if node.Type != core.UIKV { + continue + } + for _, kv := range node.KV { + if kv[0] == materialKVKey { + return kv[1] + } + } + } + return "" +} + +// materialSpawn 启动材料整理后台任务（建卡 + 注册内容键）。 +// 派发失败（如容量满，I3 前为硬拒绝）返回空串，自然延后到下一次兜底机会。 +func (m *Manager) materialSpawn(rc *runCtx, key string) string { + short := key + if len(short) > 12 { + short = short[:12] + } + opts := bgSpawnOpts{ + agentID: materialSubagentID, + name: materialCardTitle, + task: buildMaterialTask(rc.eff, rc.attachments), + hint: "以材料实际内容为准；用途建议必须是材料能支撑的，不虚构。", + kv: [][2]string{{materialKVKey, short}, {"文件", fmt.Sprintf("%d 份", len(rc.attachments))}}, + taskKey: key, + material: true, + } + if _, err := m.spawnBackgroundOpts(rc.run, opts); err != nil { + log.Printf("[runmgr] material intake spawn: %v", err) + return "" + } + return materialStartedNote +} + +// materialKeyRegister/RegisterRelease 内容键注册表（内存档；卡片 KV 兜重启）。 +func (m *Manager) materialKeyRegister(convID, key string) { + m.materialMu.Lock() + defer m.materialMu.Unlock() + if m.materialActive == nil { + m.materialActive = map[string]map[string]bool{} + } + if m.materialActive[convID] == nil { + m.materialActive[convID] = map[string]bool{} + } + m.materialActive[convID][key] = true +} + +func (m *Manager) materialKeyRelease(convID, key string) { + m.materialMu.Lock() + defer m.materialMu.Unlock() + if m.materialActive == nil || m.materialActive[convID] == nil { + return + } + delete(m.materialActive[convID], key) +} diff --git a/internal/runmgr/material_test.go b/internal/runmgr/material_test.go new file mode 100644 index 0000000..be21e08 --- /dev/null +++ b/internal/runmgr/material_test.go @@ -0,0 +1,180 @@ +package runmgr + +import ( + "strings" + "testing" + + "agent-system-backend/internal/runtime" + core "agent-system-core" +) + +// holdRunner 阻塞到 release 才完成——材料整理去重需要子任务仍在运行的窗口。 +type holdRunner struct { + release chan struct{} + id string +} + +func (h *holdRunner) Name() string { return "hold" } + +func (h *holdRunner) Execute(rc runtime.RunCtx) error { + if src, ok := rc.(interface{ SubagentID() string }); ok { + h.id = src.SubagentID() + } + <-h.release + return rc.SetAssistantParts([]core.Part{{Type: core.PartText, Text: "整理完成：三份材料的要点与冲突已汇总。"}}) +} + +func materialDocs() []core.ParsedDocument { + return []core.ParsedDocument{ + {Meta: core.DocMeta{Filename: "会议纪要.docx", Parser: "docx"}, Blocks: []core.DocBlock{{Type: core.BlockPara, Text: "决定上线新模块，预算 50 万，2026-11 前完成。"}}}, + {Meta: core.DocMeta{Filename: "评审意见.pdf", Parser: "pdf"}, Blocks: []core.DocBlock{{Type: core.BlockPara, Text: "对预算规模存疑，建议分两期。"}}}, + {Meta: core.DocMeta{Filename: "需求清单.md", Parser: "md"}, Blocks: []core.DocBlock{{Type: core.BlockPara, Text: "共 12 项需求，3 项依赖外部接口。"}}}, + } +} + +func secondRunCtx(c *runCtx, docs []core.ParsedDocument, userText string) *runCtx { + msg := core.Message{ConversationID: c.run.ConversationID} + if userText != "" { + msg.Parts = []core.Part{{Type: core.PartText, Text: userText}} + } + return &runCtx{ + mgr: c.mgr, run: core.Run{ID: "run_second", ConversationID: c.run.ConversationID, ProjectID: c.run.ProjectID, Owner: c.run.Owner}, + eff: c.eff, userMessage: msg, attachments: docs, + } +} + +// 验收主用例的后端形态：三附件、无文字、直接发送 → 立即预启动、建卡、 +// 进行中去重、完成后按内容键不重跑。 +func TestMaterialIntakeAttachmentOnlyLifecycle(t *testing.T) { + hold := &holdRunner{release: make(chan struct{})} + c, events := newCardSpawnEnv(t, hold) + c.mgr.runner = noopRunner{} + c.attachments = materialDocs() + + note := c.mgr.materialIntake(c) + if !strings.Contains(note, "系统已自动启动材料整理后台任务") { + t.Fatalf("pre-spawn note = %q", note) + } + waitUntil(t, func() bool { + cards, err := c.mgr.cards.List(c.run.Owner, c.run.ConversationID) + return err == nil && len(cards) == 1 && cards[0].Title == materialCardTitle && cards[0].Status == core.CardActive + }) + if got := cardEvents(events); len(got) == 0 { + t.Fatal("card events missing on spawn") + } + + // 同批材料重复发送：进行中 → 待回投说明，不重建子任务。 + c2 := secondRunCtx(c, materialDocs(), "") + note2 := c.mgr.materialIntake(c2) + if !strings.Contains(note2, "此前已为这批材料启动") { + t.Fatalf("dedup note = %q", note2) + } + ids, err := c.mgr.st.SubagentRunIDs(c.run.ConversationID) + if err != nil { + t.Fatal(err) + } + if len(ids) != 1 { + t.Fatalf("subagent runs = %d, want 1 (no respawn on resend)", len(ids)) + } + + close(hold.release) + waitUntil(t, func() bool { return len(systemTexts(t, c)) >= 1 }) + + // 完成后同批再发：已完成说明，同样不重跑；卡片回投保留材料键。 + c3 := secondRunCtx(c, materialDocs(), "") + note3 := c.mgr.materialIntake(c3) + if !strings.Contains(note3, "已整理完成") { + t.Fatalf("done-dedup note = %q", note3) + } + ids, err = c.mgr.st.SubagentRunIDs(c.run.ConversationID) + if err != nil { + t.Fatal(err) + } + if len(ids) != 1 { + t.Fatalf("subagent runs after completion = %d, want 1", len(ids)) + } + cards, err := c.mgr.cards.List(c.run.Owner, c.run.ConversationID) + if err != nil || len(cards) != 1 { + t.Fatalf("cards = %v err = %v", cards, err) + } + if materialKVOf(cards[0]) == "" { + t.Fatal("material key KV lost on finish backfill") + } + if hold.id != materialSubagentID { + t.Fatalf("material subagent id = %q, want %q", hold.id, materialSubagentID) + } +} + +// 文字+小材料：预启动跳过（模型先答），ensureMaterial 兜底启动且幂等。 +func TestMaterialIntakeDeferredThenEnsure(t *testing.T) { + hold := &holdRunner{release: make(chan struct{})} + c, _ := newCardSpawnEnv(t, hold) + small := []core.ParsedDocument{ + {Meta: core.DocMeta{Filename: "说明.txt", Parser: "txt"}, Blocks: []core.DocBlock{{Type: core.BlockPara, Text: "短说明"}}}, + } + c.attachments = small + c.userMessage = core.Message{Parts: []core.Part{{Type: core.PartText, Text: "这份文件第三行说的对吗？"}}} + + if note := c.mgr.materialIntake(c); note != "" { + t.Fatalf("small text+attachment should defer, note = %q", note) + } + if got := c.ensureMaterial(); !strings.Contains(got, "系统已自动启动材料整理后台任务") { + t.Fatalf("ensure note = %q", got) + } + if again := c.ensureMaterial(); again != "" { + t.Fatalf("ensureMaterial not idempotent: %q", again) + } + close(hold.release) + waitUntil(t, func() bool { return len(systemTexts(t, c)) >= 1 }) +} + +// runtime.materialIntake=false：入口与兜底都关闭（逃生开关）。 +func TestMaterialIntakeDisabled(t *testing.T) { + c, _ := newCardSpawnEnv(t, &captureRunner{}) + c.eff = core.EffectiveSettings{"runtime": map[string]any{"materialIntake": false}} + c.attachments = materialDocs() + if note := c.mgr.materialIntake(c); note != "" { + t.Fatalf("disabled intake note = %q", note) + } + if got := c.ensureMaterial(); got != "" { + t.Fatalf("disabled ensure note = %q", got) + } +} + +// 任务正文必须内联材料清单与解析文本；超预算截断并给出检索指引。 +func TestBuildMaterialTaskInlineBudget(t *testing.T) { + long := strings.Repeat("字", 600) + eff := core.EffectiveSettings{"context": map[string]any{"maxAttachmentChars": float64(100)}} + task := buildMaterialTask(eff, []core.ParsedDocument{ + {Meta: core.DocMeta{Filename: "长文.docx", Parser: "docx"}, Blocks: []core.DocBlock{{Type: core.BlockPara, Text: long}}}, + }) + if !strings.Contains(task, "### 长文.docx") { + t.Fatal("manifest entry missing") + } + if !strings.Contains(task, "超长截断") || !strings.Contains(task, "knowledge_search") { + t.Fatal("truncation marker / retrieval hint missing") + } + full := buildMaterialTask(core.EffectiveSettings{}, materialDocs()) + for _, name := range []string{"会议纪要.docx", "评审意见.pdf", "需求清单.md"} { + if !strings.Contains(full, name) { + t.Fatalf("manifest missing %s", name) + } + } + if !strings.Contains(full, "决定上线新模块") { + t.Fatal("parsed text not inlined") + } +} + +func TestMaterialKeyStableAcrossOrder(t *testing.T) { + docs := materialDocs() + a := materialKey(docs) + reversed := []core.ParsedDocument{docs[2], docs[1], docs[0]} + if b := materialKey(reversed); a != b { + t.Fatal("key should be order-insensitive") + } + changed := materialDocs() + changed[0].Blocks[0].Text = "内容变了" + if b := materialKey(changed); a == b { + t.Fatal("key should change with content") + } +} diff --git a/internal/runmgr/runmgr.go b/internal/runmgr/runmgr.go index e7dc1ce..d63d9f6 100644 --- a/internal/runmgr/runmgr.go +++ b/internal/runmgr/runmgr.go @@ -85,6 +85,11 @@ type Manager struct { bgInFlight map[string]int delivering map[string]bool + // 材料整理内容键注册表（附件即保证）：会话 → 活跃材料键。卡片 KV 是 + // 重启后的持久兜底，这里只是热路径的快速去重。 + materialMu sync.Mutex + materialActive map[string]map[string]bool + allowMu sync.Mutex sessionAllow map[string]map[string]bool } @@ -93,10 +98,11 @@ const maxBackgroundChildren = 3 // bgNotice 是一条尚未投递给父会话的后台子代理结果。 type bgNotice struct { - id string // 持久化队列主键（重启重投凭据） - owner string - name string - payload core.AgentResultPayload + id string // 持久化队列主键（重启重投凭据） + owner string + name string + payload core.AgentResultPayload + material bool // 材料整理任务：通知回合要衔接交付物选择（I2 消费） } // ErrConversationBusy 表示会话已有在途 run（HTTP 层映射 409）。 @@ -259,9 +265,13 @@ type runCtx struct { subTask string subHint string subAgent string + subModel string // 系统派发覆盖（"chat" = 子代理用对话同档；空 = 按 spec） launch *workflow.Launch files *filestate.Tracker permissionMode string + // 材料整理（附件即保证）：预启动说明注入第 0 回合；ensureMaterial 兜底幂等。 + materialNote string + materialEnsured bool } // Surfaces 返回当前会话最近保存的生成页面（U3/R6：ctxasm 语义投影回灌； @@ -652,6 +662,9 @@ func (c *runCtx) SubagentID() string { return c.subAgent } func (c *runCtx) Subhint() string { return c.subHint } +// Submodel 系统派发的模型档覆盖（材料整理用对话同档；空 = 子代理 spec 默认）。 +func (c *runCtx) Submodel() string { return c.subModel } + func (c *runCtx) UpdatePlan(p core.PlanSnapshot) error { p.PlanID = c.run.ConversationID if err := c.mgr.st.SavePlan(c.run.ConversationID, p); err != nil { @@ -1236,6 +1249,11 @@ func (m *Manager) startClaimedRun(conv core.Conversation, userMessage core.Messa PersistInputTexts(m.workspaceRoot, conv.Owner, conv.ID, attachments) inputPaths = ListWorkspaceInputs(m.workspaceRoot, conv.Owner, conv.ID, inputPaths) rc := &runCtx{mgr: m, run: run, prof: prof, eff: eff, ctx: ctx, h: h, userMessage: userMessage, attachments: attachments, inputPaths: inputPaths, launch: launch, files: filestate.New(), permissionMode: conversationMode(m, run.Owner, run.ConversationID)} + // 材料整理（附件即保证）：无文字/大材料发送瞬间预启动，说明注入第 0 回合； + // 其余带附件回合由 runtime stop 钩子兜底（模型已自行委派时尊重模型判断）。 + if launch == nil { + rc.materialNote = m.materialIntake(rc) + } go func() { // 执行许可（U3，R8）：排队有界；获取失败（队列满/取消/存储故障）以 // failed 收口——不执行任何模型调用，副作用无从产生。 @@ -1634,6 +1652,12 @@ func (m *Manager) spawnSubagent(parentCtx context.Context, parent core.Run, agen // startChild 做深度检查、建 run、发 spawn 事件。detach 时子 run 使用独立 ctx， // 父 run 结束不会取消它；cancel 仍登记在 active 里，CancelRun 和停机中断照常生效。 func (m *Manager) startChild(parentCtx context.Context, parent core.Run, agentID, name, task, hint string, detach bool) (*runCtx, runtime.Runner, error) { + return m.startChildOpts(parentCtx, parent, bgSpawnOpts{agentID: agentID, name: name, task: task, hint: hint}, detach) +} + +// startChildOpts 在 startChild 之上支持系统派发选项（模型档等）。 +func (m *Manager) startChildOpts(parentCtx context.Context, parent core.Run, o bgSpawnOpts, detach bool) (*runCtx, runtime.Runner, error) { + agentID, name, task, hint := o.agentID, o.name, o.task, o.hint if parent.Kind == core.RunSubagent { return nil, nil, fmt.Errorf("子代理不能再派发子代理") } @@ -1664,7 +1688,7 @@ func (m *Manager) startChild(parentCtx context.Context, parent core.Run, agentID prof, _ := m.profiles.Get(parent.Owner, parent.ProfileID) eff := m.settings.Effective(parent.Owner, parent.ProjectID) - rc := &runCtx{mgr: m, run: child, prof: prof, eff: eff, ctx: ctx, h: h, subTask: task, subHint: hint, subAgent: agentID, files: filestate.New(), permissionMode: conversationMode(m, child.Owner, child.ConversationID)} + rc := &runCtx{mgr: m, run: child, prof: prof, eff: eff, ctx: ctx, h: h, subTask: task, subHint: hint, subAgent: agentID, subModel: o.model, files: filestate.New(), permissionMode: conversationMode(m, child.Owner, child.ConversationID)} m.setRunStatus(&rc.run, core.RunRunning, core.PhaseActing) runner := m.subRunner @@ -1750,10 +1774,33 @@ func (m *Manager) finishChild(rc *runCtx, runner runtime.Runner, emitResult bool return payload, nil } +// bgSpawnOpts 后台派发选项：模型 delegate_task 走零值；系统确定性派发 +// （材料整理）携带模型档、卡片 KV、内容键与材料标记。 +type bgSpawnOpts struct { + agentID, name, task, hint string + model string // "chat" = 子代理用对话同档模型（材料整理） + kv [][2]string + taskKey string // 内容键（非空 = 派发前去重、完成后保留键于卡片） + material bool // 材料整理任务（通知回合衔接交付物选择） +} + func (m *Manager) spawnBackground(parent core.Run, agentID, name, task, hint string) (core.ID, error) { + return m.spawnBackgroundOpts(parent, bgSpawnOpts{agentID: agentID, name: name, task: task, hint: hint}) +} + +func (m *Manager) spawnBackgroundOpts(parent core.Run, o bgSpawnOpts) (core.ID, error) { if parent.Kind == core.RunSubagent { return "", fmt.Errorf("子代理不能再派发子代理") } + if o.taskKey != "" { + convID := string(parent.ConversationID) + m.materialMu.Lock() + active := m.materialActive != nil && m.materialActive[convID][o.taskKey] + m.materialMu.Unlock() + if active { + return "", fmt.Errorf("同键后台任务已在运行（材料键 %s），见收件箱进度卡", truncate(o.taskKey, 12)) + } + } m.noticeMu.Lock() if m.bgInFlight == nil { m.bgInFlight = map[string]int{} @@ -1765,29 +1812,36 @@ func (m *Manager) spawnBackground(parent core.Run, agentID, name, task, hint str m.bgInFlight[parent.ConversationID]++ m.noticeMu.Unlock() - rc, runner, err := m.startChild(context.Background(), parent, agentID, name, task, hint, true) + rc, runner, err := m.startChildOpts(context.Background(), parent, o, true) if err != nil { m.decBackground(parent.ConversationID) return "", err } + if o.taskKey != "" { + m.materialKeyRegister(string(parent.ConversationID), o.taskKey) + } // 慢通道可观测（任务快慢双速，SR-B10）：后台子代理进收件箱进度卡， // 完成后把结果回投该卡；通知回合路径保持不变，卡片是用户侧回收入口。 - bgCard := m.createBackgroundCard(parent, rc.run.ID, name, task) + bgCard := m.createBackgroundCard(parent, rc.run.ID, o.name, o.task, o.kv) + kv := o.kv go func() { defer m.decBackground(parent.ConversationID) + if o.taskKey != "" { + defer m.materialKeyRelease(string(parent.ConversationID), o.taskKey) + } // 后台子代理同样计入执行预算（U3：子代理预算计入全局）。 if err := m.adm.acquire(context.Background(), m.st, rc.run.ID, parent.Owner); err != nil { log.Printf("[runmgr] admission denied background %s: %v", rc.run.ID, err) m.setRunStatus(&rc.run, core.RunFailed, rc.run.Phase) m.st.UpdateRun(&core.Run{ID: rc.run.ID, Status: core.RunFailed, Error: &core.ErrorPart{Code: "run.admission_denied", Message: err.Error()}}) m.emit(rc.run.ConversationID, rc.run.ID, core.EvRunFailed, core.RunFailedPayload{Code: "run.admission_denied", Message: "后台子代理执行许可排队已满或已取消"}) - m.finishBackgroundCard(parent.Owner, bgCard, core.AgentResultPayload{}, err) + m.finishBackgroundCard(parent.Owner, bgCard, core.AgentResultPayload{}, err, kv) return } defer m.adm.release(m.st, rc.run.ID) payload, err := m.finishChild(rc, runner, false) - m.finishBackgroundCard(parent.Owner, bgCard, payload, err) - m.enqueueNotice(parent.ConversationID, bgNotice{owner: parent.Owner, name: name, payload: payload}) + m.finishBackgroundCard(parent.Owner, bgCard, payload, err, kv) + m.enqueueNotice(parent.ConversationID, bgNotice{owner: parent.Owner, name: o.name, payload: payload, material: o.material}) m.deliverNotices(parent.ConversationID) }() return rc.run.ID, nil @@ -1795,7 +1849,8 @@ func (m *Manager) spawnBackground(parent core.Run, agentID, name, task, hint str // createBackgroundCard 在收件箱登记慢通道进度卡。收件箱未启用（cards==nil） // 或建卡失败时返回零值卡，完成回投随之跳过，不影响通知投递。 -func (m *Manager) createBackgroundCard(parent core.Run, childID core.ID, name, task string) core.ActivityCard { +// kv 为系统派发任务的附加键值（材料键等），随完成回投保留。 +func (m *Manager) createBackgroundCard(parent core.Run, childID core.ID, name, task string, kv [][2]string) core.ActivityCard { if m.cards == nil { return core.ActivityCard{} } @@ -1803,13 +1858,14 @@ func (m *Manager) createBackgroundCard(parent core.Run, childID core.ID, name, t if title == "" { title = "后台任务" } + body := []core.UINode{ + {Type: core.UIMarkdown, Markdown: truncate(strings.TrimSpace(task), 400)}, + {Type: core.UIKV, KV: append(append([][2]string(nil), kv...), [2]string{"通道", "慢通道 · 后台执行"}, [2]string{"状态", "执行中，完成后自动回投结果"})}, + } card, err := m.cards.Create(parent.Owner, core.ActivityCard{ Kind: core.CardKindProgress, Title: title, Status: core.CardActive, Tone: "info", ConversationID: parent.ConversationID, ProjectID: parent.ProjectID, SourceRunID: childID, - Body: []core.UINode{ - {Type: core.UIMarkdown, Markdown: truncate(strings.TrimSpace(task), 400)}, - {Type: core.UIKV, KV: [][2]string{{"通道", "慢通道 · 后台执行"}, {"状态", "执行中，完成后自动回投结果"}}}, - }, + Body: body, }, "") if err != nil { log.Printf("[runmgr] background card create: %v", err) @@ -1819,8 +1875,8 @@ func (m *Manager) createBackgroundCard(parent core.Run, childID core.ID, name, t } // finishBackgroundCard 把后台子代理终态写回进度卡：成功=结果摘要（含工件行）， -// 失败=错误说明；状态统一置 done，tone 区分成败。 -func (m *Manager) finishBackgroundCard(owner string, card core.ActivityCard, payload core.AgentResultPayload, err error) { +// 失败=错误说明；状态统一置 done，tone 区分成败。kv 原样保留（材料键等持久凭据）。 +func (m *Manager) finishBackgroundCard(owner string, card core.ActivityCard, payload core.AgentResultPayload, err error, kv [][2]string) { if m.cards == nil || card.ID == "" { return } @@ -1838,7 +1894,7 @@ func (m *Manager) finishBackgroundCard(owner string, card core.ActivityCard, pay } card.Body = []core.UINode{ {Type: core.UIMarkdown, Markdown: summary}, - {Type: core.UIKV, KV: [][2]string{{"通道", "慢通道 · 后台执行"}, {"状态", "已完成"}}}, + {Type: core.UIKV, KV: append(append([][2]string(nil), kv...), [2]string{"通道", "慢通道 · 后台执行"}, [2]string{"状态", "已完成"})}, } if uerr := m.cards.Update(owner, card); uerr != nil { log.Printf("[runmgr] background card update: %v", uerr) diff --git a/internal/runtime/llm_direct.go b/internal/runtime/llm_direct.go index 2c6ebe0..d7395bc 100644 --- a/internal/runtime/llm_direct.go +++ b/internal/runtime/llm_direct.go @@ -74,17 +74,18 @@ type directRun struct { // 从此有可指地址。 ledger []evidenceEntry ledgerCount int - progress *gates.ProgressReminder - checks []core.CheckPart - servedModel string - switches []string - switchMu sync.Mutex + progress *gates.ProgressReminder + checks []core.CheckPart + servedModel string + switches []string + switchMu sync.Mutex // 任务快慢双速（SR-B10 实路径）：started 用注入时钟记 run 起点， // nudged/replied/delegated 三个标志驱动「超时仍未反馈则提醒转双速」的一次性触发。 started time.Time nudgedDualSpeedCount int replied bool delegatedBackground bool + materialChecked bool // 材料兜底只问一次（runCtx 侧另有幂等，双保险） } type toolEvidence struct { @@ -318,9 +319,18 @@ func (l *LLMRunner) runDirect(rc RunCtx, stream agentllm.StreamFunc, model strin // 快慢双速入口前置（SR-B10 实路径）：带附件的任务在第 0 回合就把 // 双速选项摆给模型——模型对开场指令的遵循远好于中途提醒（实测 // MiniMax 无视中途 system-reminder，但对工作方法开场指令照办）。 - // 只提示一次，不强制拆分，保留 UR-27 的智能体自判。 + // 材料整理入口（附件即保证）：系统已确定性启动时注入事实说明 + // （职责改为快通道反馈+后续交付物），未预启动（文字+小材料）时 + // 保留建议式提示，回合结束由 stop 钩子兜底保证。 if turn == 0 && st.eff.GetNumber("runtime.dualSpeedNudgeSeconds", dualSpeedNudgeDefaultSeconds) > 0 && len(rc.Attachments()) > 0 { - out = append(out, "本任务附带材料，可能属于重任务。若预计要产出正式文档或做深度处理，采用快慢双速：先在当前回复里给用户即时反馈（材料相关性判断、概要或执行计划），再用 delegate_task 的 background=true 把深度工作放到后台执行——收件箱会显示进度卡，完成后系统自动回投结果并汇报。简单任务按常规同步完成即可。") + note := "" + if src, ok := rc.(interface{ MaterialNote() string }); ok { + note = strings.TrimSpace(src.MaterialNote()) + } + if note == "" { + note = "本任务附带材料，可能属于重任务。若预计要产出正式文档或做深度处理，采用快慢双速：先在当前回复里给用户即时反馈（材料相关性判断、概要或执行计划），再用 delegate_task 的 background=true 把深度工作放到后台执行——收件箱会显示进度卡，完成后系统自动回投结果并汇报。简单任务按常规同步完成即可。" + } + out = append(out, note) } // 转录权威：系统段在播种时冻结，动态上下文（尾注/环境/新命中模块） // 只在非播种 run 的首个请求注入一次——run 内反复重发没有信息增量。 @@ -578,6 +588,19 @@ func (st *directRun) onEvent(ev nruntime.Event) { } func (st *directRun) stop(last agentllm.Message, info nruntime.StopInfo) nruntime.StopDecision { + // 材料整理兜底（附件即保证）：带附件回合结束仍无后台任务且模型也没自行 + // 委派（delegatedBackground 尊重模型判断）→ 系统确定性启动，续跑一轮让 + // 模型告知用户。ensureMaterial 幂等 + materialChecked 一次性：不续跑循环。 + // 实测动机：MiniMax 对入口提示无视、问一句澄清就收场，0 委派 0 卡片， + // 用户全程无反馈。 + if !st.materialChecked && len(st.rc.Attachments()) > 0 && !st.delegatedBackground { + if ens, ok := st.rc.(interface{ EnsureMaterial() string }); ok { + st.materialChecked = true + if note := strings.TrimSpace(ens.EnsureMaterial()); note != "" { + return nruntime.StopDecision{Continue: true, Reason: materialBackstopReason} + } + } + } if block, why := deliverableGateOf(st.turnBody, st.deliverables, st.rc); block { st.demoteLastText() if st.eff.GetBool("runtime.verify", false) { @@ -769,7 +792,13 @@ func (st *directRun) runToolCtx(ctx context.Context, name, args string) agenttoo if sp, ok := st.rc.(interface { SpawnBackground(agentID, name, task, hint string) (core.ID, error) }); ok { - id, serr := sp.SpawnBackground(subagentProfileID(a.Agent), orDefault(a.Name, "子代理"), a.Task, a.Hint) + // 材料传递（R2）：模型自派的后台任务同样带上材料指引——子代理 + // 看不到父回合内联的附件全文，需指明检索通道。 + task := a.Task + if len(st.rc.Attachments()) > 0 { + task += delegateMaterialsNote(st.rc.Attachments()) + } + id, serr := sp.SpawnBackground(subagentProfileID(a.Agent), orDefault(a.Name, "子代理"), task, a.Hint) if serr != nil { out = "子代理失败：" + serr.Error() } else { diff --git a/internal/runtime/material_flow_test.go b/internal/runtime/material_flow_test.go new file mode 100644 index 0000000..88a6c59 --- /dev/null +++ b/internal/runtime/material_flow_test.go @@ -0,0 +1,121 @@ +package runtime + +import ( + "context" + "strings" + "testing" + + agentllm "agent-native/runtime/llm" + core "agent-system-core" +) + +// matCtx 在 fakeRunCtx 之上实现材料整理的两个可选接口（附件即保证）， +// 记录 EnsureMaterial 调用次数以断言 stop 兜底的幂等。 +type matCtx struct { + *fakeRunCtx + note string + ensureN int + lastNote string +} + +func (m *matCtx) MaterialNote() string { return m.note } + +func (m *matCtx) EnsureMaterial() string { + m.ensureN++ + if m.ensureN > 1 { + return "" + } + return m.lastNote +} + +func matAttachments() []core.ParsedDocument { + return []core.ParsedDocument{ + {Meta: core.DocMeta{Filename: "纪要.docx"}, Blocks: []core.DocBlock{{Type: core.BlockPara, Text: "决定 11 月上线"}}}, + {Meta: core.DocMeta{Filename: "意见.pdf"}, Blocks: []core.DocBlock{{Type: core.BlockPara, Text: "预算存疑"}}}, + {Meta: core.DocMeta{Filename: "清单.md"}, Blocks: []core.DocBlock{{Type: core.BlockPara, Text: "12 项需求"}}}, + } +} + +func runMaterial(t *testing.T, turns [][]agentllm.Event, rc *matCtx) *dualSpeedRecorder { + t.Helper() + rec := &dualSpeedRecorder{clock: &stepClock{}, turns: turns} + r := &LLMRunner{Stream: rec.stream(scriptStream(turns, nil)), Now: rec.clock.now} + if err := r.Execute(rc); err != nil { + t.Fatalf("Execute: %v", err) + } + return rec +} + +func requestsContaining(rec *dualSpeedRecorder, needle string) int { + n := 0 + for _, req := range rec.request { + if strings.Contains(req, needle) { + n++ + } + } + return n +} + +// 预启动说明替换建议式提示：第 0 回合注入事实说明而非「可能属于重任务」。 +func TestTurn0MaterialNoteReplacesAdvisory(t *testing.T) { + rc := &matCtx{fakeRunCtx: &fakeRunCtx{ctx: context.Background(), prof: verifyOn()}, note: "系统已自动启动材料整理后台任务（收件箱进度卡「材料整理」已创建）。"} + rc.attachments = matAttachments() + rec := runMaterial(t, [][]agentllm.Event{textDeltaTurn("收到，先给每份材料一句话概览。")}, rc) + if requestsContaining(rec, "系统已自动启动材料整理后台任务") == 0 { + t.Fatal("material note not injected at turn 0") + } + if requestsContaining(rec, "可能属于重任务") != 0 { + t.Fatal("advisory text should be replaced when material note present") + } +} + +// 未预启动（文字+小材料）：保留建议式入口提示。 +func TestTurn0AdvisoryWhenNoNote(t *testing.T) { + rc := &matCtx{fakeRunCtx: &fakeRunCtx{ctx: context.Background(), prof: verifyOn()}} + rc.attachments = matAttachments() + rec := runMaterial(t, [][]agentllm.Event{textDeltaTurn("概览如下。")}, rc) + if requestsContaining(rec, "可能属于重任务") == 0 { + t.Fatal("advisory hint missing when no material note") + } +} + +// stop 兜底：模型问一句澄清就收场（用户实测现象）→ 系统续跑一轮要求告知； +// ensureMaterial 幂等保证只续跑一次。 +func TestStopMaterialBackstopContinuesOnce(t *testing.T) { + rc := &matCtx{ + fakeRunCtx: &fakeRunCtx{ctx: context.Background(), prof: verifyOn()}, + lastNote: "系统已自动启动材料整理后台任务", + } + rc.attachments = matAttachments() + turns := [][]agentllm.Event{ + textDeltaTurn("请问你需要哪种产出？"), + textDeltaTurn("材料正在后台整理，完成后自动汇报；先给概览。"), + } + rec := runMaterial(t, turns, rc) + if requestsContaining(rec, "系统已自动启动材料整理后台任务") == 0 { + t.Fatal("backstop reason not injected as continuation") + } + if rc.ensureN != 1 { + t.Fatalf("EnsureMaterial calls = %d, want exactly 1", rc.ensureN) + } +} + +// 模型已自行委派后台（delegatedBackground）→ 尊重模型判断，不触发兜底。 +func TestStopMaterialBackstopSkippedWhenDelegated(t *testing.T) { + rc := &matCtx{ + fakeRunCtx: &fakeRunCtx{ctx: context.Background(), prof: verifyOn(), bgID: "run_bg_1"}, + } + rc.attachments = matAttachments() + delegate := toolCall("delegate_task", `{"name":"深度解析","task":"解析材料","background":true}`) + turns := [][]agentllm.Event{ + textDeltaTurn("", delegate), + textDeltaTurn("已在后台解析，先给即时反馈。"), + } + rec := runMaterial(t, turns, rc) + if rc.ensureN != 0 { + t.Fatalf("EnsureMaterial calls = %d, want 0 (model delegated)", rc.ensureN) + } + if requestsContaining(rec, "自动启动材料整理后台任务") != 0 { + t.Fatal("backstop should not fire when model delegated") + } +} diff --git a/internal/runtime/sub_loop.go b/internal/runtime/sub_loop.go index 41f1a2d..3e5f302 100644 --- a/internal/runtime/sub_loop.go +++ b/internal/runtime/sub_loop.go @@ -19,6 +19,11 @@ const subagentFallback = "你是被派生的子代理。独立完成给定子任 const defaultSubagentID = "agent.sub.general" +// materialSubagentID 材料整理子代理（附件即保证）：系统确定性派发，不依赖 +// 提示词库配置即可工作——spec 缺省在代码内（对话同档模型 + 检索；fs 工具是 +// 预留能力默认关，材料通道 = 任务正文内联 + knowledge_search）。 +const materialSubagentID = "agent.sub.material" + func fallbackSubagentSpec() prompts.SubagentSpec { return prompts.SubagentSpec{ Tools: []string{"knowledge_search", "web_search", "tavily_search", "time_now", "list_conversations", "read_conversation", "fs_read_file", "fs_list_dir"}, @@ -26,6 +31,13 @@ func fallbackSubagentSpec() prompts.SubagentSpec { } } +func materialSubagentSpec() prompts.SubagentSpec { + return prompts.SubagentSpec{ + Tools: []string{"knowledge_search", "time_now"}, + Model: "chat", + } +} + func (l *SubLLMRunner) Name() string { return "llm-subagent" } func (l *SubLLMRunner) Execute(rc RunCtx) error { @@ -36,11 +48,18 @@ func (l *SubLLMRunner) Execute(rc RunCtx) error { } } spec := fallbackSubagentSpec() + if id == materialSubagentID { + spec = materialSubagentSpec() + } if l.Prompts != nil { if got, ok := l.Prompts.SubagentSpec(rc.Profile().Owner, id); ok { spec = got } } + // 系统派发的模型档覆盖（材料整理 = 对话同档）：优先于 spec 默认。 + if src, ok := rc.(interface{ Submodel() string }); ok && src.Submodel() == "chat" { + spec.Model = "chat" + } maxTurns := spec.MaxTurns if maxTurns <= 0 { maxTurns = math.MaxInt32 @@ -253,6 +272,21 @@ func (st *subRun) runTool(name, args string) agenttools.Result { return agenttools.Result{Content: summary} } +// delegateMaterialsNote 模型自派后台任务的材料指引（R2）：子代理看不到父回合 +// 内联的附件全文，指明 knowledge_search 检索通道（上传时解析文本已进索引）。 +func delegateMaterialsNote(docs []core.ParsedDocument) string { + names := make([]string, 0, len(docs)) + for _, d := range docs { + if n := strings.TrimSpace(d.Meta.Filename); n != "" { + names = append(names, n) + } + } + if len(names) == 0 { + return "" + } + return "\n\n[系统补充] 本会话材料文件：" + strings.Join(names, "、") + "。解析全文可用 knowledge_search 以文件名为关键词检索获取。" +} + func subagentProfileID(agent string) string { switch agent { case "explore", "research", "plan", "verify", "general", "writer": diff --git a/internal/runtime/verify.go b/internal/runtime/verify.go index 1d2baf0..a55a782 100644 --- a/internal/runtime/verify.go +++ b/internal/runtime/verify.go @@ -26,6 +26,11 @@ func systemCheckReason(body string) string { return "\n这是系统的终轮自动检查，不是用户发言。先用工具核实并修复指出的问题。检查带位置时先修那一处；确认检查本身有误时，在最终答复里用一句话说明原因（不要引用检查原文），然后如实收尾——既不要默默无视未通过的检查，也不要在没核实的情况下反复空转。\n" + body + "\n" } +// materialBackstopReason 材料整理兜底（附件即保证）的续跑指令：不走 +// systemCheckReason 的「核实修复」前缀——这里没有待修的检查，只有事实告知 +// 与职责提醒；ensureMaterial 幂等保证只续跑一轮。 +const materialBackstopReason = "\n这是系统的终轮自动处理，不是用户发言。系统已自动启动材料整理后台任务（收件箱有进度卡「材料整理」，完成后结果自动回投并汇报）。请在当前回复里告知用户这一点（一两句话即可），并补充你现在就能给的即时反馈——每份材料一句话概览或初步判断。不要用 delegate_task 重复派发材料整理，也不要等待整理完成再回复。\n" + func (l *LLMRunner) runVerifier(rc RunCtx, body string, evidence []toolEvidence, refs []*core.ArtifactRef) (gates.Verdict, error) { route := ResolveLightweightModel(rc.Profile(), rc.Settings()) stream := l.VerifyStream diff --git a/internal/settings/settings.go b/internal/settings/settings.go index 95c9b61..334ab89 100644 --- a/internal/settings/settings.go +++ b/internal/settings/settings.go @@ -34,14 +34,16 @@ func SystemDefaults() map[string]any { "tavily": map[string]any{"apiKeys": "", "endpoint": ""}, // 网络搜索（逗号分隔密钥池；空 = 不注册搜索工具） }, "runtime": map[string]any{ - "mock": false, // true = 全部会话走 mock runner（演示/测试） - "squad": true, // 小队编排（Agent-Squad 引擎）可用 - "entry": "direct", // direct = 现有对话循环；squad = 小队分诊入口（灰度，达标后再改默认） - "rateLimitPerMin": 0, // 租户限流（次/分；0 = 不限） - "redisAddr": "", // 限流共享后端（原生 Redis addr；空 = 进程内） - "verify": true, // 终轮确定性检查与独立验证 - "llmRetries": 2, // 直连模型在尚未输出时的额外重试次数 - "codeOrchestration": false, // 模型用脚本批量调用工具；默认关 + "mock": false, // true = 全部会话走 mock runner（演示/测试） + "squad": true, // 小队编排（Agent-Squad 引擎）可用 + "entry": "direct", // direct = 现有对话循环；squad = 小队分诊入口（灰度，达标后再改默认） + "rateLimitPerMin": 0, // 租户限流（次/分；0 = 不限） + "redisAddr": "", // 限流共享后端（原生 Redis addr；空 = 进程内） + "verify": true, // 终轮确定性检查与独立验证 + "llmRetries": 2, // 直连模型在尚未输出时的额外重试次数 + "codeOrchestration": false, // 模型用脚本批量调用工具；默认关 + "materialIntake": true, // 附件即保证：带附件回合系统确定性启动材料整理后台任务 + "materialIntakeChars": 12000, // 带文字发送时材料总量达到该字符数也预启动（否则回合结束兜底） }, "storage": map[string]any{ "dataDir": "./data", // 启动注入实际值（--data） @@ -99,6 +101,8 @@ func Schema() []core.SettingDesc { {Key: "runtime.codeOrchestration", Group: "runtime", Label: "代码编排", Type: core.SettingBool, Default: false, Effect: core.EffectNewRun, Description: "允许模型用 run_tool_script 写脚本批量调用工具。默认关闭"}, {Key: "runtime.factCheck", Group: "runtime", Label: "终轮事实核查", Type: core.SettingBool, Default: true, Effect: core.EffectNewRun, Description: "交付物里的百分比/日期/大额数字回溯本轮材料，找不到出处的给模型一轮修正（修正过仍失败不拦截，只如实记录）"}, {Key: "runtime.dualSpeedNudgeSeconds", Group: "runtime", Label: "快慢双速提醒阈值（秒）", Type: core.SettingNumber, Default: 75, Effect: core.EffectNewRun, Description: "任务连续运行超过该秒数、用户还没收到任何答复、也没把深度工作放后台时，一次性提醒模型转快慢双速：先把判断/概要/计划回复给用户，重活用 delegate_task 的 background 放后台（SR-B10）。0 = 关闭"}, + {Key: "runtime.materialIntake", Group: "runtime", Label: "附件即材料整理", Type: core.SettingBool, Default: true, Effect: core.EffectNewRun, Description: "带附件的发送由系统确定性启动材料整理后台任务（无文字或大材料立即启动；文字+小材料回合结束兜底），进度卡即时入收件箱。关闭 = 回到模型自行判断"}, + {Key: "runtime.materialIntakeChars", Group: "runtime", Label: "材料预启动阈值（字符）", Type: core.SettingNumber, Default: 12000, Effect: core.EffectNewRun, Description: "带文字发送时，附件解析文本总量达到该字符数也立即预启动材料整理；未达到则模型先答、回合结束兜底"}, {Key: "runtime.verifierSameModel", Group: "runtime", Label: "允许同源验证器", Type: core.SettingBool, Default: false, Effect: core.EffectNewRun, Description: "轻量档未单独配置时，默认跳过与主模型同源的独立验证（硬事实与事实核查仍执行）；显式开启才用主模型做验证"}, {Key: "runtime.composeFinal", Group: "runtime", Label: "终轮整理回复", Type: core.SettingBool, Default: false, Effect: core.EffectNewRun, Description: "用过工具的回合结束后，再用主模型重写一段最终回复。默认关闭（裁定 4：转录权威后工作模型已看到完整证据，重写只见过 160 字摘要、实测会虚构章节与承诺未做之事）；异常收尾时另有兜底"}, {Key: "runtime.intentSemantic", Group: "runtime", Label: "意图语义裁决（慢通道）", Type: core.SettingBool, Default: false, Effect: core.EffectRestart, Description: "规则歧义时用 embedding 语义相似度裁决。需已配置 embedding 端点。默认关闭（行为与 I1 一致）"},