Skip to content

uixray/DesignOps

BranchesTags

Repository files navigation

DesignOps Logo

DesignOps Assistant

Middleware for Designers — an AI-powered productivity tool for UI/UX designers on Windows

Features • Installation • Configuration • Architecture • Русский

✨ Features

🤖 AI Spotlight (Alt + J)

A Cmd+K style fuzzy-search window for instant access to AI prompts. Select text, press the hotkey, and pick a command — the AI response streams in real-time with a typing animation.

  • Context-Aware — automatically adapts responses based on your active application:

    Active App Behavior
    Figma Concise UX copy, no markdown, sentence case
    Obsidian Valid Markdown syntax, structured notes
    VS Code Raw code only, no markdown fences
    Telegram Conversational tone
    Chrome Concise assistant mode

  • Multi-Provider — switch between AI backends per-prompt or globally:

    Provider Type Default Endpoint
    LM Studio Local http://localhost:1234/v1/chat/completions
    Ollama Local http://localhost:11434/v1/chat/completions
    OpenAI Cloud https://api.openai.com/v1/chat/completions
    DeepSeek Cloud https://api.deepseek.com/v1/chat/completions
    Claude Cloud https://api.anthropic.com/v1/messages
    YandexGPT Cloud https://llm.api.cloud.yandex.net/foundationModels/v1/completion

  • Preview + Actions — after AI responds, choose: ✅ Insert, 🔄 Retry, or ❌ Cancel

  • Auto-Fallback — if the prompt's preferred provider fails, retries with the default

  • Quick Rewrite (Shift+Alt+D) — instantly rewrites selected text using the first prompt

  • Custom Prompt Input — free-form queries via "📝 Другой запрос..."

⌨️ Smart Typography (Design Mode)

Professional typographic characters accessible through simple hotkeys:

Hotkey Character Description
Alt + - — Em dash
Alt + Shift + - − Minus sign (math)
Alt + . … Ellipsis
Alt + Space Non-breaking space (NBSP)
Ctrl + Alt + Space Thin space
Alt + X × Multiplication sign
Alt + R ₽ Ruble sign
Alt + [ « Left guillemet
Alt + ] » Right guillemet
Alt + ' ́ Combining accent mark

🛠️ Tools

Hotkey Function
CapsLock Toggle Design Mode ON/OFF (all hotkeys only work when ON)
Alt + J AI Spotlight — fuzzy search through prompts
Shift + Alt + D Quick Rewrite — apply first prompt to selected text
Alt + S Text Snippets — instant paste of saved templates
Alt + P Figma Plugin Launcher — run plugins by name
Shift + Alt + C Cycle Case — lower → Title → UPPER
Win + F Figma Deep Link — open figma.com URL in desktop app

🎨 Built-in Prompts

The default configuration includes prompts optimized for designers:

Prompt Description
✨ Improve Text Professional editor rewrite
📝 Fix Grammar Proofreading without style changes
🖋️ Typographer Russian typography standards (Lebedev-style)
🇺🇸/🇷🇺 Translate Auto-detect and translate RU↔EN
📢 Tone: Official Formal business rewrite
🤝 Tone: Friendly Conversational rewrite
⚠️ Tone: Error UX-friendly error messages
💡 5 Headlines Generate headline variations
🎨 Color Palette Suggest colors from text mood
🐟 Smart Dummy Text Context-aware placeholder text
🐍 Explain Code Code explanation in bullet points
🧹 Refactor Code Clean code refactoring
⚡ Optimize CSS CSS/SCSS optimization
regex Regex Generator Generate regex patterns

📦 Installation

Prerequisites

Setup

git clone https://github.com/user/DesignOps.git
cd DesignOps

  1. Copy configuration templates:

    copy settings.ini.example settings.ini
copy data.json.example data.json

  2. Edit settings.ini — add your API key for the desired provider

  3. Run DesignOps.ahk (double-click or right-click → "Run with AutoHotkey")

  4. The tray icon appears — right-click for Settings, Reload, or Exit

💡 Tip: For free local testing without API keys, use LM Studio or Ollama

