Інструмент GitHub Trending Archify автоматизує діаграми архітектури за допомогою ШІ

Красиві схеми архітектури з підтримкою оновлень у реальному часі тепер можна створювати за допомогою ШІ з одним кліком!

Сподіваємося, усі ви, хто працює з ручним малюванням, стикалися з проблемами, пов’язаними з необхідністю постійної настройки полотна та застаріванням зображень після оновлення коду.

Хоча генерація за допомогою Mermaid зручна, при більш складних схемах стрілки можуть розлетітися, і доведеться вносити зміни вручну.

Зараз відкритий проект Archify, який потрапив у GitHub Trending, стиснув це в одне речення:

Проаналізуйте цей сховище коду та створіть високорівневу архітектурну діаграму виконання.

Потім генерується архітектурна схема у форматі HTML, яка дозволяє шукати вузли, відстежувати шляхи викликів та змінювати тему.

І він не вимагає певної моделі — чи то Claude Code, Codex, Cursor, чи будь-який інший агент, він працюватиме.

На момент публікації Archify отримав багато позитивних відгуків з 100 000 лайків у X, зібрав 1,9K Fork, 31 400 Star і зайняв перше місце у тенденціях GitHub.

Люди не змогли утриматися від зауважень:

Дякую Archify, я зекономив щонайменше чотири або п’ять додаткових зустрічей.

Але дивно, що розробник цього популярного AI-агенту «Також немає дощу, ні туману, ні сонця» не закінчив відомий університет.

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

Після того як Archify став відомим, він з легким засмученням підтікав у своєму аккаунті X:

Я працював охоронцем, вчився ремонту авто, працював на заводі, навіть зусиллями пройшов кілька етапів інтерв’ю в таких великих компаніях, як ByteDance Feishu та Yuanfudao, і завжди думав, що пропозиція про роботу вже близько — але під час перевірки рекомендацій вони виявляли, що я закінчив коледж, і мені залишалося лише з жалем відійти. У рік закінчення навчання я постійно стикався з таким: на інтерв’ю все йшло добре, але щойно я говорив, що я «з коледжу на бакалавра», у HR не було вже жодної відповіді. (Смутна посмішка)

Він відкрито сказав, що після того, як пропозиції поступово відхилялися, він переживав болі, сумніви, розпач і навіть одразу спустився вниз і пробіг 5 кілометрів.

Але він ніколи не здавався.

Пізніше, за підтримки виконавчого директора з операцій Manus Cz Chen, він вирішив використати Archify, щоб довести всім:

Походження з бідності — не позор!

Archify — це агентська здібність для AI-агентів, таких як Claude Code, Codex, Cursor та OpenCode.

Ви можете надати йому системний опис або дозволити Archify автоматично проаналізувати сховище коду.

Після розуміння коду Archify спочатку генерує структурований JSON IR, потім перевіряє схему, макет і відображення, і нарешті виводить окремий HTML-файл.

Процес виглядає приблизно так:

Код або текстовий опис → розуміння Archify → генерація JSON IR → перевірка правил → відображення HTML/SVG → інтеракція та експорт.

Він може генерувати п’ять типів технічних діаграм: архітектурні діаграми, діаграми робочих процесів, діаграми послідовності, діаграми потоків даних та діаграми життєвого циклу.

Крім того, згенеровані зображення можна не лише переглядати, а й шукати вузли, переглядати сусідні модулі, відстежувати шляхи між двома вузлами; зручно перемикати між темним і світлим режимами, експортувати у форматах PNG, SVG, WebM та ділитися картками.

Якщо результат вас не задовольняє, ви завжди можете вказати Archify зробити зміни, наприклад:

Приєднуйтесь до Redis.

Перемістіть модуль верифікації вліво.

Підкреслити механізми відновлення після недійсності кешу.

Але виникає питання: інструменти для генерації графіків за текстом, такі як Mermaid і D2, вже існують — у чому ж унікальність Archify?

Відповідь у тому, що це не просто створення зображень за допомогою тексту, а вбудовування здатності до малювання безпосередньо в робочий процес програмного агента, що дозволяє агенту розуміти код, генерувати графіки у форматі GIF та постійно їх змінювати.

Навпаки, Mermaid і Graphify лише відповідають за візуалізацію існуючих текстових описів у вигляді зображень і, можливо, навіть не так гарно, як Archify.

Справжня відмінність Archify полягає в тому, що він інтегрує інструменти для малювання в робочий процес програмного агента.

Вам не потрібно вивчати синтаксис графіки з нуля — достатньо описати технічну мету.

Роботу з розуміння коду, організації компонентів та генерації структурованих даних можна покласти на AI Agent, а Archify відповідає за перевірку та відображення.

Ця розподілена робота також намагається вирішити одну з проблем генерації архітектурних діаграм за допомогою ШІ, а саме

Модель може швидко малювати, але не обов’язково правильно.

Archify перевірить структуру даних, розташування вузлів, мітки та конфлікти з’єднань перед доставкою.

Якщо перевірка не вдалася, вона вкаже на конкретну проблему та допустимі способи її виправлення, а не просто надасть зображення, яке виглядає добре, але містить помилки.

