diff --git a/docs_v1.0/API_V1.0.0/INTERNAL/VECTOR_SPEC_V1.0.0.md b/docs_v1.0/API_V1.0.0/INTERNAL/VECTOR_SPEC_V1.0.0.md index 7aea8b9..b77c5b6 100644 --- a/docs_v1.0/API_V1.0.0/INTERNAL/VECTOR_SPEC_V1.0.0.md +++ b/docs_v1.0/API_V1.0.0/INTERNAL/VECTOR_SPEC_V1.0.0.md @@ -41,6 +41,50 @@ related_documents: | 建立時間 | 2026-05-02 | | 文件版本 | V1.0 | +## Collection 命名隔離原則 + +不同機器、不同環境的向量資料**完全隔離**,命名格式: + +``` +{machine}_{env}_{type} +``` + +| 機器 | 環境 | prefix | 用途 | +|------|------|--------|------| +| M5 | dev | `m5_dev_` | M5 開發測試 | +| M5 | prod | `m5_prod_` | M5 正式(未來) | +| M4 | dev | `m4_dev_` | M4 開發測試 | +| M4 | prod | `m4_prod_` | M4 正式 | + +### 完整 Collection 列表 + +| 名稱 | 機器 | 維度 | 用途 | +|------|------|------|------| +| `m5_dev_rule1` | M5 | 768D | Sentence chunks | +| `m5_dev_face` | M5 | 512D | Face embeddings | +| `m5_dev_voice` | M5 | 192D | Voice embeddings(未來) | +| `m4_dev_rule1` | M4 | 768D | Sentence chunks | +| `m4_dev_face` | M4 | 512D | Face embeddings | +| `m4_prod_rule1` | M4 | 768D | 正式環境 sentence | +| `m4_prod_face` | M4 | 512D | 正式環境 face | + +### 設定方式 + +透過 `.env.development` 控制: + +```bash +# M5 dev +QDRANT_COLLECTION=m5_dev_rule1 + +# M4 dev +QDRANT_COLLECTION=m4_dev_rule1 + +# M4 prod +QDRANT_COLLECTION=m4_prod_rule1 +``` + +Face/voice collection 也遵循同樣規則(`m5_dev_face`、`m4_prod_face` 等)。 + ## 關鍵術語定義 | 術語 | 定義 |