SuperHarness - AI Agent 开发框架

概述

SuperHarness 是一个完整的 AI Agent 开发框架，使用 Rust + Python 构建，对标 Claude Code 和 LangChain。

• Python SDK: 简洁的 API 用于构建 AI 应用
• Rust CLI/TUI: 高性能终端交互界面
• 多 LLM 支持: Anthropic、OpenAI、Gemini、自定义端点
• 完整工具链: 文件操作、代码编辑、Shell 执行

六层架构

┌─────────────────────────────────────────────┐
│ Layer 5: Application Layer (CLI/TUI)        │  ← 用户交互
├─────────────────────────────────────────────┤
│ Layer 4: Agent Runtime                      │  ← 智能体运行时
├─────────────────────────────────────────────┤
│ Layer 3: Tool System                        │  ← 工具系统
├─────────────────────────────────────────────┤
│ Layer 2: Session & Memory                   │  ← 会话与记忆
├─────────────────────────────────────────────┤
│ Layer 1: Core Services                      │  ← 核心服务
├─────────────────────────────────────────────┤
│ Layer 0: Security Foundation                │  ← 安全基础
└─────────────────────────────────────────────┘

Python SDK

from superharness import Agent
 
# 创建 Agent
agent = Agent(
    api_key="your-api-key",
    provider="anthropic",  # 或 "openai", "gemini", "custom"
    model="claude-sonnet-4-6"
)
 
# 简单对话
response = agent.run("Hello, how are you?")
print(response)
 
# 流式输出
for chunk in agent.run_stream("Tell me a story"):
    print(chunk, end="", flush=True)
 
# 注册工具
@agent.tool
def calculate(expression: str) -> float:
    """Evaluate a mathematical expression."""
    return eval(expression)
 
# 使用工具
response = agent.run("What is 123 * 456?")

CLI / TUI

# 直接进入 TUI
superharness
 
# 查看帮助
superharness --help
 
# 查看版本
superharness --version

开发进度

Phase 0: SDK/TUI 基础功能 ✅ 完成

Phase 1: 产品级功能 ⏳ 进行中

设计哲学

核心原则

1. 无 MVP/Demo - 直接开发完整产品
2. 对标 Claude Code/LangChain - 持平或超越
3. 任务精确 - 明确完成标准和验收条件
4. 真实验证 - 真实用户使用流程验证

透明性三原则

• 无隐藏行为 - 所有操作可见
• 状态可视化 - 实时显示进度
• 决策可解释 - 解释工具选择和执行

当前状态

Phase 0 完成，192 个测试全部通过，Phase 1 进行中。