harness - 配置参考

HarnessEngine 的配置示例：

HarnessEngine engine = HarnessEngine.of("work", ".soloncode/")
     .systemPrompt("你是一个 AI 助手")
     .sessionWindowSize(12)
     .compressionThreshold(100, 0.75D)
     .toolsAdd(ToolName.TOOL_ALL_FULL) // 设定工具权限
     .build();

可选配置：

1、核心配置项

models 模型配置参考：《模型配置与请求选项》

2、安全与行为配置

3、扩展配置

附录、工具权限配置选择（tools）

附录、运行时动态修改

HarnessEngine 构建完成后，仍可在运行时动态调整工具权限与模型（变更后会自动重建主代理，使其立即生效）。

• 动态调整工具权限

engine.allowTool("websearch"); // 动态授权一个工具
engine.disallowTool("bash"); // 动态禁用一个工具

engine.allowToolReset(Arrays.asList("read", "write", "edit")); // 仅重置白名单（allowedTools）
engine.disallowToolReset(Arrays.asList("bash")); // 仅重置黑名单（disallowedTools）
engine.toolPermissionReset(Arrays.asList("read", "write"), Arrays.asList("bash")); // 同时重置白/黑名单（避免两次重建）

三种重置方法的区别：

• allowToolReset(tools) — 仅重置白名单（allowedTools），黑名单不变；
• disallowToolReset(tools) — 仅重置黑名单（disallowedTools），白名单不变；
• toolPermissionReset(tools, disallowedTools) — 同时重置白/黑名单，触发一次主代理重建，比分别调用前两者更高效。

• 动态管理模型

engine.addModel(new ChatConfig().then(c -> {
 c.setApiUrl("https://api.deepseek.com");
 c.setApiKey("sk-***");
 c.setModel("deepseek-v4-flash");
})); // 添加模型

engine.setDefaultModel("deepseek-v4-flash"); // 设定默认模型（影响主代理时自动刷新）
engine.removeModel("deepseek-v4-flash"); // 移除模型

• 其它运行时配置

engine.setMaxTurns(30);
engine.setSessionWindowSize(12);
engine.setCompressionThreshold(100, 0.75D);
engine.setSandboxEnabled(true);
engine.setHitlEnabled(false);
engine.setSubagentEnabled(true);
engine.setMemoryEnabled(true);
engine.setCacheControl(CacheControl.of(...));
engine.setSystemPrompt("新的系统提示词");

// 上述两项只更新 Harness 配置；主代理已经创建时需显式刷新后才会生效
engine.refreshMainAgent();

• 动态管理扩展

engine.addExtension((engineRef, agentName, agentBuilder) -> {
    // 自定义拦截器或工具注入
});
engine.removeExtension(extension); // 移除扩展（触发主代理重建）

• 动态管理服务器与挂载点

// 动态添加 MCP 服务
engine.addMcpServer("my-mcp", mcpServerParameters);
engine.refreshMcpServer("my-mcp");
engine.removeMcpServer("my-mcp");

// 动态添加 OpenAPI 服务
engine.addApiServer(apiSource);
engine.refreshApiServer(docUrl);
engine.removeApiServer(docUrl);

// 动态添加 LSP 服务
engine.addLspServer("my-lsp", lspServerParameters);
engine.removeLspServer("my-lsp");

// 挂载点管理
engine.addMount(mountDir);
engine.removeMount("@alias");
engine.refreshMount(null);  // null 表示刷新所有