مُشَارِكَات Go لـ Ollama: مقارنة SDK و أمثلة Qwen3/GPT-OSS

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
	"time"
)

// ---- أنواع واجهة المحادثة ----

type ChatMessage struct {
	Role    string `json:"role"`
	Content string `json:"content"`
}

type ChatRequest struct {
	Model    string        `json:"model"`
	Messages []ChatMessage `json:"messages"`
	// بعض الخوادم تُعرض التحكم في التفكير كعلم boolean.
	// حتى لو تم تجاهله، يمكنك لا تزال التحكم في Qwen3 عبر /think أو /no_think.
	Think   *bool          `json:"think,omitempty"`
	Stream  *bool          `json:"stream,omitempty"`
	Options map[string]any `json:"options,omitempty"`
}

type ChatResponse struct {
	Model     string `json:"model"`
	CreatedAt string `json:"created_at"`
	Message   struct {
		Role     string `json:"role"`
		Content  string `json:"content"`
		Thinking string `json:"thinking,omitempty"` // موجود عند تمكين التفكير
	} `json:"message"`
	Done bool `json:"done"`
}

// ---- أنواع واجهة الإنتاج ----

type GenerateRequest struct {
	Model   string         `json:"model"`
	Prompt  string         `json:"prompt"`
	Think   *bool          `json:"think,omitempty"`
	Stream  *bool          `json:"stream,omitempty"`
	Options map[string]any `json:"options,omitempty"`
}

type GenerateResponse struct {
	Model     string `json:"model"`
	CreatedAt string `json:"created_at"`
	Response  string `json:"response"`           // النص النهائي لغير التدفق
	Thinking  string `json:"thinking,omitempty"` // موجود عند تمكين التفكير
	Done      bool   `json:"done"`
}

// ---- وظائف مساعدة ----

func httpPostJSON(url string, payload any) ([]byte, error) {
	body, err := json.Marshal(payload)
	if err != nil {
		return nil, err
	}
	c := &http.Client{Timeout: 60 * time.Second}
	resp, err := c.Post(url, "application/json", bytes.NewReader(body))
	if err != nil {
		return nil, err
	}
	defer resp.Body.Close()
	return io.ReadAll(resp.Body)
}

// bptr يعيد مؤشرًا إلى قيمة boolean
func bptr(b bool) *bool { return &b }

func chatQwen3Thinking() error {
	endpoint := "http://localhost:11434/api/chat"

	req := ChatRequest{
		Model:   "qwen3:8b-thinking", // أي :*-thinking تمت سحبها
		Think:   bptr(true),
		Stream:  bptr(false),
		Messages: []ChatMessage{
			{Role: "system", Content: "أنت مساعد دقيق."},
			{Role: "user",   Content: "اذكر التكرار مع مثال قصير بلغة Go."},
		},
	}

	raw, err := httpPostJSON(endpoint, req)
	if err != nil {
		return err
	}
	var out ChatResponse
	if err := json.Unmarshal(raw, &out); err != nil {
		return err
	}
	fmt.Println("🧠 التفكير:\n", out.Message.Thinking)
	fmt.Println("\n💬 الإجابة:\n", out.Message.Content)
	return nil
}

// لتعطيل التفكير في الدور التالي، قم ب:
// (أ) تعيين Think=false، و/أو
// (ب) إضافة "/no_think" إلى آخر رسالة نظامية / مستخدمية (مفتاح تبديل ناعم لـ Qwen3).
// Qwen3 يحترم أحدث تعليمات /think أو /no_think في المحادثات متعددة الدورات.
func chatQwen3NoThinking() error {
	endpoint := "http://localhost:11434/api/chat"

	req := ChatRequest{
		Model:  "qwen3:8b-thinking",
		Think:  bptr(false),
		Stream: bptr(false),
		Messages: []ChatMessage{
			{Role: "system", Content: "أنت مختصر. /no_think"},
			{Role: "user",   Content: "اذكر التكرار في جملة واحدة."},
		},
	}

	raw, err := httpPostJSON(endpoint, req)
	if err != nil {
		return err
	}
	var out ChatResponse
	if err := json.Unmarshal(raw, &out); err != nil {
		return err
	}
	// توقع أن يكون التفكير فارغًا؛ لا تزال التعامل بحذر.
	if out.Message.Thinking != "" {
		fmt.Println("🧠 التفكير (غير متوقع):\n", out.Message.Thinking)
	}
	fmt.Println("\n💬 الإجابة:\n", out.Message.Content)
	return nil
}

