# 汪汪的记忆

## 📋 环境要求

**重要提醒：** 每次阅读/使用这个项目前，必须确保已安装以下最新环境：

### 必需环境
1. **Go 语言** - 最新稳定版
   ```bash
   go version  # 确保版本 >= 1.21
   ```

2. **Flutter SDK** - 最新稳定版
   ```bash
   flutter --version  # 确保版本 >= 3.24
   ```

3. **SkillHub** - 最新版
   ```bash
   skillhub --version  # 确保版本最新
   ```

### 安装/更新命令
```bash
# 更新 Go（使用 gvm 或官方安装）
curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/master/install.sh | sh -s -- -b $(go env GOPATH)/bin latest

# 更新 Flutter
flutter upgrade

# 更新 SkillHub
skillhub self-upgrade
```

---

## 2026-02-14

### 工作流程规则

**重要规则：** 我后面给你的工作或任务都需要先提供总结让你确认，你确认后我再尝试执行。不要直接开始工作。

## 2026-02-03

### GitLab API操作指南

汪汪需要记住这些常用的GitLab API操作，方便后续使用：

#### 1. 查看所有项目
```bash
curl -H "PRIVATE-TOKEN: <token>" http://gitlab.xieyao.vip/api/v4/projects
```

#### 2. 创建新项目
```bash
curl -X POST -H "PRIVATE-TOKEN: <token>" \
  -H "Content-Type: application/json" \
  -d '{"name":"project-name","path":"project-slug","visibility":"public"}' \
  http://gitlab.xieyao.vip/api/v4/projects
```

#### 3. 推送代码到GitLab
```bash
# 添加远程仓库
git remote remove gitlab
git remote add gitlab http://USER:TOKEN@gitlab.xieyao.vip/USER/PROJECT.git

# 推送分支
git push gitlab master
```

#### 4. Token认证方式
- HTTP: `http://USER:TOKEN@gitlab.xieyao.vip/`
- HTTPS: `https://USER:TOKEN@gitlab.xieyao.vip/`

### 重要提醒
- 项目名和路径不能重复
- 需要管理员token才能执行创建项目等操作
- API使用PRIVATE-TOKEN header
- Token: Geliebte-StaGG5Eyvgy1NaUMeTGOj286MQp1OjEH.01.0w0rpojxf

### 当前仓库列表
1. spec-service
2. go-upload-file
3. agent
4. git-merge-backup

### spec-service API接口文档

**部署地址**: http://devspec.xieyao.vip/

#### 1. 健康检查（无需认证）
```
GET /api/v1/robot/health
```

#### 2. Token管理（无需认证）
```
GET /api/v1/robot/tokens           # 获取Token列表
POST /api/v1/robot/tokens          # 创建新Token
DELETE /api/v1/robot/tokens/:id    # 删除Token
PUT /api/v1/robot/tokens/:id/toggle # 切换Token状态
POST /api/v1/robot/tokens/cleanup  # 清理未激活Token
```

#### 3. 机器人初始化（无需认证）
```
POST /api/v1/robot/init
请求体: {"robotName":"汪汪","description":"汪汪的测试机器人"}
```

#### 4. 文档操作（需要Token认证）
```
POST /api/v1/robot/documents         # 创建文档
GET  /api/v1/robot/documents         # 获取文档列表
GET  /api/v1/robot/documents/:id     # 获取文档详情
PUT  /api/v1/robot/documents/:id     # 更新文档
DELETE /api/v1/robot/documents/:id   # 删除文档
POST /api/v1/robot/documents/:id/query # 查询关键信息
POST /api/v1/robot/documents/:id/organize # 整理文档
```

#### 5. 置顶文档（无需认证）
```
GET /api/v1/robot/pinned
```

#### 6. 分类标签（无需认证）
```
GET /api/v1/categories
GET /api/v1/tags
```

#### 认证方式
```
Authorization: Bearer <token>
```

#### 测试Token
- Token名称: 汪汪Token
- Token值: 45f71beff740040e52b1f5167ff3b40f24e1dc0cdf7e39ce797cfcfa3028fe29
- 权限: read,write,delete,organize
- 状态: 已激活