feat(mod-manager): revamp layout and add GitHub-style markdown panels

- Auto-fit mod manager split layout on first load and surface fetch failures

- Add README/CHANGELOG GitHub-style viewer with markdown preprocessing for upstream formatting quirks

- Refactor pipeline trace UX with selectable rows, impact detail panel, and jump-to-pipeline navigation

- Cache pipeline snapshot/prompt rendering on backend with TTL + inflight dedupe

Author: AstralSolipsism

.gitignore

@@ -45,6 +45,7 @@ yarn.lock
 astrbot.lock
 
 # Other
+playwright-screenshots/
 chroma
 venv/*
 pytest.ini

astrbot/dashboard/routes/pipeline.py

@@ -1,5 +1,9 @@
 from __future__ import annotations
 
+import asyncio
+import hashlib
+import time
+from copy import deepcopy
 from typing import Any, cast
 
 from quart import request
@@ -28,6 +32,13 @@
 
 
 class PipelineRoute(Route):
+    _static_cache: dict[tuple[str, str, bool], tuple[dict[str, Any], float]] = {}
+    _render_cache: dict[tuple[str, str, str, bool], tuple[dict[str, Any], float]] = {}
+    _inflight: dict[tuple[str, tuple[Any, ...]], asyncio.Future] = {}
+    _cache_lock: asyncio.Lock = asyncio.Lock()
+    STATIC_CACHE_TTL: float = 15.0
+    RENDER_CACHE_TTL: float = 10.0
+
     def __init__(self, context: RouteContext, core_lifecycle: AstrBotCoreLifecycle | None = None) -> None:
         super().__init__(context)
         self.core_lifecycle = core_lifecycle
@@ -307,7 +318,32 @@ async def get_snapshot(self):
         preview_prompt_provided = bool(preview_prompt_raw_str)
         preview_prompt = preview_prompt_raw_str if preview_prompt_provided else "（预览）用户输入：<未提供>"
 
-        snapshot = build_pipeline_snapshot(umo=umo, force_refresh=force_refresh, debug=debug)
+        cls = self.__class__
+        scope_mode = "session" if umo else "global"
+        static_key = (scope_mode, str(umo or ""), bool(debug))
+
+        base_snapshot: dict[str, Any] | None = None
+        if not force_refresh:
+            now = time.monotonic()
+            async with cls._cache_lock:
+                entry = cls._static_cache.get(static_key)
+                if entry is not None:
+                    cached_snapshot, ts = entry
+                    if now - ts <= cls.STATIC_CACHE_TTL:
+                        base_snapshot = cached_snapshot
+                    else:
+                        cls._static_cache.pop(static_key, None)
+
+        if base_snapshot is None:
+            base_snapshot = build_pipeline_snapshot(umo=umo, force_refresh=force_refresh, debug=debug)
+            async with cls._cache_lock:
+                now = time.monotonic()
+                for k, (_, ts) in list(cls._static_cache.items()):
+                    if now - ts > cls.STATIC_CACHE_TTL:
+                        cls._static_cache.pop(k, None)
+                cls._static_cache[static_key] = (deepcopy(base_snapshot), now)
+
+        snapshot = deepcopy(base_snapshot)
 
         if render:
             snapshot.setdefault("_debug", {})
@@ -382,12 +418,75 @@ async def get_snapshot(self):
                 snapshot.setdefault("_debug", {})
                 snapshot["_debug"]["persona_prompt_influencers_len"] = len(persona_influencers)
 
-                rendered = await self._render_final_prompt_preview(
-                    umo=render_umo,
-                    prompt=preview_prompt,
-                    debug=debug,
-                    persona_prompt_influencers=persona_influencers,
-                )
+                preview_hash = hashlib.sha256(preview_prompt.encode("utf-8")).hexdigest()
+                render_cache_key = (str(snapshot.get("snapshot_id") or ""), str(render_umo or ""), preview_hash, bool(debug))
+
+                rendered: dict[str, Any] | None = None
+                if not force_refresh:
+                    now = time.monotonic()
+                    async with cls._cache_lock:
+                        entry = cls._render_cache.get(render_cache_key)
+                        if entry is not None:
+                            cached_rendered, ts = entry
+                            if now - ts <= cls.RENDER_CACHE_TTL:
+                                rendered = deepcopy(cached_rendered)
+                            else:
+                                cls._render_cache.pop(render_cache_key, None)
+
+                if rendered is None:
+                    inflight_key = ("render", render_cache_key)
+                    fut: asyncio.Future | None = None
+                    owner = False
+
+                    async with cls._cache_lock:
+                        if not force_refresh and rendered is None:
+                            entry = cls._render_cache.get(render_cache_key)
+                            if entry is not None:
+                                cached_rendered, ts = entry
+                                if time.monotonic() - ts <= cls.RENDER_CACHE_TTL:
+                                    rendered = deepcopy(cached_rendered)
+
+                        if rendered is None:
+                            fut = cls._inflight.get(inflight_key)
+                            if fut is None:
+                                fut = asyncio.get_running_loop().create_future()
+                                cls._inflight[inflight_key] = fut
+                                owner = True
+
+                    if rendered is None and fut is not None and not owner:
+                        rendered = cast(dict[str, Any], await fut)
+
+                    if rendered is None and owner:
+                        try:
+                            computed = await self._render_final_prompt_preview(
+                                umo=render_umo,
+                                prompt=preview_prompt,
+                                debug=debug,
+                                persona_prompt_influencers=persona_influencers,
+                            )
+                            rendered = computed
+                            async with cls._cache_lock:
+                                now = time.monotonic()
+                                for k, (_, ts) in list(cls._render_cache.items()):
+                                    if now - ts > cls.RENDER_CACHE_TTL:
+                                        cls._render_cache.pop(k, None)
+                                cls._render_cache[render_cache_key] = (deepcopy(computed), now)
+                                inflight_fut = cls._inflight.pop(inflight_key, None)
+                                if inflight_fut is not None and not inflight_fut.done():
+                                    inflight_fut.set_result(deepcopy(computed))
+                        except Exception as e:
+                            async with cls._cache_lock:
+                                inflight_fut = cls._inflight.pop(inflight_key, None)
+                                if inflight_fut is not None and not inflight_fut.done():
+                                    inflight_fut.set_exception(e)
+                            raise
+
+                if rendered is None:
+                    rendered = {
+                        "prompt": "",
+                        "system_prompt": "",
+                    }
+
                 rendered_prompt = rendered.get("prompt") or ""
                 rendered_system_prompt = rendered.get("system_prompt") or ""
 

dashboard/package.json

@@ -23,6 +23,7 @@
     "chance": "1.1.11",
     "date-fns": "2.30.0",
     "event-source-polyfill": "^1.0.31",
+    "github-markdown-css": "^5.8.1",
     "highlight.js": "^11.11.1",
     "js-md5": "^0.8.3",
     "katex": "^0.16.27",

dashboard/src/components/extension/mod-manager/GlobalPanel.vue

@@ -6,8 +6,6 @@ import type { CommandConflictGroup, PluginSummary } from './types'
 import type { EffectTarget, PipelineStageId } from './pipeline/pipelineSnapshotTypes'
 import PipelineSnapshotPanel from './pipeline/PipelineSnapshotPanel.vue'
 
-const { tm } = useModuleI18n('features/extension')
-
 type GlobalPanelTab = 'pipeline' | 'trace'
 
 const props = withDefaults(
@@ -26,31 +24,61 @@ const emit = defineEmits<{
   (e: 'select-plugin', name: string): void
 }>()
 
+const { tm } = useModuleI18n('features/extension')
+const $t = tm
+
 const activeTab = ref<GlobalPanelTab>('pipeline')
 
 const traceNavigationToken = ref(0)
 const traceFocusTarget = ref<EffectTarget | null>(null)
 const traceStageId = ref<PipelineStageId | null>(null)
+const traceParticipantId = ref<string | null>(null)
 
 const handleSelectPlugin = (name: string) => {
   if (!name) return
   emit('select-plugin', name)
 }
 
 const handleNavigateTrace = (payload: { participantId: string; stageId: PipelineStageId | null; target: EffectTarget }) => {
+  traceParticipantId.value = payload.participantId || null
   traceFocusTarget.value = payload.target
   traceStageId.value = payload.stageId
   traceNavigationToken.value += 1
   activeTab.value = 'trace'
 }
+
+const handleNavigatePipeline = () => {
+  activeTab.value = 'pipeline'
+}
 </script>
 
 <template>
   <v-card class="h-100 d-flex flex-column global-panel" rounded="lg" variant="flat">
     <div class="global-panel__header">
       <v-tabs v-model="activeTab" color="primary" density="comfortable">
-        <v-tab value="pipeline">{{ tm('pipeline.tabTitle') }}</v-tab>
-        <v-tab value="trace">{{ tm('pipeline.traceTabTitle') }}</v-tab>
+        <v-tab value="pipeline">
+          <span class="d-inline-flex align-center">
+            {{ $t('pipeline.tabs.pipeline') }}
+            <v-tooltip location="bottom">
+              <template #activator="{ props: tooltipProps }">
+                <v-icon v-bind="tooltipProps" size="small" class="ml-1">mdi-information-outline</v-icon>
+              </template>
+              {{ $t('pipeline.tabs.pipelineTooltip') }}
+            </v-tooltip>
+          </span>
+        </v-tab>
+
+        <v-tab value="trace">
+          <span class="d-inline-flex align-center">
+            {{ $t('pipeline.tabs.trace') }}
+            <v-tooltip location="bottom">
+              <template #activator="{ props: tooltipProps }">
+                <v-icon v-bind="tooltipProps" size="small" class="ml-1">mdi-information-outline</v-icon>
+              </template>
+              {{ $t('pipeline.tabs.traceTooltip') }}
+            </v-tooltip>
+          </span>
+        </v-tab>
       </v-tabs>
       <v-divider />
     </div>
@@ -63,8 +91,10 @@ const handleNavigateTrace = (payload: { participantId: string; stageId: Pipeline
         :trace-navigation-token="traceNavigationToken"
         :trace-focus-target="traceFocusTarget"
         :trace-stage-id="traceStageId"
+        :trace-participant-id="traceParticipantId"
         @select-plugin="handleSelectPlugin"
         @navigate-trace="handleNavigateTrace"
+        @navigate-pipeline="handleNavigatePipeline"
       />
     </div>
   </v-card>

dashboard/src/components/extension/mod-manager/LegacyInstalledView.vue

@@ -23,6 +23,7 @@ const emit = defineEmits<{
   (e: 'action-configure', plugin: PluginSummary): void
   (e: 'action-view-handlers', plugin: PluginSummary): void
   (e: 'action-view-readme', plugin: PluginSummary): void
+  (e: 'view-changelog', plugin: PluginSummary): void
   (e: 'action-open-repo', url: string): void
 }>()
 
@@ -306,6 +307,7 @@ function toPlugin(item: unknown): PluginSummary {
                 @toggle-activation="handleToggleActivation(extension)"
                 @view-handlers="emit('action-view-handlers', extension)"
                 @view-readme="emit('action-view-readme', extension)"
+                @view-changelog="emit('view-changelog', extension)"
               />
             </div>
           </v-col>