feat(im): tenant-wide IM channels overview under the user menu

Until now the IM channels a tenant has connected were only visible from
inside each agent's editor (AgentEditorModal → IMChannelPanel). Finding
out which bots are live across all agents meant clicking through every
one of them. Add a tenant-scoped overview so the set of connected IMs is
always one hop away from the avatar.

Backend

- im.Service.ListChannelsByTenant(tenantID) returns all non-deleted
  channels in the tenant, LEFT JOIN'd with custom_agents.name so
  built-in agents (which don't have rows in custom_agents) still show
  up with an empty agent_name; the frontend substitutes a localized
  "built-in agent" label.
- Credentials are intentionally stripped from this response — the list
  view is read-only and the editor route (GET /agents/:id/im-channels)
  remains the only source for secrets.
- New ChannelWithAgent DTO + IMHandler.ListAllIMChannels wired at
  GET /api/v1/im-channels under the existing RegisterIMChannelRoutes
  group, so auth middleware is inherited.

Frontend

- IMChannelsOverviewPanel.vue: floating submenu pane, stacked rows
  (agent on top, channel below) with identical 20px avatars and 12px
  labels so neither identity dominates. Each row is the whole click
  target (jumps to the agent editor); the switch uses @click.stop to
  toggle in place without triggering navigation.
- UserMenu.vue: new hover-driven submenu entry ("已接入的 IM" + link
  icon). The pane is teleported to <body> because the sidebar container
  has overflow:hidden that would otherwise clip right-flying content.
  Position is computed from the menu item's rect and clamps/flips
  against the viewport edges.
- "Live" indicator: a pulsing green dot on the menu item when at least
  one channel is enabled. UserMenu prefetches the list once on mount;
  the panel re-emits channels-changed after every load/toggle so the
  dot stays in sync. Respects prefers-reduced-motion.
- AgentList.vue: supplement the existing onMounted-only
  checkAndOpenEditModal with a watch(route.query.edit) so
  router.push({ path: '/platform/agents', query: { edit, section } })
  from an already-mounted AgentList (the common case when navigating
  from the overview) opens the editor immediately instead of only
  after a hard refresh.

Assets

- Seven platform SVGs under assets/img/im/, pulled from iconify
  (simple-icons / logos / tdesign / icon-park / remix icon) and baked
  with brand colors so monochrome sources (wecom/wechat/dingtalk/
  feishu) don't render black.

i18n

- New imOverview namespace in zh-CN / en-US / ko-KR / ru-RU covering
  the menu label, panel title/subtitle, column headers, builtin-agent
  fallback, and the live-indicator tooltip.

Tested

- go build ./...
- go test ./internal/im/...
- vue-tsc --noEmit
- npm run build
This commit is contained in:
wizardchen
2026-04-30 15:23:28 +08:00
committed by lyingbug
parent a5f80b747c
commit e029d31f86
18 changed files with 821 additions and 3 deletions
+222 -3
View File
@@ -47,6 +47,25 @@
<t-icon name="secured" class="menu-icon" />
<span>{{ $t('settings.apiInfo') }}</span>
</div>
<div
ref="imMenuItemRef"
class="menu-item menu-item--submenu"
:class="{ 'is-open': imSubmenuOpen }"
@mouseenter="showIMSubmenu"
@mouseleave="scheduleHideIMSubmenu"
>
<t-icon name="link" class="menu-icon" />
<span class="menu-item-label">{{ $t('imOverview.menuTitle') }}</span>
<span
v-if="hasActiveIMChannels"
class="live-indicator"
:title="$t('imOverview.liveIndicator')"
aria-hidden="true"
>
<span class="live-indicator-dot"></span>
</span>
<t-icon name="chevron-right" class="menu-chevron" />
</div>
<div class="menu-divider"></div>
<div class="menu-item" @click="handleSettings">
<t-icon name="setting" class="menu-icon" />
@@ -105,6 +124,25 @@
</template>
</div>
</Transition>
<!-- IM submenu is teleported to body because the sidebar (.aside_box) has
overflow:hidden, which would otherwise clip any absolutely-positioned
child that reaches past its bounds. -->
<Teleport to="body">
<div
v-if="imSubmenuOpen"
class="im-submenu-floating"
:style="imSubmenuStyle"
@mouseenter="showIMSubmenu"
@mouseleave="scheduleHideIMSubmenu"
>
<IMChannelsOverviewPanel
:active="imSubmenuOpen"
@close="closeAll"
@channels-changed="onChannelsChanged"
/>
</div>
</Teleport>
</div>
</template>
@@ -116,6 +154,8 @@ import { useAuthStore } from '@/stores/auth'
import { MessagePlugin } from 'tdesign-vue-next'
import { getCurrentUser, logout as logoutApi } from '@/api/auth'
import { useI18n } from 'vue-i18n'
import IMChannelsOverviewPanel from '@/components/IMChannelsOverviewPanel.vue'
import { listAllIMChannels, type IMChannelOverview } from '@/api/agent'
const { t } = useI18n()
@@ -124,7 +164,12 @@ const uiStore = useUIStore()
const authStore = useAuthStore()
const menuRef = ref<HTMLElement>()
const imMenuItemRef = ref<HTMLElement>()
const menuVisible = ref(false)
const imSubmenuOpen = ref(false)
const imSubmenuStyle = ref<Record<string, string>>({})
const hasActiveIMChannels = ref(false)
let imSubmenuHideTimer: ReturnType<typeof setTimeout> | null = null
// 用户信息
const userInfo = ref({
@@ -168,6 +213,81 @@ const handleSettings = () => {
router.push('/platform/settings')
}
// Hover-driven submenu controls. A small hide delay tolerates the pointer
// slipping off briefly onto the gap between menu item and submenu pane.
const showIMSubmenu = () => {
if (imSubmenuHideTimer) {
clearTimeout(imSubmenuHideTimer)
imSubmenuHideTimer = null
}
// Compute panel position based on the menu item's rect — the panel is
// teleported to body so we can't rely on CSS `left: 100%`.
positionIMSubmenu()
imSubmenuOpen.value = true
}
const scheduleHideIMSubmenu = () => {
if (imSubmenuHideTimer) clearTimeout(imSubmenuHideTimer)
imSubmenuHideTimer = setTimeout(() => {
imSubmenuOpen.value = false
imSubmenuHideTimer = null
}, 180)
}
const closeAll = () => {
imSubmenuOpen.value = false
menuVisible.value = false
}
// Silent prefetch so the "live" indicator on the IM menu item reflects reality
// as soon as the user sees the avatar area. Errors are swallowed — the
// indicator just stays off if the request fails, which is the conservative
// default. The panel component emits channels-changed after toggle/refresh so
// we stay in sync without re-polling.
const refreshIMStatus = async () => {
try {
const resp = await listAllIMChannels()
const data: IMChannelOverview[] = resp?.data || []
hasActiveIMChannels.value = data.some((c) => c.enabled)
} catch {
// Intentionally ignored — indicator just stays off.
}
}
const onChannelsChanged = (channels: IMChannelOverview[]) => {
hasActiveIMChannels.value = channels.some((c) => c.enabled)
}
// Anchor the floating submenu just to the right of the hovered menu item,
// clamped to the viewport so it stays visible near the screen edge.
const positionIMSubmenu = () => {
const el = imMenuItemRef.value
if (!el) return
const rect = el.getBoundingClientRect()
const PANEL_WIDTH = 300
const PANEL_MAX_HEIGHT = 520
const GAP = 8
const MARGIN = 8
let left = rect.right + GAP
// If the panel would overflow the right edge, flip to the left side.
if (left + PANEL_WIDTH + MARGIN > window.innerWidth) {
left = Math.max(MARGIN, rect.left - PANEL_WIDTH - GAP)
}
// Align the panel's top with the menu item, then clamp so it doesn't
// spill past the bottom of the viewport.
let top = rect.top - 4
const maxTop = window.innerHeight - Math.min(PANEL_MAX_HEIGHT, window.innerHeight - MARGIN * 2) - MARGIN
if (top > maxTop) top = maxTop
if (top < MARGIN) top = MARGIN
imSubmenuStyle.value = {
left: `${left}px`,
top: `${top}px`,
}
}
const CHROME_EXTENSION_URL =
'https://chromewebstore.google.com/detail/jpemjbopikggjlmikmclgbmkhhopjdgd?utm_source=item-share-cb'
@@ -252,14 +372,20 @@ const loadUserInfo = async () => {
// 点击外部关闭菜单
const handleClickOutside = (e: MouseEvent) => {
if (menuRef.value && !menuRef.value.contains(e.target as Node)) {
menuVisible.value = false
}
const target = e.target as Node
if (menuRef.value && menuRef.value.contains(target)) return
// The submenu is teleported to body, so it's not inside menuRef — check it
// separately to avoid closing the dropdown when the user clicks the submenu.
const floating = document.querySelector('.im-submenu-floating')
if (floating && floating.contains(target)) return
menuVisible.value = false
imSubmenuOpen.value = false
}
onMounted(() => {
document.addEventListener('click', handleClickOutside)
loadUserInfo()
refreshIMStatus()
})
onUnmounted(() => {
@@ -411,6 +537,69 @@ onUnmounted(() => {
}
}
// 包含右弹子菜单的菜单项
&--submenu {
position: relative;
.menu-item-label {
flex: 1;
}
.menu-chevron {
font-size: 14px;
color: var(--td-text-color-placeholder);
flex-shrink: 0;
transition: transform 0.15s;
}
&.is-open {
background: var(--td-bg-color-container-hover);
.menu-chevron {
color: var(--td-text-color-secondary);
}
}
// "Live" indicator — shown when at least one IM channel is enabled.
// A small green dot with a halo that pulses to signal active connections.
.live-indicator {
position: relative;
display: inline-flex;
align-items: center;
justify-content: center;
width: 10px;
height: 10px;
margin-right: 2px;
flex-shrink: 0;
}
.live-indicator-dot {
position: relative;
width: 6px;
height: 6px;
border-radius: 50%;
background: var(--td-success-color, #07c160);
// Pulsing halo around the dot. Prefers-reduced-motion disables it.
&::after {
content: '';
position: absolute;
inset: -3px;
border-radius: 50%;
background: var(--td-success-color, #07c160);
opacity: 0.45;
animation: im-live-pulse 1.6s ease-out infinite;
pointer-events: none;
}
}
@media (prefers-reduced-motion: reduce) {
.live-indicator-dot::after {
animation: none;
}
}
}
.menu-icon {
font-size: 16px;
color: var(--td-text-color-secondary);
@@ -506,5 +695,35 @@ onUnmounted(() => {
opacity: 1;
transform: translateY(0);
}
// Live indicator halo animation — a soft expanding ring to signal that at
// least one IM channel is actively connected.
@keyframes im-live-pulse {
0% {
transform: scale(0.9);
opacity: 0.45;
}
70% {
transform: scale(1.8);
opacity: 0;
}
100% {
transform: scale(1.8);
opacity: 0;
}
}
</style>
<style lang="less">
// Non-scoped: the IM submenu is teleported to <body> so scoped styles
// from this component won't reach it. The panel component's own CSS is
// scoped and self-contained; this rule only positions the wrapper.
.im-submenu-floating {
position: fixed;
z-index: 1100;
// Invisible padding forms a pointer bridge from the menu item to the
// panel so hovering across the gap doesn't fire mouseleave-hide.
padding-left: 2px;
}
</style>