🦾 碳核 (Carbon-Core)

基于 nanobot 的超轻量级个人 AI 助手 — 不空谈，只行动

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

✨ 特性一览

🧠 智能核心 🤖 多模型热切换 — Claude / Gemini / GPT / DeepSeek / MiniMax / Kimi 🌐 Antigravity 网关 — 多 Google 账号轮换，免费用 Claude & Gemini 🧬 思维链支持 — DeepSeek-R1、Claude Thinking 推理过程可视化 🔄 交错思维链 — 工具执行后自动反思，提升多步推理质量 ⚡ 反空转干预 — 执行型请求 tool_choice=required 源头阻断空转，模型必须调工具 💰 Prompt Caching — Anthropic/Claude 自动注入缓存标记，节省 token 成本	🛡️ 安全可靠 🛡️ 防幻觉机制 — 自动拦截编造的命令输出、虚假搜索结果 🔒 命令安全护栏 — 智能拦截危险操作 + $() 受控放行（白名单子命令） 🔗 URL 真实性验证 — 模型给出的链接也要查验 📊 实时状态反馈 — 🤔→🔧→✅ 执行进度一目了然 🧠 双层记忆 — 长期事实 + 事件日志，跨会话永久记忆 🔎 知识搜索 — BM25 全文检索 + 可选语义向量搜索
⏰ 自动化 ⏰ 提醒模式 — 定时发送静态提醒 🤖 Agent 模式 — 定时执行完整工具链任务（天气预报、系统巡检） 🎯 一次性定时 at — 指定时间执行一次，完成自动删除 🚀 子代理 — 后台派遣长任务，无需持续盯着 💓 心跳保活 — 7×24 在线，崩溃自动重启	📱 全平台接入 Telegram ✅ (reply-to 引用) | 飞书 ✅ | 钉钉 ✅ | Slack ✅ Email ✅ | QQ ✅ | Discord ✅ (长消息自动分片) | WhatsApp ✅

🚀 快速部署

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

3. 配置 ~/.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"
    }
  },
  "tools": {
    "web": {
      "search": {
        "api_key": "你的Brave-Search-API-Key"
      }
    }
  }
}

4. 部署 Antigravity 网关（可选）

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

5. 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

# 只看 cron 定时任务日志
journalctl -u nanobot --no-pager | grep -i cron

# 快速更新
cd /opt/nanobot && git pull && systemctl restart nanobot

📱 Telegram 命令

命令	说明
/model	查看当前模型 & 可用 providers
/model <模型名>	热切换模型
/status	系统状态
/new	整合记忆后开始新对话
/help	显示可用命令
/clear	清除会话历史（磁盘 + 内存缓存）

🤖 碳核定制功能

以下功能为本 fork 独有，上游 nanobot 不包含：

防幻觉系统

用户: 帮我查磁盘使用情况
模型: (编造了一段 du -sh 输出)
碳核: ⚠️ 检测到异常 — 我刚才试图用文字描述操作结果...请重新发送请求

• 检测模型编造的命令输出、虚假路径列表、伪造搜索结果
• 即使模型支持工具但选择不用，也会触发检测
• URL 真实性验证，拦截虚构链接

反空转干预（v3 — tool_choice 源头阻断）

执行型请求 → tool_choice="required" → API 层强制模型必须调工具
问答型请求 → tool_choice="auto"      → 正常对话不干预
已有工具调用 → tool_choice="auto"      → 后续自由总结
required 失败 → 自动回退 auto 一次    → 记录 [E_TOOL_CHOICE_FALLBACK] 告警

• 自动判断执行型 vs 问答型请求（默认执行型，排除明显问答）
• tool_choice=required：从 API 层阻断纯文本回复，模型无法绕过
• 分阶段启用：当前对 Gemini / Codex 系列生效，其他模型保持 auto
• 最小兜底：required 回退后仍检测 lazy/hallucination 作为安全网
• 可通过 idle_intervention: false 关闭

Shell $() 受控放行

✅ echo $(date)              — 白名单放行
✅ echo $(cat notes.txt)     — 放行（再受 workspace 约束）
❌ echo $(rm -rf /)          — 拦截
❌ echo $(date; whoami)      — 复合命令拦截
❌ echo $(echo $(date))      — 嵌套拦截

定时任务 Agent 模式

例如：
用户: 每天早上7点给我推送xxx天气预报
碳核: cron(mode="agent", message="查询xxx天气...", cron_expr="0 7 * * *", timezone="Asia/Shanghai")

• 提醒模式：发送静态文本
• Agent 模式：定时触发完整 Agent 处理（可调用所有工具）
• 一次性定时 at：cron(at="2026-02-14T10:30:00")，到时执行，完成自动删除
• 120 秒超时 + 错误兜底通知 + session 隔离

实时状态反馈

🤔 碳核正在思考...
🔧 💻 正在执行命令: df -h
✅ 命令执行完成
[最终回复]

Antigravity 网关兼容

自动解析 Antigravity 的 {"raw": "..."} 工具参数格式为标准格式，确保所有工具调用正常工作。

双层记忆 + 知识搜索

MEMORY.md    — 长期事实，始终加载到上下文（用户偏好、项目信息、习惯）
HISTORY.md   — 事件日志，通过 grep 按关键词搜索历史
index.sqlite — 本地 FTS5 全文索引，BM25 关键词检索

• 会话超过 50 条消息时自动整合（LLM 分析对话 → 提取事实 → 归档事件）
• /new 命令主动触发整合后清空会话
• 跨会话持久记忆，重启不丢失
• 🔎 内置搜索引擎（Python 原生 SQLite FTS5，零外部依赖）
  • 启动时自动索引记忆文件，写入/修改后增量更新
  • Agent 调用 knowledge_search 工具搜索历史知识
  • 默认 BM25 关键词模式，可通过 nanobot search embed 激活语义向量搜索

CLI 搜索命令

nanobot search status          # 查看索引状态
nanobot search query "关键词"   # CLI 搜索测试
nanobot search reindex          # 手动重建索引
nanobot search embed            # 激活语义搜索（需安装 sentence-transformers）

推特智能监控

• 📋 Web 管理面板 — 关注名单管理、凭证配置、摘要查看
• 🕷️ 自动抓取 — 系统 cron 定时抓取关注用户推文
• 🤖 AI 总结推送 — Agent 定时读取摘要、智能总结、推送到 Telegram
• 🔍 关键词搜索 — 主题搜索 AI/科技领域热点

📦 支持的模型

Provider	模型	Function Calling
Antigravity	antigravity/claude-opus-4-6-thinking	✅
Antigravity	antigravity/gemini-3-flash-preview	✅
Antigravity	antigravity/gemini-3-pro	✅
OpenAI	openai/gpt-5.3-codex	✅ (via codex_bridge)
MiniMax	minimax/MiniMax-M2.1	✅
Gemini	gemini-2.5-flash-preview	✅
Claude	anthropic/claude-sonnet-4-5	✅
DeepSeek	deepseek/deepseek-chat	✅
Kimi	moonshot/kimi-k2.5	✅

🙏 致谢

本项目 fork 自 HKUDS/nanobot v0.1.4.post1，在其基础上进行了大量定制开发。

---

🦾 碳核 — 不空谈，只行动