Files
jxxghp 6d4ce83837 fix(types): clear host mypy debt and prevent typing regressions
严格检查全部宿主源码,清零类型错误预算并移除按模块类型豁免。
按原因、所属方法、错误码及语法指纹锁定必要兼容例外和站点类型桩,
CI 阻断新增忽略、检查范围退化、本地桩替代真实接口及新的类型错误。

修复空值、异步和供应方类型边界,保持插件与 API 兼容合同,
并补充存储、订阅、通知、Agent 和工作流边界的回归覆盖。
2026-10-21 22:03:18 +08:00

92 lines
2.0 KiB
Python

"""
站点认证与索引资源扩展的宿主类型声明。
实现由发布资源提供,此文件供宿主静态检查使用。
"""
from typing import Any, List, Optional, Tuple
class SitesHelper:
"""
声明 Cython 站点认证与索引扩展的宿主接口。
"""
def __init__(self) -> None:
"""
返回进程内共享的站点助手实例。
"""
...
@property
def auth_version(self) -> str:
"""
返回认证资源版本。
"""
...
@property
def indexer_version(self) -> str:
"""
返回站点索引资源版本。
"""
...
@property
def auth_level(self) -> int:
"""
返回当前用户认证等级。
"""
...
def check(self, domain: str) -> Tuple[bool, str]:
"""
检查站点域名是否触发访问频率限制。
"""
...
def get_indexers(self) -> List[dict[str, Any]]:
"""
返回全部可用站点索引配置。
"""
...
async def async_get_indexers(self) -> List[dict[str, Any]]:
"""
异步返回全部可用站点索引配置。
"""
...
def get_indexer(self, domain: str) -> Optional[dict[str, Any]]:
"""
按域名返回单个站点索引配置。
"""
...
async def async_get_indexer(self, domain: str) -> Optional[dict[str, Any]]:
"""
异步按域名返回单个站点索引配置。
"""
...
def get_authsites(self) -> dict[str, Any]:
"""
返回认证站点配置。
"""
...
def get_indexsites(self) -> dict[str, Any]:
"""
返回内置站点索引配置。
"""
...
def check_user(
self,
site: Optional[str] = None,
params: Optional[dict[str, Any]] = None,
) -> Tuple[bool, str]:
"""
校验用户站点认证信息并返回状态与消息。
"""
...