func chatGptOss() error {
	endpoint := "http://localhost:11434/api/chat"

	req := ChatRequest{
		Model:  "gpt-oss:20b",
		Think:  bptr(true),   // طلب فصل الاستنتاج إذا كان مدعومًا
		Stream: bptr(false),
		Messages: []ChatMessage{
			{Role: "user", Content: "ما هو البرمجة الديناميكية؟ اشرح الفكرة الأساسية."},
		},
	}

	raw, err := httpPostJSON(endpoint, req)
	if err != nil {
		return err
	}
	var out ChatResponse
	if err := json.Unmarshal(raw, &out); err != nil {
		return err
	}
	// عيب معروف: تعطيل التفكير قد لا يثبط الاستنتاج تمامًا على gpt-oss:20b.
	// تأكد دائمًا من تصفية / إخفاء التفكير في الواجهة إذا كنت لا ترغب في عرضه.
	fmt.Println("🧠 التفكير:\n", out.Message.Thinking)
	fmt.Println("\n💬 الإجابة:\n", out.Message.Content)
	return nil
}

func generateQwen3() error {
	endpoint := "http://localhost:11434/api/generate"
	req := GenerateRequest{
		Model:  "qwen3:4b-thinking",
		Prompt: "في 2–3 جمل، ما هي استخدامات B-Trees في قواعد البيانات؟",
		Think:  bptr(true),
	}
	raw, err := httpPostJSON(endpoint, req)
	if err != nil {
		return err
	}
	var out GenerateResponse
	if err := json.Unmarshal(raw, &out); err != nil {
		return err
	}
	if out.Thinking != "" {
		fmt.Println("🧠 التفكير:\n", out.Thinking)
	}
	fmt.Println("\n💬 الإجابة:\n", out.Response)
	return nil
}

func generateGptOss() error {
	endpoint := "http://localhost:11434/api/generate"
	req := GenerateRequest{
		Model:  "gpt-oss:20b",
		Prompt: "اذكر خوارزمية الانتشار العكسي في الشبكات العصبية بشكل مختصر.",
		Think:  bptr(true),
	}
	raw, err := httpPostJSON(endpoint, req)
	if err != nil {
		return err
	}
	var out GenerateResponse
	if err := json.Unmarshal(raw, &out); err != nil {
		return err
	}
	if out.Thinking != "" {
		fmt.Println("🧠 التفكير:\n", out.Thinking)
	}
	fmt.Println("\n💬 الإجابة:\n", out.Response)
	return nil
}

go get github.com/ollama/ollama/api

package main

import (
	"context"
	"fmt"
	"log"

	"github.com/ollama/ollama/api"
)

func chatWithQwen3Thinking(ctx context.Context, thinking bool) error {
	client, err := api.ClientFromEnvironment() // يحترم OLLAMA_HOST إذا تم تعيينه
	if err != nil {
		return err
	}

	req := &api.ChatRequest{
		Model: "qwen3:8b-thinking",
		// العديد من إصدارات الخادم تُعرض التفكير كعلم رئيسي؛
		// بالإضافة إلى ذلك، يمكنك التحكم في Qwen3 عبر /think أو /no_think في الرسائل.
		Think: api.Ptr(thinking),
		Messages: []api.Message{
			{Role: "system", Content: "أنت مساعد دقيق."},
			{Role: "user",   Content: "اذكر ترتيب الدمج مع مقتطف Go قصير."},
		},
	}

	var resp api.ChatResponse
	if err := client.Chat(ctx, req, &resp); err != nil {
		return err
	}

	if resp.Message.Thinking != "" {
		fmt.Println("🧠 التفكير:\n", resp.Message.Thinking)
	}
	fmt.Println("\n💬 الإجابة:\n", resp.Message.Content)
	return nil
}

func main() {
	ctx := context.Background()
	if err := chatWithQwen3Thinking(ctx, true); err != nil {
		log.Fatal(err)
	}
	// مثال: غير التفكير
	if err := chatWithQwen3Thinking(ctx, false); err != nil {
		log.Fatal(err)
	}
}

func chatWithGptOss(ctx context.Context) error {
	client, err := api.ClientFromEnvironment()
	if err != nil {
		return err
	}
	req := &api.ChatRequest{
		Model: "gpt-oss:20b",
		Think: api.Ptr(true),
		Messages: []api.Message{
			{Role: "user", Content: "ما هو التخزين المؤقت وماذا يفيد؟"},
		},
	}
	var resp api.ChatResponse
	if err := client.Chat(ctx, req, &resp); err != nil {
		return err
	}
	// إذا كنت تخطط ل隱藏 الاستنتاج، فافعل ذلك هنا بغض النظر عن الأعلام.
	if resp.Message.Thinking != "" {
		fmt.Println("🧠 التفكير:\n", resp.Message.Thinking)
	}
	fmt.Println("\n💬 الإجابة:\n", resp.Message.Content)
	return nil
}

