Alice

C++ 写的 AI Agent 运行时平台。Core 只管提供能力，业务逻辑全部交给 Mod。

这是什么

Alice 是一个微内核架构的 AI Agent 平台。核心 (AliceCore) 提供运行时基础设施——事件总线、服务注册、管线引擎、HTTP/WS 服务器、脚本引擎、定时器、文件存储等——但不包含任何业务逻辑。所有业务行为（聊天、AI 调用、工具执行、文件操作）都由 Mod 定义。

设计理念

Core 是平台，不是应用。

Core 不知道"聊天"、"AI"、"角色"这些业务概念。它只提供通用能力（事件、服务、管线、存储、网络），让 Mod 去定义一切。这意味着 Alice 不只能做聊天机器人——换一套 Mod，它可以是任务调度器、数据处理管线、IoT 网关，或者别的什么东西。删掉所有 Mod，Alice 还是能启动，只是没有功能。

验收标准: 删掉所有 Mod，Core 还能跑。加一个新 Mod，不改 Core 一行代码。

特性

• 四种插件语言: C++ DLL / C# (.NET 10) / Lua / JavaScript (QuickJS)
• 统一 API: 不管用哪种语言写 Mod，都通过同一套 alice.* API 访问平台能力
• Agent 循环: Handler + Regen Loop，LLM 可以调用工具、看到结果、继续推理
• 流式输出: SSE + WebSocket 双通道，Stream Masker 实时隐藏工具调用标签
• 多 LLM 支持: OpenAI / Claude / Gemini / Vertex AI，协议插件可扩展
• 热重载: 改了 Mod 文件自动重载，不用重启
• 事件治理: TTL、链路深度限制、异步分发

项目结构

Alice/
├── AliceCore/          C++ 核心静态库 (12 个模块)
├── AliceServer/        可执行文件入口
├── AliceSdk/           C# 插件 SDK (Alice.SDK.dll)
├── ThirdParty/         第三方依赖 (bee, dotnet hosting)
├── mods/               示例 Mod
│   ├── ai-manager/     多 Provider 路由
│   ├── chat-pipeline/  聊天编排 + Regen Loop
│   ├── providers/      LLM 协议 (openai/claude/gemini/vertexai-cf)
│   ├── handlers/       工具 Handler (code-exec/file-ops/timer)
│   ├── hello-js/       QuickJS 示例
│   └── hello-csharp/   C# 示例
└── docs/               文档

写一个 Mod

Lua 最简示例

mods/my-mod/
├── alice.json
└── main.lua

{
    "id": "my-mod",
    "name": "My Mod",
    "version": "1.0.0",
    "type": "plugin"
}

function onLoad()
    alice.service.register("my.echo", function(method, args_json)
        return '{"echo":"' .. method .. '"}'
    end)
    alice.log.info("My Mod loaded!")
end

function onUnload()
    alice.log.info("My Mod unloaded")
end

完整开发指南见 docs/PLUGIN_GUIDE.md。

alice.* API 概览

这套 API 在 Lua、JavaScript、C# 中完全一致。

Regen Loop (Agent 工具调用循环)

sequenceDiagram
    participant User as 用户
    participant CP as chat-pipeline
    participant LLM as LLM API
    participant H as Handler

    User->>CP: 发送消息
    loop 最多 10 轮
        CP->>LLM: 调用 (流式)
        LLM-->>CP: 回复 (可能含工具标签)
        CP->>H: 解析标签, 执行工具
        H-->>CP: 返回结果 + regen=true/false
        alt regen=true
            Note over CP: 工具结果追加到 messages, 继续循环
        else regen=false
            Note over CP: 结束循环
        end
    end
    CP-->>User: 最终回复

HTTP API

项目开源

Alice-微内核架构的 AI Agent 平台

项目作者KK&Zixue

项目地址https://github.com/systemal/Alice