siphonclaw

🔍 多模态文档知识库检索引擎

基于 MCP 协议的文档智能管道,通过本地+云端混合架构实现低成本视觉语义检索,为工程师提供私有化知识库解决方案。

收藏
11k
安装
2.9k
版本
v1.2.0
CLS 安全性认证2026-05-03
点击查看完整报告 >

使用说明

SiphonClaw 是一款面向技术文档管理的 MCP 技能,旨在为现场服务工程师、研究人员及设备维护人员构建智能化的私有知识库。该技能通过文档摄取、多模态检索和视觉识别能力,将分散的 PDF、图像和电子表格转化为可快速检索的结构化知识资产。

核心用法
SiphonClaw 通过五个 MCP 工具构建完整的文档智能管道。siphonclaw_ingest 支持将 PDF、Excel、图像等文件摄入本地向量数据库,自动生成文本和视觉嵌入;siphonclaw_search 提供三重混合检索(BM25 关键词 + 语义向量 + 视觉页面嵌入),并基于 RRF 融合与交叉编码器重排序返回高置信度结果;siphonclaw_identify 允许用户上传设备照片,通过视觉模型识别后自动检索相关文档;siphonclaw_field_note 支持将现场维修记录保存为知识库条目,形成经验积累的闭环;siphonclaw_status 则提供系统健康度、模型可用性和成本追踪的监控能力。

显著优点
该技能最大的优势在于其混合架构设计。Mode A(本地+云端)模式下,利用 Ollama 本地运行嵌入和 OCR 模型实现零成本文档处理,仅将生成和推理任务发送至 OpenRouter,使月均成本控制在 $0.5-5,相比全云端模式节省数十倍费用。同时,三重混合检索机制显著提升了技术文档的召回准确率,特别是在处理包含复杂图表、零件照片和型号标签的工业场景时,视觉嵌入能有效弥补纯文本检索的不足。此外,系统提供复合置信度评分和脚注式引用,帮助用户验证答案可靠性。

潜在缺点与局限性
作为 T3 来源的个人开发者项目,其代码可信度和长期维护能力不及企业级产品。尽管 Skill 本身为纯文档,但实际功能依赖 pip 安装的 Python 包,用户需自行审计源码。本地模式要求约 10GB 磁盘空间和足够内存运行 Qwen3-VL 等模型,硬件门槛较高。配置过程涉及 Ollama、OpenRouter、Brave Search 等多个服务的 API 密钥管理,对非技术用户不够友好。此外,视觉检索效果依赖训练数据分布,对于极度专业的工业设备可能存在识别偏差。

适合的目标群体
该技能特别适合现场服务工程师、设备维修技师、工厂维护团队以及需要管理大量技术文档的研究人员。对于希望在局域网环境构建私有化知识库、避免敏感技术文档上传公有云的中小型企业,SiphonClaw 的本地化处理模式具有显著吸引力。同时,需要快速查询零件编号、维修手册和故障代码的技术人员也能从中获益。

使用风险
用户需注意 T3 来源带来的供应链风险,建议在生产环境使用前审查实际代码。API 密钥管理责任完全由用户承担,需通过环境变量安全配置,避免泄露。本地模式虽保障隐私,但大模型运行会显著消耗计算资源,可能影响其他业务系统性能。依赖的外部服务(如 OpenRouter)的可用性和定价策略变化可能影响服务连续性。此外,OCR 和视觉识别对低质量扫描件或复杂光照条件的照片可能存在识别误差,关键操作建议人工复核。

安全解读

核心用法

SiphonClaw 是一个领域无关的文档智能管道,专为现场服务工程师、研究人员和维修人员设计。它通过 triple hybrid retrieval(BM25关键词匹配 + 语义文本向量 + 视觉页面嵌入)将 PDF、图片和电子表格转化为可搜索的知识库。

五大 MCP 工具:

  • siphonclaw_search: 混合检索搜索,支持文本/视觉/关键词模式
  • siphonclaw_ingest: 文档摄取(PDF、Excel、图片),自动生成文本和视觉嵌入
  • siphonclaw_field_note: 保存现场维修记录作为可检索知识条目,形成学习闭环
  • siphonclaw_identify: 视觉识别设备/零件,自动搜索相关文档
  • siphonclaw_status: 管道健康监测、成本追踪和模型可用性检查

显著优点

1. 成本优化灵活:推荐混合模式(本地OCR/嵌入 + 云端推理),月费仅$0.50-5,相比全云端首月可省$50-100
2. 视觉理解能力:不仅能搜索文本,还能通过视觉嵌入搜索图表、电路板照片、设备标签

3. 置信度透明:每个响应附带复合置信度评分(检索+忠实度+相关性+覆盖度)和脚注式引用

4. 本地优先隐私:敏感文档处理在本地完成,不上传云端

5. 学习闭环:现场维修记录自动索引,团队知识持续积累

潜在局限

  • 本地资源要求:混合模式需 ~10GB 本地模型存储和 GPU/CPU 推理能力
  • curl 管道安装:Ollama 安装使用 curl | sh,虽官方可信但无法预先审查脚本
  • API 密钥管理:依赖用户自行配置 OpenRouter 和可选的 Brave Search API 密钥
  • 无实时协作:基于本地向量数据库,默认不支持多用户实时同步

适合人群

  • 现场服务工程师(快速查手册、识别零件)
  • 设备维修团队(积累维修经验、建立内部知识库)
  • 学术研究人员(管理大量 PDF 文献和实验记录)
  • 隐私敏感型企业(文档不上云)

常规风险

| 风险项 | 等级 | 说明 |
|--------|------|------|
| 远程脚本执行 | 低 | Ollama 官方 curl 管道安装,来源可信但建议先下载审查 |
| API 成本失控 | 低 | 内置每日预算上限(默认$5),可配置 |
| 数据泄露 | 极低 | 本地处理为主,云端仅用于生成/推理 |
| 模型可用性 | 中 | 依赖 Ollama 本地服务,需确保服务运行 |

认证评级:S 级(88分) — 纯 Markdown 文档型 Skill,无可执行代码,来自可信开源社区。

siphonclaw 内容

手动下载zip · 10.0 kB
README.mdtext/markdown
请选择文件