| name | embed |
| description | Use when building or refreshing the RagKit index for a project knowledge-base/ (e.g. after distill added or updated knowledge points). Trigger /ragkit:embed. Querying instead uses ragkit:query; index health uses ragkit:status. |
RagKit Embed
脚本在本插件的 scripts/ 目录(本 skill 目录的上两级);用本 skill 的 base directory 把下面的相对路径拼成绝对路径执行。
sh ../../scripts/run.sh ../../scripts/ragkit.py \
embed --kb <项目根>/knowledge-base
- 增量:默认只重嵌变更 chunk;模型/后端变更或索引损坏时加
--rebuild。
- 退出码 3 = 无向量后端:stdout 的 ╭─ RagKit ─╮ 提示块必须原样转述给用户(含安装命令与第三方配置方法,不要改写);此时词汇/元数据索引已建好,query 可降级使用。
- 首次装本地模型:
uv run ../../scripts/ragkit_local_embed.py install(约 1.2GB;国内先 export HF_ENDPOINT=https://hf-mirror.com)。
- 双后端并存时固定用本地(脚本内置优先级,无需选择)。