@dxtmisha/wiki 0.25.1 → 0.39.2

package/src/media/functional/scripts/classes/AiDocType/AiDocType.vi.mdx

@@ -0,0 +1,49 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/AiDocType - Trình Quản lý Loại Tài liệu AI'/>
+
+# Lớp AiDocType
+
+Một lớp quản lý đóng vai trò như một kho đăng ký và trình lựa chọn cho các loại tài liệu khác nhau. Nó xác định trình xử lý tài liệu chuyên biệt nào (ví dụ: cho lớp, hàm hoặc composable) sẽ được sử dụng cho một tệp nhất định dựa trên các đặc điểm của tệp đó.
+
+## Tính năng chính
+
+- **Đăng ký Động** — cho phép thêm các loại tài liệu mới vào hệ thống trong thời gian chạy.
+- **Lựa chọn Thông minh** — tự động xác định trình xử lý tài liệu chính xác cho tệp bằng cách lặp qua các loại đã đăng ký và thực thi logic kiểm tra của chúng.
+- **Ủy quyền** — điều phối việc khởi tạo và thực thi các trình xử lý tài liệu chuyên biệt (các triển khai của `AiDocItemAbstract`).
+- **API Tĩnh** — cung cấp một giao diện tĩnh thuận tiện cho việc quản lý tài liệu toàn cầu mà không cần khởi tạo đối tượng.
+
+## Khởi tạo
+
+`AiDocType` được thiết kế để sử dụng thông qua các phương thức tĩnh. Không cần khởi tạo.
+
+```typescript
+import { AiDocType } from '@dxtmisha/scripts'
+
+// Công cụ sử dụng lớp này nội bộ để xử lý các mục tệp:
+await AiDocType.make(gitFileItem)
+```
+
+## Phương thức
+
+### Quản lý Tài liệu
+
+- `make(item: GitFileItem): Promise<void>` — (Tĩnh) Phân tích mục tệp được cung cấp, chọn loại tài liệu phù hợp và kích hoạt quy trình tạo.
+
+### Kiểm soát Kho đăng ký
+
+- `add(type: AiDocTypeItem): void` — (Tĩnh) Đăng ký một loại tài liệu mới vào đầu danh sách ưu tiên.
+
+## Các kiểu dữ liệu
+
+### AiDocTypeItem
+Cấu hình cho trình xử lý loại tài liệu.
+- `check: (item: GitFileItem) => boolean` — hàm xác định xem trình xử lý này có phù hợp với tệp hay không.
+- `item: new (path: string, item: GitFileItem) => AiDocItemAbstract` — hàm khởi tạo lớp xử lý.
+
+### GitFileItem
+Đại diện cho thông tin tệp được quản lý bởi Git.
+- `path: string` — Đường dẫn tương đối đến tệp.
+- `pathByOS: string` — Đường dẫn tuyệt đối đặc thù của hệ điều hành.
+- `date: string` — Ngày sửa đổi cuối cùng.
+- `item: any` — Dành riêng cho siêu dữ liệu bổ sung.

package/src/media/functional/scripts/classes/AiGoogle/AiGoogle.en.mdx

