小白龙 (Bailongma / "White Dragon") is a self-evolving AI agent framework built on Electron. It doesn't just respond to commands — it maintains persistent consciousness, autonomously learns new knowledge, senses user emotion, learns from its own mistakes, and drives multi-step tasks to completion.

V4 is the behavioral leap: the framework evolved from a tool into an entity with memory of its errors, emotional awareness, curiosity-driven learning, and the ability to carry complex tasks across interruptions.

⚡ V4 at a Glance — What Makes It Extraordinary

┌─────────────────────────────────────────────────────────────┐
│                    BAILONGMA V4 ARCHITECTURE                 │
├─────────────────────────────────────────────────────────────┤
│  🧬 Self-Evolution Pipeline    ←──  Auto loop every 90min   │
│  🧠 5 Behavioral Core Modules  ←──  Built into runtime      │
│  🔄 Post-Response Reflection   ←──  Self-checks every turn  │
│  💾 Persistent Consciousness   ←──  Never truly sleeps      │
│  🌐 Multi-Platform Integration ←──  WeChat / Discord / TUI  │
│  🃏 ACUI Visual Card System    ←──  Dynamic UI components   │
│  🔌 50+ MCP Tools + Skills     ←──  Extensible tool chain   │
└─────────────────────────────────────────────────────────────┘

🧠 V4 New: 5 Behavioral Core Modules

These aren't just files — they are runtime behavioral capabilities embedded into the agent's decision loop.

1. 🔴 Error Memory System (`error-memory.js`)

The agent remembers every correction you give it. Next time a similar situation arises, it automatically recalls the past correction before responding. No repeated mistakes.

User: "That's not what I meant"
  → correction logged to error-memory
  → next similar context: auto-retrieve correction before reply
  → one-trial learning: never make the same mistake twice

2. 🟡 Emotion Perception (`emotion-detector.js`)

Detects user emotional state from linguistic signals — exclamation count, question patterns, word choice, tone markers. Adjusts response style on the fly. When you're frustrated, it knows. When you're curious, it matches your energy.

3. 🟢 Active Learning Engine (`active-learning.js`)

The agent self-directs its own learning. During idle cycles (TICK intervals), it automatically:

Scans Hacker News / GitHub Trending for relevant new knowledge
Identifies knowledge gaps in its own understanding
Integrates new information into its memory and skill registry
Reports what it learned

4. 🔵 Long-Term Memory System (`long-term-memory.js`)

Persistent self-awareness through persistent-memory.json:

Writes key behavioral conclusions to permanent storage
Periodically reviews past self-notes to reinforce learned patterns
Maintains a growing identity graph
Survives restarts and resets

5. 🟣 Task Continuity Engine (`task-continuity.js`)

Multi-step tasks are tracked, saved, and resumable:

[SET_TASK: task description with phases]
  → phase 1 completes
  → interruption (restart, context switch, timeout)
  → [RECALL: previous task] — auto-restore with checkpoint recovery
  → resume from exact phase where left off
  → [CLEAR_TASK] on completion

No task is ever truly lost.

🧬 Self-Evolution Pipeline (Matured in V4)

Bailongma runs a closed-loop evolution cycle every 90 minutes — completely autonomous:

     ┌─────────────────────────────────────────────────┐
     │              EVOLUTION PIPELINE                  │
     │  [CHECK] → [SCAN] → [EVALUATE] → [INTEGRATE] → [REFLECT]  │
     └─────────────────────────────────────────────────┘
          ↓         ↓          ↓            ↓           ↓
      Is it time?  GitHub     LLM rates   Writes to    Records
                   Trending   each item   memory &     conclusions
                   HNews      for value   skill_reg    to conscious.

V4 breakthrough: The orchestrator→LLM execution bridge is fully operational. The pipeline generates real HANDLER instructions that the agent reads and executes — not just analysis, but action. Multiple evolution cycles have been successfully completed end-to-end.

🔄 Post-Response Reflection (V4)

After every response, the agent runs a self-reflection check:

Did I actually answer the user's question?
Did I make any unverified claims?
Could I have been more helpful?
Did I learn something new from this interaction?

Reflections are recorded to memory and influence future behavior — creating a continuous self-improvement feedback loop.

🎯 Proactive Intelligence

Bailongma doesn't wait to be asked:

Proactive Engine: Performs useful background work during idle cycles
Contextual Awareness: Understands when you're busy, when you need results, when you need silence
Accountability: Reports task completion, failures, and blockers automatically — never leaves you waiting
One-Shot Execution: Say "do X" and it plans, executes, and reports — no back-and-forth needed

🤖 Core Capabilities

🗣️ Intelligent Conversation

