feat(knowledge): add document download action (#2654)

* feat(knowledge): add document download action

* fix(knowledge): preserve file extension on download
main
韩贤涛 2026-08-12 10:43:58 +08:00 committed by GitHub
parent 517942c846
commit 20ecaa402c
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
7 changed files with 102 additions and 10 deletions

View File

@ -22,6 +22,7 @@ import { useI18n } from 'vue-i18n';
import { useAuthStore } from '@/stores/auth';
import DocumentPreview from '@/components/document-preview.vue';
import KnowledgeProcessingTimeline from '@/components/knowledge-processing-timeline.vue';
import { resolveKnowledgeDownloadFileName } from '@/views/knowledge/knowledgeDownloadFileName';
const { t } = useI18n();
const authStore = useAuthStore();
@ -1550,9 +1551,7 @@ const downloadFile = () => {
const link = document.createElement("a");
link.style.display = "none";
link.setAttribute("href", url.value);
const needsExt = props.details.type === 'manual' && !props.details.title.toLowerCase().endsWith('.md');
const ext = needsExt ? '.md' : '';
link.setAttribute("download", props.details.title + ext);
link.setAttribute("download", resolveKnowledgeDownloadFileName(props.details));
document.body.appendChild(link);
link.click();
nextTick(() => {

View File

@ -38,6 +38,7 @@ import {
listKnowledgeFolders,
moveKnowledgeToFolder,
renameKnowledgeFolder,
downKnowledgeDetails,
type KnowledgeFolderTree,
} from "@/api/knowledge-base/index";
import { knowledgeSpansPayloadHasTrace } from '@/utils/knowledgeTrace';
@ -60,6 +61,7 @@ import {
shouldRefreshWikiStatusAfterKnowledgePoll,
} from './wikiStatusRefresh';
import { listMoveTargets, moveKnowledge, getKnowledgeMoveProgress } from '@/api/knowledge-base';
import { resolveKnowledgeDownloadFileName } from './knowledgeDownloadFileName';
import {
buildUploadFileName,
canMoveFolderTo,
@ -2145,12 +2147,34 @@ const confirmCancelParseKnowledge = async (item: KnowledgeCard) => {
}
};
const downloadKnowledge = async (item: KnowledgeCard) => {
if (!item?.id) return;
try {
const file = await downKnowledgeDetails(item.id);
const objectUrl = URL.createObjectURL(file);
const link = document.createElement('a');
const fileName = resolveKnowledgeDownloadFileName(item);
link.style.display = 'none';
link.href = objectUrl;
link.download = fileName;
document.body.appendChild(link);
link.click();
nextTick(() => {
link.remove();
URL.revokeObjectURL(objectUrl);
});
} catch {
MessagePlugin.error(t('file.downloadFailed'));
}
};
// Bridge card-view actions back to existing per-card handlers.
const handleCardAction = (
action: 'edit' | 'reparse' | 'cancel-parse' | 'move' | 'move-folder' | 'delete' | 'view-trace' | 'batch-manage',
action: 'download' | 'edit' | 'reparse' | 'cancel-parse' | 'move' | 'move-folder' | 'delete' | 'view-trace' | 'batch-manage',
item: KnowledgeCard,
) => {
const idx = (cardList.value || []).findIndex((i: KnowledgeCard) => i.id === item.id);
if (action === 'download') return downloadKnowledge(item);
if (action === 'edit') return handleManualEdit(idx, item);
if (action === 'reparse') {
if (isParseInFlight(item.parse_status)) return onReparseMenuClick(idx, item);
@ -2165,10 +2189,11 @@ const handleCardAction = (
// Bridge list-view actions back to existing per-card handlers.
const handleListAction = (
action: 'edit' | 'reparse' | 'cancel-parse' | 'move' | 'move-folder' | 'delete' | 'view-trace' | 'batch-manage',
action: 'download' | 'edit' | 'reparse' | 'cancel-parse' | 'move' | 'move-folder' | 'delete' | 'view-trace' | 'batch-manage',
item: KnowledgeCard,
) => {
const idx = (cardList.value || []).findIndex((i: KnowledgeCard) => i.id === item.id);
if (action === 'download') return downloadKnowledge(item);
if (action === 'edit') return handleManualEdit(idx, item);
if (action === 'reparse') return confirmRebuildKnowledge(idx, item);
if (action === 'cancel-parse') return confirmCancelParseKnowledge(item);
@ -2569,6 +2594,7 @@ async function createNewSession(value: string): Promise<void> {
:selected-ids="selectedIds"
:batch-mode="batchMode"
:can-edit="canEdit"
:can-download="canDownloadKnowledge"
:can-mutate-knowledge="canMutateKnowledge"
:trace-available-by-id="traceAvailableById"
:tag-list="tagList"
@ -2595,7 +2621,7 @@ async function createNewSession(value: string): Promise<void> {
<template v-else-if="(cardList.length || currentChildFolders.length) && viewMode === 'list'">
<DocumentListView :items="cardList" :folders="currentChildFolders" :folder-options="folderOptions"
:selected-ids="selectedIds" :tag-list="tagList"
:can-edit="canEdit" :can-mutate-knowledge="canMutateKnowledge"
:can-edit="canEdit" :can-download="canDownloadKnowledge" :can-mutate-knowledge="canMutateKnowledge"
:trace-visible-ids="traceAvailableById"
:move-menu-mode="moveMenuMode"
:move-target-kbs="moveTargetKbs"

View File

@ -12,6 +12,7 @@ interface KnowledgeItem {
const props = defineProps<{
item: KnowledgeItem;
canDownload: boolean;
canMutateKnowledge: boolean;
traceVisible: boolean;
/** Whether the knowledge base has a folder structure to file documents into. */
@ -19,6 +20,7 @@ const props = defineProps<{
}>();
const emit = defineEmits<{
(e: 'download'): void;
(e: 'edit'): void;
(e: 'view-trace'): void;
(e: 'reparse'): void;
@ -41,6 +43,16 @@ const fileName = computed(() => props.item.file_name || props.item.title || prop
</script>
<template>
<!-- 下载原始文档 -->
<div
v-if="canDownload && (item.type === 'file' || item.type === 'manual')"
class="doc-action-menu-item"
@click.stop="emit('download')"
>
<t-icon class="icon" name="download" />
<span>{{ $t('common.download') }}</span>
</div>
<!-- 编辑文档 -->
<div v-if="item.type === 'manual'" class="doc-action-menu-item" @click.stop="emit('edit')">
<t-icon class="icon" name="edit" />

View File

@ -42,6 +42,7 @@ const props = defineProps<{
selectedIds: Set<string>;
batchMode: boolean;
canEdit: boolean;
canDownload: boolean;
canMutateKnowledge: boolean;
traceAvailableById: Record<string, boolean>;
tagList: Tag[];
@ -67,7 +68,7 @@ const emit = defineEmits<{
(e: 'open', item: KnowledgeCard): void;
(e: 'toggle-checkbox', id: string, checked: boolean, ctx?: { e?: Event }): void;
(e: 'menu-visible-change', visible: boolean, item: KnowledgeCard): void;
(e: 'action', action: 'edit' | 'view-trace' | 'reparse' | 'cancel-parse' | 'move' | 'move-folder' | 'batch-manage' | 'delete', item: KnowledgeCard): void;
(e: 'action', action: 'download' | 'edit' | 'view-trace' | 'reparse' | 'cancel-parse' | 'move' | 'move-folder' | 'batch-manage' | 'delete', item: KnowledgeCard): void;
(e: 'tag-edit', item: KnowledgeCard): void;
(e: 'open-folder', path: string): void;
(e: 'move-to-folder', item: KnowledgeCard, folderPath: string): void;
@ -295,7 +296,7 @@ const onFolderPicked = (item: KnowledgeCard, path: string) => {
};
// --- Action handlers ---
const handleAction = (action: 'edit' | 'view-trace' | 'reparse' | 'cancel-parse' | 'move' | 'move-folder' | 'batch-manage' | 'delete', item: KnowledgeCard) => {
const handleAction = (action: 'download' | 'edit' | 'view-trace' | 'reparse' | 'cancel-parse' | 'move' | 'move-folder' | 'batch-manage' | 'delete', item: KnowledgeCard) => {
// The folder picker opens inside this same popup, so keep the menu open.
if (action === 'move-folder') {
folderPickerItemId.value = item.id;
@ -387,8 +388,10 @@ const handleAction = (action: 'edit' | 'view-trace' | 'reparse' | 'cancel-parse'
<div v-else-if="moveMenuMode === 'normal'" class="card-menu">
<DocumentActionMenu
:item="item"
:can-download="canDownload"
:can-mutate-knowledge="canMutateKnowledge"
:trace-visible="isTraceMenuVisible(item)"
@download="handleAction('download', item)"
@edit="handleAction('edit', item)"
@view-trace="handleAction('view-trace', item)"
@reparse="handleAction('reparse', item)"

View File

@ -33,6 +33,7 @@ const props = defineProps<{
items: KnowledgeItem[];
selectedIds: Set<string>;
canEdit: boolean;
canDownload: boolean;
canMutateKnowledge: boolean;
traceVisibleIds: Record<string, boolean>;
tagList: Tag[];
@ -60,7 +61,7 @@ const emit = defineEmits<{
(e: 'open', item: KnowledgeItem): void;
(e: 'toggle-row', id: string, checked: boolean, shiftKey: boolean): void;
(e: 'toggle-all', checked: boolean): void;
(e: 'action', action: 'edit' | 'reparse' | 'cancel-parse' | 'move' | 'move-folder' | 'delete' | 'view-trace' | 'batch-manage', item: KnowledgeItem): void;
(e: 'action', action: 'download' | 'edit' | 'reparse' | 'cancel-parse' | 'move' | 'move-folder' | 'delete' | 'view-trace' | 'batch-manage', item: KnowledgeItem): void;
(e: 'probe-trace', item: KnowledgeItem): void;
(e: 'tag-edit', item: KnowledgeItem): void;
(e: 'open-folder', path: string): void;
@ -235,7 +236,7 @@ const onFolderPicked = (item: KnowledgeItem, path: string) => {
emit('move-to-folder', item, path);
};
const handleAction = (action: 'edit' | 'reparse' | 'cancel-parse' | 'move' | 'move-folder' | 'delete' | 'view-trace' | 'batch-manage', item: KnowledgeItem) => {
const handleAction = (action: 'download' | 'edit' | 'reparse' | 'cancel-parse' | 'move' | 'move-folder' | 'delete' | 'view-trace' | 'batch-manage', item: KnowledgeItem) => {
// The folder picker opens inside this same popup, so keep the menu open.
if (action === 'move-folder') {
folderPickerItemId.value = item.id;
@ -398,8 +399,10 @@ const handleAction = (action: 'edit' | 'reparse' | 'cancel-parse' | 'move' | 'mo
<div v-else-if="moveMenuMode === 'normal'" class="card-menu">
<DocumentActionMenu
:item="item"
:can-download="canDownload"
:can-mutate-knowledge="canMutateKnowledge"
:trace-visible="!!traceVisibleIds[item.id] || (item.parse_status === 'pending' || item.parse_status === 'processing' || item.parse_status === 'finalizing')"
@download="handleAction('download', item)"
@edit="handleAction('edit', item)"
@view-trace="handleAction('view-trace', item)"
@reparse="handleAction('reparse', item)"

View File

@ -0,0 +1,34 @@
import assert from 'node:assert/strict';
import test from 'node:test';
import { resolveKnowledgeDownloadFileName } from './knowledgeDownloadFileName.ts';
test('prefers the original filename over the extensionless display name', () => {
assert.equal(resolveKnowledgeDownloadFileName({
id: 'knowledge-1',
original_file_name: 'quarterly-report.pdf',
file_name: 'quarterly-report',
type: 'file',
}), 'quarterly-report.pdf');
});
test('falls back to the backend filename when no original filename is present', () => {
assert.equal(resolveKnowledgeDownloadFileName({
id: 'knowledge-2',
file_name: 'notes.txt',
type: 'file',
}), 'notes.txt');
});
test('adds the markdown extension to manual documents exactly once', () => {
assert.equal(resolveKnowledgeDownloadFileName({
id: 'knowledge-3',
title: 'meeting-notes',
type: 'manual',
}), 'meeting-notes.md');
assert.equal(resolveKnowledgeDownloadFileName({
id: 'knowledge-4',
title: 'meeting-notes.md',
type: 'manual',
}), 'meeting-notes.md');
});

View File

@ -0,0 +1,15 @@
export interface KnowledgeDownloadItem {
id: string;
original_file_name?: string;
file_name?: string;
title?: string;
type?: string;
}
export function resolveKnowledgeDownloadFileName(item: KnowledgeDownloadItem): string {
const baseName = item.original_file_name || item.file_name || item.title || item.id;
if (item.type === 'manual' && !baseName.toLowerCase().endsWith('.md')) {
return `${baseName}.md`;
}
return baseName;
}