一个使用 Go 构建的 AI Agent,默认运行本机聊天服务,提供 Charm TUI,可选接入 Matrix、Violet、Telegram、Discord 与 Slack 站内聊天。
- Matrix 协议: 通过 mautrix-go 完整支持 Matrix 协议
- 端到端加密: Matrix 可选的 E2EE 支持,使用 goolm(纯 Go 实现,无需 CGO)
- Violet 站内聊天: 以 Bot API 的 bot 虚拟用户身份接入 Violet 博客的聊天系统,SSE 收消息、原地编辑做流式回复、断线按消息历史补拉(默认关闭,接入步骤见 docs/platform-system.md)
- 自主换头像: Matrix 与 Violet 的
saber_avatar工具可读取自身头像,并由已授权管理员通过聊天让 Saber 更换公开账号头像;支持本轮图片附件或已授权工作区图片,详见 头像工具。 - 可插拔平台层: 平台按
platforms.<name>.enabled启停,接入新平台不必改注册表与装配代码 - Telegram / Discord / Slack: 均默认关闭。Telegram 走
getUpdates长轮询;Discord 走 Gateway WebSocket(需在开发者后台开启MESSAGE_CONTENTintent);Slack 走 Socket Mode(需 bot 与 app 两个 token),详见配置
- OpenAI 兼容 API:
GET /v1/models与POST /v1/chat/completions(含流式),沿用服务端 Bearer 令牌;非任务、不持久化、不启用工具 - 编辑器接入(ACP):
saber acp通过 stdio 把 Agent Client Protocol 转发给已运行的saber serve,适用于 Zed 等编辑器 - 技能文件:
memory.skills.dirs读取<name>/SKILL.md,/skill files|import|export显式导入导出,聊天中可用/技能名调用 - 上下文与快照: 自动注入
AGENTS.md等工作区约定与@文件引用;write_file/apply_patch写前快照,snapshot rollback可撤回 - 历史摘要与画像:
saber_history结果附带带缓存的 LLM 摘要;/memory profile [refresh]查看或重建当前空间画像
- AI 集成: 内置 AI 对话功能,支持 OpenAI 兼容的 API
- 多提供商支持: 同时配置多个 AI 提供商,运行时动态切换模型
- 工具调用: 支持 MCP (Model Context Protocol) 工具调用,AI 可执行网络搜索、网页抓取等操作
- 流式响应: 实时流式输出,智能消息编辑
- 图片理解: 支持发送图片让 AI 理解和分析(需模型支持视觉功能)
- 上下文管理: 每个房间/群组独立的持久化对话上下文
- 可扩展命令: 清晰的命令注册和分发系统
- 自动重连: 弹性连接,支持指数退避
- 私聊自动回复: 在私聊中自动响应 AI 消息
- 群聊提及回复: 在群聊中被 @mention 时自动响应
- 回复延续对话: 回复机器人的消息时自动继续对话
- 主动聊天: AI 驱动的主动消息,支持静默检测、定时触发、新成员欢迎
- 人格管理: 支持为不同房间设置不同的机器人人格,包括内置人格和自定义人格
- 子代理并行: 顶层任务可用内置
delegate工具把独立子目标交给子代理并行完成(agent.subagents,默认开启) - 运行中转向:
!task redirect或自然语言补充可在运行中任务的下一轮之前注入,不必取消重开 - 批次与轨迹导出:
saber_batch把多条独立任务在一次事务里提交,saber_trace把任务轨迹导出为私有 JSONL 产物 - 危险命令审批:
execution.command_guard: ask把绊线命中改为一次性审批码,由授权成员!approve/!deny
- Meme 搜索: 支持搜索 GIF/Sticker/Meme 并发送到聊天(使用 Klipy API)
- Go 1.27.1 或更高版本
- (仅 Matrix 入口需要)一个 Matrix 账号
- (可选)一个 OpenAI 兼容的 API 密钥
git clone https://github.com/your-username/saber.git
cd saber
make build- 生成示例配置文件:
./bin/saber -generate-config -o config.yaml- 编辑
config.yaml填入你的设置:
platforms:
matrix:
enabled: false # 可选聊天入口;接入 Matrix 时设为 true
violet:
enabled: false # 可选聊天入口;endpoint 与 bot_token 在 Violet 管理端签发
ai:
enabled: true
# 多提供商配置(推荐)
providers:
openai:
type: "openai"
base_url: "https://api.openai.com/v1"
api_key: "your-api-key"
models:
gpt-4o-mini:
model: "gpt-4o-mini"
default_model: "openai.gpt-4o-mini" # 使用完全限定名称:提供商.模型名./bin/saber
# 在另一个终端打开 TUI 聊天
./bin/saber chat
# 或指定配置文件路径
./bin/saber -c /path/to/config.yaml
# 启用调试日志
./bin/saber -v直接运行 ./bin/saber 或 ./bin/saber serve 启动常驻服务,默认监听 127.0.0.1:8320。首次启动在配置目录创建 .saber-token(0600);HTTP 接口使用 Bearer 令牌认证。会话、任务和增量事件保存到 tasks.db,订阅断开不取消任务。Matrix 是独立的可选聊天入口。使用 ./bin/saber chat 进入 TUI,支持流式 Markdown、工具状态、会话切换、模型与思考等级选择。界面预览和快捷键见 终端聊天。
Matrix 仅在 platforms.matrix.enabled: true 时校验账号并连接服务器。旧配置需要按新配置结构重新整理。AI 未启用时服务继续运行,聊天入口提示完成模型配置。
| 标志 | 缩写 | 默认值 | 描述 |
|---|---|---|---|
-config |
-c |
./config.yaml |
配置文件路径 |
-verbose |
-v |
false |
启用调试日志 |
-version |
显示版本信息 | ||
-generate-config |
生成示例配置文件 |
项目的多阶段 Distroless 镜像用于普通聊天和不需要本地执行器的部署。它不包含 Docker CLI,也没有 daemon 连接及宿主工作区挂载配置,必须保持 execution.enabled: false。
需要 Agent 命令执行和文件工具时,使用 宿主二进制部署步骤。Saber 在宿主上调用 Docker CLI,任务命令仍在受限容器中执行。
# 构建当前平台镜像
make docker-build
# 构建多架构镜像(amd64 + arm64)
make docker-buildx
# 构建并加载到本地
make docker-load# 使用 make 运行(开发环境)
make docker-run
# 或手动运行
docker run --rm -it \
-v ./config.yaml:/data/config.yaml:ro \
-v ./data:/data \
--name saber \
saber:latest# 设置仓库地址并推送
make docker-push DOCKER_REGISTRY=your-registry.com/- 基础镜像: Distroless(无 shell,最小攻击面)
- 多架构: 支持 linux/amd64 和 linux/arm64
- 静态链接: 无需运行时依赖
- 非 root 运行: 安全默认配置
- 体积优化: 约 20MB(最终镜像)
项目使用 docker-bake.hcl 配置多架构构建,支持以下变量:
| 变量 | 默认值 | 描述 |
|---|---|---|
REGISTRY |
"" |
Docker 仓库地址 |
VERSION |
dev |
镜像版本标签 |
GIT_COMMIT |
unknown |
Git commit hash |
GIT_BRANCH |
unknown |
Git 分支名 |
BUILD_TIME |
"" |
构建时间 |
| 命令 | 描述 |
|---|---|
!ping |
检查机器人是否在线 |
!help |
列出所有可用命令 |
!version |
显示版本信息 |
!ai <message> |
与 AI 对话 |
!ai clear |
清除对话上下文 |
!ai context |
显示上下文信息 |
!ai models |
列出所有可用模型 |
!ai switch <id> |
切换全局默认模型(需命令管理员) |
!ai current |
显示当前默认模型 |
!task run <goal> |
创建后台任务 |
!task list/status/cancel |
查询或控制当前会话任务 |
!task logs <id> |
下载获授权任务的完整日志 |
!schedule once/every/weekdays |
创建定时计划 |
!schedule list/status/pause/delete |
查询或管理计划 |
!mcp list |
列出所有 MCP 服务器和工具 |
!meme <keyword> |
搜索并发送 GIF/Sticker/Meme |
!meme --gif <kw> |
搜索并发送 GIF 动图 |
!meme --sticker <kw> |
搜索并发送 Sticker 贴纸 |
!meme --meme <kw> |
搜索并发送 Meme 图片 |
!persona list |
列出所有可用人格 |
!persona set <id> |
设置当前会话人格 |
!persona clear |
清除当前会话人格 |
!persona status |
显示当前会话人格 |
!persona new ... |
创建共享人格(需命令管理员) |
!persona del <id> |
删除共享人格(需命令管理员) |
Matrix 继续推荐 ! 前缀;Violet 使用同一路径的 / 前缀,例如 /task list。群聊命令由 Violet 在正文开头插入目标 bot 提及:@(saber:<bot-user-id>) /task list。/ai <问题>保留原文,问题恰好以 clear 等命令词开头时写 /ai -- <问题>。未知命令和参数错误会直接回复,不会交给模型。全局及会话写入权限见 配置。Violet 暂不发布需要文件或图片发送能力的 task logs、meme。
当启用 direct_chat_auto_reply 时,机器人在私聊中会自动响应消息,无需 !ai 前缀。
当启用 group_chat_mention_reply 时,机器人在群聊中被 @mention 时会自动响应,无需 !ai 前缀。
配置示例:
ai:
enabled: true
group_chat_mention_reply: true # 启用群聊提及回复使用场景:
- 用户在群聊中发送
@botname 你好 - 机器人识别到提及并自动回复
当启用 reply_to_bot_reply 时,用户可以通过回复机器人的消息来继续对话,无需每次都使用 !ai 命令。
配置示例:
ai:
enabled: true
reply_to_bot_reply: true # 启用回复延续对话使用场景:
- 用户发送
!ai 你好 - 机器人回复
- 用户直接回复机器人的消息(使用 Matrix 的回复功能)继续讨论
- 机器人自动识别并继续对话
主动聊天功能让机器人能够在没有用户直接触发的情况下,主动向聊天室发送消息。这可以用于激活沉寂的群组、定时发送提醒、或欢迎新成员。
配置示例:
matrix:
proactive:
enabled: true
max_messages_per_day: 5
min_interval_minutes: 60
silence:
enabled: true
threshold_minutes: 60
check_interval_minutes: 15
schedule:
enabled: true
times: [ "09:00", "12:00", "18:00" ]
new_member:
enabled: true
welcome_prompt: "用友好的方式欢迎新成员加入"
decision:
model: ""
temperature: 0.8
prompt_template: ""主动聊天支持三种触发类型:
1. 静默触发 (Silence)
当聊天室长时间没有活动时,机器人会主动发送消息激活氛围。
silence:
enabled: true
threshold_minutes: 60 # 静默超过 60 分钟触发
check_interval_minutes: 15 # 每 15 分钟检查一次工作流程:
- 定时检查所有已加入的房间
- 计算每个房间距离最后一条用户消息的时间
- 如果静默时长超过阈值,触发 AI 决策
- AI 决定是否发送消息以及发送什么内容
2. 定时触发 (Schedule)
在指定的时间点发送消息,适合用于每日提醒、问候等场景。
schedule:
enabled: true
times: [ "09:00", "12:00", "18:00" ] # 24 小时制,格式 "HH:MM"工作流程:
- 每分钟检查当前时间是否匹配配置的时间点
- 每个时间点每天只触发一次
- 日期变化后自动重置触发状态
3. 新成员触发 (New Member)
当有新成员加入房间时,自动发送欢迎消息。
new_member:
enabled: true
welcome_prompt: "用友好的方式欢迎新成员加入"工作流程:
- 监听房间成员变更事件
- 检测到新成员加入时触发
- 使用 AI 生成个性化欢迎消息(如 AI 未启用则使用简单模板)
当触发器被激活后,AI 决策引擎会根据当前上下文决定:
- 是否应该发送消息
- 发送什么内容
决策上下文包括:
- 房间名称和成员数量
- 活动水平(low/medium/high)
- 距离最后一条消息的时间
- 今日已发送的主动消息数
- 触发类型(inactivity/scheduled/new_user)
决策配置:
decision:
model: "" # 指定决策使用的模型(留空使用默认模型)
temperature: 0.8 # 决策温度(0-2,较高值更有创造性)
prompt_template: "" # 自定义决策提示词(留空使用默认模板)决策响应格式 (JSON):
{
"should_speak": true,
"reason": "房间已静默 2 小时,适合发送消息激活氛围",
"content": "大家好,有什么有趣的话题想聊聊吗?"
}为避免过度打扰,主动聊天内置了频率限制:
max_messages_per_day: 5 # 每个房间每天最多 5 条主动消息
min_interval_minutes: 60 # 两次主动消息之间至少间隔 60 分钟限制规则:
- 达到每日上限后,当天不再发送主动消息
- 未达到最小间隔时,跳过本次触发
- 频率限制独立应用于每个房间
- 合理设置静默阈值: 建议设置为 60-120 分钟,避免在短暂停顿后打扰对话
- 控制每日消息量: 建议 3-5 条,避免让机器人显得过于活跃
- 选择合适的发送时间: 定时触发应避开深夜和凌晨
- 自定义欢迎提示词: 根据群组主题定制欢迎风格
- 监控决策日志: 观察 AI 的决策理由,适时调整配置
问题: 主动消息没有发送
检查以下几点:
proactive.enabled是否为true- AI 服务是否正常启用(
ai.enabled: true) - 检查日志中的频率限制信息
- 确认房间是否有足够的活动记录(新加入的房间可能缺少历史数据)
问题: 定时触发不工作
- 确认时间格式正确("HH:MM",24 小时制)
- 检查系统时区设置
- 查看日志确认触发器是否检测到时间匹配
问题: AI 决策总是返回不发送
- 检查决策温度设置(过低的温度可能导致保守决策)
- 查看决策上下文中的活动水平是否为 "high"
- 确认今日消息数是否已达到上限
Saber 支持同时配置多个 AI 提供商,使用完全限定名称(提供商.模型名)标识模型:
ai:
enabled: true
providers:
# OpenAI 提供商
openai:
type: "openai"
base_url: "https://api.openai.com/v1"
api_key: "your-openai-key"
models:
gpt-4o-mini:
model: "gpt-4o-mini"
gpt-4o:
model: "gpt-4o"
temperature: 0.5
# Azure OpenAI 提供商
azure:
type: "azure"
base_url: "https://your-resource.openai.azure.com"
api_key: "your-azure-key"
models:
gpt-4:
model: "gpt-4"
# Ollama 本地模型
ollama:
type: "openai" # Ollama 兼容 OpenAI API
base_url: "http://localhost:11434/v1"
models:
llama3:
model: "llama3"
qwen2:
model: "qwen2"
# 默认模型使用完全限定名称
default_model: "openai.gpt-4o-mini"!ai models # 查看所有可用模型(显示完全限定名称)
!ai switch openai.gpt-4o # 切换到指定模型
!ai current # 查看当前默认模型注意: 通过命令切换的默认模型在重启后会恢复为配置文件中的设置。
机器人支持图片理解功能,只需在私聊或 @机器人 的消息中发送图片,AI 会自动分析图片内容。
配置示例:
matrix:
media:
enabled: true # 启用媒体处理
max_size_mb: 10 # 最大文件大小(MB)
timeout_sec: 30 # 处理超时时间(秒)
# model: "openai.gpt-4o" # 指定视觉模型(留空使用默认模型)使用场景:
- 用户在私聊中发送图片
- 机器人自动调用视觉模型分析图片
- 用户可以追加文字说明,如"这张图片里有什么?"
Saber 支持 MCP (Model Context Protocol) 工具调用,让 AI 能够执行实际操作,如网络搜索、网页抓取等。
开启 MCP 并配置执行授权后,可使用以下内置工具:
| 工具 | 描述 |
|---|---|
fetch_url |
获取网页内容并转换为文本 |
web_search |
搜索互联网获取相关信息 |
run_js |
在安全沙箱中执行 JavaScript 代码 |
mcp:
enabled: true
# 内置工具配置
builtin:
web_search:
max_results: 5 # 最大返回结果数
timeout_seconds: 20 # 请求超时时间
js_sandbox:
enabled: true # 启用 JS 沙箱
timeout_ms: 5000 # 执行超时时间
max_memory_mb: 64 # 最大内存限制Saber 支持连接外部 MCP 服务器:
mcp:
enabled: true
servers:
# stdio 类型服务器
filesystem:
type: stdio
enabled: true
command: "/path/to/mcp-server-filesystem"
args: [ "--root", "/home/user/documents" ]
timeout_seconds: 30
# http 类型服务器
remote-server:
type: http
enabled: false
url: "https://mcp.example.com/api"
token: "your-bearer-token"当 AI 需要使用工具时,会自动调用相应的 MCP 工具。例如:
用户: 帮我搜索一下 Go 语言的最佳实践
AI: [调用 web_search 工具] 我找到了以下信息...
使用 !mcp list 命令查看当前可用的所有 MCP 服务器和工具。
Saber 支持 Meme 搜索功能,可以通过 Klipy API 搜索 GIF、Sticker 和 Meme 图片并直接发送到聊天。
配置示例:
matrix:
meme:
enabled: true
api_key: "your-klipy-api-key" # 从 partner.klipy.com 获取
max_results: 5
timeout_seconds: 10使用方式:
!meme happy # 搜索 GIF(默认)
!meme --gif happy # 搜索 GIF
!meme --sticker hello # 搜索 Sticker
!meme --meme cat # 搜索 Meme
人格功能允许为不同房间设置不同的机器人"性格",每个人格有独特的系统提示词,会在 AI 对话时与基础系统提示词合并。
| ID | 名称 | 描述 |
|---|---|---|
catgirl |
猫娘 | 可爱活泼,句尾加"喵~" |
butler |
管家 | 优雅恭敬,英伦风格 |
pirate |
海盗 | 豪爽冒险,说话带"啊哈" |
tsundere |
傲娇 | 表面冷淡内心温柔 |
poet |
诗人 | 文雅古风,喜用诗词 |
!persona list # 列出所有可用人格
!persona set catgirl # 设置当前房间为猫娘人格
!persona status # 查看当前房间的人格状态
!persona clear # 清除当前房间的人格设置
!persona new robot "机器人" "你是一个友好的机器人助手" "机器人人格"
参数说明:
robot- 人格 ID(唯一标识符)"机器人"- 显示名称"你是一个友好的机器人助手"- 系统提示词"机器人人格"- 描述信息
!persona del robot
注意:内置人格不可删除。
人格数据存储在 SQLite 数据库中,默认位于配置文件同目录下的 persona.db。
完整字段、默认值和可直接使用的示例见 配置说明。
| 配置节 | 职责 |
|---|---|
server |
本机 HTTP 服务及令牌 |
ai |
提供商、协议、模型参数、请求超时 |
agent |
任务轮数、总超时、流式传输、重试、上下文预算 |
matrix |
可选聊天接入、媒体、主动聊天、Meme |
mcp / execution |
可选工具与服务端授权 |
shutdown |
优雅关闭时限 |
-generate-config 输出以服务端为中心的精简配置;Matrix、MCP 和本地执行默认关闭,不预置空密钥模型。旧配置不自动迁移,未知字段明确报错。模型输出预算与温度按模型覆盖全局设置;思考等级支持模型、提供商、全局继承和 TUI 本轮覆盖。
agent.context 裁剪实际模型输入,保留完整工具调用轮次,不删除数据库历史。请求时限、任务时限和单次工具时限分别配置,详见配置说明。Responses 模型清单见 接入说明。
Saber 的 Matrix 聊天入口通过 chat.Handler 接收并持久化任务,由 task.Manager 后台调用 Agent Runtime,结果单独投递。
嵌入式调用可继续使用 conversation.Processor 的同步会话模式。Matrix 和内存 adapter 共用消息、会话和回复契约;核心 task、agent、chat、conversation、model、mcp 不依赖 Matrix SDK。
应用默认运行本机 HTTP/SSE 服务,统一管理 Agent 与持久化任务。聊天入口读取事件或注册终态投递器;Matrix 的同步和投递仅在启用时装配。
接口、会话隔离及验收命令见 通用聊天接入。
任务命令、恢复规则和验收命令见 持久化任务。
自主命令/文件工具、容器隔离和成员授权见 执行权限配置。
定时计划命令、时区与重启语义见 持久化定时计划。
saber/
main.go # 入口点
main_test.go # 主测试
Makefile # 构建和 Docker 命令
Dockerfile # Docker 多阶段构建
docker-bake.hcl # Docker 多架构构建配置
config.example.yaml # 示例配置文件
internal/
chat/ # 通用消息、会话、回复与展示能力契约
memory/ # 无网络聊天 adapter
command/ # 统一命令注册、解析、执行与目录
platform/ # 可插拔平台接入端接口与注册表
terminal/ # 本机 HTTP 聊天入口生命周期(saber chat / TUI 后端)
matrix/ # Matrix 平台接入端:消息适配与任务投递
violet/ # Violet Bot API、SSE 与命令目录发布
telegram/ # Telegram Bot API 长轮询接入
discord/ # Discord Gateway WebSocket 与 REST 接入
slack/ # Slack Socket Mode 接入
acp/ # Agent Client Protocol stdio 适配(saber acp)
conversation/ # 平台无关的历史、串行调度与回复交付
task/ # SQLite 任务与定时计划、执行日志、目录互斥和结果重试
automation/ # 持久自动化的调度、边界、审计与任务交付,复用唯一任务管理器
batch/ # 从持久任务导出 ShareGPT 轨迹、检查点与评估
execution/ # 容器命令/文件工具、权限检查、日志与交付文件
snapshots.go # write_file/apply_patch 写前快照与回滚
refs.go # 工作区上下文文件与 @ 引用解析
browser/ # 原生 CDP 浏览器工具与进程管理,不执行宿主脚本
computer/ # 经 cua-driver MCP 的桌面截屏与输入控制
codeexec/ # 受任务隔离的持久代码单元与工具 RPC
devtools/ # 受任务后端约束的 LSP 诊断、补全与文档辅助
discovery/ # 按当前任务授权渐进披露工具
toolkit/ # 可选能力共用的工具端口与宿主授权
vault/ # 按用户与站点绑定的秘密存储,仅交给受监督浏览器
plugins/ # 显式安装的进程插件、受权扩展调用与托管连接器
agent/
runtime.go # 独立执行循环、预算、取消和工具错误回传
types.go # 模型与工具接口、运行事件和每轮记录
bot/
bot.go # 机器人初始化和生命周期
chat_commands.go # 通用命令装配与平台能力
errors.go # 错误定义
server/ # 本机会话接口、令牌认证、持久化事件流与本机命令入口
tui/ # Charm 聊天界面、模型选择、断线续读
desktop/ # 隔离 Electron 桌面客户端启动、面板与音频代理
cli/
flags.go # 命令行标志解析
setup/ # 显式授权的本机初始化、配置、安装、升级与回滚
config/
config.go # 配置加载和验证
commands.go # 命令管理员与会话写入权限
provider.go # 提供商配置和模型 ID 解析
context/
keys.go # 上下文键定义
user.go # 用户上下文工具
db/
sqlite_nocgo.go # SQLite 纯 Go 驱动(默认使用)
matrix/
client.go # Matrix 客户端封装
crypto.go # E2EE 支持
handlers.go # 事件处理和命令分发
chat_adapter.go # 通用消息、媒体和回复契约适配
presence.go # 在线状态管理
rooms.go # 房间操作
context.go # 上下文工具
mention.go # 提及解析服务
reply.go # 回复工具
media.go # 媒体上传和处理
commands/ # 命令模块
register.go # 命令注册
ping.go # !ping 命令
help.go # !help 命令
version.go # !version 命令
ai.go # AI 命令处理
meme.go # Meme 命令
model/ # 不依赖聊天平台的模型核心
core.go # 客户端缓存和请求限流
client.go # 协议分流与 OpenAI 兼容客户端
responses.go # Responses 消息、工具与流式终态适配
strategy.go # 提供商策略
model_registry.go # 模型注册与选择
agent.go # Runtime 模型接口适配
stream_tool_handler.go # 模型增量拼接
retry_handler.go # 重试逻辑和退避
circuit_breaker.go # 熔断器
ai/ # 模型、任务与通用聊天处理
service.go # 装配通用聊天处理器
chat_commands.go # AI、任务及计划的通用命令处理
agent.go # 模型/MCP 装配与 Agent Runtime
model_compat.go # 旧模型名称兼容,不包含重复实现
context_manager.go # Matrix 历史命令适配通用存储
proactive.go # 主动聊天管理器
proactive_rooms.go # 主动聊天的平台房间端口与会话降级
proactive_triggers.go # 触发器实现(静默/定时)
proactive_state.go # 房间状态跟踪
proactive_decision.go # AI 决策引擎
tools.go # 工具管理
memory.go # 记忆快照注入与 saber_memory 工具
memory_commands.go # memory 通用命令处理
skills.go # 技能管理 saber_skill 工具定义与执行
skill_commands.go # skill 通用命令处理
history.go # 历史回忆 saber_history 工具与投影同步
memory_review.go # 受限沙箱后台复盘与配额控制流水线
memory_profile.go # 用户画像生成、注入与刷新
openai_api.go # OpenAI 兼容 /v1 非任务请求
context_files.go # 工作区约定文件与 @ 引用展开
mcp/
manager.go # MCP 管理器
factory.go # MCP 服务器工厂模式
config.go # MCP 配置验证
tools.go # 工具管理
middleware.go # 中间件
validation.go # 输入验证
logging.go # 日志中间件
servers/ # MCP 服务器实现
builtin.go # 内置服务器注册
shared_client.go # 共享 HTTP 客户端
web_fetch.go # 网页抓取工具
web_search.go # 网络搜索工具
js_sandbox.go # JavaScript 沙箱
stdio.go # Stdio MCP 服务器
http.go # HTTP MCP 服务器
media/ # Go 原生媒体协议、生成、转录与实时语音
meme/
service.go # Meme 服务(Klipy API)
chat_command.go # 通用图片命令处理
command.go # !meme 命令处理
persona/
types.go # Persona 结构体定义
builtin.go # 内置人格定义
service.go # 人格服务(CRUD、完整会话键映射)
chat_commands.go # 通用人格命令处理
commands.go # !persona 命令处理
memory/
types.go # 作用域、条目、建议、技能与容量定义
service.go # 按用户与群作用域隔离的记忆读写与授权
store.go # memory.db 表结构与扫描
snapshot.go # 受预算限制的注入快照
history.go # 历史投影记录、FTS5 全文召回与上下文读取
review.go # 复盘设置、配额、排除来源与复盘结果存储
skills.go # 程序性技能存储、CAS版本控制、建议流与目录生成
memoryproviders/ # 已核实协议的外部原生记忆服务接入,作用域与权限由 Saber 决定
由于使用了 goolm 纯 Go 实现的加密,则需要在编译时添加 tag。Makefile 已经添加好了,如果编辑器也需要,则可以使用环境变量来添加。
# mautrix 加密需要的 tag
export GOFLAGS="-tags=goolm"make build # 构建二进制文件(纯 Go,静态链接)
make build-prod # 构建优化的生产版本(额外内联优化)
make build-all # 构建所有平台(macOS/Linux/Windows/FreeBSD/OpenBSD/Loong64)
make run # 使用 go run 运行
make test # 运行测试
make test-cover # 运行测试并生成覆盖率报告
make fmt # 格式化代码
make lint # 运行代码检查
make clean # 清理构建产物项目使用纯 Go 编译(CGO_ENABLED=0),使用 modernc/sqlite 作为 SQLite 驱动:
| 命令 | 特点 | 适用场景 |
|---|---|---|
make build |
纯 Go,静态链接 | 日常开发 |
make build-prod |
纯 Go + 激进内联优化 (-gcflags="-l=4") |
生产部署 |
make build-all |
交叉编译 11 个目标:macOS、Linux、Windows、FreeBSD、OpenBSD | 发布版本 |
每次向任意分支推送时,GitHub Actions 会分别运行格式与 lint、测试与覆盖率门禁、当前平台构建;向 master 或 main 提交的 PR 也会运行这些检查。
发布时先更新 Makefile 的 VERSION 和 CHANGELOG.md 中对应的版本说明。把提交推送并确认 CI 通过后,推送形如 v0.1.0 的标签。标签对应的 CI 检查全部通过后,Release 任务会交叉编译 macOS amd64/arm64、Linux amd64/arm64/loong64、Windows amd64/arm64、FreeBSD amd64/arm64、OpenBSD amd64/arm64,将 11 个二进制文件及 SHA256SUMS 上传至 GitHub Release。
构建参数说明:
| 参数 | 作用 |
|---|---|
CGO_ENABLED=0 |
禁用 CGO,强制纯 Go 编译 |
-tags goolm |
使用纯 Go 的 E2EE 实现 |
-trimpath |
移除文件系统路径,可复现构建 |
-ldflags="-s -w" |
移除符号表和调试信息,减小体积 |
-ldflags="-X ..." |
运行时注入版本、Git commit 等信息 |
-gcflags="-l=4" |
激进内联优化(仅 build-prod) |
E2EE 需要 goolm 构建标签:
go build -tags goolm .
go run -tags goolm main.go
go test -tags goolm ./...# 安装 goimports(格式化和自动导入管理)
go install golang.org/x/tools/cmd/goimports@latest
# 安装 golangci-lint(代码检查)
# macOS/Linux
curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/master/install.sh | sh -s -- -b $(go env GOPATH)/bin
# 或使用 go install
go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest- 提交前运行
make fmt(使用 goimports 格式化代码并自动管理导入) - 遵循 Effective Go 指南
- 所有导出标识符的注释使用中文
- 永远不要忽略错误
- 永远不要将
config.yaml提交到版本控制 - 配置文件与会话文件包含密钥,建议手动执行
chmod 600 config.yaml(程序不再强制校验权限) - 会话文件包含访问令牌,使用
0600权限保护 - 生产环境使用访问令牌而非密码
- E2EE pickle 密钥应安全存储
- mautrix-go - Matrix 客户端库
- go-openai - OpenAI 客户端
- go-sdk - MCP (Model Context Protocol) SDK
- goja - JavaScript 运行时(用于 JS 沙箱)
- tint - 带颜色的结构化日志
- bluemonday - HTML 净化库
- modernc/sqlite - 纯 Go SQLite 驱动
MIT License