BREAKING CHANGE: Remove all `agent-reach read` and `agent-reach search-*` commands. Agent Reach is now an installer, configuration tool, and doctor — not a wrapper layer. After installation, agents call upstream tools directly (bird CLI, yt-dlp, mcporter, gh CLI, Jina Reader, etc.). What's kept: - agent-reach install: one-shot installer - agent-reach doctor: channel status overview - agent-reach configure: cookies, proxy, credentials - agent-reach setup: interactive wizard - SKILL.md: complete guide for agents to use upstream tools directly What's removed: - agent-reach read URL (and all channel read() methods) - agent-reach search-* commands (and all channel search() methods) - ReadResult / SearchResult data classes - URL routing system (get_channel_for_url) - All parsing/conversion logic (VTT, Reddit JSON, bird text parser, etc.) - MCP server read/search tools (kept only get_status) Net change: -1790 lines. Less code = fewer bugs.
36 lines
1.2 KiB
Python
36 lines
1.2 KiB
Python
# -*- coding: utf-8 -*-
|
|
"""
|
|
Channel base class — platform availability checking.
|
|
|
|
Each channel represents a platform (YouTube, Twitter, GitHub, etc.)
|
|
and provides:
|
|
- can_handle(url) → does this URL belong to this platform?
|
|
- check(config) → is the upstream tool installed and configured?
|
|
|
|
After installation, agents call upstream tools directly.
|
|
"""
|
|
|
|
import shutil
|
|
from abc import ABC, abstractmethod
|
|
from typing import List, Tuple
|
|
|
|
|
|
class Channel(ABC):
|
|
"""Base class for all channels."""
|
|
|
|
name: str = "" # e.g. "youtube"
|
|
description: str = "" # e.g. "YouTube 视频和字幕"
|
|
backends: List[str] = [] # e.g. ["yt-dlp"] — what upstream tool is used
|
|
tier: int = 0 # 0=zero-config, 1=needs free key, 2=needs setup
|
|
|
|
@abstractmethod
|
|
def can_handle(self, url: str) -> bool:
|
|
"""Check if this channel can handle this URL."""
|
|
...
|
|
|
|
def check(self, config=None) -> Tuple[str, str]:
|
|
"""
|
|
Check if this channel's upstream tool is available.
|
|
Returns (status, message) where status is 'ok'/'warn'/'off'/'error'.
|
|
"""
|
|
return "ok", f"{'、'.join(self.backends) if self.backends else '内置'}"
|