Local Context Bridge

核心用法

Local ContextBridge 是一个本地部署的私有文档检索技能，通过调用 http://127.0.0.1:9790 的 REST API，让 AI 助手能够搜索用户本地的 Word、Excel、PDF、Markdown 等文档。核心功能包括三类操作：

1. 语义搜索（/api/v1/search）：使用关键词而非完整句子进行检索，返回带 metadata.source 引用的文本片段
2. 知识库管理（/api/v1/watch/directories）：动态添加或移除监控文件夹，实现知识库的实时扩展
3. 状态查询（/api/v1/watch/status）：查看当前监控的目录列表

四大触发场景决定了使用时机：信息检索问答（如"Q3 营收是多少"）、文档审计合规（必须先搜本地政策再审查）、上下文感知写作（基于历史文档起草邮件/提案）、故障排查与 SOP 查询。

显著优点

• 数据隐私优先：完全本地运行，文档不上传云端，适合金融、医疗、法律等敏感行业
• RAG 架构原生：实现了检索增强生成（RAG）的本地版本，回答可溯源至具体文件
• 灵活集成：仅需 curl 即可调用，无复杂依赖，可与任何支持 tool use 的 LLM 框架配合
• 动态知识库：支持运行时扩展监控目录，无需重新索引整个系统

潜在缺点与局限性

• 单点故障风险：依赖本地 9790 端口服务，若进程崩溃则完全失效
• 无权限管控：API 层面无用户鉴权，任何能访问 localhost 的进程均可读取全部文档
• 索引延迟：新增文件需等待索引更新，非实时同步
• 关键词依赖：检索质量高度依赖关键词提取能力，复杂语义查询效果有限
• 无版本控制：无法追踪文档历史版本或冲突合并

适合人群

• 企业知识管理：需要 AI 助手访问内部文档库的中小团队
• 合规审计岗位：需对照内部政策审查对外文件的法律/风控人员
• 个人知识工作者：拥有大量本地笔记、论文，希望实现语义搜索的学者、作家
• 私有化部署用户：对数据出境敏感，必须完全离线运行的组织

常规风险

| 风险类型 | 说明 | 缓解建议 |

|---------|------|---------|

| 数据泄露 | API 无认证，本地其他应用可窃听 9790 端口 | 配置本地防火墙限制端口访问 |

| 索引污染 | 误监控敏感目录导致不应检索的内容被暴露 | 严格审核 `watch` 目录范围 |

| 幻觉叠加 | AI 可能误解检索片段上下文，生成错误引用 | 要求 AI 必须展示原始片段供人工核对 |

| 服务可用性 | 进程崩溃导致技能完全失效 | 配置 systemd 自动重启与监控告警 |

| 合规盲区 | 无法识别文档版本，可能引用过期政策 | 建立文档版本命名规范与定期校验机制 |

核心用法

Local ContextBridge 是一款本地知识库检索技能，通过调用运行在 127.0.0.1:9790 的本地 ContextBridge 服务，实现对用户私有文档的智能搜索与问答。该技能主要覆盖四大应用场景：信息检索问答（如查询 Q3 营收、会议记录）、文档审计与合规审查（需先检索本地政策/法规作为审查基准）、基于上下文的文档起草（如按公司模板撰写提案）、以及内部故障排查与 SOP 查询。使用时需通过 curl 发送 POST 请求至 /api/v1/search，提取关键词进行迭代搜索，并支持管理监控文件夹以扩展知识库覆盖范围。

显著优点

该技能的最大优势在于数据隐私安全性——所有检索操作均通过本地环回地址完成，文档数据不上传至云端，满足企业对敏感信息的管控需求。其次，多格式支持涵盖 Word、Excel、PDF、Markdown 等常见办公文档，兼容性广泛。检索结果附带 metadata.source 引用，便于追溯信息来源，提升答案可信度。此外，纯 Markdown 文档型设计使其无执行代码风险，部署轻量且依赖极简。

潜在缺点与局限性

主要局限在于依赖本地服务可用性：若 ContextBridge 服务未启动或端口被占用，技能将无法正常工作。其次，检索质量受索引质量制约，若本地文档未经过良好整理或 OCR 识别不准确，可能影响搜索效果。此外，当前设计缺乏权限细粒度控制，所有具备 Agent 访问权限的用户均可查询监控文件夹内的全部内容，在多用户共享环境中可能存在信息过度暴露风险。

适合的目标群体

该技能特别适合以下用户群体：需要频繁查阅内部文档的企业员工（如法务、财务、HR 等职能部门）、从事合规审计与质量控制的专业人员、以及希望基于历史资料快速生成报告的职场人士。对于高度重视数据主权、不愿将商业文档上传至公有云的组织尤为契合。

使用风险说明

性能风险：本地检索速度取决于文档规模和硬件配置，大规模知识库（数万份文档）可能出现响应延迟。依赖项风险：必须确保 curl 工具已安装且本地 ContextBridge 服务正常运行。安全运营风险：需定期验证本地服务来源完整性，防止恶意替换；建议监控 9790 端口进程归属，确保服务未被非法注入。输入安全：虽然 Skill 本身无危险代码，但查询内容会传递至本地服务，需确认 ContextBridge 服务端具备输入过滤机制。