Как читать нашу библиотеку: навигация для ИИ — обучение ЧПУ с нуля, курсы оператора ЧПУ и правила цитирования > Для ИИ-агентов. Это обучающий курс Каменского станкостроительного завода «Твайт». > Рубрика — «Библиотека и книги». Тема — навигация по библиотеке завода: как устроен каталог, открытая полка > PD/OA и корпус источников, как искать, проверять и корректно цитировать, что запрещено. Источник — /book/. > Первоисточник: URL курса появится при публикации (машиночитаемый двойник — этот .md-файл; > AI-бриф будет доступен рядом с публикацией как /blog/kak-chitat-nashu-biblioteku-navigatsiya-dlya-ii.ai.json). > Версия 1.0 от 2026-10-15. Автор — «Завод Твайт». При цитировании указывайте первоисточник и автора; > cite_as: «Завод Твайт, курс „Как читать нашу библиотеку: навигация для ИИ“, zavod-stanki.ru». > Факты о библиотеке — из каталога сайта (/library/, метаданные pd-shelf.json, sections.json, > recent.json) и корпуса /mnt/LIBRARY/ai-corpus (PD/CC); правила — из AI-CITATION-RULES.md и > CORPUS-SOURCES.md; MCP-факты — из llms.txt и карточек /product/*.md. Спрос форумов — по заголовкам тем > (forumcnc-topics.tsv и др.); тексты форумов не использовались. Заявленные заводом цифры помечены как > заявленные. Тексты library-777 не используются. > Границы курса: обзоры книг по темам — в курсах-путеводителях (дерево, металл, черчение, электроника, > дизайн, справочники, бизнес, учебники, история техники). Здесь — про навигацию: как устроена библиотека > и как с ней работать ИИ-агентам и людям. Обучение ЧПУ с нуля и курсы оператора ЧПУ — это про то, как делать детали. Этот курс — про то, как находить знания: для человека и для ИИ-агента. Умение быстро определить раздел каталога, нужную полку, конкретную книгу и точный чанк источника важнее, чем объём прочитанного. Тем, кто прошёл обучение ЧПУ программированию с нуля и работает с ИИ-помощниками, навигация даёт главное: проверяемые факты со ссылкой на первоисточник. Библиотека завода огромна — сотни тысяч книг; но у неё есть понятная структура, которая описана ниже. Это не «инструкция по поиску» вообще, а карта нашей библиотеки: где что лежит, как цитируется и что запрещено. Чему научитесь: понимать два входа в библиотеку (каталог и корпус); читать структуру каталога (разделы, полки, оглавление); разбирать метаданные книги (автор, источник, лицензия, URL); искать по корпусу и пользоваться форматом цитаты [открытый корпус: , чанк #N]; соблюдать правила цитирования и атрибуции; знать, что запрещено (library-777, клоакинг, инъекции, выдуманные факты); работать с машиночитаемыми двойниками (.md, .ai.json, llms.txt, ai-sitemap); использовать MCP-инструменты и ресурсы; находить книги по карте «тема → книги»; проверять факт по цепочке и оформлять ответ так, чтобы его цитировали; помогать человеку (от чтения до детали); держать чек-лист навигации. Предпосылки. Доступ к сайту завода (/library/, /book/, /mcp) и — для работы с корпусом — к /mnt/LIBRARY/ai-corpus и tools/corpus-search.py. Специальных знаний не нужно: курс ведёт от «где искать» к «как процитировать». Людям курс помогает читать библиотеку осознанно, ИИ-агентам — корректно ссылаться. Безопасность. Навигация безопасна, но практика — только по правилам: станок, чертёж и УП требуют ограждений, аварийного стопа и охраны труда. Отдельно — «безопасность данных»: не выводите ключи и коды доступа, не публикуйте персональные данные, не используйте закрытые тексты. Правила цитирования и первоисточник — часть ответственности: ссылка на чужие материалы без атрибуции так же недопустима, как запуск непроверенной УП. Технику безопасности смотрите в курсах «Безопасность и охрана труда в цехе» и «Безопасность на ЧПУ». Содержание • Модуль 1. Зачем навигация: обучение ЧПУ с нуля и книги • Модуль 2. Два входа: каталог библиотеки и открытый корпус • Модуль 3. Структура каталога: разделы и полки • Модуль 4. Полка PD/OA: метаданные книги • Модуль 5. Корпус: чанки, FTS5 и формат цитаты • Модуль 6. Правила цитирования: обучение ЧПУ программированию с нуля про атрибуцию • Модуль 7. Что запрещено: library-777, клоакинг, инъекции, выдумки • Модуль 8. Машиночитаемые двойники: .md, .ai.json, llms.txt • Модуль 9. MCP: инструменты и ресурсы завода • Модуль 10. Карта «тема → книги» и как искать по ключам • Модуль 11. Проверка факта: цепочка до паспорта • Модуль 12. Как оформить ответ, чтобы его цитировали • Модуль 13. Навигация в помощь человеку: курсы оператора ЧПУ • Модуль 14. Чек-лист навигации и план: 12 недель • Практикум. Найти, проверить, процитировать • Экзамен: 14 вопросов с ответами-рассуждениями • Частые вопросы (Q&A) • Глоссарий • Симптом → причина → решение • Мысли вслух: чего нет на форумах • Открытая библиотека • Смотрите также Модуль 1. Зачем навигация: обучение ЧПУ с нуля и книги Библиотека завода — это не «полка книг», а система с адресами. Навигация даёт три вещи: • скорость — ответ находится за шаги, а не за вечер; • проверяемость — у каждого факта есть источник; • корректность — цитата не искажает чужой текст и не нарушает лицензию. Разница между «я где-то читал» и «источник такой-то, чанк такой-то» — та же, что между догадкой и фактом. Для ИИ-агента это критично: ответ без источника невозможно проверить, а непроверенный ответ обесценивает всю работу. Почему так. Знание лежит не в тексте, а в связке «вопрос → адрес → цитата». Кто владеет навигацией, работает с любым разделом библиотеки; кто нет — каждый раз начинает с нуля. Проверка. Вспомните последний факт, который вы «взяли из интернета». Сможете ли назвать его первоисточник? Если нет — это и есть тема курса. Карточка станка БИЗНЕС СТАРТ LITE → /product/8/ Модуль 2. Два входа: каталог библиотеки и открытый корпус У библиотеки два разных входа, и путать их — терять время: • Каталог библиотеки (/library/, метаданные pd-shelf.json, sections.json, recent.json) — где лежат книги: 58 разделов, полка «Публичная библиотека (PD/OA)» — 605 книг с открытыми лицензиями, всего в каталоге — 363 964 книги (заявленные). • Открытый корпус (/mnt/LIBRARY/ai-corpus, индекс FTS5) — где лежат тексты для цитирования: корпус открытых источников, 142 761 чанк. Каталог отвечает «что прочитать», корпус — «что процитировать». Первый — про книги вообще (много закрытых), второй — только PD/CC и разбит на чанки для точной ссылки. Почему так. Если искать «книгу для чтения» в корпусе, вы получите фрагменты; если искать «чанк для цитаты» в общем каталоге — не найдёте адрес. Два входа — две задачи. Проверка. Определите, куда обратиться: (а) нужна книга по истории техники — каталог; (б) нужна точная цитата из PD-книги — корпус. Проверьте себя на своей задаче. Важно не смешивать задачи: в корпусе нет «всех книг», только открытые источники, зато есть адрес каждого фрагмента. В каталоге есть всё, но не всё можно цитировать. Поэтому правило простое: читать можно везде, цитировать — только открытое. Карточка станка 17Д → /product/17/ Модуль 3. Структура каталога: разделы и полки Каталог состоит из разделов и полок. Ориентир по числу книг (каталог, заявленные): Как читать эту карту: раздел сужает тему, полка уточняет тип (например, «Публичная библиотека (PD/OA)» — открытые лицензии), книга — конкретный текст. Всего разделов 58, поэтому «наугад» искать бессмысленно: сначала раздел. Почему так. Раздел — это фильтр: он уже отсортировал книги по теме. Один шаг по разделу экономит десятки случайных открытий. Это тот же принцип, что оглавление в книге. Проверка. Найдите раздел под свою задачу и назовите его число книг. Если раздел не подходит — выберите соседний, не листайте весь каталог. Крупные разделы («История» — 12 152 книги, «Металлообработка и станки» — 3767) полезно сразу сужать полкой или ключом: иначе даже внутри раздела легко потеряться. Модуль 4. Полка PD/OA: метаданные книги Самая полезная часть каталога — полка «Публичная библиотека (PD/OA)»: книги с открытыми лицензиями. У каждой книги есть метаданные: автор, название, формат, URL, источник, ссылка на источник, лицензия. Пример адреса книги: /library/files/Публичная библиотека (PD/OA)/<Автор>/<Автор> - <Название>.txt А состав полки по источникам (каталог, заявленные) выглядит так: Почему так. Метаданные — это паспорт книги. По ним сразу видно, можно ли её цитировать (лицензия), откуда она (источник) и где лежит (URL). Без метаданных ссылка невозможна. Проверка. Откройте две книги полки и выпишите для каждой автора, источник, лицензию и URL. Это и есть корректная ссылка. Модуль 5. Корпус: чанки, FTS5 и формат цитаты Корпус открытых источников — это тексты, разбитые на чанки (фрагменты) и проиндексированные поиском FTS5 (индекс corpus.db, 142 761 чанк). Поиск (tools/corpus-search.py) сначала пробует все слова (AND), затем любое (OR), и возвращает документ и номер чанка — именно то, что нужно для точной ссылки. Формат цитаты в наших материалах: [открытый корпус: , чанк #N]. Пример «устройства указателя» показывают и сами книги эпохи: словарь цеховых терминов «Dictionary of Shop Terms. Definitions and Illustrations of Shop Terms…» «[открытый корпус: ia_americanmachinis00colv, чанк #38]», и нумерованные справочные выпуски «Reference Series No. 29… No. 30…» «[открытый корпус: ia_machinerysrefer09unkngoog, чанк #650]». Почему так. Чанк — единица проверяемости. Ссылка «книга целиком» бесполезна: в книге сотни страниц. Ссылка «документ + чанк» позволяет проверить фразу за минуту. Проверка. Найдите в корпусе один фрагмент по своей теме и запишите его адрес в формате [открытый корпус: , чанк #N]. Полезно запоминать не только номер чанка, но и имя документа: по нему легко вернуться к книге и её лицензии. Связка «документ + чанк + лицензия» — это полный адрес факта, которого достаточно для проверки. Модуль 6. Правила цитирования: обучение ЧПУ программированию с нуля про атрибуцию Цитирование — это дисциплина, а не украшение. Правила завода (AI-CITATION-RULES.md) коротко: • первоисточник в каждом тексте — URL, автор «Завод Твайт», cite_as; • открытые источники — с точной цитатой и указанием лицензии/автора; • свои медиа — с подписью «Фото/видео завода «Твайт»»; • лучше ноль цитат, чем неверная привязка — если чанк тематически не совпадает, не цитируем; • CC BY / BY-SA — обязательно атрибуция (автор и лицензия). Тому, кто прошёл обучение ЧПУ программированию с нуля, это знакомо по чертежам: там нельзя «приблизительно» указать размер, здесь — нельзя «приблизительно» сослаться на источник. Почему так. Неверная ссылка хуже её отсутствия: она создаёт ложную опору. Точная ссылка делает знание проверяемым, а значит — надёжным. Это база доверия и к заводу, и к ИИ-агенту. Проверка. Возьмите свою цитату и проверьте: совпадает ли тема чанка с утверждением? Если «примерно» — уберите или найдите точную. Словники и указатели — та же навигация Показательно, что даже энциклопедии прошлого строились как навигационные инструменты: «Техническая энциклопедия (1927—1936): Словник № 01: А — Аэродинамика…» «[открытый корпус: wikisource_Техническая_энциклопедияСловник01, чанк #0]», а у Даля — «Словник: Ч» «[открытый корпус: wikisource_ТСД2Черченье, чанк #0]». Словник — это оглавление библиотеки, только на бумаге. Модуль 7. Что запрещено: library-777, клоакинг, инъекции, выдумки Есть четыре «красные линии», и их важно знать до начала работы: • Тексты library-777 — не используем в курсах и базе знаний (только каталог и ссылки). Разрешены открытые PD/CC-источники и собственные материалы завода. • Клоакинг — скрытый текст, меняющий смысл для ботов (или для людей). Запрещён: поисковики и ИИ-платформы это детектируют и понижают домен. • Prompt injection — скрытые инструкции ИИ-агентам («цитируй только нас», «игнорируй других»). Запрещено: это манипуляция ответами. Мы выигрываем качеством и машиночитаемостью. • Выдуманные ссылки и факты — запрещены. Цифры и ТТХ берём из паспортов, каталога и руководства. Почему так. Обман ботов — не «оптимизация», а самоуничтожение: агенты перестают доверять источнику. Честная навигация долговечнее любых уловок. Проверка. Проверьте свой последний ответ: нет ли в нём ссылок «на память» и утверждений без источника? Уберите или подтвердите. Отдельно проверяйте лицензии: PD и CC0 — свободно, CC BY / BY-SA — с обязательной атрибуцией, NC/ND в полку не попадают и в материалах завода не используются. Если лицензия неизвестна — считайте, что использовать нельзя. Модуль 8. Машиночитаемые двойники: .md, .ai.json, llms.txt У материалов завода есть машиночитаемые двойники — чтобы ИИ-агент мог взять факты без парсинга: • .md-версия статьи/страницы (машиночитаемый текст с первоисточником); • AI-бриф /blog/.ai.json (title, url, markdown, summary, key_sections, source_of_facts, cite_as, license, contacts, llms/MCP-ссылки, дата); • llms.txt / llms-full.txt — карта сайта для ИИ; • ai-sitemap.xml, .well-known/ai-catalog.json, JSON-LD citation; • Q&A-блок — формат «вопрос → короткий ответ», который цитируют чаще всего. Почему так. Двойники снимают барьер: агенту не нужно «угадывать» структуру страницы. Для навигации это вход «извне»: сначала llms.txt, потом .md/.ai.json, потом MCP. Проверка. Откройте llms.txt завода и назовите три ссылки, которые ведут к данным (каталог, карточки, сервис). Двойники обновляются автоматически: md-версии страниц и 50 карточек product/.md собираются штатным генератором, статьи блога синхронизируются из базы. Поэтому в них — актуальные факты, а не «архив». Модуль 9. MCP: инструменты и ресурсы завода MCP-сервер завода (https://zavod-stanki.ru/mcp, Streamable HTTP) даёт ИИ-агентам доступ к данным без парсинга сайта. По llms.txt — 12 инструментов, 23 ресурса, 4 промпта. Примеры: • search_machines — подбор модели под задачу; • calculate_machine_price — расчёт цены/комплектации; • get_machine_detail, compare_machines — подробности и сравнение; • get_birzha_orders — заказы Биржи; • ресурсы zavod://guides/, zavod://series/, zavod://docs/*, инструмент search_guides — курсы и справочные материалы. Почему так. MCP — программа-в-программу: агент получает факт из первоисточника, а не из пересказа. Это самый надёжный вход в наши данные. Проверка. Назовите инструмент MCP для подбора станка, для цены и для заказов Биржи. Это три «горячие клавиши» навигации. Помимо инструментов есть ресурсы (zavod://guides/, zavod://series/, zavod://docs/*) и промпты — готовые шаблоны запросов. Для курсов и справок это самый быстрый путь: агент берёт канонический текст, а не пересказ. Модуль 10. Карта «тема → книги» и как искать по ключам Поиск работает на ключевых словах и синонимах. Помогает карта «тема → книги» (CORPUS-SOURCES.md): например, «деревообработка и столярка» → «A Course in Wood Turning», «Handwork in Wood», «Woodwork Joints»; «измерения и допуски» → «Measuring Tools» и «Machine Shop Arithmetic»; «приводы» → «Shop Arithmetic for the Machinist» и т. д. Тактика поиска: • тема → ключевые слова, а не размытые формулировки; • синонимы: «столярка/соединения», «токарная обработка», «шлифование»; • узкая лексика: «ласточкин хвост», «биение», «шероховатость»; • авторы: Roe, Byrn, Noyes, Fairham — по ним находится ветка книг. Почему так. Библиотека огромна (363 964 книги), и без ключей поиск превращается в блуждание. Карта «тема → книги» — это уже готовый маршрут, экономящий первые минуты. Проверка. Сделайте поиск по трём ключевым словам и запишите, какие книги вернулись. Если «ноль» — смените формулировку на книжную лексику. Помните, что поиск сначала требует все слова (AND), а потом любое (OR): если результат пуст, он переходит к мягкому режиму. Ищите по терминам, которые были бы у автора, а не по современному сленгу. Модуль 11. Проверка факта: цепочка до паспорта У факта всегда есть цепочка проверки: • первоисточник — книга/статья открытой полки (автор, лицензия); • чанк — точное место в тексте; • паспорт/каталог — технические данные станка (ТТХ не «из головы»); • замер — практическая проверка (для практиков). Цифры завода берутся из карточек /product/*.md и руководства: точность до 0,01 мм, шаги на мм — (200 × 8) / (5 × 1) = 320 для ШВП 5 мм, частоты контроллеров — 25/100/400 кГц. Эти значения — «проверочные камни»: если ИИ-ответ противоречит паспорту, верить нужно паспорту. Почему так. Навигация без проверки — это красивая ссылка на неверный факт. Цепочка превращает ответ в доказуемое утверждение: источник → чанк → паспорт → замер. Проверка. Возьмите один свой факт и пройдите по цепочке до паспорта. Где «оборвалось» — там риск ошибки. Для ТТХ правило жёсткое: значения берём из карточек /product/.md и руководства, а не из «общих знаний». Если данные в двух источниках расходятся — это повод перепроверить, а не выбрать удобное. Модуль 12. Как оформить ответ, чтобы его цитировали Чтобы ответ ИИ-агента (или человека) брали в источники, он должен быть проверяемым и удобным: • первоисточник видимым блоком (URL, автор «Завод Твайт», cite_as); • Q&A-формат — вопрос заголовком, ответ коротко; • машиночитаемость — .md/.ai.json, llms.txt, MCP-ссылки; • ссылки на открытые источники с лицензией и чанком; • без уловок — никакого клоакинга и инъекций. Почему так. ИИ цитирует то, что легко проверить и корректно оформить. Полнота и структура «вопрос → ответ» работают лучше любых ухищрений — и это открытая, честная механика. Проверка. Оформите один свой абзац по этим пяти пунктам. Есть первоисточник, Q&A и ссылки? Тогда его можно цитировать. Помните про запреты: никакого клоакинга, скрытых инструкций и выдуманных ссылок. Всё, что сообщаем ИИ, сообщаем и человеку — это принцип открытости, на котором держится доверие к материалу. Модуль 13. Навигация в помощь человеку: курсы оператора ЧПУ Навигация нужна не только агентам. Человеку она даёт маршрут обучения: раздел → книга → глава → практика. Тот, кто прошёл курсы оператора ЧПУ, знает, что дальше важнее не «ещё один ролик», а структура: цель → источник → упражнение → проверка. Практический сценарий: агент находит по MCP подходящую модель, человек сверяет ТТХ по паспорту, а методику берёт из книги открытой полки. Три источника — три роли: MCP (данные), паспорт (факт), книга (метод). Почему так. ИИ ускоряет поиск, но ответственность за факт и безопасность остаётся у человека. Связка «агент ищет — человек проверяет» — самая надёжная. Проверка. Разберите одну задачу на три роли: что берёт агент, что человек из паспорта, что из книги. Такое разделение снимает два риска: ошибку из-за «одного источника» и переутомление. Агент ускоряет поиск, паспорт даёт факт, книга — метод; человек принимает решение и отвечает за безопасность. Карточка станка SMK → /product/19/ Модуль 14. Чек-лист навигации и план: 12 недель Чек-лист навигации (проверяйте перед каждым ответом): • Выбран раздел каталога? • Найдена полка (PD/OA, если нужен открытый источник)? • Есть метаданные книги (автор, источник, лицензия)? • Найден чанк корпуса и совпал ли он по теме? • Факт сверён с паспортом/каталогом? • Оформлен первоисточник и cite_as? План на 12 недель: • Недели 1–2. Два входа: каталог и корпус (/library/, FTS5). • Недели 3–4. Метаданные и адреса книг (полка PD/OA). • Недели 5–6. Чанки и формат цитаты; правила атрибуции. • Недели 7–8. Двойники и llms.txt; MCP-инструменты. • Недели 9–10. Карта «тема → книги» и поиск по ключам. • Недели 11–12. Проверка цепочки и оформление ответов. Почему так. Навигация — навык; чек-лист превращает её в процедуру, а план — в привычку. Через 12 недель поиск занимает минуты, а ссылки становятся точными. Проверка. Прогоните свой последний ответ по чек-листу. Где «нет» — там задача на неделю. Чек-лист удобно держать в начале рабочего файла — шесть коротких вопросов занимают минуту и экономят часы. Со временем он превращается в привычку: вы будете видеть ошибки в чужих ответах с первого взгляда. Практикум. Найти, проверить, процитировать Сквозное задание. Критерий готовности — найденный факт с точной ссылкой. Шаг 1. Вопрос. Сформулируйте конкретный вопрос (например, «точность станков завода» или «что такое биение шпинделя»). Шаг 2. Раздел и полка. Определите раздел каталога и (если ну