DeepSeek Harness Hub
← 返回列表

向量库删除验证PerryLink/RAG-Purge-Verify

DeepSeek Harnessspec-screened在 GitHub 查看 ↗
未验证

核查向量库中用户数据是否彻底清除

尚未跑自动兼容性验证,可查看页面内的依赖与入口分析。 · 最近上游提交 2026/8/22 · 已提供中文文档

验证GDPR请求后从向量数据库中完整删除用户数据。虽然SQL记录很容易删除,但嵌入可能保留PII。此工具对ChromaDB和Qdrant执行元数据和有效负载文本检查,显示可视化的PASSED/FAILED结果。使用Python、Typer和Rich构建,以实现直观的CLI验证。

综合分
28.2
GitHub 分
28.2
用户评分
★ Stars
1
周下载量
安装插件(需先安装 dsh CLI 引擎:npm install -g @deepseek-ai/dsh)
dsh plugin --profile web add PerryLink/RAG-Purge-Verify
该插件未发布到 npm,走 GitHub 源安装(pnpm 若拦截 prepare 脚本,按其提示在 pnpm-workspace.yaml 的 allowBuilds 中放行后重跑)
数据截至 2026/9/16(元数据每日更新 · 实装验证按队列轮转,单条结论的验证时间见上方)
用户评分
还没有人投票,来当第一个
订阅周报,不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动

README

RAG-Purge-Verify

用于验证用户数据是否已从 RAG 系统的向量数据库中彻底删除的 GDPR 合规工具。

已移植到 dsh-library —— PerryLink DSH 插件家族的一员。

License

English · 简体中文

功能简介

当用户行使 GDPR「被遗忘权」时,仅从关系数据库中删除记录是不够的——向量数据库中的嵌入数据仍可能残留其信息。RAG-Purge-Verify 会检查向量数据库中是否残留用户数据,并给出 PASSED 或 FAILED 结论,让「我们删除了数据」变成「我们能证明数据已删除」。

功能特性

- 两种验证模式:
- 元数据检查——按用户 ID 检索
- Payload 文本检查——在文档内容中搜索 PII
- 支持 ChromaDB 与 Qdrant
- 雷达扫描动画与 PASSED / FAILED 结果盖章及残留报告
- 列出可用集合

快速开始

需要 Python 3.9+。

git clone https://github.com/PerryLink/RAG-Purge-Verify.git
cd RAG-Purge-Verify
pip install -e .

使用方法

每次检查需提供 --user-id(元数据检查)或 --text(Payload 检查)之一。

ChromaDB——检查元数据中是否残留用户 ID
rag-verify chroma --collection user_docs --user-id user_123

ChromaDB——在文档内容中搜索 PII
rag-verify chroma --collection chat_history --text "alice@example.com"

ChromaDB——指定持久化路径
rag-verify chroma --collection user_docs --path ./chroma_db --user-id user_123

Qdrant——检查远程服务器
rag-verify qdrant --collection user_docs --host localhost --port 6333 --user-id user_123

列出集合
rag-verify list-collections chroma
rag-verify list-collections qdrant --host localhost --port 6333

典型场景

收到 GDPR 删除请求后,先删除用户记录,再确认无任何残留:

rag-verify chroma --collection user_embeddings --user-id user_12345

绿色 PASSED 盖章表示未发现残留数据。

检测可能仍残留在文档内容中的 PII:

rag-verify qdrant --collection support_tickets --text "customer@example.com"

若发现残留,会显示红色 FAILED 警报并列出详情。

注意事项

- 性能 —— 适用于中小规模数据集;大规模数据集可能需要较长时间。
- 准确性 —— 文本搜索基于简单的字符串匹配,可能产生误报或漏报。
- 安全性 —— 本工具仅做验证,绝不删除任何数据。

基于 Typer、Rich、chromadb、qdrant-client 与 pydantic 构建。

开发

pip install -e ".[dev]"
pytest tests/

可使用 docker-compose up -d 启动本地 Qdrant 测试实例。

相关项目

- dsh-library —— 本工具已移植进的 DSH 插件
- PerryLink —— PerryLink DSH 插件家族

许可证

Apache License 2.0 © 2026 PerryLink

上游仓库有新提交时邮件通知你(每天最多一封,无更新不打扰),随时一键退订。

💬 加入 DPharness 群聊

插件用法、部署报错、新插件第一时间同步——群里问,比一个人翻文档快。

点击加入 QQ 群
DPharness 群聊二维码,手机 QQ 扫码进群
扫码进群