diff --git a/.clinerules b/.clinerules index e676838..9f663e8 100644 --- a/.clinerules +++ b/.clinerules @@ -35,7 +35,9 @@ - **Plan 模式**:MiniMax M2.7(标准版,非 highspeed) - **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` **模型降级口诀**: diff --git a/CLAUDE.md b/CLAUDE.md index 4955aaa..b9db7cd 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -13,8 +13,8 @@ ## 🔖 状态栏(每次结束 session 前必须更新这三行) - - **最后更新**:Claude(顾问)| 2026-06-26 - - **当前状态一句话**:Phase 3 知识库已完成;看板升级子项目 L3 分析引擎原型 v0.1 已出(HTML 可视化+制片人审定视觉方向),L2 打标收摊+003 迁移到位。主干暂停。 + - **最后更新**:Claude(顾问)| 2026-07-03 + - **当前状态一句话**:远程仓库已迁至腾讯云 Gitea(101.42.29.217:3000),双机开发就绪;git 历史已清理大文件(769MB→5MB)。Phase 3 知识库已完成,主干暂停。 - **下一个动手的人从这里开始**:见下方「⏩ 交接备注」 --- @@ -63,6 +63,7 @@ - **认证**:**Session + Cookie(不用 JWT)**;CORS 必须 `allow_credentials=True` + 显式列 `allow_origins`(不能 `["*"]`)。 - **其他锁定**:Word 用 docxtpl;甘特图用 frappe-gantt;定时任务 APScheduler。任何「换成 XX 更好」先在 Plan 讨论,绝不直接改。 - **关键目录**:`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`): - 后端:`cd backend` → 激活虚拟环境 → `uvicorn app.main:app --reload --port 8000`(文档 `/docs`) - 前端:`cd frontend` → `npm run dev`(端口 5173 或 5174) diff --git a/docs/git_workflow.md b/docs/git_workflow.md index 9c4070d..afcca78 100644 --- a/docs/git_workflow.md +++ b/docs/git_workflow.md @@ -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 加强** | ---