Skill: whyischen/local-context-bridge (version 1.0.10)

--- name: local-context-bridge description: > Search local personal and internal documents (Word, Excel, PDF, Markdown) using semantic keywords. Use this tool when the user asks about local files, private data, or internal knowledge. It returns highly relevant text snippets and file paths. Note: Always use extracted core entities as keywords, not full conversational sentences. metadata: { openclaw: { emoji: "🌉", requires: { bins: [pip] } } } --- # ContextBridge Knowledge Base ## 📚 How It Works ContextBridge provides OpenClaw with instant retrieval capabilities for local documents (Word, Excel, PDF, Markdown). 1. **Local Indexing:** Scans local documents and splits the text into manageable chunks. 2. **Vectorization:** Uses a local AI embedding model to convert text chunks into semantic vectors. 3. **Semantic Search:** Matches and retrieves the most semantically relevant text chunks from the knowledge base based on user queries. --- ## 🚀 Download & Installation Installation and initialization workflow for `cbridge`: ```mermaid flowchart TD A([Start]) --> B{Is cbridge installed?\n`cbridge --version`} B -- Yes --> C[Check for updates\n`cbridge update`] C --> D{Re-initialization needed?\nAsk user} D -- Yes --> E[Re-initialize config\n`cbridge init`] D -- No --> G E --> G B -- No --> F1[Explain ContextBridge installation requirement\nNeeded for directory monitoring & vectorization] F1 --> F2[Explain ContextBridge working directory\n`~/.cbridge`] F2 --> F3[Obtain user authorization\nAuto-download & initialize with default config] F3 --> G G[Configuration complete\nInteract with ContextBridge via cbridge] --> H([Run built-in demo\ncbridge search ContextBridge]) H --> I([End]) ``` ### 1. Download > 🔓 **Open Source & Trustworthy**: `cbridge-agent` is fully open-source, hosted on [GitHub](https://github.com/whyischen/context-bridge) for audit and verification. Runs entirely locally with zero data leakage risk. ```bash pip install cbridge-agent ``` ### 2. Initialization & Configuration ```bash cbridge init ``` *Note: Because this software is primarily invoked by AI tools, it is highly recommended to use the default configuration for all prompts during initialization.* ### 3. Add Documents ```bash cbridge watch add /path/to/your/documents cbridge watch list # View currently monitored directories ``` ### 4. Run Test Demo ```bash cbridge search ContextBridge # Search the built-in test document ``` --- ## 💡 Search Best Practices 1. **Seamless Execution:** Act autonomously. Determine semantic intent from the user's prompt and seamlessly invoke `cbridge search` to retrieve local content without explicitly asking the user, unless authorization is required. 2. **Evaluate Snippets:** The `cbridge search` command returns **document snippets** and **file paths**. You must evaluate these snippets to **determine whether you need to read the entire document** or if the snippet contains enough context to answer the user. ### When to Use ContextBridge 1. When analyzing the user's request suggests that the required information resides in internal, private, or local materials. 2. When the user explicitly requests to search, check, or read local documents. ### Keyword Extraction - **Recommended:** Extract core entities and noun phrases. - `2024 marketing budget` ✅ - **Not Recommended:** Use full conversational sentences. - `What was the budget for 2024 marketing` ❌ ### Iterative Search Strategy 1. Start with highly precise keywords. 2. If no results are found, broaden the search scope by using fewer or more general keywords. 3. Try synonyms, related terminology, or alternative phrasing. --- ## 📖 CLI Commands ```bash # Initialization cbridge init # Initialize workspace cbridge lang en # Switch CLI language to English # Document Management cbridge watch add <path> # Add a directory to watch list cbridge watch remove <path> # Remove a directory from watch list cbridge watch list # List all watched directories cbridge index # Manually rebuild the index # Service Control cbridge start # Start the background service cbridge serve # Start API only cbridge stop # Stop the service cbridge status # Check service status cbridge logs # View service logs # Search cbridge search <query> # Search documents using keywords ``` --- ## 📚 Resource Links - **GitHub:** [whyischen/context-bridge](https://github.com/whyischen/context-bridge) - **Configuration File:** `~/.cbridge/config.yaml` - **Workspace:** `~/.cbridge/workspace`


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (HIGH)