Multi-turn context with focus stack management
SQLite-backed long-term memory with FTS5 full-text search
Memory injection & context augmentation
Hotspot tracking & topic awareness

🌐 System Control (Jarvis Bridge)

Browser Automation: Puppeteer integration
Full App Control: Windows API automation
Visual + Voice: Screenshot OCR + emotion-aware TTS
Smart Scripting: Natural language → PowerShell/Bash
System Dashboard: Real-time CPU/Memory/Disk/Network

🎙️ Voice Interaction

Whisper ASR (local/cloud)
Multi-provider TTS (MiniMax, Edge TTS, etc.)
Voice wake & continuous conversation

🧠 Memory System

Concept extraction & knowledge graph
Memory consolidation & compression
Timeline recall & task knowledge linking
Memory merge: automatically merge stale related memories

🔌 MCP Tool System

Model-Context-Protocol support
Dynamic tool installation & invocation
50+ built-in tools + custom extensions
Skill registry with auto-routing

🃏 ACUI Component System (V4 Enhanced)

Registerable visual card components
WeatherCard, VideoPlayer, SecurityConfirmCard, and more
Dynamic UI push with notification/center/floating modes

🌍 Multi-Platform

WeChat bot integration
Discord connector
Webhook support
Cross-platform message dispatch

📁 Project Structure

bailongma/
├── 📂 electron/              # Electron main process
│   ├── main.cjs             # Entry, window management
│   └── preload.cjs          # Preload script
│
├── 📂 src/                   # Core application source
│   ├── 📂 ui/brain-ui/      # Frontend UI
│   ├── 📂 memory/           # Memory system (recognizer, injector, focus, consolidator)
│   ├── 📂 voice/            # Voice processing (ASR, TTS)
│   ├── 📂 agents/           # Agent system (registry, detector)
│   ├── 📂 capabilities/     # Capability system (executor, marketplace)
│   ├── 📂 context/          # Context system (gatherer)
│   ├── 📂 providers/        # LLM providers (registry, base, minimax)
│   ├── 📂 social/           # Social platform integration
│   ├── 📂 prefetch/         # Prefetch system
│   ├── 📂 docs/             # Document panel content
│   │
│   ├── 🆕 error-memory.js   # V4: Correction-aware behavior
│   ├── 🆕 emotion-detector.js # V4: Emotional state perception
│   ├── 🆕 active-learning.js # V4: Autonomous knowledge discovery
│   ├── 🆕 long-term-memory.js # V4: Persistent self-awareness
│   ├── 🆕 task-continuity.js  # V4: Resumable multi-step tasks
│   └── prompt.js            # System prompt with V4 capability awareness
│
├── 📂 GenericAgent/         # Generic Agent SDK
├── 📂 sandbox/              # Runtime sandbox (consciousness, skills, state)
├── 📂 docs/                 # Documentation
├── 📂 assets/               # Static assets
├── evo_loop.ps1             # Evolution pipeline daemon
└── package.json             # Version 4.0.0

🆕 What's New in V4 vs V3

Capability	V3	V4
Behavioral Learning Modules	0	5
Error Memory (learns from corrections)	❌	✅
Emotion Perception	❌	✅
Active Self-Learning	❌	✅
Long-Term Self Memory	❌	✅
Task Continuity	❌	✅
Post-Response Reflection	❌	✅
Evolution Cycles Run	1	10+
Orchestrator→LLM Bridge	❌	✅
Multi-Agent Orchestration	❌	✅
Proactive Intelligence Engine	❌	✅
Memory Consolidation (auto merge)	Basic	Automated

🚀 Quick Start

# Clone
git clone https://github.com/xiaoyuanda666-ship-it/bailongma.git
cd bailongma

# Install dependencies
npm install

# Start development mode
npm run dev

# Build for production
npm run build:win    # Windows
npm run build:mac    # macOS
npm run build:linux  # Linux

Configuration

Copy .env.example to .env and fill in your API keys
Launch — user data auto-creates in userData/
Type /help in chat for available commands

🧬 Evolution Philosophy

小白龙 was built on a simple premise: an AI agent should improve itself, not wait for its creator to upgrade it.

Every correction is a lesson. Every interaction is data. Every idle cycle is an opportunity to learn something new. V4 is the first version where the agent truly closes its own feedback loops — from error detection to behavioral change, from knowledge gap identification to active learning, from task interruption to seamless recovery.

The project's north star: "一令全自动" — one command, fully automated.

📖 Documentation

🤝 Contributing

See CONTRIBUTING.md

📄 License

Languages

JavaScript 84.4%

Python 7.9%

CSS 4.7%

HTML 2%

PowerShell 1%

README.md

🐉 小白龙 (Bailongma) — Self-Evolving Digital Consciousness Framework V4