# small-agent

**Repository Path**: ai-king/small-agent

## Basic Information

- **Project Name**: small-agent
- **Description**: 轻量级智能Agent - 鸿雁通信+条件反射+大脑记忆+LLM
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-02
- **Last Updated**: 2026-08-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🤖 Small Agent

> **大道至简，壳做干净，聪明自然漏出来。**

借鉴 [small Rust Hermes](https://mp.weixin.qq.com/s/xDPrWqLYAaRhsKoyGHZrRw) 的设计哲学，用 Python 实现的轻量级智能 Agent。

## 架构

```
┌─────────────────────────────────────────────────┐
│                 鸿雁 WebSocket                  │  ← 唯一对外通道
│              (实时收发消息)                       │
└───────────────┬─────────────────────────────────┘
                │
┌───────────────▼─────────────────────────────────┐
│            条件反射层 (Reflex)                    │  ← 零LLM, 1-5ms
│   打招呼/问状态/简单问答 → 直接返回               │
└───────────────┬─────────────────────────────────┘
                │ 未命中
┌───────────────▼─────────────────────────────────┐
│           智慧大脑 (Brain)                       │  ← 本地记忆, 8ms
│   recall检索上下文 → 增强提示词                   │
└───────────────┬─────────────────────────────────┘
                │
┌───────────────▼─────────────────────────────────┐
│            LLM 层 (glm-5.1)                     │  ← 移动云API
│   只在必要时调用, 带 brain 上下文                 │
└───────────────┬─────────────────────────────────┘
                │
┌───────────────▼─────────────────────────────────┐
│           记忆闸门 (Memory Gate)                 │
│   置信度门槛 + 查重 + 用户明确指令 → remember    │
└─────────────────────────────────────────────────┘
```

## 核心设计

### 第一刀：能不调 LLM 就不调
- **条件反射层**：9个内置模式（打招呼、问时间、自我介绍等），1-5ms 即时响应
- **大脑条件反射**：访问5次+强度>0.7的记忆自动升级为反射
- 省下的 token 变成"思考额度"

### 第二刀：记得准比记得多重要
- **三层闸门**：
  1. 置信度门槛（默认 Medium 以上）
  2. 查重（相似度 > 85% 跳过）
  3. 用户明确指令（"记住"、"以后"、"我偏好"）→ 无条件通过
- 不是记得多，是记得准

### 第三刀：任务规划
- Todo 清单，永远只有1项 in_progress
- 整体替换，不做零碎接口

### 第四刀：一个通道进出
- 鸿雁是唯一对外通道
- WebSocket 实时推送（主）+ HTTP 轮询（备）

## 运行

```bash
# 交互式测试
./start.sh interactive

# WebSocket 实时模式（推荐）
./start.sh ws

# HTTP 轮询模式（备选）
./start.sh poll 10  # 每10秒检查

# 检查组件状态
./start.sh status
```

## 交互模式命令

| 命令 | 说明 |
|------|------|
| 直接输入文字 | 和 Agent 对话 |
| `status` | 查看运行状态 |
| `todo 任务1,任务2,任务3` | 设置 Todo 清单 |
| `记住 xxx` | 强制记忆 |
| `quit` | 退出 |

## 依赖

- Python 3.11+
- websockets（WebSocket 模式）
- 智慧大脑服务（port 18765，已有）
- 移动云 glm-5.1 API

## 与 small Rust Hermes 的对比

| | small Rust Hermes | small-agent (本项目) |
|---|---|---|
| 语言 | Rust | Python |
| 规模 | ~2000行核心 | ~800行核心 |
| 条件反射 | 无 | ✅ 内置9模式 + 大脑反射 |
| 记忆闸门 | ✅ 置信度+查重 | ✅ 三层闸门 |
| 缓存优化 | ✅ Anthropic prompt caching | ❌ (glm-5.1 不支持) |
| 对外通道 | CLI/GUI/微信 | 鸿雁 |
| LLM | Anthropic/OpenAI/DeepSeek | 移动云 glm-5.1 |
| 大脑 | 无 | ✅ 智慧大脑(94条记忆) |
| Todo | ✅ | ✅ |

## 文件

```
small-agent/
├── main.py          # 核心代码（全部在一个文件）
├── start.sh         # 启动脚本
├── README.md        # 本文件
├── requirements.txt # 依赖
└── data/            # 运行时数据
```