From 285bf234bd50ce54fcae7bb777f8fa579b91266e Mon Sep 17 00:00:00 2001
From: kongdeqiang <123456>
Date: 星期一, 12 十月 2026 09:53:45 +0800
Subject: [PATCH] fix: 新增分组

---
 src/utils/download.js                 |   62 +++
 src/utils/sidebarGroups.js            |   76 ++++
 src/api/chatGroupApi.js               |   33 ++
 src/utils/chatTime.js                 |  126 +++++++
 src/components/ArchivedChatDrawer.vue |  295 ++++++++++++++++++
 src/utils/uiPrefs.js                  |  111 ++++++
 src/components/ChatListItem.vue       |  223 +++++++++++++
 7 files changed, 926 insertions(+), 0 deletions(-)

diff --git a/src/api/chatGroupApi.js b/src/api/chatGroupApi.js
new file mode 100644
index 0000000..05d5ae4
--- /dev/null
+++ b/src/api/chatGroupApi.js
@@ -0,0 +1,33 @@
+import http from './axios'
+
+/**
+ * 瀵硅瘽鍒嗙粍锛堢敤鎴疯嚜寤虹殑鏂囦欢澶癸級銆�
+ *
+ * 涓庛�屼粖澶� / 鏄ㄥぉ / 鏇存棭銆嶇殑鏃堕棿鍒嗙粍鏃犲叧锛氶偅鏄墠绔寜鏃堕棿绠楀嚭鏉ョ殑瑙嗗浘褰掔被锛�
+ * 杩欓噷鏄瓨鍦ㄦ暟鎹簱閲屻�佺敤鎴峰彲浠ュ懡鍚嶅拰澧炲垹鐨勫疄浣撱��
+ */
+
+/** 褰撳墠鐢ㄦ埛鐨勫叏閮ㄥ垎缁勶紙鍚瘡涓垎缁勭殑浼氳瘽鏁帮級 */
+export function listChatGroups() {
+  return http.get('/chat-groups')
+}
+
+/** 鏂板缓鍒嗙粍 */
+export function createChatGroup(name) {
+  return http.post('/chat-groups', { name })
+}
+
+/** 閲嶅懡鍚嶅垎缁� */
+export function renameChatGroup(groupId, name) {
+  return http.put(`/chat-groups/${groupId}`, { name })
+}
+
+/**
+ * 鍒犻櫎鍒嗙粍銆�
+ *
+ * 鍙В闄ゅ垎缁勫叧绯伙紝**涓嶄細鍒犻櫎缁勫唴浼氳瘽** 鈥斺�� 瀹冧滑浼氬洖鍒般�屾湭鍒嗙粍銆嶃��
+ * 杩斿洖鍊奸噷甯� movedChats锛堣绉诲嚭鐨勪細璇濇暟锛夛紝鐢ㄤ簬缁欑敤鎴蜂竴鍙ユ槑纭殑鎻愮ず銆�
+ */
+export function deleteChatGroup(groupId) {
+  return http.delete(`/chat-groups/${groupId}`)
+}
diff --git a/src/components/ArchivedChatDrawer.vue b/src/components/ArchivedChatDrawer.vue
new file mode 100644
index 0000000..2da6ab5
--- /dev/null
+++ b/src/components/ArchivedChatDrawer.vue
@@ -0,0 +1,295 @@
+<template>
+  <n-drawer v-model:show="visible" :width="460" placement="right">
+    <n-drawer-content closable>
+      <template #header>
+        <div class="drawer-header">
+          <span>褰掓。瀵硅瘽</span>
+          <span class="drawer-count">{{ total }} 涓�</span>
+        </div>
+      </template>
+
+      <div class="archive-search">
+        <n-input
+          v-model:value="keyword"
+          size="small"
+          clearable
+          placeholder="鍦ㄥ綊妗g殑瀵硅瘽閲屾悳绱�"
+          @input="handleInput"
+        />
+      </div>
+
+      <n-spin v-if="loading || searching" size="small" class="archive-loading" />
+
+      <div v-else-if="visibleChats.length === 0" class="empty-hint archive-empty">
+        <template v-if="isSearching">
+          娌℃湁鎵惧埌鍖归厤銆寋{ keyword }}銆嶇殑褰掓。瀵硅瘽
+        </template>
+        <template v-else>
+          杩樻病鏈夊綊妗g殑瀵硅瘽<br />
+          鍦ㄥ璇濈殑銆屸嫰銆嶈彍鍗曢噷閫夈�屽綊妗c�嶏紝鑱婂畬鐨勫璇濆氨浼氭敹杩涜繖閲�
+        </template>
+      </div>
+
+      <div
+        v-for="chat in visibleChats"
+        v-else
+        :key="chat.id"
+        class="archive-item"
+        :class="{ active: chat.id === activeChatId }"
+        @click="$emit('select', chat.id)"
+      >
+        <div class="archive-item-main">
+          <div class="archive-title">{{ chat.title || '鏂板璇�' }}</div>
+          <div v-if="chat.matchSnippet" class="archive-snippet">{{ chat.matchSnippet }}</div>
+          <div class="archive-meta">
+            <span>褰掓。浜� {{ relative(chat.archivedAt) }}</span>
+            <span class="dot">路</span>
+            <span>{{ chat.messageCount || 0 }} 鏉℃秷鎭�</span>
+          </div>
+        </div>
+
+        <div class="archive-actions" @click.stop>
+          <n-button text size="tiny" @click="restore(chat)">鎭㈠</n-button>
+          <n-dropdown
+            trigger="click"
+            :options="downloadOptions"
+            placement="bottom-end"
+            @select="(key) => download(chat, key)"
+          >
+            <n-button text size="tiny">涓嬭浇</n-button>
+          </n-dropdown>
+          <n-button text size="tiny" class="danger" @click="confirmDelete(chat)">鍒犻櫎</n-button>
+        </div>
+      </div>
+    </n-drawer-content>
+  </n-drawer>
+</template>
+
+<script setup>
+import { computed, ref, watch } from 'vue'
+import {
+  NButton,
+  NDrawer,
+  NDrawerContent,
+  NDropdown,
+  NInput,
+  NSpin,
+  useDialog,
+  useMessage
+} from 'naive-ui'
+import { useChatStore } from '@/stores/chatStore'
+import { formatRelative } from '@/utils/chatTime'
+
+const props = defineProps({
+  show: { type: Boolean, default: false }
+})
+const emit = defineEmits(['update:show', 'select'])
+
+const chatStore = useChatStore()
+const message = useMessage()
+const dialog = useDialog()
+
+const loading = ref(false)
+const keyword = ref('')
+
+/** 鎶藉眽寮�鍏筹細鏈湴浠g悊 v-model:show */
+const visible = computed({
+  get: () => props.show,
+  set: (value) => emit('update:show', value)
+})
+
+const activeChatId = computed(() => chatStore.activeChatId)
+const total = computed(() => chatStore.archivedChats.length)
+const isSearching = computed(() => keyword.value.trim().length > 0)
+const searching = computed(() => chatStore.archiveSearching)
+
+/**
+ * 褰掓。鍒楄〃鐨勫姞杞芥椂鏈恒��
+ *
+ * 鎶藉眽姣忔鎵撳紑閮介噸鏂版媺涓�娆★紝鑰屼笉鏄緷璧栨寕杞芥椂鐨勪竴娆″姞杞斤細
+ * 褰掓。鍔ㄤ綔鍙兘鍙戠敓鍦ㄨ繖涓粍浠朵箣澶栵紙渚ц竟鏍忚彍鍗曪級锛�
+ * 姣忔鎵撳紑閮藉埛鏂版槸鏈�鐪佸績涔熸渶涓嶅鏄撳嚭鐜般�屽綊妗d簡浣嗗垪琛ㄩ噷娌℃湁銆嶇殑鍋氭硶銆�
+ */
+watch(visible, async (open) => {
+  if (!open) return
+  keyword.value = ''
+  chatStore.clearArchiveSearch()
+  loading.value = true
+  try {
+    await chatStore.loadArchivedChats()
+  } catch (error) {
+    message.error(error.message || '鍔犺浇褰掓。瀵硅瘽澶辫触')
+  } finally {
+    loading.value = false
+  }
+})
+
+/** 鎼滅储鎬佹樉绀虹粨鏋滐紝鍚﹀垯鏄剧ず鍏ㄩ儴褰掓。浼氳瘽 */
+const visibleChats = computed(() =>
+  isSearching.value ? chatStore.archiveResults : chatStore.archivedChats
+)
+
+let timer = null
+function handleInput() {
+  if (timer) clearTimeout(timer)
+  const value = keyword.value
+  if (!value.trim()) {
+    chatStore.clearArchiveSearch()
+    return
+  }
+  timer = setTimeout(async () => {
+    try {
+      await chatStore.searchArchive(value)
+    } catch (error) {
+      message.error(error.message || '鎼滅储澶辫触')
+    }
+  }, 250)
+}
+
+function relative(value) {
+  return formatRelative(value)
+}
+
+const downloadOptions = [
+  { label: 'JSON锛堝惈鍏ㄩ儴鍒嗘敮锛�', key: 'json' },
+  { label: 'TXT锛堢函鏂囨湰锛�', key: 'txt' },
+  { label: 'PDF锛堝甫椤电爜鎺掔増锛�', key: 'pdf' }
+]
+
+async function restore(chat) {
+  try {
+    await chatStore.setArchived(chat.id, false)
+    message.success('宸叉仮澶嶅埌瀵硅瘽鍒楄〃')
+  } catch (error) {
+    message.error(error.message || '鎭㈠澶辫触')
+  }
+}
+
+async function download(chat, format) {
+  try {
+    const filename = await chatStore.exportChat(chat.id, format)
+    message.success(`宸插鍑� ${filename}`)
+  } catch (error) {
+    message.error(error.message || '瀵煎嚭澶辫触')
+  }
+}
+
+function confirmDelete(chat) {
+  dialog.warning({
+    title: '鍒犻櫎瀵硅瘽',
+    content: `纭畾鍒犻櫎銆�${chat.title || '鏂板璇�'}銆嶅悧锛熷綊妗e彧鏄敹璧凤紝鍒犻櫎鏄�**涓嶅彲鎭㈠**鐨勶紝`
+      + '璇ヤ細璇濈殑鎵�鏈夋秷鎭兘浼氳涓�骞跺垹闄ゃ��',
+    positiveText: '鍒犻櫎',
+    negativeText: '鍙栨秷',
+    onPositiveClick: async () => {
+      try {
+        await chatStore.removeChat(chat.id)
+        message.success('宸插垹闄�')
+      } catch (error) {
+        message.error(error.message || '鍒犻櫎澶辫触')
+        return false
+      }
+      return true
+    }
+  })
+}
+</script>
+
+<style scoped>
+.drawer-header {
+  display: flex;
+  align-items: baseline;
+  gap: 8px;
+}
+
+.drawer-count {
+  font-size: 12px;
+  color: var(--text-muted);
+  font-weight: 400;
+}
+
+.archive-search {
+  margin-bottom: 10px;
+}
+
+.archive-loading {
+  display: flex;
+  justify-content: center;
+  padding: 24px 0;
+}
+
+.archive-empty {
+  padding: 32px 8px;
+  line-height: 1.9;
+  text-align: center;
+}
+
+.archive-item {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  padding: 10px;
+  border-radius: 8px;
+  cursor: pointer;
+  border: 1px solid transparent;
+}
+
+.archive-item:hover {
+  background: var(--bg-hover);
+}
+
+.archive-item.active {
+  background: #eef2f7;
+  border-color: #cbd5e1;
+}
+
+.archive-item-main {
+  flex: 1;
+  min-width: 0;
+}
+
+.archive-title {
+  font-size: 13.5px;
+  font-weight: 500;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.archive-snippet {
+  font-size: 11.5px;
+  color: var(--text-secondary);
+  margin-top: 3px;
+  display: -webkit-box;
+  -webkit-line-clamp: 2;
+  -webkit-box-orient: vertical;
+  overflow: hidden;
+}
+
+.archive-meta {
+  font-size: 11.5px;
+  color: var(--text-muted);
+  margin-top: 3px;
+}
+
+.dot {
+  margin: 0 4px;
+}
+
+.archive-actions {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  flex-shrink: 0;
+  opacity: 0;
+  transition: opacity 0.12s ease;
+}
+
+.archive-item:hover .archive-actions {
+  opacity: 1;
+}
+
+.danger {
+  color: #d03050;
+}
+</style>
diff --git a/src/components/ChatListItem.vue b/src/components/ChatListItem.vue
new file mode 100644
index 0000000..22db72f
--- /dev/null
+++ b/src/components/ChatListItem.vue
@@ -0,0 +1,223 @@
+<template>
+  <div
+    class="chat-item"
+    :class="{ active: active, indented: indented }"
+    :title="fullTime(chat.updatedAt)"
+    @click="$emit('select', chat.id)"
+  >
+    <div class="chat-item-main">
+      <!-- 鍙屽嚮杩涘叆灏卞湴閲嶅懡鍚嶏紝绗﹀悎妗岄潰绔枃浠剁鐞嗙殑鐩磋 -->
+      <n-input
+        v-if="editing"
+        ref="renameInputRef"
+        v-model:value="editingTitle"
+        size="tiny"
+        @blur="commitRename"
+        @keyup.enter="commitRename"
+        @keyup.esc="cancelRename"
+        @click.stop
+      />
+      <div v-else class="chat-title" @dblclick.stop="startRename">
+        <span v-if="chat.pinned" class="pin-icon" title="宸茬疆椤�">馃搶</span>
+        {{ chat.title || '鏂板璇�' }}
+      </div>
+
+      <!-- 鍛戒腑娑堟伅鍐呭鏃跺睍绀虹墖娈碉紙鎼滅储缁撴灉鐢級锛屾柟渚跨‘璁ゆ槸涓嶆槸杩欐瀵硅瘽 -->
+      <div v-if="chat.matchSnippet" class="chat-snippet">{{ chat.matchSnippet }}</div>
+
+      <div class="chat-meta">
+        <span class="chat-date">{{ time(chat.updatedAt) }}</span>
+        <span class="chat-dot">路</span>
+        <span>{{ chat.messageCount || 0 }} 鏉℃秷鎭�</span>
+        <span v-if="chat.collectionNames?.length" class="chat-rag-tag">
+          路 {{ chat.collectionNames.length }} 涓煡璇嗗簱
+        </span>
+        <span v-if="chat.matchType" class="match-badge">{{ matchLabel }}</span>
+      </div>
+    </div>
+
+    <n-dropdown
+      trigger="click"
+      :options="options"
+      placement="bottom-end"
+      @select="(key) => $emit('menu', key, chat)"
+    >
+      <n-button text class="chat-more" @click.stop>鈰�</n-button>
+    </n-dropdown>
+  </div>
+</template>
+
+<script setup>
+import { computed, nextTick, ref } from 'vue'
+import { NButton, NDropdown, NInput, useMessage } from 'naive-ui'
+import { useChatStore } from '@/stores/chatStore'
+import { formatChatTime, formatFullTime } from '@/utils/chatTime'
+
+/**
+ * 渚ц竟鏍忛噷鐨勪竴鏉′細璇濄��
+ *
+ * 鎶芥垚缁勪欢鏄洜涓哄悓涓�涓潯鐩幇鍦ㄨ鍑虹幇鍦ㄤ笁涓湴鏂癸細鎼滅储缁撴灉銆佹椂闂村垎缁勩��
+ * 鑷畾涔夊垎缁勩�傚鍒朵笁浠芥ā鏉挎剰鍛崇潃浠ュ悗鏀逛竴澶勬牱寮忚璁板緱鏀逛笁澶�
+ * 锛堣繖涓」鐩殑鍥剧墖鏄剧ず bug 灏辨槸杩欎箞鏉ョ殑锛夈��
+ */
+const props = defineProps({
+  chat: { type: Object, required: true },
+  active: { type: Boolean, default: false },
+  /** 鍒嗙粍鍐呯殑鏉$洰缂╄繘涓�灞傦紝浣撶幇灞傜骇 */
+  indented: { type: Boolean, default: false },
+  /** 鑿滃崟椤圭敱鐖剁粍浠舵彁渚涳細涓嶅悓浣嶇疆锛堟悳绱㈡��/鍒嗙粍鍐咃級鍙敤鎿嶄綔涓嶅悓 */
+  options: { type: Array, required: true }
+})
+
+const emit = defineEmits(['select', 'menu'])
+
+const chatStore = useChatStore()
+const toast = useMessage()
+
+// 灏卞湴閲嶅懡鍚嶏細鏉$洰鑷繁绠$悊缂栬緫鎬侊紝鐖剁粍浠朵笉蹇呬负銆屽摢涓�鏉″湪缂栬緫銆嶇淮鎶ょ姸鎬�
+const editing = ref(false)
+const editingTitle = ref('')
+const renameInputRef = ref(null)
+
+function time(value) {
+  return formatChatTime(value)
+}
+
+function fullTime(value) {
+  return formatFullTime(value)
+}
+
+const matchLabel = computed(() => {
+  const type = props.chat.matchType
+  if (type === 'title') return '鏍囬鍛戒腑'
+  if (type === 'both') return '鏍囬+鍐呭'
+  return '鍐呭鍛戒腑'
+})
+
+function startRename() {
+  if (editing.value) return
+  editing.value = true
+  editingTitle.value = props.chat.title || ''
+  nextTick(() => renameInputRef.value?.focus?.())
+}
+
+function cancelRename() {
+  editing.value = false
+  editingTitle.value = ''
+}
+
+async function commitRename() {
+  const title = editingTitle.value.trim()
+  // 娌℃敼鍔ㄦ垨涓虹┖鍒欐斁寮冿紝閬垮厤浜х敓绌烘爣棰�
+  if (!title || title === props.chat.title) {
+    cancelRename()
+    return
+  }
+  try {
+    await chatStore.renameChat(props.chat.id, title)
+    toast.success('宸查噸鍛藉悕')
+  } catch (error) {
+    toast.error(error.message || '閲嶅懡鍚嶅け璐�')
+  } finally {
+    cancelRename()
+  }
+}
+
+defineExpose({ startRename })
+</script>
+
+<style scoped>
+.chat-item {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+  padding: 9px 10px;
+  border-radius: 8px;
+  cursor: pointer;
+  margin-bottom: 2px;
+  transition: background 0.12s ease;
+}
+
+.chat-item:hover {
+  background: var(--bg-hover);
+}
+
+.chat-item.active {
+  background: #e3e5e8;
+}
+
+/* 鍒嗙粍鍐呯殑鏉$洰缂╄繘锛屼綋鐜般�屽畠鍦ㄨ繖涓枃浠跺す閲屻�� */
+.chat-item.indented {
+  padding-left: 20px;
+}
+
+.chat-item-main {
+  flex: 1;
+  min-width: 0;
+}
+
+.chat-title {
+  font-size: 13.5px;
+  font-weight: 500;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.pin-icon {
+  font-size: 11px;
+  margin-right: 2px;
+}
+
+.chat-snippet {
+  font-size: 11.5px;
+  color: var(--text-secondary);
+  margin-top: 3px;
+  display: -webkit-box;
+  -webkit-line-clamp: 2;
+  -webkit-box-orient: vertical;
+  overflow: hidden;
+  line-height: 1.5;
+}
+
+.chat-meta {
+  font-size: 11.5px;
+  color: var(--text-muted);
+  margin-top: 3px;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.chat-date {
+  /* 绛夊鏁板瓧锛氬琛屾棩鏈熷湪瑙嗚涓婂榻愶紝鎵鏃朵笉浼氬弬宸� */
+  font-variant-numeric: tabular-nums;
+}
+
+.chat-dot {
+  margin: 0 4px;
+}
+
+.chat-rag-tag {
+  color: #6b7280;
+}
+
+.match-badge {
+  color: #0f766e;
+  margin-left: 6px;
+}
+
+.chat-more {
+  opacity: 0;
+  font-size: 16px;
+  line-height: 1;
+  padding: 0 4px;
+  color: var(--text-secondary);
+  transition: opacity 0.12s ease;
+}
+
+.chat-item:hover .chat-more,
+.chat-item.active .chat-more {
+  opacity: 1;
+}
+</style>
diff --git a/src/utils/chatTime.js b/src/utils/chatTime.js
new file mode 100644
index 0000000..b58eb18
--- /dev/null
+++ b/src/utils/chatTime.js
@@ -0,0 +1,126 @@
+/**
+ * 浼氳瘽鍒楄〃鐨勬椂闂村鐞嗕笌鍒嗙粍銆�
+ *
+ * 銆屼粖澶� / 鏄ㄥぉ / 鏇存棭銆嶈繖涓変釜鍒嗙粍鐨勫垽瀹氱湅璧锋潵绠�鍗曪紝浣嗘湁鍑犱釜蹇呴』澶勭悊濂界殑鐐癸細
+ *
+ *   1. **鎸夋湰鍦版棩鍘嗘棩姣旇緝锛屼笉鏄寜 24 灏忔椂宸�**
+ *      鍑屾櫒 1 鐐圭湅鍒般�屾槰澶� 23:00 鐨勫璇濄�嶏紝濡傛灉鎸夈�岀浉宸笉鍒� 24 灏忔椂銆嶇畻锛�
+ *      瀹冧細琚綊鍒般�屼粖澶┿�嶏紝涓庣敤鎴风殑鐩磋涓嶇銆�
+ *   2. **鏃堕棿鏄� ISO 瀛楃涓蹭笖涓嶅甫鏃跺尯**
+ *      鍚庣杩斿洖鐨勬槸 LocalDateTime锛堝 2026-10-09T10:32:24锛夛紝
+ *      `new Date('2026-10-09T10:32:24')` 鍦ㄦ祻瑙堝櫒閲屾寜**鏈湴鏃跺尯**瑙f瀽锛�
+ *      琛屼负姝eソ绗﹀悎棰勬湡锛涗絾濡傛灉鍝ぉ鍚庣鏀规垚甯� Z 鐨勬牸寮忥紝
+ *      杩欓噷鐨勬瘮杈冮�昏緫闇�瑕佽窡鐫�璋冩暣锛堟墍浠ラ泦涓湪鏈枃浠堕噷澶勭悊锛夈��
+ *   3. **缃《浼氳瘽鍗曠嫭鎴愮粍**
+ *      瀹冧滑宸茬粡鎸夈�岀疆椤跺厛鍚庛�嶆帓濂藉簭锛屽啀鍋氭椂闂村垎缁勫弽鑰屼細鎶婇『搴忔墦涔便��
+ */
+
+const DAY_MS = 24 * 60 * 60 * 1000
+
+/** 瑙f瀽鍚庣鏃堕棿锛涙棤娉曡В鏋愭椂杩斿洖 null锛岀敱璋冪敤鏂瑰厹搴� */
+export function parseTime(value) {
+  if (!value) return null
+  if (value instanceof Date) return value
+  const date = new Date(value)
+  return Number.isNaN(date.getTime()) ? null : date
+}
+
+function startOfDay(date) {
+  return new Date(date.getFullYear(), date.getMonth(), date.getDate())
+}
+
+/**
+ * 鐩稿樊鍑犱釜銆屾棩鍘嗘棩銆嶃��
+ * 0=浠婂ぉ锛�1=鏄ㄥぉ锛�2=鍓嶅ぉ鈥︹�� 鍙寜鏃ユ湡绠楋紝蹇界暐鍏蜂綋鏃跺埢銆�
+ */
+export function daysAgo(date, now = new Date()) {
+  if (!date) return Number.MAX_SAFE_INTEGER
+  const diff = startOfDay(now).getTime() - startOfDay(date).getTime()
+  return Math.round(diff / DAY_MS)
+}
+
+function pad(n) {
+  return String(n).padStart(2, '0')
+}
+
+/**
+ * 鍒楄〃椤逛笂鏄剧ず鐨勬棩鏈熸枃鏈� 鈥斺�� 鐢ㄦ埛鏄庣‘瑕佹眰銆屽垪琛ㄩ噷瑕佽兘鐪嬪埌鏃ユ湡銆嶏紝
+ * 鎵�浠ヨ繖閲屽缁堝甫涓婃棩鏈燂紝鑰屼笉鏄彧缁欎竴涓� HH:mm銆�
+ *
+ *   浠婂ぉ   鈫� 浠婂ぉ 10:32
+ *   鏄ㄥぉ   鈫� 鏄ㄥぉ 10:32
+ *   浠婂勾   鈫� 10-09 10:32
+ *   寰�骞�   鈫� 2025-10-09 10:32
+ */
+export function formatChatTime(value, now = new Date()) {
+  const date = parseTime(value)
+  if (!date) return ''
+
+  const time = `${pad(date.getHours())}:${pad(date.getMinutes())}`
+  const ago = daysAgo(date, now)
+  if (ago === 0) return `浠婂ぉ ${time}`
+  if (ago === 1) return `鏄ㄥぉ ${time}`
+  if (date.getFullYear() === now.getFullYear()) {
+    return `${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${time}`
+  }
+  return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${time}`
+}
+
+/** 瀹屾暣鏃堕棿锛岀敤浜� hover 鎻愮ず */
+export function formatFullTime(value) {
+  const date = parseTime(value)
+  if (!date) return ''
+  return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ` +
+    `${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}`
+}
+
+/** 鐩稿鏃堕棿锛岀敤浜庡綊妗e垪琛ㄨ繖绫讳笉寮鸿皟绮剧‘鏃跺埢鐨勫湴鏂� */
+export function formatRelative(value, now = new Date()) {
+  const date = parseTime(value)
+  if (!date) return ''
+  const ago = daysAgo(date, now)
+  if (ago === 0) return '浠婂ぉ'
+  if (ago === 1) return '鏄ㄥぉ'
+  if (ago < 30) return `${ago} 澶╁墠`
+  if (date.getFullYear() === now.getFullYear()) {
+    return `${date.getMonth() + 1} 鏈� ${date.getDate()} 鏃
+  }
+  return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`
+}
+
+/**
+ * 鎶婁細璇濆垪琛ㄦ寜銆岀疆椤� / 浠婂ぉ / 鏄ㄥぉ / 鏇存棭銆嶅垎缁勩��
+ *
+ * @param {Array} chats 鍚庣宸叉帓濂藉簭鐨勫垪琛紙缃《鍦ㄥ墠锛屽叾浣欐寜鏈�杩戞椿璺冨�掑簭锛�
+ * @returns {Array<{key:string,label:string,chats:Array}>} 鍙繑鍥為潪绌哄垎缁�
+ *
+ * 娉ㄦ剰锛氱粍鍐呴『搴�**瀹屽叏娌跨敤鍚庣椤哄簭**锛岃繖閲屽彧鍋氬垎妗讹紝涓嶆帓搴忋��
+ */
+export function groupChats(chats, now = new Date()) {
+  const list = Array.isArray(chats) ? chats : []
+
+  const pinned = []
+  const today = []
+  const yesterday = []
+  const earlier = []
+
+  for (const chat of list) {
+    if (chat.pinned) {
+      pinned.push(chat)
+      continue
+    }
+    // 鍒嗙粍渚濇嵁鐢ㄣ�屾渶杩戞椿璺冩椂闂淬�嶏細鐢ㄦ埛瀵广�岃繖娈靛璇濇槸浠�涔堟椂鍊欑殑銆嶇殑璁板繂
+    // 閫氬父鏉ヨ嚜鏈�鍚庝竴娆′氦璋堬紝鑰屼笉鏄垱寤烘椂闂�
+    const ago = daysAgo(parseTime(chat.updatedAt || chat.createdAt), now)
+    if (ago <= 0) today.push(chat)
+    else if (ago === 1) yesterday.push(chat)
+    else earlier.push(chat)
+  }
+
+  const groups = []
+  if (pinned.length) groups.push({ key: 'pinned', label: '缃《', chats: pinned })
+  if (today.length) groups.push({ key: 'today', label: '浠婂ぉ', chats: today })
+  if (yesterday.length) groups.push({ key: 'yesterday', label: '鏄ㄥぉ', chats: yesterday })
+  if (earlier.length) groups.push({ key: 'earlier', label: '鏇存棭', chats: earlier })
+  return groups
+}
diff --git a/src/utils/download.js b/src/utils/download.js
new file mode 100644
index 0000000..7f6f3ac
--- /dev/null
+++ b/src/utils/download.js
@@ -0,0 +1,62 @@
+/**
+ * 娴忚鍣ㄧ鏂囦欢涓嬭浇銆�
+ *
+ * 涓轰粈涔堣璧� Blob + 涓存椂 <a> 鑰屼笉鏄洿鎺� `location.href = url`锛�
+ *   瀵煎嚭鎺ュ彛闇�瑕� `Authorization` 澶达紝鑰屾祻瑙堝櫒鐩存帴璺宠浆鏄彂涓嶅嚭鑷畾涔夊ご鐨勶紝
+ *   缁撴灉灏辨槸涓�涓� 401 鐨勭┖鐧介〉銆傛墍浠ュ繀椤诲厛鐢� axios 甯� token 鍙栧洖瀛楄妭锛�
+ *   鍐嶅湪鍐呭瓨閲岄�犱竴涓璞� URL 浜ょ粰娴忚鍣ㄤ繚瀛樸��
+ */
+
+/**
+ * 浠� Content-Disposition 鍝嶅簲澶磋В鏋愭湇鍔$寤鸿鐨勬枃浠跺悕銆�
+ *
+ * 鏈嶅姟绔寜 RFC 5987 鍚屾椂缁欎簡涓や釜锛�
+ *   attachment; filename="export.pdf"; filename*=UTF-8''%E4%B8%AD%E6%96%87.pdf
+ * 涓枃鍚嶅彧鑳戒粠 filename* 閲屽彇锛坒ilename 閭d釜鏄� ASCII 鍏滃簳锛夈��
+ *
+ * @returns {string|null} 瑙f瀽涓嶅嚭鏉ユ椂杩斿洖 null锛岀敱璋冪敤鏂圭敤榛樿鍚嶅厹搴�
+ */
+export function filenameFromDisposition(disposition) {
+  if (!disposition) return null
+
+  // 浼樺厛 filename*锛堝甫瀛楃闆嗕笌鐧惧垎鍙风紪鐮侊級
+  const star = /filename\*\s*=\s*([^;]+)/i.exec(disposition)
+  if (star) {
+    let value = star[1].trim().replace(/^["']|["']$/g, '')
+    const parts = value.split("''")
+    if (parts.length === 2) {
+      value = parts[1]
+    }
+    try {
+      return decodeURIComponent(value)
+    } catch {
+      // 缂栫爜寮傚父鏃堕��鍥炰笅闈㈢殑鏅�� filename
+    }
+  }
+
+  const plain = /filename\s*=\s*"?([^";]+)"?/i.exec(disposition)
+  if (plain) {
+    return plain[1].trim()
+  }
+  return null
+}
+
+/**
+ * 瑙﹀彂娴忚鍣ㄤ繚瀛樹竴涓� Blob銆�
+ *
+ * 蹇呴』 revokeObjectURL锛氫笉閲婃斁鐨勮瘽锛屾瘡涓嬭浇涓�娆″氨鍦ㄥ唴瀛橀噷鐣欎竴浠�
+ * 瀹屾暣鏂囦欢鐨勫壇鏈紝鐩村埌椤甸潰鍏抽棴 鈥斺�� 涓嬭浇鍑犱釜澶� PDF 灏变細鏄庢樉鍚冨唴瀛樸��
+ */
+export function saveBlob(blob, filename) {
+  const url = URL.createObjectURL(blob)
+  const a = document.createElement('a')
+  a.href = url
+  a.download = filename || 'download'
+  a.style.display = 'none'
+  document.body.appendChild(a)
+  a.click()
+  document.body.removeChild(a)
+
+  // 浜ょ粰娴忚鍣ㄤ竴鐐规椂闂村紑濮嬩笅杞斤紝鍐嶉噴鏀�
+  setTimeout(() => URL.revokeObjectURL(url), 1000)
+}
diff --git a/src/utils/sidebarGroups.js b/src/utils/sidebarGroups.js
new file mode 100644
index 0000000..09ea5d8
--- /dev/null
+++ b/src/utils/sidebarGroups.js
@@ -0,0 +1,76 @@
+import { daysAgo, parseTime } from './chatTime'
+
+/**
+ * 鎶婁細璇濆垪琛ㄧ紪鎺掓垚渚ц竟鏍忚鏄剧ず鐨勭粨鏋勩��
+ *
+ * 涓夋潯瑙勫垯锛岄『搴忎篃鏄紭鍏堢骇锛�
+ *
+ *   1. **缃《涓旀湭鍒嗙粍** 鈫� 杩涖�岀疆椤躲�嶅尯锛堝浐瀹氬湪鍒楄〃鏈�涓婃柟锛�
+ *   2. **鏈夊垎缁�**       鈫� 杩涘畠鑷繁鐨勫垎缁勶紙鍝�曞畠杩樼疆椤剁潃 鈥斺�� 鐢ㄦ埛鏃㈢劧鎶婂畠
+ *                        鏀捐繘浜嗘枃浠跺す锛屽氨涓嶈鍐嶆妸瀹冧粠鏂囦欢澶归噷鎶借蛋锛�
+ *                        缃《鍦ㄨ繖閲屼綋鐜颁负銆屾帓鍦ㄨ鍒嗙粍鏈�鍓� + 甯﹀浘閽夈�嶏級
+ *   3. **鍏朵綑**         鈫� 鎸変粖澶� / 鏄ㄥぉ / 鏇存棭鑷姩褰掔被
+ *
+ * 涔熷氨鏄鑷畾涔夊垎缁勪笌鏃堕棿鍒嗙粍鏄�**浜掓枼**鐨勶細杩涗簡鏂囦欢澶瑰氨涓嶅啀鍑虹幇鍦�
+ * 鏃堕棿鍒嗙粍閲岋紝閬垮厤鍚屼竴鏉″璇濆湪渚ц竟鏍忓嚭鐜颁袱娆★紙鐐瑰摢涓兘浼氭墦寮�鍚屼竴鏉★紝
+ * 浣嗙敤鎴蜂細浠ヤ负鏈変袱浠斤級銆�
+ *
+ * 缁勫唴椤哄簭鐩存帴娌跨敤鍚庣杩斿洖鐨勯『搴忥紙鍚庣宸叉寜 pinned / pinned_at / updated_at
+ * 鎺掑ソ锛夛紝杩欓噷鍙仛鍒嗘《锛屼笉閲嶆帓 鈥斺�� 鍚﹀垯銆屽墠绔帓涓�閬嶃�佸悗绔帓涓�閬嶃��
+ * 杩熸棭浼氬嚭鐜颁袱杈逛笉涓�鑷达紝鍒锋柊涓�娆¢『搴忓張璺冲洖鍘汇��
+ *
+ * @param {Array} chats 鍚庣杩斿洖鐨勪細璇濆垪琛紙宸叉帓搴忥級
+ * @param {Array} groups 鍚庣杩斿洖鐨勫垎缁勫垪琛紙宸叉寜鍒涘缓椤哄簭锛�
+ * @param {Date} now 娉ㄥ叆褰撳墠鏃堕棿锛屼究浜庢祴璇�
+ */
+export function buildSidebarSections(chats, groups, now = new Date()) {
+  const list = Array.isArray(chats) ? chats : []
+  const groupList = Array.isArray(groups) ? groups : []
+
+  const pinned = []
+  const buckets = new Map()
+  const today = []
+  const yesterday = []
+  const earlier = []
+
+  for (const group of groupList) {
+    buckets.set(group.id, [])
+  }
+
+  for (const chat of list) {
+    // 鍒嗙粍鍙兘宸茶鍒犻櫎鑰屼細璇濊繕娈嬬暀 group_id锛堝苟鍙�/寮傚父鏁版嵁锛夛細
+    // 杩欐椂鎸夈�屾湭鍒嗙粍銆嶅鐞嗭紝瀹佸彲璁╁畠钀藉埌鏃堕棿鍒嗙粍閲岋紝涔熶笉瑕佸畠鍑┖娑堝け
+    const bucket = chat.groupId != null ? buckets.get(chat.groupId) : undefined
+
+    if (bucket) {
+      bucket.push(chat)
+      continue
+    }
+    if (chat.pinned) {
+      pinned.push(chat)
+      continue
+    }
+
+    const ago = daysAgo(parseTime(chat.updatedAt || chat.createdAt), now)
+    if (ago <= 0) today.push(chat)
+    else if (ago === 1) yesterday.push(chat)
+    else earlier.push(chat)
+  }
+
+  const timeGroups = []
+  if (today.length) timeGroups.push({ key: 'today', label: '浠婂ぉ', chats: today })
+  if (yesterday.length) timeGroups.push({ key: 'yesterday', label: '鏄ㄥぉ', chats: yesterday })
+  if (earlier.length) timeGroups.push({ key: 'earlier', label: '鏇存棭', chats: earlier })
+
+  return {
+    pinned,
+    // 绌哄垎缁勪篃瑕佷繚鐣欙細鐢ㄦ埛鍒氬缓濂借繕娌℃斁涓滆タ鐨勬枃浠跺す搴旇鐪嬪緱瑙侊紝
+    // 鍚﹀垯銆屾垜鏄庢槑寤轰簡鍒嗙粍锛屾�庝箞娌′簡銆�
+    groups: groupList.map((group) => ({
+      id: group.id,
+      name: group.name,
+      chats: buckets.get(group.id) || []
+    })),
+    timeGroups
+  }
+}
diff --git a/src/utils/uiPrefs.js b/src/utils/uiPrefs.js
new file mode 100644
index 0000000..949f61b
--- /dev/null
+++ b/src/utils/uiPrefs.js
@@ -0,0 +1,111 @@
+import { ref, watch } from 'vue'
+
+/**
+ * 鎶樺彔鐘舵�佽繖绫�**绾鍥惧亸濂�**鐨勮鍐欍��
+ *
+ * 涓轰粈涔堜笉瀛樺埌鏁版嵁搴擄細鐐逛竴涓嬫姌鍙犲氨鍙戜竴涓啓璇锋眰锛屾棦娌″繀瑕佷篃瀹规槗澶辫触
+ * 锛堢綉缁滄姈涓�涓嬫姌鍙犵姸鎬佸氨鍜岀溂鐫涚湅鍒扮殑涓嶄竴鑷翠簡锛夈�傝繖绫荤姸鎬佸睘浜庛�岃繖鍙版満鍣ㄧ殑
+ * 杩欎釜娴忚鍣ㄧ獥鍙c�嶏紝鏀� localStorage 姝eソ锛屽埛鏂板悗浠嶇劧淇濇寔銆�
+ *
+ * key 閲屼細甯︿笂鐢ㄦ埛 id锛氬悓涓�鍙版満鍣ㄤ笂鎹㈣处鍙风櫥褰曟椂锛屼袱涓敤鎴风殑鍒嗙粍鎶樺彔鐘舵��
+ * 涓嶈浜掔浉褰卞搷銆�
+ */
+
+const PREFIX = 'webui_ui_'
+
+function storageKey(key) {
+  // 浠� localStorage 閲屽凡淇濆瓨鐨勭敤鎴蜂俊鎭彇 id 鍋氬悗缂�銆�
+  // 涓� import authStore锛氶偅浼氬舰鎴� utils 鈫� store 鐨勫弽鍚戜緷璧栵紝
+  // 鑰岃繖閲屽彧闇�瑕佷竴涓ǔ瀹氱殑鏍囪瘑绗︺��
+  let who = 'anon'
+  try {
+    const raw = localStorage.getItem('webui_user')
+    if (raw) {
+      const user = JSON.parse(raw)
+      who = user?.id ?? user?.username ?? 'anon'
+    }
+  } catch {
+    // 瑙f瀽澶辫触灏辩敤 anon锛屼笉褰卞搷鍔熻兘
+  }
+  return `${PREFIX}${who}_${key}`
+}
+
+/**
+ * 涓�涓細鎸佷箙鍖栧埌 localStorage 鐨勫竷灏斿紑鍏炽��
+ *
+ * @param {string} key 鐘舵�佸悕锛堜細鑷姩鍔犱笂鐢ㄦ埛鍓嶇紑锛�
+ * @param {boolean} defaultValue 娌℃湁瀛樿繃鏃剁殑榛樿鍊�
+ * @returns {{ collapsed: import('vue').Ref<boolean>, toggle: Function, set: Function }}
+ */
+export function usePersistentFlag(key, defaultValue = false) {
+  const storage = storageKey(key)
+  let initial = defaultValue
+  try {
+    const raw = localStorage.getItem(storage)
+    if (raw === '1') initial = true
+    else if (raw === '0') initial = false
+  } catch {
+    // 闅愮妯″紡涓� localStorage 鍙兘涓嶅彲鐢紝閫�鍥為粯璁ゅ�煎嵆鍙�
+  }
+
+  const state = ref(initial)
+  watch(state, (value) => {
+    try {
+      localStorage.setItem(storage, value ? '1' : '0')
+    } catch {
+      // 瀛樹笉杩涘幓涓嶅奖鍝嶄娇鐢紝鍙槸鍒锋柊鍚庝笉璁板緱
+    }
+  })
+
+  return {
+    // 瀛楁鍚嶅氨鍙� collapsed锛氫箣鍓嶈繖閲屽彨 value锛岃皟鐢ㄦ柟鎸� `{ collapsed }` 瑙f瀯锛�
+    // 鎷垮埌鐨勬槸 undefined锛屽鑷淬�屾姌鍙犱簡浣嗙晫闈㈡病鍙嶅簲銆嶁�斺��
+    // 鍚嶅瓧蹇呴』鍜屽畠鐨勮涔変竴鑷达紝鍒浜虹寽銆�
+    collapsed: state,
+    toggle: () => { state.value = !state.value },
+    set: (v) => { state.value = !!v }
+  }
+}
+
+/**
+ * 涓�缁勩�屽垎缁勫悇鑷殑鎶樺彔鐘舵�併�嶏紝鍚屾牱鎸佷箙鍖栥��
+ *
+ * 瀛樼殑鏄竴寮� map锛歿 [groupId]: true/false }锛�
+ * 榛樿灞曞紑 鈥斺�� 鏀惰棌璧锋潵鐨勫璇濆垪琛ㄩ粯璁ゆ敹璧蜂細璁╀汉浠ヤ负鍒嗙粍鏄┖鐨勩��
+ */
+export function usePersistentMap(key) {
+  const storage = storageKey(key)
+  let initial = {}
+  try {
+    const raw = localStorage.getItem(storage)
+    if (raw) initial = JSON.parse(raw) || {}
+  } catch {
+    initial = {}
+  }
+
+  const state = ref(initial)
+  watch(state, (value) => {
+    try {
+      localStorage.setItem(storage, JSON.stringify(value))
+    } catch {
+      // 鍚屼笂锛岄潤榛樺拷鐣�
+    }
+  }, { deep: true })
+
+  return {
+    /**
+     * 榛樿**灞曞紑**锛氬彧鏈夋樉寮忓瓨杩� true 鎵嶇畻鏀惰捣銆�
+     *
+     * 杩欓噷韪╄繃涓�娆¤嚜宸辩殑鍧戯細涓�寮�濮嬫妸銆屾敹璧枫�嶅畾涔変负瀛� false锛�
+     * 鑰� toggle 鍐欐垚 `!(next[id] === false)` 鈥斺�� 缂虹渷鍊� undefined 浼氳瀹冪畻鍑� true锛�
+     * 涔熷氨鏄�岀涓�娆$偣鍑诲弽鑰屽啓鍏ヤ簡灞曞紑鐘舵�併�嶏紝缁撴灉鎶樺彔姘歌繙涓嶇敓鏁堛��
+     * 鍒ゅ畾涓庡啓鍏ュ繀椤讳弗鏍间簰閫嗭細瀛� true = 鏀惰捣锛岀己鐪� = 灞曞紑銆�
+     */
+    isCollapsed: (id) => state.value[id] === true,
+    toggle(id) {
+      const next = { ...state.value }
+      next[id] = !(next[id] === true)
+      state.value = next
+    }
+  }
+}

--
Gitblit v1.9.1