122 lines
1.9 KiB
Markdown
122 lines
1.9 KiB
Markdown
|
# Cursor 開發最高準則（Nuxt 4 · Gemini Direct）
|
|||
|
|
|
|||
|
|
## 1. 前提
|
|||
|
|
- 專案已存在
|
|||
|
|
- 使用 Nuxt 4
|
|||
|
|
- 使用真實 Gemini API
|
|||
|
|
- Token 由使用者於設定頁輸入
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 2. Dependency 規則
|
|||
|
|
|
|||
|
|
### 規劃階段
|
|||
|
|
- 允許討論是否需要新增 dependency
|
|||
|
|
- 需說明必要性與替代方案
|
|||
|
|
|
|||
|
|
### 實作階段（預設）
|
|||
|
|
- ❌ 不新增任何 dependency
|
|||
|
|
- ❌ 不安裝任何套件
|
|||
|
|
- ❌ 不隱性引入 library
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 3. Component 拆解原則（Token 最小化）
|
|||
|
|
|
|||
|
|
只允許三層：
|
|||
|
|
|
|||
|
|
### Base
|
|||
|
|
- BaseButton
|
|||
|
|
- BaseInput
|
|||
|
|
- BaseTextarea
|
|||
|
|
- BaseCard
|
|||
|
|
|
|||
|
|
### Feature
|
|||
|
|
- ToolCard
|
|||
|
|
- SceneCard
|
|||
|
|
- CameraShotCard
|
|||
|
|
|
|||
|
|
### Page
|
|||
|
|
- pages/*.vue
|
|||
|
|
- 僅組合元件與呼叫 composable
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 4. 拆 component 的唯一判斷
|
|||
|
|
是否會被兩個以上頁面重用：
|
|||
|
|
- 是 → 拆
|
|||
|
|
- 否 → 留在頁面
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 5. AI 呼叫規則
|
|||
|
|
|
|||
|
|
- UI 不得直接呼叫 Gemini
|
|||
|
|
- UI 只呼叫 composable
|
|||
|
|
- Prompt 組裝只存在於 utils/ai
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 6. AI Provider 架構
|
|||
|
|
|
|||
|
|
### Interface（/types/ai.ts）
|
|||
|
|
|
|||
|
|
```ts
|
|||
|
|
export interface AIProvider {
|
|||
|
|
generateStoryboard(input: unknown): Promise<string>
|
|||
|
|
analyzeCamera(input: unknown): Promise<string>
|
|||
|
|
generateVideoPlan(input: unknown): Promise<string>
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Gemini Client
|
|||
|
|
- 從 localStorage 讀取 token
|
|||
|
|
- 單一責任：呼叫 API
|
|||
|
|
|
|||
|
|
### Grok Client
|
|||
|
|
- 與 Gemini 相同介面
|
|||
|
|
- 預設不啟用
|
|||
|
|
|
|||
|
|
### Provider Selector
|
|||
|
|
- 依設定頁選擇 provider
|
|||
|
|
- 預設 Gemini
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 7. 鏡頭語言處理規則
|
|||
|
|
|
|||
|
|
- 不 hardcode 鏡頭語言
|
|||
|
|
- 不寫 enum
|
|||
|
|
- 不驗證 AI 選擇是否合理
|
|||
|
|
- UI 僅顯示結構化結果
|
|||
|
|
|
|||
|
|
建議結構：
|
|||
|
|
|
|||
|
|
```ts
|
|||
|
|
{
|
|||
|
|
shot: string
|
|||
|
|
movement: string
|
|||
|
|
composition: string
|
|||
|
|
lighting: string
|
|||
|
|
description: string
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 8. Cursor 輸出限制
|
|||
|
|
|
|||
|
|
- 一次只產生一個檔案
|
|||
|
|
- 不跨檔案修改
|
|||
|
|
- 不自動優化
|
|||
|
|
- 不補未使用功能
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 9. 開發順序（不可跳）
|
|||
|
|
1. Settings Page
|
|||
|
|
2. Gemini Client
|
|||
|
|
3. Provider Selector
|
|||
|
|
4. AI 分鏡表
|
|||
|
|
5. 其他工具頁
|