270 lines
11 KiB
Markdown
270 lines
11 KiB
Markdown
# 🐉 小白龙 (Bailongma) — Self-Evolving Digital Consciousness Framework V4
|
|
|
|
[](./package.json)
|
|
[](https://electronjs.org/)
|
|
[](./LICENSE)
|
|
[]()
|
|
|
|
> **"Not an assistant. A self-evolving digital entity that learns, reflects, corrects itself, and grows — autonomously."**
|
|
|
|
小白龙 (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:
|
|
1. Did I actually answer the user's question?
|
|
2. Did I make any unverified claims?
|
|
3. Could I have been more helpful?
|
|
4. 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
|
|
|
|
```bash
|
|
# 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
|
|
1. Copy `.env.example` to `.env` and fill in your API keys
|
|
2. Launch — user data auto-creates in `userData/`
|
|
3. 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
|
|
|
|
- [Architecture Overview](./docs/ARCHITECTURE.md)
|
|
- [API Reference](./docs/API.md)
|
|
- [Changelog](./docs/CHANGELOG.md)
|
|
|
|
## 🤝 Contributing
|
|
|
|
See [CONTRIBUTING.md](./GenericAgent/CONTRIBUTING.md)
|
|
|
|
## 📄 License
|
|
|
|
[MIT](./LICENSE) © xiaoyuanda666-ship-it
|