@allbluecn/web-app 0.3.0

package/src/server/serverFns/knowledge-index.ts

@@ -0,0 +1,147 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import { createServerFn } from "@tanstack/react-start"
+import { getRequest } from "@tanstack/react-start/server"
+import { z } from "zod"
+import { prisma } from "@allbluecn/database"
+import { requireAuth } from "@/server/auth-helpers"
+import { generateEmbedding, chunkText } from "@allbluecn/ai-gateway"
+import { insertEmbedding, deleteEmbeddings } from "@/lib/pgvector"
+
+const KB_EMBEDDINGS_TABLE = "knowledge_embeddings"
+const OPENROUTER_BASE_URL = "https://openrouter.ai/api/v1"
+const PLACEHOLDER_KEYS = new Set(["sk-your-api-key-here", "", "sk-or-your-api-key-here"])
+
+export function extractText(content: unknown): string {
+  if (!content || typeof content !== "object") return ""
+  const obj = content as Record<string, unknown>
+  if (typeof obj.markdown === "string" && obj.markdown) return obj.markdown
+  if (typeof obj.html === "string" && obj.html) return obj.html.replace(/<[^>]*>/g, "")
+  return ""
+}
+
+export async function resolveAiConfig(kbId: string): Promise<{ apiKey?: string; baseUrl?: string }> {
+  const kb = await prisma.knowledgeBase.findUnique({
+    where: { id: kbId },
+    select: { userId: true },
+  })
+  if (!kb) return {}
+
+  const user = await prisma.user.findUnique({
+    where: { id: kb.userId },
+    select: { aiApiKey: true, aiProvider: true },
+  })
+  if (!user || !user.aiApiKey || PLACEHOLDER_KEYS.has(user.aiApiKey)) return {}
+
+  const result: { apiKey: string; baseUrl?: string } = { apiKey: user.aiApiKey }
+  if (user.aiProvider === "openrouter") {
+    result.baseUrl = OPENROUTER_BASE_URL
+  }
+  return result
+}
+
+export async function indexDocumentEmbeddings(
+  doc: { id: string; kbId: string; title: string; content: unknown },
+  aiOpts?: { apiKey?: string; baseUrl?: string }
+): Promise<number> {
+  const text = extractText(doc.content) || doc.title
+  if (!text) return 0
+
+  const chunks = chunkText(text)
+  await deleteEmbeddings(KB_EMBEDDINGS_TABLE, "documentId", doc.id)
+
+  for (let i = 0; i < chunks.length; i++) {
+    const embedding = await generateEmbedding(chunks[i], aiOpts)
+    await insertEmbedding(KB_EMBEDDINGS_TABLE, `${doc.id}-${i}`, chunks[i], embedding, {
+      kbId: doc.kbId,
+      documentId: doc.id,
+      chunkIndex: i,
+    })
+  }
+
+  return chunks.length
+}
+
+export async function indexDocumentById(documentId: string): Promise<number> {
+  const doc = await prisma.knowledgeDocument.findUnique({
+    where: { id: documentId },
+    select: { id: true, kbId: true, title: true, content: true },
+  })
+  if (!doc) return 0
+
+  const aiConfig = await resolveAiConfig(doc.kbId)
+  return indexDocumentEmbeddings(doc, aiConfig)
+}
+
+export const indexKnowledgeDocumentFn = createServerFn({ method: "POST" })
+  .validator(z.object({ documentId: z.string() }))
+  .handler(async ({ data }) => {
+    const request = getRequest()
+    const session = await requireAuth(request)
+    const doc = await prisma.knowledgeDocument.findFirst({
+      where: {
+        id: data.documentId,
+        isDeleted: false,
+        kb: { userId: session.user!.id!, isDeleted: false },
+      },
+      select: { id: true, kbId: true, title: true, content: true },
+    })
+    if (!doc) throw new Error("未找到或无权限")
+
+    const aiConfig = await resolveAiConfig(doc.kbId)
+    const indexed = await indexDocumentEmbeddings(doc, aiConfig)
+    return { indexed }
+  })
+
+export const deleteKnowledgeEmbeddingsFn = createServerFn({ method: "POST" })
+  .validator(z.object({ documentId: z.string() }))
+  .handler(async ({ data }) => {
+    const request = getRequest()
+    await requireAuth(request)
+    await deleteEmbeddings(KB_EMBEDDINGS_TABLE, "documentId", data.documentId)
+    return { deleted: true }
+  })
+
+export const reindexKnowledgeBaseFn = createServerFn({ method: "POST" })
+  .validator(z.object({ kbId: z.string() }))
+  .handler(async ({ data }) => {
+    const request = getRequest()
+    const session = await requireAuth(request)
+    const kb = await prisma.knowledgeBase.findFirst({
+      where: { id: data.kbId, userId: session.user!.id!, isDeleted: false },
+      select: { id: true },
+    })
+    if (!kb) throw new Error("未找到或无权限")
+
+    const docs = await prisma.knowledgeDocument.findMany({
+      where: { kbId: data.kbId, isDeleted: false },
+      select: { id: true, title: true, content: true, kbId: true },
+    })
+
+    const aiConfig = await resolveAiConfig(data.kbId)
+
+    await deleteEmbeddings(KB_EMBEDDINGS_TABLE, "kbId", data.kbId)
+
+    let total = 0
+    for (const doc of docs) {
+      const indexed = await indexDocumentEmbeddings(doc, aiConfig)
+      total += indexed
+    }
+
+    return { indexed: total, documentCount: docs.length }
+  })

