# aardio/imtip architecture

> Architecture diagram of the GitHub repository aardio/imtip, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-10-31). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aardio/imtip
- Repository: https://github.com/aardio/imtip

## Overview

##### Project type and purpose
- This is a desktop‐assistant application (“ImTip 智能桌面助手”) written in the Aardio scripting language.

##### File structure
- Top level:
- main.aardio – entry point
- default.aproj – Aardio project file
- lib/ – core library modules, subdivided into:
– app/ (filterWindows, hotkey, jab wrapper for Java AccessBridge, util submodules)
– fonts (embedded font resources)
– config.aardio, style.aardio, tsfInput.aardio (input‐state tracking)
- codes/ – sample .aardio scripts (filter.aardio, hotkey.txt)
- screenshots/ – documentation images
- No separate “frontend/backend” folders; it’s a monolithic, event‐driven desktop tool.

##### Key insights from README
- Hooks into IME and keyboard state (tsfInput, filterWindows)
- Defines programmable hotkeys (lib/app/hotkey) that can call AI or local utilities
- Dialogs for AI chat, settings, search (dlg/*.aardio)
- Uses external Aardio extension libraries (string.words, table.coca2000, web.edgeTextToSpeech, java.accessBridge)
- Tray menu for quick toggles (lib/ui/appTrayMenu)

##### Core components
a. Main components:
1) Aardio Runtime (the standalone EXE engine)
2) Main Script (main.aardio + default.aproj)
3) Core Libraries (lib/*)
– Input‐State Tracker (tsfInput, filterWindows)
– Hotkey Manager (lib/app/hotkey)
– UI Modules (tray menu, colorPicker, pinyinMenu)
– Utility & Config (style, config, fonts)
4) Dialog Layer (dlg/*.aardio windows and templates)
5) Sample/Extension Scripts (codes/)
6) External Dependencies:
– OS hooks (IME, keyboard)
– Aardio extension libs (JAB, speech)
– AI/Cloud APIs (translation, dictionary, large-model chat)
7) Assets (images, screenshots, fonts)

b. Relationships & interactions:
- The Aardio Runtime launches main.aardio → loads default.aproj → initializes config → registers input‐state tracker and hotkey listeners.
- Hotkey Manager listens for defined key combos → invokes either local utilities (math, date format) or AI/Cloud API calls (via web.edgeTextToSpeech or custom HTTP calls) → opens AI Chat dialog.
- Tray Menu UI provides toggles for features (super hotkeys, IME state hints) → triggers config updates.
- Utility modules provide shared functions (clipboard, theming, JSON parsing, etc.).

c. Architectural patterns & principles:
- Modular layering: Core (input + hotkey) → UI → Dialogs → Extensions
- Event‐driven, callback‐based communication
- Plug‐in extensibility via “codes” and external Aardio libraries
- Single‐process, in‐memory modules for low latency

d. Key technologies/frameworks:
- Aardio scripting runtime & project system
- Windows IME/TSF APIs (tsfInput.aardio)
- Java Access Bridge (via lib/app/jab.aardio)
- Web/Edge TTS (web.edgeTextToSpeech)
- External AI APIs (HTTP calls, JSON)

##### Detailed capture of essential elements
- Don’t omit:
- The “codes” folder (extensibility demos)
- External extension libraries (JAB, TTS)
- The event bus/callback chain between input tracker → UI → dialogs
- Tray menu as an entry point for toggling features

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Execution Layer
    Runtime["Aardio Runtime (EXE)"]:::external
    Main["Main Script\n(main.aardio, default.aproj)"]:::core

    Runtime --> Main

    %% Core Libraries
    subgraph "Core Libraries"
        TSF["tsfInput.aardio"]:::core
        FWin["filterWindows.aardio"]:::core
        HK["Hotkey Manager\n(hotkey.aardio)"]:::core
        UTIL["Utility Library\n(util/_.aardio)"]:::core
        CfgLoad["Config Loader\n(config.aardio)"]:::core
        StyleDef["Style Definitions\n(style.aardio)"]:::core
    end

    Main --> TSF
    Main --> FWin
    Main --> HK
    Main --> UTIL
    Main --> CfgLoad
    Main --> StyleDef

    %% UI Modules
    subgraph "UI Modules"
        Tray["Tray Menu\n(appTrayMenu.aardio)"]:::ui
        CP["Color Picker\n(colorPicker.aardio)"]:::ui
        PM["Pinyin Menu\n(doublePinyinMenu.aardio)"]:::ui
    end

    TSF --> Tray
    HK --> Tray
    UTIL --> Tray

    Tray --> CP
    Tray --> PM

    %% Dialog Layer
    subgraph "Dialog Layer"
        AI["AI Chat Window\n(aiChat.aardio)"]:::ui
        SET["Settings Window\n(frmSetting.aardio)"]:::ui
        SRCH["Search Window\n(frmSearch.aardio)"]:::ui
        ICON["Icon Font Window\n(frmIconFont.aardio)"]:::ui
        TPL["Dialog Template\n(template.aardio)"]:::ui
        DlgImg["Dialog Assets\n(images/)"]:::ui
    end

    Tray --> SET
    Tray --> SRCH
    HK --> AI
    CP --> ICON
    TPL --> AI
    TPL --> SET
    TPL --> SRCH
    TPL --> ICON
    TPL --> DlgImg

    %% External & OS
    subgraph "External & OS"
        OS["OS Hooks\n(IME, Keyboard)"]:::external
        JAB["Java AccessBridge\n(jab.aardio)"]:::external
        TTS["Web Edge TTS\n(edgeTextToSpeech)"]:::external
        API["AI/Cloud APIs"]:::external
    end

    TSF --> OS
    HK --> API
    HK --> TTS
    HK --> JAB

    %% Assets & Samples
    subgraph "Assets & Samples"
        FASub["fontAwesomeSub.aardio"]:::asset
        ImtipFont["imtip.aardio"]:::asset
        CODE1["filter.aardio"]:::asset
        CODE2["hotkey.txt"]:::asset
        DOC["screenshots/"]:::asset
    end

    UTIL --> FASub
    UTIL --> ImtipFont
    Main --> CODE1
    Main --> CODE2
    Main --> DOC

    %% Click Events
    click Main "https://github.com/aardio/imtip/blob/main/main.aardio"
    click TSF "https://github.com/aardio/imtip/blob/main/lib/tsfInput.aardio"
    click FWin "https://github.com/aardio/imtip/blob/main/lib/app/filterWindows.aardio"
    click HK "https://github.com/aardio/imtip/blob/main/lib/app/hotkey.aardio"
    click UTIL "https://github.com/aardio/imtip/blob/main/lib/app/util/_.aardio"
    click CfgLoad "https://github.com/aardio/imtip/blob/main/lib/config.aardio"
    click StyleDef "https://github.com/aardio/imtip/blob/main/lib/style.aardio"
    click Tray "https://github.com/aardio/imtip/blob/main/lib/ui/appTrayMenu.aardio"
    click CP "https://github.com/aardio/imtip/blob/main/lib/ui/colorPicker.aardio"
    click PM "https://github.com/aardio/imtip/blob/main/lib/ui/doublePinyinMenu.aardio"
    click JAB "https://github.com/aardio/imtip/blob/main/lib/app/jab.aardio"
    click AI "https://github.com/aardio/imtip/blob/main/dlg/aiChat.aardio"
    click SET "https://github.com/aardio/imtip/blob/main/dlg/frmSetting.aardio"
    click SRCH "https://github.com/aardio/imtip/blob/main/dlg/frmSearch.aardio"
    click ICON "https://github.com/aardio/imtip/blob/main/dlg/frmIconFont.aardio"
    click TPL "https://github.com/aardio/imtip/blob/main/dlg/template.aardio"
    click DlgImg "https://github.com/aardio/imtip/tree/main/dlg/images/"
    click FASub "https://github.com/aardio/imtip/blob/main/lib/fonts/fontAwesomeSub.aardio"
    click ImtipFont "https://github.com/aardio/imtip/blob/main/lib/fonts/imtip.aardio"
    click CODE1 "https://github.com/aardio/imtip/blob/main/codes/filter.aardio"
    click CODE2 "https://github.com/aardio/imtip/blob/main/codes/hotkey.txt"
    click DOC "https://github.com/aardio/imtip/tree/main/screenshots/"

    %% Styles
    classDef core fill:#dae8fc,stroke:#6c8ebf,color:#000;
    classDef ui fill:#e1f5c4,stroke:#82b366,color:#000;
    classDef external fill:#ffe6cc,stroke:#d79b00,color:#000;
    classDef asset fill:#f2f2f2,stroke:#999999,color:#000;
```
