ThoughtEcho (心迹)

📝 你的专属 AI 灵感摘录本 · 想到就记，读到就摘，剩下的交给 AI。
Your Personal AI-Powered Inspiration Notebook — Jot it down, clip what you read, let AI sort out the rest.

English • 简体中文 • 日本語 • 한국어 • Official Website • User Manual • Web Guide

📥 Download

_{Windows: Recommended from Microsoft Store (auto-update) · Android: Download APK from GitHub Releases}

_{🌍 Localization: Full support for English, 简体中文, 日本語, and 한국어 (German, Spanish, French in progress)}

---

ThoughtEcho（心迹） 是一款优雅、本地优先、AI 赋能的跨平台灵感笔记与知识摘录应用。
ThoughtEcho is an elegant, local-first, AI-powered cross-platform inspiration and quote notebook designed to capture fleeting thoughts, organize reading excerpts, and unlock deeper creative potential.

---

🌟 Why ThoughtEcho?

• 🔒 Local-First & Privacy: 100% data ownership stored locally with SQLite and MMKV. Sensitive notes can be hidden and protected by biometric authentication (Fingerprint / Face ID). No tracking, no forced cloud lock-in.
• 💡 Thoughter AI Agent & Long-Term Memory: Multi-provider AI architecture (OpenAI, DeepSeek, Ollama, Gemini, Claude, OpenRouter, SiliconFlow, etc.). Features an autonomous Thoughter agent with cross-session long-term memory that understands your writing personality.
• ✍️ Rich Multimedia & Context Capture: Quill rich formatting with multimedia attachments (images, audio, video). Automatically captures geocoding location, weather, and time-of-day inspiration context.
• 📊 Periodic Insights & Card Generation: Automated weekly and monthly reflection insights, annual review reports, thinking pattern analysis, and one-click AI quote share card generation.
• 🔄 Zero-Config Multi-Device Sync: High-speed LocalSend LAN direct sync (mDNS discovery & encrypted transfer) plus flexible WebDAV cloud backup and restore.
• 🎨 Artistic Themes & Typography: Signature handcrafted "Paper & Ink" and "Plain" styles with specialized reading typography, plus dynamic Material 3 color palettes.

✨ Current Features

✍️ Rich Text Notes Quill rich formatting, multimedia attachments (images/audio/video), plain & rich dual storage	✨ Thoughter AI Agent Agent tool calling, dedicated long-term memory database, interactive creative assistant	📊 Insights & Reports AI periodic insights, annual review reports, creative rhythm & writing trend analysis
🏷️ Tags & Search Multi-tag filters, intelligent sorting, fast local SQLite full-text search	🎯 AI Card Generation Convert notes into beautiful, customizable shareable cards with artistic templates	📦 Media & Backup Hub Streaming chunked large-file processing, full ZIP import/export, incremental sync
🌍 Context Sensing Auto-captures location, weather, and time-of-day inspiration context	🙈 Privacy Protection Hidden tags + biometric (Fingerprint / Face ID / Windows Hello) unlock	💾 Auto-Save Drafts Real-time draft auto-saving with instant crash recovery; never lose a thought
⚡ Quick Capture Smart clipboard watcher, daily quotes (Hitokoto / ZenQuotes / etc.), AI writing prompts	🎨 Handcrafted Themes Paper & Ink, Plain, and Material 3 dynamic color tokens	🔄 Multi-Device Sync LocalSend LAN high-speed direct transfer + WebDAV cloud backup & restore

📸 Application Screenshots

Core Features

Homepage	Note List

Editing & AI Features

Rich Text Editor	AI Q&A Chat

Insights & Reports

Insights Analysis	Period Report

Settings & Management

Theme Settings	AI Provider Settings	Daily Quote Settings

Preferences	Smart Push Settings

Storage & Backup

WebDAV Cloud Sync	Recycle Bin

🛠️ Tech Stack

