项目名称和部署路径修改

tangwang
1 parent 1589c4f8
Showing 50 changed files with 202 additions and 135 deletions Show diff stats
.cursor/plans/es-query-25a9f060.plan.检索表达式优化.ES_function表达式.md
.cursor/plans/es-query-25a9f060.plan.检索表达式优化.ES_function表达式.基于ES_fuction_score原生能力优化.md
.github/workflows/test.yml
CHANGES.md
CLAUDE.md
CLIP_SERVICE_README.md
README.md
activate.sh
api/indexer_app.py
config/env_config.py
data/wanbang/README.md
data/wanbang/使用说明.md
docs/CNCLIP_SERVICE说明文档.md
docs/ES/ES_9
docs/Usage-Guide.md
docs/向量化模块和API说明文档.md
docs/测试Pipeline说明.md
docs/环境配置说明.md
docs/翻译模块说明.md
embeddings/CLOUD_EMBEDDING_README.md
@@ -48,7 +48,7 @@
  
 ### 2. 文件修改清单
  
-#### `/home/tw/SearchEngine/search/multilang_query_builder.py`
+#### `/home/tw/saas-search/search/multilang_query_builder.py`
  
 **修改 `build_multilang_query` 方法**（约156-190行）：
  
@@ -165,9 +165,9 @@ def _build_score_functions(self) -&gt; List[Dict[str, Any]]:
     return functions
 ```
  
-#### `/home/tw/SearchEngine/search/ranking_engine.py` 
+#### `/home/tw/saas-search/search/ranking_engine.py` 
  
-**重命名为** `/home/tw/SearchEngine/search/rerank_engine.py`
+**重命名为** `/home/tw/saas-search/search/rerank_engine.py`
  
 **修改类名和文档**：
  
@@ -194,7 +194,7 @@ class RerankEngine:
             self.parsed_terms = self._parse_expression(ranking_expression)
 ```
  
-#### `/home/tw/SearchEngine/search/__init__.py`
+#### `/home/tw/saas-search/search/__init__.py`
  
 更新导入：
  
@@ -202,7 +202,7 @@ class RerankEngine:
 from .rerank_engine import RerankEngine  # 原 RankingEngine
 ```
  
-#### `/home/tw/SearchEngine/search/searcher.py`
+#### `/home/tw/saas-search/search/searcher.py`
  
 **修改初始化**（约88行）：
  
@@ -245,7 +245,7 @@ if enable_rerank and self.rerank_engine.enabled:
     )
 ```
  
-#### `/home/tw/SearchEngine/config/schema/tenant1/config.yaml`
+#### `/home/tw/saas-search/config/schema/tenant1/config.yaml`
  
 **添加配置项**（254行后）：
  
@@ -274,7 +274,7 @@ function_score:
       weight: 1.1
 ```
  
-#### `/home/tw/SearchEngine/config/tenant_config.py`
+#### `/home/tw/saas-search/config/tenant_config.py`
  
 **更新配置类**：
  
@@ -30,7 +30,7 @@
  
 ## 配置设计（简化版）
  
-### `/home/tw/SearchEngine/config/schema/tenant1/config.yaml`
+### `/home/tw/saas-search/config/schema/tenant1/config.yaml`
  
 ```yaml
 # Function Score配置（ES层打分规则）
@@ -131,7 +131,7 @@ rerank:
  
 ### 1. 定义配置模型
  
-**文件**: `/home/tw/SearchEngine/config/models.py`（新建或更新tenant_config.py）
+**文件**: `/home/tw/saas-search/config/models.py`（新建或更新tenant_config.py）
  
 ```python
 from dataclasses import dataclass, field
@@ -186,7 +186,7 @@ class RerankConfig:
  
 ### 2. 修改 MultiLanguageQueryBuilder
  
-**文件**: `/home/tw/SearchEngine/search/multilang_query_builder.py`
+**文件**: `/home/tw/saas-search/search/multilang_query_builder.py`
  
 **修改 init 方法**：
  
@@ -276,13 +276,13 @@ if fs_config and fs_config.max_boost:
  
 ### 3. 更新配置加载器
  
-**文件**: `/home/tw/SearchEngine/config/__init__.py` 或 `config/loader.py`
+**文件**: `/home/tw/saas-search/config/__init__.py` 或 `config/loader.py`
  
 确保正确加载 `function_score` 和 `rerank` 配置段
  
 ### 4. 更新示例配置
  
-**文件**: `/home/tw/SearchEngine/config/schema/tenant1/config.yaml`
+**文件**: `/home/tw/saas-search/config/schema/tenant1/config.yaml`
  
 在 `ranking` 配置后添加新配置（参见上面完整YAML）
  
-name: SearchEngine Test Pipeline
+name: saas-search Test Pipeline
  
 on:
   push:
@@ -4,7 +4,7 @@
 2025-12-05
  
 ## 🎯 更新目标
-为 SearchEngine 项目添加基于阿里云 DashScope API 的云端文本向量化功能。
+为 saas-search 项目添加基于阿里云 DashScope API 的云端文本向量化功能。
  
 ## 📝 新增文件
  
@@ -23,11 +23,12 @@ This is a **production-ready Multi-Tenant E-Commerce Search SaaS** platform spec
  
 ## Development Environment
  
-**Required Environment Setup:**
+**Required Environment Setup:** Use project root `activate.sh` (activates conda env `searchengine` and loads `.env`). On a new machine, set `CONDA_ROOT` if conda is not at default path.
 ```bash
-source /home/tw/miniconda3/etc/profile.d/conda.sh
-conda activate searchengine
+# Optional on new machine: if conda is ~/anaconda3/bin/conda → export CONDA_ROOT=$HOME/anaconda3
+source activate.sh
 ```
+See `docs/环境配置说明.md` for first-time env creation (`conda env create -f environment.yml` or `pip install -r requirements.txt`).
  
 **Database Configuration:**
 ```yaml
