360 Secure SkillHub
360 安全技能中心

Local ContextBridge 中文

通过 cbridge 命令行工具扫描并索引本地 Word、Excel、PDF、Markdown 文档，用本地嵌入模型做语义检索，按关键词返回相关文本片段与文件路径；提供初始化、目录监听、索引重建、服务控制与搜索等命令，安装需 pip 安装 cbridge-agent。

whyischen
whyischen
热度 56.82
最近更新 2026-05-11 17:35:23
分类：搜索依赖：代码执行 / 读写文件应用场景：研究 / 笔记整理 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add local-context-bridge-cn
Metadata
name
local-context-bridge
description
使用语义关键词搜索本地个人和内部文档(Word/Excel/PDF/Markdown)。当用户询问本地文件、私人数据或内部知识时使用此工具。它会返回高度相关的文本片段和文件路径。注意：始终使用提取的核心实体作为关键词，而不是完整句子。
metadata
{"openclaw":{"emoji":"🌉","requires":{"bins":["pip"]}}}

ContextBridge 知识库

📚 工作原理

ContextBridge 为 OpenClaw 提供对你本地文档（Word、Excel、PDF、Markdown）的即时检索能力。

  1. 本地索引：扫描文档并将文本切分为文本块。
  2. 向量化：使用本地 AI 嵌入模型将文本转换为语义向量。
  3. 语义搜索：从知识库中匹配最相关的文本块。

🚀 下载安装

cbridge 安装与初始化流程

flowchart TD
    A([开始]) --> B{已安装 cbridge？\ncbridge --version}

    B -- 是 --> C[检测更新\ncbridge update]
    C --> D{需要重新初始化？\n询问用户}
    D -- 是 --> E[重新初始化配置\ncbridge init]
    D -- 否 --> G
    E --> G

    B -- 否 --> F1[说明需安装 ContextBridge\n用于监控本地目录、向量化文件]
    F1 --> F2[说明工作目录\n创建 ~/.cbridge 保存工作文件]
    F2 --> F3[获取用户授权\n自动完成下载与初始化]
    F3 --> G

    G[配置完成\n通过 cbridge 与 ContextBridge 交互] --> H[运行内置 Demo\ncbridge search ContextBridge]
    H --> I([结束])

1. 下载

🔓 开源可信：cbridge-agent 完全开源，代码托管于 GitHub，可审计验证，本地运行无数据泄露风险。

pip install cbridge-agent

2. 初始化配置

cbridge init

因为软件主要为 AI 工具调用，推荐用户全部使用默认配置

3. 添加文档

cbridge watch add /path/to/your/documents
cbridge watch list    # 查看已监听文件夹

4. 运行测试 demo

cbridge search ContextBridge    # 搜索内置测试文档

💡 搜索最佳实践

  1. 尽量做到无感使用，根据用户语义判断使用调用 cbridge seatch 检索本地内容
  2. cbridge seatch 会返回与搜索相关的文档片段以及文档路径，根据文档片段判断是否需要获取文档全部内容。

什么时候使用 ContextBridge

  1. 分析用户所提到的资料可能是内部资料时
  2. 用户明确提出查看本地文档时

关键词提取

  • 推荐：提取核心实体
    • 2024 marketing budget ✅
  • 不推荐：使用完整句子
    • What was the budget for 2024 marketing ❌

迭代搜索

  1. 先用精准关键词
  2. 若无结果，扩大查询范围
  3. 尝试同义词或相关术语

📖 CLI 命令

# 初始化
cbridge init                 # 初始化工作区
cbridge lang en              # 切换语言

# 文档管理
cbridge watch add path     # 添加文件夹
cbridge watch remove path  # 移除文件夹
cbridge watch list           # 列出文件夹
cbridge index                # 手动重建索引

# 服务控制
cbridge start                # 启动服务
cbridge serve                # 仅启动 API
cbridge stop                 # 停止服务
cbridge status               # 查看状态
cbridge logs                 # 查看日志

# 搜索
cbridge search query       # 搜索文档

📚 资源链接