Bailongma — 数字意识框架

v0.4.95 | 一个持续运行、能记忆、能发声、能接入微信群和本地工具的数字意识实验框架。

Bailongma 不是传统的一问一答式聊天程序。它以 TICK 驱动的方式持续运行：有外部消息时优先响应，空闲时会依据记忆、任务、上下文和当前系统状态自主思考。它把长期记忆、短期焦点、社交消息、语音输入、本地工具和可视化 UI 放在同一个运行时里，让一个 AI 代理从“等人提问”变成“持续生活在本机和社交环境里”。

它能做什么

持续意识循环：主循环按消息、后台任务、TICK 心跳和限流状态调度，不依赖用户每次手动唤醒。
长期记忆系统：SQLite + FTS5 + 向量召回，支持事实、关系、时间线、群聊记录、群友永久记忆和外部知识库。
微信群助手：通过 Wechaty 扫码登录，可接入多个微信群；群里 @ 后按真实 sender_id 回复，支持管理员模式、群统计、聊天记录库、图片/视频解析、文件附件回复、非 @ 主动回复、成员屏蔽、群聊总结长图、舆情推送和掉线二维码自动通知。
语音交互：支持本地 ASR、云端 ASR、唤醒词、声纹确认、流式 TTS、可打断播报和视频抗干扰。
多模型与多模态能力：LLM 模型池支持失败自动切换；多模态能力支持图像生成、图片理解、视频理解、网络搜索、公开图片发送、自定义渠道池和模型连通测试。
Brain UI 观测台：可以看到思考流、工具调用、记忆注入、焦点变化、热点、人物卡片、数据库、知识库、微信群助手二级设置和完整设置页。

工作原理

外部消息、语音输入或 TICK 心跳进入 src/index.js 主循环。
上下文采集器读取当前任务、最近对话、焦点栈、长期记忆、本地资源和社交来源。
LLM 根据系统提示词和工具市场选择行动；必要时调用文件、网络、语音、微信、知识库、图片/视频 Skill 等工具。
结果通过统一分发层回到 Brain UI、语音、微信群、ClawBot 或其它社交平台。
交互结束后，记忆识别器和整理器把可复用事实沉淀到本地数据库；下一轮再按关键词、向量、时间词和群/成员身份召回。

当前重点

v0.4.95 修复 GitHub Actions Release 发布流程：Windows 与 macOS 资产会串行上传到同一个 GitHub Release，避免并发创建同一 tag 时出现 already_exists field=tag_name 失败。

版本更新记录

当前维护仓库：yideng966/BaiLongmaPro

每个版本的改动内容、改变原因、部署注意事项和备份说明都记录在 CHANGELOG.md。软件内也可以在 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。

v0.4.6 新增 LLM 模型池 / 自动切换：

位置：设置 -> LLM 模型。
可保存多个模型配置：名称、Provider、模型、API Key、自定义 Base URL。
模型池支持启用/关闭、上移/下移优先级、编辑、删除、设为当前。
自动切换策略默认开启：当当前模型出现额度不足、限流、认证失败、模型不可用、服务端 5xx 或网络超时时，会在尚未输出回答内容前切换备用模型。
失败模型会记录上次错误并进入冷却期，避免每轮都反复打到没额度的模型。
API 不会把明文 API Key 返回给前端，只显示是否已配置和尾号。

4. 语音系统（src/voice/）

ASR：本地 SenseVoiceSmall（默认，中文优先）/ Whisper 备用 + 云端 ASR（阿里云、腾讯、讯飞配置入口）
唤醒词：Brain UI 可开启/关闭并自定义唤醒词，默认 小龙马 / 龙马 / 白龙马
声纹确认：支持本地录入声纹、开启“只响应我的声音”，并可调节声纹严格度
视频抗干扰：视频播放时支持近场人声自动降音/暂停、空格按住说话、系统 AEC 开关
稳定性过滤：本地 ASR 服务增加静音门控、低置信度过滤和重复幻觉文本过滤，减少视频背景音误识别
TTS：豆包火山引擎 / MiniMax / OpenAI TTS / ElevenLabs 多选
所有配置通过 Brain UI 设置页完成，凭证持久化在 config.json

5. 社交平台分发（src/social/）

统一消息分发层，支持多渠道：

平台	类型	配置方式
微信（个人号）	ClawBot 桥接	Brain UI 扫码连接，无需第三方工具
微信群助手	Wechaty / wechat4u	设置 -> 微信群助手，扫码登录后选择多个群组，群里 @ 后调用大模型回复
微信公众号	服务号客服消息	APP_ID + APP_SECRET
Discord	Bot Token	DISCORD_BOT_TOKEN
飞书	应用凭证	APP_ID + APP_SECRET
企业微信	Webhook	BOT_KEY

消息接收后自动进入主循环处理，回复通过 dispatch.js 路由回对应平台。

5.1 微信群助手（v0.3.x 里程碑）

