fix(scheduler)!: 撤掉“优先级=可配置策略表”的错误设计,回归内核内部属性

用户指正:**优先级是内核内部属性**,不是配置项,更不该由插件声明。
我此前把它建模成“策略表 + 字符串解析”,甚至准备接配置中心
(core.agent.priority.<channel>)——方向性错误,故整体撤销。

撤销:
- 删除 ParseLevel(字符串解析只服务于“外部可配”这个错误前提)
- 删除 AgentConfig.PriorityLookup / Agent.priorityLookup 及 taskLevel 中的查表分支;
  taskLevel 回归为纯内核内部规则(cli/webui/http→L3,system/_consolidation_→L1,
  其余 L1),注释明确“不对外暴露、不做运维可调项”
- 设计稿 §3.2 改写为“内核内部属性,不做成配置项”,并删除 §15 里
  “ChannelDef.Priority / InjectOptions.Priority 进公开 SDK”这一方向(同属外化)
- 未触碰配置中心(registry.go/main.go 的优先级配置一行未加)

同时落地 D6(与本撤销无关、此前遗漏的承诺):
- AgentConfig.MaxToolTurns + runTaskSteps 在发起新一轮 LLM 前按 f.Turn 收尾;
  0 = 不限;cmd/homed/main.go 从既有 core.agent.max_tool_turns 取值
- 新增 task_test.go 2 项:上限 3 时恰好跑 3 批工具/3 次 LLM 并收尾;
  0 = 不限(跑完脚本)

验收:agent 全量 + -race;全仓 build/vet 通过
This commit is contained in:
JianFeeeee
2026-09-13 06:17:49 +08:00
parent 98d67559d1
commit 8372f5bd8f
6 changed files with 121 additions and 25 deletions

View File

