feat: improve wiki document and artifact views

offline-backend-20260512/backend/CLAUDE.md

@@ -1359,6 +1359,29 @@ page is successfully rebuilt. `WikiRetrievalService` partitions mixed requests
 per mapping, so ready libraries stay local while incomplete libraries use that
 Wiki-only fallback.
 
+The frontend must keep Wiki citations visibly distinct from raw-document
+citations while hiding provider-brand wording from user-facing labels, status
+text, and errors. Any click on a Wiki source card opens the shared right-side
+source drawer, which renders the complete Markdown page. When the local index
+is disabled, the drawer reads the remote WeKnora Wiki-page endpoint directly
+and must not surface the local-index-disabled response. A Wiki target must not
+also load or render the legacy original-document preview, even when its citation
+still carries a document id. The drawer supports
+single-page Markdown and Word downloads, and its **Open in Wiki** link carries
+both the DeerFlow knowledge-base mapping id and the exact `wikiSlug`. Wiki
+search-result cards use this same drawer instead of navigating immediately.
+Exact-page navigation uses the native
+`knowledge/{mapping_id}/wiki/view?wikiSlug=...` reader, not the WeKnora detail
+iframe. Keep legacy `knowledge/{mapping_id}?tab=wiki&wikiSlug=...` links fast by
+redirecting them in `LlmWikiKnowledgePage` before its runtime-loading gate.
+Drawer-to-reader navigation stays in the current SPA and passes the fetched
+Wiki page in router state so the article can render before the background query
+refresh completes. The native reader must retain a searchable/collapsible left
+Wiki directory, reconstruct hierarchy from `parent_slug`, `wiki_path`,
+`category_path`, and slug fallback, expand/highlight the active page, and keep
+directory navigation on the same lightweight route rather than mounting the
+WeKnora iframe.
+
 Owners manually force a full sync/vectorization through `POST
 /api/llmwiki/knowledge-bases/{id}/vectorize`; status is available through `GET
 /api/llmwiki/knowledge-bases/{id}/wiki-index-status`. The Wiki management page

offline-backend-20260512/backend/README.md

@@ -768,6 +768,27 @@ after the full-library readiness gate succeeds. Knowledge-base owners can click
 `GET /api/llmwiki/knowledge-bases/{id}/wiki-index-status`. Existing chunk
 citations remain readable while all new retrieval citations open Wiki pages.
 
+The frontend labels these results simply as **Wiki** references; provider-brand
+wording is intentionally hidden from user-facing labels and status text. Clicking any
+part of a Wiki reference card opens one right-side drawer (rather than a second
+detail dialog), renders the complete page as Markdown, and reads the remote
+WeKnora Wiki page directly when the local index is disabled. Even if a Wiki
+citation carries a legacy document id, the drawer does not mix in the uploaded
+original-file preview. A single page can
+be downloaded as Markdown or Word from the drawer. **Open in Wiki** navigates
+to the exact DeerFlow knowledge-base mapping and Wiki slug. Wiki search-result
+cards use the same drawer interaction. Exact Wiki links now open a lightweight
+native reader at `knowledge/{mapping_id}/wiki/view?wikiSlug=...`; it fetches
+only the selected page and never creates a WeKnora iframe session. The former
+`knowledge/{mapping_id}?tab=wiki&wikiSlug=...` links redirect to the reader
+before waiting for the LLMWiki runtime check. Drawer navigation stays in the
+same SPA and passes the already-loaded page as route state for immediate paint.
+The native reader also keeps a searchable, collapsible Wiki directory on the
+left. It reconstructs hierarchy from `parent_slug`, `wiki_path`,
+`category_path`, and the slug fallback, highlights and expands the current
+page, and switches directory entries through the same lightweight reader route
+without mounting the WeKnora iframe.
+
 Wiki management also provides **导出 Excel**. `GET
 /api/llmwiki/knowledge-bases/{id}/wiki/export.xlsx` exports every processed Wiki
 page, including its full directory path, current directory, parent-directory