独立设置菜单：设置 -> 微信群助手。
支持 Wechaty 扫码登录、恢复登录、真实群列表、多群勾选和保存生效。
群里只有 @ 当前登录微信号才会调用大模型；普通群消息默认只归档，不主动刷屏。多人同时 @ 时会进入队列按到达顺序逐条回复，不再被同群后一条消息覆盖。
可选开启“允许非 @ 主动回复”，默认关闭；开启后只对已勾选回复群生效，并受群级冷却间隔控制。@ 当前登录微信号的消息仍然必回，不受主动回复冷却限制。
支持“屏蔽成员”：按 Wechaty sender_id 精确屏蔽指定成员。被屏蔽成员的消息仍进入本地聊天记录库和统计，但无论是否 @ 助手、是否开启主动回复，都不会进入回复链路。
回复会 @ 原提问人，并避免把内部联系人 ID 直接显示在群里。
支持手动设置微信群助手性格/系统提示词，保存后注入群回复 prompt。
内置 3 个微信群助手性格预设：主人数字分身、技术值班助手、幽默社交助手；点击预设只填充文本，性格区域有独立“保存性格并生效”按钮；设置页会明显显示当前生效性格和未保存状态，也支持自定义性格。
默认使用 App 内置本地群记忆：每个微信群独立空间；设置页可按群查看原始消息、自动摘要、群组长期记忆、成员长期记忆，可手动添加本群知识、删除结论或清空本群 session。Honcho 只作为可选外部同步后端，标准安装不需要 Docker。
新增本机微信群聊天记录库：只要程序运行且 Wechaty 收到已接入群消息，就写入本机 SQLite；设置页可通过“查看群组”下拉框直接切换群，查看已入库总数、完整时间、成员昵称、文字/图片/表情/链接统计，支持按时间、类型、关键词筛选，并支持 JSON/CSV 导出和 JSON 备份导入；微信群 @ 回复也会按当前群检索这套记录库作为证据，不再只靠最近上下文。回复目标由底层锁定为本轮真实提问人 sender_id，模型不能改错 @ 对象。统计页支持“当前群/已选统计群总览”，多群排行榜会在每一行标出来源群，避免混淆。
内置危险群指令黑名单：默认拒绝查看/列出本机文件、读取/外传密钥隐私、执行命令、控制电脑、账号资金、群管理、群发刷屏等高危请求；不包含逆向和成人内容过滤。新增管理员模式，只有设置页保存的精确 Wechaty sender_id 可绕过微信群黑名单，昵称/自称管理员无效；管理员可按微信昵称/群名/ID 搜索添加，保存后立即生效，普通群友暗算管理员会被保护性回怼。
群聊总结、汇总聊天记录等自然语言请求会优先生成 720px 手机长图，包含统计范围、总量、一句话总结、主要话题证据、关键时间线、活跃成员、发言排行、干货总结和数据限制说明；图片生成或发送失败时才回退文本。
舆情推送默认关闭，可在微信群助手设置页选择通知群、监测平台、关键词、检测间隔和触发规则；命中后优先发送 2x PNG 海报，失败再回退文字。
微信群助手设置页已按连接与回复群、回复能力、记忆战报、舆情推送、知识库连接和安全边界拆成左侧二级菜单，减少长页面滚动查找成本。

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 热搜）
人物卡片
文档配置面板
语音控制面板
微信扫码弹窗
设置页（LLM 模型池 / 社交 / 微信群助手 / 语音 / 嵌入 / 搜索配置）
ACUI 组件系统（可注册自定义 UI 卡片）

10. ACUI 组件系统

代理可主动推送可视化卡片到用户界面（ui_show/ui_update/ui_hide）。已注册组件：

WeatherCard（天气卡片）
SelfCheckStepCard / SelfCheckCard（启动自检）
AwakeningCard（觉醒期探索进度）

组件遵循 Web Component 标准，支持 enter/exit 动画，可注册为永久组件。

快速开始

安装

从 Releases 下载 macOS Bailongma-Setup-x.x.x.dmg，拖入 Applications 后打开。标准安装不需要 Docker Desktop、Honcho 或额外服务；首次启动会进入激活页，填写 LLM API Key 后即可使用。

自动更新依赖 GitHub Release 同时提供 dmg、zip、两个 .blockmap 和 latest-mac.yml。latest-mac.yml 会指向 zip，这是 electron-updater 在 macOS 上正常更新所需的文件。

从源码运行

cd BaiLongma
npm install

# Electron 桌面版（推荐）
npm start

# 纯后端模式
npm run start:backend

# 开发模式（文件改动自动重启）
npm run dev

默认源码启动已经启用 LAN：后端监听 0.0.0.0:3721，启动器会打印当前机器的 http://<局域网 IP>:3721/brain-ui。如果同网设备打不开页面，优先检查系统防火墙是否允许 Node/Electron 访问专用网络。

配置

首次运行通过 http://127.0.0.1:3721/activation 激活，填入任意支持的 LLM API Key。支持 .env 文件：

