SuperAPI AI 工具集

vector-db-cleanup

通用与其它

查看项目

更新于 10-16 08:00

技能介绍

用途:当源文件已被删除或重命名时,从 ChromaDB 向量库中移除过时和孤立的文本块,避免检索到已不存在的文件内容。

主要能力:按 profile(语义空间)执行清理;提供一致性检查脚本,用于清理后验证存储完整性与索引一致性。

使用方式:默认 wiki profile 的进程内清理命令为 python3 scripts/cleanup.py --profile wiki。流程为先在 .agent/learning/vector_profiles.json 中确认活动 profile(默认 wiki),再带必填 --profile 参数运行 scripts/cleanup.py,最后报告被清理的 profile 与移除的块总数。验证命令为 python3 scripts/vector_consistency_check.py --profile wiki --topic .agent/learning/。

限制与约束:必须指定目标 --profile,避免误剪其他语义空间;禁止直接操作 SQLite 文件,只能通过 scripts/cleanup.py 执行;需报告所清理的 profile 和删除的块数量。具体依赖环境、支持的 ChromaDB 版本、失败处理方式与更多参数暂未提供。