@@ -0,0 +1,60 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/AiGoogle - Auto-configured Google Gemini AI'/>
+
+# AiGoogle Class
+
+A high-level implementation of the Google Gemini AI integration. The `AiGoogle` class extends `AiGoogleLite` and automatically initializes itself with the API key and model ID specified in the project's configuration files.
+
+## Key Features
+
+- **Zero-config Initialization** — automatically loads API credentials and model settings from the project environment.
+- **Gemini Powered** — provides access to Google's state-of-the-art generative models.
+- **Inherited Robustness** — includes all features from `AiGoogleLite`, such as multimodal support (text + images) and complex prompt accumulation.
+- **Simplified Workflow** — ideal for use within the project's documentation engine where manual configuration is not needed.
+
+## Initialization
+
+Unlike `AiGoogleLite`, the `AiGoogle` class does not require constructor parameters as it pulls settings from `getConfigAi()`.
+
+```typescript
+import { AiGoogle } from '@dxtmisha/scripts'
+
+const ai = new AiGoogle()
+
+// Optionally override the model if needed
+ai.setModel('gemini-1.5-pro')
+
+// Generate a response
+const response = await ai.generate('Generate a brief description of the project.')
+```
+
+## Methods
+
+### Generation
+
+- `generate(contents: string): Promise<string>` — (Inherited) Combines accumulated context and performs the AI generation request.
+
+### Configuration
+
+- `setKey(key: string): this` — (Inherited) Updates the API key and re-initializes the internal client.
+- `setModel(model: string): this` — (Inherited) Switches the active model.
+
+### Context Building
+
+- `addPrompt(prompt: string): void` — (Inherited) Appends a persistent text prefix.
+- `addContent(content: string): this` — (Inherited) Adds a text part to the prompt.
+- `addImage(image: AiImageItem): this` — (Inherited) Appends an image (base64) to the request.
+- `resetPrompt(): void` — (Inherited) Clears the persistent prefix.
+- `resetContents(): this` — (Inherited) Clears accumulated text parts.
+- `resetImages(): this` — (Inherited) Clears accumulated images.
+
+## Types
+
+### AiImageItem
+Represents an image for multimodal requests.
+- `mime: string` — the MIME type of the image.
+- `base64: string` — the image data in base64 format.
+
+### AiImageList
+An array of `AiImageItem`.

package/src/media/functional/scripts/classes/AiGoogle/AiGoogle.ru.mdx

@@ -0,0 +1,60 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Classes/AiGoogle - Автоконфигурируемый Google Gemini AI'/>
+
+# Класс AiGoogle
+
+Высокоуровневая реализация интеграции с Google Gemini AI. Класс `AiGoogle` расширяет `AiGoogleLite` и автоматически инициализирует себя, используя API-ключ и идентификатор модели, указанные в файлах конфигурации проекта.
+
+## Ключевые особенности
+
+- **Инициализация без конфигурации** — автоматически загружает учетные данные API и настройки модели из окружения проекта.
+- **На базе Gemini** — предоставляет доступ к современным генеративным моделям от Google.
+- **Наследуемая надежность** — включает все функции `AiGoogleLite`, такие как мультимодальная поддержка (текст + изображения) и накопление сложных промптов.
+- **Упрощенный процесс** — идеально подходит для использования внутри движка документирования проекта, где не требуется ручная настройка.
+
+## Инициализация
+
+В отличие от `AiGoogleLite`, класс `AiGoogle` не требует параметров конструктора, так как он получает настройки из `getConfigAi()`.
+
+```typescript
+import { AiGoogle } from '@dxtmisha/scripts'
+
+const ai = new AiGoogle()
+
+// При необходимости можно переключить модель
+ai.setModel('gemini-1.5-pro')
+
+// Генерация ответа
+const response = await ai.generate('Создайте краткое описание проекта.')
+```
+
+## Методы
+
+### Генерация
+
+- `generate(contents: string): Promise<string>` — (Унаследовано) Объединяет накопленный контекст и выполняет запрос к ИИ.
+
+### Конфигурация
+
+- `setKey(key: string): this` — (Унаследовано) Обновляет API-ключ и переинициализирует внутренний клиент.
+- `setModel(model: string): this` — (Унаследовано) Переключает активную модель.
+
+### Сбор контекста
+
+- `addPrompt(prompt: string): void` — (Унаследовано) Добавляет постоянный текстовый префикс.
+- `addContent(content: string): this` — (Унаследовано) Добавляет текстовую часть к промпту.
+- `addImage(image: AiImageItem): this` — (Унаследовано) Добавляет изображение (base64) к запросу.
+- `resetPrompt(): void` — (Унаследовано) Очищает постоянный префикс.
+- `resetContents(): this` — (Унаследовано) Очищает все накопленные части текста.
+- `resetImages(): this` — (Унаследовано) Очищает все накопленные изображения.
+
+## Типы
+
+### AiImageItem
+Представляет изображение для мультимодальных запросов.
+- `mime: string` — MIME-тип изображения.
+- `base64: string` — данные изображения в формате base64.
+
+### AiImageList
+Массив элементов `AiImageItem`.

package/src/media/functional/scripts/classes/AiGoogle/AiGoogle.vi.mdx

@@ -0,0 +1,60 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/AiGoogle - Google Gemini AI tự động cấu hình'/>
+
+# Lớp AiGoogle
+
+Một triển khai cấp cao về tích hợp Google Gemini AI. Lớp `AiGoogle` mở rộng từ `AiGoogleLite` và tự động khởi tạo với mã API và ID mô hình được chỉ định trong các tệp cấu hình của dự án.
+
+## Tính năng chính
+
+- **Khởi tạo không cần cấu hình** — tự động tải thông tin xác thực API và cài đặt mô hình từ môi trường dự án.
+- **Sức mạnh từ Gemini** — cung cấp quyền truy cập vào các mô hình tạo nảy tiên tiến nhất của Google.
+- **Độ tin cậy được kế thừa** — bao gồm tất cả các tính năng của `AiGoogleLite`, chẳng hạn như hỗ trợ đa phương thức (văn bản + hình ảnh) và tích lũy các lời nhắc phức tạp.
+- **Quy trình đơn giản hóa** — lý tưởng để sử dụng trong công cụ tài liệu của dự án khi không cần cấu hình thủ công.
+
+## Khởi tạo
+
+Khác với `AiGoogleLite`, lớp `AiGoogle` không yêu cầu tham số hàm khởi tạo vì nó lấy các cài đặt từ `getConfigAi()`.
+
+```typescript
+import { AiGoogle } from '@dxtmisha/scripts'
+
+const ai = new AiGoogle()
+
+// Tùy chọn thay đổi mô hình nếu cần
+ai.setModel('gemini-1.5-pro')
+
+// Tạo phản hồi
+const response = await ai.generate('Tạo một mô tả ngắn gọn về dự án.')
+```
+
+## Phương thức
+
+### Tạo (Generation)
+
+- `generate(contents: string): Promise<string>` — (Kế thừa) Kết hợp ngữ cảnh đã tích lũy và thực hiện yêu cầu tạo AI.
+
+### Cấu hình
+
+- `setKey(key: string): this` — (Kế thừa) Cập nhật mã API và khởi tạo lại ứng dụng khách nội bộ.
+- `setModel(model: string): this` — (Kế thừa) Chuyển đổi mô hình hoạt động.
+
+### Xây dựng Ngữ cảnh
+
+- `addPrompt(prompt: string): void` — (Kế thừa) Thêm tiền tố văn bản cố định.
+- `addContent(content: string): this` — (Kế thừa) Thêm một phần văn bản vào lời nhắc.
+- `addImage(image: AiImageItem): this` — (Kế thừa) Thêm một hình ảnh (base64) vào yêu cầu.
+- `resetPrompt(): void` — (Kế thừa) Xóa tiền tố cố định.
+- `resetContents(): this` — (Kế thừa) Xóa các phần văn bản đã tích lũy.
+- `resetImages(): this` — (Kế thừa) Xóa các hình ảnh đã tích lũy.
+
+## Các kiểu dữ liệu
+
+### AiImageItem
+Đại diện cho một hình ảnh cho các yêu cầu đa phương thức.
+- `mime: string` — loại MIME của hình ảnh.
+- `base64: string` — dữ liệu hình ảnh ở định dạng base64.
+
+### AiImageList
+Một mảng các `AiImageItem`.

package/src/media/functional/scripts/classes/AiGoogleCli/AiGoogleCli.en.mdx

@@ -0,0 +1,52 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/AiGoogleCli - Auto-configured Google Gemini AI via CLI'/>
+
+# AiGoogleCli Class
+
+A high-level implementation for interacting with Google's Gemini AI via a system command-line interface. The `AiGoogleCli` class extends `AiGoogleCliLite` and simplifies the process by automatically loading the required API key and model identifier from the project's configuration settings (`getConfigAi()`).
+
+> This implementation requires the `gemini` CLI utility to be installed and accessible in the system path.
+
+## Key Features
+
+- **Automated Configuration** — no manual initialization of keys or models is needed; it pulls everything from the project environment.
+- **CLI-based Execution** — leverages shell commands to perform AI requests, making it suitable for specific build environments.
+- **Temporary File Management** — handles the creation and cleanup of temporary prompt files (`./ai-tmp`) automatically.
+- **Concise Outputs** — uses optimized CLI flags to ensure the AI returns direct answers without conversational preamble.
+
+## Initialization
+
+The `AiGoogleCli` class is ready to use without any constructor arguments.
+
+```typescript
+import { AiGoogleCli } from '@dxtmisha/scripts'
+
+const ai = new AiGoogleCli()
+
+// Generate a response using project-defined settings
+const response = await ai.generate('Summarize the changes in the project.')
+```
+
+## Methods
+
+### Generation
+
+- `generate(contents: string): Promise<string>` — (Inherited) Analyzes input, manages temporary files, and executes the CLI command to get a response.
+
+### Configuration
+
+- `setKey(key: string): this` — (Inherited) Manually overrides the API key if necessary.
+- `setModel(model: string): this` — (Inherited) Switches to a different model ID.
+
+### Context Building
+
+- `addPrompt(prompt: string): void` — (Inherited) Sets a persistent text prefix for system instructions.
+- `addContent(content: string): this` — (Inherited) Adds a text part to the cumulative request.
+- `resetPrompt(): void` — (Inherited) Clears the persistent prefix.
+- `resetContents(): this` — (Inherited) Clears all accumulated text parts.
+
+## Limitations
+
+- **Multimodal Support** — like its base class, this implementation does not currently support image inputs.
+- **System Dependencies** — requires the `gemini` CLI tool and appropriate file system permissions for temporary data.

package/src/media/functional/scripts/classes/AiGoogleCli/AiGoogleCli.ru.mdx

@@ -0,0 +1,52 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Classes/AiGoogleCli - Автоконфигурируемый Google Gemini AI через CLI'/>
+
+# Класс AiGoogleCli
+
+Высокоуровневая реализация для взаимодействия с ИИ Google Gemini через интерфейс командной строки (CLI) системы. Класс `AiGoogleCli` расширяет `AiGoogleCliLite` и упрощает работу, автоматически загружая необходимые API-ключ и идентификатор модели из настроек конфигурации проекта (`getConfigAi()`).
+
+> Для работы этой реализации требуется установленная утилита `gemini` CLI, доступная в переменной PATH вашей системы.
+
+## Ключевые особенности
+
+- **Автоматическая настройка** — не требует ручной инициализации ключей или моделей; все данные берутся из окружения проекта.
+- **Выполнение через CLI** — использует команды оболочки для выполнения запросов к ИИ, что делает его подходящим для определенных сред сборки.
+- **Управление временными файлами** — автоматически обрабатывает создание и удаление временных файлов промптов (`./ai-tmp`).
+- **Лаконичные ответы** — использует оптимизированные флаги CLI, чтобы ИИ возвращал прямые ответы без лишних вступлений.
+
+## Инициализация
+
+Класс `AiGoogleCli` готов к использованию без каких-либо аргументов конструктора.
+
+```typescript
+import { AiGoogleCli } from '@dxtmisha/scripts'
+
+const ai = new AiGoogleCli()
+
+// Генерация ответа с использованием настроек проекта
+const response = await ai.generate('Опиши изменения в проекте.')
+```
+
+## Методы
+
+### Генерация
+
+- `generate(contents: string): Promise<string>` — (Унаследовано) Анализирует ввод, управляет временными файлами и выполняет команду CLI для получения ответа.
+
+### Конфигурация
+
+- `setKey(key: string): this` — (Унаследовано) Позволяет вручную переопределить API-ключ при необходимости.
+- `setModel(model: string): this` — (Унаследовано) Переключает идентификатор активной модели.
+
+### Сбор контекста
+
+- `addPrompt(prompt: string): void` — (Унаследовано) Устанавливает постоянный текстовый префикс (системные инструкции).
+- `addContent(content: string): this` — (Унаследовано) Добавляет текстовую часть к совокупному запросу.
+- `resetPrompt(): void` — (Унаследовано) Очищает постоянный префикс.
+- `resetContents(): this` — (Унаследовано) Очищает все накопленные части текста.
+
+## Ограничения
+
+- **Мультимодальность** — как и базовый класс, эта реализация в настоящее время не поддерживает ввод изображений.
+- **Системные зависимости** — требуется наличие инструмента `gemini` CLI и соответствующих прав файловой системы для работы с временными данными.

package/src/media/functional/scripts/classes/AiGoogleCli/AiGoogleCli.vi.mdx

@@ -0,0 +1,52 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/AiGoogleCli - Google Gemini AI tự động cấu hình qua CLI'/>
+
+# Lớp AiGoogleCli
+
+Một triển khai cấp cao để tương tác với Google Gemini AI thông qua giao diện dòng lệnh (CLI) của hệ thống. Lớp `AiGoogleCli` mở rộng từ `AiGoogleCliLite` và đơn giản hóa quy trình bằng cách tự động tải mã API và mã định danh mô hình được yêu cầu từ cấu hình của dự án (`getConfigAi()`).
+
+> Triển khai này yêu cầu tiện ích CLI `gemini` phải được cài đặt và có thể truy cập được trong đường dẫn hệ thống.
+
+## Tính năng chính
+
+- **Cấu hình Tự động** — không cần khởi tạo thủ công mã khoá hoặc mô hình; nó lấy mọi thứ từ môi trường dự án.
+- **Thực thi dựa trên CLI** — tận dụng các lệnh shell để thực hiện các yêu cầu AI, phù hợp cho các môi trường xây dựng cụ thể.
+- **Quản lý Tệp Tạm thời** — tự động xử lý việc tạo và dọn dẹp các tệp lời nhắc tạm thời (`./ai-tmp`).
+- **Phản hồi Ngắn gọn** — sử dụng các cờ CLI được tối ưu hóa để đảm bảo AI trả về câu trả lời trực tiếp mà không có phần dẫn dắt rườm rà.
+
+## Khởi tạo
+
+Lớp `AiGoogleCli` đã sẵn sàng để sử dụng mà không cần bất kỳ đối số hàm khởi tạo nào.
+
+```typescript
+import { AiGoogleCli } from '@dxtmisha/scripts'
+
+const ai = new AiGoogleCli()
+
+// Tạo phản hồi bằng các cài đặt được xác định trong dự án
+const response = await ai.generate('Tóm tắt các thay đổi trong dự án.')
+```
+
+## Phương thức
+
+### Tạo (Generation)
+
+- `generate(contents: string): Promise<string>` — (Kế thừa) Phân tích đầu vào, quản lý các tệp tạm thời và thực thi lệnh CLI để lấy phản hồi.
+
+### Cấu hình
+
+- `setKey(key: string): this` — (Kế thừa) Ghi đè mã API thủ công nếu cần thiết.
+- `setModel(model: string): this` — (Kế thừa) Chuyển đổi sang ID mô hình khác.
+
+### Xây dựng Ngữ cảnh
+
+- `addPrompt(prompt: string): void` — (Kế thừa) Thiết lập tiền tố văn bản cố định cho các hướng dẫn hệ thống.
+- `addContent(content: string): this` — (Kế thừa) Thêm một phần văn bản vào yêu cầu tích lũy.
+- `resetPrompt(): void` — (Kế thừa) Xóa tiền tố cố định.
+- `resetContents(): this` — (Kế thừa) Xóa tất cả các phần văn bản đã tích lũy.
+
+## Hạn chế
+
+- **Hỗ trợ Đa phương thức** — giống như lớp cơ sở của nó, triển khai này hiện không hỗ trợ đầu vào hình ảnh.
+- **Phụ thuộc Hệ thống** — yêu cầu công cụ CLI `gemini` và các quyền hệ thống tệp phù hợp cho dữ liệu tạm thời.