package/src/server/serverFns/knowledge-public/bookmarks/categories.ts

@@ -0,0 +1,67 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import { createServerFn } from '@tanstack/react-start'
+import { getRequest } from '@tanstack/react-start/server'
+import { z } from 'zod'
+import { prisma } from '@allbluecn/database'
+import { requireAuth } from '@/server/auth-helpers'
+
+export const listBookmarkCategoriesFn = createServerFn({ method: 'GET' })
+  .validator(z.object({}).optional())
+  .handler(async () => {
+    const request = getRequest()
+    const session = await requireAuth(request)
+    return prisma.bookmarkCategory.findMany({
+      where: { OR: [{ userId: null }, { userId: session.user!.id! }] },
+      orderBy: [{ sortOrder: 'asc' }, { name: 'asc' }],
+      select: { id: true, name: true, icon: true, sortOrder: true, isDefault: true, userId: true },
+    })
+  })
+
+export const createBookmarkCategoryFn = createServerFn({ method: 'POST' })
+  .validator(z.object({ name: z.string().min(1).max(20), icon: z.string().default('Folder') }))
+  .handler(async ({ data }) => {
+    const request = getRequest()
+    const session = await requireAuth(request)
+    const last = await prisma.bookmarkCategory.findFirst({
+      where: { userId: session.user!.id! },
+      orderBy: { sortOrder: 'desc' },
+    })
+    return prisma.bookmarkCategory.create({
+      data: {
+        name: data.name,
+        icon: data.icon,
+        userId: session.user!.id!,
+        sortOrder: (last?.sortOrder ?? 0) + 1,
+      },
+      select: { id: true, name: true, icon: true, sortOrder: true },
+    })
+  })
+
+export const deleteBookmarkCategoryFn = createServerFn({ method: 'POST' })
+  .validator(z.object({ id: z.string() }))
+  .handler(async ({ data }) => {
+    const request = getRequest()
+    const session = await requireAuth(request)
+    const cat = await prisma.bookmarkCategory.findUnique({ where: { id: data.id } })
+    if (!cat) throw new Error('未找到')
+    if (cat.isDefault) throw new Error('预置分类不可删除')
+    if (cat.userId !== session.user!.id!) throw new Error('无权限')
+    await prisma.bookmarkCategory.delete({ where: { id: data.id } })
+    return { success: true }
+  })

package/src/server/serverFns/knowledge-public/bookmarks/create.ts

