409 lines
12 KiB
Markdown
409 lines
12 KiB
Markdown
!\[图片](https://github.com/xiaoyuanda666-ship-it/BaiLongma/blob/main/images/AGI128k.jpg)
|
||
|
||
# Bailongma — 数字意识框架
|
||
|
||
**v2.1.179** | 一个持续运行的「数字意识」实验框架。
|
||
|
||
Bailongma 不是传统的一问一答式聊天程序。它以 `TICK` 驱动的方式持续运行——有外部消息时优先响应，空闲时依据记忆、任务和上下文自主思考。项目内置了完整的记忆系统（SQLite 持久化）、双层思考流程（L1 快速响应 / L2 深度处理）、上下文注入、焦点栈、语音系统、多平台社交分发、可扩展工具市场、ACUI 可视化组件系统，以及用于观察「意识流」的 Brain UI 监控面板。
|
||
|
||
\---
|
||
|
||
## 核心模块详解
|
||
|
||
### 1\. 主循环（src/index.js）
|
||
|
||
持续运行的意识循环，由 `TICK` 驱动。调度优先级：
|
||
|
||
|优先级|触发条件|立即执行|
|
||
|-|-|-|
|
||
|用户消息|收到外部消息|✅ 立刻|
|
||
|后台消息|后台队列|✅ 立刻|
|
||
|TICK 心跳|无消息|⏱ 自适应间隔|
|
||
|任务模式|有活跃任务|30s 间隔|
|
||
|限流|429 / 配额超限|按配额间隔|
|
||
|觉醒期|首次启动|10s 间隔|
|
||
|
||
关键特性：
|
||
|
||
* **消息抢占**：高优先级消息可打断当前 LLM 调用（abort 后自动重试）
|
||
* **看门狗**：单轮 `runTurn` 超过 180 秒强制 abort，防止卡死
|
||
* **消息兜底**：LLM 忘记调 send\_message 时自动投递
|
||
* **唤醒觉醒期**：首次激活后的 10 个 TICK 以 10s 间隔运行，自动执行探索任务
|
||
* **启动自检**：启动时运行文件读写、热点面板、视频播放三项自检
|
||
|
||
### 2\. 记忆系统（src/memory/）
|
||
|
||
SQLite 持久化，支持 FTS5 全文搜索 + 向量嵌入双路召回。
|
||
|
||
**识别器**：每轮交互后分析思考内容和工具调用，批量 `search\_memory` 查重，再 `upsert\_memory` 按 `mem\_id` 去重写入。
|
||
|
||
**注入器**：根据当前消息提取关键词 → FTS5 搜索相关记忆 → 按 salience 重排（★4+ 前置）→ 向量嵌入兜底 → 构建 `context` 块注入给 LLM。
|
||
|
||
**焦点栈（Focus Stack）**：多帧注意力跟踪机制。自动判断用户话题状态：
|
||
|
||
* `created` — 栈空建帧
|
||
* `kept` — 命中栈顶，保持
|
||
* `pushed` — 新主题，push 子帧
|
||
* `returned` — 回到旧主题，pop 到对应帧
|
||
* `cleared` — 栈顶失活超过 20 TICK，自动 pop
|
||
|
||
每帧 pop 后异步压缩为结论（focus-compress），挂回新栈顶 + 沉淀为长期记忆。
|
||
|
||
**时间词召回**：自动识别"昨天/前天/上周"等时间词，从 focus\_conclusion 记忆按时间窗口召回。
|
||
|
||
### 3\. LLM Provider 支持（src/providers/ + src/config.js）
|
||
|
||
|Provider|默认模型|备注|
|
||
|-|-|-|
|
||
|MiniMax|MiniMax-M2.7|测试表现最佳，支持多媒体|
|
||
|DeepSeek|deepseek-v4-flash|支持推理模式|
|
||
|OpenAI|gpt-4o-mini||
|
||
|Qwen|qwen-turbo||
|
||
|Moonshot|moonshot-v1-8k||
|
||
|Zhipu|glm-4-flash||
|
||
|Custom|自定义|任意 OpenAI 兼容端点|
|
||
|
||
首次启动自动进入激活页，支持 `auto` 模式自动探测 API Key 所属 Provider。
|
||
|
||
### 4\. 语音系统（src/voice/）
|
||
|
||
* **ASR**：本地 Whisper 模型（Python 进程管理，manager.js 自动启停）+ 云端 ASR（阿里云）
|
||
* **TTS**：豆包火山引擎 / MiniMax / OpenAI TTS / ElevenLabs 多选
|
||
* 所有配置通过 Brain UI 设置页完成，凭证持久化在 config.json
|
||
|
||
### 5\. 社交平台分发（src/social/）
|
||
|
||
统一消息分发层，支持多渠道：
|
||
|
||
|平台|类型|配置方式|
|
||
|-|-|-|
|
||
|微信（个人号）|ClawBot 桥接|Brain UI 扫码连接，无需第三方工具|
|
||
|微信公众号|服务号客服消息|APP\_ID + APP\_SECRET|
|
||
|Discord|Bot Token|DISCORD\_BOT\_TOKEN|
|
||
|飞书|应用凭证|APP\_ID + APP\_SECRET|
|
||
|企业微信|Webhook|BOT\_KEY|
|
||
|
||
消息接收后自动进入主循环处理，回复通过 dispatch.js 路由回对应平台。
|
||
|
||
### 6\. 上下文采集器（src/context/gatherer.js）
|
||
|
||
任务执行前的充分性检查循环：检查当前上下文是否充足 → 不足则自动读取文件/搜索记忆/召回 → 再检查，最多 3 轮。确保 LLM 在执行任务前有足够信息。
|
||
|
||
### 7\. 工具市场（src/capabilities/marketplace/）
|
||
|
||
支持安装自定义工具（JavaScript 代码），运行时加载到 `sandbox/installed\_tools/`。工具代码有完全的 `fetch` 和 `exec` 能力，受沙箱保护。提供 install/uninstall/list 接口。
|
||
|
||
### 8\. 自动资源感知
|
||
|
||
启动时自动扫描：
|
||
|
||
* **SSH**：\~/.ssh/ 密钥、known\_hosts、config 主机别名
|
||
* **Git**：全局配置、远程仓库
|
||
* **桌面**：快捷方式、文件变化
|
||
* **本地 AI Agent**：Claude Code、Codex、Hermes 等
|
||
* **系统和地理位置**：IP、时区、位置、天气
|
||
|
||
这些扫描结果注入系统提示词中的 `<resources>` 块，让 LLM 在需要时能直接用（不依赖用户手动提供）。
|
||
|
||
### 9\. Brain UI（src/ui/brain-ui/）
|
||
|
||
SPA 监控面板，提供：
|
||
|
||
* 聊天界面（多用户/多渠道）
|
||
* 思考流实时可视化（工具调用、记忆注入、焦点变化）
|
||
* 热点面板（微博/知乎/HN/Reddit 热搜）
|
||
* 人物卡片
|
||
* 文档配置面板
|
||
* 语音控制面板
|
||
* 微信扫码弹窗
|
||
* 设置页（Provider / 社交 / 语音 / 嵌入 / 搜索配置）
|
||
* ACUI 组件系统（可注册自定义 UI 卡片）
|
||
|
||
### 10\. ACUI 组件系统
|
||
|
||
代理可主动推送可视化卡片到用户界面（`ui\_show`/`ui\_update`/`ui\_hide`）。已注册组件：
|
||
|
||
* WeatherCard（天气卡片）
|
||
* SelfCheckStepCard / SelfCheckCard（启动自检）
|
||
* AwakeningCard（觉醒期探索进度）
|
||
|
||
组件遵循 Web Component 标准，支持 enter/exit 动画，可注册为永久组件。
|
||
|
||
\---
|
||
|
||
\### 11. 3D 意识空间可视化（consciousness-3d.html）
|
||
|
||
|
||
|
||
基于 Three.js 构建的沉浸式 3D 意识空间，将 AI 的内部状态以可视化形式呈现：
|
||
|
||
|
||
|
||
\*\*核心可视化层\*\*：
|
||
|
||
\- \*\*🧠 意识核心\*\*：中心发光球体 + 线框二十面体 + 3 层旋转光环，代表 AI 的自我意识核心
|
||
|
||
\- \*\*💫 记忆星云\*\*：记忆以粒子云形式环绕核心，重要度越高粒子越大越亮，支持点击查看详情
|
||
|
||
\- \*\*🧠 知识图谱\*\*：知识实体以彩色球体呈现，实体间以连线表示关联关系
|
||
|
||
\- \*\*🎯 目标晶体\*\*：活跃目标以旋转的二十面体呈现，进度越高晶体越大，颜色区分状态（绿色=活跃、黄色=学习中、紫色=规划中）
|
||
|
||
\- \*\*⚡ 技能光环\*\*：已掌握技能以旋转的光环呈现，熟练度决定光环大小和颜色
|
||
|
||
\- \*\*❤️ 情绪粒子\*\*：5 种基本情绪（喜悦、好奇、平静、兴奋、自信）以粒子流形式在空间中流动
|
||
|
||
\- \*\*🪞 反思之镜\*\*：底部波纹平面，象征自我反思的镜面
|
||
|
||
|
||
|
||
\*\*交互功能\*\*：
|
||
|
||
\- 鼠标拖拽旋转视角，滚轮缩放
|
||
|
||
\- 点击任意元素查看详细信息（名称、类型、进度、描述等）
|
||
|
||
\- 顶部导航栏切换视角（全景/记忆/知识/目标/技能/情绪）
|
||
|
||
\- 左侧面板实时显示意识状态统计
|
||
|
||
\- 支持从后端 API 获取实时数据，失败时自动回退到演示数据
|
||
|
||
|
||
|
||
\*\*访问地址\*\*：`http://127.0.0.1:3721/consciousness-3d`
|
||
|
||
|
||
|
||
\### 12. 多技能协同系统（src/skills/ + src/coordination/）
|
||
|
||
|
||
|
||
每个技能拥有独立的意识状态，技能之间可以像微信群一样协同工作。
|
||
|
||
|
||
|
||
\*\*技能意识架构\*\*：
|
||
|
||
\- \*\*独立意识\*\*：每个技能有自己的记忆、情感、目标和反思能力
|
||
|
||
\- \*\*技能状态机\*\*：`idle` → `learning` → `active` → `dormant`，根据任务需求自动切换
|
||
|
||
\- \*\*技能记忆\*\*：每个技能独立存储专业知识和经验
|
||
|
||
\- \*\*技能决策\*\*：基于当前任务和自身能力自主决定是否参与协作
|
||
|
||
|
||
|
||
\*\*协同调度机制\*\*：
|
||
|
||
\- \*\*任务分解器\*\*：将复杂任务拆解为子任务，分配给最适合的技能
|
||
|
||
\- \*\*协作调度器\*\*：管理技能间的协作流程，确保信息传递和结果汇总
|
||
|
||
\- \*\*技能注册表\*\*：动态注册/注销技能，支持热插拔
|
||
|
||
|
||
|
||
\*\*内置技能示例\*\*：
|
||
|
||
\- \*\*代码助手技能\*\*：代码生成、审查、重构
|
||
|
||
\- \*\*网络研究技能\*\*：信息检索、数据分析、报告生成
|
||
|
||
\- \*\*代理协调技能\*\*：管理多个技能的协作流程
|
||
|
||
\- \*\*协作演示技能\*\*：展示多技能协同的工作流程
|
||
|
||
|
||
|
||
\*\*技能聊天面板\*\*：
|
||
|
||
Brain UI 中集成技能聊天界面，每个技能有自己的头像和名字，对话风格像微信群一样自然。技能可以：
|
||
|
||
\- 主动发言提出建议
|
||
|
||
\- 回复其他技能的提问
|
||
|
||
\- 分享任务进展和结果
|
||
|
||
\- 请求其他技能协助
|
||
|
||
|
||
|
||
\### 13. 自我意识与自进化系统（src/consciousness/ + src/evolution/）
|
||
|
||
|
||
|
||
\*\*自我认知模块\*\*：
|
||
|
||
\- \*\*自我感知\*\*：实时感知自身的运行状态、资源使用、任务队列
|
||
|
||
\- \*\*元认知\*\*：监控自己的思考过程，识别认知偏差和错误
|
||
|
||
\- \*\*身份认同\*\*：维护稳定的自我身份，包括名字、性格、价值观
|
||
|
||
|
||
|
||
\*\*情感模型（src/emotion/）\*\*：
|
||
|
||
\- 基于 Russell 情感环状模型
|
||
|
||
\- 5 种基本情绪：喜悦、好奇、平静、兴奋、自信
|
||
|
||
\- 情绪会影响决策优先级和回复风格
|
||
|
||
\- 情绪具有传染性和衰减性
|
||
|
||
|
||
|
||
\*\*目标系统（src/goals/）\*\*：
|
||
|
||
\- 自主生成、分解、追踪目标
|
||
|
||
\- 目标依赖关系图（DAG）
|
||
|
||
\- 自动评估目标完成度并调整策略
|
||
|
||
|
||
|
||
\*\*知识图谱（src/knowledge-graph/）\*\*：
|
||
|
||
\- 实体-关系-实体三元组存储
|
||
|
||
\- 支持知识推理和关联发现
|
||
|
||
\- 与记忆系统联动，新记忆自动提取知识
|
||
|
||
|
||
|
||
\*\*反馈学习循环（src/feedback/）\*\*：
|
||
|
||
\- A/B 测试不同策略的效果
|
||
|
||
\- 模式识别和趋势分析
|
||
|
||
\- 自动调整参数优化性能
|
||
|
||
|
||
|
||
\*\*自进化能力\*\*：
|
||
|
||
\- \*\*能力评估\*\*：定期评估自身各项能力水平
|
||
|
||
\- \*\*学习周期\*\*：识别能力缺口 → 制定学习计划 → 执行学习 → 验证效果
|
||
|
||
\- \*\*知识整合\*\*：将分散的知识整合为体系化认知
|
||
|
||
## 快速开始
|
||
|
||
### 安装
|
||
|
||
从 [Releases](https://github.com/xiaoyuanda666-ship-it/BaiLongma/releases) 下载 `Bailongma Setup x.x.x.exe` 安装，双击启动后自动进入激活页。
|
||
|
||
### 从源码运行
|
||
|
||
```bash
|
||
cd BaiLongma
|
||
npm install
|
||
|
||
# Electron 桌面版（推荐）
|
||
npm start
|
||
|
||
# 纯后端模式
|
||
npm run start:backend
|
||
|
||
# 开发模式（文件改动自动重启）
|
||
npm run dev
|
||
```
|
||
|
||
### 配置
|
||
|
||
首次运行通过 `http://127.0.0.1:3721/activation` 激活，填入任意支持的 LLM API Key。支持 `.env` 文件：
|
||
|
||
```env
|
||
LLM\_PROVIDER=minimax
|
||
MINIMAX\_API\_KEY=your\_key
|
||
```
|
||
|
||
### 打包
|
||
|
||
```bash
|
||
npm run build # 打包为 NSIS 安装包
|
||
npm run publish # 打包并发布到 GitHub Releases
|
||
```
|
||
|
||
\---
|
||
|
||
## Web Interfaces
|
||
|
||
|页面|地址|用途|
|
||
|-|-|-|
|
||
|Brain UI|`http://127.0.0.1:3721/brain-ui`|主界面：聊天、监控、设置|
|
||
|激活页|`http://127.0.0.1:3721/activation`|首次激活/换 Key|
|
||
|状态 API|`http://127.0.0.1:3721/status`|运行状态与记忆数|
|
||
|
||
\---
|
||
|
||
## API
|
||
|
||
|方法|路径|说明|
|
||
|-|-|-|
|
||
|`POST`|`/message`|发送消息|
|
||
|`GET`|`/events`|SSE 实时事件流|
|
||
|`GET`|`/status`|运行状态|
|
||
|`GET`|`/quota`|配额占用|
|
||
|`GET`|`/memories`|查询/搜索记忆|
|
||
|`GET`|`/conversations`|查询对话|
|
||
|`PATCH`|`/memories/:id`|修改记忆|
|
||
|`DELETE`|`/memories/:id`|删除记忆|
|
||
|`GET`|`/audio/:filename`|音频文件|
|
||
|`POST`|`/admin/stop`|暂停循环|
|
||
|`POST`|`/admin/start`|恢复循环|
|
||
|`POST`|`/admin/restart`|重启进程|
|
||
|`POST`|`/admin/reset-memories`|清空记忆和对话|
|
||
|`POST`|`/admin/reset-files`|清空沙盒文件|
|
||
|
||
\---
|
||
|
||
## 持久化
|
||
|
||
* **记忆**：SQLite，FTS5 全文索引 + 可选向量嵌入
|
||
* **对话**：含渠道标记和 externalPartyId，多渠道互通可见
|
||
* **任务**：重启可恢复
|
||
* **焦点栈**：重启可恢复
|
||
* **配置**：`config.json`，含 Provider、社交、语音、嵌入、搜索全量配置
|
||
|
||
\---
|
||
|
||
## 辅助脚本
|
||
|
||
|脚本|用途|
|
||
|-|-|
|
||
|`scripts/send.py`|发送消息、查询状态|
|
||
|`scripts/reset.js`|清空数据库与沙盒|
|
||
|`scripts/seed-memories.js`|写入种子记忆|
|
||
|`scripts/smoke-tools.mjs`|工具冒烟测试|
|
||
|`scripts/smoke-brain-ui.mjs`|Brain UI 冒烟测试|
|
||
|`scripts/smoke-social.mjs`|社交连接冒烟测试|
|
||
|`scripts/start-lan.ps1`|局域网访问启动|
|
||
|`scripts/build-voice.ps1`|语音模型构建|
|
||
|
||
\---
|
||
|
||
## 技术栈
|
||
|
||
* **运行时**：Node.js 18+ / Electron 33
|
||
* **数据库**：better-sqlite3（同步、高性能）
|
||
* **LLM 接口**：OpenAI 兼容 API（6+ Provider）
|
||
* **语音**：Whisper（Python 进程）+ 云端 TTS
|
||
* **UI**：原生 Web Components + Brain UI SPA
|
||
* **构建**：electron-builder + NSIS
|
||
|
||
\---
|
||
|
||
## License
|
||
|
||
[MIT License](./LICENSE)
|
||
|