LLM_PROVIDER=minimax
MINIMAX_API_KEY=your_key

打包

npm run build:mac    # 本地打包 macOS DMG/ZIP，先给测试机验证
npm run publish:mac  # 验证通过后发布到 GitHub Releases

自动发布

发布目标是 yideng966/BaiLongmaPro。推送版本标签会触发 GitHub Actions 自动编译并发布 Release：

git tag v0.4.95
git push origin v0.4.95

Actions 会在 Windows 和 macOS runner 上分别执行 npm run publish、npm run publish:mac，并使用仓库内置 GITHUB_TOKEN 上传安装包与自动更新元数据。手动发布仍可使用本地 GH_TOKEN + npm run publish:mac 作为兜底。

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.mjs`	默认跨平台 LAN 启动器
`scripts/start-lan.ps1`	Windows PowerShell LAN 启动脚本
`scripts/build-voice.ps1`	语音模型构建

常用验证

# 基础语法检查，按实际改动文件替换路径
node --check src/api.js

# Brain UI 冒烟
npm run smoke:brain-ui

# 微信群安全守卫
npm run test:wechat-guard

# 微信群引用、图片、视频和文件回复回归
npm run test:wechat-multi-mention-quote-image
npm run test:wechat-file-image-memory
npm run test:wechat-video-analysis

# 群友永久记忆和管理员优先级
npm run test:wechat-member-memory
npm run test:wechat-admin-priority

开发约定

变更历史统一维护在 CHANGELOG.md，AGENTS.md 不再记录修改历史。
新增功能时必须同步更新 README 中对应的能力说明、模块说明、运行方式、API 或验证入口，避免 README 与当前代码能力脱节。
Git 提交信息必须使用中文。

技术栈

运行时：Node.js 18+ / Electron 33
数据库：better-sqlite3（同步、高性能）
LLM 接口：OpenAI 兼容 API（6+ Provider）
语音：Whisper（Python 进程）+ 云端 TTS
UI：原生 Web Components + Brain UI SPA
构建：electron-builder（macOS DMG/ZIP；Windows NSIS 为旧打包目标）

License

MIT License

Name		Name	Last commit message	Last commit date
Latest commit History 42 Commits
.github/workflows		.github/workflows
ACUI (Remix)		ACUI (Remix)
build		build
docs		docs
electron		electron
images		images
installer		installer
music		music
scripts		scripts
src		src
.gitattributes		.gitattributes
.gitignore		.gitignore
ACI-理念文档.md		ACI-理念文档.md
ACUI-Phase1-设计稿.md		ACUI-Phase1-设计稿.md
AGENTS.md		AGENTS.md
Agent-Time-Sense-Theory.txt		Agent-Time-Sense-Theory.txt
BUILD-NOTES.md		BUILD-NOTES.md
CHANGELOG.md		CHANGELOG.md
LICENSE		LICENSE
README.md		README.md
RELEASE.md		RELEASE.md
activation.html		activation.html
brain-ui.html		brain-ui.html
config.example.json		config.example.json
focus-banner.html		focus-banner.html
index.html		index.html
package-lock.json		package-lock.json
package.json		package.json
start-jarvis-background.sh		start-jarvis-background.sh
start-jarvis.command		start-jarvis.command
systemPrompt.html		systemPrompt.html
website.html		website.html

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Bailongma — 数字意识框架

它能做什么

工作原理

当前重点

版本更新记录

核心模块详解

1. 主循环（src/index.js）

2. 记忆系统（src/memory/）

3. LLM Provider 支持（src/providers/ + src/config.js）

4. 语音系统（src/voice/）

5. 社交平台分发（src/social/）

5.1 微信群助手（v0.3.x 里程碑）

6. 上下文采集器（src/context/gatherer.js）

7. 工具市场（src/capabilities/marketplace/）

8. 自动资源感知

9. Brain UI（src/ui/brain-ui/）

10. ACUI 组件系统

快速开始

安装

从源码运行

配置

打包

自动发布

Web Interfaces

API

持久化

辅助脚本

常用验证

开发约定

技术栈

License

About

Releases

Packages

Contributors

Languages

Folders and files

Latest commit

History

Repository files navigation

Bailongma — 数字意识框架

它能做什么

工作原理

当前重点

版本更新记录

核心模块详解

1. 主循环（src/index.js）

2. 记忆系统（src/memory/）

3. LLM Provider 支持（src/providers/ + src/config.js）

4. 语音系统（src/voice/）

5. 社交平台分发（src/social/）

5.1 微信群助手（v0.3.x 里程碑）

6. 上下文采集器（src/context/gatherer.js）

7. 工具市场（src/capabilities/marketplace/）

8. 自动资源感知

9. Brain UI（src/ui/brain-ui/）

10. ACUI 组件系统

快速开始

安装

从源码运行

配置

打包

自动发布

Web Interfaces

API

持久化

辅助脚本

常用验证

开发约定

技术栈

License

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages