From ab3e472748e09ca66ac3dcfdcee371d37bcd6f0e Mon Sep 17 00:00:00 2001
From: wizardchen <wizardchen@tencent.com>
Date: Wed, 24 Jun 2026 01:51:22 +0800
Subject: [PATCH] feat(frontend): implement session source filter component for
 improved session management

Added a new SessionSourceFilter component to allow users to filter session lists by source, enhancing the user experience. The component integrates with existing session management features and includes logic for displaying web and channel sources. Additionally, utility functions for managing session source options and visibility conditions have been introduced, along with corresponding unit tests to ensure functionality.
---
 .../src/components/SessionSourceFilter.vue    | 313 ++++++++++++++
 frontend/src/components/menu.vue              | 407 +++++++-----------
 .../sessionSidebarSourceFilter.test.ts        |  39 ++
 .../components/sessionSidebarSourceFilter.ts  |  38 ++
 4 files changed, 539 insertions(+), 258 deletions(-)
 create mode 100644 frontend/src/components/SessionSourceFilter.vue
 create mode 100644 frontend/src/components/sessionSidebarSourceFilter.test.ts
 create mode 100644 frontend/src/components/sessionSidebarSourceFilter.ts

diff --git a/frontend/src/components/SessionSourceFilter.vue b/frontend/src/components/SessionSourceFilter.vue
new file mode 100644
index 00000000..599785c2
--- /dev/null
+++ b/frontend/src/components/SessionSourceFilter.vue
@@ -0,0 +1,313 @@
+<template>
+  <div class="session-source-filter" :class="{
+    'session-source-filter--inline': inline,
+    'session-source-filter--emphasized': emphasized,
+  }">
+    <button ref="triggerRef" type="button" class="session-source-filter__trigger" :aria-expanded="open"
+      aria-haspopup="listbox" @click.stop="toggleOpen">
+      <span class="session-source-filter__leading">
+        <img v-if="!inline && currentOption?.logo" :src="currentOption.logo" :alt="currentOption.label"
+          class="session-source-filter__logo" />
+        <t-icon v-else-if="!inline" :name="iconFor(currentOption)" class="session-source-filter__icon" size="14px" />
+        <span class="session-source-filter__label" :title="currentOption?.label">{{ currentOption?.label }}</span>
+      </span>
+      <t-icon v-if="inline" name="chevron-down" class="session-source-filter__chevron"
+        :class="{ 'session-source-filter__chevron--open': open }" size="10px" />
+      <t-icon v-else name="chevron-down" class="session-source-filter__chevron"
+        :class="{ 'session-source-filter__chevron--open': open }" size="12px" />
+    </button>
+    <Teleport to="body">
+      <div v-if="open" class="session-source-filter__panel" role="listbox" :style="panelStyle" @click.stop>
+        <button v-for="item in sources" :key="item.value" type="button" class="session-source-filter__option"
+          :class="{ 'session-source-filter__option--active': item.value === current }" role="option"
+          :aria-selected="item.value === current" @click="handleSelect(item.value)">
+          <span class="session-source-filter__option-leading">
+            <img v-if="item.logo" :src="item.logo" :alt="item.label" class="session-source-filter__logo" />
+            <t-icon v-else :name="iconFor(item)" class="session-source-filter__icon" size="14px" />
+            <span class="session-source-filter__option-label" :title="item.label">{{ item.label }}</span>
+          </span>
+          <t-icon v-if="item.value === current" name="check" class="session-source-filter__check" size="13px" />
+        </button>
+      </div>
+    </Teleport>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { computed, nextTick, onBeforeUnmount, ref } from 'vue'
+import { DEFAULT_SESSION_BUCKET_KEY } from './sessionSidebarSourceFilter'
+
+interface SourceItem {
+  value: string
+  label: string
+  logo?: string
+}
+
+const props = defineProps<{
+  sources: SourceItem[]
+  current: string
+  /** 列表顶部的轻量文字触发器（无图标，右对齐） */
+  inline?: boolean
+  /** 非默认来源时始终显示（便于切回网页对话） */
+  emphasized?: boolean
+}>()
+
+const emit = defineEmits<{
+  (e: 'select', value: string): void
+}>()
+
+const PANEL_GAP = 4
+const VIEWPORT_MARGIN = 8
+
+const open = ref(false)
+const triggerRef = ref<HTMLButtonElement | null>(null)
+const panelStyle = ref<Record<string, string>>({})
+
+const currentOption = computed(() =>
+  props.sources.find((item) => item.value === props.current) ?? props.sources[0],
+)
+
+const iconFor = (item: SourceItem | undefined): string => {
+  if (!item) return 'chat'
+  if (item.value === DEFAULT_SESSION_BUCKET_KEY) return 'chat'
+  if (item.value.startsWith('embed:')) return 'internet'
+  return 'link'
+}
+
+const updatePanelPosition = (): void => {
+  const trigger = triggerRef.value
+  if (!trigger) return
+  const rect = trigger.getBoundingClientRect()
+  const width = Math.max(rect.width, 168)
+  const left = props.inline
+    ? Math.max(VIEWPORT_MARGIN, rect.right - width)
+    : Math.max(
+      VIEWPORT_MARGIN,
+      Math.min(rect.left, window.innerWidth - width - VIEWPORT_MARGIN),
+    )
+  panelStyle.value = {
+    top: `${rect.bottom + PANEL_GAP}px`,
+    left: `${left}px`,
+    width: `${width}px`,
+  }
+}
+
+const removeListeners = (): void => {
+  document.removeEventListener('click', close)
+  window.removeEventListener('resize', close)
+  window.removeEventListener('scroll', close, true)
+}
+
+const close = (): void => {
+  open.value = false
+  removeListeners()
+}
+
+const toggleOpen = (): void => {
+  if (open.value) {
+    close()
+    return
+  }
+  updatePanelPosition()
+  open.value = true
+  nextTick(() => {
+    document.addEventListener('click', close)
+    window.addEventListener('resize', close)
+    window.addEventListener('scroll', close, true)
+  })
+}
+
+const handleSelect = (value: string): void => {
+  close()
+  if (value === props.current) return
+  emit('select', value)
+}
+
+onBeforeUnmount(() => {
+  removeListeners()
+})
+</script>
+
+<style scoped lang="less">
+.session-source-filter {
+  padding: 2px 0 6px;
+
+  &--inline {
+    padding: 0;
+    min-width: 0;
+    max-width: 100%;
+
+    .session-source-filter__leading {
+      gap: 0;
+      flex: 0 1 auto;
+    }
+  }
+}
+
+.session-source-filter__trigger {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+  width: 100%;
+  min-height: 28px;
+  padding: 4px 10px 4px 14px;
+  border: 0;
+  border-radius: 6px;
+  background: transparent;
+  color: var(--td-text-color-secondary);
+  cursor: pointer;
+  transition: background 0.15s ease, color 0.15s ease;
+  font-family: var(--app-font-family);
+  text-align: left;
+
+  &:hover,
+  &[aria-expanded='true'] {
+    background: var(--td-bg-color-container-hover);
+    color: var(--td-text-color-primary);
+  }
+
+  .session-source-filter--inline & {
+    width: auto;
+    max-width: 100%;
+    min-height: 0;
+    gap: 2px;
+    padding: 0;
+    border-radius: 0;
+    color: var(--td-text-color-disabled);
+    justify-content: flex-end;
+
+    &:hover,
+    &[aria-expanded='true'] {
+      background: transparent;
+      color: var(--td-text-color-placeholder);
+    }
+  }
+}
+
+.session-source-filter__leading,
+.session-source-filter__option-leading {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  min-width: 0;
+  flex: 1 1 auto;
+}
+
+.session-source-filter__label,
+.session-source-filter__option-label {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  font-size: 12px;
+  font-weight: 500;
+  line-height: 18px;
+  letter-spacing: 0.01em;
+
+  .session-source-filter--inline .session-source-filter__trigger & {
+    font-size: 11px;
+    font-weight: 600;
+    line-height: 16px;
+    color: inherit;
+  }
+}
+
+.session-source-filter__logo {
+  flex: 0 0 auto;
+  width: 14px;
+  height: 14px;
+  object-fit: contain;
+  opacity: 0.72;
+  filter: grayscale(0.15);
+
+  .session-source-filter--inline & {
+    width: 12px;
+    height: 12px;
+    opacity: 0.55;
+  }
+}
+
+.session-source-filter__icon {
+  flex: 0 0 auto;
+  color: var(--td-text-color-placeholder);
+
+  .session-source-filter--inline & {
+    font-size: 12px !important;
+    color: var(--td-text-color-disabled);
+  }
+}
+
+.session-source-filter__chevron {
+  flex: 0 0 auto;
+  color: var(--td-text-color-placeholder);
+  transition: transform 0.18s ease, color 0.15s ease;
+
+  &--open {
+    transform: rotate(180deg);
+    color: var(--td-text-color-secondary);
+  }
+
+  .session-source-filter--inline & {
+    color: var(--td-text-color-disabled);
+    opacity: 0.85;
+    font-size: 10px !important;
+  }
+}
+
+.session-source-filter__panel {
+  position: fixed;
+  z-index: 3000;
+  padding: 4px;
+  border: 1px solid var(--td-component-stroke);
+  border-radius: 8px;
+  background: var(--td-bg-color-sidebar, var(--td-bg-color-container));
+  box-shadow: 0 4px 16px rgba(0, 0, 0, 0.06);
+}
+
+.session-source-filter__option {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+  width: 100%;
+  min-height: 30px;
+  padding: 5px 8px;
+  border: 0;
+  border-radius: 6px;
+  background: transparent;
+  color: var(--td-text-color-primary);
+  cursor: pointer;
+  transition: background 0.15s ease, color 0.15s ease;
+  font-family: var(--app-font-family);
+  text-align: left;
+
+  &:hover {
+    background: var(--td-bg-color-container-hover);
+  }
+
+  &--active {
+    background: var(--td-bg-color-secondarycontainer);
+    color: var(--td-text-color-primary);
+
+    .session-source-filter__icon {
+      color: var(--td-text-color-secondary);
+    }
+
+    .session-source-filter__logo {
+      opacity: 0.9;
+      filter: none;
+    }
+  }
+}
+
+.session-source-filter__option-label {
+  font-size: 13px;
+  font-weight: 430;
+  line-height: 18px;
+}
+
+.session-source-filter__check {
+  flex: 0 0 auto;
+  color: var(--td-text-color-secondary);
+}
+</style>
diff --git a/frontend/src/components/menu.vue b/frontend/src/components/menu.vue
index 1d90b08f..a6a4a11f 100644
--- a/frontend/src/components/menu.vue
+++ b/frontend/src/components/menu.vue
@@ -100,8 +100,13 @@
                 </t-tooltip>
             </div>
 
