Method Initialize

pkg/agent/tool_manager.go:51–100

Initialize 初始化工具管理器 将所有工具添加到索引，并根据配置决定哪些工具活跃

(toolNames []string, activeByDefault bool)

// Initialize 初始化工具管理器
// 将所有工具添加到索引，并根据配置决定哪些工具活跃
func (tm *ToolManager) Initialize(toolNames []string, activeByDefault bool) error {
	tm.mu.Lock()
	defer tm.mu.Unlock()

	ctx := context.Background() // 用于日志记录

	for _, name := range toolNames {
		tool, err := tm.registry.Create(name, nil)
		if err != nil {
			toolMgrLog.Warn(ctx, "failed to create tool", map[string]any{"name": name, "error": err})
			continue
		}

		// 检查是否是核心工具（始终活跃）
		isCore := tm.isCoreToolLocked(name)

		// 决定是否活跃
		isActive := activeByDefault || isCore

		// 检查是否实现了 DeferrableTool 接口
		if deferrable, ok := tool.(tools.DeferrableTool); ok {
			config := deferrable.DeferConfig()
			if config != nil && config.DeferLoading && !isCore {
				isActive = false
			}
		}

		// 添加到索引
		source := "builtin"
		if err := tm.index.IndexTool(tool, source, !isActive); err != nil {
			toolMgrLog.Warn(ctx, "failed to index tool", map[string]any{"name": name, "error": err})
			continue
		}

		if isActive {
			tm.activeTools[name] = tool
			toolMgrLog.Debug(ctx, "tool loaded (active)", map[string]any{"name": name})
		} else {
			entry := tm.index.GetTool(name)
			if entry != nil {
				tm.deferredTools[name] = *entry
				toolMgrLog.Debug(ctx, "tool indexed (deferred)", map[string]any{"name": name})
			}
		}
	}

	toolMgrLog.Info(ctx, "initialized", map[string]any{"active_tools": len(tm.activeTools), "deferred_tools": len(tm.deferredTools)})

	return nil
}

// isCoreToolLocked 检查是否是核心工具（需要持有锁）
func (tm *ToolManager) isCoreToolLocked(name string) bool {