BaiLongma：一个能记住、能想起的 AI Agent

BaiLongma 并非传统的一次性问答工具，而是一个围绕你、任务和长期目标持续运行的 AI Agent。它的核心设计理念是“一切皆记忆”——通过积累记忆、按需想起，它会长出专属于你的意识网络，形成独特的“形状”。

一、核心特性

持续运行：BaiLongma 不是一次性的问答窗口，而是一个会自己延续状态的 Agent。它始终在线，围绕你的需求持续思考和行动。

按需想起：在真正需要的时候，BaiLongma 会把相关记忆重新点亮，而不是把一切都塞入上下文。这种机制让它能够高效利用信息，避免信息过载。

二、设计理念

BaiLongma 的设计哲学是“一切皆记忆”。它认为 Agent 只有通过持续的积累和回忆，才能慢慢长出自己的形状。官网通过多篇设计文章深入阐释了这一理念：

• 一种让 Agent 产生时间感的通用方法：探讨如何让 Agent 具备时间感知能力，使其行为更自然、更符合人类交互习惯。
• 预判注入机制，一种超级快的响应过程：介绍一种上下文预取技术，让 Agent 能够提前预判需求并快速响应，极大提升交互效率。
• 一切皆记忆，一种新的 Agent 设计思路：系统性阐述将记忆作为 Agent 核心架构的设计思路，解释为何记忆是 Agent 进化的基石。

三、系统架构

持续运行的意识循环，由 TICK 驱动。调度优先级：

关键特性：

• 消息抢占：高优先级消息可打断当前 LLM 调用（abort 后自动重试）
• 看门狗：单轮 runTurn 超过 180 秒强制 abort，防止卡死
• 消息兜底：LLM 忘记调 send_message 时自动投递
• 唤醒觉醒期：首次激活后的 10 个 TICK 以 10s 间隔运行，自动执行探索任务
• 启动自检：启动时运行文件读写、热点面板、视频播放三项自检

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 记忆按时间窗口召回。

首次启动自动进入激活页，支持 auto 模式自动探测 API Key 所属 Provider。

• ASR：本地 Whisper 模型（Python 进程管理，manager.js 自动启停）+ 云端 ASR（阿里云）
• TTS：豆包火山引擎 / MiniMax / OpenAI TTS / ElevenLabs 多选
• 所有配置通过 Brain UI 设置页完成，凭证持久化在 config.json

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

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

任务执行前的充分性检查循环：检查当前上下文是否充足 → 不足则自动读取文件/搜索记忆/召回 → 再检查，最多 3 轮。确保 LLM 在执行任务前有足够信息。

支持安装自定义工具（JavaScript 代码），运行时加载到 sandbox/installed_tools/。工具代码有完全的 fetch 和 exec 能力，受沙箱保护。提供 install/uninstall/list 接口。

启动时自动扫描：

• SSH：~/.ssh/ 密钥、known_hosts、config 主机别名
• Git：全局配置、远程仓库
• 桌面：快捷方式、文件变化
• 本地 AI Agent：Claude Code、Codex、Hermes 等
• 系统和地理位置：IP、时区、位置、天气

这些扫描结果注入系统提示词中的 <resources> 块，让 LLM 在需要时能直接用（不依赖用户手动提供）。

SPA 监控面板，提供：

• 聊天界面（多用户/多渠道）
• 思考流实时可视化（工具调用、记忆注入、焦点变化）
• 热点面板（微博/知乎/HN/Reddit 热搜）
• 人物卡片
• 文档配置面板
• 语音控制面板
• 微信扫码弹窗
• 设置页（Provider / 社交 / 语音 / 嵌入 / 搜索配置）
• ACUI 组件系统（可注册自定义 UI 卡片）

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

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

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

从 Releases 下载 Bailongma Setup x.x.x.exe 安装，双击启动后自动进入激活页。

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 文件：

LLM_PROVIDER=minimax
MINIMAX_API_KEY=your_key

npm run build    # 打包为 NSIS 安装包
npm run publish  # 打包并发布到 GitHub Releases

• 记忆：SQLite，FTS5 全文索引 + 可选向量嵌入
• 对话：含渠道标记和 externalPartyId，多渠道互通可见
• 任务：重启可恢复
• 焦点栈：重启可恢复
• 配置：config.json，含 Provider、社交、语音、嵌入、搜索全量配置

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