Перевод на zensical и актуализация
This commit is contained in:
@@ -1,130 +0,0 @@
|
||||
---
|
||||
title: Глоссарий терминов
|
||||
icon: material/format-text
|
||||
---
|
||||
|
||||
# Глоссарий терминов
|
||||
|
||||
Справочник терминов, используемых в документации Koda.
|
||||
|
||||
## A
|
||||
|
||||
**Agent (Агент)** — режим работы Koda, в котором AI самостоятельно выполняет многошаговые задачи, используя различные инструменты.
|
||||
|
||||
**API Key (API-ключ)** — уникальный ключ для доступа к API провайдера моделей (OpenAI, Anthropic и др.).
|
||||
|
||||
**Autocomplete (Автодополнение)** — режим автоматического предложения продолжения кода при наборе.
|
||||
|
||||
## C
|
||||
|
||||
**Chat (Чат)** — режим диалога с AI-моделью для решения задач, объяснения кода и получения рекомендаций.
|
||||
|
||||
**Completion** — см. Autocomplete.
|
||||
|
||||
**Config (Конфигурация)** — файл настроек Koda (`config.yaml`), определяющий модели, провайдеров и параметры.
|
||||
|
||||
**Context (Контекст)** — информация, которую Koda использует для генерации ответов (файлы, код, документация).
|
||||
|
||||
**Context Provider (Контекстный провайдер)** — компонент, автоматически добавляющий релевантную информацию в запросы через символ <kbd>@</kbd> (file, code, docs, codebase, diff, terminal и др.). Подробнее в [Контекст-провайдеры](context-providers.md).
|
||||
|
||||
## D
|
||||
|
||||
**Diff (Дифф)** — разница между двумя версиями файла, показывающая изменения.
|
||||
|
||||
## E
|
||||
|
||||
**Edit (Редактирование)** — режим изменения выделенного кода по инструкции пользователя.
|
||||
|
||||
**Embeddings (Эмбеддинги)** — векторные представления текста для поиска по семантическому сходству.
|
||||
|
||||
## F
|
||||
|
||||
**FIM (Fill-In-Middle)** — техника автодополнения, когда модель заполняет текст между префиксом и суффиксом.
|
||||
|
||||
## I
|
||||
|
||||
**Indexing (Индексация)** — процесс анализа и векторизации кодовой базы или документации для быстрого поиска.
|
||||
|
||||
## L
|
||||
|
||||
**LLM (Large Language Model)** — большая языковая модель, используемая для генерации текста и кода.
|
||||
|
||||
## M
|
||||
|
||||
**Model (Модель)** — AI-модель, используемая для генерации ответов (GPT-4, Claude, Llama и др.).
|
||||
|
||||
**Model Role (Роль модели)** — назначение модели в Koda (chat, edit, agent, autocomplete, embed, rerank).
|
||||
|
||||
## P
|
||||
|
||||
**Provider (Провайдер)** — сервис, предоставляющий доступ к AI-моделям (OpenAI, Anthropic, Ollama и др.).
|
||||
|
||||
**Prompt (Промпт)** — текстовый запрос к AI-модели.
|
||||
|
||||
## R
|
||||
|
||||
**RAG (Retrieval-Augmented Generation)** — техника генерации ответов с использованием поиска по внешней базе знаний.
|
||||
|
||||
**Retrieval (Поиск)** — режим поиска по документации и другим источникам информации.
|
||||
|
||||
**Roles (Роли)** — см. Model Role.
|
||||
|
||||
## S
|
||||
|
||||
**Session (Сессия)** — отдельный диалог в чате Koda со своей историей и контекстом.
|
||||
|
||||
**Session History (История сессий)** — список всех предыдущих сессий с возможностью поиска, переключения и удаления.
|
||||
|
||||
**Session Metadata (Метаданные сессии)** — информация о сессии: ID, заголовок, дата создания, режим работы, рабочая директория.
|
||||
|
||||
**Session Storage (Хранилище сессий)** — место сохранения данных сессий (локальные файлы `~/.koda/sessions/` или серверное хранилище).
|
||||
|
||||
**Summarization (Суммаризация)** — процесс сжатия длинной истории диалога в краткое содержание для экономии токенов.
|
||||
|
||||
**SummaryMarker (Маркер суммаризации)** — визуальный индикатор в истории чата, показывающий где была применена суммаризация.
|
||||
|
||||
**Auto-Summarize (Автосуммаризация)** — автоматическая суммаризация при достижении 75% использования контекста (только Agent режим).
|
||||
|
||||
**Skill (Навык)** — переиспользуемый набор инструкций для AI-модели, хранящийся в отдельном файле.
|
||||
|
||||
**Slash Command (Slash-команда)** — специальная команда, начинающаяся с <kbd>@</kbd> (например, /share, /commit, /summarize).
|
||||
|
||||
## T
|
||||
|
||||
**Token (Токен)** — единица измерения длины текста для AI-моделей (примерно ¾ слова).
|
||||
|
||||
**Tool (Инструмент)** — действие, которое агент может выполнить (читать файл, редактировать код, запускать команду).
|
||||
|
||||
## V
|
||||
|
||||
:material-microsoft-visual-studio-code: **VS Code** — Visual Studio Code, среда разработки от Microsoft.
|
||||
|
||||
## W
|
||||
|
||||
**Workspace (Рабочая область)** — проект или директория, открытая в IDE.
|
||||
|
||||
## Ё
|
||||
|
||||
**Ёфикация** — использование буквы "ё" вместо "е" в русских текстах документации.
|
||||
|
||||
---
|
||||
|
||||
## Сокращения
|
||||
|
||||
| Сокращение | Расшифровка |
|
||||
|------------|-------------|
|
||||
| AI | Artificial Intelligence (Искусственный интеллект) |
|
||||
| API | Application Programming Interface |
|
||||
| IDE | Integrated Development Environment |
|
||||
| LLM | Large Language Model |
|
||||
| [RAG] | Retrieval-Augmented Generation |
|
||||
| :material-microsoft-visual-studio-code: VS Code | Visual Studio Code |
|
||||
| FIM | Fill-In-Middle |
|
||||
|
||||
---
|
||||
|
||||
## Дополнительные ресурсы
|
||||
|
||||
- [Основная документация](README.md)
|
||||
- [Режимы работы](modes.md)
|
||||
- [Инструменты агента](agent-tools.md)
|
||||
@@ -0,0 +1,284 @@
|
||||
# Песочница
|
||||
|
||||
|
||||
|
||||
## Мелочёвка
|
||||
|
||||
=== "Frontmatter"
|
||||
|
||||
```yaml
|
||||
---
|
||||
title: My Page
|
||||
description: Some page description
|
||||
icon: material/star
|
||||
tags: [tag1, tag2]
|
||||
hide: [navigation, toc, path]
|
||||
status: new
|
||||
#status: deprecated
|
||||
#status: beta
|
||||
---
|
||||
|
||||
# My Super-Duper Page
|
||||
|
||||
# Markdown content goes here
|
||||
```
|
||||
|
||||
=== "Бейджи"
|
||||
|
||||
<!-- md:version 8.5.0 --> <!-- md:default true --> <!-- md:flag experimental -->
|
||||
|
||||
=== "Тултипы"
|
||||
|
||||
:material-information-outline:{ title="текст подсказки" }
|
||||
|
||||
[Hover me 1](https://example.com "I'm first tooltip!")
|
||||
|
||||
[Hover me 2][example]
|
||||
|
||||
[example]: https://example.com "I'm second tooltip!"
|
||||
|
||||
=== "Кнопки"
|
||||
|
||||
[Серая кнопка](https://example.com/){ .md-button }
|
||||
|
||||
[Синяя кнопка](https://example.com/){ .md-button .md-button--primary }
|
||||
|
||||
[:fontawesome-solid-paper-plane: Кнопка серая с иконкой и подсказкой](https://example.com/){ .md-button title="текст подсказки 2" }
|
||||
|
||||
[:fontawesome-solid-paper-plane: Кнопка синяя с иконкой](https://example.com/){ .md-button .md-button--primary }
|
||||
|
||||
---
|
||||
|
||||
=== "Простой блок"
|
||||
|
||||
```python
|
||||
def _render_icon(shortcode: str, md) -> str:
|
||||
emoji_pattern = md.inlinePatterns.get("emoji")
|
||||
if emoji_pattern is None:
|
||||
return escape(shortcode)
|
||||
```
|
||||
|
||||
=== "С аннотациями"
|
||||
|
||||
```python
|
||||
def _render_icon(shortcode: str, md) -> str: #(1)!
|
||||
emoji_pattern = md.inlinePatterns.get("emoji") #(2)!
|
||||
if emoji_pattern is None:
|
||||
return escape(shortcode) #(3)!
|
||||
```
|
||||
|
||||
1. сигнатура функции
|
||||
2. инициализация переменной
|
||||
3. возврат результата
|
||||
|
||||
=== "С заголовком"
|
||||
|
||||
```python title="example.py"
|
||||
def _render_icon(shortcode: str, md) -> str:
|
||||
emoji_pattern = md.inlinePatterns.get("emoji")
|
||||
if emoji_pattern is None:
|
||||
return escape(shortcode)
|
||||
```
|
||||
|
||||
=== "С нумерацией с 5"
|
||||
|
||||
```python linenums="5"
|
||||
def _render_icon(shortcode: str, md) -> str:
|
||||
emoji_pattern = md.inlinePatterns.get("emoji")
|
||||
if emoji_pattern is None:
|
||||
return escape(shortcode)
|
||||
```
|
||||
|
||||
=== "С выделением"
|
||||
|
||||
```python linenums="1" hl_lines="2-5 8 9 22"
|
||||
def _render_icon(shortcode: str, md) -> str:
|
||||
try:
|
||||
emoji_pattern = md.inlinePatterns["emoji"]
|
||||
except KeyError:
|
||||
return escape(shortcode)
|
||||
|
||||
icon = emoji_pattern.emoji_index["emoji"].get(shortcode)
|
||||
if icon is None:
|
||||
return escape(shortcode)
|
||||
|
||||
element = emoji_pattern.generator(
|
||||
emoji_pattern.emoji_index["name"],
|
||||
shortcode,
|
||||
None,
|
||||
None,
|
||||
shortcode,
|
||||
"",
|
||||
icon.get("category", ""),
|
||||
emoji_pattern.options,
|
||||
md,
|
||||
)
|
||||
return tostring(element, encoding="unicode", method="html")
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Врезки
|
||||
|
||||
=== "Полные"
|
||||
|
||||
!!! note "Заголовок статичной врезки"
|
||||
Содержимое, которое может
|
||||
быть многострочным
|
||||
|
||||
!!! abstract "Заголовок статичной врезки"
|
||||
Содержимое, которое может
|
||||
быть многострочным
|
||||
|
||||
!!! info "Заголовок статичной врезки"
|
||||
Содержимое, которое может
|
||||
быть многострочным
|
||||
|
||||
!!! tip "Заголовок статичной врезки"
|
||||
Содержимое, которое может
|
||||
быть многострочным
|
||||
|
||||
!!! success "Заголовок статичной врезки"
|
||||
Содержимое, которое может
|
||||
быть многострочным
|
||||
|
||||
!!! question "Заголовок статичной врезки"
|
||||
Содержимое, которое может
|
||||
быть многострочным
|
||||
|
||||
!!! warning "Заголовок статичной врезки"
|
||||
Содержимое, которое может
|
||||
быть многострочным
|
||||
|
||||
!!! failure "Заголовок статичной врезки"
|
||||
Содержимое, которое может
|
||||
быть многострочным
|
||||
|
||||
!!! danger "Заголовок статичной врезки"
|
||||
Содержимое, которое может
|
||||
быть многострочным
|
||||
|
||||
!!! bug "Заголовок статичной врезки"
|
||||
Содержимое, которое может
|
||||
быть многострочным
|
||||
|
||||
!!! example "Заголовок статичной врезки"
|
||||
Содержимое, которое может
|
||||
быть многострочным
|
||||
|
||||
!!! quote "Заголовок статичной врезки"
|
||||
Содержимое, которое может
|
||||
быть многострочным
|
||||
|
||||
=== "Свёрнутые"
|
||||
|
||||
??? note "Заголовок свёрнутой врезки"
|
||||
Содержимое, которое может
|
||||
быть многострочным
|
||||
|
||||
??? abstract "Заголовок свёрнутой врезки"
|
||||
Содержимое, которое может
|
||||
быть многострочным
|
||||
|
||||
??? info "Заголовок свёрнутой врезки"
|
||||
Содержимое, которое может
|
||||
быть многострочным
|
||||
|
||||
??? tip "Заголовок свёрнутой врезки"
|
||||
Содержимое, которое может
|
||||
быть многострочным
|
||||
|
||||
??? success "Заголовок свёрнутой врезки"
|
||||
Содержимое, которое может
|
||||
быть многострочным
|
||||
|
||||
??? question "Заголовок свёрнутой врезки"
|
||||
Содержимое, которое может
|
||||
быть многострочным
|
||||
|
||||
??? warning "Заголовок свёрнутой врезки"
|
||||
Содержимое, которое может
|
||||
быть многострочным
|
||||
|
||||
??? failure "Заголовок свёрнутой врезки"
|
||||
Содержимое, которое может
|
||||
быть многострочным
|
||||
|
||||
??? danger "Заголовок свёрнутой врезки"
|
||||
Содержимое, которое может
|
||||
быть многострочным
|
||||
|
||||
??? bug "Заголовок свёрнутой врезки"
|
||||
Содержимое, которое может
|
||||
быть многострочным
|
||||
|
||||
??? example "Заголовок свёрнутой врезки"
|
||||
Содержимое, которое может
|
||||
быть многострочным
|
||||
|
||||
??? quote "Заголовок свёрнутой врезки"
|
||||
Содержимое, которое может
|
||||
быть многострочным
|
||||
|
||||
=== "Сворачиваемые"
|
||||
|
||||
???+ note "Заголовок развёрнутой врезки"
|
||||
Содержимое, которое может
|
||||
быть многострочным
|
||||
|
||||
???+ abstract "Заголовок развёрнутой врезки"
|
||||
Содержимое, которое может
|
||||
быть многострочным
|
||||
|
||||
???+ info "Заголовок развёрнутой врезки"
|
||||
Содержимое, которое может
|
||||
быть многострочным
|
||||
|
||||
???+ tip "Заголовок развёрнутой врезки"
|
||||
Содержимое, которое может
|
||||
быть многострочным
|
||||
|
||||
???+ success "Заголовок развёрнутой врезки"
|
||||
Содержимое, которое может
|
||||
быть многострочным
|
||||
|
||||
???+ question "Заголовок развёрнутой врезки"
|
||||
Содержимое, которое может
|
||||
быть многострочным
|
||||
|
||||
???+ warning "Заголовок развёрнутой врезки"
|
||||
Содержимое, которое может
|
||||
быть многострочным
|
||||
|
||||
???+ failure "Заголовок развёрнутой врезки"
|
||||
Содержимое, которое может
|
||||
быть многострочным
|
||||
|
||||
???+ danger "Заголовок развёрнутой врезки"
|
||||
Содержимое, которое может
|
||||
быть многострочным
|
||||
|
||||
???+ bug "Заголовок развёрнутой врезки"
|
||||
Содержимое, которое может
|
||||
быть многострочным
|
||||
|
||||
???+ example "Заголовок развёрнутой врезки"
|
||||
Содержимое, которое может
|
||||
быть многострочным
|
||||
|
||||
???+ quote "Заголовок развёрнутой врезки"
|
||||
Содержимое, которое может
|
||||
быть многострочным
|
||||
|
||||
=== "Короткие"
|
||||
|
||||
!!! note
|
||||
Дефолтный заголовок
|
||||
|
||||
!!! abstract ""
|
||||
Пустой заголовок
|
||||
|
||||
!!! info "Пустое содержимое"
|
||||
|
||||
|
||||
---
|
||||
@@ -1,14 +0,0 @@
|
||||
---
|
||||
title: Теги
|
||||
icon: material/tag-text
|
||||
---
|
||||
|
||||
# Теги документации
|
||||
|
||||
Здесь перечислены все теги, которые встречаются на страницах документации.
|
||||
|
||||
Нажмите на ссылку для перехода к странице, которая содержит тег.
|
||||
|
||||
---
|
||||
|
||||
<!-- material/tags -->
|
||||
+549
-548
File diff suppressed because it is too large
Load Diff
Reference in New Issue
Block a user