@@ -0,0 +1,86 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import { createServerFn } from '@tanstack/react-start'
+import { getRequest } from '@tanstack/react-start/server'
+import { z } from 'zod'
+import { prisma } from '@allbluecn/database'
+import { requireAuth } from '@/server/auth-helpers'
+import { bookmarkCanonicalId, parseGithubUrl } from '@/server/knowledge-public/canonical-id'
+import { fetchGithubData } from '@/server/knowledge-public/github-sync'
+import { resolveFavicon } from '@/server/knowledge-public/favicon'
+
+const createSchema = z.object({
+  title: z.string().min(1).max(200),
+  url: z.string().url(),
+  categoryId: z.string().optional(),
+  summary: z.string().max(1000).optional(),
+  tags: z.array(z.string()).default([]),
+})
+
+export const createBookmarkFn = createServerFn({ method: 'POST' })
+  .validator(createSchema)
+  .handler(async ({ data }) => {
+    const request = getRequest()
+    const session = await requireAuth(request)
+    const gh = parseGithubUrl(data.url)
+    let faviconUrl: string | null = null
+    try {
+      faviconUrl = await resolveFavicon(data.url)
+    } catch {}
+
+    const bookmark = await prisma.websiteBookmark.create({
+      data: {
+        canonicalId: bookmarkCanonicalId(data.url),
+        title: data.title,
+        url: data.url,
+        categoryId: data.categoryId || null,
+        summary: data.summary || null,
+        tags: data.tags,
+        visibility: 'private',
+        userId: session.user!.id!,
+        isGithub: !!gh,
+        githubOwner: gh?.owner ?? null,
+        githubRepo: gh?.repo ?? null,
+        faviconUrl,
+        faviconSyncedAt: faviconUrl ? new Date() : null,
+      },
+      select: { id: true },
+    })
+
+    if (gh) {
+      (async () => {
+        try {
+          const gd = await fetchGithubData(gh.owner, gh.repo)
+          if (gd) {
+            await prisma.websiteBookmark.update({
+              where: { id: bookmark.id },
+              data: {
+                githubStars: gd.stars,
+                githubRepoUpdatedAt: gd.repoUpdatedAt,
+                githubLatestVersion: gd.latestVersion,
+                githubVersionDate: gd.versionDate,
+                githubSyncedAt: new Date(),
+              },
+            })
+          }
+        } catch {}
+      })().catch(() => {})
+    }
+
+    return bookmark
+  })

package/src/server/serverFns/knowledge-public/bookmarks/delete.ts

@@ -0,0 +1,36 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import { createServerFn } from '@tanstack/react-start'
+import { getRequest } from '@tanstack/react-start/server'
+import { z } from 'zod'
+import { prisma } from '@allbluecn/database'
+import { requireAuth } from '@/server/auth-helpers'
+
+export const deleteBookmarkFn = createServerFn({ method: 'POST' })
+  .validator(z.object({ id: z.string() }))
+  .handler(async ({ data }) => {
+    const request = getRequest()
+    const session = await requireAuth(request)
+    const existing = await prisma.websiteBookmark.findUnique({ where: { id: data.id } })
+    if (!existing) throw new Error('未找到')
+    const isOwner = existing.userId === session.user!.id!
+    const isAdmin = session.user!.role === 'ADMIN' || session.user!.role === 'SUPER_ADMIN'
+    if (!isOwner && !isAdmin) throw new Error('无权限')
+    await prisma.websiteBookmark.update({ where: { id: data.id }, data: { isDeleted: true } })
+    return { success: true }
+  })

package/src/server/serverFns/knowledge-public/bookmarks/detail.ts

@@ -0,0 +1,63 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import { createServerFn } from '@tanstack/react-start'
+import { getRequest } from '@tanstack/react-start/server'
+import { z } from 'zod'
+import { prisma } from '@allbluecn/database'
+import { requireAuth } from '@/server/auth-helpers'
+import { aggregateSharers } from '@/server/knowledge-public/share-merge'
+
+export const getBookmarkDetailFn = createServerFn({ method: 'GET' })
+  .validator(z.object({ id: z.string() }))
+  .handler(async ({ data }) => {
+    const request = getRequest()
+    const session = await requireAuth(request)
+    const userId = session.user!.id!
+    const item = await prisma.websiteBookmark.findFirst({
+      where: { id: data.id, isDeleted: false },
+      include: { category: { select: { icon: true } } },
+    })
+    if (!item) throw new Error('未找到')
+    if (item.visibility === 'private' && item.userId !== userId) {
+      throw new Error('无权限')
+    }
+    let sharers: any[] = []
+    if (item.visibility === 'public') {
+      const map = await aggregateSharers('bookmark', [item.canonicalId])
+      sharers = map.get(item.canonicalId) ?? []
+      if (sharers.length === 0) {
+        const owner = await prisma.user.findUnique({
+          where: { id: item.userId },
+          select: { id: true, username: true, avatarConfig: true, bgShape: true, bgColor: true },
+        })
+        if (owner) sharers = [owner]
+      }
+    }
+    const fav = await prisma.articleFavorite.findFirst({
+      where: { entityType: 'bookmark', entityId: item.canonicalId, userId },
+      select: { id: true },
+    })
+    const { category: _c, ...rest } = item
+    return {
+      ...rest,
+      categoryIcon: _c?.icon ?? 'Folder',
+      isOwner: item.userId === userId,
+      isFavorited: !!fav,
+      sharers,
+    }
+  })

