---
name: debug-revit-plugin
description: Диагностика проблем Revit-плагина — не загружается, не собирается, команда не видна, ошибка addin. Использовать когда студент пишет «не работает», «не видно», «ошибка сборки».
---

# Отладка Revit-плагина

Диагностика для студентов. Отвечай **на русском**.

## Сбор информации

Если студент не указал — спроси:

1. Текст ошибки (сборка / Revit / журнал)
2. Версия Revit (ожидается 2023)
3. Шаги: что нажал, что ожидал
4. Менялся ли `.addin` или namespace

## Чеклист проверок

```
- [ ] Сборка без ошибок в Visual Studio?
- [ ] Файлы в %AppData%\Autodesk\REVIT\Addins\2023\
      — PCC_Revit_Automation.addin
      — PCC_Revit_Automation.dll
- [ ] FullClassName в .addin == namespace + класс в C#?
- [ ] Assembly в .addin == PCC_Revit_Automation.dll?
- [ ] Revit перезапущен после сборки?
- [ ] HintPath к RevitAPI.dll указывает на Revit 2023?
- [ ] ClientId уникален для каждой записи Command?
```

## Типичные проблемы

| Симптом | Причина | Решение |
|---------|---------|---------|
| Addin не в списке | Post-build не скопировал файлы | Проверить папку Addins, собрать вручную |
| «Could not load file or assembly» | Неверный путь к DLL в .addin | Assembly = имя файла без пути |
| «Class not found» | FullClassName не совпадает | Исправить namespace/имя класса |
| Команда не в External Tools | Нет записи Type="Command" | Добавить в .addin |
| CS0246 Revit API | Неверный HintPath | RevitApi.props.user или .csproj |
| Изменения не видны | Revit не перезапущен | Закрыть все окна Revit |

## Журнал Revit

Путь к журналу (Windows):

```
%LOCALAPPDATA%\Autodesk\Revit\Autodesk Revit 2023\Journals\
```

Последний `journal.*.txt` — искать строки с `Add-In`, `Exception`, имя плагина.

## Порядок действий для AI

1. Прочитать `.addin`, проблемный `.cs`, `.csproj`
2. Сверить namespace / FullClassName / Assembly
3. Предложить **минимальное** исправление
4. Напомнить пересборку и перезапуск Revit

Не переписывать весь проект при точечной ошибке.