Справочник ремонта BMW без пиратского мануала

Коротко

Автор создал мобильный справочник для BMW E90 325i с 20 процедурами ремонта, семью справочными материалами и ответами Gemma по всей небольшой базе за раз. Проект показывает, как обойтись без RAG, но подчёркивает, что технические данные требуют проверки механиком и не заменяют сервисную документацию.

Контекст

Автор — разработчик, который сделал BMW Repair Workshop для друга, самостоятельно ремонтирующего BMW E90 325i. Вместо коммерческого руководства Bentley или BMW TIS и нелегальных копий он составил материалы из общих автомобильных знаний и сверил часть данных с публичными источниками; у каждой записи указано происхождение, а числа сопровождаются просьбой перепроверить их через RealOEM или дилера.

Главное

• Справочник предназначен для BMW E90 325i; в первоначальном описании указаны 20 процедур и семь справочных руководств.
• Официальные коммерческие материалы Bentley и BMW TIS, а также их сетевые копии автор не использовал из-за авторских прав и сомнительного происхождения.
• Контент написан на основе общих автомобильных знаний; некоторые числа сверялись с форумами владельцев и инструкциями продавцов запчастей. У каждой записи есть поле Source.
• Корпус из 27 записей занимает около 11 000 токенов, поэтому модель получает его полностью при каждом вопросе; RAG, эмбеддинги, векторное хранилище и чанкинг не применяются.
• Используются gemma-4-31B-it и DigitalOcean Serverless Inference через inference.do-ai.run/v1/chat/completions; ключ хранит Cloudflare Worker.
• Сайт на GitHub Pages не имеет собственного бэкенда; клиентский поиск строится из Markdown с помощью скрипта Node.js без зависимостей.
• Системная инструкция предписывает не придумывать моменты затяжки, номера деталей и шаги, сохранять предупреждения и указывать источник ответа.
• Расход заявлен примерно как $0.002 за вопрос; предоплаченный баланс DigitalOcean ограничивает возможные траты, автопополнение отключено.
• Друг подтвердил, что в знакомых ему процедурах не увидел ошибок, но официальной построчной проверки не проводил; он предпочёл текст голосовому вводу.
• После отзывов добавлены ссылка «See it done» с запросом для BMW E90 N52B25, процедура по выхлопу и обслуживание жидкости и поддона коробки; внутренний ремонт АКПП отклонён как работа для специалиста.

Как сделано

Сайт — статический проект на GitHub Pages: Markdown-файлы компилируются скриптом Node.js без зависимостей в HTML-страницы и индекс для поиска. Вопрос пользователя проходит через Cloudflare Worker, где хранится ключ, затем отправляется совместимому с OpenAI API запросу inference.do-ai.run/v1/chat/completions; модель gemma-4-31B-it обслуживает DigitalOcean Serverless Inference.

Автор отказался от RAG после измерения корпуса: все 27 записей занимают около 11 000 токенов и целиком помещаются в один запрос. Поэтому каждый вопрос сопровождается полным корпусом — без эмбеддингов, векторной базы и разбиения на фрагменты. Системная инструкция требует отвечать только по этим материалам, не выдумывать значения и шаги, сохранять предупреждения и называть использованную процедуру. Для ограничения расходов используется предоплаченный баланс DigitalOcean с отключённой автоподзарядкой; CORS не считается защитой от прямых запросов, поэтому автор указывает на необходимость лимитов и финансового ограничения.

Результаты

Получился опубликованный справочник с 20 процедурами и семью справочными материалами; автор также сообщает, что после обратной связи друга добавил процедуру по выхлопной системе, обслуживание жидкости и поддона коробки, а также ссылки на видео-поиск, уточнённый для BMW E90 N52B25 и конкретной работы. Один запрос к модели стоит около $0.002. Друг, работающий механик, просмотрел знакомые ему работы и не заметил явных противоречий, однако это не была построчная проверка по официальной документации. На запрос о капитальном ремонте АКПП система отказывает и указывает на границы имеющихся материалов.

Ограничения

Автор не использовал BMW TIS, руководство Bentley или их копии; спецификации составлены из общих знаний и частично сверены с публичными источниками, поэтому все технические значения нуждаются в проверке. Проверка другом не равна аудиту по первичной документации. Нет декодирования VIN, а значит, нельзя точно подобрать данные к конкретной комплектации; проект не проверен на другом шасси. Внутренний ремонт коробки передач намеренно не описан как самостоятельная процедура. Статья не приводит систематических метрик точности или сравнения с RAG и альтернативными моделями.

Что взять себе

• Сначала измерьте размер корпуса знаний: если он целиком помещается в контекст модели, прямой запрос может быть проще и прозрачнее RAG.
• Для ответов, влияющих на безопасность, ограничивайте модель проверяемыми материалами, требуйте указывать источник и сохранять оговорки; отказ от ответа — полезное поведение.
• Не выдавайте непроверенные автомобильные характеристики за гарантированные спецификации: направляйте пользователя к первичной документации, дилеру или специалисту.
• CORS не защищает API от запросов вне браузера; нужны отдельные меры ограничения частоты и расходов.
• Проверяйте пользовательские сценарии с реальными людьми: обратная связь изменила продуктовые решения, включая отказ от голосового ввода.

Читать оригинал, если…

Откройте оригинал, если нужны демонстрация и исходный код, полный перечень процедур, детали системного промпта или разбор исправленных ошибок безопасности.