组合默认执行组件

五个默认组件

没有传入组合配方时，会话使用 system + tools + budget + compact + infer。

列表顺序是装配顺序，不表示“先执行 system，再执行 tools”。组件先根据日志计算状态，运行时再从当前可执行的动作中选择下一步。

配置一个会话

下面的例子保留五个默认组件，设置 12 次工具调用预算、历史长度阈值和模型尝试次数。它只配置执行方式；模型连接和工作区权限仍由你的 Agent 配置提供。

use aster_core::{Agent, HarnessComposeOptions, SessionOptions};

async fn run(agent: &Agent) -> anyhow::Result<()> {
    let mut harness = HarnessComposeOptions::compose(
        ["system", "tools", "budget", "compact", "infer"]
            .map(str::to_owned)
            .to_vec(),
        Some(12),
        Some(120_000),
        vec!["修改代码后，运行项目已有的测试并解释结果。".into()],
    )?;
    harness.step_limit = Some(96);
    harness.model_attempts = Some(2);

    let options = SessionOptions::new().with_harness(harness);
    let session = agent.session_async("/my-project", Some(options)).await?;
    session.send("修复失败的测试", None).await?;
    Ok(())
}

每个参数限制什么

工具调用次数、工具轮次和状态转换次数是不同的计数。压缩、请求模型和处理确认都可能消耗状态转换次数，因此 step_limit 不能简单当作工具次数使用。

model_attempts 限制的是 Harness 层对一次模型推理的尝试次数。供应商客户端内部的网络重试另有策略，不能把这个数字直接当作 HTTP 请求总数。

tool_budget: None 表示继承，不表示主动取消原有上限。费用和总执行时间也不由这个字段控制；宿主配额通过 with_budget_guard 等会话接口接入。

在当前事实执行路径中，基础会话的 with_max_tool_rounds(0) 不派生轮次和状态转换次数上限；配方里显式给出的上限仍然有效。低层组装器也可以调用 HarnessConfig::without_count_limits()，一起清除工具次数、工具轮次和状态转换次数上限。它不会取消权限检查或其他执行策略。

长度压缩与 token 压缩

compact_after_chars 虽然名字含有 chars，当前调度器按 Rust 字符串长度累计，也就是 UTF-8 字节数。中文内容不能按“一个字等于一个单位”估算这个阈值。

会话还提供 with_auto_compact、with_auto_compact_threshold 和 with_max_context_tokens。低层 HarnessConfig::with_token_compact 则使用模型报告的输入 token 数，并保留一段最近历史。

采用 token 压缩时，字符阈值不会同时触发。同一个组合覆盖基础配置时，如果显式改变 compact_after_chars，就会改用相应的长度阈值；未改变它时，原来的 token 压缩设置会保留。

token 压缩依赖模型适配器报告输入 token 数。接入自定义模型时，需要确认它确实提供这个数据，不能只设置阈值就认为压缩一定会触发。

ACP 可以选择哪些组合

当前 ACP 的 _meta.asterHarness.components 只接受以下精确列表：

system, tools, budget, compact, infer
system, tools, budget, infer
system, tools, host:intent_stamp, budget, compact, infer

未提供这个字段时使用第一套。换顺序、添加未知组件或提交其他列表都会被拒绝。intent_stamp 是用于验证宿主组件接入的内置标记，不是通用业务插件。

实现依据

• 配方解析、覆盖和默认值
• 调度器的预算与压缩设置
• 会话默认的状态转换上限
• ACP 接受的三套组合