refactor(ai): simplify runtime and RAG/tools integration and add unit tests (#1433)

* [refactor(runtime)] redesign component registry and loading

* [fix(config)] apply defaults for composite schemas

* [fix(server)] bind default host to all interfaces

* [docs(paths)] normalize local project references

* [chore(repo)] clean local workflow artifacts

* [refactor(rag)]modularize subcomponents and option pipeline

* [refactor(tools)]bind tool managers to runtime components

* [feat(models)]register actions and refresh default embeddings

* [feat(agent)]simplify react stages and align prompt contracts

* [docs(ai)]refresh readme/proposals/todo/checklist assets

* [docs(ai)] delete redundant docs and link wiki website

Author: stringl1l1l1l

ai/.gitignore

@@ -6,4 +6,10 @@
 .env
 
 reference
-.qoder
+.qoder
+AGENTS.md
+# Temporary ignore for vibe-coding docs
+.claude/
+.spec-workflow/
+.commenting-guidelines.md
+CLAUDE.md

ai/README.md

@@ -1,30 +1,5 @@
-# dubbo-admin-ai
-## Introduction
+# Dubbo Admin AI
 
-This project is an intelligent agent's server for dubbo-admin.
+Dubbo Admin AI 是面向 Dubbo Admin 场景的智能运维服务模块，用于通过 AI 对话辅助排障、分析与治理决策。
 
-
-## Startup
-1. Set your API Keys in the `.env` file or set them as environment variables
-```shell
-# .env_example
-PINECONE_API_KEY=your_pinecone_api_key
-DASHSCOPE_API_KEY=your_dashscope_api_key
-COHERE_API_KEY=your_cohere_api_key
-SILICONFLOW_API_KEY=your_siliconflow_api_key
-GEMINI_API_KEY=your_gemini_api_key
-```
-
-2. Run the server
-```shell
-go run main.go --mode dev --env your_env_file_path --port 8888
-```
-
-## Build and Run
-```shell
-mkdir build
-cd build
-go build -o dubbo-admin-ai ../
-
-./dubbo-admin-ai --mode prod --env your_env_file_path --port 8888
-```
+项目 wiki: https://stringl1l1l1l.github.io/dubbo-admin-ai-wiki/

ai/TEST_CHECKLIST_V7.md

@@ -4,6 +4,7 @@ import (
 	"context"
 	compRag "dubbo-admin-ai/component/rag"
 	appconfig "dubbo-admin-ai/config"
+	"dubbo-admin-ai/runtime"
 	"flag"
 	"fmt"
 	"log"
@@ -17,6 +18,7 @@ import (
 	"github.com/firebase/genkit/go/plugins/googlegenai"
 	"github.com/firebase/genkit/go/plugins/pinecone"
 	"github.com/openai/openai-go/option"
+	"gopkg.in/yaml.v3"
 )
 
 type IndexCommand struct {
@@ -116,7 +118,7 @@ func executeIndexing(cmd *IndexCommand) error {
 	// Build-time target index selection: default to directory name for this CLI
 	targetIndex := getNamespace("", cmd.Directory)
 
-	sys, err := compRag.BuildRAGFromSpec(ctx, g, cfg)
+	sys, err := buildRAGSystem(g, cfg)
 	if err != nil {
 		return fmt.Errorf("failed to build RAG system: %w", err)
 	}
@@ -175,3 +177,41 @@ func loadRAGConfig(configPath string) (*compRag.RAGSpec, error) {
 
 	return &cfg, nil
 }
+
+func buildRAGSystem(g *genkit.Genkit, cfg *compRag.RAGSpec) (*compRag.RAG, error) {
+	if g == nil {
+		return nil, fmt.Errorf("genkit registry is nil")
+	}
+	if cfg == nil {
+		return nil, fmt.Errorf("rag config is nil")
+	}
+
+	var specNode yaml.Node
+	if err := specNode.Encode(cfg); err != nil {
+		return nil, fmt.Errorf("failed to encode rag config: %w", err)
+	}
+
+	compRaw, err := compRag.RAGFactory(&specNode)
+	if err != nil {
+		return nil, fmt.Errorf("failed to create rag component: %w", err)
+	}
+
+	ragComp, ok := compRaw.(*compRag.RAGComponent)
+	if !ok {
+		return nil, fmt.Errorf("invalid rag component type: %T", compRaw)
+	}
+
+	rt := runtime.NewRuntime()
+	rt.SetGenkitRegistry(g)
+	if err := ragComp.Validate(); err != nil {
+		return nil, fmt.Errorf("failed to validate rag component: %w", err)
+	}
+	if err := ragComp.Init(rt); err != nil {
+		return nil, fmt.Errorf("failed to init rag component: %w", err)
+	}
+	if ragComp.Rag == nil {
+		return nil, fmt.Errorf("rag system is not initialized")
+	}
+
+	return ragComp.Rag, nil
+}