核心用法
ContextBridge（cbridge）是一款面向 AI 工作流的本地知识库检索工具，通过 cbridge search <关键词> 命令实现语义级文档搜索。安装后执行 cbridge init 初始化工作区，使用 cbridge watch add 添加监控目录，系统自动完成文档扫描、文本分块与向量化索引。搜索时采用本地 AI 嵌入模型匹配语义向量，返回相关文档片段及路径，支持根据片段判断是否需要获取全文。
显著优点
- 完全本地化：数据不出本机，索引与向量计算均在本地完成，规避云端隐私风险
- 多格式支持：原生支持 Word、Excel、PDF、Markdown 等办公常用格式
- 语义检索：基于向量的相似度匹配，优于传统关键词搜索，支持同义表达与概念关联
- 无感集成：OpenClaw 生态内可自动根据对话上下文触发检索，减少人工判断成本
- 增量更新：监控目录自动追踪文件变更，索引实时同步
潜在缺点与局限性
- 硬件依赖：向量化计算依赖本地 AI 模型，低配设备可能面临性能瓶颈
- Python 生态：需预装 Python 环境，对非技术用户存在配置门槛
- 中文分词质量：未明确说明中文语义解析能力，复杂专业术语可能召回偏差
- 权限边界：文档访问权限继承操作系统权限，敏感文件误监控存在泄露风险
适合人群
- 知识工作者：律师、咨询顾问、研究员等需频繁调用历史文档的专业人士
- 企业内网用户：受合规限制无法使用云端知识库的团队
- AI 重度用户：已将 OpenClaw 纳入日常工作流，希望扩展本地记忆能力
常规风险
- 数据残留：工作区
~/.cbridge存储原始文本块与向量数据，未加密场景下设备丢失即数据暴露 - 索引漂移：长期未执行
cbridge index重建索引，可能产生过期结果 - 模型偏见：嵌入模型的训练数据偏见可能传导至检索结果排序
- 供应链风险：通过 pip 安装的
cbridge-agent需信任 PyPI 包完整性