From 84edfa5439f300e8706b868aa1dd2c5173b5b78b Mon Sep 17 00:00:00 2001 From: wizardchen Date: Fri, 10 Apr 2026 21:35:28 +0800 Subject: [PATCH] feat: Implement wiki editing functionalities and UI components - Added new tools for wiki page editing, including writing, replacing text, renaming, and deleting pages, with corresponding data structures for each action. - Enhanced the frontend with a new `WikiEditResult` component to display results of wiki edits, supporting multiple languages for improved accessibility. - Updated localization files for English and Chinese to include new strings related to wiki actions. - Modified existing tools to return structured data for wiki actions, improving the clarity and usability of the output messages. These changes significantly enhance the wiki editing capabilities, providing users with a more robust and user-friendly experience when managing wiki content. --- frontend/src/i18n/locales/en-US.ts | 18 + frontend/src/i18n/locales/zh-CN.ts | 18 + frontend/src/types/tool-results.ts | 53 ++- .../chat/components/ToolResultRenderer.vue | 10 +- .../tool-results/WikiEditResult.vue | 318 ++++++++++++++++++ internal/agent/tools/wiki_delete_page.go | 16 +- internal/agent/tools/wiki_rename_page.go | 17 +- internal/agent/tools/wiki_replace_text.go | 17 +- internal/agent/tools/wiki_tools.go | 8 + internal/agent/tools/wiki_write_page.go | 19 +- 10 files changed, 483 insertions(+), 11 deletions(-) create mode 100644 frontend/src/views/chat/components/tool-results/WikiEditResult.vue diff --git a/frontend/src/i18n/locales/en-US.ts b/frontend/src/i18n/locales/en-US.ts index 5380bfc0..facbdb36 100755 --- a/frontend/src/i18n/locales/en-US.ts +++ b/frontend/src/i18n/locales/en-US.ts @@ -2030,6 +2030,24 @@ export default { noKnowledgeBases: 'No knowledge bases available', enterDescription: 'Enter description', rawOutputLabel: 'Raw output', + wikiWritePageTitle: 'Wiki Page Write', + wikiReplaceTextTitle: 'Wiki Text Replace', + wikiRenamePageTitle: 'Wiki Page Rename', + wikiDeletePageTitle: 'Wiki Page Delete', + wikiActionCreated: 'Created', + wikiActionUpdated: 'Updated', + wikiActionRenamed: 'Renamed', + wikiActionDeleted: 'Deleted', + wikiFieldSlug: 'Slug', + wikiFieldTitle: 'Title', + wikiFieldPageType: 'Type', + wikiFieldSummary: 'Summary', + wikiFieldOldText: 'Old text', + wikiFieldNewText: 'New text', + wikiFieldOldSlug: 'Old slug', + wikiFieldNewSlug: 'New slug', + wikiFieldAffectedPages: 'Affected pages', + wikiAffectedCount: '{count} page link(s) updated', selectKnowledgeBaseWarning: 'Please select at least one knowledge base', processError: 'Processing error', sessionExcerpt: 'Session Excerpt', diff --git a/frontend/src/i18n/locales/zh-CN.ts b/frontend/src/i18n/locales/zh-CN.ts index b3b10929..aa8625e5 100755 --- a/frontend/src/i18n/locales/zh-CN.ts +++ b/frontend/src/i18n/locales/zh-CN.ts @@ -403,6 +403,24 @@ export default { knowledgeBaseCount: "共 {count} 个知识库", noKnowledgeBases: "没有可用的知识库", rawOutputLabel: "原始输出", + wikiWritePageTitle: "Wiki 页面写入", + wikiReplaceTextTitle: "Wiki 文本替换", + wikiRenamePageTitle: "Wiki 页面重命名", + wikiDeletePageTitle: "Wiki 页面删除", + wikiActionCreated: "已创建", + wikiActionUpdated: "已更新", + wikiActionRenamed: "已重命名", + wikiActionDeleted: "已删除", + wikiFieldSlug: "页面路径", + wikiFieldTitle: "标题", + wikiFieldPageType: "类型", + wikiFieldSummary: "摘要", + wikiFieldOldText: "原文本", + wikiFieldNewText: "新文本", + wikiFieldOldSlug: "原路径", + wikiFieldNewSlug: "新路径", + wikiFieldAffectedPages: "受影响页面", + wikiAffectedCount: "{count} 个页面的链接已更新", selectKnowledgeBaseWarning: "请至少选择一个知识库", processError: "处理出错", sessionExcerpt: "会话摘录", diff --git a/frontend/src/types/tool-results.ts b/frontend/src/types/tool-results.ts index 1971b661..c21a78ce 100644 --- a/frontend/src/types/tool-results.ts +++ b/frontend/src/types/tool-results.ts @@ -20,7 +20,11 @@ export type DisplayType = | 'database_query' | 'web_search_results' | 'web_fetch_results' - | 'grep_results'; + | 'grep_results' + | 'wiki_write_page' + | 'wiki_replace_text' + | 'wiki_rename_page' + | 'wiki_delete_page'; // Search result item export interface SearchResultItem { @@ -216,6 +220,47 @@ export interface GrepResultsData { max_results: number; } +// Wiki write page data +export interface WikiWritePageData { + display_type: 'wiki_write_page'; + action: 'created' | 'updated'; + slug: string; + title: string; + page_type: string; + summary: string; +} + +// Wiki replace text data +export interface WikiReplaceTextData { + display_type: 'wiki_replace_text'; + slug: string; + title: string; + old_text: string; + new_text: string; +} + +// Wiki rename page data +export interface WikiRenamePageData { + display_type: 'wiki_rename_page'; + old_slug: string; + new_slug: string; + title: string; + updated_count: number; + affected_pages?: string[]; +} + +// Wiki delete page data +export interface WikiDeletePageData { + display_type: 'wiki_delete_page'; + slug: string; + title: string; + updated_count: number; + affected_pages?: string[]; +} + +// Union type for all wiki edit data +export type WikiEditData = WikiWritePageData | WikiReplaceTextData | WikiRenamePageData | WikiDeletePageData; + // Union type for all tool result data export type ToolResultData = | SearchResultsData @@ -229,7 +274,11 @@ export type ToolResultData = | DatabaseQueryData | WebSearchResultsData | WebFetchResultsData - | GrepResultsData; + | GrepResultsData + | WikiWritePageData + | WikiReplaceTextData + | WikiRenamePageData + | WikiDeletePageData; // Action data (from index.vue) export interface ActionData { diff --git a/frontend/src/views/chat/components/ToolResultRenderer.vue b/frontend/src/views/chat/components/ToolResultRenderer.vue index 39327db5..631e7745 100644 --- a/frontend/src/views/chat/components/ToolResultRenderer.vue +++ b/frontend/src/views/chat/components/ToolResultRenderer.vue @@ -73,6 +73,12 @@ :data="toolData as GrepResultsData" /> + + +
@@ -100,7 +106,8 @@ import type { DatabaseQueryData, WebSearchResultsData, WebFetchResultsData, - GrepResultsData + GrepResultsData, + WikiEditData } from '@/types/tool-results'; import SearchResults from './tool-results/SearchResults.vue'; @@ -115,6 +122,7 @@ import DatabaseQuery from './tool-results/DatabaseQuery.vue'; import WebSearchResults from './tool-results/WebSearchResults.vue'; import WebFetchResults from './tool-results/WebFetchResults.vue'; import GrepResults from './tool-results/GrepResults.vue'; +import WikiEditResult from './tool-results/WikiEditResult.vue'; interface Props { displayType?: DisplayType; diff --git a/frontend/src/views/chat/components/tool-results/WikiEditResult.vue b/frontend/src/views/chat/components/tool-results/WikiEditResult.vue new file mode 100644 index 00000000..5839edaa --- /dev/null +++ b/frontend/src/views/chat/components/tool-results/WikiEditResult.vue @@ -0,0 +1,318 @@ + + + + + diff --git a/internal/agent/tools/wiki_delete_page.go b/internal/agent/tools/wiki_delete_page.go index 4f9c6a6e..a208c32e 100644 --- a/internal/agent/tools/wiki_delete_page.go +++ b/internal/agent/tools/wiki_delete_page.go @@ -106,10 +106,20 @@ func (t *wikiDeletePageTool) Execute(ctx context.Context, args json.RawMessage) } } - outputMsg := fmt.Sprintf("Successfully deleted page %s and cleaned up %d incoming links.", params.Slug, updatedCount) + outputMsg := fmt.Sprintf("Successfully deleted page [[%s]] and cleaned up %d incoming links.", params.Slug, updatedCount) if updatedCount > 0 { - outputMsg += fmt.Sprintf(" Affected pages: %s", strings.Join(updatedSlugs, ", ")) + outputMsg += fmt.Sprintf("\n- Affected pages: %s", strings.Join(updatedSlugs, ", ")) } - return &types.ToolResult{Success: true, Output: outputMsg}, nil + return &types.ToolResult{ + Success: true, + Output: outputMsg, + Data: map[string]interface{}{ + "display_type": "wiki_delete_page", + "slug": params.Slug, + "title": existingPage.Title, + "updated_count": updatedCount, + "affected_pages": updatedSlugs, + }, + }, nil } diff --git a/internal/agent/tools/wiki_rename_page.go b/internal/agent/tools/wiki_rename_page.go index df9b6c39..b4c64a25 100644 --- a/internal/agent/tools/wiki_rename_page.go +++ b/internal/agent/tools/wiki_rename_page.go @@ -134,10 +134,21 @@ func (t *wikiRenamePageTool) Execute(ctx context.Context, args json.RawMessage) // Rebuild the index page to reflect the new/updated summary _ = t.wikiPageService.RebuildIndexPage(ctx, kbID) - outputMsg := fmt.Sprintf("Successfully renamed page %s to %s and updated %d incoming links.", params.Slug, params.NewSlug, updatedCount) + outputMsg := fmt.Sprintf("Successfully renamed page [[%s]] → [[%s]] and updated %d incoming links.", params.Slug, params.NewSlug, updatedCount) if updatedCount > 0 { - outputMsg += fmt.Sprintf(" Affected pages: %s", strings.Join(updatedSlugs, ", ")) + outputMsg += fmt.Sprintf("\n- Affected pages: %s", strings.Join(updatedSlugs, ", ")) } - return &types.ToolResult{Success: true, Output: outputMsg}, nil + return &types.ToolResult{ + Success: true, + Output: outputMsg, + Data: map[string]interface{}{ + "display_type": "wiki_rename_page", + "old_slug": params.Slug, + "new_slug": params.NewSlug, + "title": existingPage.Title, + "updated_count": updatedCount, + "affected_pages": updatedSlugs, + }, + }, nil } diff --git a/internal/agent/tools/wiki_replace_text.go b/internal/agent/tools/wiki_replace_text.go index 4f66a0ac..c1463ed8 100644 --- a/internal/agent/tools/wiki_replace_text.go +++ b/internal/agent/tools/wiki_replace_text.go @@ -95,5 +95,20 @@ func (t *wikiReplaceTextTool) Execute(ctx context.Context, args json.RawMessage) return &types.ToolResult{Success: false, Error: "Failed to update page: " + err.Error()}, nil } - return &types.ToolResult{Success: true, Output: fmt.Sprintf("Successfully replaced text on page %s.", params.Slug)}, nil + oldPreview := truncateRunes(params.OldText, 80) + newPreview := truncateRunes(params.NewText, 80) + + output := fmt.Sprintf("Successfully replaced text on page [[%s]].\n- Old: %s\n- New: %s", params.Slug, oldPreview, newPreview) + + return &types.ToolResult{ + Success: true, + Output: output, + Data: map[string]interface{}{ + "display_type": "wiki_replace_text", + "slug": params.Slug, + "title": existingPage.Title, + "old_text": oldPreview, + "new_text": newPreview, + }, + }, nil } diff --git a/internal/agent/tools/wiki_tools.go b/internal/agent/tools/wiki_tools.go index 7e7433b3..3c010f07 100644 --- a/internal/agent/tools/wiki_tools.go +++ b/internal/agent/tools/wiki_tools.go @@ -404,3 +404,11 @@ func extractSnippet(content string, query string) string { return "... " + strings.TrimSpace(snippet) + " ..." } + +func truncateRunes(s string, maxRunes int) string { + runes := []rune(s) + if len(runes) <= maxRunes { + return s + } + return string(runes[:maxRunes]) + "..." +} diff --git a/internal/agent/tools/wiki_write_page.go b/internal/agent/tools/wiki_write_page.go index 40402cc4..80e5de37 100644 --- a/internal/agent/tools/wiki_write_page.go +++ b/internal/agent/tools/wiki_write_page.go @@ -5,6 +5,7 @@ import ( "encoding/json" "errors" "fmt" + "strings" "github.com/Tencent/WeKnora/internal/application/repository" "github.com/Tencent/WeKnora/internal/types" @@ -142,8 +143,24 @@ func (t *wikiWritePageTool) Execute(ctx context.Context, args json.RawMessage) ( // Rebuild the index page to reflect the new/updated summary _ = t.wikiPageService.RebuildIndexPage(ctx, kbID) + output := fmt.Sprintf("Successfully %s page [[%s]].\n- Title: %s\n- Type: %s\n- Summary: %s\n- Content length: %d chars", action, params.Slug, params.Title, params.PageType, params.Summary, len(params.Content)) + if len(params.Aliases) > 0 { + output += fmt.Sprintf("\n- Aliases: %s", strings.Join(params.Aliases, ", ")) + } + if len(resolvedRefs) > 0 { + output += fmt.Sprintf("\n- Source refs: %d document(s)", len(resolvedRefs)) + } + return &types.ToolResult{ Success: true, - Output: fmt.Sprintf("Successfully %s page %s.", action, params.Slug), + Output: output, + Data: map[string]interface{}{ + "display_type": "wiki_write_page", + "action": action, + "slug": params.Slug, + "title": params.Title, + "page_type": params.PageType, + "summary": params.Summary, + }, }, nil }