fix(filelib): 授权表与侧栏展示 displayName 而非裸 userId

GrantDto 加 principalName:USER → User.displayName,GROUP → MemberGroup.name,
取不到行(用户/组已删)时回落为 principalId,与 /database/api/me 同一回落语义。
解析走批量 helper(两条 IN 查询,非 N+1),listGrants/putGrants/forceAdjustGrants
三个出口共用,保证 GET 与 PUT 响应同形状。组不按 archivedAt 过滤 —— 已归档组的
历史授权仍需显示名字,否则管理员无法辨认后收回。

principalName 是纯展示字段;写路径仍只认 principalId,不得据此做授权判断。

前端:
- GrantsPanel 主体列由裸 id 改为展示名,id 移入 title 供排查;收回确认框同步。
- LibraryView 侧栏身份区改用 $me.displayName(/me 早已返回,此前未消费)。
- types.ts 去掉重复声明的 Grant 与无引用的 GroupSearchResult。

集成测试断言三种情形(displayName / 组名 / 已删主体回落)。

hub/filelib-web/src/lib/GrantsPanel.svelte

@@ -84,7 +84,7 @@
   }
 
   async function revoke(g: Grant): Promise<void> {
-    if (!confirm(`收回「${g.principalId}」的 ${g.role} 授权?`)) return;
+    if (!confirm(`收回「${g.principalName}」的 ${g.role} 授权?`)) return;
     try {
       await api(`/database/api/nodes/${node.id}/grants/${encodeURIComponent(g.id)}`, {
         method: "DELETE",
@@ -133,7 +133,8 @@
               <td>
                 <span class="inline-flex items-center gap-2">
                   <span class="flex text-ink-3"><Icon name={g.principalType === "USER" ? "user" : "group"} size={14} /></span>
-                  <span class="font-mono text-[12px]">{g.principalId}</span>
+                  <!-- 展示名优先(后端已解析);id 作为 title 供排查。 -->
+                  <span class="font-medium" title={g.principalId}>{g.principalName}</span>
                   {#if g.isCreatorGrant}<span class="quiet">(创建者)</span>{/if}
                 </span>
               </td>

hub/filelib-web/src/lib/LibraryView.svelte

@@ -63,7 +63,7 @@
     }
   }
 
-  const initial = $derived(($me?.userId ?? "U").slice(0, 1).toUpperCase());
+  const initial = $derived((($me?.displayName ?? $me?.userId) ?? "U").slice(0, 1).toUpperCase());
 </script>
 
 <div class="flex min-h-0 flex-1">
@@ -97,7 +97,8 @@
     {#if showUserFooter}
       <div class="flex items-center gap-2 border-t border-line-soft px-4 py-3 text-[12.5px]">
         <div class="flex h-6 w-6 shrink-0 items-center justify-center rounded-full bg-accent text-[11px] font-semibold text-white">{initial}</div>
-        <span class="flex-1 truncate text-ink">{$me?.userId ?? ""}</span>
+        <!-- 展示名优先;/me 取不到 User 行时后端已回落为 userId。 -->
+        <span class="flex-1 truncate text-ink" title={$me?.userId ?? ""}>{$me?.displayName ?? ""}</span>
         <button class="rounded-lg border border-line-soft px-2.5 py-1 text-[11.5px] text-ink-3 transition hover:bg-hover hover:text-ink" onclick={logout} title="退出登录">退出</button>
       </div>
     {/if}

hub/filelib-web/src/lib/types.ts

@@ -72,21 +72,6 @@ export interface ExportJob {
   readonly createdAt: string;
 }
 
-export interface Grant {
-  readonly id: string;
-  readonly principalType: "USER" | "GROUP";
-  readonly principalId: string;
-  readonly role: Role;
-  readonly isCreatorGrant: boolean;
-  readonly createdAt: string;
-}
-
-export interface GroupSearchResult {
-  readonly id: string;
-  readonly name: string;
-  readonly breadcrumb: string;
-}
-
 /** 成员组(ADR-0028);后端返回扁平列表,前端按 parentId/depth 拼树。 */
 export interface MemberGroupNode {
   readonly id: string;
@@ -114,6 +99,8 @@ export interface Grant {
   readonly id: string;
   readonly principalType: "USER" | "GROUP";
   readonly principalId: string;
+  /** 后端解析好的展示名(USER→displayName / GROUP→组名);取不到行时回落为 principalId。 */
+  readonly principalName: string;
   readonly role: Role;
   /** 创建者授权不可收回、不可改(契约 8.1)。 */
   readonly isCreatorGrant: boolean;