README.md

# Project Aura 🌫️

**微光：有呼吸感的AI主动性**

Give AI the grace of knowing when to listen, and when to whisper.

---

## 是什么

Project Aura 是一套**AI主动交互调度系统**，它解决的核心问题是：

> 如何让AI在「该说话的时候说话」，而不是「随时都在说话」或「永远不说话」？

它不是一个聊天机器人，而是聊天机器人背后的**决策层**——决定什么时候该主动开口、说什么、以及如何优雅地表达。

## 核心架构

```
用户状态变化 / 定时心跳
       ↓
┌──────────────┐
│  心跳调度器   │ ← 自适应泊松过程（空闲越久越频繁）
├──────────────┤
│  双系统调度器 │ ← 快系统(规则) + 慢系统(LLM)
├──────────────┤
│  价值网络    │ ← V = α·urgency + β·relevance - δ·interruption
├──────────────┤
│  反骚扰漏斗  │ ← 频率/话题/场景/反馈 四级过滤
├──────────────┤
│  DeepSeek R1 │ ← 内容生成 + 慢系统评估
├──────────────┤
│  表达层      │ ← 呼吸光效 → 标题 → 完整消息
└──────────────┘
```

## 快速开始

```bash
# 1. 安装依赖
pip install -r requirements.txt

# 2. 演示模式（无需GPU，使用规则引擎Fallback）
python examples/r1_integration.py --dry-run

# 3. 完整模式（接入 DeepSeek R1）
python examples/r1_integration.py \
  --model ljsysfurry/DeepSeek-R1-Distill-Qwen-7B \
  --lora ljsysfurry/deepseek-r1-7b-xiaoshan-lora
```

## 模块说明

| 模块 | 文件 | 功能 |
|------|------|------|
| 调度引擎 | `aura/scheduler.py` | 自适应心跳 + 双系统调度 |
| 感知层 | `aura/perception.py` | 用户状态监测 |
| 价值网络 | `aura/decision.py` | 量化评估 + 反骚扰 |
| 记忆系统 | `aura/memory.py` | 异构图记忆 + 遗忘曲线 |
| 内容生成 | `aura/generation.py` | 对接 DeepSeek R1 |
| 表达层 | `aura/interaction.py` | 三级渐进式通知 |
| 控制面板 | `aura/control.py` | 主动性温度计 + 场景模式 |
| 伦理护盾 | `aura/ethics.py` | 隐私信号灯 + 红队测试 |
| 主引擎 | `aura/engine.py` | 全模块整合 |

## 防御性公开

本项目是**防御性公开（Defensive Publication）**。详见 `PATENT_DEFENSE.md`。

## 许可证

本项目所有内容放弃专利权，进入公共领域。