@wentorai/research-plugins 1.2.2 → 1.3.0

package/skills/tools/document/openpaper-guide/SKILL.md

@@ -1,232 +0,0 @@
----
-name: openpaper-guide
-description: "Open-source tool for organizing and annotating research papers"
-metadata:
-  openclaw:
-    emoji: "📄"
-    category: "tools"
-    subcategory: "document"
-    keywords: ["paper management", "PDF annotation", "research organizer", "paper reader", "document viewer", "open source"]
-    source: "https://github.com/nicehash/openpaper"
----
-
-# OpenPaper Guide
-
-## Overview
-
-OpenPaper is an open-source research paper management and annotation tool. It provides PDF viewing with inline annotations, paper organization with tags and collections, metadata extraction, full-text search across your library, and export capabilities. Designed as a lightweight, privacy-focused alternative to commercial reference managers, running entirely locally.
-
-## Installation
-
-```bash
-# Install via pip
-pip install openpaper
-
-# Or from source
-git clone https://github.com/nicehash/openpaper.git
-cd openpaper && pip install -e .
-
-# Launch
-openpaper
-```
-
-## Library Management
-
-```python
-from openpaper import Library
-
-library = Library("./my_research_library")
-
-# Add papers
-paper = library.add("path/to/paper.pdf")
-print(f"Added: {paper.title}")
-print(f"Authors: {paper.authors}")
-print(f"Year: {paper.year}")
-
-# Bulk import
-added = library.import_directory(
-    "downloads/papers/",
-    recursive=True,
-    extract_metadata=True,   # Auto-extract from PDF
-    deduplicate=True,         # Skip duplicates by DOI/title
-)
-print(f"Imported {len(added)} papers, {added.duplicates} skipped")
-```
-
-## Organization
-
-```python
-# Tags
-paper.add_tag("transformer")
-paper.add_tag("attention")
-paper.add_tag("priority:high")
-
-# Collections
-library.create_collection("thesis-chapter-2")
-library.add_to_collection("thesis-chapter-2", paper)
-
-# Smart collections (auto-updating filters)
-library.create_smart_collection(
-    name="Recent NLP",
-    filters={
-        "tags": ["nlp"],
-        "year": {"gte": 2023},
-        "read_status": "unread",
-    },
-)
-
-# List and browse
-for p in library.search(tags=["transformer"], year=2024):
-    print(f"{p.title} ({p.year}) - {p.read_status}")
-```
-
-## Annotations
-
-```python
-# Add annotations to papers
-paper.annotate(
-    page=3,
-    type="highlight",
-    text="The attention mechanism allows the model to focus...",
-    color="yellow",
-    note="Key definition of attention",
-)
-
-paper.annotate(
-    page=5,
-    type="comment",
-    position=(100, 250),  # x, y coordinates
-    note="This contradicts the claim in Smith et al. 2023",
-)
-
-# Export annotations
-annotations = paper.get_annotations()
-for ann in annotations:
-    print(f"[p.{ann.page}] {ann.type}: {ann.text[:60]}...")
-    if ann.note:
-        print(f"  Note: {ann.note}")
-
-# Export to markdown
-paper.export_annotations("annotations.md")
-```
-
-## Search
-
-```python
-# Full-text search across library
-results = library.search_fulltext("attention mechanism")
-for r in results:
-    print(f"{r.title} (relevance: {r.score:.2f})")
-    for match in r.matches[:3]:
-        print(f"  p.{match.page}: ...{match.context}...")
-
-# Metadata search
-results = library.search(
-    query="transformer",        # Title/abstract search
-    authors="Vaswani",
-    year_range=(2020, 2025),
-    tags=["nlp"],
-)
-
-# Semantic search (if embeddings enabled)
-results = library.semantic_search(
-    "methods for reducing quadratic complexity of attention",
-    top_k=10,
-)
-```
-
-## Metadata Extraction
-
-```python
-# Auto-extract metadata from PDFs
-metadata = library.extract_metadata("paper.pdf")
-print(f"Title: {metadata.title}")
-print(f"Authors: {metadata.authors}")
-print(f"Abstract: {metadata.abstract[:200]}...")
-print(f"DOI: {metadata.doi}")
-print(f"Year: {metadata.year}")
-print(f"References: {len(metadata.references)}")
-
-# Enrich with external databases
-enriched = library.enrich_metadata(
-    paper,
-    sources=["crossref", "semantic_scholar"],
-)
-print(f"Citations: {enriched.citation_count}")
-print(f"Venue: {enriched.venue}")
-```
-
-## Export
-
-```python
-# Export bibliography
-library.export_bibtex("references.bib", collection="thesis-chapter-2")
-
-# Export reading list
-library.export_reading_list("reading_list.md", format="markdown")
-
-# Export annotations from all papers
-library.export_all_annotations("all_annotations.md")
-
-# Sync with reference manager
-library.export_ris("export.ris")          # RIS format
-library.export_csv("export.csv")          # CSV with metadata
-```
-
-## Configuration
-
-```json
-{
-  "library_path": "./research_library",
-  "pdf_viewer": "builtin",
-  "metadata": {
-    "auto_extract": true,
-    "enrich_sources": ["crossref"],
-    "language": "en"
-  },
-  "search": {
-    "fulltext_index": true,
-    "semantic_search": false,
-    "embedding_model": "all-MiniLM-L6-v2"
-  },
-  "storage": {
-    "copy_pdfs": true,
-    "organize_by": "year",
-    "max_library_size_gb": 10
-  }
-}
-```
-
-## CLI Usage
-
-```bash
-# Add paper
-openpaper add paper.pdf --tags "nlp,transformer"
-
-# Search
-openpaper search "attention mechanism" --limit 10
-
-# List library
-openpaper list --sort year --tags "priority:high"
-
-# Export
-openpaper export bibtex --collection thesis --output refs.bib
-
-# Stats
-openpaper stats
-# Papers: 342, Tagged: 289, Annotated: 156, Collections: 12
-```
-
-## Use Cases
-
-1. **Paper library**: Organize and search your PDF collection
-2. **Reading workflow**: Track read status, annotate, take notes
-3. **Reference management**: Export BibTeX for LaTeX papers
-4. **Literature review**: Tag and categorize papers by topic
-5. **Team sharing**: Export reading lists and annotations
-
-## References
-
-- [OpenPaper GitHub](https://github.com/nicehash/openpaper)
-- [Zotero](https://www.zotero.org/) — Popular open-source alternative
-- [Semantic Scholar API](https://api.semanticscholar.org/) — Metadata enrichment

package/skills/tools/document/weknora-guide/SKILL.md

@@ -1,216 +0,0 @@
----
-name: weknora-guide
-description: "Tencent document understanding engine with RAG capabilities"
-metadata:
-  openclaw:
-    emoji: "📑"
-    category: "tools"
-    subcategory: "document"
-    keywords: ["WeKnora", "document understanding", "RAG", "text mining", "Tencent", "knowledge extraction"]
-    source: "https://github.com/Tencent/WeKnora"
----
-
-# WeKnora Guide
-
-## Overview
-
-WeKnora is Tencent's open-source document understanding and retrieval-augmented generation engine. It processes complex documents (PDF, DOCX, HTML) into structured knowledge, supporting layout analysis, table extraction, formula recognition, and multi-modal content parsing. Integrates with RAG pipelines for question answering over document collections. Suited for academic paper processing, report analysis, and enterprise document intelligence.
-
-## Installation
-
-```bash
-# Install WeKnora
-pip install weknora
-
-# With GPU support
-pip install weknora[gpu]
-
-# With all optional dependencies
-pip install weknora[all]
-```
-
-## Document Parsing
-
-```python
-from weknora import DocumentParser
-
-parser = DocumentParser()
-
-# Parse a PDF document
-doc = parser.parse("research_paper.pdf")
-
-print(f"Pages: {doc.num_pages}")
-print(f"Sections: {len(doc.sections)}")
-print(f"Tables: {len(doc.tables)}")
-print(f"Figures: {len(doc.figures)}")
-print(f"Equations: {len(doc.equations)}")
-
-# Access structured content
-for section in doc.sections:
-    print(f"\n## {section.title}")
-    print(f"   {section.text[:200]}...")
-    if section.tables:
-        print(f"   Tables: {len(section.tables)}")
-```
-
-## Layout Analysis
-
-```python
-from weknora import LayoutAnalyzer
-
-analyzer = LayoutAnalyzer(model="layoutlmv3")
-
-# Detect document layout elements
-layout = analyzer.analyze("paper.pdf")
-
-for page in layout.pages:
-    print(f"\nPage {page.number}:")
-    for element in page.elements:
-        print(f"  [{element.type}] ({element.bbox}) "
-              f"{element.text[:50]}...")
-    # Element types: title, text, table, figure,
-    #   equation, header, footer, caption, list
-```
-
-## Table Extraction
-
-```python
-from weknora import TableExtractor
-
-extractor = TableExtractor()
-
-# Extract tables from document
-tables = extractor.extract("paper.pdf")
-
-for i, table in enumerate(tables):
-    print(f"\nTable {i+1}: {table.caption}")
-    df = table.to_dataframe()
-    print(df.head())
-
-    # Export
-    df.to_csv(f"table_{i+1}.csv")
-
-# Extract specific table by page
-table = extractor.extract_from_page("paper.pdf", page=5, index=0)
-```
-
-## Formula Recognition
-
-```python
-from weknora import FormulaRecognizer
-
-recognizer = FormulaRecognizer()
-
-# Extract formulas from document
-formulas = recognizer.extract("paper.pdf")
-
-for formula in formulas:
-    print(f"Page {formula.page}: {formula.latex}")
-    # Output: "\\mathcal{L} = -\\sum_{i} y_i \\log(\\hat{y}_i)"
-    print(f"  Type: {formula.type}")  # inline or display
-```
-
-## RAG Pipeline
-
-```python
-from weknora import RAGPipeline
-
-# Build RAG over document collection
-rag = RAGPipeline(
-    embedding_model="bge-large-zh-v1.5",
-    chunk_size=512,
-    chunk_overlap=64,
-)
-
-# Index documents
-rag.add_documents([
-    "papers/transformer.pdf",
-    "papers/bert.pdf",
-    "papers/gpt3.pdf",
-])
-
-# Query
-result = rag.query(
-    "What is the computational complexity of self-attention?"
-)
-print(result.answer)
-for source in result.sources:
-    print(f"  [{source.document}] p.{source.page}: "
-          f"{source.text[:80]}...")
-```
-
-## Multi-Modal Processing
-
-```python
-from weknora import MultiModalParser
-
-parser = MultiModalParser()
-
-# Process document with figures and tables
-doc = parser.parse("paper.pdf", extract_all=True)
-
-# Access figure descriptions
-for fig in doc.figures:
-    print(f"Figure {fig.number}: {fig.caption}")
-    fig.save_image(f"figures/fig_{fig.number}.png")
-
-# Cross-reference tables and text
-for ref in doc.cross_references:
-    print(f"'{ref.text}' → {ref.target_type} {ref.target_id}")
-```
-
-## Batch Processing
-
-```python
-from weknora import BatchProcessor
-
-processor = BatchProcessor(
-    workers=4,
-    output_dir="./parsed_docs",
-)
-
-# Process directory of documents
-results = processor.process_directory(
-    "papers/",
-    formats=["pdf", "docx"],
-    output_format="json",  # or "markdown"
-)
-
-print(f"Processed: {results.success}/{results.total}")
-print(f"Failed: {results.failures}")
-```
-
-## Configuration
-
-```python
-from weknora import Config
-
-config = Config(
-    parser={
-        "layout_model": "layoutlmv3",
-        "ocr_engine": "paddleocr",
-        "formula_engine": "latex_ocr",
-        "language": "en",  # or "zh", "multi"
-    },
-    rag={
-        "embedding_model": "bge-large-zh-v1.5",
-        "reranker": "bge-reranker-large",
-        "chunk_strategy": "semantic",
-        "vector_store": "faiss",
-    },
-)
-```
-
-## Use Cases
-
-1. **Paper parsing**: Extract structured content from academic PDFs
-2. **Table digitization**: Convert paper tables to spreadsheets
-3. **Document QA**: RAG-based question answering over papers
-4. **Knowledge extraction**: Build knowledge bases from documents
-5. **Report analysis**: Process and compare technical reports
-
-## References
-
-- [WeKnora GitHub](https://github.com/Tencent/WeKnora)
-- [LayoutLMv3](https://arxiv.org/abs/2204.08387)
-- [PaddleOCR](https://github.com/PaddlePaddle/PaddleOCR)

package/skills/tools/knowledge-graph/mimir-memory-guide/SKILL.md

@@ -1,135 +0,0 @@
----
-name: mimir-memory-guide
-description: "Semantic vector search memory bank for AI agents"
-metadata:
-  openclaw:
-    emoji: "📝"
-    category: "tools"
-    subcategory: "knowledge-graph"
-    keywords: ["agent memory", "vector search", "semantic memory", "MCP", "knowledge persistence", "embedding"]
-    source: "https://github.com/orneryd/Mimir"
----
-
-# Mimir Agent Memory Guide
-
-## Overview
-
-Mimir is a semantic memory bank for AI agents that provides persistent, searchable memory via vector embeddings. Agents can store observations, learnings, and context that persists across sessions, and retrieve relevant memories using semantic search. Available as an MCP server for seamless integration with Claude Code, OpenClaw, and other agent frameworks.
-
-## Installation
-
-```bash
-# MCP server
-npm install -g @mimir/mcp-server
-
-# Python library
-pip install mimir-memory
-```
-
-## MCP Configuration
-
-```json
-{
-  "mcpServers": {
-    "mimir": {
-      "command": "npx",
-      "args": ["@mimir/mcp-server"],
-      "env": {
-        "MEMORY_PATH": "~/.mimir/memories",
-        "EMBEDDING_MODEL": "all-MiniLM-L6-v2"
-      }
-    }
-  }
-}
-```
-
-## Core Operations
-
-```python
-from mimir import MemoryBank
-
-bank = MemoryBank(
-    path="./agent_memory",
-    embedding_model="all-MiniLM-L6-v2",
-)
-
-# Store a memory
-bank.store(
-    content="The project uses FastAPI with PostgreSQL. "
-            "Database migrations are managed with Alembic.",
-    metadata={
-        "type": "project_context",
-        "project": "wentor",
-        "timestamp": "2025-03-10",
-    },
-)
-
-# Semantic search
-results = bank.search(
-    query="How does the database work?",
-    top_k=5,
-)
-for r in results:
-    print(f"[{r.score:.3f}] {r.content[:100]}...")
-
-# Delete memory
-bank.delete(memory_id=results[0].id)
-```
-
-## MCP Tools
-
-```markdown
-### Available MCP Tools
-- `store_memory(content, metadata)` — Store new memory
-- `search_memory(query, limit)` — Semantic search
-- `list_memories(filter)` — List by metadata filter
-- `delete_memory(id)` — Remove specific memory
-- `clear_memories(filter)` — Clear matching memories
-
-### Usage in Agent Chat
-"Remember that the API uses JWT tokens with 30-day expiry"
-→ Stores as persistent memory
-
-"What do you know about the authentication system?"
-→ Searches memories, returns relevant stored context
-```
-
-## Memory Types
-
-```python
-# Structured memory categories
-bank.store(
-    content="User prefers dark theme and minimal logging",
-    metadata={"type": "preference"},
-)
-
-bank.store(
-    content="Fixed bug: ECharts CSS vars don't work on Canvas",
-    metadata={"type": "lesson_learned", "topic": "echarts"},
-)
-
-bank.store(
-    content="Deploy script is at deploy/deploy.sh, "
-            "requires .credentials file",
-    metadata={"type": "project_knowledge"},
-)
-
-# Search by type
-prefs = bank.search(
-    query="user preferences",
-    filter={"type": "preference"},
-)
-```
-
-## Use Cases
-
-1. **Agent memory**: Persistent context across sessions
-2. **Project knowledge**: Store and retrieve project facts
-3. **Learning accumulation**: Build expertise over time
-4. **Preference tracking**: Remember user preferences
-5. **Research notes**: Searchable research observations
-
-## References
-
-- [Mimir GitHub](https://github.com/orneryd/Mimir)
-- [MCP Specification](https://modelcontextprotocol.io/)