Squashed 'astrbot-sdk/' changes from b817715b9..378257db7

378257db7 chore: refresh vendor snapshot [skip ci]
f8dab1de5 Merge pull request #100 from united-pooh:dev
5492735cd feat: 添加 repo 字段到插件元数据，增强插件信息的完整性
REVERT: b817715b9 chore: refresh vendor snapshot [skip ci]

git-subtree-dir: astrbot-sdk
git-subtree-split: 378257db7da5e75fb99449ab1266f33e101a6922

Author: whatevertogo

src/astrbot_sdk/cli.py

@@ -678,6 +678,7 @@ def _render_init_plugin_yaml(
     display_name: str,
     desc: str,
     author: str,
+    repo: str,
     version: str,
 ) -> str:
     python_version = f"{sys.version_info.major}.{sys.version_info.minor}"
@@ -688,6 +689,7 @@ def _render_init_plugin_yaml(
         display_name: {display_name}
         desc: {desc}
         author: {author}
+        repo: {repo}
         version: {version}
         runtime:
           python: "{python_version}"
@@ -968,19 +970,21 @@ def _prompt_nonempty_text(prompt: str) -> str:
         click.echo("该字段不能为空，请重新输入。")
 
 
-def _collect_init_metadata(name: str | None) -> tuple[str, str, str, str]:
-    if name is not None:
-        return name, "", "", "1.0.0"
+def _default_init_repo_name(plugin_name: str) -> str:
+    return _normalize_plugin_name(plugin_name)
 
-    plugin_name = _prompt_nonempty_text("插件名字")
-    author = click.prompt("作者", type=str, default="", show_default=False).strip()
+
+def _collect_init_metadata(name: str | None) -> tuple[str, str, str, str, str]:
+    plugin_name = name if name is not None else _prompt_nonempty_text("插件名字")
+    author = _prompt_nonempty_text("作者")
+    repo = _default_init_repo_name(plugin_name)
     desc = click.prompt("描述", type=str, default="", show_default=False).strip()
     version = click.prompt("版本", type=str, default="1.0.0", show_default=True).strip()
-    return plugin_name, author, desc, version or "1.0.0"
+    return plugin_name, author, repo, desc, version or "1.0.0"
 
 
 def _init_plugin(name: str | None, agents: tuple[str, ...] = ()) -> None:
-    raw_name, author, desc, version = _collect_init_metadata(name)
+    raw_name, author, repo, desc, version = _collect_init_metadata(name)
     plugin_name = _normalize_plugin_name(raw_name)
     target_dir = Path(plugin_name)
     if target_dir.exists():
@@ -995,6 +999,7 @@ def _init_plugin(name: str | None, agents: tuple[str, ...] = ()) -> None:
             display_name=display_name,
             desc=desc,
             author=author,
+            repo=repo,
             version=version,
         ),
         encoding="utf-8",

src/astrbot_sdk/clients/metadata.py

@@ -26,6 +26,7 @@ class StarMetadata:
     name: str
     display_name: str
     description: str
+    repo: str
     author: str
     version: str
     enabled: bool = True
@@ -44,6 +45,7 @@ def from_dict(cls, data: dict[str, Any]) -> StarMetadata:
             name=str(data.get("name", "")),
             display_name=str(data.get("display_name", data.get("name", ""))),
             description=str(data.get("desc", data.get("description", ""))),
+            repo=str(data.get("repo", "")),
             author=str(data.get("author", "")),
             version=str(data.get("version", "0.0.0")),
             enabled=bool(data.get("enabled", True)),

src/astrbot_sdk/runtime/capability_router.py

@@ -337,6 +337,7 @@ def upsert_plugin(
         normalized_metadata = dict(metadata)
         normalized_metadata.setdefault("display_name", name)
         normalized_metadata.setdefault("description", "")
+        normalized_metadata.setdefault("repo", "")
         normalized_metadata.setdefault("author", "")
         normalized_metadata.setdefault("version", "0.0.0")
         normalized_metadata.setdefault("enabled", True)

src/astrbot_sdk/runtime/loader.py

@@ -35,6 +35,7 @@
 plugin.yaml 格式：
     name: my_plugin
     author: author_name
+    repo: my_plugin
     desc: Plugin description
     version: 1.0.0
     runtime:
@@ -112,12 +113,29 @@
 DiscoverySeverity: TypeAlias = Literal["warning", "error"]
 DiscoveryPhase: TypeAlias = Literal["discovery", "load", "lifecycle", "reload"]
 _LOGGER = logging.getLogger(__name__)
+_GITHUB_REPO_NAME_RE = re.compile(r"^[A-Za-z0-9_.-]+$")
+_GITHUB_REPO_SLUG_RE = re.compile(r"^[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+$")
+_GITHUB_REPO_URL_RE = re.compile(
+    r"^https://github\.com/[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+/?$",
+    re.IGNORECASE,
+)
 
 
 def _default_python_version() -> str:
     return f"{sys.version_info.major}.{sys.version_info.minor}"
 
 
+def _is_valid_github_repo_ref(value: str) -> bool:
+    normalized = value.strip()
+    if not normalized:
+        return False
+    return bool(
+        _GITHUB_REPO_NAME_RE.fullmatch(normalized)
+        or _GITHUB_REPO_SLUG_RE.fullmatch(normalized)
+        or _GITHUB_REPO_URL_RE.fullmatch(normalized)
+    )
+
+
 def _venv_python_path(venv_dir: Path) -> Path:
     if os.name == "nt":
         return venv_dir / "Scripts" / "python.exe"
@@ -709,6 +727,19 @@ def validate_plugin_spec(plugin: PluginSpec) -> None:
     if not isinstance(raw_python, str) or not raw_python:
         raise ValueError(f"{manifest_label} 缺少 runtime.python。")
 
+    raw_author = manifest_data.get("author")
+    if not isinstance(raw_author, str) or not raw_author.strip():
+        raise ValueError(f"{manifest_label} 缺少 author。")
+
+    raw_repo = manifest_data.get("repo")
+    if not isinstance(raw_repo, str) or not raw_repo.strip():
+        raise ValueError(f"{manifest_label} 缺少 repo。")
+    if not _is_valid_github_repo_ref(raw_repo):
+        raise ValueError(
+            f"{manifest_label} 的 repo 不合法："
+            "请填写 GitHub 仓库名（repo）、owner/repo，或 https://github.com/owner/repo。"
+        )
+
     components = manifest_data.get("components")
     if not isinstance(components, list):
         raise ValueError(f"{manifest_label} 的 components 必须是数组。")

src/astrbot_sdk/runtime/supervisor.py

@@ -462,6 +462,7 @@ def _publish_plugin_registry_snapshot(
                     "description": str(
                         manifest.get("desc") or manifest.get("description") or ""
                     ),
+                    "repo": str(manifest.get("repo") or ""),
                     "author": str(manifest.get("author") or ""),
                     "version": str(manifest.get("version") or "0.0.0"),
                     "enabled": plugin.name in enabled_plugins,

src/astrbot_sdk/testing.py

@@ -87,6 +87,7 @@ def _plugin_metadata_from_spec(
         "name": plugin.name,
         "display_name": str(manifest.get("display_name") or plugin.name),
         "description": str(manifest.get("desc") or manifest.get("description") or ""),
+        "repo": str(manifest.get("repo") or ""),
         "author": str(manifest.get("author") or ""),
         "version": str(manifest.get("version") or "0.0.0"),
         "enabled": enabled,