Archify

Преобразуйте всё, что вы хотите понять, спланировать или поделиться, в интерактивную визуализацию.

Начните с идеи, вопроса или плана. Опишите её вашему агенту ИИ, и Archify превратит её в интерактивный HTML, который можно исследовать, настраивать и делиться. От маршрутов путешествий и карт обучения до сложных систем — сделайте это своим.

Узнайте, что создаёт сообщество, и представьте, что вы могли бы сделать дальше.

Живые демо  ·  Начать работу  ·  Руководство по сценариям  ·  Сообщество  ·  简体中文

❤️ Партнёры и спонсоры: Kimi Work · Supercode · EverMind/Raven

Увидеть Archify в действии

_{Три реально сгенерированных артефакта. Signal Flow · Blueprint · Classic · открыть интерактивную Proof Lab ↗}

Нажмите на предпросмотр, чтобы открыть реальные интерактивные артефакты. GIF показывает движение; HTML позволяет исследовать его самостоятельно.

Установите, затем опишите свою идею

Работает с Cursor, Claude Code, Codex CLI и OpenCode. Ниже приведены варианты установки для дополнительных интеграций.

npx skills add tt-a1i/archify -g

Отправьте это вашему агенту:

Use Archify to diagram a web request: Browser calls the API,
the API checks Redis, and a cache miss queries PostgreSQL and fills the cache.

Затем продолжите: «Добавить аутентификацию», «Выделить путь с промахом кэша» или «Переключиться на светлую тему».

Репозиторий не требуется: начните с описания или попросите агента прочитать репозиторий для создания архитектурной диаграммы на основе исходников.

Выберите своего агента · Подробности установки и проверка обновлений

❤️ Спонсоры

Archify × Kimi Work. Найдите Archify в магазине плагинов Kimi Work как Интерактивная архитектурная диаграмма. Опишите свою систему в одном предложении, чтобы создать интерактивную диаграмму. Попробуйте в Kimi Work →

supercode.sh	Supercode спонсирует Archify и улучшает Codex и Cursor за счёт оптимизации токенов, отобранных навыков (Skills) и разработки на основе спецификаций. Archify представлен как навык Выбор редактора Supercode.
EverMind · Raven	EverMind поддерживает Archify и создаёт инфраструктуру памяти для агентов. Его фреймворк Raven поддерживает Archify в качестве навыка для проверенных интерактивных карт систем.

Хотите спонсировать Archify? Свяжитесь с нами по электронной почте.

Покажите, что важно

Описать рабочий процесс агента	Следовать за промахом кэша	Исследовать взаимосвязи между сервисами
Пройдите по шагам, определённым на диаграмме.	Выделите путь от веб-приложения к базе данных.	Сосредоточьтесь на созданных соединениях бэкенда и базы данных.

В Proof Lab содержатся все 11 проверенных сценариев, их JSON-источники, именованные представления и подтверждения валидации.

Поймите реальный репозиторий

_{КОД → ДИАГРАММА · Карта системы с обоснованием источником}

Archify проследил mco-org/mco на коммите 9f1a1cf и сгенерировал эту проверенную карту. Откройте её ↗ · проследить доступность ↗ · источник с типом

Легко расширяемо. Больше способов сделать его своим.

_{ИСТОРИИ СООБЩЕСТВА · Выбранные примеры, поделённые пользователями}

Продолжайте разработку после генерации диаграммы. Archify — это открытый исходный код, а его вывод — это независимый HTML-файл. Попросите своего агента адаптировать его, добавить полезные ссылки или включить интерактивные элементы для вашего собственного рабочего процесса. Создания сообщества уже охватывают командное сотрудничество, планирование путешествий, проверку юридических ссылок, ревью контрактов и ретроспективы инцидентов. Вот лишь несколько примеров.

Один пользователь начал с нарисованной вручную многоагентной архитектуры, превратил её в интерактивную диаграмму, а затем добавил пул выполнения Kimi через диалог. Другие попросили своего агента прочитать проект и перенесли полученную архитектуру в Feishu или DingTalk для обсуждения с командой.

Другой пользователь превратил гид по прогулкам по Шанхаю в четырёхдневный маршрут: переключайтесь между днями, изучайте остановку и переходите к Amap, Xiaohongshu или Dianping. Автор также добавил проверки прибытия и заметки к остановкам, превратив маршрут в небольшой инструмент для использования во время поездки. Эти расширения были добавлены автором сообщества для этого конкретного артефакта.

▶ Исследуйте интерактивный маршрут по Шанхаю

▶ Попробуйте интерактивную версию · Переключайтесь между D1–D4 и нажимайте на место, чтобы исследовать его.

_{Артефакт сообщества · Прогулка по Шанхаю · Четыре дня маршрутов и ссылок на места}

Скачайте, откройте, исследуйте.

