核心用法
Local ContextBridge 是一项本地知识检索技能,通过调用 http://127.0.0.1:9790 的私有 API,让 AI 助手能够搜索用户本地的 Word、Excel、PDF、Markdown 等文档内容。使用时需通过 curl 发送 POST 请求到 /api/v1/search,提取关键词而非完整问句进行检索,并支持迭代优化搜索策略。
显著优点
1. 隐私优先:所有数据检索在本地完成,敏感文档无需上传云端
2. 场景覆盖全面:四大触发场景包括信息检索(Q&A)、文档审计与合规、上下文起草、故障排查与 SOP 查询
3. 可追溯引用:API 返回结果包含 metadata.source,便于标注信息来源
4. 灵活管理:支持动态添加/监控本地文件夹,实时扩展知识库范围
潜在局限
- 依赖本地服务:需用户提前部署 ContextBridge 服务,端口 9790 必须可用
- 关键词提炼门槛:用户或 AI 需掌握从自然语言提取核心实体的技巧
- 无语义理解保障:基于关键词匹配,复杂语义关联可能遗漏
- 单点故障风险:本地服务宕机则技能完全不可用
适合人群
企业知识管理用户、法律/合规审计人员、需要基于内部文档写作的商务人士、技术运维团队(查询 SOP 与故障手册)。
常规风险
- 本地服务暴露:127.0.0.1 虽为回环地址,但若配置不当可能被外部访问
- 权限边界模糊:AI 获得本地文件读取能力,需确保最小权限原则
- 数据残留:curl 命令历史可能暴露查询内容,需注意 shell 历史清理