;;; ============================================================
;;;  SPISHELP.lsp — справка по командам СПИС
;;;
;;;  Введите SPISHELP в командной строке AutoCAD.
;;;  Показывает описание всех команд, схему комплекта,
;;;  полезные пути и решение типовых проблем.
;;; ============================================================

(defun c:SPISHELP ( / )
  (princ "\n")
  (princ "\n============================================================")
  (princ "\n  ИНСТРУМЕНТЫ СПИС — полная справка")
  (princ "\n============================================================")

  ;; --- СХЕМА КОМПЛЕКТА ---
  (princ "\n")
  (princ "\n  СХЕМА КОМПЛЕКТА (ссылки Overlay, вставка 0,0,0, масштаб 1:1):")
  (princ "\n")
  (princ "\n    АР  — основа, сама ничего не подключает")
  (princ "\n    ЭТР = АР + СС + ВК + ОВ")
  (princ "\n    СС  = АР + ВК + ОВ + ЭТР")
  (princ "\n    ВК  = АР + СС + ОВ + ЭТР")
  (princ "\n    ОВ  = АР + СС + ВК + ЭТР")

  ;; --- ПОРЯДОК РАБОТЫ ---
  (princ "\n")
  (princ "\n  ПОРЯДОК РАБОТЫ:")
  (princ "\n")
  (princ "\n    1. SPISRUNSETS    — собрать файлы дисциплин (фоном через Python)")
  (princ "\n    2. Дождаться завершения (лог: %TEMP%\\spis_sets_log.txt)")
  (princ "\n    3. SPISATTACHSETS — подключить файлы в открытый СПИС")

  ;; --- КОМАНДЫ: СБОРКА ---
  (princ "\n")
  (princ "\n  СБОРКА КОМПЛЕКТА:")
  (princ "\n")
  (princ "\n    SPISRUNSETS")
  (princ "\n      Создать файлы дисциплин (ЭТР, СС, ВК, ОВ) со ссылками по схеме.")
  (princ "\n      Спрашивает корень проекта (папка, где лежат АР, ЭТР, СС, ВК, ОВ).")
  (princ "\n      Определяет корпус из имени файла АР или папки.")
  (princ "\n      Запускает Python-скрипт в фоне — AutoCAD остаётся свободен.")
  (princ "\n      Лог: %TEMP%\\spis_sets_log.txt")
  (princ "\n")
  (princ "\n    SPISATTACHSETS")
  (princ "\n      Подключить АР и все дисциплины в открытый СПИС (Overlay).")
  (princ "\n      Спрашивает корень проекта.")
  (princ "\n      Показывает список файлов и спрашивает подтверждение.")
  (princ "\n      Уже подключённые ссылки пропускаются.")

  ;; --- КОМАНДЫ: ССЫЛКИ ---
  (princ "\n")
  (princ "\n  РАБОТА СО ССЫЛКАМИ (XREF):")
  (princ "\n")
  (princ "\n    XRLIST")
  (princ "\n      Показать все внешние ссылки с их статусом.")
  (princ "\n      Ничего не изменяет. Отчёт: %TEMP%\\xrbind_report.txt")
  (princ "\n")
  (princ "\n    XRBIND")
  (princ "\n      Внедрить (BIND) ВСЕ разрешённые ссылки в чертёж.")
  (princ "\n      Битые ссылки пропускаются. Отчёт: %TEMP%\\xrbind_report.txt")
  (princ "\n")
  (princ "\n    XRBIND1")
  (princ "\n      Внедрить ОДНУ ссылку по имени (спросит имя).")
  (princ "\n")
  (princ "\n    XRPATH")
  (princ "\n      Сменить путь «переехавшей» ссылки.")
  (princ "\n      Спросит имя ссылки и новый путь к DWG-файлу.")
  (princ "\n      Полезно, когда файлы moved на другой диск/папку.")
  (princ "\n")
  (princ "\n    XRUNBIND")
  (princ "\n      Отсоединить ТОЛЬКО битые (неразрешённые) ссылки.")
  (princ "\n      Не требует исходных файлов. Лечит чертёж, который не")
  (princ "\n      сохраняется из-за битых вложенных ссылок.")
  (princ "\n")
  (princ "\n    XRDETACH")
  (princ "\n      Отсоединить ВСЕ ссылки (спросит подтверждение).")
  (princ "\n      ВНИМАНИЕ: без внедрения! Сначала XRBIND, потом XRDETACH.")

  ;; --- ПОЛЕЗНЫЕ ПУТИ ---
  (princ "\n")
  (princ "\n  ПОЛЕЗНЫЕ ПУТИ:")
  (princ "\n")
  (princ (strcat "\n    Инструменты:     " *SPIS-DIR*))
  (princ (strcat "\n    Лог сборки:      " (getenv "TEMP") "\\spis_sets_log.txt"))
  (princ (strcat "\n    Лог ссылок:      " (getenv "TEMP") "\\xrbind_report.txt"))
  (princ "\n    Python:          .venv\\Scripts\\pythonw.exe (рядом с инструментами)")

  ;; --- РЕШЕНИЕ ПРОБЛЕМ ---
  (princ "\n")
  (princ "\n  РЕШЕНИЕ ТИПОВЫХ ПРОБЛЕМ:")
  (princ "\n")
  (princ "\n    FILEDIA сломался (нет диалогов открытия/сохранения):")
  (princ "\n      (setvar \"FILEDIA\" 1)    — выполнить в командной строке")
  (princ "\n")
  (princ "\n    «Ошибка при сохранении документа» при сборке:")
  (princ "\n      В AutoCAD висят незакрытые документы от прошлых запусков.")
  (princ "\n      Закройте все документы (кроме СПИС) и запустите снова.")
  (princ "\n      Или закройте и откройте AutoCAD заново.")
  (princ "\n")
  (princ "\n    Ссылки не подключаются (SPISATTACHSETS):")
  (princ "\n      Проверьте, что файлы лежат в подпапках АР, ЭТР, СС, ВК, ОВ.")
  (princ "\n      Проверьте XRLIST — какие ссылки уже есть и их статус.")
  (princ "\n")
  (princ "\n    Сборка зависла / не запускается:")
  (princ "\n      Посмотрите лог: %TEMP%\\spis_sets_log.txt")
  (princ "\n      Убедитесь, что .venv существует рядом с инструментами.")

  ;; --- АВТОЗАГРУЗКА ---
  (princ "\n")
  (princ "\n  АВТОЗАГРУЗКА:")
  (princ "\n")
  (princ "\n    APPLOAD -> Содержимое -> Добавить -> SPIS_TOOLS.lsp")
  (princ "\n    Или в acaddoc.lsp:")
  (princ "\n      (load \"G:/Мой диск/lisp-code/SPIS/SPIS_TOOLS.lsp\")")

  (princ "\n")
  (princ "\n============================================================")
  (princ "\n  Введите SPISHELP ещё раз для повторного показа справки.")
  (princ "\n============================================================")
  (princ)
)

(princ "\nSPISHELP.lsp загружен. Команда: SPISHELP")
(princ)