local-rag-wiki

Локальная для репозитория RAG-вики для ИИ-агентов: MCP-сервис знаний для каждого репозитория (управляемые поиск / чтение / запись заметок вики в Markdown) плюс установщик, который встраивает его в инструментарий вашего агента. Для запуска сервиса требуется Docker.

Быстрый старт (рекомендуется)

Заблаговременно загрузите образ сервиса перед первой сессией агента, чтобы избежать задержек холодного старта:

docker pull ihorleleka/project-rag-wiki:latest

Related MCP server: hw_rag_mcp

Установка

Выполните в корне вашего репозитория:

npx github:ihorleleka/Local-Rag-Wiki install .

Это создаёт управляемый раннер .agents/, раздел политики AGENTS.md, конфигурацию MCP для DeepSeek Harness (.dsh/mcp.servers.yml), Claude Code, Codex, VS Code и OpenCode, а также папку wiki/. Эти интеграции аддитивны: установка поддержки DSH не удаляет и не заменяет другие конфигурации харнессов. Затем MCP-сервис автоматически запускается для каждого репозитория при подключении клиента вашего агента. Перед запуском агента в новом окружении рекомендуется предварительно загрузить образ (см. выше).

DeepSeek Harness

Установите нативный DSH-бандл один раз в используемый вами профиль (обычно web):

dsh plugin --profile web add github:ihorleleka/Local-Rag-Wiki

Перезапустите этот профиль DSH, откройте установленный репозиторий как его рабочую область и начните сессию. При agent/created бандл использует фактическую рабочую область агента (включая пользовательский --agents-dir), чтобы подключить официальный @deepseek-ai/dsh-mcp-client от DSH, запустить управляемый MCP-раннер, переподключить его, обнаружить его инструменты и зарегистрировать предсказуемые инструменты mcp__wiki-manager__*. Клиент остаётся привязанным к агенту, даже если пространство имён стабильно. Раннер запускает или подключается к Docker-сервису этого репозитория точно так же, как и для других харнессов.

Он также подключает управляемый маркером координатор извлечения Cordis для этой рабочей области: agent/session-start закладывает подсказки о повторяющихся темах; agent/pre-step использует локальное состояние, затем выполняет ограниченное извлечение из вики только для существенного промпта — сначала wiki_search depth="abstract" (L0), затем соответствующий контекст depth="packet" (L1). Он помечает свидетельства и оставляет полные решения L2 wiki_read модели. session/event записывает сводку ассистента, а agent/turn-stopping и session/flush усекают и сохраняют состояние. Извлечение кэшируется для каждой рабочей области и дедуплицируется на лету; L1-пакеты ограничены по частоте, холодные старты имеют ограниченный лимит в 90 секунд, а обновления состояния ставятся в очередь с атомарной заменой. Вне репозитория с маркером установки wiki-kit не используется ни состояние, ни вики-процесс.

Сгенерированный .dsh/mcp.servers.yml остаётся альтернативой конфигурации рабочей области; предпочитайте профильный бандл запуску обоих мостов, что создаст два MCP-подключения к одному и тому же сервису репозитория. AGENTS.md остаётся переносимым уровнем политики.

Хуки .agents/hooks/ и .claude/settings.local.json специфичны для Claude Code. Перехват жизненного цикла DSH должен выполняться в доверенных плагинах Cordis Host/Profile, а не в проектно-локальном манифесте хуков. См. .dsh/README.md о границе конфигурации рабочей области.

Обновление

После установки обновите управляемые файлы изнутри репозитория — npx не нужен:

.agents\update-wiki-kit.cmd --force

sh .agents/update-wiki-kit.sh --force

Жизненный цикл

npx github:ihorleleka/Local-Rag-Wiki status .
npx github:ihorleleka/Local-Rag-Wiki restart .
npx github:ihorleleka/Local-Rag-Wiki doctor . --live

start ., stop . и pull . доступны аналогичным образом. Контейнер репозитория сохраняется независимо от отдельных клиентов агентов.

Как это работает

• Этот пакет — установщик: он создаёт и поддерживает раннер .agents/ и конфигурацию MCP в репозитории-потребителе.

• kb-service/ — это контейнеризованный MCP-сервис знаний, который раннер запускает для каждого репозитория. Он предоставляет wiki_search, wiki_read, wiki_list, wiki_tree, wiki_schema_report, wiki_write, wiki_capture, wiki_delete и wiki_rename через POST /mcp/ (по умолчанию loopback), с записями, защищёнными хешем. wiki_search поддерживает многоуровневое извлечение (depth=abstract|packet), а также ограничение по каталогу path_prefix.

Версионирование

Установщик и kb-service используют один и тот же Git-тег (X.Y.Z или vX.Y.Z). Автоматизация релизов:

• tag-version-verify.yml

• docker-release.yml

Лицензия

MIT (см. kb-service/LICENSE).