Вывод — это автономный HTML-файл. Скачайте его и откройте в браузере, чтобы использовать детали узлов, исследование путей и руководства по главам, включённые в этот артефакт. Установка Archify не требуется для просмотра. Отправьте HTML-файл кому-то другому, и интерактивные элементы останутся с ним; внешние веб-сайты и ссылки на карты требуют подключения к сети.

Исследуйте маршрут по Шанхаю ↗ · Скачать HTML ↓

_{Попробуйте переключаться между D1–D4, открывать карточку места или следовать ссылке на карту. Временные и пространственные данные отражают оригинальный маршрут автора.}

Общественность и признание

• #1 в списке репозиториев GitHub Trending за неделю по всем языкам. Скриншот рейтинга, опубликованный создателем 1 сентября 2026 года, с отображением всех языков и фильтром «Эта неделя».
• Отмечен и проинтервьюирован QbitAI. Освещение проекта · История разработчика.
• Разделен с сообществами разработчиков. Пост midudev.

_{Выборка публичных упоминаний, общих публикаций и исторических вех. Следуйте по ссылкам для дат и источников.}

Предпросмотр

Темы, экспорт и карточки для sharing

Один и тот же диаграмма, две темы, переключение одним кликом:

Тёмная	Светлая

В меню Экспорт копируется PNG в буфер обмена и загружаются статические или анимационные форматы:

Используйте Копировать карточку для sharing, если хотите получить каноничное изображение размером 1200×630 для README, релиза или поста в соцсетях.

После прослеживания маршрута Экспорт → Карточка маршрута для sharing загружает проложенный путь как PNG размером 1200×630 с сохранением полной диаграммы для контекста.

После прослеживания авторских участков Upstream или Downstream Экспорт → Карточка охвата для sharing фиксирует точное чтение без влияния на время выполнения.

Откройте локально examples/web-app.html, чтобы попробовать полный просмотрщик.

Быстрый старт

Текущая версия разработки: v2.17.0-dev.1. См. Журнал изменений.

1. Установка

npx skills add tt-a1i/archify -g

Дополнительные варианты установки и детали проверки обновлений

Для явной, неинтерактивной установки Cursor:

npx -y skills add tt-a1i/archify --skill archify --agent cursor --global --copy --yes

Чтобы попробовать без установки:

npx skills use tt-a1i/archify@archify --agent codex

Участие сообщества DSH: dsh plugin --profile web add @tt-a1i/archify-dsh@0.1.0

Переключатель агентов поддерживает cursor, codex, claude-code и opencode.

Archify может получить фиксированный стабильный манифест только для отображения опционального напоминания; он никогда не загружает или устанавливает обновления. Успешные проверки ждут около 72 часов (±20%); активное использование повторяет неудачи через 6, затем 24 часа. Сервер видит стандартные HTTP-метаданные (IP и время), но не получает версию, агента, данные проекта, запросы, идентификаторы аккаунта/устройства или ETag. Вы решаете, когда и нужно ли обновлять. Установите ARCHIFY_UPDATE_CHECK_DISABLED=1, чтобы отключить сетевые подключения и запись состояния напоминаний.

2. Начать с описания — репозиторий не требуется

Use Archify to draw: Browser -> API -> Redis cache -> PostgreSQL fallback.

Для доказательства источника откройте репозиторий и задайте вопрос:

Analyze this repository, then use archify to create a high-level runtime architecture diagram.
Show 8–12 core components, one primary path, external dependencies, and trust boundaries.
Put supporting detail in cards instead of adding more edges.

3. Уточнение в чате

Продолжайте с фокусированными запросами, такими как добавить Redis, переместить auth влево или выделить путь отката. Archify сохраняет введённый источник для целенаправленной итерации.

Выберите правильный тип диаграммы

Пять типов диаграмм, сравнения архитектур и примеры

Профиль архитектуры с опциональной deployment-ownership завершает работу с ошибкой, если отсутствуют авторские владельцы, размещение в регионе, область частной базы данных или именованные пересечения; он никогда не подразумевается и не проверяет живую инфраструктуру. См. проверенное доказательство развёртывания.

Для дизайна или проверки PR Архитектурная дельта сравнивает проверенные снимки Before / Delta / After с машинным подтверждением. Выберите авторское изменение или воспроизведите одно конечное, доступное только для просмотра Review; он не подразумевает никакого влияния, риска или безопасности слияния.

node archify/bin/archify.mjs compare architecture base.json head.json architecture-delta.html --json

Не уверены, какой подходит? Воспользуйтесь интерактивным гидом по сценариям или обратитесь к CLI без зависимостей:

node archify/bin/archify.mjs guide "Show an API request with Redis cache miss"
node archify/bin/archify.mjs guide "Map Kafka topics, consumer groups, replay, and DLQ" --json

Рабочий процесс сохраняет счастливый путь ясным через полосы:

Последовательность объясняет одну взаимодействие во времени:

Поток данных делает движение и границы чувствительности явными:

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

Примеры архитектуры: web-app · Archify pipeline · grid placement · desktop agent

Почему Archify

Инженерная основа опыта

