> ## Documentation Index
> Fetch the complete documentation index at: https://docs.memorose.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 基本操作

> Memorose 服务端 API 的最小流程 — 认证、写入、检索、图谱、语义变更。

# 基本操作

本指南展示当前服务端 API 的最小操作流程。

## 认证（Authentication）

```bash theme={null}
TOKEN=$(curl -s -X POST http://127.0.0.1:3000/v1/dashboard/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username":"admin","password":"admin"}' | jq -r '.token')
```

## 创建 Stream

```bash theme={null}
STREAM_ID=$(uuidgen | tr '[:upper:]' '[:lower:]')
```

## 写入文本

```bash theme={null}
curl -s -X POST "http://127.0.0.1:3000/v1/users/user_123/streams/$STREAM_ID/events" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "org_id": "default",
    "content": "User writes Rust code with async patterns",
    "content_type": "text"
  }'
```

## 检索（Retrieve）

```bash theme={null}
curl -s -X POST "http://127.0.0.1:3000/v1/users/user_123/streams/$STREAM_ID/retrieve" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "org_id": "default",
    "query": "What language and style does the user prefer?",
    "limit": 5,
    "graph_depth": 1
  }'
```

## 手动添加图谱边（Graph Edge）

```bash theme={null}
curl -s -X POST "http://127.0.0.1:3000/v1/users/user_123/graph/edges" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "source_id": "11111111-1111-1111-1111-111111111111",
    "target_id": "22222222-2222-2222-2222-222222222222",
    "relation": "Supports",
    "weight": 0.8
  }'
```

## 预览语义记忆变更（Semantic Memory Change）

当用户意图是"更新这条记忆"或"忘掉那个事实"而非硬删除时，使用此接口。

```bash theme={null}
curl -s -X POST "http://127.0.0.1:3000/v1/users/user_123/memories/semantic/preview" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "instruction": "I moved from Shanghai to Beijing and my email changed from old@example.com to new@example.com",
    "org_id": "default",
    "mode": "update",
    "forget_mode": "soft",
    "limit": 10
  }'
```

响应会返回一个计划以及受影响的记忆候选项。请在审核后再执行。

## 执行已审核的语义计划

```bash theme={null}
curl -s -X POST "http://127.0.0.1:3000/v1/users/user_123/memories/semantic/execute" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "plan_id": "<plan-id>",
    "org_id": "default",
    "confirm": true
  }'
```

## 硬删除记忆单元（Memory Unit）

仅在需要直接且不可逆地删除单个记忆单元时使用硬删除。

```bash theme={null}
curl -s -X DELETE "http://127.0.0.1:3000/v1/users/user_123/memories/<memory-id>" \
  -H "Authorization: Bearer $TOKEN"
```

## 查看待处理任务

```bash theme={null}
curl -s http://127.0.0.1:3000/v1/status/pending \
  -H "Authorization: Bearer $TOKEN"
```

## 使用仪表盘（Dashboard）

* UI 地址：`http://127.0.0.1:3100/dashboard`
* API 重定向：`http://127.0.0.1:3000/dashboard`

仪表盘可用于记忆检查、图谱探索、组织知识管理和集群健康监控。