Supreme Agent — 最强命令行 AI 助手

永久长期记忆 · 多 Agent 协调 · 多模型支持 · MCP 协议 · 可扩展工具系统

目标：超越 codex 和 claude code 的开源命令行 Agent。

---

项目状态

项	值
版本	0.1.0
语言	Rust 2021 edition
代码规模	41 个源文件，6517 行 Rust 代码
二进制	supreme.exe 9.32 MB（release，LTO + strip）
编译时间	~53s（release，增量）
测试	5 个单元测试（diff 解析），全部通过
依赖数	22 个 crate

已实现核心能力

• ✅ 多 LLM Provider：OpenAI / DeepSeek / Anthropic Claude / Google Gemini / Ollama 本地模型
• ✅ 原生 Function Calling：OpenAI tools / Anthropic tool_use / Gemini functionDeclarations / Ollama tools
• ✅ 流式输出：tokio mpsc channel，含工具调用时的缓冲策略（避免思考文本重复显示）
• ✅ 永久长期记忆：SQLite + 向量嵌入（nomic-embed-text / text-embedding-3-small），永不删减
• ✅ 记忆自动固化：Consolidator 从对话提炼事实/偏好/决策写入长期记忆
• ✅ 会话持久化：对话历史存 SQLite，/resume /sessions 恢复历史
• ✅ 多 Agent 协调：Coordinator + Specialist，tokio::spawn 真并行 + 依赖拓扑排序
• ✅ MCP 协议客户端：stdio JSON-RPC 2.0，加载外部 MCP server 工具
• ✅ 文件 Diff 编辑：SEARCH/REPLACE 块精准编辑（类 Aider）
• ✅ 命令沙箱审批：危险命令（rm -rf / format / git push --force / curl|sh）执行前 y/N 确认
• ✅ Git 深度集成：status/diff/log/add/commit/commit_all/show/branch + /commit auto（AI 生成 message）
• ✅ TUI 增强：工具调用编号 + 计时 + 思考行数提示
• ✅ 跨平台：Windows / Linux / macOS（PowerShell + sh 双执行路径）

---

快速开始

1. 安装 Rust

# Windows
winget install Rustlang.Rustup
# Linux/macOS
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

2. 编译

cd 小失业99-最强agent
cargo build --release
# 产物: target/release/supreme(.exe)

3. 配置

首次运行 supreme init 生成默认配置，或手动创建 ~/.supreme-agent/config.toml：

default_provider = "ollama"

[providers.ollama]
kind = "ollama"
api_base = "http://localhost:11434"
model = "qwen3-coder:30b"
embedding_model = "nomic-embed-text"
max_tokens = 4096
temperature = 0.7

[providers.deepseek]
kind = "openai"
api_base = "https://api.deepseek.com/v1"
api_key = ""            # 或设置环境变量 DEEPSEEK_API_KEY
model = "deepseek-chat"
embedding_model = "text-embedding-3-small"
max_tokens = 4096
temperature = 0.7

[memory]
enabled = true
top_k = 5
similarity_threshold = 0.35
auto_consolidate = true

[agent]
multi_agent_enabled = true
max_iterations = 10

[cli]
streaming = true
command_approval = true

[git]
auto_stage_after_edit = false
auto_commit = false

# MCP 服务器 (可选)
# [mcp.filesystem]
# command = "npx"
# args = ["-y", "@modelcontextprotocol/server-filesystem", "/path"]

4. 运行

# 交互 REPL
supreme

# 单次问答
supreme "用一句话说明 Rust 的所有权机制"

# 指定 provider/model
supreme -p deepseek -m deepseek-reasoner "写一个快排"

# 禁用记忆/多 Agent/流式
supreme --no-memory --no-agents --no-stream "hello"

# 恢复历史会话
supreme --resume <session-id>

5. 本地 Ollama 测试（已验证）

# 启动 ollama 并拉取模型
ollama pull qwen3-coder:30b
ollama pull nomic-embed-text

# supreme 配置 default_provider = "ollama" 后
supreme "用一句话说明 Rust 的所有权机制"
# 输出: 🤖 Rust 的所有权机制是一种编译时内存管理策略...

---

命令一览

CLI 子命令