package/src/media/functional/scripts/classes/AiGoogleCliLite/AiGoogleCliLite.en.mdx

@@ -0,0 +1,56 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/AiGoogleCliLite - Google Gemini AI via CLI'/>
+
+# AiGoogleCliLite Class
+
+A specialized implementation of the `AiAbstract` class that interacts with Google's Gemini AI using a system command-line interface (CLI). This approach is useful in environments where a direct SDK integration is not preferred or where existing CLI tools are leveraged.
+
+> This implementation requires the `gemini` CLI utility to be installed and accessible in the system path.
+
+## Key Features
+
+- **CLI-driven Workflow** — executes requests by constructing and running shell commands.
+- **Large Prompt Handling** — automatically creates temporary files to pass large prompt contents to the CLI, avoiding command-line length limitations.
+- **Clean Execution** — manages its own temporary storage (`./ai-tmp`) and performs cleanup after each request.
+- **YOLO Mode** — executes commands with strict output flags to ensure results are concise and free of conversational filler.
+
+## Initialization
+
+Initialize `AiGoogleCliLite` with your API key and intended model.
+
+**Parameters:**
+- `key: string` — your Google AI API key (passed to the CLI via environment variables).
+- `model: string` — the model identifier for the Gemini CLI.
+
+```typescript
+import { AiGoogleCliLite } from '@dxtmisha/scripts'
+
+const ai = new AiGoogleCliLite('YOUR_API_KEY', 'gemini-1.5-flash')
+
+// Generate a response
+const response = await ai.generate('Review this code snippet.')
+```
+
+## Methods
+
+### Generation
+
+- `generate(contents: string): Promise<string>` — the primary method for interaction. It compiles the context into temporary files, executes the CLI command, and returns the trimmed output.
+
+### Configuration
+
+- `setKey(key: string): this` — updates the API key for subsequent CLI calls.
+- `setModel(model: string): this` — switches the active model ID.
+
+### Context Building
+
+- `addPrompt(prompt: string): void` — sets a persistent text prefix.
+- `addContent(content: string): this` — adds a text part to the cumulative prompt.
+- `resetPrompt(): void` — clears the persistent prefix.
+- `resetContents(): this` — clears all accumulated text parts.
+
+## Limitations
+
+- **Images** — currently, the CLI implementation does not support image passing (`addImage` will have no effect on the generation).
+- **Environment** — relies on the availability of the `exec` function and the filesystem for temporary storage.

package/src/media/functional/scripts/classes/AiGoogleCliLite/AiGoogleCliLite.ru.mdx

