TradingAgents/GIT_REMOTE_SETUP.md

连接远程 Git 仓库指南

📋 快速步骤

情况 1: 本地已有代码，需要连接到远程仓库

# 1. 初始化 git 仓库（如果还没有）
git init

# 2. 添加远程仓库
git remote add origin <你的远程仓库URL>

# 3. 添加所有文件
git add .

# 4. 创建初始提交
git commit -m "Initial commit: Add TradingAgents with seeking_alpha_analyst"

# 5. 推送到远程（如果是新仓库）
git branch -M main  # 将分支重命名为 main（如果远程使用 main）
git push -u origin main

# 或者如果远程使用 master
git push -u origin master

情况 2: 远程仓库已有代码，需要克隆并连接

# 1. 克隆远程仓库
git clone <你的远程仓库URL>

# 2. 进入目录
cd <仓库名>

# 3. 查看远程仓库
git remote -v

---

🔗 远程仓库 URL 格式

HTTPS 方式（推荐新手）

git remote add origin https://github.com/username/repo-name.git

SSH 方式（需要配置 SSH key）

git remote add origin git@github.com:username/repo-name.git

---

📝 完整示例

假设你的远程仓库是 https://github.com/yourusername/TradingAgents.git：

# 1. 初始化
git init

# 2. 添加远程
git remote add origin https://github.com/yourusername/TradingAgents.git

# 3. 检查远程配置
git remote -v
# 应该显示:
# origin  https://github.com/yourusername/TradingAgents.git (fetch)
# origin  https://github.com/yourusername/TradingAgents.git (push)

# 4. 添加文件
git add .

# 5. 提交
git commit -m "Initial commit: TradingAgents with seeking_alpha_analyst"

# 6. 推送到远程
git branch -M main
git push -u origin main

---

🔧 常用命令

查看远程仓库

git remote -v

修改远程仓库 URL

git remote set-url origin <新的URL>

删除远程仓库

git remote remove origin

重命名远程仓库

git remote rename origin upstream

拉取远程更新

git pull origin main

推送本地更新

git push origin main

---

⚠️ 常见问题

问题 1: 远程仓库已存在内容

如果远程仓库已经有代码，需要先拉取：

# 拉取远程代码
git pull origin main --allow-unrelated-histories

# 解决可能的冲突后
git add .
git commit -m "Merge remote and local"
git push origin main

问题 2: 认证失败

如果使用 HTTPS，可能需要配置 token：

1. GitHub: Settings → Developer settings → Personal access tokens
2. 生成 token 后，使用 token 作为密码

或者配置 SSH key（推荐）：

# 生成 SSH key
ssh-keygen -t ed25519 -C "your_email@example.com"

# 添加到 ssh-agent
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

# 复制公钥到 GitHub/GitLab
cat ~/.ssh/id_ed25519.pub

问题 3: 分支名称不匹配

# 查看当前分支
git branch

# 重命名分支
git branch -M main  # 重命名为 main
# 或
git branch -M master  # 重命名为 master

---

🚀 使用提供的脚本

我已经创建了 connect_remote_git.sh 脚本，你可以这样使用：

# 使用脚本（需要提供远程 URL）
./connect_remote_git.sh https://github.com/username/repo.git

# 或者指定远程名称
./connect_remote_git.sh https://github.com/username/repo.git origin

---

📌 下一步

连接成功后，你可以：

1. 继续开发: 正常使用 git add, git commit, git push
2. 创建分支: git checkout -b feature/new-feature
3. 协作: 其他人可以 git clone 你的仓库

---

💡 提示

• 首次推送使用 -u 参数设置上游分支: git push -u origin main
• 之后可以直接使用 git push 和 git pull
• 建议定期提交和推送，避免丢失代码