-            <!-- 历史会话：OpenAI 式「渠道文件夹 + 聊天列表」，各来源独立分页 -->
-            <div class="submenu" v-if="!uiStore.sidebarCollapsed">
+            <!-- 历史会话：按来源筛选后统一按日期分组展示 -->
+            <div class="submenu" v-if="!uiStore.sidebarCollapsed"
+                :class="{ 'submenu--scope-fallback': showSessionScopeFallback }">
+                <div v-if="showSessionScopeFallback" class="session-list-scope-fallback">
+                    <SessionSourceFilter inline :emphasized="sessionScopeFilterPinned" :sources="sessionSourceOptions"
+                        :current="activeSessionBucketKey" @select="switchSessionBucket" />
+                </div>
                 <template v-if="sessionListBooting && !hasAnySession">
                     <div v-for="n in 4" :key="'skel-' + n" class="submenu_item_p session-chat-row">
                         <div class="session-list-row session-list-row--flat">
@@ -111,84 +116,29 @@
                     </div>
                 </template>
 
-                <!-- 其他来源（IM / 网页嵌入）：置顶一行入口，默认收起 -->
-                <div v-if="visibleChannelBuckets.length" class="session-channels-section">
-                    <div class="timeline_header timeline_header--collapsible session-list-row session-list-row--flat"
-                        role="button" tabindex="0" @click="toggleChannelsSection"
-                        @keydown.enter.prevent="toggleChannelsSection" @keydown.space.prevent="toggleChannelsSection">
-                        <span class="session-list-row__body">
-                            <span class="session-header-text">
-                                <span class="timeline_header-label">{{ t('menu.otherSources') }}</span>
-                                <t-icon class="timeline_header-chevron"
-                                    :name="channelsSectionCollapsed ? 'chevron-right' : 'chevron-down'" size="10px" />
-                            </span>
-                        </span>
-                    </div>
-                    <template v-if="!channelsSectionCollapsed">
-                        <template v-for="bucket in visibleChannelBuckets" :key="bucket.key">
-                            <div class="session-folder-header session-list-row session-list-row--flat" role="button"
-                                tabindex="0" @click="toggleSessionGroup(bucket.key)"
-                                @keydown.enter.prevent="toggleSessionGroup(bucket.key)"
-                                @keydown.space.prevent="toggleSessionGroup(bucket.key)">
-                                <span class="session-list-row__body">
-                                    <span class="session-header-text">
-                                        <span class="session-folder-entry">
-                                            <img v-if="bucket.platform && platformLogo(bucket.platform)"
-                                                :src="platformLogo(bucket.platform)" :alt="bucket.platform"
-                                                class="session-channel-inline-icon" />
-                                            <t-icon v-else name="internet" class="session-channel-inline-icon"
-                                                size="14px" />
-                                            <span class="session-folder-label">{{ bucket.label }}</span>
-                                        </span>
-                                        <t-icon class="session-group-chevron"
-                                            :name="isSessionGroupCollapsed(bucket.key) ? 'chevron-right' : 'chevron-down'"
-                                            size="12px" />
-                                    </span>
-                                </span>
+                <div v-else class="session-filtered-list">
+                    <template
+                        v-if="activeBucket?.loading && !activeBucket.loaded && filteredGroupedSessions.length === 0">
+                        <div v-for="n in 4" :key="'bucket-skel-' + n" class="submenu_item_p session-chat-row">
+                            <div class="session-list-row session-list-row--flat">
+                                <t-skeleton animation="gradient" class="session-list-row__body"
+                                    :row-col="[{ width: '100%', height: '14px' }]" />
                             </div>