@@ -48,11 +49,12 @@ password: P89cZHS5d7dFyc9R
  
 ### Environment Setup
 ```bash
-# Complete environment setup
-./setup.sh
+# Activate environment (canonical: use activate.sh)
+source activate.sh
  
-# Install Python dependencies
-pip install -r requirements.txt
+# First-time / new machine: create env and install deps
+./setup.sh   # or: conda env create -f environment.yml
+# If pip-only: pip install -r requirements.txt
 ```
  
 ### Data Management
@@ -109,7 +111,7 @@ python main.py search &quot;query&quot; --tenant-id 1 --size 10
  
 ### Core Components
 ```
-/data/tw/SearchEngine/
+/data/tw/saas-search/
 ├── api/              # FastAPI REST API service (port 6002)
 ├── config/           # Configuration management system
 ├── indexer/          # MySQL → Elasticsearch data pipeline
@@ -14,8 +14,9 @@
 推荐使用 Conda 新建一个专用环境（与本项目的 `searchengine` 环境隔离）：
  
 ```bash
-# 1）加载 conda
-source /home/tw/miniconda3/etc/profile.d/conda.sh
+# 1）加载 conda（你的 conda 是 ~/anaconda3/bin/conda → CONDA_ROOT=~/anaconda3）
+export CONDA_ROOT=${CONDA_ROOT:-$HOME/anaconda3}   # 或你的 Conda 安装路径
+source "$CONDA_ROOT/etc/profile.d/conda.sh"
  
 # 2）创建 clip 向量服务专用环境
 conda create -n clip_service python=3.9 -y
@@ -46,14 +47,14 @@ chmod +x scripts/stop_clip_service.sh
 ### 2.1 启动服务
  
 ```bash
-cd /home/tw/SearchEngine
+cd /data/saas-search
 ./scripts/start_clip_service.sh
 ```
  
 脚本行为：
  
-- 自动 `cd` 到仓库根目录 `/home/tw/SearchEngine`
-- 尝试加载 `/home/tw/miniconda3/etc/profile.d/conda.sh` 并激活 `clip_service` 环境
+- 自动 `cd` 到仓库根目录
+- 尝试加载 `$CONDA_ROOT/etc/profile.d/conda.sh` 并激活 `clip_service` 环境（可通过 `export CONDA_ROOT=...` 适配新机器）
 - 使用 `nohup python -m clip_server` 启动服务到后台
 - 将日志写入 `logs/clip_service.log`
 - 将进程号写入 `logs/clip_service.pid`
@@ -65,7 +66,7 @@ cd /home/tw/SearchEngine
 ### 2.2 停止服务
  
 ```bash
-cd /home/tw/SearchEngine
+cd /data/saas-search
 ./scripts/stop_clip_service.sh
 ```
  
@@ -101,7 +102,8 @@ cd /home/tw/SearchEngine
 1. 确认 `clip_service` 环境创建并安装成功：
  
    ```bash
-   source /home/tw/miniconda3/etc/profile.d/conda.sh
+   export CONDA_ROOT=${CONDA_ROOT:-$HOME/anaconda3}
+   source "$CONDA_ROOT/etc/profile.d/conda.sh"
    conda activate clip_service
    python -c "import jina; print('jina version:', jina.__version__)"
    ```
@@ -109,7 +111,7 @@ cd /home/tw/SearchEngine
 2. 启动服务并查看日志：
  
    ```bash
-   cd /home/tw/SearchEngine
+   cd /data/saas-search
    ./scripts/start_clip_service.sh
    tail -f logs/clip_service.log
    ```
@@ -100,16 +100,23 @@ localhost替换为
  
  
 ## 项目环境
-source /home/tw/miniconda3/etc/profile.d/conda.sh
-conda activate searchengine
-source .env
+
+以项目根目录的 **`activate.sh`** 为准（会激活 Conda 环境 `searchengine` 并加载 `.env`）：
+
+```bash
+# 若在新机器且 Conda 不在默认路径，先设置：
+# - 你的 conda 是 ~/anaconda3/bin/conda，则：export CONDA_ROOT=$HOME/anaconda3
+source activate.sh
+```
+
+新机器首次需创建环境，见 `docs/环境配置说明.md`（`conda env create -f environment.yml` 或 `pip install -r requirements.txt`）。
  
 ## 测试pipeline
  
 1. 
 店铺1  tenant_id=162：
 fake数据 生成商品导入数据 提交到店匠的店铺：
-cd /home/tw/SearchEngine && source /home/tw/miniconda3/etc/profile.d/conda.sh && conda activate searchengine && python scripts/csv_to_excel_multi_variant.py --output  with_colors.xlsx 
+cd /data/saas-search && source activate.sh && python scripts/csv_to_excel_multi_variant.py --output with_colors.xlsx
  
 店铺2  tenant_id= 
  
@@ -143,7 +150,7 @@ python scripts/recreate_and_import.py \
  
 | 步骤 | 去哪里看 | 摘要 |
 |------|---------|------|
-| 1. 准备环境 | `环境配置说明.md` / `Usage-Guide.md` | Conda/依赖、Elasticsearch、MySQL、必需变量 |
+| 1. 准备环境 | `docs/环境配置说明.md` / `Usage-Guide.md` | Conda、`activate.sh`、依赖、ES/MySQL、`.env` |
 | 2. 构造测试数据 | `测试数据指南.md` | Tenant1 Mock、Tenant2 CSV、`mock_data.sh` / `ingest.sh` |
 | 3. 启动与验证 | `Usage-Guide.md` | `run.sh` 一键启动、分步脚本、日志与健康检查 |
 | 4. 理解架构 | `系统设计文档.md` | 数据流、配置系统、查询/搜索/索引模块 |
