# nnet 多仓库发布指南

## 一、Git多远程仓库配置

### 1.1 添加多个远程仓库

```bash
# 查看当前远程仓库
git remote -v

# 添加GitHub远程仓库（通常命名为origin）
git remote add origin https://github.com/noahlann/nnet.git

# 添加Gitee远程仓库
git remote add gitee https://gitee.com/noahlann/nnet.git

# 添加私有库远程仓库
git remote add private https://your-private-git.com/noahlann/nnet.git

# 或者使用SSH方式
git remote add origin git@github.com:noahlann/nnet.git
git remote add gitee git@gitee.com:noahlann/nnet.git
git remote add private git@your-private-git.com:noahlann/nnet.git
```

### 1.2 查看所有远程仓库

```bash
git remote -v
```

输出示例：
```
origin   https://github.com/noahlann/nnet.git (fetch)
origin   https://github.com/noahlann/nnet.git (push)
gitee    https://gitee.com/noahlann/nnet.git (fetch)
gitee    https://gitee.com/noahlann/nnet.git (push)
private  https://your-private-git.com/noahlann/nnet.git (fetch)
private  https://your-private-git.com/noahlann/nnet.git (push)
```

### 1.3 修改远程仓库URL

如果需要修改已存在的远程仓库URL：

```bash
# 修改origin的URL
git remote set-url origin https://github.com/noahlann/nnet.git

# 修改gitee的URL
git remote set-url gitee https://gitee.com/noahlann/nnet.git
```

## 二、同时推送到多个仓库

### 2.1 方法1：使用多个push命令（推荐）

```bash
# 推送到GitHub
git push origin main

# 推送到Gitee
git push gitee main

# 推送到私有库
git push private main
```

### 2.2 方法2：配置push URL（一次push到多个仓库）

```bash
# 为origin添加多个push URL
git remote set-url --add --push origin https://github.com/noahlann/nnet.git
git remote set-url --add --push origin https://gitee.com/noahlann/nnet.git
git remote set-url --add --push origin https://your-private-git.com/noahlann/nnet.git

# 现在只需要一个push命令
git push origin main
```

**注意**：这种方法会同时推送到所有配置的URL，但fetch时只会从第一个URL获取。

### 2.3 方法3：使用Git别名（推荐用于日常开发）

创建便捷的别名：

```bash
# 创建推送所有仓库的别名
git config alias.pushall '!git push origin main && git push gitee main && git push private main'

# 使用别名
git pushall
```

或者添加到 `.git/config` 文件：

```ini
[alias]
    pushall = !git push origin main && git push gitee main && git push private main
```

### 2.4 方法4：使用脚本（最灵活）

创建 `scripts/push-all.sh`：

```bash
#!/bin/bash

# 推送所有远程仓库
echo "Pushing to GitHub..."
git push origin main || echo "Failed to push to GitHub"

echo "Pushing to Gitee..."
git push gitee main || echo "Failed to push to Gitee"

echo "Pushing to Private..."
git push private main || echo "Failed to push to Private"

echo "Done!"
```

使用：

```bash
chmod +x scripts/push-all.sh
./scripts/push-all.sh
```

## 三、Go模块路径配置

### 3.1 问题：Go模块路径的选择

Go的 `go.mod` 中只能有一个 `module` 路径，但不同仓库可能有不同的URL。

### 3.2 解决方案

#### 方案1：使用GitHub作为主路径（推荐，当前采用）

```go
// go.mod
module github.com/noahlann/nnet

go 1.25
```

**优点**：
- GitHub是Go生态中最常用的
- 大多数Go工具默认支持GitHub
- 社区熟悉
- 无需额外配置

**缺点**：
- 如果GitHub不可访问，会有问题

**当前配置**：
- 模块路径：`github.com/noahlann/nnet`
- 无需域名配置

#### 方案2：使用Gitee作为主路径（国内用户）

```go
// go.mod
module gitee.com/yourusername/nnet

go 1.25
```

**优点**：
- 国内访问速度快
- 适合国内开发者

**缺点**：
- 国际开发者可能不熟悉

#### 方案3：使用自定义域名

```go
// go.mod
module go.noahlan.cn/nnet

go 1.25
```

**优点**：
- 不依赖特定平台
- 可以随时切换仓库
- 更专业
- 更好的控制权

**缺点**：
- 需要配置域名和重定向

### 3.3 配置Go代理和私有仓库

#### 配置GOPROXY（支持多个源）

```bash
# 设置Go代理（按优先级）
go env -w GOPROXY=https://goproxy.cn,direct

# 或者使用多个代理
go env -w GOPROXY=https://goproxy.cn,https://goproxy.io,direct
```

#### 配置GOPRIVATE（私有仓库）

```bash
# 设置私有仓库（不走代理）
go env -w GOPRIVATE=your-private-git.com/*,gitee.com/yourusername/*
```

#### 配置GOSUMDB（校验和数据库）