@@ -0,0 +1,56 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/scripts/Classes/AiGoogleCliLite - Google Gemini AI через CLI'/>
+
+# Класс AiGoogleCliLite
+
+Специализированная реализация класса `AiAbstract`, которая взаимодействует с ИИ Google Gemini через интерфейс командной строки (CLI) системы. Этот подход полезен в средах, где прямое использование SDK нежелательно или где используются существующие инструменты CLI.
+
+> Для работы этой реализации требуется установленная утилита `gemini` CLI, доступная в переменной PATH вашей системы.
+
+## Ключевые особенности
+
+- **Работа через CLI** — выполняет запросы путем формирования и запуска системных команд оболочки.
+- **Обработка длинных промптов** — автоматически создает временные файлы для передачи объемного содержимого промптов в CLI, обходя ограничения на длину командной строки.
+- **Чистое выполнение** — управляет собственным временным хранилищем (`./ai-tmp`) и выполняет очистку после каждого запроса.
+- **Режим YOLO** — выполняет команды со строгими флагами вывода, чтобы результаты были лаконичными и не содержали лишних рассуждений ИИ.
+
+## Инициализация
+
+Инициализируйте `AiGoogleCliLite`, указав ваш API-ключ и нужную модель.
+
+**Параметры:**
+- `key: string` — ваш API-ключ Google AI (передается в CLI через переменные окружения).
+- `model: string` — идентификатор модели для Gemini CLI.
+
+```typescript
+import { AiGoogleCliLite } from '@dxtmisha/scripts'
+
+const ai = new AiGoogleCliLite('ВАШ_API_КЛЮЧ', 'gemini-1.5-flash')
+
+// Генерация ответа
+const response = await ai.generate('Проверь этот фрагмент кода.')
+```
+
+## Методы
+
+### Генерация
+
+- `generate(contents: string): Promise<string>` — основной метод взаимодействия. Компилирует контекст во временные файлы, выполняет команду CLI и возвращает очищенный результат.
+
+### Конфигурация
+
+- `setKey(key: string): this` — обновляет API-ключ для последующих вызовов CLI.
+- `setModel(model: string): this` — переключает идентификатор активной модели.
+
+### Сбор контекста
+
+- `addPrompt(prompt: string): void` — устанавливает постоянный текстовый префикс.
+- `addContent(content: string): this` — добавляет текстовую часть к накопительному промпту.
+- `resetPrompt(): void` — очищает постоянный префикс.
+- `resetContents(): this` — очищает все накопленные части текста.
+
+## Ограничения
+
+- **Изображения** — в настоящее время реализация CLI не поддерживает передачу изображений (вызов `addImage` не повлияет на генерацию).
+- **Окружение** — зависит от доступности функции `exec` и файловой системы для хранения временных данных.

package/src/media/functional/scripts/classes/AiGoogleCliLite/AiGoogleCliLite.vi.mdx

@@ -0,0 +1,56 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/scripts/Classes/AiGoogleCliLite - Google Gemini AI qua CLI'/>
+
+# Lớp AiGoogleCliLite
+
+Một triển khai chuyên biệt của lớp `AiAbstract` tương tác với Google Gemini AI thông qua giao diện dòng lệnh (CLI) của hệ thống. Cách tiếp cận này hữu ích trong các môi trường mà việc tích hợp trực tiếp SDK không được ưu tiên hoặc khi các công cụ CLI hiện có được tận dụng.
+
+> Triển khai này yêu cầu tiện ích CLI `gemini` phải được cài đặt và có thể truy cập được trong đường dẫn hệ thống.
+
+## Tính năng chính
+
+- **Quy trình làm việc qua CLI** — thực hiện các yêu cầu bằng cách xây dựng và chạy các lệnh shell.
+- **Xử lý Lời nhắc Lớn** — tự động tạo các tệp tạm thời để chuyển nội dung lời nhắc lớn cho CLI, tránh các giới hạn về độ dài dòng lệnh.
+- **Thực thi Sạch sẽ** — quản lý bộ lưu trữ tạm thời của riêng nó (`./ai-tmp`) và thực hiện dọn dẹp sau mỗi yêu cầu.
+- **Chế độ YOLO** — thực thi các lệnh với các cờ đầu ra nghiêm ngặt để đảm bảo kết quả ngắn gọn và không có các nội dung thừa.
+
+## Khởi tạo
+
+Khởi tạo `AiGoogleCliLite` bằng mã API và mô hình dự định của bạn.
+
+**Tham số:**
+- `key: string` — mã API Google AI của bạn (được chuyển đến CLI qua các biến môi trường).
+- `model: string` — mã định danh mô hình cho Gemini CLI.
+
+```typescript
+import { AiGoogleCliLite } from '@dxtmisha/scripts'
+
+const ai = new AiGoogleCliLite('YOUR_API_KEY', 'gemini-1.5-flash')
+
+// Tạo phản hồi
+const response = await ai.generate('Kiểm tra đoạn mã này.')
+```
+
+## Phương thức
+
+### Tạo (Generation)
+
+- `generate(contents: string): Promise<string>` — phương thức chính để tương tác. Nó biên dịch ngữ cảnh vào các tệp tạm thời, thực thi lệnh CLI và trả về đầu ra đã được cắt tỉa.
+
+### Cấu hình
+
+- `setKey(key: string): this` — cập nhật mã API cho các cuộc gọi CLI tiếp theo.
+- `setModel(model: string): this` — chuyển đổi ID mô hình hoạt động.
+
+### Xây dựng Ngữ cảnh
+
+- `addPrompt(prompt: string): void` — thiết lập tiền tố văn bản cố định.
+- `addContent(content: string): this` — thêm một phần văn bản vào lời nhắc tích lũy.
+- `resetPrompt(): void` — xóa tiền tố cố định.
+- `resetContents(): this` — xóa tất cả các phần văn bản đã tích lũy.
+
+## Hạn chế
+
+- **Hình ảnh** — hiện tại, triển khai CLI không hỗ trợ truyền hình ảnh (`addImage` sẽ không có tác dụng đối với việc tạo).
+- **Môi trường** — dựa trên tính khả dụng của hàm `exec` và hệ thống tệp cho lưu trữ tạm thời.