-                            <template v-if="!isSessionGroupCollapsed(bucket.key)">
-                                <div v-if="bucket.loading && bucket.items.length === 0" class="session-folder-loading">
-                                    <div class="session-list-row session-list-row--flat">
-                                        <span class="session-list-row__body">
-                                            <t-loading size="small" />
-                                        </span>
-                                    </div>
-                                </div>
-                                <div v-for="subitem in bucket.items" :key="subitem.id"
-                                    class="submenu_item_p session-chat-row session-folder-item" :class="{
-                                        'session-chat-row--active': !batchMode && subitem.path === currentSecondpath,
-                                        'session-chat-row--selected': batchMode && batchSelectedIds.includes(subitem.id),
-                                    }">
-                                    <div
-                                        class="session-list-row session-list-row--flat session-list-row--channel-nested">
-                                        <div class="session-list-row__body">
-                                            <SessionSidebarRow :item="subitem" :batch-mode="batchMode"
-                                                :active-path="currentSecondpath" :selected-ids="batchSelectedIds"
-                                                :menu-options="buildSessionMenuOptions(subitem)"
-                                                @navigate="gotopage(subitem.path)"
-                                                @toggle-select="toggleBatchSelect(subitem.id)"
-                                                @menu-click="handleSessionMenuClick($event, subitem)"
-                                                @hover-in="mouseenteBotDownr(subitem.id)"
-                                                @hover-out="mouseleaveBotDown" />
-                                        </div>
-                                    </div>
-                                </div>
-                            </template>
-                        </template>
+                        </div>
                     </template>
