refactor: restructure project with CLI tool, multi-engine support, and skill-builder compliant SKILL.md

- Replace setup.py with pyproject.toml (uv-compatible)
- Add CLI entry point (web-search) with 9 subcommands
- Add multi-engine architecture (14 web + 7 special sources)
- Add WeChat/CLS/WallStreetCN/ArXiv/Twitter search engines
- Remove old src/ and examples/ directories
- Remove redundant requirements.txt and setup.py
- Update README.md and SKILL.md with full documentation
- SKILL.md now compliant with skill-builder standards (frontmatter, triggers, structure)
This commit is contained in:
vex1023 committed 2026-05-14 16:31:54 +08:00
1 parent 80ac14491e
commit 87935b59ce
29 files changed
+2364 -354

No files matched your search

+48
View File
@@ -0,0 +1,48 @@
"""
Core data types and base classes for search engines.
Provides:
- SearchResult: Standard result dataclass used across all engines
- SearchEngine: Abstract base class for all search engine implementations
"""
from __future__ import annotations
from abc import ABC, abstractmethod
from dataclasses import dataclass, field
from typing import Any, Optional
@dataclass
class SearchResult:
"""Represents a single search result."""
title: str = ""
url: str = ""
snippet: str = ""
source: str = ""
rank: int = 0
category: str = ""
extra: dict[str, Any] = field(default_factory=dict)
class SearchEngine(ABC):
"""Abstract base class for search engines."""
def __init__(self, name: str, config: Optional[dict[str, Any]] = None):
self.name = name
self.config = config or {}
@abstractmethod
async def search(
self, query: str, max_results: int = 10, **kwargs
) -> list[SearchResult]:
"""Execute a search and return results."""
...
def build_url(self, query: str, **kwargs) -> str:
"""Build a search URL for this engine (optional)."""
return ""
async def close(self):
"""Clean up resources."""
pass