命令	说明
supreme init	初始化配置文件
supreme providers	列出已配置 provider
supreme remember <kind> <content>	直接存入记忆
supreme memory stats	记忆统计
supreme memory recall <query>	检索记忆
supreme sessions	列出持久化会话
supreme sessions delete <id>	删除会话

REPL 斜杠命令

命令	说明
/help	帮助
/provider [name]	查看/切换 provider
/model [name]	查看/切换模型
/tools	列出可用工具
/commit [message|auto]	自动暂存并提交（auto=AI 生成 message）
/agents <task>	强制多 Agent 协作
/sessions /resume <id>	会话管理
/save /title <t> /forget-session	会话操作
/memory /recall <q> /remember <k> <c>	记忆操作
/config /clear /exit	其他

---

工具系统

Agent 可调用以下内置工具（通过 function calling）：

工具	说明
read_file	读文件（支持 offset/limit）
write_file	写文件
edit_file	全文替换式编辑
edit_file_diff	SEARCH/REPLACE 块精准编辑
list_dir	列目录
run_command	执行 shell 命令（危险命令需审批）
web_search	网络搜索
git_status git_diff git_log	Git 查询
git_add git_commit git_commit_all	Git 提交
git_show git_branch	Git 详情
recall_memory remember list_memory	记忆操作
mcp_{server}_{tool}	MCP 外部工具（动态加载）

---

架构概览

┌─────────────────────────────────────────────────────┐
│                     CLI (clap)                       │
│   supreme init / providers / sessions / remember     │
├─────────────────────────────────────────────────────┤
│                    REPL / run_once                   │
│   斜杠命令 · 事件渲染 · 工具计时 · 思考折叠           │
├─────────────────────────────────────────────────────┤
│                      Agent (ReAct)                   │
│   推理-行动循环 · 流式 · auto_stage hook             │
├──────────┬──────────┬───────────┬───────────────────┤
│   LLM    │  Tools   │  Memory   │   Multi-Agent     │
│ Client   │ Registry │  Store    │   Coordinator     │
│ ┌──────┐ │ ┌──────┐ │ ┌──────┐ │   ┌──────┐        │
│ │OpenAI│ │ │fs    │ │ │SQLite│ │   │Planner│        │
│ │Ollama│ │ │exec  │ │ │+向量 │ │   │Specialist│     │
│ │Claude│ │ │git   │ │ │嵌入  │ │   │(并行) │        │
│ │Gemini│ │ │memory│ │ └──────┘ │   └──────┘        │
│ └──────┘ │ │search│ │          │                    │
│          │ │mcp_* │ │          │                    │
│          │ └──────┘ │          │                    │
├──────────┴──────────┴───────────┴───────────────────┤
│              MCP Client (stdio JSON-RPC)             │
│   连接外部 MCP server · 工具发现 · 工具调用           │
└─────────────────────────────────────────────────────┘

详细架构见 ARCHITECTURE.md。

---

记忆策略

永不删减：所有记忆和会话消息只有 INSERT，无任何 DELETE/清理逻辑（除非用户主动 /forget-session 或 supreme sessions delete）。

• 长期记忆：memories 表，含向量嵌入，语义检索
• 会话消息：session_messages 表，按 session_id + seq 持久化
• 自动固化：对话达阈值后，Consolidator 调 LLM 提炼事实写入长期记忆

---

跨平台

• Windows：run_command 走 PowerShell；MCP 子进程隐藏控制台窗口
• Linux/macOS：run_command 走 sh -c
• 配置目录：~/.supreme-agent/（Windows: %USERPROFILE%\.supreme-agent\）

Tailscale 远程调用 Ollama

# PC 端 (ollama 主机) 暴露服务
# 设置 OLLAMA_HOST=0.0.0.0:11434 后重启 ollama

# 远端机器配置 supreme
[providers.ollama]
api_base = "http://<pc-tailscale-ip>:11434"

直接调用 DeepSeek API

[providers.deepseek]
kind = "openai"
api_base = "https://api.deepseek.com/v1"
api_key = "sk-..."           # 或环境变量 DEEPSEEK_API_KEY
model = "deepseek-chat"

supreme -p deepseek "你好"

---

开发

cargo build              # debug
cargo build --release    # release (LTO)
cargo test --bin supreme # 测试
cargo test --bin supreme fs_tool  # 单模块测试

License

MIT