feat: 品牌重命名 Sub2API -> TianShuAPI (基于官方 v0.1.56)
基于官方最新代码 upstream/main (dae0d53)
新功能：
- 添加 5小时窗口费用控制和会话数量限制
- Caddy 静态资源长期缓存配置
- 前端性能优化（路由预加载、移除 Google Fonts 改用系统字体）
- 修复 api_contract_test 缺少 SessionLimitCache 参数问题
品牌修改：
- 仅修改品牌显示名称为 TianShuAPI
- 保持所有功能完整
- 恢复 docker-compose.1panel.yml 配置文件
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
huangzhenpc
207
项目介绍.md
Normal file
207
项目介绍.md
Normal file
@@ -0,0 +1,207 @@
|
||||
● 完全正确！标准的二次开发工作流程就是这样的：
|
||||
|
||||
🔄 正确的工作流程
|
||||
|
||||
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
|
||||
│ 官方仓库 │ │ 你的仓库 │ │ 生产服务器 │
|
||||
│ (upstream) │────┐ │ (origin) │────────▶│ /opt/sub2api │
|
||||
│ GitHub │ │ │ git.586vip.cn │ │ │
|
||||
└─────────────────┘ │ └──────────────────┘ └─────────────────┘
|
||||
│ ▲ │
|
||||
│ │ │
|
||||
│ │ push │ pull
|
||||
│ │ │
|
||||
│ ┌─────────┴──────────┐ │
|
||||
└───▶│ 本地开发环境 │ │
|
||||
fetch/pull │ (你的 WSL) │◀──────────────┘
|
||||
│ /mnt/d/tmp/... │ 仅用于测试
|
||||
└────────────────────┘
|
||||
|
||||
---
|
||||
📋 具体操作流程
|
||||
|
||||
1️⃣ 本地环境（你的 WSL - 主要工作区）
|
||||
|
||||
cd /mnt/d/tmp/claude相关/sub2api
|
||||
|
||||
# 查看当前 remote 配置
|
||||
git remote -v
|
||||
# origin https://git.586vip.cn/oadmin/sub2api.git
|
||||
# upstream https://github.com/Wei-Shaw/sub2api.git
|
||||
|
||||
# ===== 同步官方更新 =====
|
||||
|
||||
# 1. 拉取官方最新代码
|
||||
git fetch upstream
|
||||
|
||||
# 2. 查看官方更新了什么
|
||||
git log HEAD..upstream/main --oneline --graph
|
||||
|
||||
# 3. 详细对比差异（重要！）
|
||||
git diff HEAD..upstream/main
|
||||
|
||||
# 查看某个文件的差异
|
||||
git diff HEAD..upstream/main -- backend/internal/service/gateway_service.go
|
||||
|
||||
# 4. 合并官方更新到你的本地
|
||||
git merge upstream/main
|
||||
|
||||
# 5. 如果有冲突，解决冲突
|
||||
# (编辑冲突文件，保留你需要的代码)
|
||||
git add .
|
||||
git commit -m "merge: 合并官方更新 vX.X.X"
|
||||
|
||||
# 6. 推送到你的仓库
|
||||
git push origin main
|
||||
|
||||
2️⃣ 服务器环境（生产服务器 - 只拉取你的仓库）
|
||||
|
||||
cd /opt/sub2api-dev
|
||||
|
||||
# 查看 remote（应该只有 origin 指向你的仓库）
|
||||
git remote -v
|
||||
# origin https://git.586vip.cn/oadmin/sub2api.git
|
||||
|
||||
# ===== 更新服务器代码 =====
|
||||
|
||||
# 1. 拉取你的仓库最新代码
|
||||
git pull origin main
|
||||
|
||||
# 2. 重新部署
|
||||
cd deploy
|
||||
docker-compose pull
|
||||
docker-compose up -d
|
||||
|
||||
# 3. 查看日志确认
|
||||
docker-compose logs -f
|
||||
|
||||
---
|
||||
🎯 完整示例场景
|
||||
|
||||
场景：官方发布了 v1.5.0 版本
|
||||
|
||||
第 1 步：本地对比更新
|
||||
|
||||
# 在你的 WSL 中
|
||||
cd /mnt/d/tmp/claude相关/sub2api
|
||||
|
||||
# 拉取官方更新
|
||||
git fetch upstream
|
||||
|
||||
# 查看更新内容
|
||||
git log HEAD..upstream/main --oneline
|
||||
# a1b2c3d (upstream/main) feat: 新增 XX 功能
|
||||
# d4e5f6g fix: 修复 YY 问题
|
||||
# ...
|
||||
|
||||
# 对比差异
|
||||
git diff HEAD..upstream/main
|
||||
|
||||
# 如果改动太多，可以查看修改的文件列表
|
||||
git diff --name-only HEAD..upstream/main
|
||||
|
||||
# 查看某个关键文件的详细差异
|
||||
git diff HEAD..upstream/main -- backend/internal/service/gateway_service.go
|
||||
|
||||
第 2 步：本地合并更新
|
||||
|
||||
# 确保工作区干净
|
||||
git status
|
||||
|
||||
# 如果有未提交的修改，先提交
|
||||
git add .
|
||||
git commit -m "feat: 我的二开功能"
|
||||
|
||||
# 合并官方更新
|
||||
git merge upstream/main
|
||||
|
||||
# 如果有冲突
|
||||
# <<<<<<< HEAD
|
||||
# 你的代码
|
||||
# =======
|
||||
# 官方代码
|
||||
# >>>>>>> upstream/main
|
||||
|
||||
# 手动编辑冲突文件，选择保留哪部分代码
|
||||
nano backend/internal/service/gateway_service.go
|
||||
|
||||
# 解决冲突后
|
||||
git add .
|
||||
git commit -m "merge: 合并官方 v1.5.0 更新"
|
||||
|
||||
第 3 步：推送到你的仓库
|
||||
|
||||
# 推送到你的仓库
|
||||
git push origin main
|
||||
|
||||
第 4 步：服务器更新
|
||||
|
||||
# SSH 到服务器
|
||||
ssh root@你的服务器IP
|
||||
|
||||
# 进入项目目录
|
||||
cd /opt/sub2api-dev
|
||||
|
||||
# 拉取最新代码
|
||||
git pull origin main
|
||||
|
||||
# 如果代码有更新，重新部署
|
||||
cd deploy
|
||||
docker-compose pull
|
||||
docker-compose up -d
|
||||
|
||||
# 查看日志
|
||||
docker-compose logs -f sub2api
|
||||
|
||||
---
|
||||
⚠️ 重要注意事项
|
||||
|
||||
✅ 正确做法
|
||||
|
||||
- ✅ 本地开发：拉取官方更新、对比、合并
|
||||
- ✅ 本地测试：确保合并后代码能正常运行
|
||||
- ✅ 推送到自己仓库：git push origin main
|
||||
- ✅ 服务器拉取：git pull origin main
|
||||
|
||||
❌ 错误做法
|
||||
|
||||
- ❌ 服务器直接拉取官方代码（跳过本地对比）
|
||||
- ❌ 不测试就直接推送到生产
|
||||
- ❌ 直接在服务器上修改代码（应该在本地改）
|
||||
|
||||
---
|
||||
📝 快速命令速查
|
||||
|
||||
本地（开发环境）
|
||||
|
||||
# 同步官方更新
|
||||
git fetch upstream
|
||||
git log HEAD..upstream/main --oneline
|
||||
git diff HEAD..upstream/main
|
||||
git merge upstream/main
|
||||
git push origin main
|
||||
|
||||
服务器（生产环境）
|
||||
|
||||
# 更新代码
|
||||
cd /opt/sub2api-dev
|
||||
git pull origin main
|
||||
|
||||
# 重新部署
|
||||
cd deploy
|
||||
docker-compose pull
|
||||
docker-compose up -d
|
||||
docker-compose logs -f
|
||||
|
||||
cd deploy/
|
||||
# 如果没有输出，说明需要重新复制
|
||||
cp docker-compose.1panel.yml docker-compose.yml
|
||||
|
||||
docker-compose build --no-cache
|
||||
|
||||
docker-compose up -d
|
||||
|
||||
# 或者一条命令
|
||||
docker-compose up -d --build
|
||||
---
|
||||
现在你可以先在服务器上部署了，后续官方有更新时，就按照上面的流程操作！
|
||||
Reference in New Issue
Block a user