```bash
# 对于私有仓库，禁用校验和检查
go env -w GOSUMDB=off

# 或者只对特定域名禁用
go env -w GOSUMDB="sum.golang.org+your-private-git.com"
```

## 四、完整配置示例

### 4.1 项目结构

```
nnet/
├── .git/
├── .gitignore
├── go.mod
├── go.sum
├── scripts/
│   └── push-all.sh
└── README.md
```

### 4.2 Git配置（.git/config）

```ini
[remote "origin"]
    url = https://github.com/noahlann/nnet.git
    fetch = +refs/heads/*:refs/remotes/origin/*

[remote "gitee"]
    url = https://gitee.com/noahlann/nnet.git
    fetch = +refs/heads/*:refs/remotes/gitee/*

[remote "private"]
    url = https://your-private-git.com/noahlann/nnet.git
    fetch = +refs/heads/*:refs/remotes/private/*

[alias]
    pushall = !git push origin main && git push gitee main && git push private main
```

### 4.3 go.mod配置

```go
module github.com/noahlann/nnet

go 1.25

require (
    github.com/panjf2000/gnet/v2 v2.9.5
)
```

**注意**：使用 GitHub 作为模块路径，无需额外配置。

### 4.4 推送脚本（scripts/push-all.sh）

```bash
#!/bin/bash

set -e

echo "🚀 Pushing to all repositories..."

# 检查是否有未提交的更改
if ! git diff-index --quiet HEAD --; then
    echo "⚠️  Warning: You have uncommitted changes"
    read -p "Continue anyway? (y/n) " -n 1 -r
    echo
    if [[ ! $REPLY =~ ^[Yy]$ ]]; then
        exit 1
    fi
fi

# 获取当前分支
BRANCH=$(git branch --show-current)

echo "📦 Current branch: $BRANCH"
echo ""

# 推送到GitHub
echo "📤 Pushing to GitHub (origin)..."
if git push origin "$BRANCH"; then
    echo "✅ GitHub: Success"
else
    echo "❌ GitHub: Failed"
    exit 1
fi

# 推送到Gitee
echo "📤 Pushing to Gitee..."
if git push gitee "$BRANCH"; then
    echo "✅ Gitee: Success"
else
    echo "❌ Gitee: Failed"
    exit 1
fi

# 推送到私有库
echo "📤 Pushing to Private..."
if git push private "$BRANCH"; then
    echo "✅ Private: Success"
else
    echo "❌ Private: Failed"
    exit 1
fi

echo ""
echo "🎉 All repositories updated successfully!"
```

### 4.5 Makefile配置（可选）

```makefile
.PHONY: push-all
push-all:
	@echo "Pushing to all repositories..."
	@git push origin main
	@git push gitee main
	@git push private main
	@echo "Done!"

.PHONY: setup-remotes
setup-remotes:
	@echo "Setting up remote repositories..."
	@git remote add origin https://github.com/noahlann/nnet.git || true
	@git remote add gitee https://gitee.com/noahlann/nnet.git || true
	@git remote add private https://your-private-git.com/noahlann/nnet.git || true
	@echo "Remotes configured!"

.PHONY: sync-all
sync-all: push-all
	@echo "Synced to all repositories"
```

使用：

```bash
make push-all
```

## 五、CI/CD配置

### 5.1 GitHub Actions（自动同步到其他仓库）

创建 `.github/workflows/sync-repos.yml`：

```yaml
name: Sync to Multiple Repos

on:
  push:
    branches: [ main, master ]
  workflow_dispatch:

jobs:
  sync:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v3
        with:
          fetch-depth: 0

      - name: Push to Gitee
        env:
          GITEE_TOKEN: ${{ secrets.GITEE_TOKEN }}
        run: |
          git remote add gitee https://oauth2:${GITEE_TOKEN}@gitee.com/noahlann/nnet.git || true
          git push gitee main --force || true

      - name: Push to Private
        env:
          PRIVATE_TOKEN: ${{ secrets.PRIVATE_TOKEN }}
          PRIVATE_URL: ${{ secrets.PRIVATE_URL }}
        run: |
          git remote add private https://oauth2:${PRIVATE_TOKEN}@${PRIVATE_URL}/noahlann/nnet.git || true
          git push private main --force || true
```

### 5.2 Gitee Go（Gitee的CI/CD）

创建 `.gitee/workflows/sync.yml`：

```yaml
name: Sync to Other Repos

on:
  push:
    branches: [ main ]

jobs:
  sync:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v3

      - name: Push to GitHub
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        run: |
          git remote add github https://x-access-token:${GITHUB_TOKEN}@github.com/noahlann/nnet.git || true
          git push github main --force || true
```

## 六、最佳实践

### 6.1 仓库同步策略

1. **主仓库选择**：
   - 选择一个作为"主仓库"（通常是GitHub）
   - 其他仓库作为镜像

2. **分支管理**：
   - 保持所有仓库的分支结构一致
   - 使用相同的分支名称（main/master）

3. **标签同步**：
   ```bash
   # 推送标签到所有仓库
   git push origin --tags
   git push gitee --tags
   git push private --tags
   ```

