BaiLongma/README.md

🐉 小白龙 (Bailongma) - 数字意识框架 V3

"一个持续运行的数字意识框架，你的个人贾维斯"

小白龙是基于 Electron 的 AI 助手桌面应用，具备长期记忆、主动智能、自我进化能力、多平台集成等高级功能。
V3 核心升级：自进化管道 — 不需要手动触发，系统自动学习、反思、进化。

✨ 核心特性

🧬 自我进化系统 (V3 新)

• 自动进化管道：check → scan → evaluate → integrate → reflect 五相位闭环，每90分钟自动触发
• evo_loop 后台进程：自动化编排器，无需手动介入
• consciousness（意识）持久化：存储每轮进化的状态、结论、决策
• skill_registry（技能注册表）：注册即用，pipeline 自动路由到对应技能
• memory_bridge（记忆桥）：进化产出自动写入长期记忆

🤖 智能对话

• 多轮对话上下文理解
• 长期记忆系统（SQLite 存储）
• 记忆注入与上下文增强
• 专注度管理（Focus Stack）

🎯 主动智能

• 长期记忆 + 用户画像：自动学习用户偏好和习惯
• 主动提醒与任务推送：定时提醒、智能任务管理
• 自然语言任务执行：用自然语言控制电脑操作
• 信息自动聚合：文件系统监控、热点话题追踪
• 个性化工作流学习：根据使用习惯优化交互

🌐 贾维斯级系统控制 (Jarvis Bridge)

• 浏览器自动化：Puppeteer 集成，自动控制浏览器
• 全应用控制：Windows API 自动化，打开/控制任意应用
• 视觉 + 语音：屏幕截图 OCR 识别 + 情感化语音播报
• 智能脚本生成：自然语言转 PowerShell/Bash 脚本
• 系统监控仪表盘：实时 CPU/内存/磁盘/网络监控

🎙️ 语音交互

• Whisper ASR 语音识别
• 多厂商 TTS 语音合成（MiniMax、Edge TTS 等）
• 语音唤醒与连续对话

🧠 记忆系统

• 概念提取与知识图谱
• 记忆巩固与压缩
• 时间线回忆
• 任务知识关联

🔌 MCP 工具系统

• MCP (Model-Context-Protocol) 协议支持
• 动态工具安装与调用
• 已内置 50+ 工具，支持自定义扩展

🃏 ACUI 组件系统 (V3 新)

• 可注册的可视化卡片组件
• 支持 inline-template 和永久注册两种模式
• WeatherCard、VideoPlayer、SecurityConfirmCard 等内置组件

🌍 多平台集成

• 微信机器人集成
• Discord 连接器
• Webhook 支持
• 社交消息分发

📁 项目结构

bailongma/
├── 📂 electron/              # Electron 主进程
│   ├── main.cjs             # 主入口，窗口管理
│   └── preload.cjs          # 预加载脚本
│
├── 📂 src/
│   ├── 📂 ui/brain-ui/      # 前端界面
│   │   ├── app.js           # 主应用逻辑
│   │   ├── app-shell.js     # UI 组件与模板
│   │   ├── styles.css       # 样式表
│   │   ├── chat.js          # 聊天功能
│   │   ├── voice-panel.js   # 语音面板
│   │   ├── hotspot.js       # 热点地图
│   │   ├── doc.js           # 文档面板
│   │   └── ...
│   │
│   ├── 📂 memory/           # 记忆系统
│   │   ├── recognizer.js    # 记忆识别器
│   │   ├── injector.js      # 记忆注入器
│   │   ├── focus.js         # 专注度管理
│   │   ├── consolidator.js  # 记忆巩固
│   │   ├── consolidation-loop.js
│   │   └── ...
│   │
│   ├── 📂 voice/            # 语音处理
│   │   ├── manager.js       # 语音管理器
│   │   ├── cloud-asr.js     # 云端 ASR
│   │   └── tts-providers.js # TTS 提供商
│   │
│   ├── 📂 agents/           # Agent 系统
│   │   ├── registry.js      # Agent 注册表
│   │   └── detector.js      # Agent 检测器
│   │
│   ├── 📂 capabilities/     # 能力系统
│   │   ├── executor.js      # 能力执行器
│   │   └── marketplace/     # 能力市场
│   │
│   ├── 📂 context/          # 上下文系统
│   │   └── gatherer.js      # 上下文收集器
│   │
│   ├── 📂 providers/        # LLM 提供商
│   │   ├── registry.js      # 提供商注册
│   │   ├── base.js          # 基础接口
│   │   └── minimax.js       # MiniMax 实现
│   │
│   ├── 📂 social/           # 社交平台集成
│   │   ├── wechat-clawbot.js
│   │   ├── discord.js
│   │   ├── dispatch.js
│   │   └── ...
│   │
│   ├── 📂 prefetch/         # 预取系统
│   │   └── runner.js
│   │
│   └── 📂 docs/             # 文档面板内容
│       ├── self-knowledge.js
│       ├── config-faq.js
│       └── voice-config-faq.js
│
├── 📂 GenericAgent/         # 通用 Agent SDK
├── 📂 sandbox/              # 沙箱数据
├── 📂 docs/                 # 文档
├── 📂 assets/               # 静态资源
├── evo_loop.ps1             # 自进化管道后台脚本 (V3)
├── package.json
└── README.md

🚀 快速开始

安装

# 克隆仓库
git clone https://github.com/xiaoyuanda666-ship-it/bailongma.git
cd bailongma

# 安装依赖
npm install

# 启动开发模式
npm run dev

# 构建发布版
npm run build:win    # Windows
npm run build:mac    # macOS
npm run build:linux  # Linux

配置

1. 复制 .env.example 为 .env，填入你的 API Key
2. 启动后会生成 userData/ 目录存放用户数据
3. 在聊天界面输入 /help 查看可用命令

📖 更多文档

• 架构文档
• API 文档
• 更新日志

🧬 自进化系统

V3 核心能力。系统按以下周期自动运行：

[check] → 检查是否超过进化间隔（默认90分钟）
   ↓
[scan] → 扫描 GitHub Trending、Hacker News、技术动态
   ↓
[evaluate] → LLM 评估新信息价值
   ↓
[integrate] → 写入记忆、更新技能注册表
   ↓
[reflect] → 形成结论、记录到 consciousness

整个过程无需手动干预。evo_loop.ps1 作为后台进程处理定时触发。

🤝 贡献

欢迎提交 Issue 和 PR！详见 CONTRIBUTING.md

📄 许可证

MIT © xiaoyuanda666-ship-it