Крім того, він може порівнювати два знімки архітектури, позначаючи додані, видалені, змінені, переміщені та перенаправлені частини у форматі Before/Delta/After.

Це означає, що архітектурна діаграма більше не є лише ілюстрацією, доданою після завершення розробки, а також може брати участь у рецензуванні коду та оновлюватися разом із проектом.

Звичайно, Archify не ідеальний — це не система реального часу для моніторингу, і вона не може автоматично підтвердити, що графік повністю відповідає онлайн-статусу.

Точність результатів все ще залежить від інформації коду, користувацьких підказок та аналітичних здібностей агента.

Після практичного тестування деякі користувачі зазначили, що Archify має деякі недоліки: деталі згенерованих вузлів відображаються досить дрібно, використання моделей без візуальної компоненти (наприклад, deepseek-v4-flash) може бути не зовсім плавним, а також споживання квот є достатньо високим.

Щодо цього розробники також висловилися: вони працюють над оновленням версії та вирішенням цих проблем — можна очікувати новини.

Отже, Archify підходить саме вам:

Вже використовуєте AI для програмування, щоб швидко розібратися в невідомих репозиторіях, відстежити ланцюжки викликів або пояснити складну систему своїй команді.

Але історія Archify — це не тільки те, як інструмент швидко став популярним за чотири місяці.

За ним стоїть ще одна більш конкретна проблема:

Коли освіта не може змінитися, як інший розробник може довести себе?

Відповідь «також немає ні дощу, ні туману, ні ясного погоди» — це створити продукт, який буде доступний, зручний і перевірений будь-ким.

Вчитель «Також немає дощу, ні туману, ні сонця» наразі не розголошує свого імені та місця роботи, однак історія Archify вже прояснилася й здобуває все більше прихильників.

Оскільки хмари розійшлися, а небо стало ясним, далі ми тепло називатимемо його «вчителем Сонячного Дня». (Ми вже зв’язалися з ним — цікавіться, стежте за майбутнім інтерв’ю.)

Вчитель Циньтянь щиро поділився зі спільнотою у Твіттері та відверто розповів про свій шлях — від закінчення фронтенд-спеціальності після перекладу з коледжу, через багато невдач, до отримання пропозиції роботи в великий компанії Шанхаю завдяки своїм відкритим проектам та інструментам. Ключові слова приблизно такі:

Початок з сільської місцевості, перехід з коледжу на бакалавріат, самостійне вивчення фронтенду, постійні проблеми з перевіркою фону, відкритий код як доказ своїх здібностей.

Після іспитів у 2018 році вчитель Цяньтянь вступив до коледжу на спеціальність «Комп’ютерні застосування», і в той рік він вважав, що його стан був жахливим…

Пізніше він пройшов підготовку зі спеціаліста на бакалавра та вступив на програму програмної інженерії у Чунцинському університеті зв’язку та інформаційних технологій, зайнявши перше місце серед усіх кандидатів у цьому наборі.

Під час стажування вчитель Цяньдянь був дуже щасливий і вважав:

Якщо я просто продовжуватиму прикладати зусилля, майбутнє обов’язково стане кращим.

Але осінній набір жорстко охолодив його:

Під час інтерв’ю на стажуванні у Університеті Сіху, коли HR знову зробила акцент на його освітньому рівні зі ступенем «спеціаліст після середньої освіти», він вже не зміг утриматися:

Походження з бідності — не позор!

Він успішно пройшов.

Але це був лише інтернship; на шляху до працевлаштування晴天 вчитель ніколи не отримував офіційних пропозицій від жодної компанії.

З минулого року до березня цього року йому довелося постійно переміщатися по стажуванням, щоб набиратися досвіду:

Пізніше він нарешті зустрів першого покровителя у своїй кар'єрі — Цзє Ченя, тодішнього chief operating officer компанії Manus.

△

Вона порадила йому, що, можливо, може довести свою здатність через твори або відкриті проекти з інших джерел.

Цей вислів підтверджує думку, яку Сонячний день завжди приховував у серці:

Освіту вже не змінити; як би ви не пояснювали, інші все одно бачитимуть диплом про підвищення кваліфікації.

Також стало наміткою для подальшої історії Archify.

Тож він почав шлях відкритого коду і перетворив свої твори на свою другу резюме:

Нарешті, він, опираючись на те, що сам побудував, отримав пропозицію від великої компанії:

Пізніше Archify став популярним, і він нарешті міг скористатися цією можливістю, щоб розповісти всім про ці глибоко приховані в його серці невдоволення та непевність:

Відкрите код не перетворив мене зі спеціаліста на 985, і не гарантує, що я в майбутньому більше не зустріну проблем через освіту; зараз я навіть не можу чітко сказати, що мені принесуть ці зірки.

Але нарешті він зітхнув:

Хоча б зараз Archify дійсно використовують, і те, що мої розробки можуть принести користь іншим, допомогти багатьом, — це для мене найбільший сенс від відкритого коду.

Поза дипломом, він власноруч склав нове резюме, яке складається з реальних робіт, відгуків користувачів та спільноти.

Його історія надає надію більшості студентів, які стикаються з труднощами через недостатній освітній рівень.

А про історію Archify все ще триває.

Цей матеріал зі сторінки WeChat «Quantum Bit», автор: слідкуйте за передовими технологіями