Align model card with AAP-SQL GitHub workflow

README.md

@@ -11,39 +11,41 @@ tags:
 - aap-sql
 ---
 
-# AAP-SQL E2 column retriever
+# AAP-SQL column retriever
 
-AAP-SQL E2 是完整 AAP-SQL 設定中的雙編碼欄位檢索器。它先從資料庫 schema 中取回 50 個候選欄位，再交給 R1 cross-encoder 重排。
+AAP-SQL 欄位檢索器是完整 AAP-SQL 設定中的雙編碼模型。它從完整資料庫結構與欄位描述中召回最多 50 個候選欄位，供後續重排序器選出核心欄位。
 
-AAP-SQL E2 is the bi-encoder column retriever used by the full AAP-SQL configuration. It retrieves 50 schema-column candidates before the R1 cross-encoder reranks them.
+AAP-SQL column retriever is the bi-encoder used in the full AAP-SQL workflow. It performs the first stage of schema retrieval and returns up to 50 candidate columns for candidate reranking.
 
 ## Model details
 
-- Base model: `sentence-transformers/all-mpnet-base-v2`
-- Training objective: `MultipleNegativesRankingLoss`
-- Training seed: `42`
+- Base model: sentence-transformers/all-mpnet-base-v2
+- Training objective: MultipleNegativesRankingLoss
+- Training seed: 42
 - Training data: column-retrieval examples derived from the BIRD training split and schema descriptions
-- Expected library: `sentence-transformers>=5.1.2`
+- Expected library: sentence-transformers>=5.1.2
+
+## AAP-SQL publication branch
+
+The complete AAP-SQL workflow, research method terminology, BIRD directory layout, and reproduction instructions are maintained in the [GitHub publication branch](https://github.com/Tommyweige/AAP-SQL/tree/codex/final-aap-sql-experiment/AAP-SQL-Original).
 
 ## Use with AAP-SQL
 
 Download this repository into the path expected by the final runner:
 
-```powershell
-hf download TommyPanLab/AAP-SQL-E2 --local-dir models/column_retriever_v3_paper_earlystop
-```
+~~~powershell
+hf download TommyPanLab/AAP-SQL-Column-Retriever --local-dir models/column_retriever_v3_paper_earlystop
+~~~
 
 Direct loading:
 
-```python
+~~~python
 from sentence_transformers import SentenceTransformer
 
-model = SentenceTransformer("TommyPanLab/AAP-SQL-E2")
+model = SentenceTransformer("TommyPanLab/AAP-SQL-Column-Retriever")
 embeddings = model.encode(["table.column: column description"])
-```
-
-The complete pipeline, required BIRD directory layout, and Gemini 3.1 result are documented in the [AAP-SQL publication branch](https://github.com/Tommyweige/AAP-SQL/tree/codex/final-aap-sql-experiment/AAP-SQL-Original).
+~~~
 
 ## Data and license notice
 
-The training examples were derived from the BIRD benchmark. Review the [BIRD project terms](https://bird-bench.github.io/) before using the model. No additional license has been declared for these fine-tuned weights; the upstream model and dataset terms still apply.
+The training examples were derived from the BIRD benchmark. Review the [BIRD project terms](https://bird-bench.github.io/) before using the model. No additional license has been declared for these fine-tuned weights; the upstream model and dataset terms still apply.