碳核 (Carbon-Core)

“我是碳核，你的碳基生命在硅基世界的延伸。无论是探测服务器漏洞，还是想听一首我推荐的歌，我都在。” 🦾

在 AI 助手泛滥的今天，大多数模型仍停留在“陪聊”阶段，面对具体任务时容易幻觉编造、拒绝调用工具或陷入死循环。碳核 (Carbon-Core) 是一个基于 nanobot 深度定制的超轻量级个人 AI 助手，专为行动而生。它通过一系列硬核的工程化改进，彻底解决了“模型只动口不动手”的顽疾，支持全平台接入，并具备 7x24 小时稳定运行能力。

核心亮点：为“执行”而生的架构

1. 反空转干预 (Anti-Idling Intervention)

这是碳核最核心的创新。传统模型在面对执行类请求时，常倾向于生成文本描述而非调用工具。

• 机制：碳核智能识别用户意图。对于执行型请求（如“查磁盘”、“重启服务”），直接在 API 层设置 tool_choice="required"，强制模型必须调用工具，从源头阻断纯文本回复。
• 兜底：若强制调用失败，自动回退一次并记录告警，同时保留后续的幻觉检测作为安全网。
• 效果：彻底杜绝模型“偷懒”，确保每个操作指令都被真实执行。

2. 多重防幻觉系统

• 输出验证：自动拦截模型编造的命令输出、虚假文件列表或伪造的搜索结果。若检测到模型试图用文字描述操作结果而非真实执行，立即报错并要求重试。
• URL 真实性查验：模型生成的链接必须经过真实性验证，防止虚构资源。
• Shell 安全护栏：
  • 白名单放行：允许 echo $(date) 等安全子命令。
  • 危险拦截：严格禁止 rm -rf、复合命令 $(cmd; cmd) 及嵌套执行，确保系统安全。

3. 双层记忆 + 本地搜索引擎

• 长期事实 (MEMORY.md)：存储用户偏好、项目信息等静态知识，始终加载到上下文。
• 事件日志 (HISTORY.md)：记录所有交互事件，支持跨会话追溯。
• 内置搜索引擎：基于 SQLite FTS5 实现 BM25 全文检索（零外部依赖），可选配语义向量搜索。Agent 可主动调用 knowledge_search 工具回忆历史，无需人工翻找。
• 自动整合：会话超过 50 条消息时，自动触发 LLM 分析并归档，保持上下文清爽。

4. Antigravity 网关兼容

• 免费用顶级模型：集成 Antigravity 网关，支持多 Google 账号轮换，让你能免费使用 Claude Opus/Gemini Pro 等顶级模型。
• 格式自适应：自动解析 Antigravity 的非标准工具参数格式，确保所有工具调用无缝工作。
• Prompt Caching：自动注入 Anthropic 缓存标记，大幅节省 Token 成本。

5. 强大的自动化能力

• Agent 模式定时任务：不仅是发提醒，更能定时执行完整工具链（如“每天早上 7 点查询天气并推送”、“每小时巡检服务器”）。
• 一次性定时 (at)：指定时间执行一次，完成后自动删除任务。
• 子代理 (Sub-Agent)：后台派遣长耗时任务，主进程无需持续等待，支持心跳保活，崩溃自动重启。

全平台接入

碳核支持极其广泛的通讯协议，无论你在哪里，都能随时召唤它：

• 即时通讯：Telegram (支持 reply-to)、飞书、钉钉、Slack、Discord (长消息自动分片)、WhatsApp、QQ。
• 邮件：支持 Email 收发。
• 统一管理：所有渠道消息汇聚至同一大脑，记忆共享，状态同步。

快速部署指南

只需几分钟，即可在你的服务器或本地电脑上拥有专属的碳核助手。

1. 克隆与安装

git clone https://github.com/deeeeeeeeap/nanobot-custom.git /opt/nanobot
cd /opt/nanobot

# 安装依赖
apt install pipx -y && pipx ensurepath && source ~/.bashrc
pipx install -e . --force
pip install croniter --break-system-packages  # 定时任务依赖
pip install sentence-transformers --break-system-packages  # 可选：语义搜索

2. 初始化与配置

nanobot onboard

编辑 ~/.nanobot/config.json，配置你的模型、渠道和工具密钥：

{
  "agents": {
    "defaults": {
      "model": "antigravity/claude-opus-4-6-thinking"
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "你的Telegram-Bot-Token",
      "allow_from": ["你的用户ID"]
    }
  },
  "providers": {
    "antigravity": {
      "api_key": "你的Antigravity-API-Key",
      "api_base": "http://127.0.0.1:8045/v1"
    }
  }
}

3. 部署 Antigravity 网关 (可选但推荐)

docker run -d --name antigravity-manager \
  -p 8045:8045 \
  -e API_KEY=你的API密钥 \
  -v ~/.antigravity_tools:/root/.antigravity_tools \
  lbjlaq/antigravity-manager:latest

4. 设置为系统服务 (Systemd)

cat > /etc/systemd/system/nanobot.service << 'EOF'
[Unit]
Description=Carbon-Core AI Assistant
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/opt/nanobot
ExecStart=/root/.local/bin/nanobot gateway
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target
EOF

systemctl daemon-reload && systemctl enable --now nanobot

日常运维与使用

• 查看日志：journalctl -u nanobot -f
• 热切换模型：在 Telegram 发送 /model gemini-3-pro 即可瞬间切换后端。
• 管理记忆：发送 /new 整合当前会话记忆并开启新对话；发送 /clear 清除缓存。
• 定时任务示例：
  • 用户：“每天早上 7 点给我推送北京天气预报。”
  • 碳核：cron(mode="agent", message="查询北京天气...", cron_expr="0 7 * * *") -> ✅ 已设定。