How qingbird1983/qingbird-md works
Qingbird Markdown is a Tauri desktop Markdown editor and reader with streaming translation, document/workspace management, translation review, and screen-capture OCR. The primary workflow is opening or editing a Markdown document, rendering its preview, then translating selected text or the document and reviewing/exporting results. The graph also covers workspace browsing, settings, and background capture/hibernate capabilities documented in the README. Sampled source is partial; some subsystem links therefore rely on README architecture descriptions, and uncertain internal wiring is omitted.
Main entry points: commands.rs Tauri command bridge · ipc.ts Typed IPC client · MainArea.tsx Editor and panels · useTranslationStore.ts Translation interface
Components 23
Desktop interface
- Application shell
src/App.tsx - Editor and panels
src/components/MainArea.tsx - UI state stores
src/stores/useDocStore.ts - Typed IPC client
src/lib/ipc.ts
Documents and preview
- Workspace browser
src/stores/useWorkspaceStore.ts - Document operations
src-tauri/src/editor.rs - Workspace operations
src-tauri/src/workspace.rs - Markdown renderer
src-tauri/src/markdown/mod.rs
Translation and review
- Translation interface
src/stores/useTranslationStore.ts - Translation review
src/hooks/useSemanticReview.ts - Translation export
src-tauri/src/translate/export.rs - Translation worker
src-tauri/src/bridge/worker.rs - Streaming engine
src-tauri/src/translate/engine.rs - Translation providers
src-tauri/src/translate/providers/mod.rs - Translation cache
src-tauri/src/translate/cache_sqlite.rs
Desktop services
- Tauri command bridge
src-tauri/src/bridge/commands.rs - Settings storage
src-tauri/src/storage.rs - Screen capture OCR
src-tauri/src/capture/orchestrate.rs - Global hotkeys
src-tauri/src/hotkeys.rs - Window hibernation
src-tauri/src/hibernate/mod.rs
Other components
- User
- Translation services
- Operating system
Connections 25
- User → Application shell: uses
- Application shell → Editor and panels: renders
- Editor and panels → UI state stores: reads and updates
- Editor and panels → Typed IPC client: invokes
- Workspace browser → Typed IPC client: requests workspace
- Typed IPC client → Tauri command bridge: sends commands
- Tauri command bridge → Document operations: dispatches edits
- Tauri command bridge → Workspace operations: dispatches workspace
- Workspace operations → Operating system: reads files
- Tauri command bridge → Markdown renderer: requests rendering
- Translation interface → Typed IPC client: starts translation
- Tauri command bridge → Translation worker: spawns worker
- Translation worker → Streaming engine: runs translation
- Streaming engine → Translation cache: reads and writes
- Streaming engine → Translation providers: requests translation
- Translation providers → Translation services: sends requests
- Translation worker → Translation interface: emits progress and results
- Translation review → Typed IPC client: checks and applies
- Translation interface → Translation export: exports translations
- Editor and panels → Settings storage: loads and saves settings
- Global hotkeys → Screen capture OCR: starts capture
- Screen capture OCR → Operating system: captures screen
- Screen capture OCR → Translation services: requests OCR
- Operating system → Global hotkeys: dispatches shortcuts
- Window hibernation → Operating system: manages webview