feat(plugin): 建立可信来源准入与安装恢复 (#6462)

app/adapters/external/plugin/client.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 
 from pathlib import Path
-from typing import Any, Optional
+from typing import Any, Optional, cast
 
 from app.adapters.external.market import PluginHelper as _PluginHelper
 from app.runtime.cache import async_fresh, fresh
@@ -21,7 +21,7 @@ class PluginMarketClient:
         repo_url: str,
         package_version: Optional[str] = None,
         force: bool = False,
-    ) -> Optional[dict[str, dict]]:
+    ) -> Optional[dict[str, dict[str, Any]]]:
         """同步读取指定仓库和代际的插件索引。"""
         with fresh(force):
             return self._helper.get_plugins(repo_url, package_version)
@@ -36,6 +36,35 @@ class PluginMarketClient:
         async with async_fresh(force):
             return await self._helper.async_get_plugins(repo_url, package_version)
 
+    def get_plugin_index_result(
+        self,
+        repo_url: str,
+        package_version: Optional[str] = None,
+        force: bool = False,
+    ) -> Optional[dict[str, dict]]:
+        """读取插件索引的三态结果，供库存读取保留失败事实。"""
+        with fresh(force):
+            return cast(
+                Optional[dict[str, dict[str, Any]]],
+                self._helper.get_plugin_index_result(repo_url, package_version),
+            )
+
+    async def async_get_plugin_index_result(
+        self,
+        repo_url: str,
+        package_version: Optional[str] = None,
+        force: bool = False,
+    ) -> Optional[dict[str, dict[str, Any]]]:
+        """异步读取插件索引的三态结果，供库存读取保留失败事实。"""
+        async with async_fresh(force):
+            return cast(
+                Optional[dict[str, dict[str, Any]]],
+                await self._helper.async_get_plugin_index_result(
+                    repo_url,
+                    package_version,
+                ),
+            )
+
     def get_local_candidates(self) -> dict[str, dict]:
         """返回全部本地插件仓库候选。"""
         return self._helper.get_local_plugin_candidates()