-                </div>
-
-                <!-- 网页对话：按日期分组，直接展示 -->
-                <div class="session-web-list">
-                    <template v-if="webBucket?.loaded && chatGroupedSessions.length === 0">
+                    <template v-else-if="activeBucket?.loaded && filteredGroupedSessions.length === 0">
                         <div class="submenu_empty">{{ t('menu.noSessions') }}</div>
                     </template>
                     <template v-else>
-                        <template v-for="group in chatGroupedSessions" :key="group.key">
-                            <div v-if="group.label" class="timeline_header session-list-row session-list-row--flat">
+                        <template v-for="(group, groupIndex) in filteredGroupedSessions" :key="group.key">
+                            <div v-if="group.label" class="timeline_header session-list-row session-list-row--flat"
+                                :class="{ 'timeline_header--with-scope': groupIndex === 0 && showSessionSourceFilter && !batchMode }">
                                 <span class="session-list-row__body">
                                     <span class="timeline_header-label">{{ group.label }}</span>
                                 </span>
+                                <SessionSourceFilter v-if="groupIndex === 0 && showSessionSourceFilter && !batchMode"
+                                    inline :emphasized="sessionScopeFilterPinned" :sources="sessionSourceOptions"
+                                    :current="activeSessionBucketKey" @select="switchSessionBucket" />
                             </div>
                             <div v-for="subitem in group.items" :key="subitem.id"
                                 class="submenu_item_p session-chat-row" :class="{
@@ -208,7 +158,7 @@
                                 </div>
                             </div>
                         </template>
-                        <div v-if="webBucket?.loading && chatGroupedSessions.length > 0"
+                        <div v-if="activeBucket?.loading && filteredGroupedSessions.length > 0"
                             class="session-list-loading session-list-row session-list-row--flat">
                             <span class="session-list-row__body">
                                 <t-loading size="small" />