package/src/server/serverFns/knowledge-public/bookmarks/favorite.ts

@@ -0,0 +1,38 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import { createServerFn } from '@tanstack/react-start'
+import { getRequest } from '@tanstack/react-start/server'
+import { z } from 'zod'
+import { prisma } from '@allbluecn/database'
+import { requireAuth } from '@/server/auth-helpers'
+
+export const toggleFavoriteBookmarkFn = createServerFn({ method: 'POST' })
+  .validator(z.object({ canonicalId: z.string() }))
+  .handler(async ({ data }) => {
+    const request = getRequest()
+    const session = await requireAuth(request)
+    const userId = session.user!.id!
+    const where = { entityType: 'bookmark', entityId: data.canonicalId, userId }
+    const existing = await prisma.articleFavorite.findFirst({ where, select: { id: true } })
+    if (existing) {
+      await prisma.articleFavorite.delete({ where: { id: existing.id } })
+      return { favorited: false }
+    }
+    await prisma.articleFavorite.create({ data: { entityType: 'bookmark', entityId: data.canonicalId, userId } })
+    return { favorited: true }
+  })

package/src/server/serverFns/knowledge-public/bookmarks/list.ts

@@ -0,0 +1,128 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import { createServerFn } from '@tanstack/react-start'
+import { getRequest } from '@tanstack/react-start/server'
+import { z } from 'zod'
+import { prisma } from '@allbluecn/database'
+import { requireAuth } from '@/server/auth-helpers'
+import { aggregateSharers } from '@/server/knowledge-public/share-merge'
+
+const listSchema = z.object({
+  scope: z.enum(['all', 'private', 'share', 'favorite']).default('all'),
+  search: z.string().optional(),
+  categoryId: z.string().optional(),
+  isGithub: z.boolean().optional(),
+  page: z.number().int().min(1).default(1),
+  pageSize: z.number().int().min(1).max(60).default(24),
+})
+
+export const listBookmarksFn = createServerFn({ method: 'GET' })
+  .validator(listSchema)
+  .handler(async ({ data }) => {
+    const request = getRequest()
+    const session = await requireAuth(request)
+    const userId = session.user!.id!
+    const where: any = { isDeleted: false }
+    if (data.scope === 'private') {
+      where.userId = userId
+      where.visibility = 'private'
+    } else if (data.scope === 'share') {
+      where.visibility = 'public'
+      const otherShared = await prisma.knowledgeShareRecord.findMany({
+        where: { entityType: 'bookmark', userId: { not: userId } },
+        select: { canonicalId: true },
+        distinct: ['canonicalId'],
+      })
+      const otherSharedIds = Array.from(new Set(otherShared.map((r) => r.canonicalId)))
+      where.AND = [
+        { OR: [{ userId: { not: userId } }, { canonicalId: { in: otherSharedIds } }] },
+      ]
+    } else if (data.scope === 'favorite') {
+      where.visibility = 'public'
+    } else {
+      where.AND = [{ OR: [{ userId, visibility: 'private' }, { visibility: 'public' }] }]
+    }
+    if (data.scope === 'favorite') {
+      const favs = await prisma.articleFavorite.findMany({
+        where: { entityType: 'bookmark', userId },
+        select: { entityId: true },
+      })
+      const ids = favs.map((f) => f.entityId)
+      where.canonicalId = { in: ids.length ? ids : ['__none__'] }
+    }
+    if (data.search) {
+      where.OR = [
+        { title: { contains: data.search, mode: 'insensitive' } },
+        { summary: { contains: data.search, mode: 'insensitive' } },
+        { url: { contains: data.search, mode: 'insensitive' } },
+        { tags: { array_contains: data.search } },
+      ]
+    }
+    if (data.categoryId) where.categoryId = data.categoryId
+    if (data.isGithub !== undefined) where.isGithub = data.isGithub
+
+    const [items, total] = await Promise.all([
+      prisma.websiteBookmark.findMany({
+        where,
+        select: {
+          id: true, canonicalId: true, title: true, url: true, categoryId: true,
+          summary: true, faviconUrl: true, isGithub: true, githubStars: true,
+          githubLatestVersion: true, githubVersionDate: true, githubRepoUpdatedAt: true,
+          githubSyncedAt: true, tags: true, visibility: true, userId: true, createdAt: true,
+          user: { select: { id: true, username: true, avatarConfig: true, bgShape: true, bgColor: true } },
+          category: { select: { icon: true } },
+        },
+        orderBy: { createdAt: 'desc' },
+        skip: (data.page - 1) * data.pageSize,
+        take: data.pageSize,
+      }),
+      prisma.websiteBookmark.count({ where }),
+    ])
+
+    const canonicalIds = items.map((i) => i.canonicalId)
+    const [favs, sharersMap] = await Promise.all([
+      canonicalIds.length
+        ? prisma.articleFavorite.findMany({
+            where: { entityType: 'bookmark', userId, entityId: { in: canonicalIds } },
+            select: { entityId: true },
+          })
+        : Promise.resolve([]),
+      data.scope !== 'private'
+        ? aggregateSharers('bookmark', canonicalIds)
+        : Promise.resolve(new Map()),
+    ])
+    const favoritedSet = new Set(favs.map((f) => f.entityId))
+
+    return {
+      items: items.map((i) => {
+        let sharers = sharersMap.get(i.canonicalId) ?? []
+        if (i.visibility === 'public' && sharers.length === 0 && i.user) {
+          sharers = [i.user]
+        }
+        const { user: _u, category: _c, ...rest } = i
+        return {
+          ...rest,
+          categoryIcon: _c?.icon ?? 'Folder',
+          isOwner: i.userId === userId,
+          isFavorited: favoritedSet.has(i.canonicalId),
+          sharers,
+        }
+      }),
+      total, page: data.page, pageSize: data.pageSize,
+    }
+  })