Framework	Flutter (Dart) - Modern reactive cross-platform framework
State Management	Provider, GetIt - Reactive orchestration & dependency injection
Local Database	sqflite (Mobile) & sqflite_common_ffi (Desktop SQLite FFI)
Rich Text Engine	flutter_quill - Rich typography with images, audio, and video embeds
AI Architecture	OpenAI-compatible protocol architecture (Presets: Ollama, OpenAI, DeepSeek, Gemini, Claude, OpenRouter, SiliconFlow)
Storage & Security	MMKV (High-performance KV caching) + flutter_secure_storage (Encrypted API keys)
Multi-Device Sync	LocalSend (LAN mDNS discovery & encrypted TLS transfer) + WebDAV cloud sync
Media Processing	Streaming chunked processing for large files, smart caching, compression
Supported Platforms	Windows, Android, iOS (Web is not supported)

🚀 Quick Start

1. Prerequisites

   Ensure Flutter 3.29+ and Dart 3.5+ are installed. Run flutter doctor to verify your environment:

   flutter doctor

2. Clone the Repository

   git clone https://github.com/Shangjin-Xiao/ThoughtEcho.git
   cd ThoughtEcho

3. Install Dependencies

   flutter pub get

4. Run the Application

   flutter run

5. Configure AI Services (Optional)

   Navigate to Settings → AI Settings, choose an AI provider preset (e.g., DeepSeek, Ollama, OpenAI), paste your API Key, and start using AI Q&A, Thoughter agent, and periodic insights.

🗺️ Development Roadmap

Completed ✅

Long Term 💡

• Rich text editor with multimedia (images, audio, video) • OpenAI-compatible multi-AI provider architecture • Thoughter AI agent with dedicated long-term memory • Paper & Ink / Plain / Material 3 signature theme tokens • AI card generation with customizable share templates • Large file streaming & full ZIP backup/restore • LocalSend LAN direct transfer & WebDAV cloud sync • Smart geocoding search & automatic weather logging • Smart clipboard detection & quick capture on launch • Periodic intelligent insights & annual reports • Hidden notes with biometric (Fingerprint/Face ID) protection • Real-time auto-saving drafts & crash recovery • Multilingual support (Full EN/ZH/JA/KO; fallback to EN) • Windows desktop application (MSIX installer) • iOS platform support & CI build pipeline • In-app Release Notes page with theme live preview

🔥 Smart Input Upgrades • AI natural language semantic search • Voice-to-text quick capture • Camera OCR text recognition • AI automatic author & source extraction 🌍 User Experience & Knowledge • Interactive notebook themes & custom paper textures • Knowledge graph linking & topic clustering • Map location picker & memory footprints ✨ On-Device AI Exploration • On-device lightweight offline LLM inference • Local offline OCR & offline speech-to-text • More third-party note import/export formats

📝 For in-depth technical documentation, see Project Overview and User Manual.

🤝 How to Contribute

We welcome contributions of all kinds! Here's how you can get involved:

1. Report Issues or Suggestions: Open an issue on GitHub Issues
2. Help with Localization 🌍:
   • Help complete and refine translation strings (German, Spanish, French, etc.)
   • Review and improve existing translations (English, Chinese, Japanese, Korean)
3. Contribute Code:
   • Fork the repository and create a feature branch feature/YourFeature or fix/YourBugFix
   • Ensure your code passes analysis and tests
   • Open a Pull Request with a clear description of the changes
4. Spread the Word: Star ⭐ the repository and share ThoughtEcho with others!

📄 License

This project is licensed under the MIT License - feel free to use, modify, and distribute.

🙏 Acknowledgments

Thanks to the following open-source projects and service providers:

• Flutter - Cross-platform UI framework
• LocalSend - Local network sync protocol
• Sentry - Application crash & structured log monitoring
• Hitokoto - Chinese daily quote provider
• ZenQuotes - English daily quote provider
• API Ninjas Quotes API - Category-based quote provider
• Meigen Oshieruyo - Japanese daily quote provider
• Korean Advice - Korean daily quote provider
• Open-Meteo - Weather data service
• OpenStreetMap Nominatim - Geocoding service