feat: add federation management features

- Introduced a new Federation Management section in the admin panel with an overview, user management, proxy user management, post synchronization management, and queue management.
- Added functionality to view and manage federated users, including their followers and historical post backfill.
- Implemented post synchronization features, allowing for manual resync and pushing to ActivityPub.
- Created a service layer for federation-related API calls to streamline data fetching and manipulation.
- Enhanced UI components for better user experience in managing federation-related tasks.

Author: Sunwuyuan

.gitignore

@@ -31,4 +31,5 @@ stats.html
 
 scratch-gui
 
-.claude
+.claude
+.env*.local

src/components/posts/PostCard.vue

@@ -127,20 +127,22 @@
                 </template>
                 <v-list-item-title>删除</v-list-item-title>
               </v-list-item>
-              <!-- 手动触发社交同步 -->
-              <v-list-item :disabled="actionLoading" @click="manualSyncPost">
-                <template #prepend>
-                  <v-icon size="18">mdi-share-all-outline</v-icon>
-                </template>
-                <v-list-item-title>同步到社交平台</v-list-item-title>
-              </v-list-item>
               <!-- 复制链接 -->
               <v-list-item @click="copyLink">
                 <template #prepend>
                   <v-icon size="18">mdi-link-variant</v-icon>
                 </template>
                 <v-list-item-title>复制链接</v-list-item-title>
               </v-list-item>
+              <!-- 联邦社交数据 -->
+              <v-list-item
+                @click="federationDialog = true"
+              >
+                <template #prepend>
+                  <v-icon size="18">mdi-access-point-network</v-icon>
+                </template>
+                <v-list-item-title>联邦社交数据</v-list-item-title>
+              </v-list-item>
             </v-list>
           </v-menu>
         </div>
@@ -435,14 +437,91 @@
       </v-carousel>
     </div>
   </v-dialog>
+
+  <!-- Federation Data Dialog -->
+  <v-dialog v-model="federationDialog" max-width="500px">
+    <v-card class="post-dialog-card">
+        <div class="post-dialog-header">
+            <span class="text-h6">联邦社交数据</span>
+            <v-spacer></v-spacer>
+            <v-btn icon="mdi-close" variant="text" size="small" @click="federationDialog = false"></v-btn>
+        </div>
+        <v-card-text class="pa-4">
+            <v-list density="compact" v-if="post.platform_refs">
+                <v-list-item v-if="post.platform_refs.twitter">
+                    <template v-slot:prepend><v-icon color="blue">mdi-twitter</v-icon></template>
+                    <v-list-item-title>Twitter</v-list-item-title>
+                    <v-list-item-subtitle>
+                        <a v-if="post.platform_refs.twitter.url" :href="post.platform_refs.twitter.url" target="_blank">
+                            {{ post.platform_refs.twitter.id || 'Link' }}
+                        </a>
+                        <span v-else>{{ post.platform_refs.twitter.id }}</span>
+                        <span v-if="post.platform_refs.twitter.kind" class="ml-2 text-caption">({{ post.platform_refs.twitter.kind }})</span>
+                    </v-list-item-subtitle>
+                </v-list-item>
+
+                <v-list-item v-if="post.platform_refs.bluesky">
+                    <template v-slot:prepend><v-icon color="light-blue">mdi-weather-cloudy</v-icon></template>
+                    <v-list-item-title>Bluesky</v-list-item-title>
+                    <v-list-item-subtitle>
+                        <a v-if="getBskyUrl(post.platform_refs.bluesky)" :href="getBskyUrl(post.platform_refs.bluesky)" target="_blank" rel="noopener">
+                            在 Bluesky 上查看
+                        </a>
+                        <div v-if="post.platform_refs.bluesky.uri" class="text-caption text-truncate" style="max-width: 300px;">URI: {{ post.platform_refs.bluesky.uri }}</div>
+                        <div v-if="post.platform_refs.bluesky.cid" class="text-caption text-truncate" style="max-width: 300px;">CID: {{ post.platform_refs.bluesky.cid }}</div>
+                    </v-list-item-subtitle>
+                </v-list-item>
+
+                <v-list-item v-if="post.platform_refs.activitypub">
+                    <template v-slot:prepend><v-icon color="purple">mdi-earth</v-icon></template>
+                    <v-list-item-title>ActivityPub</v-list-item-title>
+                    <v-list-item-subtitle>
+                        <a v-if="post.platform_refs.activitypub.url" :href="post.platform_refs.activitypub.url" target="_blank">
+                            {{ post.platform_refs.activitypub.id || 'View Note' }}
+                        </a>
+                        <span v-else>{{ post.platform_refs.activitypub.id }}</span>
+                    </v-list-item-subtitle>
+                </v-list-item>
+            </v-list>
+            <div v-else class="text-center pa-4 text-medium-emphasis">
+                无同步数据
+            </div>
+        </v-card-text>
+
+        <v-divider></v-divider>
+
+        <v-card-actions v-if="canDelete">
+            <v-btn
+                variant="text"
+                color="primary"
+                :loading="actionLoading"
+                prepend-icon="mdi-share-all-outline"
+                @click="manualSyncPost"
+            >
+                全平台同步
+            </v-btn>
+            <v-spacer></v-spacer>
+            <v-btn
+                variant="text"
+                color="secondary"
+                :loading="actionLoading"
+                prepend-icon="mdi-earth"
+                @click="pushToFederation"
+            >
+                推送到联邦
+            </v-btn>
+        </v-card-actions>
+    </v-card>
+  </v-dialog>
 </template>
 
 <script setup>
 import { computed, ref, watch, nextTick } from "vue";
-import { useRouter } from "vue-router";
+import { useRouter, useRoute } from "vue-router";
 import { localuser } from "@/services/localAccount";
 import { getS3staticurl } from "@/services/projectService";
 import PostsService from "@/services/postsService";
+import federationService from "@/services/federationService";
 import { showSnackbar } from "@/composables/useNotifications";
 import { useDeleteConfirm } from "@/composables/useDeleteConfirm";
 import axios from "@/axios/axios";
@@ -471,10 +550,12 @@ const props = defineProps({
 const emit = defineEmits(["deleted", "created", "updated"]);
 
 const router = useRouter();
+const route = useRoute();
 
 // Dialog states
 const replyDialog = ref(false);
 const quoteDialog = ref(false);
+const federationDialog = ref(false);
 const actionLoading = ref(false);
 
 const mediaViewerOpen = ref(false);
@@ -519,6 +600,11 @@ const authorAvatar = computed(() => {
   return localuser.getUserAvatar(avatar);
 });
 
+// Check if current view is detail view for this post
+const isDetailView = computed(() => {
+  return String(route.params.id) === String(postId.value);
+});
+
 // Time
 const createdAt = computed(
   () =>
@@ -1112,6 +1198,7 @@ const copyLink = async () => {
 };
 
 const handleDeleteClick = () => {
+  // Trigger rebuild
   showDeleteConfirm(
     async () => {
       await PostsService.remove(postId.value);
@@ -1128,18 +1215,52 @@ const handleDeleteClick = () => {
   );
 };
 
+const getBskyUrl = (bluesky) => {
+  if (!bluesky) return null;
+  if (bluesky.url) return bluesky.url;
+  // Parse AT URI: at://did:plc:xxx/app.bsky.feed.post/rkey
+  const uri = bluesky.uri;
+  if (!uri) return null;
+  const match = uri.match(/^at:\/\/([^/]+)\/[^/]+\/([^/]+)$/);
+  if (match) {
+    return `https://bsky.app/profile/${match[1]}/post/${match[2]}`;
+  }
+  return null;
+};
+
 const manualSyncPost = async () => {
-  if (!requireLogin("手动同步")) return;
+  if (!canDelete.value) return;
+  if (!confirm("确定要重新同步此帖子到所有关联的社交平台吗？")) return;
+
+  actionLoading.value = true;
+  try {
+    const res = await federationService.userResyncPost(postId.value);
+    if (res.data?.status === "success" || res.data?.status === "ok") {
+      showSnackbar("同步任务已提交", "success");
+    } else {
+      showSnackbar(res.data?.message || "同步失败", "error");
+    }
+  } catch (e) {
+    showSnackbar(e?.message || "同步失败", "error");
+  } finally {
+    actionLoading.value = false;
+  }
+};
+
+const pushToFederation = async () => {
+  if (!canDelete.value) return;
+  if (!confirm("确定要推送到 ActivityPub 联邦网络吗？")) return;
+
   actionLoading.value = true;
   try {
-    const result = await PostsService.syncToSocial(postId.value);
-    if (result?.status === "success") {
-      showSnackbar("已提交同步任务", "success");
+    const res = await federationService.userPushPostToFederation(postId.value);
+    if (res.data?.status === "success" || res.data?.status === "ok") {
+        showSnackbar("推送任务已提交", "success");
     } else {
-      showSnackbar(result?.message || "提交同步任务失败", "error");
+        showSnackbar(res.data?.message || "推送失败", "error");
     }
   } catch (e) {
-    showSnackbar(e?.message || "提交同步任务失败", "error");
+    showSnackbar(e?.message || "推送失败", "error");
   } finally {
     actionLoading.value = false;
   }

src/pages/app/admin/federation/index.vue

@@ -0,0 +1,129 @@
+<template>
+  <v-container>
+    <v-card class="mb-6">
+      <v-card-title>联邦系统概览</v-card-title>
+      <v-card-text>
+        <v-row>
+          <v-col cols="12" md="6">
+            <v-alert
+              v-if="stats.federation"
+              :type="stats.federation.enabled ? 'success' : 'warning'"
+              variant="tonal"
+              border="start"
+            >
+              <div class="text-h6">ActivityPub 状态</div>
+              <div>域名: {{ stats.federation.domain }}</div>
+              <div>状态: {{ stats.federation.enabled ? '已启用' : '未启用' }}</div>
+            </v-alert>
+          </v-col>
+          <v-col cols="12" md="6" v-if="stats.queue">
+             <v-card variant="outlined">
+                <v-card-title>队列状态</v-card-title>
+                <v-card-text>
+                    <div class="d-flex justify-space-between">
+                         <span>等待中: {{ stats.queue.waiting }}</span>
+                         <span>进行中: {{ stats.queue.active }}</span>
+                         <span>已完成: {{ stats.queue.completed }}</span>
+                         <span>失败: {{ stats.queue.failed }}</span>
+                    </div>
+                </v-card-text>
+                <v-card-actions>
+                    <v-btn color="primary" to="/app/admin/federation/queue">管理队列</v-btn>
+                </v-card-actions>
+             </v-card>
+          </v-col>
+        </v-row>
+      </v-card-text>
+    </v-card>
+
+    <v-row>
+        <v-col cols="12" sm="6" md="3" v-for="(count, key) in displayCounts" :key="key">
+            <v-card>
+                <v-card-text class="d-flex flex-column align-center">
+                    <div class="text-h4 mb-2">{{ count.value }}</div>
+                    <div class="text-subtitle-1">{{ count.label }}</div>
+                </v-card-text>
+            </v-card>
+        </v-col>
+    </v-row>
+
+    <v-row class="mt-4" v-if="stats.platformSync">
+        <v-col cols="12">
+            <v-card>
+                <v-card-title>平台同步统计</v-card-title>
+                <v-card-text>
+                     <v-row>
+                        <v-col cols="12" md="4" v-for="(count, platform) in stats.platformSync" :key="platform">
+                             <v-list-item>
+                                <template v-slot:prepend>
+                                    <v-icon :icon="getPlatformIcon(platform)"></v-icon>
+                                </template>
+                                <v-list-item-title class="text-capitalize">{{ platform }}</v-list-item-title>
+                                <template v-slot:append>
+                                    <v-chip>{{ count }}</v-chip>
+                                </template>
+                             </v-list-item>
+                        </v-col>
+                     </v-row>
+                </v-card-text>
+            </v-card>
+        </v-col>
+    </v-row>
+
+    <v-row class="mt-4">
+        <v-col cols="12">
+            <div class="d-flex gap-2 flex-wrap">
+                <v-btn prepend-icon="mdi-account-group" to="/app/admin/federation/users" color="primary" variant="tonal">本地联邦用户</v-btn>
+                <v-btn prepend-icon="mdi-account-network" to="/app/admin/federation/proxy-users" color="secondary" variant="tonal">远程代理用户</v-btn>
+                <v-btn prepend-icon="mdi-sync" to="/app/admin/federation/posts" color="info" variant="tonal">帖子同步管理</v-btn>
+            </div>
+        </v-col>
+    </v-row>
+  </v-container>
+</template>
+
+<script setup>
+import { ref, onMounted, computed } from 'vue';
+import federationService from '@/services/federationService';
+
+const stats = ref({
+    federation: null,
+    counts: {},
+    platformSync: null,
+    queue: null
+});
+
+const displayCounts = computed(() => {
+    const c = stats.value.counts || {};
+    return [
+        { key: 'remoteFollowers', label: '远程关注者', value: c.remoteFollowers || 0 },
+        { key: 'proxyUsers', label: '远程代理用户', value: c.proxyUsers || 0 },
+        { key: 'federatedPosts', label: '联邦帖子', value: c.federatedPosts || 0 },
+        { key: 'localPosts', label: '本地帖子', value: c.localPosts || 0 },
+    ];
+});
+
+const getPlatformIcon = (platform) => {
+    switch(platform) {
+        case 'twitter': return 'mdi-twitter';
+        case 'bluesky': return 'mdi-butterfly'; // Assuming mdi-butterfly or similar, or just cloud
+        case 'activitypub': return 'mdi-earth';
+        default: return 'mdi-share-variant';
+    }
+};
+
+const loadStats = async () => {
+    try {
+        const res = await federationService.getStats();
+        if (res.status === 200 && res.data.status === 'ok') {
+            stats.value = res.data.data;
+        }
+    } catch (e) {
+        console.error('Failed to load federation stats', e);
+    }
+};
+
+onMounted(() => {
+    loadStats();
+});
+</script>