# Git 版本管理指南 **项目**: Funstat MCP Server **当前版本**: v1.0.0 **最后更新**: 2025-10-26 --- ## 📋 仓库信息 ```bash 项目路径: /Users/lucas/chat--1003255561049 Git状态: ✅ 已初始化分支: main 提交数: 1 标签: v1.0.0 ``` --- ## 🏷️ 版本标签 ### v1.0.0 - 首次发布 (2025-10-26) **核心功能**: - ✅ 自动翻页搜索 (数据获取+285%) - ✅ SSE传输模式 - ✅ 8个MCP工具 - ✅ 完整文档 **性能指标**: - 翻页速度: 6秒/页 - 数据量: 890条记录 - 自动化率: 100% **提交信息**: ``` feat: 初始提交 - Funstat MCP 服务器 v1.0.0 53 files changed, 11235 insertions(+) ``` --- ## 📂 文件结构 ### 已跟踪的重要文件 ``` ✅ .gitignore # Git忽略规则 ✅ README.md # 项目说明文档 ✅ claude-code-mcp-config.json # MCP配置 ✅ funstat_mcp/ ✅ server.py # MCP服务器(SSE) ✅ search_with_pagination.py # 翻页搜索 ✅ search_all_translation.py # 多关键词搜索 ✅ test_pagination.py # 翻页测试 ✅ requirements.txt # Python依赖 ✅ start_sse.sh # SSE启动脚本 ✅ 文档/ ✅ PAGINATION_SUCCESS_REPORT.md # 翻页功能报告 ✅ SSE_CONVERSION_COMPLETE.md # SSE转换文档 ✅ AGENTAPI_PROXY_SETUP.md # AgentAPI配置 ✅ FUNSTAT_MCP_DEPLOYMENT_REPORT.md # 部署报告 ``` ### 被忽略的文件 ``` ❌ *.session # Telegram会话文件 ❌ *.session-journal # 会话日志 ❌ *.txt # 数据文本文件 ❌ *.json (除配置文件外) # 数据JSON文件 ❌ __pycache__/ # Python缓存 ❌ *.log # 日志文件 ❌ .DS_Store # macOS系统文件 ``` --- ## 🔧 常用Git命令 ### 查看状态 ```bash # 查看工作区状态 git status # 查看提交历史 git log --oneline # 查看详细提交历史 git log --graph --decorate --all # 查看所有标签 git tag -l -n9 ``` ### 创建提交 ```bash # 添加所有更改 git add . # 添加特定文件 git add funstat_mcp/server.py # 提交更改 git commit -m "feat: 添加新功能" # 使用多行提交信息 git commit -m "$(cat <<'EOF' feat: 功能标题详细说明... 🤖 Generated with Claude Code Co-Authored-By: Claude EOF )" ``` ### 版本标签 ```bash # 创建带注释的标签 git tag -a v1.1.0 -m "版本 1.1.0 说明" # 查看标签 git tag -l # 查看标签详情 git show v1.0.0 # 删除标签 git tag -d v1.0.0 ``` ### 分支管理 ```bash # 创建分支 git branch feature/new-feature # 切换分支 git checkout feature/new-feature # 创建并切换 git checkout -b feature/new-feature # 合并分支 git checkout main git merge feature/new-feature # 删除分支 git branch -d feature/new-feature ``` ### 撤销操作 ```bash # 撤销工作区更改 git checkout -- file.py # 撤销暂存 git reset HEAD file.py # 修改最后一次提交 git commit --amend # 回退到上一个提交 git reset --soft HEAD^ ``` --- ## 📝 提交规范 ### Commit Message 格式 ``` ():