Assembly Chat
Открыть приложение: Поговорить со сборкой .NET → (products.documentize.ai)
В одном предложении
Assembly Chat читает публичный API сборки .NET (DLL, EXE или пакета NuGet), а затем позволяет просканировать её в диаграммы и таблицы, задавать вопросы о ней простым языком, получать статистику или сравнивать две версии, чтобы увидеть, что изменилось.
Чем он уникален
Большинство инструментов «чата с кодом» читают исходный код. Assembly Chat читает скомпилированную библиотеку, поэтому отвечает по реальным сигнатурам и XML-комментариям той самой версии, которую вы ему дали, а не по догадкам о библиотеке. Это ещё и единственное приложение этого семейства, которое умеет сравнивать две версии пакета до обновления. Ответы строятся по индексу с поиском (RAG), созданному из вашей сборки, поэтому уточняющие вопросы быстрые: сканирование выполняется один раз и используется повторно.
Когда использовать и когда нет
- Используйте, чтобы разобраться в незнакомой зависимости («как с помощью этой библиотеки прочитать документ и сохранить его как PDF?»), получить диаграммы классов для обзора архитектуры или увидеть, что новая версия пакета удалила или изменила.
- Используйте перед обновлением: сравните версию, которую вы запускаете, с той, на которую хотите перейти.
- Не для вашего собственного исходного кода → Code Graph строит карту репозитория, а Repo Docs пишет его документацию.
- Не для библиотек не на .NET. Страница описывает только управляемые сборки .NET.
Прежде чем начать
- Управляемая сборка .NET (
.dllили.exe) или название пакета NuGet (и при желании версия). FAQ страницы называет .NET Framework 4.6.2+, .NET Core 3.1+ и .NET 5–8. - Что видит ИИ: публичные типы и их публичные или защищённые (protected) члены. Внутренние (internal) и закрытые (private) члены исключаются, если не отметить Include Internal.
- Для Diff нужны либо две DLL, либо название и версия пакета «до» и «после».
Пошаговая инструкция
- Откройте Assembly Chat и выберите Command (см. таблицу ниже). По умолчанию выбран Scan.
- Укажите вход: загрузите DLL или введите Пакет NuGet (и Версию NuGet; оставьте пустой для последней).
- Для Chat введите вопрос в Query. Для Diff заполните ещё пакет и версию «После».
- Запустите. Для чата ответ появится в панели чата.
- Задавайте уточняющие вопросы в той же панели. Сканирование используется повторно, поэтому уточняющие вопросы должны возвращаться заметно быстрее первого ответа. New scan (или кнопка нового чата) начинает заново.
Параметры
| Параметр | Что делает | По умолчанию | Рекомендуется |
|---|---|---|---|
| Command: Scan (сканировать, создать UML и CSV) | Читает сборку и создаёт исходники диаграмм и таблицы | выбрано | Первое знакомство с библиотекой |
| Command: Chat (задать вопрос) | Отвечает на ваш вопрос по сборке | – | Повседневное использование |
| Command: Stats (статистика сборки) | Считает и обобщает то, что содержит сборка | – | Быстрая оценка размера и формы |
| Command: Diff (сравнить две версии) | Сравнивает сборку «до» и «после» и сообщает об изменениях API | – | Перед обновлением |
| Query | Ваш вопрос (только Chat) | пусто | Назовите тип или задачу: «как объединить два PDF?» |
| Пакет NuGet / Версия NuGet | Берёт пакет с nuget.org вместо загрузки файла | пусто | Оставьте версию пустой для последней |
| После пакета NuGet / После версии NuGet | Вторая сборка для Diff | пусто | Версия, на которую вы собираетесь перейти |
| Include Internal | Дополнительно читает внутренние члены | выключено | Только для библиотек, которыми вы владеете |
| Комментарии ИИ (AI Comments) | При сканировании просит ИИ написать комментарии к членам | выключено | Только если в библиотеке мало комментариев к документации (проверьте эффект в работающем приложении) |
Ответ в чате может сопровождаться альтернативами: другими вариантами ответа, на которые можно нажать, чтобы ответить на тот же вопрос, взяв другое основное соответствие.
Что вы получите
- Scan: несколько файлов, включая исходники диаграмм UML (
.puml) и таблицы CSV с типами и членами. SVG-изображения создаются, только если воркеру это запрошено (проверьте в работающем приложении, предлагает ли это страница). - Chat: ответ в виде markdown-текста в панели чата, с примерами кода и, по запросу, диаграммами.
- Stats: текстовый отчёт и его PDF.
- Diff: отчёт в markdown, PDF этого отчёта и файлы диаграмм для изменений.
Качество и ограничения
Создано ИИ, но опирается на сигнатуры, которые он действительно прочитал. Он всё же может ошибиться, какой метод вы имели в виду, поэтому считайте примеры кода сильным первым черновиком и компилируйте их. Известна только публичная поверхность: ИИ не может рассказать, что метод делает внутри, помимо его комментариев. Что отправляется в модель: ваш вопрос и подходящие фрагменты API уходят в службу языковой модели, которую использует Documentize; саму сборку читает собственный сканер приложения. Страница сообщает, что извлечённые метаданные хранятся только временно на время вашей сессии и не используются для обучения моделей.
Хорошо сочетается с
- До: NuGet Updater скажет, что устарело; Assembly Chat — что меняет новая версия.
- После: Repo Docs для документирования вашего собственного кода.
- Связанное: Доверие, проверка и ограничения результатов ИИ.
Типичные ошибки и их исправление
- «No DLL was uploaded and no NuGet package specified» → укажите что-то одно из двух.
- «Diff needs a second DLL» → загрузите два файла или заполните пакет «После».
- Query пуст → для Chat нужен вопрос.
- В ответе упоминается тип, которого вы не видите → возможно, вы просканировали другую версию; проверьте поле версии.
То же в других каналах
Для этого приложения не проверено. О том, что есть для других приложений, см. каналы.
Попробуйте
Выберите Scan, введите Newtonsoft.Json как Пакет NuGet и оставьте версию пустой. Когда сканирование закончится, переключитесь на Chat и спросите: «How do I serialize an object to a JSON string?» (Как сериализовать объект в строку JSON?). Затем выполните Diff с двумя версиями одного пакета и прочитайте в отчёте список изменённых членов.