Поиск документации и версия AI-снимка
Поиск документации и версия AI-снимка
Найти контракт через инструменты документации
В обычном AI-чате EyeAuras поиск документации работает с локальным снимком Wiki. Публикация статьи на сайте и обновление этого снимка — разные операции.
Найти операцию и прочитать исходный текст
- Включите базу знаний в настройках AI и запустите сессию Standard Chat.
- Попросите вызвать
doc_searchс точным именем API и задачей, напримерScriptVariable Listen lifetime. - Прочитайте найденный
chunkIdчерезdoc_get_chunk_full. Заголовок и короткое превью помогают выбрать результат, но не заменяют контракт и код. - Для ссылки на статью используйте
Linkиз результата. У английских страниц это/en/..., у русских/ru/...; путь файла с.mdостаётся идентификатором документа внутри индекса.
Для конкретного документа у doc_search есть docName; kind и tagsCsv
фильтруют только метаданные, которые действительно были загружены. Не угадывайте
метки по содержимому: сначала посмотрите их через doc_list_documents.
Длинный фрагмент может потребовать нескольких вызовов. doc_get_chunk_full
возвращает до 20 000 символов за вызов и указывает смещение продолжения, если
остался текст. Передавайте этот offset с тем же chunkId, пока продолжений
не останется. Частичный ответ может закончиться внутри кода — это ещё не
полный пример.
Какие страницы попадают в базу
Desktop и бот исключают статьи с явным published: false. Отсутствие этого
поля не равнозначно запрету публикации. Опубликованные карты scripting/api/AGENTS.md
остаются документацией; имя файла само по себе не делает страницу внутренней.
Загрузчик читает плоские поля description, kind, tags, published из
frontmatter. Метки поддерживают строку через запятую и список в квадратных
скобках. Заголовок frontmatter не попадает в текст поискового фрагмента.
Сложные вложенные YAML-объекты не являются форматом этих метаданных.
Обновить desktop-снимок и проверить его версию
Для Standard Chat сохраните настройки AI кнопкой Save, затем начните новую сессию или сбросьте текущую. Сохранение сбрасывает подготовленную базу; следующая инициализация обновляет Git-каталог и строит новый индекс. Уже открытая сессия продолжает пользоваться своим снимком до пересоздания.
doc_get_index_status возвращает:
SourceRevision— Git SHA снимка, загруженного desktop-провайдером;IndexHash— идентификатор содержимого и настроек индекса;DocumentCount,ChunkCount,IsIndexedиIsDirty— состояние этой базы.
У общего AiDocsKnowledgeBasePlugin, созданного другим приложением, ревизия
может отсутствовать: её передаёт владелец источника. doc_reindex перестраивает
индекс уже загруженных документов; он не выполняет Git fetch.
Кнопка Rebuild в разделе Guidance pack обновляет отдельный набор файлов
для внешних инструментов. SHA этого набора не доказывает, что существующая
Standard Chat-сессия уже использует тот же индекс. Обновление сайта из main
каждые 15 минут тоже не обновляет открытый desktop-чат.
Контракты и связанные области
Типы AiDocsKnowledgeBasePlugin, Bm25Document, Bm25SearchHit и
Bm25IndexStatus находятся в EyeAuras.AI.BM25. SourceUrl у документа задаёт
каноническую ссылку независимо от его имени в индексе; общие загрузчики могут
передавать собственный URL. Интерпретация published относится к адаптеру
источника, а не к механизму ранжирования.