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
<template>
<div class="storage-backend-settings">
<div class="section-header">
<div class="section-header__top">
<div>
<h2>{{ t('settings.storage.title') }}</h2>
<p class="section-description">{{ t('settings.storageBackend.description') }}</p>
</div>
</div>
</div>
<t-loading :loading="loading" size="small" class="backend-list-loading">
<t-empty
v-if="!loading && backends.length === 0 && !authStore.hasRole('admin')"
:description="t('settings.storageBackend.empty')"
/>
<div v-else-if="!loading" class="backend-grid">
<div
v-for="backend in backends"
:key="backend.id"
class="backend-card"
:class="[
`backend-card--${backend.provider}`,
{ 'backend-card--clickable': canEdit(backend) },
]"
:role="canEdit(backend) ? 'button' : undefined"
:tabindex="canEdit(backend) ? 0 : undefined"
@click="onCardClick($event, backend)"
@keydown.enter="onCardClick($event, backend)"
>
<div
class="backend-card__badge"
:class="badgeClass(backend.provider)"
:style="badgeStyle(backend.provider)"
:aria-label="backend.provider"
>
<img
v-if="resolveLogo(backend.provider)?.mode === 'color'"
:src="resolveLogo(backend.provider)!.url"
:alt="backend.provider"
class="backend-card__badge-img"
/>
<template v-else-if="!resolveLogo(backend.provider)">{{ providerInitial(backend.provider) }}</template>
</div>
<div class="backend-card__body">
<div class="backend-card__header">
<h3 class="backend-card__title">{{ backend.name }}</h3>
<t-tag v-if="backend.id === defaultID" theme="primary" variant="light" size="small">{{ t('settings.storageBackend.defaultTag') }}</t-tag>
<div v-if="hasActions(backend)" class="backend-card__actions" @click.stop>
<t-dropdown
:options="getBackendOptions(backend)"
placement="bottom-right"
attach="body"
trigger="click"
@click="(data: any) => handleMenuAction(data.value, backend)"
>
<t-button variant="text" shape="square" size="small" class="backend-card__action-btn">
<t-icon name="ellipsis" />
</t-button>
</t-dropdown>
</div>
</div>
<p class="backend-card__subtitle">
<span>{{ backend.provider.toUpperCase() }}</span>
<template v-if="backendMeta(backend)">
<span class="backend-card__sep">·</span>
<span class="backend-card__meta">{{ backendMeta(backend) }}</span>
</template>
</p>
</div>
</div>
<button
v-if="authStore.hasRole('admin')"
type="button"
class="backend-card backend-card--add"
@click="openCreate"
>
<span class="backend-card--add__icon" aria-hidden="true">
<add-icon />
</span>
<span class="backend-card--add__label">{{ t('settings.storageBackend.add') }}</span>
</button>
</div>
</t-loading>
<SettingDrawer
v-model:visible="visible"
:title="editing ? t('settings.storageBackend.editTitle') : t('settings.storageBackend.createTitle')"
:class="`storage-backend-drawer storage-backend-drawer--${form.provider}`"
:confirm-loading="saving"
@confirm="save"
@cancel="visible = false"
>
<template #headerIcon>
<img
v-if="currentLogo?.mode === 'color'"
:src="currentLogo.url"
:alt="form.provider"
class="header-icon__img"
/>
<span
v-else-if="currentLogo?.mode === 'mono'"
class="header-icon__mono"
:style="monoLogoStyle"
/>
<span v-else class="header-icon__text">{{ providerInitial(form.provider) }}</span>
</template>
<template #subtitle>
<span>{{ editing ? t('settings.storageBackend.editSubtitle') : t('settings.storageBackend.createSubtitle') }}</span>
</template>
<t-form :data="form" layout="vertical">
<section class="setting-drawer__section">
<h4 class="setting-drawer__section-title">{{ t('settings.storageBackend.basicSection') }}</h4>
<div class="form-item">
<label class="form-label required">{{ t('settings.storageBackend.nameLabel') }}</label>
<t-input v-model="form.name" :placeholder="t('settings.storageBackend.namePlaceholder')" clearable />
</div>
<div class="form-item">
<label class="form-label required">{{ t('settings.storageBackend.providerLabel') }}</label>
<t-select v-model="form.provider" :disabled="!!editing" @change="resetConfig">
<t-option
v-for="provider in providers"
:key="provider"
:value="provider"
:label="provider.toUpperCase()"
/>
</t-select>
</div>
<div v-if="form.provider === 'minio'" class="form-item">
<label class="form-label">{{ t('settings.storageBackend.modeLabel') }}</label>
<div class="source-options" role="radiogroup">
<button
type="button"
class="source-option"
:class="{ 'is-active': form.config.mode !== 'docker' }"
:disabled="!!editing"
@click="form.config.mode = 'remote'"
>
<t-icon name="cloud" class="source-option__icon" />
<span class="source-option__label">{{ t('settings.storageBackend.modeRemote') }}</span>
</button>
<button
type="button"
class="source-option"
:class="{ 'is-active': form.config.mode === 'docker' }"
:disabled="!!editing"
@click="form.config.mode = 'docker'"
>
<t-icon name="server" class="source-option__icon" />
<span class="source-option__label">{{ t('settings.storageBackend.modeEnv') }}</span>
</button>
</div>
</div>
</section>
<section class="setting-drawer__section">
<h4 class="setting-drawer__section-title">{{ t('settings.storageBackend.connectionSection') }}</h4>
<div v-if="needsEndpoint" class="form-item">
<label class="form-label required">Endpoint</label>
<t-input
v-model="form.config.endpoint"
:disabled="!!editing"
:placeholder="form.provider === 'minio' ? 'storage.example.com:9000' : 'https://storage.example.com'"
clearable
/>
</div>
<div v-if="needsRegion" class="form-item">
<label class="form-label required">Region</label>
<t-input v-model="form.config.region" :disabled="!!editing" clearable />
</div>
<template v-if="needsCredentials">
<div class="form-item">
<label class="form-label required">Access Key / Secret ID</label>
<t-input v-model="form.config.access_key_id" placeholder="***" clearable>
<template #prefix-icon><t-icon name="lock-on" /></template>
</t-input>
</div>
<div class="form-item">
<label class="form-label required">Secret Key</label>
<t-input v-model="form.config.secret_access_key" type="password" placeholder="***" clearable>
<template #prefix-icon><t-icon name="lock-on" /></template>
</t-input>
</div>
</template>
<div v-if="form.provider !== 'local'" class="form-item">
<label class="form-label required">Bucket</label>
<t-input v-model="form.config.bucket_name" :disabled="!!editing" clearable />
</div>
<div v-if="form.provider === 'cos'" class="form-item">
<label class="form-label">App ID</label>
<t-input v-model="form.config.app_id" :disabled="!!editing" :placeholder="t('settings.storageBackend.optionalPlaceholder')" clearable />
</div>
</section>
<section class="setting-drawer__section">
<h4 class="setting-drawer__section-title">{{ t('settings.storageBackend.advancedSection') }}</h4>
<div class="form-item">
<label class="form-label">{{ t('settings.storageBackend.pathPrefixLabel') }}</label>
<t-input v-model="form.config.path_prefix" :disabled="!!editing" placeholder="weknora/" clearable />
</div>
<div v-if="form.provider === 'minio'" class="form-item">
<div class="vision-toggle">
<t-switch v-model="form.config.use_ssl" />
<span class="form-desc form-desc--inline">{{ t('settings.storageBackend.useSslDesc') }}</span>
</div>
</div>
<div v-if="form.provider === 's3'" class="form-item">
<div class="vision-toggle">
<t-switch v-model="form.config.force_path_style" />
<span class="form-desc form-desc--inline">{{ t('settings.storageBackend.forcePathStyleDesc') }}</span>
</div>
</div>
<div v-if="form.provider === 'oss'" class="form-item">
<div class="vision-toggle">
<t-switch v-model="form.config.use_temp_bucket" />
<span class="form-desc form-desc--inline">{{ t('settings.storageBackend.useTempBucketDesc') }}</span>
</div>
</div>
<template v-if="['cos', 'tos'].includes(form.provider) || (form.provider === 'oss' && form.config.use_temp_bucket)">
<div class="form-item">
<label class="form-label">{{ t('settings.storageBackend.tempBucketLabel') }}</label>
<t-input v-model="form.config.temp_bucket_name" :placeholder="t('settings.storageBackend.tempBucketPlaceholder')" clearable />
</div>
<div class="form-item">
<label class="form-label">{{ t('settings.storageBackend.tempRegionLabel') }}</label>
<t-input v-model="form.config.temp_region" :placeholder="t('settings.storageBackend.tempRegionPlaceholder')" clearable />
</div>
</template>
</section>
</t-form>
<template #footer-left>
<t-button variant="outline" :loading="testing" @click="testRaw">
<template #icon>
<t-icon v-if="!testing && rawTestResult === 'ok'" name="check-circle-filled" class="status-icon available" />
<t-icon v-else-if="!testing && rawTestResult === 'error'" name="close-circle-filled" class="status-icon unavailable" />
</template>
{{ t('settings.storageBackend.testConnection') }}
</t-button>
</template>
</SettingDrawer>
</div>
</template>
<script setup lang="ts">
import { computed, onMounted, reactive, ref } from 'vue'
import { DialogPlugin, MessagePlugin } from 'tdesign-vue-next'
import { AddIcon } from 'tdesign-icons-vue-next'
import { useI18n } from 'vue-i18n'
import { useAuthStore } from '@/stores/auth'
import SettingDrawer from '@/components/settings/SettingDrawer.vue'
import { providerLogo } from './providerLogos'
import {
createStorageBackend, deleteStorageBackend, listStorageBackends, listStorageBackendTypes,
setDefaultStorageBackend, testStorageBackend, testStorageBackendByID, updateStorageBackend,
type StorageBackend, type StorageBackendConfig,
} from '@/api/storage-backend'
const { t } = useI18n()
const authStore = useAuthStore()
const loading = ref(false), saving = ref(false), testing = ref(false), visible = ref(false)
const backends = ref<StorageBackend[]>([]), providers = ref<string[]>([]), defaultID = ref('')
const editing = ref<StorageBackend | null>(null)
const rawTestResult = ref<'ok' | 'error' | null>(null)
const blankConfig = (): StorageBackendConfig => ({ mode: 'remote', endpoint: '', region: '', access_key_id: '', secret_access_key: '', bucket_name: '', path_prefix: '', use_ssl: true })
const form = reactive<{ name: string; provider: string; config: StorageBackendConfig }>({ name: '', provider: 'local', config: blankConfig() })
const needsEndpoint = computed(() => !['local', 'cos'].includes(form.provider) && !(form.provider === 'minio' && form.config.mode === 'docker'))
const needsRegion = computed(() => !['local', 'minio'].includes(form.provider))
const needsCredentials = computed(() => form.provider !== 'local' && !(form.provider === 'minio' && form.config.mode === 'docker'))
const resolveLogo = (provider: string) => providerLogo('storage', provider)
const providerInitial = (provider: string) => (provider || '?').trim().charAt(0).toUpperCase() || '?'
const badgeClass = (provider: string) => {
const mode = resolveLogo(provider)?.mode
return {
'backend-card__badge--logo': !!mode,
'backend-card__badge--color': mode === 'color',
'backend-card__badge--mono': mode === 'mono',
}
}
const badgeStyle = (provider: string): Record<string, string> => {
const logo = resolveLogo(provider)
return logo?.mode === 'mono' ? { '--logo-url': `url("${logo.url}")` } : {}
}
const currentLogo = computed(() => providerLogo('storage', form.provider))
const monoLogoStyle = computed((): Record<string, string> => {
const logo = currentLogo.value
if (!logo || logo.mode !== 'mono') return {}
return { '--logo-url': `url("${logo.url}")` }
})
function backendMeta(backend: StorageBackend): string {
return backend.config.endpoint || backend.config.bucket_name || backend.config.path_prefix || t('settings.storageBackend.localStorage')
}
const canEdit = (backend: StorageBackend) => authStore.hasRole('admin') && backend.source !== 'env'
const canDelete = (backend: StorageBackend) => authStore.hasRole('admin') && backend.source !== 'env' && !backend.legacy_alias
const canSetDefault = (backend: StorageBackend) => backend.id !== defaultID.value && authStore.hasRole('admin')
// 测试连接对所有可见用户开放,因此每张卡至少有一个动作。
const hasActions = (_backend: StorageBackend) => true
function getBackendOptions(backend: StorageBackend) {
const options: { content: string; value: string; theme?: string }[] = []
options.push({ content: t('settings.storageBackend.testConnection'), value: 'test' })
if (canSetDefault(backend)) options.push({ content: t('settings.storageBackend.setDefault'), value: 'default' })
if (canEdit(backend)) options.push({ content: t('settings.storageBackend.edit'), value: 'edit' })
if (canDelete(backend)) options.push({ content: t('settings.storageBackend.delete'), value: 'delete', theme: 'error' })
return options
}
function handleMenuAction(value: string, backend: StorageBackend) {
if (value === 'test') testSaved(backend)
else if (value === 'default') makeDefault(backend)
else if (value === 'edit') openEdit(backend)
else if (value === 'delete') remove(backend)
}
function onCardClick(event: Event, backend: StorageBackend) {
if (!canEdit(backend)) return
const target = event.target as HTMLElement | null
if (target?.closest('.backend-card__actions')) return
openEdit(backend)
}
async function load() {
loading.value = true
try {
const [list, types] = await Promise.all([listStorageBackends(), listStorageBackendTypes()])
backends.value = list.data || []; defaultID.value = list.default_storage_backend_id || ''; providers.value = types.data || []
} finally { loading.value = false }
}
function resetConfig() { form.config = blankConfig(); rawTestResult.value = null }
function openCreate() { editing.value = null; form.name = ''; form.provider = providers.value[0] || 'local'; form.config = blankConfig(); rawTestResult.value = null; visible.value = true }
function openEdit(backend: StorageBackend) { editing.value = backend; form.name = backend.name; form.provider = backend.provider; form.config = { ...blankConfig(), ...backend.config }; rawTestResult.value = null; visible.value = true }
async function testRaw() {
testing.value = true
rawTestResult.value = null
try {
const r: any = editing.value ? await testStorageBackendByID(editing.value.id) : await testStorageBackend(form)
if (r.success) { rawTestResult.value = 'ok'; MessagePlugin.success(t('settings.storageBackend.testSuccess')) }
else { rawTestResult.value = 'error'; MessagePlugin.error(r.error || t('settings.storageBackend.testFailed')) }
} finally { testing.value = false }
}
async function testSaved(backend: StorageBackend) { const r: any = await testStorageBackendByID(backend.id); r.success ? MessagePlugin.success(t('settings.storageBackend.testSuccess')) : MessagePlugin.error(r.error || t('settings.storageBackend.testFailed')) }
async function save() {
if (!form.name.trim()) { MessagePlugin.warning(t('settings.storageBackend.nameRequired')); return }
saving.value = true
try {
const payload = { name: form.name.trim(), provider: form.provider, config: { ...form.config } }
if (editing.value) await updateStorageBackend(editing.value.id, payload); else await createStorageBackend(payload)
MessagePlugin.success(t('settings.storageBackend.saveSuccess')); visible.value = false; await load()
} catch (e: any) { MessagePlugin.error(e?.message || t('settings.storageBackend.saveFailed')) } finally { saving.value = false }
}
async function makeDefault(backend: StorageBackend) { await setDefaultStorageBackend(backend.id); defaultID.value = backend.id; MessagePlugin.success(t('settings.storageBackend.defaultUpdated')) }
function remove(backend: StorageBackend) {
const dialog = DialogPlugin.confirm({ theme: 'danger', confirmBtn: { content: t('common.delete'), theme: 'danger' }, header: t('settings.storageBackend.deleteTitle'), body: t('settings.storageBackend.deleteConfirm', { name: backend.name }), onConfirm: async () => { dialog.destroy(); try { await deleteStorageBackend(backend.id); await load(); MessagePlugin.success(t('settings.storageBackend.deleted')) } catch (e: any) { MessagePlugin.error(e?.message || t('settings.storageBackend.deleteFailed')) } }, onCancel: () => dialog.destroy() })
}
onMounted(load)
</script>
<style scoped lang="less">
@import (reference) '@/components/css/provider-card.less';
@import (reference) '@/components/css/settings-section.less';
.storage-backend-settings {
width: 100%;
}
.section-header {
.settings-section-header();
}
.backend-list-loading {
min-height: 120px;
}
.backend-grid {
display: grid;
grid-template-columns: repeat(auto-fill, minmax(320px, 1fr));
gap: 12px;
.backend-card--add {
width: 100%;
height: 100%;
}
}
.backend-card {
.provider-card();
.provider-card-interactive();
&--clickable {
cursor: pointer;
}
&--add {
.provider-card-add();
&:hover,
&:focus-visible {
box-shadow: none;
}
&__icon {
display: flex;
align-items: center;
justify-content: center;
width: 32px;
height: 32px;
border-radius: var(--app-radius-md);
background: color-mix(in srgb, var(--td-brand-color) 10%, transparent);
color: var(--td-brand-color);
font-size: var(--app-text-2xl);
}
&__label {
font-size: var(--app-text-md);
font-weight: 500;
line-height: 1.4;
}
}
}
.backend-card__badge {
.provider-card-badge();
.provider-card-badge-color(#0052d9);
}
.backend-card__badge-img {
.provider-card-badge-img();
}
.backend-card--local .backend-card__badge {
.provider-card-badge-color(#464646);
}
.backend-card--minio .backend-card__badge {
.provider-card-badge-color(#c0382b);
}
.backend-card--cos .backend-card__badge {
.provider-card-badge-color(#0052d9);
}
.backend-card--tos .backend-card__badge {
.provider-card-badge-color(#0089ff);
}
.backend-card--s3 .backend-card__badge {
.provider-card-badge-color(#d97706);
}
.backend-card--oss .backend-card__badge {
.provider-card-badge-color(#e55a00);
}
.backend-card--ks3 .backend-card__badge {
.provider-card-badge-color(#07a050);
}
.backend-card--obs .backend-card__badge {
.provider-card-badge-color(#ce1126);
}
.backend-card__body {
.provider-card-body();
}
.backend-card__header {
.provider-card-header();
}
.backend-card__title {
.provider-card-title();
}
.backend-card__subtitle {
margin: 2px 0 0;
font-size: var(--app-text-sm);
line-height: 1.5;
color: var(--td-text-color-secondary);
display: flex;
align-items: center;
min-width: 0;
}
.backend-card__sep {
margin: 0 6px;
color: var(--td-text-color-placeholder);
flex-shrink: 0;
}
.backend-card__meta {
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
min-width: 0;
}
.backend-card__actions {
flex-shrink: 0;
display: flex;
align-items: center;
}
.backend-card__action-btn {
flex-shrink: 0;
padding: 2px;
color: var(--td-text-color-placeholder);
opacity: 0;
transition: opacity var(--app-motion-fast) ease;
&:hover,
&:focus-visible {
background: var(--td-bg-color-secondarycontainer);
color: var(--td-text-color-primary);
}
}
.backend-card:hover .backend-card__action-btn,
.backend-card:focus-within .backend-card__action-btn {
opacity: 1;
}
// ---- 抽屉头部图标 ----
.header-icon__img {
width: 24px;
height: 24px;
object-fit: contain;
display: block;
}
.header-icon__mono {
display: inline-block;
width: 22px;
height: 22px;
background-color: currentColor;
-webkit-mask-image: var(--logo-url);
-webkit-mask-position: center;
-webkit-mask-repeat: no-repeat;
-webkit-mask-size: contain;
mask-image: var(--logo-url);
mask-position: center;
mask-repeat: no-repeat;
mask-size: contain;
}
.header-icon__text {
font-size: var(--app-text-lg);
font-weight: 600;
letter-spacing: 0.02em;
}
// ---- 抽屉表单 ----
.form-item {
margin-bottom: 0;
}
.form-label {
display: block;
margin-bottom: 6px;
font-size: var(--app-text-md);
font-weight: 500;
color: var(--td-text-color-primary);
line-height: 1.4;
&.required::before {
content: '*';
color: var(--td-error-color);
margin-right: 4px;
font-weight: 500;
line-height: 1;
}
}
.form-desc {
margin: 4px 0 0 0;
font-size: var(--app-text-sm);
line-height: 1.5;
color: var(--td-text-color-placeholder);
&--inline {
margin: 0;
}
}
:deep(.t-input),
:deep(.t-select),
:deep(.t-textarea) {
width: 100%;
font-size: var(--app-text-md);
}
.vision-toggle {
display: flex;
align-items: center;
gap: 8px;
}
// ---- MinIO 部署模式 pill segmented ----
.source-options {
display: inline-flex;
align-items: center;
gap: 4px;
padding: 3px;
background: var(--td-bg-color-component);
border: 1px solid var(--td-component-stroke);
border-radius: var(--app-radius-md);
}
.source-option {
display: inline-flex;
align-items: center;
gap: 6px;
padding: 5px 12px;
height: 28px;
background: transparent;
border: 1px solid transparent;
border-radius: var(--app-radius-sm);
cursor: pointer;
font-family: inherit;
font-size: var(--app-text-md);
color: var(--td-text-color-secondary);
line-height: 1;
transition: all var(--app-motion-fast) ease;
&:disabled {
cursor: not-allowed;
opacity: 0.6;
}
&:hover:not(.is-active):not(:disabled) {
color: var(--td-text-color-primary);
background: var(--td-bg-color-container-hover);
}
&.is-active {
background: var(--td-bg-color-container);
border-color: var(--td-brand-color);
color: var(--td-brand-color);
font-weight: 500;
box-shadow: 0 1px 2px rgba(15, 23, 42, 0.04);
}
}
.source-option__icon {
font-size: var(--app-text-base);
flex-shrink: 0;
}
.source-option__label {
white-space: nowrap;
}
.status-icon {
font-size: var(--app-text-xl);
flex-shrink: 0;
&.available {
color: var(--td-brand-color);
}
&.unavailable {
color: var(--td-error-color);
}
}
</style>
<!--
Non-scoped: drawer header icon coloring per provider, mirroring the list
card badge colors. Namespaced under .storage-backend-drawer--{id}.
-->
<style lang="less">
.storage-backend-drawer .setting-drawer__header-icon:has(.header-icon__img) {
background: var(--td-bg-color-container);
box-shadow: inset 0 0 0 1px var(--td-component-stroke);
}
.storage-backend-drawer--local .setting-drawer__header-icon { background: rgba(70, 70, 70, 0.1); color: #464646; }
.storage-backend-drawer--minio .setting-drawer__header-icon { background: rgba(225, 38, 38, 0.12); color: #C0382B; }
.storage-backend-drawer--cos .setting-drawer__header-icon { background: rgba(0, 82, 217, 0.1); color: #0052D9; }
.storage-backend-drawer--tos .setting-drawer__header-icon { background: rgba(0, 137, 255, 0.12); color: #0089FF; }
.storage-backend-drawer--s3 .setting-drawer__header-icon { background: rgba(255, 153, 0, 0.12); color: #D97706; }
.storage-backend-drawer--oss .setting-drawer__header-icon { background: rgba(255, 90, 0, 0.12); color: #E55A00; }
.storage-backend-drawer--ks3 .setting-drawer__header-icon { background: color-mix(in srgb, var(--td-brand-color) 12%, transparent); color: #07A050; }
.storage-backend-drawer--obs .setting-drawer__header-icon { background: rgba(206, 17, 38, 0.1); color: #CE1126; }
</style>