@@ -255,6 +205,7 @@ import { getSessionsList, delSession, batchDelSessions, deleteAllSessions, clear
 import { useChatResourcesStore } from '@/stores/chatResources';
 import { listAllIMChannels } from '@/api/agent/index';
 import SessionSidebarRow from './SessionSidebarRow.vue';
+import SessionSourceFilter from './SessionSourceFilter.vue';
 import {
     SIDEBAR_BUCKET_PAGE_SIZE,
     applyBucketCountProbe,
@@ -276,8 +227,16 @@ import {
     classifyDateBucket,
     configuredPlatforms,
     groupSessionsByDate,
+    originGroupKey,
+    resolveSessionOrigin,
     type DateBucketKey,
 } from './sessionGrouping';
+import {
+    DEFAULT_SESSION_BUCKET_KEY,
+    buildSessionSourceOptions,
+    findSessionBucketKey,
+    shouldShowSessionSourceFilter,
+} from './sessionSidebarSourceFilter';
 import { logout as logoutApi } from '@/api/auth';
 import { useMenuStore } from '@/stores/menu';
 import { useAuthStore } from '@/stores/auth';
@@ -337,46 +296,31 @@ const currentSecondpath = ref('');
 const scrollContainer = ref<HTMLElement | null>(null);
 const imPlatforms = ref<string[]>([]);
 const embedChannelNames = ref<Record<string, string>>({});
-// 分组折叠：其他来源整块 + 各来源文件夹默认收起；日期标题仅作分隔，不折叠。
-const channelsSectionCollapsed = ref(true);
-const collapsedSessionGroups = ref<Set<string>>(new Set());
-const channelBucketKeys = (keys: string[] = bucketOrder.value) =>
-    keys.filter((key) => isChannelBucketKey(key));
-const applyDefaultChannelCollapse = () => {
-    collapsedSessionGroups.value = new Set(channelBucketKeys());
-};
-const isSessionGroupCollapsed = (key: string) => collapsedSessionGroups.value.has(key);
-const toggleChannelsSection = async () => {
-    channelsSectionCollapsed.value = !channelsSectionCollapsed.value;
-    await refreshSessionListScrollability();
-};
-const ensureChannelBucketLoaded = async (key: string) => {
-    if (!isChannelBucketKey(key)) return;
-    const bucket = sessionBuckets.value[key];
-    if (!bucket || bucket.loaded || bucket.loading) return;
-    await loadBucketPage(key, 1);
-};
-
-const toggleSessionGroup = async (key: string) => {
-    const wasCollapsed = collapsedSessionGroups.value.has(key);
-    const next = new Set(collapsedSessionGroups.value);
-    if (next.has(key)) next.delete(key);
-    else next.add(key);
-    collapsedSessionGroups.value = next;
-    const expanded = wasCollapsed && !next.has(key);
-    if (expanded && isChannelBucketKey(key)) {
-        await ensureChannelBucketLoaded(key);
-        await ensureBucketFillsViewport(key);
-    }
-    await refreshSessionListScrollability();
-};
+const activeSessionBucketKey = ref(DEFAULT_SESSION_BUCKET_KEY);
 const sessionListCanScroll = ref(false);
-const webBucket = computed(() => sessionBuckets.value.web);
 const visibleChannelBuckets = computed(() =>
     bucketOrder.value
         .map((key) => sessionBuckets.value[key])
         .filter((bucket): bucket is SidebarSessionBucket => !!bucket && isChannelBucket(bucket) && bucketVisible(bucket)),
 );
+const showSessionSourceFilter = computed(() =>
+    shouldShowSessionSourceFilter(visibleChannelBuckets.value.length),
+);
+const sessionScopeFilterPinned = computed(() =>
+    activeSessionBucketKey.value !== DEFAULT_SESSION_BUCKET_KEY,
+);
+const sessionSourceOptions = computed(() =>
+    buildSessionSourceOptions(
+        t('menu.myChats'),
+        visibleChannelBuckets.value.map((bucket) => ({
+            key: bucket.key,
+            label: bucket.label,
+            platform: bucket.platform,
+        })),
+        (platform) => platformLogo(platform),
+    ),
+);
+const activeBucket = computed(() => sessionBuckets.value[activeSessionBucketKey.value]);
 const hasAnySession = computed(() =>
     Object.values(sessionBuckets.value).some((bucket) => bucket.items.length > 0),
 );
@@ -498,6 +442,7 @@ const currentKbInfo = ref<any>(null)
 // 进行中的置顶/取消置顶请求，避免重复点击
 const pinningIds = ref<Set<string>>(new Set())
 
+// 「聊天」区内按日期分组（当前筛选来源）
 const dateBucketLabels = computed<Record<DateBucketKey, string>>(() => ({
     pinned: t('time.pinned'),
     today: t('time.today'),
@@ -508,18 +453,28 @@ const dateBucketLabels = computed<Record<DateBucketKey, string>>(() => ({
     earlier: t('time.earlier'),
 }));
 
-// 「聊天」区内按日期分组（仅 web 会话）
-const chatGroupedSessions = computed(() => {
-    const web = sessionBuckets.value.web;
-    if (!web?.items.length) return [];
-
+const filteredGroupedSessions = computed(() => {
+    const bucket = activeBucket.value;
+    if (!bucket?.items.length) return [];
     return groupSessionsByDate(
-        web.items,
+        bucket.items.map((item) => ({
+            ...item,
+            path: `chat/${item.id}`,
+        })),
         dateBucketLabels.value,
         (session) => classifyDateBucket(session.updated_at || session.created_at),
     );
 });
 
+const showSessionScopeFallback = computed(() => {
+    if (!showSessionSourceFilter.value || batchMode.value) return false;
+    if (sessionListBooting.value && !hasAnySession.value) return true;
+    const bucket = activeBucket.value;
+    if (bucket?.loading && !bucket.loaded && filteredGroupedSessions.value.length === 0) return true;
+    if (bucket?.loaded && filteredGroupedSessions.value.length === 0) return true;
+    return false;
+});
+
 const refreshSessionListScrollability = async () => {
     await nextTick();
     const container = scrollContainer.value;
@@ -863,6 +818,38 @@ const loadBucketPage = async (key: string, page?: number, token?: number) => {
     }
 };
 
+const switchSessionBucket = async (key: string) => {
+    if (key === activeSessionBucketKey.value) return;
+    activeSessionBucketKey.value = key;
+    const bucket = sessionBuckets.value[key];
+    if (bucket && !bucket.loaded && !bucket.loading) {
+        await loadBucketPage(key, 1);
+    }
+    await ensureBucketFillsViewport(key);
+    await refreshSessionListScrollability();
+};
+
+const syncActiveBucketFromChat = async (sessionId: string | undefined) => {
+    if (!sessionId) return;
+
+    let bucketKey = findSessionBucketKey(sessionBuckets.value, sessionId);
+    if (!bucketKey) {
+        const chatMenu = (menuArr.value as unknown as MenuItem[]).find((item) => item.path === 'creatChat');
+        const fromStore = (chatMenu?.children as Record<string, unknown>[] | undefined)
+            ?.find((item) => item.id === sessionId);
+        if (fromStore) {
+            bucketKey = originGroupKey(resolveSessionOrigin(menuChildToSessionRow(fromStore)));
+        }
+    }
+    if (!bucketKey || bucketKey === activeSessionBucketKey.value) return;
+
+    activeSessionBucketKey.value = bucketKey;
+    const bucket = sessionBuckets.value[bucketKey];
+    if (bucket && !bucket.loaded && !bucket.loading) {
+        await loadBucketPage(bucketKey, 1);
+    }
+};
+
 const initSessionBuckets = async () => {
     const token = ++bucketRequestToken;
     sessionListBooting.value = true;
@@ -884,7 +871,6 @@ const initSessionBuckets = async () => {
 
     if (token === bucketRequestToken) {
         sessionListBooting.value = false;
-        applyDefaultChannelCollapse();
         syncMenuStoreFromBuckets();
         await ensureBucketFillsViewport('web');
         await refreshSessionListScrollability();
@@ -895,23 +881,24 @@ const getMessageList = async () => {
     await initSessionBuckets();
 };
 
-// 滚动到底时仅为「聊天」区加载下一页 web 会话
+// 滚动到底时为当前筛选来源加载下一页
 const checkScrollBottom = async () => {
     const container = scrollContainer.value;
-    const web = sessionBuckets.value.web;
-    if (!container || !web || !bucketHasMore(web) || web.loading) return;
+    const key = activeSessionBucketKey.value;
+    const bucket = sessionBuckets.value[key];
+    if (!container || !bucket || !bucketHasMore(bucket) || bucket.loading) return;
 
     const { scrollTop, scrollHeight, clientHeight } = container;
     const hasOverflow = scrollHeight > clientHeight + 1;
     if (!hasOverflow) {
-        await ensureBucketFillsViewport('web');
+        await ensureBucketFillsViewport(key);
         return;
     }
 
     const isNearBottom = scrollHeight - (scrollTop + clientHeight) < 100;
     if (!isNearBottom) return;
 
-    await loadBucketPage('web');
+    await loadBucketPage(key);
 };
 
 const handleScroll = debounce(checkScrollBottom, 200);
@@ -980,6 +967,7 @@ onMounted(async () => {
     const initialChatId = route.params.chatid as string | undefined;
     if (initialChatId) {
         ensureSessionInSidebar(initialChatId);
+        await syncActiveBucketFromChat(initialChatId);
     }
     // 若组织列表未加载则拉取一次，用于侧栏「待审批」角标
     if (orgStore.organizations.length === 0) {
@@ -1005,6 +993,7 @@ watch([() => route.name, () => route.params], (newvalue, oldvalue) => {
     const newChatId = (newvalue[1] as any)?.chatid as string | undefined;
     if (nameStr === 'chat' && newChatId) {
         ensureSessionInSidebar(newChatId);
+        void syncActiveBucketFromChat(newChatId);
     }
 
     // 路由变化时更新图标状态和知识库信息（不涉及对话列表）
@@ -1464,7 +1453,7 @@ const onDragHandleMouseDown = (e: MouseEvent) => {
 
     .submenu {
         font-family: var(--app-font-family);
-        font-size: 13px;
+        font-size: 14px;
         font-style: normal;
         min-width: 0;
         padding-top: 3px;
@@ -1498,60 +1487,6 @@ const onDragHandleMouseDown = (e: MouseEvent) => {
         opacity: 1;
     }
 
-    .session-channels-section {
-        // 渠道图标 14px + 间距 6px → 子会话标题与文件夹文案左对齐
-        --sidebar-channel-icon-size: 14px;
-        --sidebar-channel-icon-gap: 6px;
-        --sidebar-channel-label-inset: calc(var(--sidebar-inset-x) + var(--sidebar-channel-icon-size) + var(--sidebar-channel-icon-gap));
-        margin-bottom: 4px;
-
-        .session-folder-header {
-            min-height: 28px;
-            font-size: 13px;
-            font-weight: 500;
-            line-height: 18px;
-            color: var(--td-text-color-secondary);
-        }
-
-        .session-folder-entry {
-            display: inline-flex;
-            align-items: center;
-            min-width: 0;
-            flex: 1 1 auto;
-            overflow: hidden;
-        }
-
-        .session-channel-inline-icon {
-            flex-shrink: 0;
-            width: var(--sidebar-channel-icon-size);
-            height: var(--sidebar-channel-icon-size);
-            margin-right: var(--sidebar-channel-icon-gap);
-            object-fit: contain;
-            filter: grayscale(1);
-            opacity: 0.55;
-        }
-
-        :deep(.session-channel-inline-icon.t-icon) {
-            color: var(--td-text-color-secondary);
-            opacity: 0.75;
-        }
-
-        .session-list-row--channel-nested {
-            padding-left: var(--sidebar-channel-label-inset);
-        }
-
-        .session-folder-item.session-chat-row .session-list-row {
-            min-height: 28px;
-        }
-
-        .session-folder-item :deep(.submenu_item) {
-            font-size: 13px;
-            line-height: 18px;
-            padding: 4px 0;
-        }
-    }
-
-    // 标题 + 折叠箭头紧挨排列，箭头 hover 时才出现
     // 列表行统一栅格：左缘 inset-x + 图标槽 18px + 间距 8px → 文案列与主菜单文字对齐
     .session-list-row {
         display: flex;
@@ -1584,72 +1519,6 @@ const onDragHandleMouseDown = (e: MouseEvent) => {
         gap: 0;
     }
 
-    // 渠道文件夹内会话：与文件夹标题文字列对齐
-    .session-list-row--nested {
-        padding-left: var(--sidebar-text-inset);
-        gap: 0;
-    }
-
-    .session-header-text {
-        display: inline-flex;
-        align-items: center;
-        gap: 3px;
-        min-width: 0;
-    }
-
-    .session-group-chevron {
-        flex: 0 0 auto;
-        color: var(--td-text-color-placeholder);
-        opacity: 0;
-        transition: opacity 0.15s ease;
-    }
-
-    .session-folder-header {
-        padding-top: 2px;
-        padding-bottom: 2px;
-        border-radius: 6px;
-        cursor: pointer;
-        color: var(--td-text-color-secondary);
-        font-size: 13px;
-        font-weight: 500;
-        line-height: 18px;
-        user-select: none;
-        outline: none;
-
-        &:hover,
-        &:focus-visible {
-            background: var(--td-bg-color-container-hover);
-
-            .session-group-chevron {
-                opacity: 1;
-            }
-        }
-    }
-
-    .session-folder-icon {
-        width: var(--sidebar-channel-icon);
-        height: var(--sidebar-channel-icon);
-        object-fit: contain;
-        flex-shrink: 0;
-    }
-
-    .session-folder-label {
-        overflow: hidden;
-        text-overflow: ellipsis;
-        white-space: nowrap;
-    }
-
-    .session-folder-loading {
-        display: flex;
-        align-items: center;
-        padding: 4px 0;
-        color: var(--td-text-color-placeholder);
-
-        .session-list-row {
-            width: 100%;
-        }
-    }
-
     .session-list-loading {
         display: flex;
         align-items: center;
@@ -1673,26 +1542,48 @@ const onDragHandleMouseDown = (e: MouseEvent) => {
         white-space: nowrap;
     }
 
-    .timeline_header--collapsible {
-        cursor: pointer;
-        outline: none;
+    .timeline_header--with-scope {
+        justify-content: space-between;
+        gap: 10px;
 
-        &:hover,
-        &:focus-visible {
-            color: var(--td-text-color-secondary);
+        :deep(.session-source-filter--inline) {
+            flex: 0 1 auto;
+            min-width: 0;
+            max-width: 52%;
+            opacity: 0;
+            transition: opacity 0.15s ease;
+        }
+
+        &:hover :deep(.session-source-filter--inline),
+        &:focus-within :deep(.session-source-filter--inline),
+        :deep(.session-source-filter--inline.session-source-filter--emphasized) {
+            opacity: 1;
         }
     }
 
-    .timeline_header-chevron {
-        flex: 0 0 auto;
-        color: inherit;
-        opacity: 0.55;
-        transition: opacity 0.15s ease;
+    .submenu--scope-fallback {
+        position: relative;
+        padding-top: 18px;
     }
 
-    .timeline_header--collapsible:hover .timeline_header-chevron,
-    .timeline_header--collapsible:focus-visible .timeline_header-chevron {
-        opacity: 1;
+    .session-list-scope-fallback {
+        position: absolute;
+        top: 1px;
+        right: 10px;
+        z-index: 1;
+        display: flex;
+        justify-content: flex-end;
+        max-width: calc(100% - var(--sidebar-inset-x) - 10px);
+
+        :deep(.session-source-filter--inline) {
+            opacity: 0;
+            transition: opacity 0.15s ease;
+        }
+
+        &:hover :deep(.session-source-filter--inline),
+        :deep(.session-source-filter--inline.session-source-filter--emphasized) {
+            opacity: 1;
+        }
     }
 
     .submenu_item_p {
@@ -1702,7 +1593,7 @@ const onDragHandleMouseDown = (e: MouseEvent) => {
         overflow: hidden;
 
         &.session-chat-row .session-list-row {
-            min-height: 28px;
+            min-height: 30px;
             border-radius: 6px;
             transition: background 0.15s ease, color 0.15s ease;
         }
@@ -1747,11 +1638,11 @@ const onDragHandleMouseDown = (e: MouseEvent) => {
         align-items: center;
         color: var(--td-text-color-primary);
         font-weight: 400;
-        font-size: 13px;
-        line-height: 18px;
+        font-size: 14px;
+        line-height: 20px;
         height: 100%;
         width: 100%;
-        padding: 5px 0;
+        padding: 6px 0;
         position: relative;
         min-width: 0;
         background: transparent;
diff --git a/frontend/src/components/sessionSidebarSourceFilter.test.ts b/frontend/src/components/sessionSidebarSourceFilter.test.ts
new file mode 100644
index 00000000..b60729dd
--- /dev/null
+++ b/frontend/src/components/sessionSidebarSourceFilter.test.ts
@@ -0,0 +1,39 @@
+import assert from 'node:assert/strict'
+import test from 'node:test'
+import {
+  DEFAULT_SESSION_BUCKET_KEY,
+  buildSessionSourceOptions,
+  findSessionBucketKey,
+  shouldShowSessionSourceFilter,
+} from './sessionSidebarSourceFilter.ts'
+
+test('shouldShowSessionSourceFilter hides when no channel buckets', () => {
+  assert.equal(shouldShowSessionSourceFilter(0), false)
+  assert.equal(shouldShowSessionSourceFilter(1), true)
+})
+
+test('buildSessionSourceOptions puts web first then channels', () => {
+  const options = buildSessionSourceOptions(
+    'My chats',
+    [
+      { key: 'im:wechat', label: 'WeChat', platform: 'wechat' },
+      { key: 'embed:abc', label: 'Widget' },
+    ],
+    (platform) => `logo:${platform}`,
+  )
+  assert.equal(options.length, 3)
+  assert.equal(options[0].value, DEFAULT_SESSION_BUCKET_KEY)
+  assert.equal(options[1].logo, 'logo:wechat')
+  assert.equal(options[2].logo, undefined)
+})
+
+test('findSessionBucketKey locates session bucket', () => {
+  const key = findSessionBucketKey(
+    {
+      web: { items: [{ id: 'a' }] },
+      'im:wechat': { items: [{ id: 'b' }] },
+    },
+    'b',
+  )
+  assert.equal(key, 'im:wechat')
+})
diff --git a/frontend/src/components/sessionSidebarSourceFilter.ts b/frontend/src/components/sessionSidebarSourceFilter.ts
new file mode 100644
index 00000000..d078292a
--- /dev/null
+++ b/frontend/src/components/sessionSidebarSourceFilter.ts
@@ -0,0 +1,38 @@
+// Sidebar session list source filter: web chats default, optional IM / embed buckets.
+
+export const DEFAULT_SESSION_BUCKET_KEY = 'web'
+
+export interface SessionSourceOption {
+  value: string
+  label: string
+  logo?: string
+}
+
+export function shouldShowSessionSourceFilter(visibleChannelCount: number): boolean {
+  return visibleChannelCount > 0
+}
+
+export function buildSessionSourceOptions(
+  webLabel: string,
+  channelBuckets: Array<{ key: string; label: string; platform?: string }>,
+  logoForPlatform: (platform: string) => string,
+): SessionSourceOption[] {
+  return [
+    { value: DEFAULT_SESSION_BUCKET_KEY, label: webLabel },
+    ...channelBuckets.map((bucket) => ({
+      value: bucket.key,
+      label: bucket.label,
+      logo: bucket.platform ? logoForPlatform(bucket.platform) : undefined,
+    })),
+  ]
+}
+
+export function findSessionBucketKey(
+  buckets: Record<string, { items: Array<{ id: string }> }>,
+  sessionId: string,
+): string | null {
+  for (const [key, bucket] of Object.entries(buckets)) {
+    if (bucket.items.some((row) => row.id === sessionId)) return key
+  }
+  return null
+}