核心用法
Local ContextBridge 是一款面向 AI Agent 的本地化文档搜索与上下文管理技能，通过 OpenClaw 协议集成。用户需先手动安装 cbridge-agent==0.1.5，随后通过 initialize() 初始化，选择 Embedded（嵌入式） 或 External（外部服务） 模式部署。Embedded 模式内置 ChromaDB，适合单机开发；External 模式可复用现有 QMD 与 OpenViking 服务，支持多应用命名空间隔离。
关键操作包括：使用 add_watch_directory() 添加监控目录、search_documents() 执行语义检索、detect_environment() 自动检测环境可用服务。索引支持 Word、Excel、PDF、Markdown 等格式，检索延迟约 50-500ms。
显著优点
1. 隐私优先：所有文档本地处理，零上传到外部云服务，满足敏感数据合规要求
2. 灵活部署：双模式架构，单机/企业场景按需切换，自动检测现有服务避免重复部署
3. 低侵入集成：命名空间隔离设计（contextbridge_docs、viking://contextbridge/），与其他应用互不干扰
4. 安全可控：依赖手动安装、版本锁定（0.1.5）、审计日志（~/.cbridge/setup.log），无自动代码执行
5. 格式全覆盖：主流办公文档格式原生支持，无需预处理转换
潜在局限
- 前置依赖门槛：必须手动执行
pip install cbridge-agent==0.1.5，自动化流程受限 - 资源占用：Embedded 模式下内存基线 200-500MB+文档大小，大规模索引需外部模式分摊
- 网络服务依赖：External 模式需本地运行 QMD（9090）与 OpenViking（8080）服务，增加运维复杂度
- 版本锁定风险：强制绑定 cbridge-agent 0.1.5，后续升级需人工介入验证兼容性
适合人群
- 个人隐私敏感用户：律师、医生、研究人员等需本地化处理机密文档
- 企业知识管理员：需在隔离命名空间内构建部门级文档检索系统
- AI Agent 开发者：为 OpenClaw 框架扩展本地化 RAG（检索增强生成）能力
- 离线环境用户：无公网访问场景下的文档智能问答需求
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 依赖投毒 | cbridge-agent 供应链攻击 | 手动安装、校验 PyPI 签名、审计日志监控 |
| 配置泄露 | `~/.cbridge/config.yaml` 暴露服务端点 | 标准 Unix 权限控制、避免共享主目录 |
| 本地服务暴露 | QMD/OpenViking 监听 0.0.0.0 | 强制绑定 127.0.0.1、防火墙规则 |
| 索引膨胀 | 监控目录无限增长导致磁盘耗尽 | 定期清理、设置目录大小配额 |
安全等级依据
技能设计体现纵深防御：手动安装阻断自动执行攻击面、审计日志支持事后溯源、命名空间隔离防止横向移动、本地网络探测限制外联风险。虽未提供实际渗透测试报告，但架构层面已覆盖主要威胁向量。