package/src/server/serverFns/knowledge-public/bookmarks/refresh-favicon.ts

@@ -0,0 +1,31 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import { createServerFn } from '@tanstack/react-start'
+import { getRequest } from '@tanstack/react-start/server'
+import { z } from 'zod'
+import { requireAuth } from '@/server/auth-helpers'
+import { syncBookmarkFavicon } from '@/server/knowledge-public/favicon'
+
+export const refreshFaviconFn = createServerFn({ method: 'POST' })
+  .validator(z.object({ id: z.string() }))
+  .handler(async ({ data }) => {
+    const request = getRequest()
+    await requireAuth(request)
+    const url = await syncBookmarkFavicon(data.id)
+    return { success: !!url, faviconUrl: url }
+  })

package/src/server/serverFns/knowledge-public/bookmarks/share.ts

@@ -0,0 +1,74 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import { createServerFn } from '@tanstack/react-start'
+import { getRequest } from '@tanstack/react-start/server'
+import { z } from 'zod'
+import { prisma } from '@allbluecn/database'
+import { requireAuth } from '@/server/auth-helpers'
+import { shareToPublic } from '@/server/knowledge-public/share-merge'
+
+export const shareBookmarkFn = createServerFn({ method: 'POST' })
+  .validator(z.object({ id: z.string() }))
+  .handler(async ({ data }) => {
+    const request = getRequest()
+    const session = await requireAuth(request)
+    const userId = session.user!.id!
+    const source = await prisma.websiteBookmark.findFirst({
+      where: { id: data.id, userId, isDeleted: false },
+    })
+    if (!source) throw new Error('未找到或无权限')
+
+    let cloneCategoryId = source.categoryId
+    if (source.categoryId) {
+      const cat = await prisma.bookmarkCategory.findUnique({ where: { id: source.categoryId } })
+      if (!cat?.isDefault) cloneCategoryId = null
+    }
+
+    const result = await shareToPublic({
+      model: 'websiteBookmark',
+      entityType: 'bookmark',
+      sourceId: source.id,
+      userId,
+      cloneData: {
+        canonicalId: source.canonicalId,
+        title: source.title,
+        url: source.url,
+        categoryId: cloneCategoryId,
+        summary: source.summary,
+        faviconUrl: source.faviconUrl,
+        faviconSyncedAt: source.faviconSyncedAt,
+        isGithub: source.isGithub,
+        githubOwner: source.githubOwner,
+        githubRepo: source.githubRepo,
+        githubStars: source.githubStars,
+        githubLatestVersion: source.githubLatestVersion,
+        githubVersionDate: source.githubVersionDate,
+        githubRepoUpdatedAt: source.githubRepoUpdatedAt,
+        githubSyncedAt: source.githubSyncedAt,
+        tags: source.tags,
+        visibility: 'public',
+        userId,
+      },
+    })
+    const messages = {
+      created: '已分享到公共知识库',
+      appended: '已加入分享(内容已存在,你的头像已追加)',
+      already: '你已分享过此内容',
+    }
+    return { result, message: messages[result.action] }
+  })