@ -114,8 +114,8 @@ type Agent struct {
// M2 起取代 eventLoop 的隐式 channel 排队。
sched *scheduler
// 优先级策略表(可空);见 AgentConfig.PriorityLookup
priorityLookup func(source, channel string) Level
// 工具轮次硬上限0 = 不限);见 AgentConfig.MaxToolTurns
maxToolTurns int
// 进行中的 LLM 请求取消函数interceptLoop 可调用以在请求中打断
cancelLLM context.CancelFunc
@ -224,9 +224,9 @@ type AgentConfig struct {
InputProcessing types.InputProcessingConfig // 非文本输入处理配置
// PriorityLookup 是内核的优先级策略表(设计文档 §3.2)。
// 返回 L1..L4返回 0 或越界值表示“无策略”,由 Agent 的通道名兜底决定
PriorityLookup func(source, channel string) Level
// MaxToolTurns 是单个任务允许的工具轮次上限0 = 不限)。
// 设计文档 D6主循环必须有硬上限否则模型不停调用就永不完结
MaxToolTurns int
}
func New(cfg AgentConfig) *Agent {
@ -310,7 +310,7 @@ func New(cfg AgentConfig) *Agent {
selfInputCh: make(chan selfInputMsg, 64),
childTasks: make(map[string]*childTaskState),
sched: newScheduler(256),
priorityLookup: cfg.PriorityLookup,
maxToolTurns: cfg.MaxToolTurns,
pluginHealth: newPluginHealthTracker(),
thinkingEnabled: cfg.ThinkingEnabled,
inputCfg: cfg.InputProcessing,

View File

@ -66,6 +66,13 @@ func (l Level) String() string {
}
}
// ParseLevel 已删除。
//
// 为何不保留:优先级是**内核内部属性**,不是配置项——内核预定义四级
// L1 后台 / L2 消息 / L3 交互 / L4 紧急),由内核按内部规则为任务与中断定级。
// 曾一度做成 `core.agent.priority.<channel>` 这种“策略表 + 字符串解析”,
// 那等于把内核的内部属性外化成运维配置,与设计意图相反。
// TaskKind 区分任务来源。
type TaskKind int
@ -471,17 +478,15 @@ func (s *scheduler) currentLevel() Level {
return DefaultLevel
}
// taskLevel 是内核的优先级策略:四级的来源(设计文档 §3.2
// taskLevel 是内核为任务定级的内部规则
//
// 优先走注入的查找函数(配置表);未命中则用通道名兜底:
// cli/webui/http 为人机交互L3system/_consolidation_ 为后台L1
// 其余一律默认级L1。显式才是特权没有策略就不给抢占权
// 优先级是**内核内部属性**,不做成配置项:内核预定义四级,并按内部规则
// 为任务与中断定级。下方规则只是 v1 的内部缺省值——它决定“谁能让位于谁”
// 属于内核自己的隐私,不对外暴露为运维可调项
//
// 缺省cli/webui/http 为人机交互L3system/_consolidation_ 为后台L1
// 其余一律默认级L1
func (a *Agent) taskLevel(source, channel string) Level {
if a.priorityLookup != nil {
if l := a.priorityLookup(source, channel); l >= LevelBackground && l <= LevelCritical {
return l
}
}
switch channel {
case "cli", "webui", "http":
return LevelInteractive

View File

@ -150,6 +150,18 @@ func (a *Agent) runTaskSteps(f *TaskFrame) stepOutcome {
if !a.inCriticalSection() && a.sched.preemptGrantedFor() && a.sched.canSuspend() {
return outcomeSuspended
}
// 工具轮次硬上限(设计文档 D6在发起下一轮 LLM 前收尾。
// f.Turn 只在 stepTurnEnd 递增,所以它等于「已完成的工具批数」;
// 因此这里允许 maxToolTurns 批,而不会多跑第 maxToolTurns+1 轮。
if f.Step == StepLLM && a.maxToolTurns > 0 && f.Turn >= a.maxToolTurns {
log.Printf("[agent] 已达最大工具轮次 %dturn=%d强制收尾", a.maxToolTurns, f.Turn)
if f.Resp != nil && strings.TrimSpace(f.Resp.Content) != "" {
f.Response = f.Resp.Content
} else {
f.Response = fmt.Sprintf("[系统] 已达到最大工具轮次 %d任务中止。", a.maxToolTurns)
}
return outcomeDone
}
switch a.step(f) {
case outcomeDone:
return outcomeDone

View File

@ -165,3 +165,74 @@ func TestTaskFrame_UnknownStepFails(t *testing.T) {
t.Fatal("未知 step 必须带错误信息")
}
}
// D6工具轮次硬上限——模型不停调用工具时必须在有限步内收尾。
//
// 这是审查里定位的 P0core.agent.max_tool_turns 只定义、从没被读过),
// 也是调度器的前提:任务必须可终止。
func TestMaxToolTurns_CapsRunawayLoop(t *testing.T) {
sh := NewStageHost()
sh.RegisterTool("t_loop", sdk.ToolDef{Name: "t_loop", Plugin: "t"}, func(args map[string]interface{}) (interface{}, error) {
return "again", nil
})
// 脚本远长于上限provider 每轮都给下一批工具调用,模拟“永不停止”。
script := make([]*agentAPI.CompletionResponse, 0, 20)
for i := 0; i < 20; i++ {
script = append(script, &agentAPI.CompletionResponse{
Content: "继续",
ToolCalls: []agentAPI.ToolCall{tc("c1", "t_loop")},
})
}
sp := &scriptProvider{script: script}
a := New(AgentConfig{
ID: "cap",
Provider: sp,
ProviderManager: agentAPI.NewProviderManager(),
IO: agentIO.NewIOManager(),
StageHost: sh,
MaxToolTurns: 3,
})
resp, toolsUsed, toolResults, err := a.process("循环", a.stageCtxFromInput("循环", "", ""))
if err != nil {
t.Fatalf("process 返回错误: %v", err)
}
if len(toolsUsed) != 3 || len(toolResults) != 3 {
t.Fatalf("工具批=%d/%d期望恰好 3到上限即止不多跑第 4 轮)", len(toolsUsed), len(toolResults))
}
if len(sp.reqs) != 3 {
t.Fatalf("LLM 调用=%d期望 3上限后不再发起新请求", len(sp.reqs))
}
if resp != "继续" {
t.Fatalf("响应=%q期望返回最近一次 LLM 文本", resp)
}
}
// 上限为 0 表示不限(显式退出机制)。
func TestMaxToolTurns_ZeroMeansUnlimited(t *testing.T) {
sh := NewStageHost()
sh.RegisterTool("t_loop", sdk.ToolDef{Name: "t_loop", Plugin: "t"}, func(args map[string]interface{}) (interface{}, error) {
return "again", nil
})
sp := &scriptProvider{script: []*agentAPI.CompletionResponse{
{Content: "a", ToolCalls: []agentAPI.ToolCall{tc("c1", "t_loop")}},
{Content: "b", ToolCalls: []agentAPI.ToolCall{tc("c2", "t_loop")}},
{Content: "c"},
}}
a := New(AgentConfig{
ID: "nocap",
Provider: sp,
ProviderManager: agentAPI.NewProviderManager(),
IO: agentIO.NewIOManager(),
StageHost: sh,
MaxToolTurns: 0,
})
resp, toolsUsed, _, err := a.process("x", a.stageCtxFromInput("x", "", ""))
if err != nil {
t.Fatalf("process 返回错误: %v", err)
}
if len(toolsUsed) != 2 || resp != "c" {
t.Fatalf("不限时应跑完脚本tools=%d resp=%q", len(toolsUsed), resp)
}
}