@@ -155,8 +162,9 @@ python scripts/recreate_and_import.py \
 ### Runtimes & 命令示例
  
 ```bash
-# 1. 安装依赖与准备服务
-pip install -r requirements.txt                      # 详见 USAGE_GUIDE.md
+# 1. 安装依赖与准备服务（环境创建见 docs/环境配置说明.md）
+source activate.sh   # 或先 export CONDA_ROOT=你的conda路径
+pip install -r requirements.txt   # 若用 environment.yml 创建环境可省略
 docker run -d --name es -p 9200:9200 elasticsearch:8.11.0
  
 # 2. 构造测试数据并导入 MySQL
@@ -187,7 +195,7 @@ curl -X POST http://localhost:6002/search/ \
  
 | 文档 | 内容提要 | 适用场景 |
 |------|----------|----------|
-| `环境配置说明.md` | 系统要求、Conda/依赖、外部服务账号、常用端口 | 首次部署、环境核对 |
+| `docs/环境配置说明.md` | 系统要求、`activate.sh`、Conda/依赖、外部服务、CONDA_ROOT | 首次部署、新机器环境 |
 | `Usage-Guide.md` | 环境准备、服务启动、配置、日志、验证手册 | 日常运维、调试 |
 | `基础配置指南.md` | 统一硬编码配置说明、索引结构、查询配置 | 了解系统配置、修改配置 |
 | `测试数据指南.md` | 两个租户的模拟/CSV 数据构造 & MySQL→ES 流程 | 数据准备、联调 |
 #!/bin/bash
-source /home/tw/miniconda3/etc/profile.d/conda.sh
+# 新机器部署：可设置 CONDA_ROOT 指向本机 Conda 路径
+# 例如你的 conda 是 ~/anaconda3/bin/conda，则 export CONDA_ROOT=$HOME/anaconda3
+CONDA_ROOT="${CONDA_ROOT:-/home/tw/miniconda3}"
+source "$CONDA_ROOT/etc/profile.d/conda.sh"
 conda activate searchengine
  
 # 如果需要加载 .env 中的环境变量
@@ -140,7 +140,7 @@ def init_indexer_service(es_host: str = &quot;http://localhost:9200&quot;):
  
 app = FastAPI(
     title="E-Commerce Indexer API",
-    description="Dedicated indexing service for SearchEngine",
+    description="Dedicated indexing service for saas-search",
     version="1.0.0",
     docs_url="/docs",
     redoc_url="/redoc",
 """
-Centralized configuration management for SearchEngine.
+Centralized configuration management for saas-search.
  
 Loads configuration from environment variables and .env file.
 This module provides a single point for loading .env and setting defaults.
@@ -80,7 +80,7 @@ DB_CONFIG = {
 def print_config():
     """Print current configuration (with sensitive data masked)."""
     print("=" * 60)
-    print("SearchEngine Configuration")
+    print("saas-search Configuration")
     print("=" * 60)
  
     print("\nElasticsearch:")
@@ -37,7 +37,7 @@ pip install requests
 ### 2. 测试运行（推荐先测试）
  
 ```bash
-cd /home/tw/SearchEngine/data_crawling
+cd /home/tw/saas-search/data_crawling
 python test_crawler.py
 ```
  
@@ -177,7 +177,7 @@ cat shopee_results/summary.json
 #### 方法1：使用配置文件（推荐）
  
 ```bash
-cd /home/tw/SearchEngine/data_crawling
+cd /home/tw/saas-search/data_crawling
 cp config.example.py config.py
 # 编辑 config.py，填入你的API密钥
 ```
@@ -39,7 +39,7 @@ data_crawling/
 ### 1. 测试运行（推荐）
  
 ```bash
-cd /home/tw/SearchEngine/data_crawling
+cd /home/tw/saas-search/data_crawling
 python test_crawler.py
 ```
  
@@ -233,7 +233,7 @@ COUNTRY = &#39;.sg&#39;  # 改为新加坡站
 # 联系万邦API开通Shopee接口
  
 # 步骤2: 测试
-cd /home/tw/SearchEngine/data_crawling
+cd /home/tw/saas-search/data_crawling
 python test_crawler.py
  
 # 步骤3: 检查测试结果
@@ -170,7 +170,7 @@ print(result.shape)  # (3, 1024)
 ## 查看日志
  
 ```bash
-tail -f /data/tw/SearchEngine/logs/cnclip_service.log
+tail -f /data/tw/saas-search/logs/cnclip_service.log
 ```
  
 ## 常见问题
@@ -236,9 +236,9 @@ http://&lt;kibana-server-ip&gt;:5601
  
 ---
  
-### 9. 与现有 SearchEngine 项目集成
+### 9. 与现有 saas-search 项目集成
  
-在这台新机器上跑你的 SearchEngine 项目时：
+在这台新机器上跑你的 saas-search 项目时：
  
 - 环境变量或配置里的 ES 地址需要指向这台机器，例如：
   - `ES_HOST=http://127.0.0.1:9200`
-# 使用指南 - SearchEngine
+# 使用指南 - saas-search
  
 本文档提供完整的使用指南，包括环境准备、服务启动、配置说明、日志查看等。
  
@@ -25,13 +25,19 @@
  
 ### 安装依赖
  
-#### 1. 安装Python依赖
+#### 1. 安装 Python 依赖与激活环境
+
+**推荐**：使用项目根目录的 `activate.sh` 激活环境（会加载 `.env`）。新机器部署时若 Conda 不在默认路径，请先设置 `CONDA_ROOT`（例如你的 conda 是 `~/anaconda3/bin/conda`，则 `export CONDA_ROOT=$HOME/anaconda3`）。详见 `docs/环境配置说明.md`。
  
 ```bash
-cd /home/tw/SearchEngine
-pip install -r requirements.txt
+cd /data/saas-search
+source activate.sh
 ```
  
+首次在新机器创建环境时，可任选其一：
+- `conda env create -f environment.yml`（推荐，与 environment.yml 一致）
+- 或创建 env 后 `pip install -r requirements.txt`
+
 #### 2. 启动Elasticsearch
  
 **方式1: 使用Docker（推荐）**
@@ -91,7 +97,7 @@ API_PORT=6002
 ### 方式1: 一键启动（推荐）
  
 ```bash
-cd /home/tw/SearchEngine
+cd /data/saas-search
 ./run.sh
 ```
  
