C✳CODEZ.WIN
🌐 简体中文

Skill 多语言阅读指南

train-sentence-transformers用途、用法与原始来源

训练或微调句子转换器模型SentenceTransformer(双编码器、用于检索、相似性、聚类、分类、释义挖掘、去重、多模态的密集或静态嵌入模型)CrossEncoder(重排序器,两阶段检索/配对分类的配对评分)SparseEncoder(SPLADE,用于学习稀疏检索的稀疏嵌入模型),以及MultiVectorEncoder(ColBERT / 后期交互,使用 MaxSim 评分的逐词嵌入)。涵盖损失选择、难负样本挖掘​​、评估器、蒸馏、LoRA、Matryoshka 和 Hugging Face Hub 发布。适用于任何句子转换器训练任务。

原文采集时间:

来源仓库
huggingface/skills
SKILL.md
skills/train-sentence-transformers/SKILL.md
仓库 Star
11,241
仓库最近更新
2026/10/30
能力分类
开发
最近采集时间

许可:Apache-2.0

流程片段用于帮助阅读上游说明。本页没有执行第三方 Skill,不属于实测评测。

下面的用途和操作片段来自上游文档,由本站整理并翻译,和另行标注的 Codez 编辑分析分开展示。

这个 Skill 能做什么

训练或微调句子转换器模型SentenceTransformer(双编码器、用于检索、相似性、聚类、分类、释义挖掘、去重、多模态的密集或静态嵌入模型)CrossEncoder(重排序器,两阶段检索/配对分类的配对评分)SparseEncoder(SPLADE,用于学习稀疏检索的稀疏嵌入模型),以及MultiVectorEncoder(ColBERT / 后期交互,使用 MaxSim 评分的逐词嵌入)。涵盖损失选择、难负样本挖掘​​、评估器、蒸馏、LoRA、Matryoshka 和 Hugging Face Hub 发布。适用于任何句子转换器训练任务。

如何使用:上游操作流程

5工作流程

确定模型类型(§)1)。如有歧义,请询问。加载 §2该类型书籍的必读文件。打开scripts/train__example.py并将其复制作为你的起始点。替换MODEL_NAME,DATASET_NAME,RUN_NAME损失,以及评估者与用户任务之间的关系。交叉检查loss/data-shape对阵references/losses_.md交叉核对metric_for_best_model关键在于references/evaluators_.md(指定评估者将密钥格式化为)eval_{name}_{primary_metric})。

原文片段 · L90 ↗

训练句子转换器模型

这SKILL.md这是一个路由,而不是一份手册。它会告诉你应该为你的任务加载哪些参考资料和示例脚本。实际内容(推荐的损失函数、评估器、训练脚本结构、模型选择、训练参数设置、故障排除)位于 [此处应填写具体位置]。references/和scripts/不要仅凭此文件合成训练脚本。打开按类型划分的生产模板(scripts/train__example.py)并将其复制作为你的起点。这些模板包含承载功能的脚手架(自动转换助手、模型卡类、日志记录器静默列表、force=True,seed,TF32(版本兼容的导入、命名评估器指标处理)之前的代理运行在从合成代码片段自行构建时反复错过的功能。

原文片段 · L6 ↗

1确定模型类型

当请求不明确时,可使用以下方法: “嵌入模型” / “向量搜索” / “相似度” → [SentenceTransformer]。 “重排序” / “排序器” / “两阶段” → [CrossEncoder]。 “SPLADE” / “稀疏” / “倒排索引” → [SparseEncoder]。 “ColBERT” / “后期交互” / “多向量” / “MaxSim” / “ColPali” / “ColQwen” → [MultiVectorEncoder]。 如果仍有疑问,请咨询。

原文片段 · L12 ↗

环境与依赖

先决条件

强烈建议使用GPU。CPU仅适用于演示。[SentenceTransformer] StaticEmbedding。

原文片段 · L100 ↗
原文片段 · bash ↗
pip install "sentence-transformers[train]>=5.0"        # add [train,image] / [audio] / [video] for [SentenceTransformer] multimodal
                                                       # [MultiVectorEncoder] requires >=6.0
pip install trackio                                    # optional tracker (or wandb / tensorboard / mlflow)
hf auth login                                          # or set HF_TOKEN with write scope (for Hub push)

限制与结果检查

4生成的脚本必须满足的约束条件

这些是不可协商的合同。实施方案已包含在生产模板和参考资料中。请勿重复发明轮子。请记录培训前评估员的评分。baseline_eval前trainer.train()。

原文片段 · L76 ↗

开始使用前

  1. 先核对支持的 Agent 宿主和仓库安装说明。保留完整 Skill 目录及其引用的脚本、资源和文档,只复制 SKILL.md 可能漏掉依赖。
  2. 向 Agent 提供实际输入、期望输出和验收标准。调用方式与可用工具取决于宿主环境,本站不假定存在通用的安装命令。
  3. 先在临时项目或输入副本上试用。涉及修改文件、远程服务或计费资源的操作,应逐项核对后再授权。
  4. 按照原文检查项和自己的需求验证输出。成功触发或仓库 Star 较高,都不能证明结果正确。

Skill 文件与目录格式规范 ↗

继续阅读原始文档

翻译与介绍范围

本页从固定版本的上游 SKILL.md 整理用途与操作片段,译文使用辅助翻译。它不是完整手册,也不代表经过兼容性实测;使用前请核对原文及其引用文件。

介绍依据下方列出的固定版本;当前仓库动态和目录采集时间单独展示。

固定版本来源
阅读原文 ↗
原文采集时间
来源提交版本
fabc634a893f62ad5c2039830397efa35fa62715
原文 SHA-256
9bd098d81049fc245032ee4f97cf5d9de906d726731ace4a6df0bad6d9dcd182
返回完整 Skill 目录