• Размещение по сути, а не универсальный авторазмещение — агент выбирает иерархию, отступы, маршруты и акценты; общие автоматические конечные точки распределяются детерминированно, а не наваливаются стрелками на одну среднюю точку.
• Типизированный JSON IR — у каждого рендеринга есть схема и воспроизводимый исходник.
• Атомарная валидация перед доставкой — проверки схемы, размещения, HTML/SVG, маршрутов и соответствия меток маршрутам должны пройти успешно, прежде чем артефакт заменяет последний проверенный вывод.
• Ошибки приходят с рецептом исправления — команды validate --json и deliver --json возвращают стабильные коды правил, точную сущность, измеренные доказательства и только поддерживаемые инструменты для исправления, а не стек вызовов или неструктурированную попытку повтора.
• Предпросмотр последней проверенной версии — опциональный десктопный цикл отслеживает один JSON-файл, обновляет только после успешной проверки последней версии и сохраняет предыдущую проверенную диаграмму видимой, если сохранение не завершено или недействительно.
• Честное взаимодействие — фокус, охват вверх/вниз по потоку, точные маршруты, сравнение ролей и истории повторно используют авторские узлы и взаимосвязи вместо изобретения топологии или претензий на влияние во время выполнения.
• Доказательства из исходника, только по запросу — Узлы Архитектуры с доказательствами отмечают себя как SRC n и открывают файлы с проверенными Git-коммитами и диапазонами строк, закреплённые за одним публичным коммитом; обычные артефакты остаются без привязки к исходнику.
• Переносимость по умолчанию — результат — один файл HTML; экспорты остаются полными диаграммами и свободными от временного состояния просмотра.

Archify — это не универсальный редактор рисунков или тема для Mermaid. Он превращает техническое намерение в артефакт коммуникации.

Как это работает

Детали генерации, валидации, предпросмотра и доставки

Полезные команды репозитория:

cd archify
node bin/archify.mjs doctor
node bin/archify.mjs demo /tmp/archify-demo
node bin/archify.mjs guide "Show CI/CD checks, approval, deploy, and rollback"
node bin/archify.mjs validate workflow examples/agent-tool-call.workflow.json --quality showcase --json
node bin/archify.mjs preview workflow examples/agent-tool-call.workflow.json /tmp/workflow.html --quality showcase
node bin/archify.mjs deliver workflow examples/agent-tool-call.workflow.json /tmp/workflow.html --quality showcase --open --json

preview — это явный режим обратной связи только на десктопе: он отслеживает один JSON-файл на случайном порту 127.0.0.1, сохраняет последний проверенный вывод даже при ошибках, останавливается по Ctrl-C и не добавляет никаких сгенерированных HTML-компонентов во время выполнения. Используйте --no-open для тестов или ручного открытия URL.

deliver --open — это однократная передача после коммита с опцией включения. Неудача открытия сохраняет успех; JSON остаётся на stdout, а абсолютный резервный путь идёт в stderr.

При ошибке команды validate --json и deliver --json выводят один JSON-объект. Применяйте только исправления supportedFixes для каждой сущности diagnostics[], в пределах двух раундов коррекции Skill; визуальный просмотр остаётся отдельным.

Настройки:

{
"meta": {
  "locale": "en",
  "animation": "trace",
  "visual_preset": "signal-flow"
}
}

meta.locale=en|zh-CN локализует заголовок страницы, легенду, состояния/ошибки, a11y, атрибуты lang в HTML/SVG — но никогда не изменяет авторский контент. В противном случае опускайте; сохраняйте текст на запрошенном языке; уточняйте о резервном английском варианте. Статические настройки опускают animation; classic по умолчанию.

Исследуйте и поделитесь результатом

Полный контракт генерации и просмотра находится в archify/SKILL.md.

Варианты установки

Справочник и область применения

• Справочник схемы · Навык · Примеры · Кухонная книга агента
• Журнал изменений
• Дорожная карта
• Сгенерированная лаборатория доказательств

Автоматическая разборка Mermaid, универсальная авторазметка, хостинг совместного использования и редактирование "что видишь, то и получаешь" (WYSIWYG) намеренно находятся за пределами текущей области применения.

Сообщество

👋 Добро пожаловать в сообщество Archify!

Общайтесь с другими пользователями и разработчиками, делитесь идеями, запрашивайте новые функции, сообщайте об ошибках, обсуждайте разработку и вместе делайте Archify лучше.

• Discord
• WeChat: отсканируйте QR-код ниже. Коды групп WeChat истекают периодически; если этот истёк, запросите текущий код через Discord или QQ.
• Группа QQ: 1121948602

WeChat

QQ

Лицензия

MIT — свободно для использования, модификации и распространения.

Вклад

Приветствуются вопросы, pull-запросы и реальные диаграммы. Начните с руководства по внесению изменений, используйте форму воспроизводимого баг-репорта для ошибок или отправляйте валидированную диаграмму через форму демонстрации сообщества. · LINUX DO

История звезд