@@ -451,7 +457,7 @@ curl &quot;https://api.yourdomain.com/search/suggestions?q=iph&amp;size=5&amp;language=en&amp;wit
 #### UAT 环境（索引前缀 uat_）
  
 ```bash
-cd /home/tw/SearchEngine
+cd /data/saas-search
  
 # 1. 切换到 UAT 环境配置
 cp .env.uat .env
@@ -475,7 +481,7 @@ curl -X POST &quot;http://localhost:6004/indexer/reindex&quot; \
 #### PROD 环境（无前缀）
  
 ```bash
-cd /home/tw/SearchEngine
+cd /data/saas-search
  
 # 1. 切换到 PROD 环境配置
 cp .env.prod .env
 # 鍚戦噺鍖栨ā鍧楀拰API璇存槑鏂囨。
  
-鏈枃妗ｈ缁嗚鏄嶴earchEngine椤圭洰涓殑鍚戦噺鍖栨ā鍧楁灦鏋勩丄PI鎺ュ彛銆侀厤缃柟娉曞拰浣跨敤鎸囧崡銆
+鏈枃妗ｈ缁嗚鏄巗aas-search椤圭洰涓殑鍚戦噺鍖栨ā鍧楁灦鏋勩丄PI鎺ュ彛銆侀厤缃柟娉曞拰浣跨敤鎸囧崡銆
  
 ## 鐩綍
  
@@ -62,7 +62,7 @@
  
 ### 1.1 鍚戦噺鍖栨ā鍧楃畝浠
  
-SearchEngine椤圭洰瀹炵幇浜嗗畬鏁寸殑鏂囨湰鍜屽浘鐗囧悜閲忓寲鑳藉姏锛屾敮鎸佷袱绉嶉儴缃叉柟寮忥細
+saas-search椤圭洰瀹炵幇浜嗗畬鏁寸殑鏂囨湰鍜屽浘鐗囧悜閲忓寲鑳藉姏锛屾敮鎸佷袱绉嶉儴缃叉柟寮忥細
  
 1. **鏈湴鍚戦噺鍖栨湇鍔**锛氱嫭绔嬮儴缃茬殑寰湇鍔★紝鍩轰簬鏈湴GPU/CPU杩愯BGE-M3鍜孋N-CLIP妯″瀷
 2. **浜戠鍚戦噺鍖栨湇鍔**锛氶泦鎴愰樋閲屼簯DashScope API锛屾寜浣跨敤閲忎粯璐
@@ -117,7 +117,7 @@ SearchEngine椤圭洰瀹炵幇浜嗗畬鏁寸殑鏂囨湰鍜屽浘鐗囧悜閲忓寲鑳藉姏锛屾敮鎸佷袱绉
  
 ```
 鈹屸攢鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹
-鈹  SearchEngine Main Service          鈹
+鈹  saas-search Main Service          鈹
 鈹  (uses CloudTextEncoder)            鈹
 鈹斺攢鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹攢鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹鈹
                鈹
@@ -169,9 +169,10 @@ SearchEngine椤圭洰瀹炵幇浜嗗畬鏁寸殑鏂囨湰鍜屽浘鐗囧悜閲忓寲鑳藉姏锛屾敮鎸佷袱绉
 #### 鏂瑰紡2锛氭墜鍔ㄥ惎鍔
  
 ```bash
-# 婵娲荤幆澧
-source /home/tw/miniconda3/etc/profile.d/conda.sh
-conda activate searchengine
+# 婵娲荤幆澧冿紙鎺ㄨ崘浣跨敤椤圭洰鏍圭洰褰 activate.sh锛涙柊鏈哄櫒鎸夐渶 export CONDA_ROOT锛
+# 渚嬪浣犵殑 conda 鏄 ~/anaconda3/bin/conda锛屽垯 export CONDA_ROOT=$HOME/anaconda3
+cd /data/saas-search
+source activate.sh
  
 # 鍚姩鏈嶅姟
 python -m uvicorn embeddings.server:app \
@@ -1419,6 +1420,6 @@ python scripts/benchmark_embeddings.py
  
 濡傛湁闂鎴栧缓璁紝璇疯仈绯婚」鐩淮鎶よ呫
  
-**椤圭洰浠撳簱**: `/data/tw/SearchEngine`
+**椤圭洰浠撳簱**: `/data/saas-search`
  
 **鐩稿叧鏂囨。鐩綍**: `docs/`
@@ -152,7 +152,7 @@ pytest tests/integration/test_api_integration.py -v
 #### 5.1 启动 Indexer 服务
  
 ```bash
-cd /home/tw/SearchEngine
+cd /home/tw/saas-search
 ./scripts/stop.sh                  # 停掉已有进程（可选）
 ./scripts/start_indexer.sh         # 启动专用 indexer 服务，默认端口 6004
 ```
  
+## 1. 系统要求
  
+- **操作系统**：Linux（推荐 Ubuntu 18.04+）
+- **Conda**：Miniconda3 或 Anaconda（用于 Python 环境隔离）
+- **Python**：3.10（由 Conda 环境提供）
+- **内存**：建议 8GB+（含模型与 ES）
+- **磁盘**：10GB+（含模型与索引）
+
+---
  
 ## 2. Python 运行环境
  
+**推荐方式（与项目脚本一致）**：使用项目根目录下的 `activate.sh` 激活环境，会自动加载当前目录下的 `.env`（忽略注释与空行）：
+
 ```bash
-# 1. 激活 Conda
-source /home/tw/miniconda3/etc/profile.d/conda.sh
-conda activate searchengine
+cd /data/saas-search
+source activate.sh
+```
  
-# 如果部署到新机器，不存在 searchengine 环境时，需要初始化环境：
-cd /home/tw/SearchEngine
-pip install -r requirements.txt
+`activate.sh` 会激活 Conda 环境 `searchengine`。若在新机器上部署，请先设置本机 Conda 路径再执行：
+
+```bash
+# 你的 conda 在 ~/anaconda3/bin/conda，则 CONDA_ROOT=~/anaconda3
+export CONDA_ROOT=$HOME/anaconda3   # 或你的 Conda 安装路径（如 /home/ubuntu/anaconda3）
+source activate.sh
 ```
  
