143 lines
3.4 KiB
Markdown
143 lines
3.4 KiB
Markdown
# 汪汪的记忆
|
||
|
||
## 📋 环境要求
|
||
|
||
**重要提醒：** 每次阅读/使用这个项目前，必须确保已安装以下最新环境：
|
||
|
||
### 必需环境
|
||
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
|
||
- 状态: 已激活 |