Compiling to EXE (Optional)

  1. Open Ahk2Exe (ships with AutoHotkey)
  2. Select DesignOps.ahk as Source
  3. Click Convert → produces a standalone DesignOps.exe

⚙️ Configuration

Right-click the tray icon → ⚙️ Настройки to open the Settings window (8 tabs, dark theme, Mica blur).

Tab 1 — System

  • Enable/disable sound effects
  • Manage AI Provider profiles (add, delete, switch)
  • Enter API endpoint URL, API key, model name, temperature, timeout
  • Test Connection button to verify API access

Tab 2 — AI Prompts

  • Create, edit, reorder, and delete prompts
  • Assign a preferred provider per prompt (or use default)
  • Toggle Ignore Context Rules for raw task execution
  • First prompt in list = Quick Rewrite target (Shift+Alt+D)

Tab 3 — Context Rules

  • Define per-application system instructions
  • Key = executable name (e.g., Figma.exe), Value = instruction text
  • AI appends these rules automatically when that app is active

Tab 4 — Snippets

  • Manage text templates for instant paste
  • Supports multi-line content (signatures, boilerplate, etc.)

Tab 5 — Figma Plugins

  • Configure plugin names and subcommands
  • Works via Figma's Quick Actions (Ctrl + /)

Tab 6 — App Launcher

  • Map hotkeys to launch applications
  • Browse for .exe files, assign any key combination

Tab 7 — Hotkeys

  • Customize all keyboard shortcuts
  • Visual hotkey pickers for each function

Tab 8 — Help

  • Built-in reference with all features and shortcuts

Configuration Files

File Purpose Tracked by Git
settings.ini API keys, hotkeys, system preferences ❌ No (contains secrets)
data.json Prompts, snippets, context rules, plugins ❌ No (user data)
settings.ini.example Clean configuration template ✅ Yes
data.json.example Example prompts and snippets ✅ Yes

⚠️ Security Note: API keys stored in settings.ini are obfuscated (XOR) but not strongly encrypted. Never share your settings.ini file. Both settings.ini and data.json are excluded via .gitignore.

🏗️ Architecture

Hybrid Monolithic Kernel + Micro-Service Worker pattern:

┌─────────────────────────────────────────────────────┐
│  DesignOps.ahk  (Entry Point)                       │
│  • Global hotkeys, CapsLock toggle, tray menu       │
│  • Bootstrap: RegisterAppHotkeys, RegisterActive... │
├─────────────────────────────────────────────────────┤
│  Runtime.ahk  (Core Engine)                         │
│  ┌─────────────┐  ┌──────────────┐  ┌────────────┐ │
│  │ AI Spotlight │  │ Context      │  │ Clipboard  │ │
│  │ (Fuzzy UI)  │  │ Engine       │  │ Manager    │ │
│  └──────┬──────┘  └──────────────┘  └────────────┘ │
│         │                                           │
│  ┌──────▼──────────────────────────────────────┐    │
│  │  AIWorkerManager (Stdin/Stdout IPC)         │    │
│  │  • Launches AI_Runner.ahk as subprocess     │    │
│  │  • JSON protocol over pipes                 │    │
│  │  • Auto-restart on crash                    │    │
│  └──────┬──────────────────────────────────────┘    │
├─────────┼───────────────────────────────────────────┤
│  Config.ahk  (Data Layer)                           │
│  • INI read/write (settings, hotkeys, profiles)     │
│  • JSON read/write (prompts, snippets, context)     │
│  • XOR obfuscation for API keys                     │
│  • Atomic save (tmp → rename) for crash safety      │
├─────────┼───────────────────────────────────────────┤
│  GUI.ahk  (Settings Window)                         │
│  • 8-tab dark-themed interface                      │
│  • DWM Mica/Acrylic blur, rounded corners           │
│  • Dark scrollbars via SetWindowTheme               │
└─────────┼───────────────────────────────────────────┘
          │ Stdin/Stdout (JSON)
┌─────────▼───────────────────────────────────────────┐
│  AI_Runner.ahk  (Isolated Worker Process)           │
│  • WinHttp.WinHttpRequest.5.1                       │
│  • Supports OpenAI-compatible + YandexGPT APIs      │
│  • UTF-8 binary payload for Cyrillic support        │
│  • Logs to AI_Runner.log                            │
└─────────────────────────────────────────────────────┘

Key Design Decisions

  • No UI freeze — AI requests run in a child process communicating via pipes
  • Transactional clipboard — Backup → Set → Paste → Restore pattern prevents data loss
  • Atomic JSON save — Write to .tmp → backup original to .bak → rename .tmp
  • Meta-Prompt injection — global system instruction prepended to every request ensures consistent raw output
  • Language detection — percentage-based Cyrillic/Latin analysis (30% threshold) for automatic response language

📁 Project Structure

DesignOps/
├── DesignOps.ahk            # Entry point, global hotkeys, CapsLock controller
├── Lib/
│   ├── Runtime.ahk          # AI engine, Spotlight UI, context, menus, tools
│   ├── GUI.ahk              # Settings window (class-based, 8 tabs, dark theme)
│   ├── Config.ahk           # INI/JSON storage, AI profiles, encryption
│   ├── AI_Runner.ahk        # Isolated HTTP worker process
│   ├── JSON.ahk             # JSON parser/serializer (thqby, HotKeyIt)
│   ├── UI_Concept.ahk       # Visual prototype / reference implementation
│   ├── Architecture.md      # Architecture documentation
│   └── Help.txt             # Built-in help content (displayed in Settings)
├── Logo Color.ico           # Tray icon (Design Mode ON)
├── Logo Dark.ico            # Tray icon (Design Mode OFF)
├── SwitchOn.wav             # Sound effect (mode ON)
├── SwitchOff.wav            # Sound effect (mode OFF)
├── settings.ini.example     # Configuration template (copy to settings.ini)
├── data.json.example        # Data template (copy to data.json)
├── LICENSE                  # MIT License
└── .gitignore               # Excludes settings.ini, data.json, logs, backups

🤝 Contributing

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/my-feature
  3. Commit changes: git commit -m "Add my feature"
  4. Push: git push origin feature/my-feature
  5. Open a Pull Request

Development Tips

  • Run DesignOps.ahk directly — no build step needed
  • AI Worker logs to Lib/AI_Runner.log for debugging
  • Use LM Studio or Ollama for free local testing without API keys
  • All UI windows use DWM dark mode — test on Windows 10 1809+ or Windows 11

📄 License

MIT — Created by Ray

📌 О проекте

DesignOps Assistant — инструмент автоматизации для UI/UX дизайнеров на Windows. Объединяет AI-ассистента, профессиональную типографику, текстовые сниппеты и интеграцию с Figma в одном легковесном интерфейсе.

Философия: Middleware for Designers — посредник между вашими намерениями и рабочими инструментами.

Возможности

🤖 AI Spotlight (Alt+J)

Окно быстрого поиска в стиле Cmd+K с нечётким поиском по промптам. Выделите текст, нажмите хоткей, выберите команду — ответ AI печатается в реальном времени.

  • Контекстная адаптация — автоматически подстраивает ответы под активное приложение (Figma → краткие UX-тексты, Obsidian → Markdown, VS Code → чистый код)
  • Мульти-провайдер — переключение между нейросетями на лету (LM Studio, Ollama, OpenAI, DeepSeek, Claude, YandexGPT)
  • Предпросмотр + действия — после ответа выбирайте: ✅ Вставить, 🔄 Повторить, ❌ Отмена
  • Авто-фоллбэк — если назначенный провайдер недоступен, запрос уходит на дефолтный
  • Быстрая перезапись (Shift+Alt+D) — мгновенно переписывает выделенный текст первым промптом
  • Свободный ввод — отправка произвольного запроса через "📝 Другой запрос..."

⌨️ Типографика (в режиме Design Mode)