+**新机器首次部署（创建环境）**：若本机尚未创建 `searchengine` 环境，任选其一：
+
+- **方式 A（推荐，与 environment.yml 一致）**：
+  ```bash
+  cd /data/saas-search
+  export CONDA_ROOT=$HOME/anaconda3   # 或你的 Conda 安装路径
+  conda env create -f environment.yml
+  source activate.sh
+  ```
+- **方式 B（仅 pip）**：
+  ```bash
+  conda create -n searchengine python=3.10 -y
+  conda activate searchengine
+  cd /data/saas-search
+  pip install -r requirements.txt
+  ```
+
+之后日常使用执行 `source activate.sh` 即可（如需可先 `export CONDA_ROOT=...`）。
+
 ---
  
 ## 3. 外部服务与端口
@@ -83,7 +115,7 @@ API_PORT=6002
  
 ## 6. 店匠数据源说明
  
-SearchEngine 以 MySQL 中的店匠标准表为权威数据源：
+saas-search 以 MySQL 中的店匠标准表为权威数据源：
  
 - `shoplazza_product_spu`：SPU 商品主表
 - `shoplazza_product_sku`：SKU 变体表
@@ -114,10 +146,13 @@ SearchEngine 以 MySQL 中的店匠标准表为权威数据源：
  
 ## 7. 相关脚本
  
+- **`activate.sh`**（项目根目录）：激活 Conda 环境 `searchengine` 并加载 `.env`，**日常开发/部署以本脚本为准**。
 - `scripts/mock_data.sh`：一次性生成 Tenant1 Mock + Tenant2 CSV 数据并导入 MySQL
 - `scripts/ingest.sh <tenant_id> [recreate]`：从 MySQL 写入 Elasticsearch
-- `run.sh` / `restart.sh`：服务启动/重启
+- `run.sh` / `restart.sh`：服务启动/重启（内部会调用 `start_backend.sh` 等，同样使用 `CONDA_ROOT`）
+
+**新机器部署**：若 Conda 未安装在默认路径（如 `/home/tw/miniconda3`），请在执行上述脚本前设置 `CONDA_ROOT`。例如你的 conda 是 `~/anaconda3/bin/conda`（即 `/home/ubuntu/anaconda3/bin/conda`），则设置：`export CONDA_ROOT=$HOME/anaconda3`。可将该行写入 `~/.bashrc` 或部署说明。
  
-更多脚本参数、日志与验证命令参见 `USAGE_GUIDE.md` 与 `TEST_DATA_GUIDE.md`。
+更多脚本参数、日志与验证命令参见 `Usage-Guide.md` 与 `测试数据指南.md`。
  
  
@@ -51,14 +51,14 @@ TRANSLATION_MODEL=qwen  # 或 deepl
 推荐（热更新）：
  
 ```bash
-cd /home/tw/SearchEngine
+cd /home/tw/saas-search
 uvicorn api.translator_app:app --host 0.0.0.0 --port 6006 --reload
 ```
  
 指定默认模型（不传请求 `model` 时生效）：
  
 ```bash
-cd /home/tw/SearchEngine
+cd /home/tw/saas-search
 export TRANSLATION_MODEL=qwen   # 或 deepl
 uvicorn api.translator_app:app --host 0.0.0.0 --port 6006 --reload
 ```
@@ -2,7 +2,7 @@
  
 ## 📝 概述
  
-本次更新为 SearchEngine 项目添加了基于阿里云 DashScope API 的云端文本向量化功能，使用 `text-embedding-v4` 模型。
+本次更新为 saas-search 项目添加了基于阿里云 DashScope API 的云端文本向量化功能，使用 `text-embedding-v4` 模型。
  
 ## 🎯 主要功能
  
@@ -25,7 +25,7 @@
 ## 📁 文件结构
  
 ```
-SearchEngine/
+saas-search/
 ├── embeddings/
 │   ├── cloud_text_encoder.py          # 云端向量化编码器（新增）
 │   ├── text_encoder.py                # 本地编码器（现有）
@@ -19,7 +19,7 @@ from embeddings.clip_model import ClipImageModel
  
 logger = logging.getLogger(__name__)
  
-app = FastAPI(title="SearchEngine Embedding Service", version="1.0.0")
+app = FastAPI(title="saas-search Embedding Service", version="1.0.0")
  
 # Models are loaded at startup, not lazily
 _text_model: Optional[BgeTextModel] = None
@@ -77,7 +77,7 @@
  
 1. **启动后端服务**：
 ```bash
