# 智能体_历史消息不忘记

**Repository Path**: C-J-R/remembers-every-conversation

## Basic Information

- **Project Name**: 智能体_历史消息不忘记
- **Description**: 面向 AI 智能体的历史消息持久化方案。解决 Agent 在多轮对话中上下文丢失、历史信息遗忘的问题，支持对话记录的存储、检索与注入，让智能体真正具备长期记忆能力
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: V1.0.0
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 43
- **Created**: 2026-07-06
- **Last Updated**: 2026-07-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI History Skill ?

![Version](https://img.shields.io/badge/version-1.0.0-blue)
![License](https://img.shields.io/badge/license-MIT-yellow)
![Python](https://img.shields.io/badge/python-3.10+-blue)

> 嘿！这是我写的 AI 对话历史记录管理 Skill。
> 像个超级记忆库，帮你记住所有和 AI 的聊天，想要的时候随时翻出来！

## 快速上手

```bash
git clone https://github.com/yourusername/ai-history-skill.git
cd ai-history-skill/V1.0.0
pip install -e ".[dev]"
make test
```

## 怎么玩？

```python
from src.core.engine import SkillEngine

engine = SkillEngine(config="configs/default.yaml")

# 存一条对话
engine.run("ai_history", {
    "action": "store",
    "session_id": "chat-001",
    "role": "user",
    "content": "帮我想一个 Python 项目创意",
    "topic": "头脑风暴",
    "tags": ["python", "idea"]
})

# 搜索历史
result = engine.run("ai_history", {
    "action": "search", "keyword": "Python"
})
print(f"找到 {result['data']['total']} 条记录")  # 输出: 找到 1 条记录

# 看看统计
result = engine.run("ai_history", {"action": "stats"})
print(f"共 {result['data']['total_records']} 条对话, {result['data']['total_sessions']} 个会话")
```

## 支持的操作

| 操作 | 说明 |
|------|------|
| `store` | 存储一条对话记录 |
| `search` | 按关键词/日期/角色/标签搜索 |
| `recent` | 获取最近 N 条对话 |
| `summarize` | 为指定会话生成摘要 |
| `stats` | 查看统计概览 |
| `sessions` | 列出所有会话 |
| `export` | 导出为 JSON/TXT/Markdown |
| `clear` | 清空历史或指定会话 |

## 项目结构

```
ai-history-skill/
├── src/
│   ├── core/                # 引擎核心
│   │   ├── engine.py        # Skill 调度引擎
│   │   ├── config.py        # 配置加载
│   │   └── exceptions.py    # 自定义异常
│   ├── skills/              # Skill 实现
│   │   ├── base_skill.py    # Skill 基类
│   │   └── ai_history_skill.py  # 历史记录 Skill
│   └── utils/
│       └── logger.py        # 日志工具
├── tests/                   # 测试
├── configs/                 # 配置
├── examples/                # 示例
├── data/                    # 历史数据存储
└── pyproject.toml
```

## 常用命令

```bash
make install    # 安装
make dev        # 安装开发依赖
make test       # 跑测试
make lint       # 代码检查
make clean      # 清理
make all        # 一条龙
```

## License

MIT - 随便用 ?