docs: 仓库迁移腾讯云Gitea + 双机开发流程文档更新
- git_workflow.md v3: 第7章从"已废弃"恢复为双机开发流程,含铁律三条/首次克隆/依赖安装 - .clinerules: 更新开发环境为双机模式,补远程仓库地址 - CLAUDE.md: 状态栏更新,技术栈节补远程仓库信息 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
simonkoson
+78
-25
@@ -1,8 +1,8 @@
|
||||
# docs/git_workflow.md — Git 操作手册
|
||||
|
||||
> 项目:TPS 中台
|
||||
> 仓库:`tps-dashboard`(单位 Gitea)
|
||||
> 文档版本:v2 · 2026-05-14
|
||||
> 仓库:`tps-dashboard`(腾讯云 Gitea: http://101.42.29.217:3000/lanhao/tps-dashboard）
|
||||
> 文档版本:v3 · 2026-07-03
|
||||
> 受众:**制片人(不会 Git)** + Cline(自动遵守此规则)
|
||||
|
||||
---
|
||||
@@ -386,10 +386,10 @@ git push origin phase1-complete
|
||||
### Q5:换了一台机器,怎么把代码搞过来
|
||||
|
||||
```powershell
|
||||
cd E:\tps-dashboard\
|
||||
git clone http://localhost:3000/simonkoson/tps-dashboard.git
|
||||
# 在新机器上 clone 云端仓库
|
||||
git clone http://101.42.29.217:3000/lanhao/tps-dashboard.git
|
||||
cd tps-dashboard
|
||||
# 然后跟原来一样开工就行
|
||||
# 然后按第 7 章流程开工
|
||||
```
|
||||
|
||||
### Q6:某次 commit 写错了想撤回
|
||||
@@ -404,34 +404,86 @@ git reset HEAD~1 # 撤回最近一次 commit,文件改动保留
|
||||
|
||||
---
|
||||
|
||||
## 第 7 章:多设备同步(已废弃)
|
||||
## 第 7 章:双机开发同步(单位 + 家里)
|
||||
|
||||
> ⚠️ **2026-05-14 更新**:家用机已于 2026-05-14 退役,项目统一在单位 4090D 开发。
|
||||
> 本章描述的多设备同步模式**已废弃**,保留仅供历史参考。
|
||||
> 当前工作流:单一开发机,每日开工 `git pull`,离开前 `git push`。
|
||||
> **2026-07-03 恢复**:项目远程仓库迁至腾讯云 Gitea,单位和家里两台电脑均可开发。
|
||||
|
||||
---
|
||||
### 7.0 仓库架构
|
||||
|
||||
### 7.1 历史模式(已废弃)
|
||||
| 项目 | 云端地址 | 说明 |
|
||||
|---|---|---|
|
||||
| **TPS 工作台(主项目)** | `http://101.42.29.217:3000/lanhao/tps-dashboard.git` | 所有主干代码 + doco/ai-labeling 等子项目目录 |
|
||||
| **配音工具** | `http://101.42.29.217:3000/lanhao/military-tech-voice3.0.git` | 独立小应用,将来作为 tps-dashboard 子功能合入 |
|
||||
|
||||
#### 离开 A 机器前
|
||||
云端 Gitea 用户名统一 `lanhao`。
|
||||
|
||||
### 7.1 每天开工铁律(无论在哪台电脑)
|
||||
|
||||
```powershell
|
||||
git status # 看有没有未提交的
|
||||
git add -A # 加进暂存
|
||||
git commit -m "..."
|
||||
git push
|
||||
```
|
||||
|
||||
### 到 B 机器开工
|
||||
|
||||
```powershell
|
||||
git pull # 拉最新
|
||||
git status # 确认干净
|
||||
cd E:\tps-dashboard\ # 单位机路径;家里机路径按实际调整
|
||||
git pull # 拉云端最新代码
|
||||
git status # 确认本地干净,无冲突
|
||||
# 开始干活
|
||||
```
|
||||
|
||||
**铁律**:**永远在 push 之前 pull**,永远在开工前 pull。这两条做到,99% 不会冲突。
|
||||
### 7.2 离开机器前铁律
|
||||
|
||||
```powershell
|
||||
git status # 确认改动
|
||||
git add -A # 暂存所有
|
||||
git commit -m "feat/fix/...: 改了什么"
|
||||
git push # 推到云端
|
||||
```
|
||||
|
||||
**不 push 就关机 = 另一台电脑拿不到你的改动,下次必出冲突。**
|
||||
|
||||
### 7.3 换到另一台电脑
|
||||
|
||||
```powershell
|
||||
git pull # 先拉最新
|
||||
git status # 确认干净
|
||||
# 正常开发
|
||||
```
|
||||
|
||||
### 7.4 铁律三条(Cline 和人都必须守)
|
||||
|
||||
1. **开工先 pull** — 每次打开项目第一条命令就是 `git pull`
|
||||
2. **收工必 push** — 做完改动 commit 后必须 push,不过夜
|
||||
3. **push 前先 pull** — 防止另一台机器推过内容导致冲突
|
||||
|
||||
做到这三条,99% 不会冲突。万一冲突,**停下来找 Claude 处理,不要自己瞎搞**。
|
||||
|
||||
### 7.5 家里电脑首次克隆(只做一次)
|
||||
|
||||
```powershell
|
||||
cd D:\myApp\lanhao2.0 # 家里机器的工作目录(按实际调整)
|
||||
git clone http://101.42.29.217:3000/lanhao/tps-dashboard.git
|
||||
cd tps-dashboard
|
||||
# 克隆完毕,以后按 7.1-7.3 流程开发
|
||||
```
|
||||
|
||||
克隆时会要求输入 Gitea 用户名密码(lanhao / 你的密码)。
|
||||
|
||||
### 7.6 .gitignore 不入库的文件(两台电脑都适用)
|
||||
|
||||
以下文件/目录**永远不推到云端**,只存在本地:
|
||||
- `.env` / `.env.local`(密码密钥)
|
||||
- `node_modules/` / `.venv/`(依赖,各机器自己装)
|
||||
- `*.mp4` / `*.mov` / `*.psd`(大文件)
|
||||
- `*.dump`(数据库备份)
|
||||
- `backup_before_*.dump`(迁移备份)
|
||||
- 各种中间产物(详见 `.gitignore`)
|
||||
|
||||
**家里电脑 clone 后需要自己装依赖**:
|
||||
```powershell
|
||||
# 前端
|
||||
cd frontend && npm install
|
||||
|
||||
# 后端
|
||||
cd backend && python -m venv .venv
|
||||
.venv\Scripts\activate
|
||||
pip install -r requirements.txt
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
@@ -440,7 +492,8 @@ git status # 确认干净
|
||||
| 版本 | 日期 | 变化 |
|
||||
|---|---|---|
|
||||
| v1 | 2026-05-06 | 初版 |
|
||||
| **v2** | **2026-05-14** | **项目目录从 NAS(Z:\AIworks\)迁移至本地 SSD(E:\tps-dashboard\);家用机退役,唯一开发环境为单位 4090D;Phase 2 起 MiniMax M2.7 正式日常使用;更新版本演进记录** |
|
||||
| v2 | 2026-05-14 | 项目目录从 NAS(Z:\AIworks\)迁移至本地 SSD(E:\tps-dashboard\);家用机退役,唯一开发环境为单位 4090D;Phase 2 起 MiniMax M2.7 正式日常使用 |
|
||||
| **v3** | **2026-07-03** | **远程仓库从本地 Gitea(localhost:3000) 迁至腾讯云 Gitea(101.42.29.217:3000);恢复双机开发模式(单位+家里);git 历史清理大文件(mp4/psd);.gitignore 加强** |
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user