soul/.github-upload-rules.md

# GitHub 上传规则

## 仓库信息

**仓库地址**: https://github.com/fnvtk/Mycontent  
**分支**: soul-content  
**完整地址**: https://github.com/fnvtk/Mycontent/tree/soul-content

---

## 快速上传命令

### 一键上传（推荐）
```bash
cd "/Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验"
git add -A
git commit -m "更新内容"
git push origin soul-content
```

### 详细上传步骤
```bash
# 1. 进入项目目录
cd "/Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验"

# 2. 查看状态
git status

# 3. 添加所有更改
git add -A

# 4. 提交更改（修改提交信息）
git commit -m "feat: 更新说明"

# 5. 推送到GitHub
git push origin soul-content
```

---

## 常用提交信息模板

### 功能更新
```bash
git commit -m "feat: 添加新功能

- 功能1
- 功能2
- 功能3"
```

### Bug修复
```bash
git commit -m "fix: 修复问题

- 修复问题1
- 修复问题2"
```

### 界面优化
```bash
git commit -m "style: 界面优化

- 优化首页
- 优化匹配页面
- 统一配色"
```

### 文档更新
```bash
git commit -m "docs: 更新文档

- 更新README
- 添加使用说明"
```

### 性能优化
```bash
git commit -m "perf: 性能优化

- 优化加载速度
- 优化API响应"
```

---

## Talk功能上传规则

### Talk内容目录
```
book/
├── 附录/
│   └── 附录1｜Soul派对房精选对话.md
└── talk/  （如果有独立的talk目录）
```

### 上传Talk内容
```bash
# 1. 添加talk相关文件
cd "/Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验"
git add book/附录/附录1｜Soul派对房精选对话.md
git add book/talk/*  # 如果有talk目录

# 2. 提交
git commit -m "feat: 更新Talk内容

- 添加新的对话记录
- 更新精选对话"

# 3. 推送
git push origin soul-content
```

---

## 分支管理

### 查看当前分支
```bash
git branch
```

### 切换分支
```bash
git checkout soul-content
```

### 创建新分支
```bash
git checkout -b new-branch-name
```

---

## 同步最新代码

### 拉取最新代码
```bash
cd "/Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验"
git pull origin soul-content
```

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

---

## 回滚操作

### 撤销未提交的更改
```bash
git checkout -- <文件名>
```

### 撤销已提交但未推送的提交
```bash
git reset --soft HEAD^
```

### 查看提交历史
```bash
git log --oneline
```

---

## 忽略文件

### .gitignore 常用配置
```
# 依赖
node_modules/
.pnp
.pnp.js

# 测试
coverage/

# 生产构建
.next/
out/
build/
dist/

# 环境变量
.env
.env.local
.env.production.local
.env.development.local

# 调试日志
npm-debug.log*
yarn-debug.log*
yarn-error.log*

# 操作系统
.DS_Store
Thumbs.db

# IDE
.vscode/
.idea/
*.swp
*.swo

# 小程序
miniprogram/node_modules/
miniprogram/.tea/

# 临时文件
*.log
*.tmp
```

---

## 紧急情况处理

### 推送失败（冲突）
```bash
# 1. 拉取最新代码
git pull origin soul-content

# 2. 解决冲突后
git add -A
git commit -m "fix: 解决冲突"
git push origin soul-content
```

### 强制推送（慎用）
```bash
git push -f origin soul-content
```

---

## 标签管理

### 创建版本标签
```bash
git tag -a v1.3.1 -m "完美版本：首页对齐H5，64章精准数据"
git push origin v1.3.1
```

### 查看所有标签
```bash
git tag
```

---

## 自动化脚本

### 快速上传脚本 (quick-push.sh)
```bash
#!/bin/bash

cd "/Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验"

echo "🚀 开始上传到GitHub..."

# 添加所有更改
git add -A

# 获取提交信息
echo "请输入提交信息（留空则使用默认信息）："
read commit_msg

if [ -z "$commit_msg" ]; then
  commit_msg="update: 更新内容 $(date '+%Y-%m-%d %H:%M:%S')"
fi

# 提交
git commit -m "$commit_msg"

# 推送
git push origin soul-content

echo "✅ 上传完成！"
echo "📝 提交信息：$commit_msg"
echo "🔗 查看：https://github.com/fnvtk/Mycontent/tree/soul-content"
```

### 使用方法
```bash
# 1. 赋予执行权限
chmod +x quick-push.sh

# 2. 执行脚本
./quick-push.sh
```

---

## 常见问题

### Q: 推送时要求输入用户名密码？
**A**: 使用GitHub个人访问令牌（Personal Access Token）
```bash
# 设置远程仓库URL（使用token）
git remote set-url origin https://<TOKEN>@github.com/fnvtk/Mycontent.git
```

### Q: 文件太大无法推送？
**A**: 使用Git LFS
```bash
git lfs install
git lfs track "*.大文件"
git add .gitattributes
```

### Q: 如何删除远程分支？
**A**: 
```bash
git push origin --delete branch-name
```

---

## 项目结构

```
一场soul的创业实验/
├── app/                    # Next.js应用
├── book/                   # 书籍内容（64章）
│   ├── 序言｜...
│   ├── 第一篇｜真实的人/
│   ├── 第二篇｜真实的行业/
│   ├── 第三篇｜真实的错误/
│   ├── 第四篇｜真实的赚钱/
│   ├── 第五篇｜真实的社会/
│   ├── 尾声｜...
│   └── 附录/
│       └── 附录1｜Soul派对房精选对话.md  ← Talk内容
├── miniprogram/            # 微信小程序
├── components/             # 组件
├── lib/                    # 工具库
├── public/                 # 静态资源
│   └── book-chapters.json  # 64章数据
├── scripts/                # 脚本
│   └── sync-book-content.js
├── .gitignore             # Git忽略配置
├── package.json           # 项目配置
└── README.md              # 项目说明
```

---

## 下次上传流程

### 简单三步：
```bash
# 1. 进入目录
cd "/Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验"

# 2. 添加并提交
git add -A && git commit -m "更新内容"

# 3. 推送
git push origin soul-content
```

### 或使用别名（更快）
```bash
# 添加到 ~/.zshrc 或 ~/.bashrc
alias soul-push='cd "/Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验" && git add -A && git commit -m "update: 更新内容" && git push origin soul-content'

# 使用
soul-push
```

---

## 重要提示

1. ⚠️ **推送前检查**：确保没有敏感信息（密钥、密码等）
2. 📝 **提交信息**：写清楚每次更改的内容
3. 🔄 **定期备份**：重要节点创建标签
4. 🚫 **不要推送**：node_modules、.env等文件
5. ✅ **推送后验证**：访问GitHub确认更新成功

---

**仓库地址**: https://github.com/fnvtk/Mycontent/tree/soul-content

**创建时间**: 2026年1月14日  
**最后更新**: v1.3.1