func generateWithQwen3(ctx context.Context) error {
	client, err := api.ClientFromEnvironment()
	if err != nil {
		return err
	}
	req := &api.GenerateRequest{
		Model:  "qwen3:4b-thinking",
		Prompt: "ملخص دور شجرة B في الفهرسة.",
		Think:  api.Ptr(true),
	}
	var resp api.GenerateResponse
	if err := client.Generate(ctx, req, &resp); err != nil {
		return err
	}
	if resp.Thinking != "" {
		fmt.Println("🧠 التفكير:\n", resp.Thinking)
	}
	fmt.Println("\n💬 الإجابة:\n", resp.Response)
	return nil
}

func generateWithGptOss(ctx context.Context) error {
	client, err := api.ClientFromEnvironment()
	if err != nil {
		return err
	}
	req := &api.GenerateRequest{
		Model:  "gpt-oss:20b",
		Prompt: "اذكر خوارزمية النزول التدرج في شبكات عصبية بشكل مبسط.",
		Think:  api.Ptr(true),
	}
	var resp api.GenerateResponse
	if err := client.Generate(ctx, req, &resp); err != nil {
		return err
	}
	if resp.Thinking != "" {
		fmt.Println("🧠 التفكير:\n", resp.Thinking)
	}
	fmt.Println("\n💬 الإجابة:\n", resp.Response)
	return nil
}

func streamChatExample() error {
	endpoint := "http://localhost:11434/api/chat"
	req := ChatRequest{
		Model:  "qwen3:8b-thinking",
		Think:  bptr(true),
		Stream: bptr(true), // تفعيل التدفق
		Messages: []ChatMessage{
			{Role: "user", Content: "اذكر خوارزمية الترتيب السريع خطوة بخطوة."},
		},
	}

	body, _ := json.Marshal(req)
	resp, err := http.Post(endpoint, "application/json", bytes.NewReader(body))
	if err != nil {
		return err
	}
	defer resp.Body.Close()

	decoder := json.NewDecoder(resp.Body)
	for {
		var chunk ChatResponse
		if err := decoder.Decode(&chunk); err == io.EOF {
			break
		} else if err != nil {
			return err
		}
		
		// معالجة التفكير والمحتوى عند وصولها
		if chunk.Message.Thinking != "" {
			fmt.Print(chunk.Message.Thinking)
		}
		fmt.Print(chunk.Message.Content)
		
		if chunk.Done {
			break
		}
	}
	return nil
}

func streamWithOfficialSDK(ctx context.Context) error {
	client, _ := api.ClientFromEnvironment()
	
	req := &api.ChatRequest{
		Model: "qwen3:8b-thinking",
		Think: api.Ptr(true),
		Messages: []api.Message{
			{Role: "user", Content: "اذكر شجرة البحث الثنائية."},
		},
	}
	
	err := client.Chat(ctx, req, func(resp api.ChatResponse) error {
		if resp.Message.Thinking != "" {
			fmt.Print(resp.Message.Thinking)
		}
		fmt.Print(resp.Message.Content)
		return nil
	})
	
	return err
}

func robustChatRequest(ctx context.Context, model string, messages []api.Message) (*api.ChatResponse, error) {
	// ضع وقتًا معقولًا
	ctx, cancel := context.WithTimeout(ctx, 2*time.Minute)
	defer cancel()
	
	client, err := api.ClientFromEnvironment()
	if err != nil {
		return nil, fmt.Errorf("إنشاء العميل: %w", err)
	}
	
	req := &api.ChatRequest{
		Model:    model,
		Messages: messages,
		Options: map[string]interface{}{
			"temperature": 0.7,
			"num_ctx":     4096, // حجم نافذة السياق
		},
	}
	
	var resp api.ChatResponse
	if err := client.Chat(ctx, req, &resp); err != nil {
		return nil, fmt.Errorf("فشل طلب المحادثة: %w", err)
	}
	
	return &resp, nil
}

type OllamaService struct {
	client *api.Client
}

func NewOllamaService() (*OllamaService, error) {
	client, err := api.ClientFromEnvironment()
	if err != nil {
		return nil, err
	}
	return &OllamaService{client: client}, nil
}

func (s *OllamaService) Chat(ctx context.Context, req *api.ChatRequest) (*api.ChatResponse, error) {
	var resp api.ChatResponse
	if err := s.client.Chat(ctx, req, &resp); err != nil {
		return nil, err
	}
	return &resp, nil
}

export OLLAMA_HOST=http://localhost:11434
export OLLAMA_NUM_PARALLEL=2
export OLLAMA_MAX_LOADED_MODELS=2

func loggedChat(ctx context.Context, logger *log.Logger, req *api.ChatRequest) error {
	start := time.Now()
	client, _ := api.ClientFromEnvironment()
	
	var resp api.ChatResponse
	err := client.Chat(ctx, req, &resp)
	
	duration := time.Since(start)
	logger.Printf("model=%s duration=%v error=%v tokens=%d", 
		req.Model, duration, err, len(resp.Message.Content))
	
	return err
}