-cd /home/tw/SearchEngine
+cd /home/tw/saas-search
 bash scripts/start_backend.sh
 ```
  
@@ -194,7 +194,7 @@
     </div>
  
     <footer>
-        <p>SearchEngine © 2025 | API: <span id="apiUrl">Loading...</span></p>
+        <p>saas-search © 2025 | API: <span id="apiUrl">Loading...</span></p>
     </footer>
  
     <script src="/static/js/tenant_facets_config.js?v=1.3"></script>
-/* SearchEngine - Modern Clean UI */
+/* saas-search - Modern Clean UI */
  
 * {
     margin: 0;
-// SearchEngine Frontend - Modern UI (Multi-Tenant)
+// saas-search Frontend - Modern UI (Multi-Tenant)
  
 const API_BASE_URL = window.API_BASE_URL || 'http://localhost:6002';
 if (document.getElementById('apiUrl')) {
@@ -18,7 +18,7 @@
 - **Mapping 位置**：`mappings/search_products.json` 中的 `qanchors` 对象。
 - **结构**（与 `title.{lang}` 一致）：
  
-```140:182:/home/tw/SearchEngine/mappings/search_products.json
+```140:182:/home/tw/saas-search/mappings/search_products.json
 "qanchors": {
   "type": "object",
   "properties": {
@@ -48,7 +48,7 @@
 - **Mapping 位置**：`mappings/search_products.json`，追加的 nested 字段。
 - **结构**：
  
-```1392:1410:/home/tw/SearchEngine/mappings/search_products.json
+```1392:1410:/home/tw/saas-search/mappings/search_products.json
 "semantic_attributes": {
   "type": "nested",
   "properties": {
@@ -89,7 +89,7 @@
 - **文件**：`indexer/process_products.py`
 - **函数签名**：
  
-```365:392:/home/tw/SearchEngine/indexer/process_products.py
+```365:392:/home/tw/saas-search/indexer/process_products.py
 def analyze_products(
     products: List[Dict[str, str]],
     target_lang: str = "zh",
@@ -108,7 +108,7 @@ def analyze_products(
  
 - **支持的输出语言**（在同文件中定义）：
  
-```54:62:/home/tw/SearchEngine/indexer/process_products.py
+```54:62:/home/tw/saas-search/indexer/process_products.py
 LANG_LABELS: Dict[str, str] = {
     "zh": "中文",
     "en": "英文",
@@ -148,7 +148,7 @@ SUPPORTED_LANGS = set(LANG_LABELS.keys())
  
 - Prompt 中会明确要求“**所有输出内容使用目标语言**”，并给出中英文示例：
  
-```65:81:/home/tw/SearchEngine/indexer/process_products.py
+```65:81:/home/tw/saas-search/indexer/process_products.py
 def create_prompt(products: List[Dict[str, str]], target_lang: str = "zh") -> str:
     """创建LLM提示词（根据目标语言输出）"""
     lang_label = LANG_LABELS.get(target_lang, "对应语言")
@@ -170,7 +170,7 @@ def create_prompt(products: List[Dict[str, str]], target_lang: str = &quot;zh&quot;) -&gt; st
  
 - 返回格式固定为 Markdown 表格，首行头为：
  
-```89:91:/home/tw/SearchEngine/indexer/process_products.py
+```89:91:/home/tw/saas-search/indexer/process_products.py
 | 序号 | 商品标题 | 品类路径 | 细分标签 | 适用人群 | 使用场景 | 适用季节 | 关键属性 | 材质说明 | 功能特点 | 商品卖点 | 锚文本 |
 |----|----|----|----|----|----|----|----|----|----|----|----|
 ```
@@ -185,7 +185,7 @@ def create_prompt(products: List[Dict[str, str]], target_lang: str = &quot;zh&quot;) -&gt; st
  
 在 `SPUDocumentTransformer.transform_spu_to_doc(...)` 的末尾，在所有基础字段（多语言文本、类目、SKU/规格、价格、库存等）填充完成后，会调用：
  
-```96:101:/home/tw/SearchEngine/indexer/document_transformer.py
+```96:101:/home/tw/saas-search/indexer/document_transformer.py
         # 文本字段处理（翻译等）
         self._fill_text_fields(doc, spu_row, primary_lang)
  
@@ -206,7 +206,7 @@ def create_prompt(products: List[Dict[str, str]], target_lang: str = &quot;zh&quot;) -&gt; st
  
 在 `_fill_llm_attributes` 内部：
  
-```148:164:/home/tw/SearchEngine/indexer/document_transformer.py
+```148:164:/home/tw/saas-search/indexer/document_transformer.py
         try:
             index_langs = self.tenant_config.get("index_languages") or ["en", "zh"]
         except Exception:
@@ -232,7 +232,7 @@ def create_prompt(products: List[Dict[str, str]], target_lang: str = &quot;zh&quot;) -&gt; st
  
 核心逻辑（简化描述）：
  
-```164:210:/home/tw/SearchEngine/indexer/document_transformer.py
+```164:210:/home/tw/saas-search/indexer/document_transformer.py
         spu_id = str(spu_row.get("id") or "").strip()
         title = str(spu_row.get("title") or "").strip()
         if not spu_id or not title:
@@ -365,7 +365,7 @@ def create_prompt(products: List[Dict[str, str]], target_lang: str = &quot;zh&quot;) -&gt; st
  
 现有 `suggestion/builder.py` 已经支持从 `qanchors.{lang}` 中提取候选：
  
-```249:287:/home/tw/SearchEngine/suggestion/builder.py
+```249:287:/home/tw/saas-search/suggestion/builder.py
         # Step 1: product title/qanchors
         hits = self._scan_products(tenant_id, batch_size=batch_size)
         ...
@@ -7,7 +7,7 @@
   - 负责**商品/店铺/类目等基础数据同步**（写 MySQL）。
   - 负责**多租户环境下的全量/增量索引调度**，但不再关心具体 doc 字段细节。
  
-- **Python 索引富化模块（本项目 SearchEngine / indexer）**
+- **Python 索引富化模块（本项目 saas-search / indexer）**
   - 负责“**如何把 MySQL 基础数据变成符合 ES mapping 的 doc**”，包括：
     - 多语言字段组织；
     - 翻译调用与缓存；
 #!/usr/bin/env python3
 """
-Main entry point for SearchEngine operations.
+Main entry point for saas-search operations.
  
 Provides a unified CLI for common operations:
 - serve: Start API service (search + admin routes)
@@ -146,7 +146,7 @@ def cmd_build_suggestions(args):
 def main():
     """Main CLI entry point."""
     parser = argparse.ArgumentParser(
-        description='SearchEngine - E-Commerce Search SaaS',
+        description='saas-search - E-Commerce Search SaaS',
         formatter_class=argparse.RawDescriptionHelpFormatter
     )
  
-# Python dependencies for SearchEngine
+# Python dependencies for saas-search
  
 # Core
 pyyaml>=6.0
@@ -27,6 +27,8 @@ fastapi&gt;=0.100.0
 uvicorn[standard]>=0.23.0
 pydantic>=2.0.0
 python-multipart>=0.0.6
+slowapi>=0.1.9
+anyio>=3.7.0
  
 # Translation
 requests>=2.31.0
@@ -31,7 +31,7 @@ logging.basicConfig(
 )
 logger = logging.getLogger("reranker.service")
  
-app = FastAPI(title="SearchEngine Reranker Service", version="1.0.0")
+app = FastAPI(title="saas-search Reranker Service", version="1.0.0")
  
 _reranker: Optional[BGEReranker] = None
  
 #!/bin/bash
  
-# Restart script for SearchEngine services
+# Restart script for saas-search services
 # This script stops all services first, then starts them again
  
 cd "$(dirname "$0")"
@@ -11,7 +11,7 @@ RED=&#39;\033[0;31m&#39;
 NC='\033[0m'
  
 echo -e "${GREEN}========================================${NC}"
-echo -e "${GREEN}SearchEngine服务重启脚本${NC}"
+echo -e "${GREEN}saas-search服务重启脚本${NC}"
 echo -e "${GREEN}========================================${NC}"
  
 # Step 1: Stop all services
 #!/bin/bash
  
-# Production startup script for SearchEngine services
+# Production startup script for saas-search services
 # This script starts frontend and backend services (no data ingestion)
  
 cd "$(dirname "$0")"
@@ -11,7 +11,7 @@ RED=&#39;\033[0;31m&#39;
 NC='\033[0m'
  
 echo -e "${GREEN}========================================${NC}"
-echo -e "${GREEN}SearchEngine服务启动脚本${NC}"
+echo -e "${GREEN}saas-search服务启动脚本${NC}"
 echo -e "${GREEN}========================================${NC}"
  
 # Create logs directory if it doesn't exist
 #!/usr/bin/env python3
 """