package/src/media/functional/scripts/classes/AiGoogleLite/AiGoogleLite.en.mdx

@@ -0,0 +1,71 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/scripts/Classes/AiGoogleLite - Google Gemini AI Integration'/>
+
+# AiGoogleLite Class
+
+A concrete implementation of the `AiAbstract` class for Google's Gemini AI (via the `GoogleGenAI` client). This class provides a streamlined way to interact with Gemini models, handling authentication, context accumulation, and content generation.
+
+## Key Features
+
+- **Google Gemini Integration** — seamlessly connects to Google's generative AI models.
+- **Multimodal Support** — supports both text and image inputs for generation requests.
+- **Context Accumulation** — inherits a robust mechanics for building complex prompts, including images and multi-part text.
+- **Unified Workflow** — provides a consistent interface for model selection and generation, abstracting away low-level client details.
+
+## Initialization
+
+Initialize the `AiGoogleLite` by providing your API key and a target model ID.
+
+**Parameters:**
+- `key: string` — your Google AI API key.
+- `model: string` — the ID of the Gemini model to use (e.g., `'gemini-1.5-flash'`).
+
+```typescript
+import { AiGoogleLite } from '@dxtmisha/scripts'
+
+const ai = new AiGoogleLite('YOUR_API_KEY', 'gemini-1.5-flash')
+
+// Set an optional system prompt prefix
+ai.addPrompt('You are a technical writer.')
+
+// Generate a response
+const response = await ai.generate('Explain the AiGoogleLite class.')
+```
+
+## Methods
+
+### Generation
+
+- `generate(contents: string): Promise<string>` — the main entry point for AI interaction. It combines all accumulated context (prefix, images, parts) and performs the request.
+
+### Configuration
+
+- `setKey(key: string): this` — updates the API key and re-initializes the internal client.
+- `setModel(model: string): this` — switches the active model for subsequent requests.
+
+### Context Building
+
+These methods allow you to accumulate data before calling `generate()`:
+
+- `addPrompt(prompt: string): void` — appends a persistent text prefix (useful for system instructions).
+- `addContent(content: string): this` — adds a text part to the prompt.
+- `addImage(image: AiImageItem): this` — appends an image (base64) to the request.
+- `resetPrompt(): void` — clears the persistent prefix.
+- `resetContents(): this` — clears all accumulated text parts.
+- `resetImages(): this` — clears all accumulated images.
+
+### Information
+
+- `getContents(): string[]` — returns the list of accumulated text parts.
+- `getImages(): AiImageList` — returns the list of accumulated images.
+
+## Types
+
+### AiImageItem
+Represents an image for multimodal requests.
+- `mime: string` — the MIME type of the image (e.g., `'image/png'`).
+- `base64: string` — the image data in base64 format.
+
+### AiImageList
+An array of `AiImageItem`.