Context-bridge local-context-bridge

通过 ContextBridge CLI 搜索本地文档（PDF/Word/Excel/Markdown）。使用场景：(1) 用户询问本地文件中的具体数据/事实（如"2024 预算是多少"）; (2) 需要基于内部政策/流程/模板回答问题; (3) 用户明确要求搜索本地文档; (4) 涉及非通用知识的私人信息检索。核心原则：先搜索 ContextBridge 再回答。

install

source · Clone the upstream repo

git clone https://github.com/whyischen/context-bridge

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/whyischen/context-bridge "$T" && mkdir -p ~/.claude/skills && cp -r "$T/openclaw_skills/local-context-bridge-cn" ~/.claude/skills/whyischen-context-bridge-local-context-bridge && rm -rf "$T"

OpenClaw · Install into ~/.openclaw/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/whyischen/context-bridge "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/openclaw_skills/local-context-bridge-cn" ~/.openclaw/skills/whyischen-context-bridge-local-context-bridge && rm -rf "$T"

manifest: openclaw_skills/local-context-bridge-cn/SKILL.md

source content

ContextBridge 本地知识库

通过

cbridge

CLI 搜索本地文档的语义内容。所有数据保留在本地，100% 隐私安全。

🚀 快速启动

1. 安装（首次）

pip install cbridge-agent

2. 初始化（首次）

cbridge init

3. 添加监控目录

cbridge watch add /path/to/documents
cbridge watch list

4. 搜索

cbridge search <关键词>

🎯 核心工作流

flowchart TD
    A([用户提问]) --> B{涉及本地/私人知识？}
    B -- 否 --> C[直接回答]
    B -- 是 --> D[提取核心关键词]
    D --> E[cbridge search <关键词>]
    E --> F{找到结果？}
    F -- 否 --> G[扩大关键词范围重试]
    G --> F
    F -- 是 --> H[评估片段是否足够]
    H -- 足够 --> I[基于片段回答 + 引用来源]
    H -- 不足 --> J[读取完整文档后回答]
    I --> K([结束])
    J --> K

💡 搜索最佳实践

关键词提取

推荐 ✅	避免 ❌
`2024 营销预算`	`2024 年的营销预算是多少？`
`采购政策`	`我们公司的采购政策是什么`
`Python 编码规范`	`帮我找找 Python 的编码规范`

迭代策略

精确关键词 → 无结果 → 扩大范围
尝试同义词或相关术语
最多重试 2-3 次

引用要求

始终标注来源：

"根据
```
budget.xlsx
```
的内容..."
"如
```
employee_handbook.pdf
```
所述..."

📋 完整命令参考

详见

references/cli-reference.md

🔧 故障排查

详见

references/troubleshooting.md

📚 资源

GitHub: https://github.com/whyischen/context-bridge
配置:
```
~/.cbridge/config.yaml
```
工作区:
```
~/.cbridge/workspace
```