補充開發部署流程說明
Browse files
CLAUDE.md
CHANGED
|
@@ -115,33 +115,39 @@ git remote add test https://KyrosDev:<HF_TOKEN>@huggingface.co/spaces/KyrosDev/k
|
|
| 115 |
|
| 116 |
### 開發工作流程
|
| 117 |
|
| 118 |
-
|
| 119 |
```bash
|
| 120 |
# 確保在 develop 分支
|
| 121 |
git checkout develop
|
| 122 |
|
| 123 |
# 開發、修改程式碼...
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 124 |
|
| 125 |
-
# 提交
|
| 126 |
-
git
|
| 127 |
-
git commit -m "新增功能描述"
|
| 128 |
|
| 129 |
# 推送到 GitHub(養成習慣)
|
| 130 |
git push github develop
|
| 131 |
```
|
| 132 |
|
| 133 |
-
|
| 134 |
```bash
|
| 135 |
# 推送 develop 到測試平台(HF 從 main 分支 build)
|
| 136 |
git push test develop:main
|
| 137 |
```
|
| 138 |
|
| 139 |
-
|
| 140 |
- 訪問 https://huggingface.co/spaces/KyrosDev/kstools-license-manager-test
|
|
|
|
| 141 |
- 測試所有功能是否正常
|
| 142 |
- 確認 API、UI、資料庫連線正常
|
| 143 |
|
| 144 |
-
|
| 145 |
```bash
|
| 146 |
# 切換到 main 分支
|
| 147 |
git checkout main
|
|
@@ -150,15 +156,37 @@ git checkout main
|
|
| 150 |
git merge develop
|
| 151 |
|
| 152 |
# 推送到正式環境和 GitHub
|
| 153 |
-
git push origin main
|
| 154 |
-
git push github main
|
| 155 |
-
```
|
| 156 |
|
| 157 |
-
|
| 158 |
-
```bash
|
| 159 |
git checkout develop
|
| 160 |
```
|
| 161 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 162 |
### 快速指令參考
|
| 163 |
|
| 164 |
```bash
|
|
|
|
| 115 |
|
| 116 |
### 開發工作流程
|
| 117 |
|
| 118 |
+
#### Step 1: 在 develop 分支開發
|
| 119 |
```bash
|
| 120 |
# 確保在 develop 分支
|
| 121 |
git checkout develop
|
| 122 |
|
| 123 |
# 開發、修改程式碼...
|
| 124 |
+
```
|
| 125 |
+
|
| 126 |
+
#### Step 2: 提交變更並推送 GitHub
|
| 127 |
+
```bash
|
| 128 |
+
# 加入變更檔案(指定檔案,避免加入敏感資訊)
|
| 129 |
+
git add <檔案1> <檔案2> ...
|
| 130 |
|
| 131 |
+
# 提交(遵循 commit 規範,不含 AI 相關資訊)
|
| 132 |
+
git commit -m "功能描述"
|
|
|
|
| 133 |
|
| 134 |
# 推送到 GitHub(養成習慣)
|
| 135 |
git push github develop
|
| 136 |
```
|
| 137 |
|
| 138 |
+
#### Step 3: 部署到測試環境
|
| 139 |
```bash
|
| 140 |
# 推送 develop 到測試平台(HF 從 main 分支 build)
|
| 141 |
git push test develop:main
|
| 142 |
```
|
| 143 |
|
| 144 |
+
#### Step 4: 在測試環境驗證
|
| 145 |
- 訪問 https://huggingface.co/spaces/KyrosDev/kstools-license-manager-test
|
| 146 |
+
- 等待 HuggingFace build 完成(約 2-5 分鐘)
|
| 147 |
- 測試所有功能是否正常
|
| 148 |
- 確認 API、UI、資料庫連線正常
|
| 149 |
|
| 150 |
+
#### Step 5: 測試通過,合併到 main 並發布
|
| 151 |
```bash
|
| 152 |
# 切換到 main 分支
|
| 153 |
git checkout main
|
|
|
|
| 156 |
git merge develop
|
| 157 |
|
| 158 |
# 推送到正式環境和 GitHub
|
| 159 |
+
git push origin main && git push github main
|
|
|
|
|
|
|
| 160 |
|
| 161 |
+
# 回到 develop 繼續開發
|
|
|
|
| 162 |
git checkout develop
|
| 163 |
```
|
| 164 |
|
| 165 |
+
### Claude Code 開發流程(請 Claude 協助時)
|
| 166 |
+
|
| 167 |
+
當使用 Claude Code 進行開發時,完成功能後請 Claude 執行:
|
| 168 |
+
|
| 169 |
+
```
|
| 170 |
+
請幫我提交變更並部署到測試環境
|
| 171 |
+
```
|
| 172 |
+
|
| 173 |
+
Claude 會執行:
|
| 174 |
+
1. `git add` - 加入變更檔案
|
| 175 |
+
2. `git commit -m "功能描述"` - 提交(不含 AI 資訊)
|
| 176 |
+
3. `git push github develop` - 推送到 GitHub
|
| 177 |
+
4. `git push test develop:main` - 部署到測試環境
|
| 178 |
+
|
| 179 |
+
測試通過後,請 Claude 執行:
|
| 180 |
+
```
|
| 181 |
+
測試通過,請幫我發布到正式環境
|
| 182 |
+
```
|
| 183 |
+
|
| 184 |
+
Claude 會執行:
|
| 185 |
+
1. `git checkout main` - 切換到 main
|
| 186 |
+
2. `git merge develop` - 合併 develop
|
| 187 |
+
3. `git push origin main && git push github main` - 推送正式環境
|
| 188 |
+
4. `git checkout develop` - 回到開發分支
|
| 189 |
+
|
| 190 |
### 快速指令參考
|
| 191 |
|
| 192 |
```bash
|