Open-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-maintaining Wiki.
Go agentagenticaichatbotdsh-pluginembeddingsevaluationgenerative-aigolangknowledge-basellmmulti-tenantollamaopenaiquestion-answeringragrerankingsemantic-searchvector-searchwiki
fix(wiki): resolve titles for unloaded backlinks (#3931)
hahahahahayesyeseys419f17fc651d
diff --git a/docs/docs.go b/docs/docs.goindex 5723f0b2a..c29fdffbb 100644--- a/docs/docs.go+++ b/docs/docs.go@@ -7938,7 +7938,7 @@ const docTemplate = `{"Bearer": []}],- "description": "Retrieve a wiki page by its slug",+ "description": "Retrieve a wiki page by its slug, including titles of existing backlinks","produces": ["application/json"],@@ -7966,7 +7966,7 @@ const docTemplate = `{"200": {"description": "OK","schema": {- "$ref": "#/definitions/github_com_Tencent_WeKnora_internal_types.WikiPage"+ "$ref": "#/definitions/github_com_Tencent_WeKnora_internal_types.WikiPageDetail"}},"404": {@@ -24042,6 +24042,150 @@ const docTemplate = `{}}},+ "github_com_Tencent_WeKnora_internal_types.WikiPageDetail": {+ "type": "object",+ "properties": {+ "aliases": {+ "description": "Alternate names, abbreviations, acronyms or translated names",+ "type": "array",+ "items": {+ "type": "string"+ }+ },+ "category_path": {+ "description": "CategoryPath is the directory breadcrumb that groups this page in the\nwiki browser, e.g. [\"AI\", \"LLM 应用\", \"RAG\"]. Derived cache of the\nfolder chain identified by FolderID.",+ "type": "array",+ "items": {+ "type": "string"+ }+ },+ "chunk_refs": {+ "description": "ChunkRefs records the specific source-document chunks this page was\nbuilt from — one UUID per cited chunk. Populated during ingest from\nthe chunk-citation pass; refreshed wholesale whenever the page is\nre-materialized. Empty for summary pages (they are document-level\nsynopses and don't carry chunk-level citations). Use this when you\nneed to surface the underlying evidence for a wiki page, or to\nretract citations when a source document is deleted.",+ "type": "array",+ "items": {+ "type": "string"+ }+ },+ "content": {+ "description": "Full markdown content",+ "type": "string"+ },+ "created_at": {+ "description": "Creation time",+ "type": "string"+ },+ "deleted_at": {+ "description": "Soft delete",+ "allOf": [+ {+ "$ref": "#/definitions/gorm.DeletedAt"+ }+ ]+ },+ "depth": {+ "description": "Depth is len(CategoryPath), cached for filtering / display.",+ "type": "integer"+ },+ "folder_id": {+ "description": "FolderID is the single source of truth for where this page sits in the\ndirectory tree — a reference to wiki_folders.id (\"\" = wiki root). The\nCategoryPath / WikiPath / Depth fields below are denormalized caches\nrecomputed from this folder's chain on every write so list/index/search\nqueries don't have to join wiki_folders.",+ "type": "string"+ },+ "id": {+ "description": "Unique identifier (UUID)",+ "type": "string"+ },+ "in_link_titles": {+ "type": "object",+ "additionalProperties": {+ "type": "string"+ }+ },+ "in_links": {+ "description": "Slugs of pages that link TO this page (backlinks)",+ "type": "array",+ "items": {+ "type": "string"+ }+ },+ "knowledge_base_id": {+ "description": "Knowledge base this page belongs to",+ "type": "string"+ },+ "last_edit_source": {+ "description": "LastEditSource records who authored the CURRENT version: pipeline |\nagent | user | revert. Empty for legacy rows (treated as pipeline).\nWhen the version is superseded this value travels into the revision\nsnapshot, so each historical version keeps its own author kind.",+ "type": "string"+ },+ "last_editor_id": {+ "description": "LastEditorID is the user id of the caller that produced the current\nversion (empty for background pipeline writes).",+ "type": "string"+ },+ "out_links": {+ "description": "Slugs of pages this page links to (outbound links)",+ "type": "array",+ "items": {+ "type": "string"+ }+ },+ "page_metadata": {+ "description": "Arbitrary metadata (tags, categories, dates, etc.)",+ "type": "array",+ "items": {+ "type": "integer"+ }+ },+ "page_type": {+ "description": "Page type: summary, entity, concept, index, synthesis, comparison",+ "type": "string"+ },+ "parent_slug": {+ "description": "ParentSlug optionally points at the wiki page that should act as this\npage's semantic parent in the directory tree. The parent may be empty\nwhen the page is grouped only by FolderID.",+ "type": "string"+ },+ "slug": {+ "description": "URL-friendly slug for addressing, e.g. \"entity/acme-corp\", \"concept/rag\"\nUnique within a knowledge base",+ "type": "string"+ },+ "sort_order": {+ "description": "SortOrder allows generated or manually edited pages to control sibling\nordering before falling back to title.",+ "type": "integer"+ },+ "source_refs": {+ "description": "References to source knowledge IDs that contributed to this page.\nFormat matches the legacy \"\u003cknowledge_id\u003e|\u003cdoc_title\u003e\" convention used\nacross the ingest pipeline, so retract / display code can split on ` + "`" + `|` + "`" + `\nto recover the title. Document-level granularity.",+ "type": "array",+ "items": {+ "type": "string"+ }+ },+ "status": {+ "description": "Page status: draft, published, archived",+ "type": "string"+ },+ "summary": {+ "description": "One-line summary for index listing",+ "type": "string"+ },+ "tenant_id": {+ "description": "Workspace ID for multi-workspace isolation",+ "type": "integer"+ },+ "title": {+ "description": "Human-readable title",+ "type": "string"+ },+ "updated_at": {+ "description": "Last update time",+ "type": "string"+ },+ "version": {+ "description": "Version number. Incremented only when a user-visible content field\n(title, content, summary, page_type, status) actually changes; pure\nbookkeeping writes (link maintenance, same-content re-ingest, status\nsync from background jobs) leave it untouched so it can be used as a\nreal \"the page was edited\" signal.",+ "type": "integer"+ },+ "wiki_path": {+ "description": "WikiPath is a normalized, sortable path derived from page_type,\ncategory_path, and title. It keeps large directory listings cheap to sort.",+ "type": "string"+ }+ }+ },"github_com_Tencent_WeKnora_internal_types.WikiPageIssue": {"type": "object","properties": {diff --git a/docs/swagger.json b/docs/swagger.jsonindex 2e3fcdcd2..7f857e191 100644--- a/docs/swagger.json+++ b/docs/swagger.json@@ -7931,7 +7931,7 @@"Bearer": []}],- "description": "Retrieve a wiki page by its slug",+ "description": "Retrieve a wiki page by its slug, including titles of existing backlinks","produces": ["application/json"],@@ -7959,7 +7959,7 @@"200": {"description": "OK","schema": {- "$ref": "#/definitions/github_com_Tencent_WeKnora_internal_types.WikiPage"+ "$ref": "#/definitions/github_com_Tencent_WeKnora_internal_types.WikiPageDetail"}},"404": {@@ -24035,6 +24035,150 @@}}},+ "github_com_Tencent_WeKnora_internal_types.WikiPageDetail": {+ "type": "object",+ "properties": {+ "aliases": {+ "description": "Alternate names, abbreviations, acronyms or translated names",+ "type": "array",+ "items": {+ "type": "string"+ }+ },+ "category_path": {+ "description": "CategoryPath is the directory breadcrumb that groups this page in the\nwiki browser, e.g. [\"AI\", \"LLM 应用\", \"RAG\"]. Derived cache of the\nfolder chain identified by FolderID.",+ "type": "array",+ "items": {+ "type": "string"+ }+ },+ "chunk_refs": {+ "description": "ChunkRefs records the specific source-document chunks this page was\nbuilt from — one UUID per cited chunk. Populated during ingest from\nthe chunk-citation pass; refreshed wholesale whenever the page is\nre-materialized. Empty for summary pages (they are document-level\nsynopses and don't carry chunk-level citations). Use this when you\nneed to surface the underlying evidence for a wiki page, or to\nretract citations when a source document is deleted.",+ "type": "array",+ "items": {+ "type": "string"+ }+ },+ "content": {+ "description": "Full markdown content",+ "type": "string"+ },+ "created_at": {+ "description": "Creation time",+ "type": "string"+ },+ "deleted_at": {+ "description": "Soft delete",+ "allOf": [+ {+ "$ref": "#/definitions/gorm.DeletedAt"+ }+ ]+ },+ "depth": {+ "description": "Depth is len(CategoryPath), cached for filtering / display.",+ "type": "integer"+ },+ "folder_id": {+ "description": "FolderID is the single source of truth for where this page sits in the\ndirectory tree — a reference to wiki_folders.id (\"\" = wiki root). The\nCategoryPath / WikiPath / Depth fields below are denormalized caches\nrecomputed from this folder's chain on every write so list/index/search\nqueries don't have to join wiki_folders.",+ "type": "string"+ },+ "id": {+ "description": "Unique identifier (UUID)",+ "type": "string"+ },+ "in_link_titles": {+ "type": "object",+ "additionalProperties": {+ "type": "string"+ }+ },+ "in_links": {+ "description": "Slugs of pages that link TO this page (backlinks)",+ "type": "array",+ "items": {+ "type": "string"+ }+ },+ "knowledge_base_id": {+ "description": "Knowledge base this page belongs to",+ "type": "string"+ },+ "last_edit_source": {+ "description": "LastEditSource records who authored the CURRENT version: pipeline |\nagent | user | revert. Empty for legacy rows (treated as pipeline).\nWhen the version is superseded this value travels into the revision\nsnapshot, so each historical version keeps its own author kind.",+ "type": "string"+ },+ "last_editor_id": {+ "description": "LastEditorID is the user id of the caller that produced the current\nversion (empty for background pipeline writes).",+ "type": "string"+ },+ "out_links": {+ "description": "Slugs of pages this page links to (outbound links)",+ "type": "array",+ "items": {+ "type": "string"+ }+ },+ "page_metadata": {+ "description": "Arbitrary metadata (tags, categories, dates, etc.)",+ "type": "array",+ "items": {+ "type": "integer"+ }+ },+ "page_type": {+ "description": "Page type: summary, entity, concept, index, synthesis, comparison",+ "type": "string"+ },+ "parent_slug": {+ "description": "ParentSlug optionally points at the wiki page that should act as this\npage's semantic parent in the directory tree. The parent may be empty\nwhen the page is grouped only by FolderID.",+ "type": "string"+ },+ "slug": {+ "description": "URL-friendly slug for addressing, e.g. \"entity/acme-corp\", \"concept/rag\"\nUnique within a knowledge base",+ "type": "string"+ },+ "sort_order": {+ "description": "SortOrder allows generated or manually edited pages to control sibling\nordering before falling back to title.",+ "type": "integer"+ },+ "source_refs": {+ "description": "References to source knowledge IDs that contributed to this page.\nFormat matches the legacy \"\u003cknowledge_id\u003e|\u003cdoc_title\u003e\" convention used\nacross the ingest pipeline, so retract / display code can split on `|`\nto recover the title. Document-level granularity.",+ "type": "array",+ "items": {+ "type": "string"+ }+ },+ "status": {+ "description": "Page status: draft, published, archived",+ "type": "string"+ },+ "summary": {+ "description": "One-line summary for index listing",+ "type": "string"+ },+ "tenant_id": {+ "description": "Workspace ID for multi-workspace isolation",+ "type": "integer"+ },+ "title": {+ "description": "Human-readable title",+ "type": "string"+ },+ "updated_at": {+ "description": "Last update time",+ "type": "string"+ },+ "version": {+ "description": "Version number. Incremented only when a user-visible content field\n(title, content, summary, page_type, status) actually changes; pure\nbookkeeping writes (link maintenance, same-content re-ingest, status\nsync from background jobs) leave it untouched so it can be used as a\nreal \"the page was edited\" signal.",+ "type": "integer"+ },+ "wiki_path": {+ "description": "WikiPath is a normalized, sortable path derived from page_type,\ncategory_path, and title. It keeps large directory listings cheap to sort.",+ "type": "string"+ }+ }+ },"github_com_Tencent_WeKnora_internal_types.WikiPageIssue": {"type": "object","properties": {@@ -26438,4 +26582,4 @@"in": "header"}}-}\ No newline at end of file+}diff --git a/docs/swagger.yaml b/docs/swagger.yamlindex 3959aaf49..6e1ebcb37 100644--- a/docs/swagger.yaml+++ b/docs/swagger.yaml@@ -4919,6 +4919,148 @@ definitions:category_path, and title. It keeps large directory listings cheap to sort.type: stringtype: object+ github_com_Tencent_WeKnora_internal_types.WikiPageDetail:+ properties:+ aliases:+ description: Alternate names, abbreviations, acronyms or translated names+ items:+ type: string+ type: array+ category_path:+ description: |-+ CategoryPath is the directory breadcrumb that groups this page in the+ wiki browser, e.g. ["AI", "LLM 应用", "RAG"]. Derived cache of the+ folder chain identified by FolderID.+ items:+ type: string+ type: array+ chunk_refs:+ description: |-+ ChunkRefs records the specific source-document chunks this page was+ built from — one UUID per cited chunk. Populated during ingest from+ the chunk-citation pass; refreshed wholesale whenever the page is+ re-materialized. Empty for summary pages (they are document-level+ synopses and don't carry chunk-level citations). Use this when you+ need to surface the underlying evidence for a wiki page, or to+ retract citations when a source document is deleted.+ items:+ type: string+ type: array+ content:+ description: Full markdown content+ type: string+ created_at:+ description: Creation time+ type: string+ deleted_at:+ allOf:+ - $ref: '#/definitions/gorm.DeletedAt'+ description: Soft delete+ depth:+ description: Depth is len(CategoryPath), cached for filtering / display.+ type: integer+ folder_id:+ description: |-+ FolderID is the single source of truth for where this page sits in the+ directory tree — a reference to wiki_folders.id ("" = wiki root). The+ CategoryPath / WikiPath / Depth fields below are denormalized caches+ recomputed from this folder's chain on every write so list/index/search+ queries don't have to join wiki_folders.+ type: string+ id:+ description: Unique identifier (UUID)+ type: string+ in_link_titles:+ additionalProperties:+ type: string+ type: object+ in_links:+ description: Slugs of pages that link TO this page (backlinks)+ items:+ type: string+ type: array+ knowledge_base_id:+ description: Knowledge base this page belongs to+ type: string+ last_edit_source:+ description: |-+ LastEditSource records who authored the CURRENT version: pipeline |+ agent | user | revert. Empty for legacy rows (treated as pipeline).+ When the version is superseded this value travels into the revision+ snapshot, so each historical version keeps its own author kind.+ type: string+ last_editor_id:+ description: |-+ LastEditorID is the user id of the caller that produced the current+ version (empty for background pipeline writes).+ type: string+ out_links:+ description: Slugs of pages this page links to (outbound links)+ items:+ type: string+ type: array+ page_metadata:+ description: Arbitrary metadata (tags, categories, dates, etc.)+ items:+ type: integer+ type: array+ page_type:+ description: 'Page type: summary, entity, concept, index, synthesis, comparison'+ type: string+ parent_slug:+ description: |-+ ParentSlug optionally points at the wiki page that should act as this+ page's semantic parent in the directory tree. The parent may be empty+ when the page is grouped only by FolderID.+ type: string+ slug:+ description: |-+ URL-friendly slug for addressing, e.g. "entity/acme-corp", "concept/rag"+ Unique within a knowledge base+ type: string+ sort_order:+ description: |-+ SortOrder allows generated or manually edited pages to control sibling+ ordering before falling back to title.+ type: integer+ source_refs:+ description: |-+ References to source knowledge IDs that contributed to this page.+ Format matches the legacy "<knowledge_id>|<doc_title>" convention used+ across the ingest pipeline, so retract / display code can split on `|`+ to recover the title. Document-level granularity.+ items:+ type: string+ type: array+ status:+ description: 'Page status: draft, published, archived'+ type: string+ summary:+ description: One-line summary for index listing+ type: string+ tenant_id:+ description: Workspace ID for multi-workspace isolation+ type: integer+ title:+ description: Human-readable title+ type: string+ updated_at:+ description: Last update time+ type: string+ version:+ description: |-+ Version number. Incremented only when a user-visible content field+ (title, content, summary, page_type, status) actually changes; pure+ bookkeeping writes (link maintenance, same-content re-ingest, status+ sync from background jobs) leave it untouched so it can be used as a+ real "the page was edited" signal.+ type: integer+ wiki_path:+ description: |-+ WikiPath is a normalized, sortable path derived from page_type,+ category_path, and title. It keeps large directory listings cheap to sort.+ type: string+ type: objectgithub_com_Tencent_WeKnora_internal_types.WikiPageIssue:properties:created_at:@@ -11700,7 +11842,8 @@ paths:tags:- Wikiget:- description: Retrieve a wiki page by its slug+ description: Retrieve a wiki page by its slug, including titles of existing+ backlinksparameters:- description: Knowledge base IDin: path@@ -11718,7 +11861,7 @@ paths:"200":description: OKschema:- $ref: '#/definitions/github_com_Tencent_WeKnora_internal_types.WikiPage'+ $ref: '#/definitions/github_com_Tencent_WeKnora_internal_types.WikiPageDetail'"404":description: Not Foundschema:diff --git a/docs/swagger_contract_test.go b/docs/swagger_contract_test.goindex 09161fa24..302d9c98d 100644--- a/docs/swagger_contract_test.go+++ b/docs/swagger_contract_test.go@@ -79,6 +79,47 @@ func TestFAQEnabledFilterContract(t *testing.T) {}}+func TestWikiPageBacklinkTitlesContract(t *testing.T) {+ for _, tt := range swaggerDocuments() {+ t.Run(tt.name, func(t *testing.T) {+ var spec struct {+ Paths map[string]map[string]struct {+ Responses map[string]struct {+ Schema struct {+ Ref string `json:"$ref" yaml:"$ref"`+ } `json:"schema" yaml:"schema"`+ } `json:"responses" yaml:"responses"`+ } `json:"paths" yaml:"paths"`+ Definitions map[string]struct {+ Properties map[string]map[string]any `json:"properties" yaml:"properties"`+ } `json:"definitions" yaml:"definitions"`+ }+ if err := tt.parse(tt.loadSpec(t), &spec); err != nil {+ t.Fatal(err)+ }+ const detail = "github_com_Tencent_WeKnora_internal_types.WikiPageDetail"+ get := spec.Paths["/knowledgebase/{kb_id}/wiki/pages/{slug}"]["get"]+ if get.Responses["200"].Schema.Ref != "#/definitions/"+detail {+ t.Fatal("page detail response must expose backlink titles")+ }+ properties := spec.Definitions[detail].Properties+ titles := properties["in_link_titles"]+ values, ok := titles["additionalProperties"].(map[string]any)+ if titles["type"] != "object" || !ok || values["type"] != "string" {+ t.Fatal("in_link_titles must be a string-valued map")+ }+ for field := range spec.Definitions["github_com_Tencent_WeKnora_internal_types.WikiPage"].Properties {+ if _, ok := properties[field]; !ok {+ t.Errorf("page detail dropped existing field %s", field)+ }+ }+ if _, ok := spec.Paths["/knowledgebase/{kb_id}/wiki/page-titles"]; ok {+ t.Fatal("obsolete standalone title endpoint remains documented")+ }+ })+ }+}+func readSwaggerFile(t *testing.T, name string) []byte {t.Helper()data, err := os.ReadFile(name)diff --git a/frontend/src/api/wiki/index.ts b/frontend/src/api/wiki/index.tsindex ea5f295a8..028558983 100644--- a/frontend/src/api/wiki/index.ts+++ b/frontend/src/api/wiki/index.ts@@ -27,6 +27,8 @@ export interface WikiPage {sort_order?: number;source_refs: string[];in_links: string[];+ // Present on page detail responses; list and mutation responses omit it.+ in_link_titles?: Record<string, string>;out_links: string[];page_metadata: Record<string, any>;version: number;diff --git a/frontend/src/views/knowledge/wiki/WikiBrowser.vue b/frontend/src/views/knowledge/wiki/WikiBrowser.vueindex 2b68c6c1f..1d0f65b7c 100644--- a/frontend/src/views/knowledge/wiki/WikiBrowser.vue+++ b/frontend/src/views/knowledge/wiki/WikiBrowser.vue@@ -809,6 +809,7 @@ import {expandedWikiDirectoryPaths,expandWikiDirectoryPath,} from './wikiDirectoryState'+import { resolveWikiBacklinkTitle } from './wikiBacklinkTitles'import { getKnowledgeDetails } from '@/api/knowledge-base'import { createSessions } from '@/api/chat'import ChatView from '@/views/chat/index.vue'@@ -2947,7 +2948,8 @@ async function savePageEdit(versionOverride?: number) {version: versionOverride ?? editBaseVersion.value,})const updated = ((res as any).data || res) as WikiPage- selectedPage.value = updated+ // Updates omit the display-only titles; retain the current detail map.+ selectedPage.value = { ...selectedPage.value, ...updated }editingPage.value = falseeditConflictVersion.value = nullupdateSidebarPageTitle(slug, updated.title)@@ -3699,12 +3701,7 @@ function formatDate(dateStr: string) {// Convert slug like "entity/acme-corp" to a readable label "acme-corp"function slugDisplayName(slug: string): string {- // Find the page title if loaded- const page = pages.value.find(p => p.slug === slug)- if (page) return page.title- // Fallback: strip type prefix, replace hyphens- const parts = slug.split('/')- return parts.length > 1 ? parts.slice(1).join('/') : slug+ return resolveWikiBacklinkTitle(slug, selectedPage.value?.in_link_titles ?? {}, pages.value)}// ─── Graph Rendering (interactive SVG force-directed graph) ───diff --git a/frontend/src/views/knowledge/wiki/wikiBacklinkBrowser.test.ts b/frontend/src/views/knowledge/wiki/wikiBacklinkBrowser.test.tsnew file mode 100644index 000000000..6f6b550e8--- /dev/null+++ b/frontend/src/views/knowledge/wiki/wikiBacklinkBrowser.test.ts@@ -0,0 +1,167 @@+import assert from 'node:assert/strict'+import { readFileSync } from 'node:fs'+import { createRequire } from 'node:module'+import test from 'node:test'+import { fileURLToPath } from 'node:url'+import { runInNewContext } from 'node:vm'+import { compileScript, parse } from '@vue/compiler-sfc'+import ts from 'typescript'+import { createRenderer, nextTick } from 'vue'++const require = createRequire(import.meta.url)+const filename = fileURLToPath(new URL('./WikiBrowser.vue', import.meta.url))+const { descriptor } = parse(readFileSync(filename, 'utf8'), { filename })+const script = compileScript(descriptor, { id: 'wiki-backlink-browser-test' }).content+ .replace('__expose();', '')+ .replace('return __returned__', '__expose(__returned__); return __returned__')+const compiled = ts.transpileModule(script, {+ compilerOptions: { module: ts.ModuleKind.CommonJS, target: ts.ScriptTarget.ES2022 },+}).outputText++function page(slug: string, titles: Record<string, string> = {}) {+ return { id: slug, slug, title: slug, content: '', version: 1, in_links: Object.keys(titles), in_link_titles: titles }+}++async function fixture() {+ const calls: { name: string; args: any[] }[] = []+ const errors: unknown[][] = []+ let response: any = page('first')+ let failure: Error | undefined+ const api = {+ getWikiPage: async (...args: any[]) => {+ calls.push({ name: 'getWikiPage', args })+ if (failure) throw failure+ return { data: response }+ },+ updateWikiPage: async (...args: any[]) => {+ calls.push({ name: 'updateWikiPage', args })+ const { in_link_titles, ...updated } = response+ return { data: { ...updated, ...args[2], version: updated.version + 1 } }+ },+ listWikiIssues: async () => [],+ listWikiPages: async () => ({ pages: [], total: 0 }),+ listWikiFolders: async () => ({ folders: [] }),+ getWikiIndex: async () => ({ groups: [] }),+ getWikiStats: async () => ({}),+ }+ const exports: any = {}+ runInNewContext(compiled, {+ exports, console: { error: (...args: unknown[]) => errors.push(args) },+ setTimeout, clearTimeout, setInterval, clearInterval,+ localStorage: { getItem: () => null, setItem() {} },+ require(name: string) {+ if (name === 'vue' || name === 'marked') return require(name)+ if (name === 'vue-router') return { useRouter: () => ({}), useRoute: () => ({ query: {} }) }+ if (name === 'vue-i18n') return { useI18n: () => ({ t: (key: string) => key }) }+ if (name === '@/stores/menu') return { useMenuStore: () => ({}) }+ if (name === '@/stores/settings') return { useSettingsStore: () => ({}) }+ if (name === '@/api/wiki') return api+ if (name === 'tdesign-vue-next') return { MessagePlugin: { success() {}, error() {} } }+ // DOM sanitization has separate tests; this fixture exercises the actual+ // component's title resolution and Markdown caller before that boundary.+ if (name === '@/utils/security') return { sanitizeMarkdownHTML: (html: string) => html, hydrateProtectedFileImages: async () => {} }+ if (name.startsWith('./wiki')) return require(`${name}.ts`)+ if (name === '@/utils/markedLiteralTilde') return require('../../../utils/markedLiteralTilde.ts')+ if (name.endsWith('.vue') || ['vue-virtual-scroller', '@/api/knowledge-base', '@/api/chat'].includes(name)) return { default: {} }+ throw new Error(`Unexpected component dependency: ${name}`)+ },+ })+ exports.default.render = () => null+ const renderer = createRenderer<any, any>({+ createElement: () => ({}), createText: () => ({}), createComment: () => ({}),+ insert() {}, remove() {}, setElementText() {}, setText() {}, patchProp() {},+ parentNode: () => null, nextSibling: () => null,+ })+ const app = renderer.createApp(exports.default, { knowledgeBaseId: 'kb-1' })+ const vm: any = app.mount({})+ await new Promise(resolve => setImmediate(resolve))+ await nextTick()+ return {+ vm, calls, errors,+ respond(value: any) { response = value; failure = undefined },+ fail() { failure = new Error('page lookup failed') },+ close: () => app.unmount(),+ }+}++test('page navigation consumes all response titles without a separate title request', async () => {+ const f = await fixture()+ try {+ const titles = Object.fromEntries(Array.from({ length: 2507 }, (_, i) => [`concept/${i}-${'a'.repeat(200)}`, `标题 ${i}`]))+ f.respond(page('first', titles))+ await f.vm.selectPage({ id: 'first', slug: 'first' })+ await nextTick()+ for (const [slug, title] of Object.entries(titles)) assert.equal(f.vm.slugDisplayName(slug), title)+ assert.equal(f.calls.length, 1)+ assert.deepEqual(f.calls[0], { name: 'getWikiPage', args: ['kb-1', 'first'] })+ assert.equal(f.errors.length, 0)+ } finally { f.close() }+})++test('navigation, same-page refresh, history and clearing use the matching page map', async () => {+ const f = await fixture()+ try {+ f.respond(page('first', { 'concept/shared': 'First title' }))+ await f.vm.selectPage({ id: 'first', slug: 'first' })+ f.respond(page('second', { 'concept/shared': 'Second title' }))+ await f.vm.navigateToSlug('second')+ assert.equal(f.vm.slugDisplayName('concept/shared'), 'Second title')+ f.respond(page('second', { 'concept/shared': 'Refreshed title' }))+ await f.vm.refreshSelectedPage()+ assert.equal(f.vm.slugDisplayName('concept/shared'), 'Refreshed title')+ f.vm.goBack()+ assert.equal(f.vm.selectedPage.slug, 'first')+ assert.equal(f.vm.slugDisplayName('concept/shared'), 'First title')+ f.vm.selectedPage = null+ assert.equal(f.vm.slugDisplayName('concept/shared'), 'shared')+ assert.equal(f.errors.length, 0)+ } finally { f.close() }+})++test('Markdown caller handles prototype names, missing titles and explicit labels', async () => {+ const f = await fixture()+ try {+ f.respond(page('current'))+ await f.vm.navigateToSlug('current')+ for (const slug of ['constructor', 'toString', '__proto__', 'hasOwnProperty']) {+ const html = f.vm.renderMarkdown(`[[${slug}]]`)+ assert.ok(html.includes(`data-slug="${slug}"`))+ assert.ok(html.includes(`>${require('marked').marked.parseInline(slug)}</a>`))+ assert.match(f.vm.renderMarkdown(`[[${slug}|Explicit label]]`), />Explicit label<\/a>/)+ }+ f.vm.pages = [{ slug: 'concept/loaded', title: 'Loaded title' }]+ assert.match(f.vm.renderMarkdown('[[concept/loaded]] [[concept/missing]]'), />Loaded title<\/a>.*>missing<\/a>/)+ f.respond(page('current', JSON.parse('{"constructor":"构造函数","__proto__":"原型"}')))+ await f.vm.refreshSelectedPage()+ assert.match(f.vm.renderMarkdown('[[constructor]] [[__proto__]]'), />构造函数<\/a>.*>原型<\/a>/)+ assert.equal(f.errors.length, 0)+ } finally { f.close() }+})++test('saving page edits retains titles omitted from the mutation response', async () => {+ const f = await fixture()+ try {+ f.respond(page('current', { 'concept/unloaded': 'Unloaded title' }))+ await f.vm.navigateToSlug('current')+ await nextTick()+ f.vm.startEditPage()+ f.vm.editForm.title = 'Edited title'+ await f.vm.savePageEdit()+ assert.equal(f.vm.selectedPage.title, 'Edited title')+ assert.equal(f.vm.slugDisplayName('concept/unloaded'), 'Unloaded title')+ assert.equal(f.errors.length, 0)+ } finally { f.close() }+})++test('failed navigation retains the displayed page and reports the failure', async () => {+ const f = await fixture()+ try {+ f.respond(page('first', { 'concept/shared': 'First title' }))+ await f.vm.navigateToSlug('first')+ f.fail()+ await f.vm.navigateToSlug('second')+ assert.equal(f.vm.selectedPage.slug, 'first')+ assert.equal(f.vm.slugDisplayName('concept/shared'), 'First title')+ assert.equal(f.errors.length, 1)+ } finally { f.close() }+})diff --git a/frontend/src/views/knowledge/wiki/wikiBacklinkTitles.test.ts b/frontend/src/views/knowledge/wiki/wikiBacklinkTitles.test.tsnew file mode 100644index 000000000..9e723061b--- /dev/null+++ b/frontend/src/views/knowledge/wiki/wikiBacklinkTitles.test.ts@@ -0,0 +1,45 @@+import assert from 'node:assert/strict'+import test from 'node:test'++import { resolveWikiBacklinkTitle } from './wikiBacklinkTitles.ts'++test('uses the response title for an unloaded backlink', () => {+ assert.equal(+ resolveWikiBacklinkTitle(+ 'concept/gong-si-zi-ben-zhi-du',+ { 'concept/gong-si-zi-ben-zhi-du': '公司资本制度' },+ [],+ ),+ '公司资本制度',+ )+})++test('only uses own string titles and preserves fallback for prototype property names', () => {+ for (const slug of ['constructor', 'toString', '__proto__', 'hasOwnProperty']) {+ assert.equal(resolveWikiBacklinkTitle(slug, {}, []), slug)+ assert.equal(resolveWikiBacklinkTitle(slug, {}, [{ slug, title: 'Loaded title' }]), 'Loaded title')+ const titles = JSON.parse(JSON.stringify({ [slug]: ' 中文标题 ' }))+ assert.equal(resolveWikiBacklinkTitle(slug, titles, []), '中文标题')+ }+ const inherited = Object.create({ 'concept/page': 'Inherited title' })+ assert.equal(resolveWikiBacklinkTitle('concept/page', inherited, []), 'page')+ for (const value of [undefined, null, 42, true, {}, [], () => 'title', '', ' ']) {+ const titles = { 'concept/page': value } as unknown as Record<string, string>+ assert.equal(resolveWikiBacklinkTitle('concept/page', titles, []), 'page')+ assert.equal(resolveWikiBacklinkTitle('concept/page', titles, [{ slug: 'concept/page', title: 'Loaded' }]), 'Loaded')+ }+})++test('prefers the response title and retains hierarchical slug fallback', () => {+ assert.equal(resolveWikiBacklinkTitle('concept/a', { 'concept/a': ' Current ' }, [{ slug: 'concept/a', title: 'Old' }]), 'Current')+ assert.equal(resolveWikiBacklinkTitle('concept/a/b', {}, []), 'a/b')+ assert.equal(resolveWikiBacklinkTitle('', {}, []), '')+})++test('keeps loaded page titles and slug fallback behavior', () => {+ assert.equal(+ resolveWikiBacklinkTitle('entity/acme', {}, [{ slug: 'entity/acme', title: 'Acme' }]),+ 'Acme',+ )+ assert.equal(resolveWikiBacklinkTitle('concept/unknown-page', {}, []), 'unknown-page')+})diff --git a/frontend/src/views/knowledge/wiki/wikiBacklinkTitles.ts b/frontend/src/views/knowledge/wiki/wikiBacklinkTitles.tsnew file mode 100644index 000000000..3db0d0944--- /dev/null+++ b/frontend/src/views/knowledge/wiki/wikiBacklinkTitles.ts@@ -0,0 +1,23 @@+export interface WikiBacklinkPage {+ slug: string+ title: string+}++// Resolve a backlink using the page detail's title map first, then pages+// already loaded in the sidebar, and finally the historical slug fallback.+export function resolveWikiBacklinkTitle(+ slug: string,+ titles: Record<string, string>,+ pages: WikiBacklinkPage[],+): string {+ if (Object.prototype.hasOwnProperty.call(titles, slug)) {+ const value = titles[slug]+ if (typeof value === 'string' && value.trim()) return value.trim()+ }++ const loadedPage = pages.find(page => page.slug === slug)+ if (loadedPage?.title) return loadedPage.title++ const parts = slug.split('/')+ return parts.length > 1 ? parts.slice(1).join('/') : slug+}diff --git a/internal/handler/wiki_page.go b/internal/handler/wiki_page.goindex fb8e07008..602d6050a 100644--- a/internal/handler/wiki_page.go+++ b/internal/handler/wiki_page.go@@ -405,12 +405,12 @@ func (h *WikiPageHandler) recordManualWikiActivity(// GetPage godoc// @Summary Get a wiki page by slug-// @Description Retrieve a wiki page by its slug+// @Description Retrieve a wiki page by its slug, including titles of existing backlinks// @Tags Wiki// @Produce json// @Param kb_id path string true "Knowledge base ID"// @Param slug path string true "Page slug"-// @Success 200 {object} types.WikiPage+// @Success 200 {object} types.WikiPageDetail// @Failure 404 {object} errors.AppError// @Security Bearer// @Router /knowledgebase/{kb_id}/wiki/pages/{slug} [get]@@ -437,7 +437,24 @@ func (h *WikiPageHandler) GetPage(c *gin.Context) {return}- c.JSON(http.StatusOK, page)+ titles := make(map[string]string, len(page.InLinks))+ // Bound SQL parameters while resolving every backlink, including pages+ // outside the sidebar's paginated window.+ const batchSize = 1000+ for start := 0; start < len(page.InLinks); start += batchSize {+ end := min(start+batchSize, len(page.InLinks))+ pages, err := h.wikiService.ListBySlugs(c.Request.Context(), kbID, page.InLinks[start:end])+ if err != nil {+ c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})+ return+ }+ for slug, backlink := range pages {+ if backlink != nil {+ titles[slug] = backlink.Title+ }+ }+ }+ c.JSON(http.StatusOK, types.WikiPageDetail{WikiPage: page, InLinkTitles: titles})}// UpdatePage godocdiff --git a/internal/handler/wiki_page_titles_test.go b/internal/handler/wiki_page_titles_test.gonew file mode 100644index 000000000..18b3cd2ca--- /dev/null+++ b/internal/handler/wiki_page_titles_test.go@@ -0,0 +1,270 @@+package handler++import (+ "context"+ "encoding/json"+ "errors"+ "fmt"+ "net/http"+ "net/http/httptest"+ "strings"+ "testing"++ "github.com/Tencent/WeKnora/internal/application/repository"+ "github.com/Tencent/WeKnora/internal/application/service"+ "github.com/Tencent/WeKnora/internal/types"+ "github.com/Tencent/WeKnora/internal/types/interfaces"+ "github.com/gin-gonic/gin"+ "github.com/stretchr/testify/assert"+ "github.com/stretchr/testify/require"+ "gorm.io/driver/sqlite"+ "gorm.io/gorm"+)++type fakeWikiPageTitlesService struct {+ interfaces.WikiPageService+ page *types.WikiPage+ pages map[string]*types.WikiPageLite+ got []string+ getErr error+ lookupErr error+ failAfter int+ lookupKBs []string+ getKB string+ getSlug string+}++func (f *fakeWikiPageTitlesService) GetPageBySlug(_ context.Context, kbID, slug string) (*types.WikiPage, error) {+ f.getKB, f.getSlug = kbID, slug+ return f.page, f.getErr+}++func (f *fakeWikiPageTitlesService) ListBySlugs(+ _ context.Context, kbID string, slugs []string,+) (map[string]*types.WikiPageLite, error) {+ f.lookupKBs = append(f.lookupKBs, kbID)+ if f.lookupErr != nil && len(f.got) >= f.failAfter {+ return nil, f.lookupErr+ }+ f.got = append(f.got, slugs...)+ out := make(map[string]*types.WikiPageLite)+ for _, slug := range slugs {+ if page, ok := f.pages[slug]; ok {+ out[slug] = page+ }+ }+ return out, nil+}++type fakeWikiPageTitlesKBService struct {+ interfaces.KnowledgeBaseService+ err error+ disabled bool+}++func (f fakeWikiPageTitlesKBService) GetKnowledgeBaseByID(+ context.Context, string,+) (*types.KnowledgeBase, error) {+ if f.err != nil {+ return nil, f.err+ }+ if f.disabled {+ return &types.KnowledgeBase{}, nil+ }+ return &types.KnowledgeBase{+ Type: types.KnowledgeBaseTypeWiki,+ IndexingStrategy: types.IndexingStrategy{WikiEnabled: true},+ }, nil+}++func wikiPageTitlesEngine(h *WikiPageHandler) *gin.Engine {+ gin.SetMode(gin.TestMode)+ r := gin.New()+ r.GET("/knowledgebase/:kb_id/wiki/pages/*slug", h.GetPage)+ return r+}++func TestGetPageResolvesBacklinkTitles(t *testing.T) {+ fake := &fakeWikiPageTitlesService{+ page: &types.WikiPage{+ ID: "page-id", KnowledgeBaseID: "kb-1", Slug: "concept/current",+ Title: "当前页面", Content: "正文", Version: 7,+ InLinks: types.StringArray{+ "concept/a", "concept/a", "entity/b", "missing", "nil-page", "constructor", "__proto__",+ },+ },+ pages: map[string]*types.WikiPageLite{+ "concept/a": {Slug: "concept/a", Title: "概念 A"},+ "entity/b": {Slug: "entity/b", Title: "实体 B"},+ "nil-page": nil,+ "constructor": {Slug: "constructor", Title: "构造函数"},+ "__proto__": {Slug: "__proto__", Title: "原型"},+ },+ }+ rec := requestWikiPageTitles(fake, fakeWikiPageTitlesKBService{}, "concept/current")+ require.Equal(t, http.StatusOK, rec.Code)+ assert.Equal(t, "kb-1", fake.getKB)+ assert.Equal(t, "concept/current", fake.getSlug)+ for _, kbID := range fake.lookupKBs {+ assert.Equal(t, "kb-1", kbID)+ }+ var body types.WikiPageDetail+ require.NoError(t, json.Unmarshal(rec.Body.Bytes(), &body))+ expectedPage, err := json.Marshal(fake.page)+ require.NoError(t, err)+ actualPage, err := json.Marshal(body.WikiPage)+ require.NoError(t, err)+ assert.JSONEq(t, string(expectedPage), string(actualPage))+ assert.Equal(t, map[string]string{+ "concept/a": "概念 A",+ "entity/b": "实体 B",+ "constructor": "构造函数",+ "__proto__": "原型",+ }, body.InLinkTitles)+}++func requestWikiPageTitles(+ fake *fakeWikiPageTitlesService, kb fakeWikiPageTitlesKBService, slug string,+) *httptest.ResponseRecorder {+ h := &WikiPageHandler{wikiService: fake, kbService: kb}+ rec := httptest.NewRecorder()+ req := httptest.NewRequest(http.MethodGet, "/knowledgebase/kb-1/wiki/pages/"+slug, nil)+ wikiPageTitlesEngine(h).ServeHTTP(rec, req)+ return rec+}++func TestGetPageResolvesAllLargeAndLongBacklinkSets(t *testing.T) {+ // Cross several lookup boundaries so earlier results cannot be silently lost.+ for _, count := range []int{999, 1000, 1001, 2507} {+ t.Run(fmt.Sprint(count), func(t *testing.T) {+ fake := &fakeWikiPageTitlesService{+ page: &types.WikiPage{Slug: "current"}, pages: map[string]*types.WikiPageLite{},+ }+ for i := 0; i < count; i++ {+ slug := fmt.Sprintf("concept/%d-%s", i, strings.Repeat("a", 200))+ fake.page.InLinks = append(fake.page.InLinks, slug)+ fake.pages[slug] = &types.WikiPageLite{Slug: slug, Title: fmt.Sprintf("标题 %d", i)}+ }+ rec := requestWikiPageTitles(fake, fakeWikiPageTitlesKBService{}, "current")+ require.Equal(t, http.StatusOK, rec.Code)+ var body types.WikiPageDetail+ require.NoError(t, json.Unmarshal(rec.Body.Bytes(), &body))+ require.Len(t, body.InLinkTitles, count)+ assert.ElementsMatch(t, []string(fake.page.InLinks), fake.got)+ for slug, page := range fake.pages {+ assert.Equal(t, page.Title, body.InLinkTitles[slug])+ }+ })+ }+}++func TestGetPageReturnsEmptyTitleObject(t *testing.T) {+ for _, links := range []types.StringArray{nil, {}, {"missing"}} {+ fake := &fakeWikiPageTitlesService{page: &types.WikiPage{Slug: "current", InLinks: links}}+ rec := requestWikiPageTitles(fake, fakeWikiPageTitlesKBService{}, "current")+ require.Equal(t, http.StatusOK, rec.Code)+ var body map[string]json.RawMessage+ require.NoError(t, json.Unmarshal(rec.Body.Bytes(), &body))+ assert.JSONEq(t, `{}`, string(body["in_link_titles"]))+ if len(links) == 0 {+ assert.Empty(t, fake.lookupKBs)+ }+ }+}++func TestGetPageTitleLookupFailureDoesNotReturnPartialSuccess(t *testing.T) {+ for _, failAfter := range []int{0, 1000} {+ t.Run(fmt.Sprint(failAfter), func(t *testing.T) {+ fake := &fakeWikiPageTitlesService{+ page: &types.WikiPage{Slug: "current"}, pages: map[string]*types.WikiPageLite{},+ lookupErr: errors.New("title query failed"), failAfter: failAfter,+ }+ for i := 0; i < 2001; i++ {+ slug := fmt.Sprintf("concept/%d", i)+ fake.page.InLinks = append(fake.page.InLinks, slug)+ fake.pages[slug] = &types.WikiPageLite{Slug: slug, Title: "Title"}+ }+ rec := requestWikiPageTitles(fake, fakeWikiPageTitlesKBService{}, "current")+ assert.Equal(t, http.StatusInternalServerError, rec.Code)+ assert.JSONEq(t, `{"error":"title query failed"}`, rec.Body.String())+ })+ }+}++func TestGetPageValidatesBeforeTitleLookup(t *testing.T) {+ for _, tc := range []struct {+ name string+ slug string+ kb fakeWikiPageTitlesKBService+ getErr error+ status int+ }{+ {"missing slug", "", fakeWikiPageTitlesKBService{}, nil, http.StatusBadRequest},+ {+ "inaccessible KB", "current",+ fakeWikiPageTitlesKBService{err: errors.New("denied")},+ nil, http.StatusBadRequest,+ },+ {"wiki disabled", "current", fakeWikiPageTitlesKBService{disabled: true}, nil, http.StatusBadRequest},+ {"missing page", "current", fakeWikiPageTitlesKBService{}, repository.ErrWikiPageNotFound, http.StatusNotFound},+ {+ "page query failure", "current",+ fakeWikiPageTitlesKBService{},+ errors.New("page query failed"), http.StatusInternalServerError,+ },+ } {+ t.Run(tc.name, func(t *testing.T) {+ fake := &fakeWikiPageTitlesService{getErr: tc.getErr}+ rec := requestWikiPageTitles(fake, tc.kb, tc.slug)+ assert.Equal(t, tc.status, rec.Code)+ assert.Empty(t, fake.lookupKBs)+ })+ }+}++func TestGetPageBacklinkTitlesThroughRepository(t *testing.T) {+ db, err := gorm.Open(sqlite.Open(":memory:"), &gorm.Config{})+ require.NoError(t, err)+ sqlDB, err := db.DB()+ require.NoError(t, err)+ sqlDB.SetMaxOpenConns(1)+ t.Cleanup(func() { require.NoError(t, sqlDB.Close()) })+ require.NoError(t, db.AutoMigrate(&types.WikiPage{}))+ current := &types.WikiPage{ID: "current", KnowledgeBaseID: "kb-1", Slug: "current", Title: "Current"}+ pages := make([]types.WikiPage, 0, 2507)+ for i := 0; i < 2507; i++ {+ slug := fmt.Sprintf("concept/%d-%s", i, strings.Repeat("a", 200))+ current.InLinks = append(current.InLinks, slug)+ pages = append(pages, types.WikiPage{+ ID: fmt.Sprint(i), KnowledgeBaseID: "kb-1", Slug: slug, Title: fmt.Sprintf("标题 %d", i),+ })+ }+ current.InLinks = append(current.InLinks, "other-kb-only", "deleted", "missing")+ require.NoError(t, db.CreateInBatches(pages, 100).Error)+ require.NoError(t, db.Create(current).Error)+ require.NoError(t, db.Create(&types.WikiPage{+ ID: "other", KnowledgeBaseID: "kb-2", Slug: "other-kb-only", Title: "Private",+ }).Error)+ // Seed a target that was soft-deleted before the request.+ require.NoError(t, db.Exec(`INSERT INTO wiki_pages (id, knowledge_base_id, slug, title, deleted_at)+ VALUES (?, ?, ?, ?, CURRENT_TIMESTAMP)`,+ "deleted", "kb-1", "deleted", "Deleted title").Error)+ repo := repository.NewWikiPageRepository(db)+ h := &WikiPageHandler{+ wikiService: service.NewWikiPageService(repo, nil, nil, nil, nil, nil),+ kbService: fakeWikiPageTitlesKBService{},+ }+ rec := httptest.NewRecorder()+ req := httptest.NewRequest(http.MethodGet, "/knowledgebase/kb-1/wiki/pages/current", nil)+ wikiPageTitlesEngine(h).ServeHTTP(rec, req)+ require.Equal(t, http.StatusOK, rec.Code)+ var body types.WikiPageDetail+ require.NoError(t, json.Unmarshal(rec.Body.Bytes(), &body))+ require.Len(t, body.InLinkTitles, len(pages))+ for _, page := range pages {+ assert.Equal(t, page.Title, body.InLinkTitles[page.Slug])+ }+ assert.NotContains(t, body.InLinkTitles, "other-kb-only")+ assert.NotContains(t, body.InLinkTitles, "deleted")+ assert.NotContains(t, body.InLinkTitles, "missing")+}diff --git a/internal/types/wiki_page.go b/internal/types/wiki_page.goindex 8d17d0ac5..b40d18f17 100644--- a/internal/types/wiki_page.go+++ b/internal/types/wiki_page.go@@ -273,6 +273,13 @@ type WikiPage struct {DeletedAt gorm.DeletedAt `json:"deleted_at" gorm:"index"`}+// WikiPageDetail adds display titles to the page detail response without+// persisting them or loading backlink content.+type WikiPageDetail struct {+ *WikiPage+ InLinkTitles map[string]string `json:"in_link_titles"`+}+// TableName specifies the database table namefunc (WikiPage) TableName() string {return "wiki_pages"diff --git a/website-docs/04-api/02-api-faq-wiki.md b/website-docs/04-api/02-api-faq-wiki.mdindex f959ed4de..40536b690 100644--- a/website-docs/04-api/02-api-faq-wiki.md+++ b/website-docs/04-api/02-api-faq-wiki.md@@ -241,7 +241,7 @@ curl -X PUT $BASE/api/v1/knowledgebase/kb-1/wiki/move-page -H "Authorization: Be用途:获取页面(`*slug` 为通配路径)。-响应:200 `WikiPage`+响应:200 `WikiPageDetail`。保留 `WikiPage` 的所有字段,并增加 `in_link_titles`,将 `in_links` 中存在的页面 slug 映射为展示标题,例如 `{"concept/example":"示例标题"}`。没有可解析的反向链接时返回空对象;不存在的目标不出现在映射中。标题查询失败时返回 500,避免返回不完整的成功响应。```bashcurl $BASE/api/v1/knowledgebase/kb-1/wiki/pages/overview -H "Authorization: Bearer $TOKEN"