soul/.github-upload-rules.md

GitHub 上传规则

仓库信息

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

---

快速上传命令

一键上传（推荐）

cd "/Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验"
git add -A
git commit -m "更新内容"
git push origin soul-content

详细上传步骤

# 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

---

常用提交信息模板

功能更新

git commit -m "feat: 添加新功能

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

Bug修复

git commit -m "fix: 修复问题

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

界面优化

git commit -m "style: 界面优化

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

文档更新

git commit -m "docs: 更新文档

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

性能优化

git commit -m "perf: 性能优化

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

---

Talk功能上传规则

Talk内容目录

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

上传Talk内容

# 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

---

分支管理

查看当前分支

git branch

切换分支

git checkout soul-content

创建新分支

git checkout -b new-branch-name

---

同步最新代码

拉取最新代码

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

查看远程仓库

git remote -v

---

回滚操作

撤销未提交的更改

git checkout -- <文件名>

撤销已提交但未推送的提交

git reset --soft HEAD^

查看提交历史

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

---

紧急情况处理

推送失败（冲突）

# 1. 拉取最新代码
git pull origin soul-content

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

强制推送（慎用）

git push -f origin soul-content

---

标签管理

创建版本标签

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

查看所有标签

git tag

---

自动化脚本

快速上传脚本 (quick-push.sh)

#!/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"

使用方法

# 1. 赋予执行权限
chmod +x quick-push.sh

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

---

常见问题

Q: 推送时要求输入用户名密码？

A: 使用GitHub个人访问令牌（Personal Access Token）

# 设置远程仓库URL（使用token）
git remote set-url origin https://<TOKEN>@github.com/fnvtk/Mycontent.git

Q: 文件太大无法推送？

A: 使用Git LFS

git lfs install
git lfs track "*.大文件"
git add .gitattributes

Q: 如何删除远程分支？

A:

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              # 项目说明

---

下次上传流程

简单三步：

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

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

# 3. 推送
git push origin soul-content

或使用别名（更快）

# 添加到 ~/.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