feat 完善注释

src/utils/entryIcon.ts

@@ -1,16 +1,7 @@
 import type { EntryTone, PortalEntryCard, PortalEntryGroup, PortalEntryVo } from '@/types/business/home'
 
-/**
- * 门户入口的视图映射：后端 icon 字段 → 页面可直接渲染的图标 + 底色
- *
- * <p>后端 icon 是「图标名 / url」自由文本，可能为空、可能是图片地址、
- * 也可能是一个标识符（如 folder）。这里按优先级兜底，保证任何取值都能渲染出可视化图标。</p>
- */
-
-/** 图标底色（设计稿为五色循环），按序号轮转分配 */
 const TONE_CYCLE: EntryTone[] = ['purple', 'green', 'blue', 'amber', 'red']
 
-/** 显示名 → emoji 兜底表（后端 icon 为空或非 emoji 时使用） */
 const NAME_ICON_MAP: Record<string, string> = {
   项目中心: '🗂️',
   需求中心: '🧾',
@@ -42,20 +33,16 @@ const NAME_ICON_MAP: Record<string, string> = {
   关于我们: 'ℹ️',
 }
 
-/** 兜底图标 */
 const DEFAULT_ICON = '📦'
 
-/** 是否图片地址 */
 function isImageUrl(value: string): boolean {
   return /^(https?:)?\/\//i.test(value) || value.startsWith('/')
 }
 
-/** 是否可直接当作 emoji / 字符图标使用（非纯字母数字标识符） */
 function isGlyph(value: string): boolean {
   return !/^[a-zA-Z0-9_-]+$/.test(value)
 }
 
-/** 解析单项图标与底色 */
 function resolveIcon(icon: string | null, name: string): { icon: string; isImage: boolean } {
   const raw = (icon ?? '').trim()
   if (raw) {
@@ -65,12 +52,6 @@ function resolveIcon(icon: string | null, name: string): { icon: string; isImage
   return { icon: NAME_ICON_MAP[name] ?? DEFAULT_ICON, isImage: false }
 }
 
-/**
- * 后端入口 → 页面卡片
- *
- * @param vo    后端入口
- * @param index 组内序号（决定底色轮转）
- */
 export function toPortalEntryCard(vo: PortalEntryVo, index: number): PortalEntryCard | null {
   if (vo.id == null) return null
   const label = (vo.name ?? '').trim() || '未命名入口'
@@ -86,7 +67,6 @@ export function toPortalEntryCard(vo: PortalEntryVo, index: number): PortalEntry
   }
 }
 
-/** 后端入口列表 → 页面卡片列表（过滤无效项，保持后端下发顺序） */
 export function toPortalEntryCards(list: PortalEntryVo[]): PortalEntryCard[] {
   return list
     .map((vo, index) => toPortalEntryCard(vo, index))