chore: initialize qiming workspace repository

This commit is contained in:
Codex
2026-05-29 14:22:48 +08:00
commit bfd67a0f2c
10750 changed files with 1885711 additions and 0 deletions

View File

@@ -0,0 +1,125 @@
# app-platform-memory
## 模块概述
app-platform-memory 是一个记忆管理模块,为 AI Agent 提供短期、长期和工作记忆的管理能力。
## 功能特性
- **多类型记忆支持**
- 短期记忆 (short_term): 用于临时存储对话上下文
- 长期记忆 (long_term): 持久化存储重要信息
- 工作记忆 (working): 当前任务相关的活跃记忆
- **记忆管理功能**
- 创建、更新、删除记忆
- 记忆搜索和检索
- 自动归档过期记忆
- 重要性评分机制
- 访问频率统计
- **API 支持**
- RESTful API 接口
- Web 管理界面
- SDK 集成
## 子模块说明
- `app-platform-memory-spec`: 规范定义和常量
- `app-platform-memory-sdk`: SDK 和 DTO 定义
- `app-platform-memory-domain`: 领域模型和仓储接口
- `app-platform-memory-application`: 应用服务层
- `app-platform-memory-infra`: 基础设施实现
- `app-platform-memory-api`: RESTful API 接口
- `app-platform-memory-web`: Web 管理界面
## 使用方式
### 添加依赖
在需要使用记忆功能的模块中添加依赖:
```xml
<dependency>
<groupId>com.xspaceagi</groupId>
<artifactId>app-platform-memory-sdk</artifactId>
<version>1.0.0-SNAPSHOT</version>
</dependency>
```
### API 调用示例
#### 创建记忆
```bash
POST /api/memory
Content-Type: application/json
{
"memoryType": "short_term",
"content": "用户偏好设置",
"metadata": {
"userId": "user123",
"sessionId": "session456"
}
}
```
#### 查询记忆
```bash
GET /api/memory/user/{userId}/type/{memoryType}
```
#### 搜索记忆
```bash
GET /api/memory/search?userId={userId}&keyword={keyword}
```
## 配置说明
### 默认配置
- 短期记忆最大容量: 100 条
- 工作记忆最大容量: 50 条
- 长期记忆转换阈值: 7 天
### 自定义配置
可以在配置文件中覆盖默认值:
```yaml
memory:
short-term:
max-size: 200
working:
max-size: 100
long-term:
threshold-days: 14
```
## 技术栈
- Java 17
- Spring Boot
- Lombok
- Maven
## 开发指南
### 构建项目
```bash
mvn clean install
```
### 运行测试
```bash
mvn test
```
## 版本历史
- v1.0.0-SNAPSHOT: 初始版本,提供基础记忆管理功能