-Simple HTTP server for SearchEngine frontend.
+Simple HTTP server for saas-search frontend.
 """
  
 import http.server
 #!/bin/bash
  
-# Unified data ingestion script for SearchEngine
+# Unified data ingestion script for saas-search
 # Ingests data from MySQL to Elasticsearch
  
 cd "$(dirname "$0")/.."
 #!/bin/bash
  
 # ============================================================================
-# Mock Data Script for SearchEngine
+# Mock Data Script for saas-search
 # ============================================================================
 # 
 # 功能说明：
@@ -20,7 +20,8 @@
 # ============================================================================
  
 cd "$(dirname "$0")/.."
-source /home/tw/miniconda3/etc/profile.d/conda.sh
+CONDA_ROOT="${CONDA_ROOT:-/home/tw/miniconda3}"
+source "$CONDA_ROOT/etc/profile.d/conda.sh"
 conda activate searchengine
  
 GREEN='\033[0;32m'
 #!/bin/bash
  
-# Unified startup script for SearchEngine services
+# Unified startup script for saas-search services
 # This script starts both frontend and backend services
  
 cd "$(dirname "$0")/.."
@@ -11,7 +11,7 @@ RED=&#39;\033[0;31m&#39;
 NC='\033[0m'
  
 echo -e "${GREEN}========================================${NC}"
-echo -e "${GREEN}SearchEngine服务启动脚本${NC}"
+echo -e "${GREEN}saas-search服务启动脚本${NC}"
 echo -e "${GREEN}========================================${NC}"
  
 # Create logs directory if it doesn't exist
@@ -5,7 +5,8 @@
 set -e
  
 cd "$(dirname "$0")/.."
-source /home/tw/miniconda3/etc/profile.d/conda.sh
+CONDA_ROOT="${CONDA_ROOT:-/home/tw/miniconda3}"
+source "$CONDA_ROOT/etc/profile.d/conda.sh"
 conda activate searchengine
  
 GREEN='\033[0;32m'
@@ -10,7 +10,7 @@ set -e
  
 cd "$(dirname "$0")/.."
  
-LOG_DIR="/home/tw/SearchEngine/logs"
+LOG_DIR="$(pwd)/logs"
 mkdir -p "${LOG_DIR}"
 PID_FILE="${LOG_DIR}/clip_service.pid"
 LOG_FILE="${LOG_DIR}/clip_service.log"
@@ -20,16 +20,17 @@ echo &quot;Starting CLIP vector service (clip-server)&quot;
 echo "========================================"
  
 # Load conda and activate dedicated environment, if available
-if [ -f "/home/tw/miniconda3/etc/profile.d/conda.sh" ]; then
+CONDA_ROOT="${CONDA_ROOT:-/home/tw/miniconda3}"
+if [ -f "$CONDA_ROOT/etc/profile.d/conda.sh" ]; then
   # shellcheck disable=SC1091
-  source /home/tw/miniconda3/etc/profile.d/conda.sh
+  source "$CONDA_ROOT/etc/profile.d/conda.sh"
   conda activate clip_service || {
     echo "Failed to activate conda env 'clip_service'. Please create it first." >&2
     echo "See CLIP_SERVICE_README.md for setup instructions." >&2
     exit 1
   }
 else
-  echo "Warning: /home/tw/miniconda3/etc/profile.d/conda.sh not found." >&2
+  echo "Warning: $CONDA_ROOT/etc/profile.d/conda.sh not found." >&2
   echo "Please activate the 'clip_service' environment manually before running this script." >&2
 fi
  
@@ -45,8 +45,8 @@ DEFAULT_MODEL_NAME=&quot;CN-CLIP/ViT-H-14&quot;
 # DEFAULT_MODEL_NAME="CN-CLIP/ViT-L-14-336"
 DEFAULT_REPLICAS=1  # 副本数
  
-# 项目路径
-PROJECT_ROOT="/data/tw/SearchEngine"
+# 项目路径（以仓库实际路径为准，避免写死 /data/tw/...）
+PROJECT_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
 CLIP_SERVER_DIR="${PROJECT_ROOT}/third-party/clip-as-service/server"
 LOG_DIR="${PROJECT_ROOT}/logs"
 PID_FILE="${LOG_DIR}/cnclip_service.pid"
@@ -180,12 +180,13 @@ if [ -z &quot;${CONDA_DEFAULT_ENV}&quot; ] || [ &quot;${CONDA_DEFAULT_ENV}&quot; != &quot;clip_service&quot; ]
     echo -e "${YELLOW}警告: 当前未激活 clip_service 环境${NC}"
     echo -e "${YELLOW}正在激活环境...${NC}"
  
-    if [ -f "/home/tw/miniconda3/etc/profile.d/conda.sh" ]; then
-        source "/home/tw/miniconda3/etc/profile.d/conda.sh"
+    CONDA_ROOT="${CONDA_ROOT:-/home/tw/miniconda3}"
+    if [ -f "$CONDA_ROOT/etc/profile.d/conda.sh" ]; then
+        source "$CONDA_ROOT/etc/profile.d/conda.sh"
         conda activate clip_service
         echo -e "${GREEN}✓ 环境已激活${NC}"
     else
-        echo -e "${RED}错误: 无法找到 conda 初始化脚本${NC}"
+        echo -e "${RED}错误: 无法找到 conda 初始化脚本: $CONDA_ROOT/etc/profile.d/conda.sh${NC}"
         exit 1
     fi
 else
@@ -13,8 +13,9 @@ set -e
 cd "$(dirname "$0")/.."
  
 # Load conda env if available (keep consistent with other scripts)
-if [ -f "/home/tw/miniconda3/etc/profile.d/conda.sh" ]; then
-  source /home/tw/miniconda3/etc/profile.d/conda.sh
+CONDA_ROOT="${CONDA_ROOT:-/home/tw/miniconda3}"
+if [ -f "$CONDA_ROOT/etc/profile.d/conda.sh" ]; then
+  source "$CONDA_ROOT/etc/profile.d/conda.sh"
   conda activate searchengine
 fi
  
@@ -5,7 +5,8 @@
 set -e
  
 cd "$(dirname "$0")/.."
-source /home/tw/miniconda3/etc/profile.d/conda.sh
+CONDA_ROOT="${CONDA_ROOT:-/home/tw/miniconda3}"
+source "$CONDA_ROOT/etc/profile.d/conda.sh"
 conda activate searchengine
  
 GREEN='\033[0;32m'
@@ -5,7 +5,8 @@
 set -e
  
 cd "$(dirname "$0")/.."
-source /home/tw/miniconda3/etc/profile.d/conda.sh
+CONDA_ROOT="${CONDA_ROOT:-/home/tw/miniconda3}"
+source "$CONDA_ROOT/etc/profile.d/conda.sh"
 conda activate searchengine
  
 GREEN='\033[0;32m'
@@ -178,12 +178,12 @@ def main():
     """Main function to start all servers."""
     global manager
  
-    parser = argparse.ArgumentParser(description='Start SearchEngine servers (multi-tenant)')
+    parser = argparse.ArgumentParser(description='Start saas-search servers (multi-tenant)')
     parser.add_argument('--es-host', default='http://localhost:9200', help='Elasticsearch host')
     parser.add_argument('--check-dependencies', action='store_true', help='Check dependencies before starting')
     args = parser.parse_args()
  
-    logger.info("Starting SearchEngine servers (multi-tenant)...")
+    logger.info("Starting saas-search servers (multi-tenant)...")
     logger.info(f"Elasticsearch: {args.es_host}")
  
     # Check dependencies if requested
@@ -4,7 +4,7 @@
 #
 set -e
  
-LOG_DIR="/home/tw/SearchEngine/logs"
+LOG_DIR="/home/tw/saas-search/logs"
 PID_FILE="${LOG_DIR}/clip_service.pid"
  
 echo "========================================"
@@ -21,7 +21,7 @@ BLUE=&#39;\033[0;34m&#39;
 NC='\033[0m' # No Color
  
 # 项目路径
-PROJECT_ROOT="/data/tw/SearchEngine"
+PROJECT_ROOT="/data/tw/saas-search"
 LOG_DIR="${PROJECT_ROOT}/logs"
 PID_FILE="${LOG_DIR}/cnclip_service.pid"
  
 # 激活环境
-source /home/tw/miniconda3/etc/profile.d/conda.sh
+CONDA_ROOT="${CONDA_ROOT:-/home/tw/miniconda3}"
+source "$CONDA_ROOT/etc/profile.d/conda.sh"
 conda activate searchengine
  
 # # 基本使用（生成所有数据）
 #!/bin/bash
  
-source /home/tw/miniconda3/etc/profile.d/conda.sh
+CONDA_ROOT="${CONDA_ROOT:-/home/tw/miniconda3}"
+source "$CONDA_ROOT/etc/profile.d/conda.sh"
  
-# SearchEngine Setup and Startup Script
+# saas-search Setup and Startup Script
 # This script sets up the environment and starts all services
  
 set -e  # Exit on error
@@ -14,7 +15,7 @@ YELLOW=&#39;\033[1;33m&#39;
 NC='\033[0m' # No Color
  
 echo -e "${GREEN}========================================${NC}"
-echo -e "${GREEN}SearchEngine Setup Script${NC}"
+echo -e "${GREEN}saas-search Setup Script${NC}"
 echo -e "${GREEN}========================================${NC}"
  
 # Change to project directory
@@ -28,9 +29,6 @@ if ! command -v conda &amp;&gt; /dev/null; then
     exit 1
 fi
  
-# Source conda
-source /home/tw/miniconda3/etc/profile.d/conda.sh
-
 # Check if environment exists
 if conda env list | grep -q "searchengine"; then
     echo -e "${GREEN}Environment 'searchengine' already exists${NC}"
 """
-SearchEngine测试模块
+saas-search测试模块
  
 提供完整的自动化测试流水线，包括：
 - 单元测试
 #!/bin/bash
  
-source /home/tw/miniconda3/etc/profile.d/conda.sh
+CONDA_ROOT="${CONDA_ROOT:-/home/tw/miniconda3}"
+source "$CONDA_ROOT/etc/profile.d/conda.sh"
 conda activate xinference
 if [ "$CONDA_DEFAULT_ENV" != "tw" ]; then
     echo "当前环境不是 tw，正在激活 tw 环境..."
-    source /home/tw/miniconda3/etc/profile.d/conda.sh
+    CONDA_ROOT="${CONDA_ROOT:-/home/tw/miniconda3}"
+    source "$CONDA_ROOT/etc/profile.d/conda.sh"
     conda activate tw
     echo "已激活 tw 环境"
 else