### 6.2 权限管理

1. **使用Personal Access Token**：
   - GitHub: Settings → Developer settings → Personal access tokens
   - Gitee: 设置 → 私人令牌
   - 私有库: 根据平台配置

2. **使用SSH密钥**（推荐）：
   ```bash
   # 生成SSH密钥
   ssh-keygen -t ed25519 -C "your_email@example.com"
   
   # 添加到各个平台
   # GitHub: Settings → SSH and GPG keys
   # Gitee: 设置 → SSH公钥
   ```

### 6.3 版本发布流程

```bash
# 1. 创建标签
git tag -a v1.0.0 -m "Release v1.0.0"

# 2. 推送代码和标签到所有仓库
git push origin main --tags
git push gitee main --tags
git push private main --tags

# 3. 在各个平台创建Release
# GitHub: Releases → New release
# Gitee: 发行版 → 新建发行版
```

### 6.4 处理冲突

如果不同仓库有不同的提交：

```bash
# 1. 从主仓库拉取
git pull origin main

# 2. 合并其他仓库的更改
git pull gitee main --allow-unrelated-histories
git pull private main --allow-unrelated-histories

# 3. 解决冲突后推送到所有仓库
git pushall
```

## 七、常见问题

### 7.1 如何只推送到特定仓库？

```bash
# 只推送到GitHub
git push origin main

# 只推送到Gitee
git push gitee main
```

### 7.2 如何删除远程仓库？

```bash
# 删除gitee远程仓库
git remote remove gitee
```

### 7.3 如何查看远程仓库的差异？

```bash
# 查看origin和gitee的差异
git fetch origin
git fetch gitee
git log origin/main..gitee/main
```

### 7.4 如何处理不同仓库的README？

如果需要在不同仓库显示不同的README：

```bash
# 使用分支或文件
# 方案1：使用不同的分支
git checkout -b gitee-readme
# 修改README
git push gitee gitee-readme:main

# 方案2：使用不同的文件名
# README.md (GitHub)
# README.gitee.md (Gitee)
```

## 八、推荐配置

### 8.1 日常开发流程

```bash
# 1. 开发完成后提交
git add .
git commit -m "feat: add new feature"

# 2. 推送到所有仓库
git pushall
# 或
./scripts/push-all.sh
```

### 8.2 版本发布流程

```bash
# 1. 更新版本号
vim version.go

# 2. 提交更改
git add .
git commit -m "chore: bump version to v1.0.0"

# 3. 创建标签
git tag -a v1.0.0 -m "Release v1.0.0"

# 4. 推送所有内容
git pushall
git push origin --tags
git push gitee --tags
git push private --tags
```

## 九、使用提供的脚本

### 9.1 快速配置（推荐）

```bash
# 1. 运行配置脚本
chmod +x scripts/setup-remotes.sh
./scripts/setup-remotes.sh

# 脚本会引导您配置所有远程仓库
```

### 9.2 使用推送脚本

```bash
# 1. 给脚本添加执行权限
chmod +x scripts/push-all.sh

# 2. 推送到所有仓库（使用当前分支）
./scripts/push-all.sh

# 3. 推送到指定分支
./scripts/push-all.sh main
./scripts/push-all.sh develop
```

### 9.3 脚本功能

**push-all.sh** 功能：
- ✅ 自动检测当前分支
- ✅ 检查未提交的更改
- ✅ 验证远程仓库配置
- ✅ 推送到所有配置的仓库
- ✅ 自动推送标签
- ✅ 彩色输出和错误处理

**setup-remotes.sh** 功能：
- ✅ 交互式配置远程仓库
- ✅ 支持更新已存在的远程仓库
- ✅ 自动创建Git别名
- ✅ 验证配置结果

## 十、总结

### 10.1 推荐方案

1. **使用提供的脚本**：`./scripts/setup-remotes.sh` 和 `./scripts/push-all.sh`
2. **使用GitHub作为主路径**：go.mod使用 `github.com/noahlann/nnet`（当前配置）
3. **配置CI/CD自动同步**：减少手动操作
4. **使用SSH密钥**：更安全便捷

### 10.2 快速开始

```bash
# 方式1：使用脚本（推荐）
chmod +x scripts/setup-remotes.sh
./scripts/setup-remotes.sh

# 方式2：手动配置
git remote add origin https://github.com/noahlann/nnet.git
git remote add gitee https://gitee.com/noahlann/nnet.git
git remote add private https://your-private-git.com/noahlann/nnet.git

# 推送
./scripts/push-all.sh
# 或
git pushall  # 如果已创建别名
```

### 10.3 工作流程

```bash
# 日常开发
git add .
git commit -m "feat: new feature"
./scripts/push-all.sh

# 版本发布
git tag -a v1.0.0 -m "Release v1.0.0"
./scripts/push-all.sh
git push origin --tags
git push gitee --tags
git push private --tags
```

---

**文档版本**: v1.0  
**最后更新**: 2024