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:
+3
-1
@@ -35,7 +35,9 @@
|
|||||||
|
|
||||||
- **Plan 模式**:MiniMax M2.7(标准版,非 highspeed)
|
- **Plan 模式**:MiniMax M2.7(标准版,非 highspeed)
|
||||||
- **Act 模式**:MiniMax M2.7
|
- **Act 模式**:MiniMax M2.7
|
||||||
- 家用机已退役,唯一开发环境为单位 4090D(E:\tps-dashboard)
|
- 双机开发:单位 4090D(E:\tps-dashboard) + 家里电脑,通过腾讯云 Gitea 同步
|
||||||
|
- 远程仓库:`http://101.42.29.217:3000/lanhao/tps-dashboard.git`
|
||||||
|
- **开工先 pull、收工必 push、push 前先 pull**——三条铁律,详见 `docs/git_workflow.md` 第 7 章
|
||||||
- API 配置:`base_url = https://api.minimaxi.com/v1`,Model ID = `MiniMax-M2.7`
|
- API 配置:`base_url = https://api.minimaxi.com/v1`,Model ID = `MiniMax-M2.7`
|
||||||
|
|
||||||
**模型降级口诀**:
|
**模型降级口诀**:
|
||||||
|
|||||||
@@ -13,8 +13,8 @@
|
|||||||
|
|
||||||
## 🔖 状态栏(每次结束 session 前必须更新这三行)
|
## 🔖 状态栏(每次结束 session 前必须更新这三行)
|
||||||
|
|
||||||
- **最后更新**:Claude(顾问)| 2026-06-26
|
- **最后更新**:Claude(顾问)| 2026-07-03
|
||||||
- **当前状态一句话**:Phase 3 知识库已完成;看板升级子项目 L3 分析引擎原型 v0.1 已出(HTML 可视化+制片人审定视觉方向),L2 打标收摊+003 迁移到位。主干暂停。
|
- **当前状态一句话**:远程仓库已迁至腾讯云 Gitea(101.42.29.217:3000),双机开发就绪;git 历史已清理大文件(769MB→5MB)。Phase 3 知识库已完成,主干暂停。
|
||||||
- **下一个动手的人从这里开始**:见下方「⏩ 交接备注」
|
- **下一个动手的人从这里开始**:见下方「⏩ 交接备注」
|
||||||
|
|
||||||
---
|
---
|
||||||
@@ -63,6 +63,7 @@
|
|||||||
- **认证**:**Session + Cookie(不用 JWT)**;CORS 必须 `allow_credentials=True` + 显式列 `allow_origins`(不能 `["*"]`)。
|
- **认证**:**Session + Cookie(不用 JWT)**;CORS 必须 `allow_credentials=True` + 显式列 `allow_origins`(不能 `["*"]`)。
|
||||||
- **其他锁定**:Word 用 docxtpl;甘特图用 frappe-gantt;定时任务 APScheduler。任何「换成 XX 更好」先在 Plan 讨论,绝不直接改。
|
- **其他锁定**:Word 用 docxtpl;甘特图用 frappe-gantt;定时任务 APScheduler。任何「换成 XX 更好」先在 Plan 讨论,绝不直接改。
|
||||||
- **关键目录**:`backend/app/{api,core,services,models,db}`、`backend/sql/`、`frontend/src/{pages,components,services,stores}`、`logs/`、`docs/`。
|
- **关键目录**:`backend/app/{api,core,services,models,db}`、`backend/sql/`、`frontend/src/{pages,components,services,stores}`、`logs/`、`docs/`。
|
||||||
|
- **远程仓库**:`http://101.42.29.217:3000/lanhao/tps-dashboard.git`(腾讯云 Gitea,用户 lanhao)。**双机开发**:单位 4090D + 家里电脑,开工先 `git pull`,收工必 `git push`,详见 `docs/git_workflow.md` 第 7 章。
|
||||||
- **本地启动**(开发模式,两个 PowerShell 窗口都别关;仓库根 `E:\tps-dashboard`):
|
- **本地启动**(开发模式,两个 PowerShell 窗口都别关;仓库根 `E:\tps-dashboard`):
|
||||||
- 后端:`cd backend` → 激活虚拟环境 → `uvicorn app.main:app --reload --port 8000`(文档 `/docs`)
|
- 后端:`cd backend` → 激活虚拟环境 → `uvicorn app.main:app --reload --port 8000`(文档 `/docs`)
|
||||||
- 前端:`cd frontend` → `npm run dev`(端口 5173 或 5174)
|
- 前端:`cd frontend` → `npm run dev`(端口 5173 或 5174)
|
||||||
|
|||||||
+78
-25
@@ -1,8 +1,8 @@
|
|||||||
# docs/git_workflow.md — Git 操作手册
|
# docs/git_workflow.md — Git 操作手册
|
||||||
|
|
||||||
> 项目:TPS 中台
|
> 项目:TPS 中台
|
||||||
> 仓库:`tps-dashboard`(单位 Gitea)
|
> 仓库:`tps-dashboard`(腾讯云 Gitea: http://101.42.29.217:3000/lanhao/tps-dashboard)
|
||||||
> 文档版本:v2 · 2026-05-14
|
> 文档版本:v3 · 2026-07-03
|
||||||
> 受众:**制片人(不会 Git)** + Cline(自动遵守此规则)
|
> 受众:**制片人(不会 Git)** + Cline(自动遵守此规则)
|
||||||
|
|
||||||
---
|
---
|
||||||
@@ -386,10 +386,10 @@ git push origin phase1-complete
|
|||||||
### Q5:换了一台机器,怎么把代码搞过来
|
### Q5:换了一台机器,怎么把代码搞过来
|
||||||
|
|
||||||
```powershell
|
```powershell
|
||||||
cd E:\tps-dashboard\
|
# 在新机器上 clone 云端仓库
|
||||||
git clone http://localhost:3000/simonkoson/tps-dashboard.git
|
git clone http://101.42.29.217:3000/lanhao/tps-dashboard.git
|
||||||
cd tps-dashboard
|
cd tps-dashboard
|
||||||
# 然后跟原来一样开工就行
|
# 然后按第 7 章流程开工
|
||||||
```
|
```
|
||||||
|
|
||||||
### Q6:某次 commit 写错了想撤回
|
### Q6:某次 commit 写错了想撤回
|
||||||
@@ -404,34 +404,86 @@ git reset HEAD~1 # 撤回最近一次 commit,文件改动保留
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 第 7 章:多设备同步(已废弃)
|
## 第 7 章:双机开发同步(单位 + 家里)
|
||||||
|
|
||||||
> ⚠️ **2026-05-14 更新**:家用机已于 2026-05-14 退役,项目统一在单位 4090D 开发。
|
> **2026-07-03 恢复**:项目远程仓库迁至腾讯云 Gitea,单位和家里两台电脑均可开发。
|
||||||
> 本章描述的多设备同步模式**已废弃**,保留仅供历史参考。
|
|
||||||
> 当前工作流:单一开发机,每日开工 `git pull`,离开前 `git push`。
|
|
||||||
|
|
||||||
---
|
### 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
|
```powershell
|
||||||
git status # 看有没有未提交的
|
cd E:\tps-dashboard\ # 单位机路径;家里机路径按实际调整
|
||||||
git add -A # 加进暂存
|
git pull # 拉云端最新代码
|
||||||
git commit -m "..."
|
git status # 确认本地干净,无冲突
|
||||||
git push
|
|
||||||
```
|
|
||||||
|
|
||||||
### 到 B 机器开工
|
|
||||||
|
|
||||||
```powershell
|
|
||||||
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 | 初版 |
|
| 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