Хоткей Символ Описание
Alt + - — Длинное тире
Alt + Shift + - − Минус (математический)
Alt + . … Многоточие
Alt + Space Неразрывный пробел (NBSP)
Ctrl + Alt + Space Узкий пробел (Thin Space)
Alt + X × Знак умножения
Alt + R ₽ Знак рубля
Alt + [ « Левая кавычка-ёлочка
Alt + ] » Правая кавычка-ёлочка
Alt + ' ́ Знак ударения

🛠️ Инструменты

Хоткей Функция
CapsLock Переключатель Design Mode ВКЛ/ВЫКЛ
Alt + J AI Spotlight — нечёткий поиск по промптам
Shift + Alt + D Быстрая перезапись — применяет первый промпт
Alt + S Сниппеты — мгновенная вставка шаблонов
Alt + P Запуск плагинов Figma
Shift + Alt + C Смена регистра: lower → Title → UPPER
Win + F Deep Link — открыть Figma-ссылку в десктопном приложении

🎨 Встроенные промпты

Промпт Описание
✨ Улучшить текст Редактура и улучшение
📝 Исправить грамматику Корректура без изменения стиля
🖋️ Типограф (Лебедев) Типографика по стандартам
🇺🇸/🇷🇺 Перевод Автоопределение языка и перевод
📢 Tone: Official Официальный тон
🤝 Tone: Friendly Дружелюбный тон
⚠️ Tone: Ошибка UX-friendly сообщение об ошибке
💡 5 Идей заголовков Варианты заголовков
🎨 Цветовая палитра Палитра цветов по настроению текста
🐟 Рыба-текст Умный плейсхолдер (не Lorem Ipsum)
🐍 Объяснить код Объяснение кода по пунктам
🧹 Рефакторинг кода Оптимизация кода
⚡ Оптимизировать CSS Оптимизация CSS/SCSS
regex Генератор Regex Генерация регулярных выражений

Установка

Требования

Шаги

git clone https://github.com/user/DesignOps.git
cd DesignOps
copy settings.ini.example settings.ini
copy data.json.example data.json
  1. Отредактируйте settings.ini — укажите API-ключ провайдера
  2. Запустите DesignOps.ahk
  3. Иконка появится в трее — правый клик для настроек

💡 Совет: Для локального тестирования без API-ключей используйте LM Studio или Ollama

Настройка

Правый клик по иконке в трее → ⚙️ Настройки — откроется окно с 8 вкладками:

  1. System — профили AI-провайдеров, звуки, тест соединения
  2. AI Prompts — создание/редактирование промптов, назначение провайдера
  3. Context — правила контекста для каждого приложения
  4. Snippets — текстовые шаблоны для быстрой вставки
  5. Figma Plugins — настройка плагинов для запуска через Quick Actions
  6. App Launcher — хоткеи для запуска приложений
  7. Hotkeys — настройка всех горячих клавиш
  8. Help — встроенная справка

Файлы конфигурации

Файл Назначение В Git
settings.ini API-ключи, хоткеи, настройки системы ❌ Нет (секреты)
data.json Промпты, сниппеты, правила контекста ❌ Нет (данные)
settings.ini.example Чистый шаблон конфигурации ✅ Да
data.json.example Примеры промптов и сниппетов ✅ Да

⚠️ Безопасность: API-ключи в settings.ini обфусцированы (XOR), но не зашифрованы криптостойким алгоритмом. Никогда не делитесь файлом settings.ini. Оба файла исключены из Git через .gitignore.

Архитектура

Гибридный паттерн: Monolithic Kernel + Micro-Service Worker

  • Основной поток обрабатывает UI, хоткеи и буфер обмена
  • AI-запросы выполняются в изолированном дочернем процессе (Stdin/Stdout IPC)
  • Никаких зависаний интерфейса при ожидании ответа от API
  • Атомарное сохранение данных (.tmp → .bak → rename) для защиты от потерь
  • Мета-промпт инжектируется перед каждым запросом для стабильного поведения AI

Лицензия

MIT — Создано Ray

About

AI-powered productivity tool for UI/UX designers on Windows. Context-aware AI assistant, smart typography, text snippets, Figma integration. AutoHotkey v2.

Resources

Readme

License

MIT license
Activity

Stars

1 star

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages