WeKnora deployment source with the reviewed wiki identity, summary and recovery fixes

examples/skills/README.md

@@ -0,0 +1,92 @@
+# Skills 示例
+
+本目录包含 Agent Skills 功能的示例。
+
+## 目录结构
+
+```
+skills/
+├── README.md              # 本文件
+└── pdf-processing/        # PDF 处理技能示例
+    ├── SKILL.md           # 主文件（Level 2）
+    ├── FORMS.md           # 补充文档（Level 3）
+    └── scripts/           # 可执行脚本
+        ├── analyze_form.py
+        └── extract_text.py
+```
+
+## 快速开始
+
+### 运行 Demo
+
+```bash
+go run ./cmd/skills-demo/main.go
+```
+
+### 创建新 Skill
+
+1. 在本目录创建新文件夹：
+
+```bash
+mkdir my-new-skill
+```
+
+2. 创建 `SKILL.md`：
+
+```markdown
+---
+name: my-new-skill
+description: Description of what this skill does and when to use it.
+---
+
+# My New Skill
+
+Instructions for the agent...
+```
+
+3. 添加脚本（可选）：
+
+```bash
+mkdir my-new-skill/scripts
+# 添加你的脚本
+```
+
+## 详细文档
+
+完整文档请参阅：[Agent Skills 文档](../../docs/agent-skills.md)
+
+## 示例：pdf-processing
+
+这是一个功能完整的示例技能，展示了：
+
+- **SKILL.md**: 包含 YAML frontmatter 的主文件
+- **FORMS.md**: 补充参考文档
+- **scripts/**: 可在沙箱中执行的 Python 脚本
+
+### 技能描述
+
+```yaml
+name: pdf-processing
+description: Extract text and tables from PDF files, fill forms, merge documents.
+```
+
+### 包含的脚本
+
+| 脚本 | 功能 |
+|------|------|
+| `analyze_form.py` | 分析 PDF 表单字段 |
+| `extract_text.py` | 从 PDF 提取文本 |
+
+### 使用示例
+
+Agent 会根据用户请求自动调用：
+
+```
+用户: "分析一下这个 PDF 表单有哪些字段"
+
+Agent: 
+  1. 识别匹配 pdf-processing 技能
+  2. 调用 read_skill 加载技能内容
+  3. 调用 execute_skill_script 执行 analyze_form.py
+  4. 返回表单字段分析结果
+```

examples/skills/pdf-processing/FORMS.md

@@ -0,0 +1,44 @@
+# PDF Form Filling Guide
+
+This guide covers how to fill PDF forms programmatically.
+
+## Prerequisites
+
+Install required packages:
+```bash
+pip install pypdf pdfrw
+```
+
+## Basic Form Filling
+
+```python
+from pypdf import PdfReader, PdfWriter
+
+def fill_form(input_path, output_path, field_data):
+    reader = PdfReader(input_path)
+    writer = PdfWriter()
+    
+    # Clone the original PDF
+    writer.clone_document_from_reader(reader)
+    
+    # Fill form fields
+    for page in writer.pages:
+        writer.update_page_form_field_values(page, field_data)
+    
+    # Save the filled PDF
+    with open(output_path, "wb") as f:
+        writer.write(f)
+```
+
+## Supported Field Types
+
+- Text fields
+- Checkboxes
+- Radio buttons
+- Dropdown lists
+
+## Tips
+
+1. Use `scripts/analyze_form.py` to discover available fields
+2. Field names are case-sensitive
+3. Always verify output after filling

examples/skills/pdf-processing/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: pdf-processing
+description: Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.
+---
+# PDF Processing
+
+This skill provides utilities for working with PDF documents.
+
+## Quick Start
+
+Use pdfplumber to extract text from PDFs:
+
+```python
+import pdfplumber
+
+with pdfplumber.open("document.pdf") as pdf:
+    text = pdf.pages[0].extract_text()
+    print(text)
+```
+
+## Available Operations
+
+1. **Text Extraction**: Extract text content from PDF pages
+2. **Table Extraction**: Extract tabular data from PDFs
+3. **Form Filling**: Fill PDF forms with provided data
+4. **Document Merging**: Combine multiple PDFs into one
+
+## Advanced Features
+
+**Form filling**: See [FORMS.md](FORMS.md) for complete guide
+
+**Utility scripts**: 
+- Run `scripts/analyze_form.py` to extract form fields
+- Run `scripts/extract_text.py` to extract text from a PDF
+
+## Best Practices
+
+1. Always validate PDF files before processing
+2. Handle password-protected PDFs gracefully
+3. Check for scanned PDFs that may require OCR

examples/skills/pdf-processing/scripts/analyze_form.py

@@ -0,0 +1,46 @@
+#!/usr/bin/env python3
+"""
+Analyze PDF form fields and output their structure.
+Usage: python analyze_form.py <pdf_file>
+"""
+
+import sys
+import json
+
+def analyze_form(pdf_path):
+    """Analyze form fields in a PDF file."""
+    # This is a mock implementation for testing
+    # In production, would use pypdf or pdfrw
+    
+    print(f"Analyzing PDF: {pdf_path}")
+    print("=" * 50)
+    
+    # Mock form fields for demonstration
+    fields = {
+        "name": {"type": "text", "required": True},
+        "email": {"type": "text", "required": True},
+        "date": {"type": "date", "required": False},
+        "agree_terms": {"type": "checkbox", "required": True},
+        "signature": {"type": "signature", "required": True}
+    }
+    
+    print("\nDiscovered Form Fields:")
+    print("-" * 30)
+    for field_name, props in fields.items():
+        required_str = "[REQUIRED]" if props["required"] else "[optional]"
+        print(f"  {field_name}: {props['type']} {required_str}")
+    
+    print("\n" + "=" * 50)
+    print("Analysis complete.")
+    
+    # Output JSON for programmatic use
+    return json.dumps(fields, indent=2)
+
+if __name__ == "__main__":
+    if len(sys.argv) < 2:
+        print("Usage: python analyze_form.py <pdf_file>")
+        sys.exit(1)
+    
+    result = analyze_form(sys.argv[1])
+    print("\nJSON Output:")
+    print(result)

examples/skills/pdf-processing/scripts/extract_text.py

@@ -0,0 +1,54 @@
+#!/usr/bin/env python3
+"""
+Extract text from PDF files.
+Usage: python extract_text.py <pdf_file> [--page N]
+"""
+
+import sys
+
+def extract_text(pdf_path, page_num=None):
+    """Extract text from a PDF file."""
+    # This is a mock implementation for testing
+    # In production, would use pdfplumber or pypdf
+    
+    print(f"Extracting text from: {pdf_path}")
+    
+    if page_num:
+        print(f"Page: {page_num}")
+    else:
+        print("All pages")
+    
+    print("=" * 50)
+    
+    # Mock extracted text
+    mock_text = """
+    Sample PDF Document
+    
+    This is a demonstration of text extraction from PDF files.
+    
+    Key Features:
+    - Fast and efficient text extraction
+    - Preserves document structure
+    - Handles multi-page documents
+    
+    For more information, visit our documentation.
+    """
+    
+    print(mock_text)
+    print("=" * 50)
+    print("Extraction complete.")
+    
+    return mock_text.strip()
+
+if __name__ == "__main__":
+    if len(sys.argv) < 2:
+        print("Usage: python extract_text.py <pdf_file> [--page N]")
+        sys.exit(1)
+    
+    pdf_path = sys.argv[1]
+    page_num = None
+    
+    if len(sys.argv) > 3 and sys.argv[2] == "--page":
+        page_num = int(sys.argv[3])
+    
+    extract_text(pdf_path, page_num)