@allbluecn/web-app 0.19.2 → 0.19.4

package/src/routes/_nav/knowledge/dictionaries/$id.lazy.tsx

@@ -15,6 +15,7 @@
 // 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 { shareResultMessage } from '@/lib/knowledge/share-result-message'
 import { createLazyFileRoute, Link } from '@tanstack/react-router'
 import { useQuery, useQueryClient } from '@tanstack/react-query'
 import { getDictionaryDetailFn } from '@/server/serverFns/knowledge/public/dictionary/detail'
@@ -26,22 +27,61 @@ import { Button } from '@/components/ui/button'
 import { Share2, ArrowLeft } from 'lucide-react'
 import { toast } from '@/components/ui/toast'
 import { m } from "@/paraglide/messages.js";
+import { toastError } from "@/lib/toast-error";
 
 export const Route = createLazyFileRoute('/_nav/knowledge/dictionaries/$id')({ component: DictionaryDetailPage })
 
 function DictionaryDetailPage() {
   const { id } = Route.useParams()
   const qc = useQueryClient()
-  const { data } = useQuery({
+  const { data, isLoading, isError } = useQuery({
     queryKey: ['dictionary-detail', id],
     queryFn: () => getDictionaryDetailFn({ data: { id } }),
   })
 
-  if (!data) return null
+  if (isLoading) {
+    return (
+      <div className="mx-auto max-w-3xl space-y-4 p-6">
+        <div className="size-8 animate-spin rounded-full border-2 border-primary border-t-transparent" />
+      </div>
+    )
+  }
+  if (isError || !data) {
+    return (
+      <div className="mx-auto max-w-3xl space-y-4 p-6 text-sm text-muted-foreground">
+        {m.common_loadFailed()}
+      </div>
+    )
+  }
   const isPublic = data.visibility === 'public'
   const aliases = Array.isArray(data.aliases) ? (data.aliases as string[]) : []
   const examples = Array.isArray(data.examples) ? (data.examples as string[]) : []
 
+  // 参考来源协议白名单（🟠 存储型 XSS 面）：用户可控 URL 仅在 http/https 时渲染为
+  // <a href>，javascript:/data: 等协议不渲染链接
+  let safeReferenceUrl: string | null = null
+  {
+    const raw = data.referenceUrl
+    if (raw) {
+      try {
+        const u = new URL(raw)
+        if (u.protocol === 'http:' || u.protocol === 'https:') safeReferenceUrl = u.toString()
+      } catch {
+        // 非法 URL 不渲染链接
+      }
+    }
+  }
+
+  const handleShare = async () => {
+    try {
+      const r = await shareDictionaryFn({ data: { id } })
+      toast.success(shareResultMessage(r.action))
+      qc.invalidateQueries({ queryKey: ['dictionary-detail', id] })
+    } catch (e) {
+      toastError(e, m.common_operationFailed())
+    }
+  }
+
   return (
     <div className="mx-auto max-w-3xl space-y-4 p-6">
       <Link
@@ -64,15 +104,7 @@ function DictionaryDetailPage() {
           </div>
         </div>
         {!isPublic && (
-          <Button
-            variant="outline"
-            size="sm"
-            onClick={async () => {
-              const r = await shareDictionaryFn({ data: { id } })
-              toast.success(r.message)
-              qc.invalidateQueries({ queryKey: ['dictionary-detail', id] })
-            }}
-          >
+          <Button variant="outline" size="sm" onClick={handleShare}>
             <Share2 className="h-4 w-4" />
             {m.knowledge_dictionaries_detail_sharePublic()}
           </Button>
@@ -90,9 +122,9 @@ function DictionaryDetailPage() {
           </ol>
         </div>
       )}
-      {data.referenceUrl && (
+      {safeReferenceUrl && (
         <a
-          href={data.referenceUrl}
+          href={safeReferenceUrl}
           target="_blank"
           rel="noopener noreferrer"
           className="inline-flex items-center gap-1 text-sm text-primary hover:underline"

package/src/routes/_nav/knowledge/dictionaries/index.lazy.tsx

@@ -25,24 +25,11 @@ import { KnowledgeFilters } from '@/components/knowledge/public/knowledge-filter
 import { KnowledgeCard } from '@/components/knowledge/public/knowledge-card'
 import { KnowledgeCardGrid, EmptyState } from '@/components/knowledge/public/knowledge-card-grid'
 import { KnowledgeFormDialog } from '@/components/knowledge/public/knowledge-form-dialog'
+import { buildIndustryOptions } from '@/components/knowledge/public/industry-options'
 import { StripedPattern } from '@/components/magicui/striped-pattern'
 import { AuroraText } from '@/components/magicui/aurora-text'
 import { m } from "@/paraglide/messages.js";
-
-function buildIndustryOptions() {
-  return [
-    { value: 'internet', label: m.knowledge_compliance_industries_internet() },
-    { value: 'finance', label: m.knowledge_compliance_industries_finance() },
-    { value: 'medical', label: m.knowledge_compliance_industries_medical() },
-    { value: 'education', label: m.knowledge_compliance_industries_education() },
-    { value: 'manufacturing', label: m.knowledge_compliance_industries_manufacturing() },
-    { value: 'energy', label: m.knowledge_compliance_industries_energy() },
-    { value: 'transportation', label: m.knowledge_compliance_industries_transportation() },
-    { value: 'ecommerce', label: m.knowledge_compliance_industries_ecommerce() },
-    { value: 'gaming', label: m.knowledge_compliance_industries_gaming() },
-    { value: 'general', label: m.knowledge_compliance_industries_general() },
-  ]
-}
+import { SEARCH_DEBOUNCE_MS, useDebouncedValue } from "@/lib/pacer";
 
 export const Route = createLazyFileRoute('/_nav/knowledge/dictionaries/')({ component: DictionaryPage })
 
@@ -55,9 +42,11 @@ function DictionaryPage() {
   const industryGroups = [
     { key: 'industry', label: m.knowledge_dictionaries_index_industry(), options: industryOptions },
   ]
+  // 搜索防抖：原始输入直连 queryKey 会每键一次 serverFn RPC
+  const [debouncedSearch] = useDebouncedValue(search, { wait: SEARCH_DEBOUNCE_MS })
   const { data } = useQuery({
-    queryKey: ['dictionary', scope, search, industry],
-    queryFn: () => listDictionaryFn({ data: { scope, search: search || undefined, industry } }),
+    queryKey: ['dictionary', scope, debouncedSearch, industry],
+    queryFn: () => listDictionaryFn({ data: { scope, search: debouncedSearch || undefined, industry } }),
     placeholderData: keepPreviousData,
   })
 

package/src/routes/_nav/knowledge/index.lazy.tsx

@@ -15,7 +15,7 @@
 // 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 { createLazyFileRoute, Link } from '@tanstack/react-router'
+import { createLazyFileRoute, Link, useRouter } from '@tanstack/react-router'
 import { Plus, Lock, Calendar, Pin, PinOff, Scale, ShieldCheck, BookMarked, Bookmark, BookCopy, MoreVertical, Trash2 } from 'lucide-react'
 import { useEffect, useState } from 'react'
 import { Button } from '@/components/ui/button'
@@ -37,6 +37,8 @@ import { LucideIconByName } from '@/components/shared-kit/icons/lucide-icon-pick
 import { KnowledgeFormDialog } from '@/components/knowledge/dialog/knowledge-form-dialog'
 import { toggleKnowledgePinFn, deleteKnowledgeFn } from '@/server/serverFns/knowledge'
 import { m } from "@/paraglide/messages.js";
+import { getLocale } from "@/paraglide/runtime.js";
+import { toastError } from "@/lib/toast-error";
 import lawIllustration from '@/assets/illustrations/knowledge/law-card-illustration.svg?url';
 import { onEvent, emitEvent, AppEvents } from "@/lib/events";
 
@@ -54,6 +56,7 @@ type GeneralKb = typeof GENERAL_KBS[number]
 
 function KnowledgeListPage() {
   const items = Route.useLoaderData() as KnowledgeList
+  const router = useRouter()
   const [createOpen, setCreateOpen] = useState(false)
   const [pinState, setPinState] = useState<Record<string, boolean>>({})
   const [deleteOpen, setDeleteOpen] = useState(false)
@@ -65,14 +68,17 @@ function KnowledgeListPage() {
     const offPinned = onEvent(AppEvents.knowledge.pinned, ({ kbId, pinned }) => {
       setPinState((prev) => ({ ...prev, [kbId]: pinned }));
     });
-    const offDeleted = onEvent(AppEvents.knowledge.deleted, () => {
-      window.location.href = '/knowledge';
+    // 删除后 SPA 内导航 + 失效 loader 重拉（原 window.location.href 整页刷新
+    // 丢失客户端状态，违反项目 SPA 约定）
+    const offDeleted = onEvent(AppEvents.knowledge.deleted, async () => {
+      await router.invalidate();
+      await router.navigate({ to: '/knowledge', replace: true });
     });
     return () => {
       offPinned();
       offDeleted();
     };
-  }, []);
+  }, [router]);
 
   const handleTogglePin = async (kbId: string, pinned: boolean) => {
     setPinState((prev) => ({ ...prev, [kbId]: pinned }));
@@ -98,7 +104,8 @@ function KnowledgeListPage() {
       setDeleteOpen(false);
       emitEvent(AppEvents.knowledge.deleted);
     } catch (e) {
-      console.error('Delete failed:', e instanceof Error ? e.message : String(e));
+      // 失败必须可感知：弹窗保持打开，用户可重试或取消
+      toastError(e, m.common_operationFailed());
     }
     setDeleting(false);
   };
@@ -215,7 +222,7 @@ function KnowledgeListPage() {
                         <LucideIconByName name={item.icon} size={20} />
                       </div>
                       <Badge variant="outline" className="text-[10px]">
-                        {item.visibility === 'team' ? m.knowledge_index_team() : item.visibility === 'general' ? '通用' : m.knowledge_index_private()}
+                        {item.visibility === 'team' ? m.knowledge_index_team() : item.visibility === 'general' ? m.knowledge_index_generalVisibility() : m.knowledge_index_private()}
                       </Badge>
                     </div>
                     <h3 className="mt-4 font-medium text-lg">{item.name}</h3>
@@ -231,7 +238,7 @@ function KnowledgeListPage() {
                       </span>
                       <span className="flex items-center gap-1">
                         <Calendar className="size-3.5" />
-                        {new Intl.DateTimeFormat('zh-CN', { month: 'short', day: 'numeric' }).format(new Date(item.updatedAt))}
+                        {new Intl.DateTimeFormat(getLocale(), { month: 'short', day: 'numeric' }).format(new Date(item.updatedAt))}
                       </span>
                     </div>
                     <DropdownMenu>

package/src/routes/_nav/knowledge/laws/$id.lazy.tsx

@@ -15,37 +15,22 @@
 // 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 { useState, Suspense } from 'react'
-import { createLazyFileRoute, Link, useNavigate } from '@tanstack/react-router'
-import { useQuery, useQueryClient } from '@tanstack/react-query'
+import { Suspense } from 'react'
+import { createLazyFileRoute } from '@tanstack/react-router'
+import { useQuery } from '@tanstack/react-query'
 import { getLegalDetailFn } from '@/server/serverFns/knowledge/public/legal/detail'
-import { shareLegalFn } from '@/server/serverFns/knowledge/public/legal/share'
-import { unshareLegalFn } from '@/server/serverFns/knowledge/public/legal/unshare'
-import { deleteLegalFn } from '@/server/serverFns/knowledge/public/legal/delete'
-import { SharersAvatarGroup } from '@/components/knowledge/public/sharers-avatar-group'
+import { getFavoriteIdsFn } from '@/server/serverFns/knowledge/public/favorite'
 import { KnowledgeDocEditor } from '@/components/knowledge/editor/knowledge-doc-editor'
 import { LEGAL_FIELDS, JURISDICTION_OPTS } from '@/components/knowledge/public/legal-compliance-editor'
+import { LegalDetailActions, LegalDetailBackButton } from '@/components/knowledge/public/legal-detail-actions'
 import type { PropertyValues } from '@/components/knowledge/doc-properties'
-import { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, AlertDialogTrigger } from '@/components/ui/alert-dialog'
-import { Button } from '@/components/ui/button'
-import { Tooltip, TooltipContent, TooltipTrigger } from '@/components/ui/tooltip'
-import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuTrigger } from '@/components/ui/dropdown-menu'
-import { Share2, ArrowLeft, Pencil, Trash2, Link2, Globe, Star } from 'lucide-react'
-import { cn } from '@/lib/utils'
-import { toggleFavoriteFn, getFavoriteIdsFn } from '@/server/serverFns/knowledge/public/favorite'
-import { toast } from '@/components/ui/toast'
 import { m } from "@/paraglide/messages.js";
-import { toastError } from "@/lib/toast-error";
 
 export const Route = createLazyFileRoute('/_nav/knowledge/laws/$id')({ component: LawDetailPage })
 
 function LawDetailPage() {
   const { id } = Route.useParams()
-  const navigate = useNavigate()
-  const qc = useQueryClient()
-  const [deleteOpen, setDeleteOpen] = useState(false)
-  const [sharing, setSharing] = useState(false)
-  const { data } = useQuery({
+  const { data, isLoading, isError } = useQuery({
     queryKey: ['legal-detail', id],
     queryFn: () => getLegalDetailFn({ data: { id } }),
   })
@@ -56,31 +41,27 @@ function LawDetailPage() {
 
   const ctx = Route.useRouteContext()
 
-  async function handleDelete() {
-    try {
-      await deleteLegalFn({ data: { id } })
-      toast.success(m.knowledge_laws_detail_deleted())
-      qc.invalidateQueries({ queryKey: ['legal'] })
-      navigate({ to: '/knowledge/laws' })
-    } catch {
-      toast.error(m.knowledge_laws_detail_deleteFailed())
-    }
+  // 加载失败不再渲染空白：区分 loading / error / 空数据三态
+  if (isLoading) {
+    return (
+      <div className="flex h-full items-center justify-center">
+        <div className="size-8 animate-spin rounded-full border-2 border-primary border-t-transparent" />
+      </div>
+    )
+  }
+  if (isError || !data) {
+    return (
+      <div className="flex h-full items-center justify-center text-sm text-muted-foreground">
+        {m.common_loadFailed()}
+      </div>
+    )
   }
-
-  if (!data) return null
   const isPublic = data.visibility === 'public'
   const currentUserId = ctx.session?.user?.id
   const isOwn = data.userId === currentUserId
   const hasShared = isPublic && currentUserId && data.sharers?.some((s) => s.id === currentUserId)
   const favorited = favoriteIds?.includes(data.id) ?? false
 
-  const handleToggleFavorite = async () => {
-    const r = await toggleFavoriteFn({ data: { entityType: 'legal', entityId: data.id } })
-    toast.success(r.favorited ? m.knowledge_laws_detail_favorited() : m.knowledge_laws_detail_unfavorited())
-    qc.invalidateQueries({ queryKey: ['favorite-ids', 'legal'] })
-    qc.invalidateQueries({ queryKey: ['legal'] })
-  }
-
   const docData = {
     id: data.id,
     kbId: '',
@@ -127,118 +108,47 @@ function LawDetailPage() {
             propertyFields={propertyFields}
             propertyValues={propertyValues}
             backButton={
-              <Tooltip>
-                <TooltipTrigger render={<Link to="/knowledge/laws" className="inline-flex items-center text-foreground hover:text-muted-foreground transition-colors" />}>
-                    <ArrowLeft className="size-8" />
-                  </TooltipTrigger>
-                <TooltipContent>{m.knowledge_laws_detail_backToList()}</TooltipContent>
-              </Tooltip>
+              <LegalDetailBackButton backTo="/knowledge/laws" label={m.knowledge_laws_detail_backToList()} />
             }
             actions={
-              <>
-              {!isOwn && (
-                <>
-                  <Tooltip>
-                    <TooltipTrigger render={<Button variant="ghost" size="icon" onClick={handleToggleFavorite} />}>
-                        <Star className={cn('h-4 w-4', favorited && 'fill-amber-400 text-amber-400')} />
-                      </TooltipTrigger>
-                    <TooltipContent>{favorited ? m.knowledge_laws_detail_unfavorite() : m.knowledge_laws_detail_favorite()}</TooltipContent>
-                  </Tooltip>
-                  <Tooltip>
-                    <TooltipTrigger render={<Button variant="ghost" size="icon" onClick={() => {
-                        navigator.clipboard.writeText(`${window.location.origin}/share/laws/${data.id}`)
-                        toast.success(m.knowledge_laws_detail_linkCopied())
-                      }} />}>
-                        <Share2 className="h-4 w-4" />
-                      </TooltipTrigger>
-                    <TooltipContent>{m.knowledge_laws_detail_copyShareLink()}</TooltipContent>
-                  </Tooltip>
-                </>
-              )}
-              {isOwn && (
-                <>
-                  <AlertDialog open={deleteOpen} onOpenChange={setDeleteOpen}>
-                    <Tooltip>
-                      <TooltipTrigger render={<AlertDialogTrigger render={<Button variant="ghost" size="icon" className="text-destructive hover:text-destructive" />} />}>
-                            <Trash2 className="h-4 w-4" />
-                          </TooltipTrigger>
-                      <TooltipContent>{m.knowledge_laws_detail_delete()}</TooltipContent>
-                    </Tooltip>
-                    <AlertDialogContent>
-                      <AlertDialogHeader>
-                        <AlertDialogTitle>{m.knowledge_laws_detail_confirmDeleteTitle()}</AlertDialogTitle>
-                        <AlertDialogDescription>{m.knowledge_laws_detail_confirmDeleteDesc()}</AlertDialogDescription>
-                      </AlertDialogHeader>
-                      <AlertDialogFooter>
-                        <AlertDialogCancel>{m.knowledge_laws_detail_cancel()}</AlertDialogCancel>
-                        <AlertDialogAction onClick={handleDelete}>{m.knowledge_laws_detail_delete()}</AlertDialogAction>
-                      </AlertDialogFooter>
-                    </AlertDialogContent>
-                  </AlertDialog>
-                  <Tooltip>
-                    <TooltipTrigger render={<Button variant="ghost" size="icon" onClick={() => navigate({ to: '/knowledge/laws/edit/$id', params: { id } })} />}>
-                        <Pencil className="h-4 w-4" />
-                      </TooltipTrigger>
-                    <TooltipContent>{m.knowledge_laws_detail_edit()}</TooltipContent>
-                  </Tooltip>
-                  <DropdownMenu>
-                    <Tooltip>
-                      <TooltipTrigger render={<DropdownMenuTrigger render={<Button variant="ghost" size="icon" disabled={sharing} />} />}>
-                            <Share2 className="h-4 w-4" />
-                          </TooltipTrigger>
-                      <TooltipContent>{m.knowledge_laws_detail_share()}</TooltipContent>
-                    </Tooltip>
-                    <DropdownMenuContent align="end" className="w-40">
-                      {hasShared ? (
-                        <DropdownMenuItem onClick={async () => {
-                          if (!data.canonicalId) return
-                          setSharing(true)
-                          try {
-                            await unshareLegalFn({ data: { canonicalId: data.canonicalId } })
-                            toast.success(m.knowledge_laws_detail_unshared())
-                            qc.invalidateQueries({ queryKey: ['legal-detail', id] })
-                          } catch (e) {
-                            toastError(e, m.knowledge_laws_detail_unshareFailed())
-                          } finally {
-                            setSharing(false)
-                          }
-                        }}>
-                          <Globe className="mr-2 h-4 w-4" />
-                          {m.knowledge_laws_detail_unshare()}
-                        </DropdownMenuItem>
-                      ) : (
-                        <DropdownMenuItem onClick={async () => {
-                          setSharing(true)
-                          try {
-                            const r = await shareLegalFn({ data: { id } })
-                            toast.success(r.message)
-                            qc.invalidateQueries({ queryKey: ['legal-detail', id] })
-                          } catch (e) {
-                            toastError(e, m.knowledge_laws_detail_shareFailed())
-                          } finally {
-                            setSharing(false)
-                          }
-                        }}>
-                          <Globe className="mr-2 h-4 w-4" />
-                          {m.knowledge_laws_detail_sharePublic()}
-                        </DropdownMenuItem>
-                      )}
-                      <DropdownMenuItem onClick={() => {
-                        const shareUrl = `${window.location.origin}/share/laws/${data.id}`
-                        navigator.clipboard.writeText(shareUrl)
-                        toast.success(m.knowledge_laws_detail_linkCopied())
-                      }}>
-                        <Link2 className="mr-2 h-4 w-4" />
-                        {m.knowledge_laws_detail_copyLink()}
-                      </DropdownMenuItem>
-                    </DropdownMenuContent>
-                  </DropdownMenu>
-                </>
-              )}
-              {isPublic && data.sharers?.length ? (
-                <SharersAvatarGroup sharers={data.sharers} currentUserId={currentUserId} />
-              ) : null}
-              </>
+              <LegalDetailActions
+                id={data.id}
+                entityType="legal"
+                isOwn={isOwn}
+                isPublic={isPublic}
+                hasShared={!!hasShared}
+                canonicalId={data.canonicalId ?? null}
+                favorited={favorited}
+                sharers={data.sharers}
+                currentUserId={currentUserId}
+                detailQueryKey={['legal-detail', id]}
+                listQueryKey="legal"
+                favoriteQueryKey={['favorite-ids', 'legal']}
+                editTo="/knowledge/laws/edit/$id"
+                shareBasePath="/share/laws"
+                msg={{
+                  cancel: m.knowledge_laws_detail_cancel(),
+                  confirmDeleteTitle: m.knowledge_laws_detail_confirmDeleteTitle(),
+                  confirmDeleteDesc: m.knowledge_laws_detail_confirmDeleteDesc(),
+                  delete: m.knowledge_laws_detail_delete(),
+                  deleteFailed: m.knowledge_laws_detail_deleteFailed(),
+                  deleted: m.knowledge_laws_detail_deleted(),
+                  edit: m.knowledge_laws_detail_edit(),
+                  favorite: m.knowledge_laws_detail_favorite(),
+                  favorited: m.knowledge_laws_detail_favorited(),
+                  unfavorite: m.knowledge_laws_detail_unfavorite(),
+                  unfavorited: m.knowledge_laws_detail_unfavorited(),
+                  copyLink: m.knowledge_laws_detail_copyLink(),
+                  copyShareLink: m.knowledge_laws_detail_copyShareLink(),
+                  linkCopied: m.knowledge_laws_detail_linkCopied(),
+                  share: m.knowledge_laws_detail_share(),
+                  shareFailed: m.knowledge_laws_detail_shareFailed(),
+                  sharePublic: m.knowledge_laws_detail_sharePublic(),
+                  unshare: m.knowledge_laws_detail_unshare(),
+                  unshareFailed: m.knowledge_laws_detail_unshareFailed(),
+                  unshared: m.knowledge_laws_detail_unshared(),
+                }}
+              />
             }
           />
         </Suspense>

package/src/routes/_nav/knowledge/laws/index.lazy.tsx

@@ -31,6 +31,8 @@ import { chipClass } from '@/components/knowledge/public/chip-utils'
 import { FlickeringGrid } from '@/components/magicui/flickering-grid'
 import { AuroraText } from '@/components/magicui/aurora-text'
 import { m } from "@/paraglide/messages.js";
+import { toastError } from "@/lib/toast-error";
+import { SEARCH_DEBOUNCE_MS, useDebouncedValue } from "@/lib/pacer";
 
 function buildJurisdictionOptions() {
   return [
@@ -54,13 +56,15 @@ function LawPage() {
   const [jurisdiction, setJurisdiction] = useState<string | undefined>()
   const [tag, setTag] = useState<string | undefined>()
   const [sort, setSort] = useState<'default' | 'effectiveDate'>('default')
+  // 搜索防抖：原始输入直连 queryKey 会每键一次 serverFn RPC
+  const [debouncedSearch] = useDebouncedValue(search, { wait: SEARCH_DEBOUNCE_MS })
   const { data: tagList } = useQuery({
     queryKey: ['entity-tags', 'legal'],
     queryFn: () => getEntityTagsFn({ data: { entityType: 'legal' } }),
   })
   const { data } = useQuery({
-    queryKey: ['legal', scope, search, jurisdiction, tag, sort],
-    queryFn: () => listLegalFn({ data: { scope, search: search || undefined, jurisdiction, tag: tag || undefined, sort } }),
+    queryKey: ['legal', scope, debouncedSearch, jurisdiction, tag, sort],
+    queryFn: () => listLegalFn({ data: { scope, search: debouncedSearch || undefined, jurisdiction, tag: tag || undefined, sort } }),
     placeholderData: keepPreviousData,
   })
 
@@ -80,10 +84,14 @@ function LawPage() {
           search={search}
           onSearchChange={setSearch}
           onCreate={async () => {
-            const r = await createLegalFn({ data: { title: '新法规', jurisdiction: '', category: '', tags: [] } })
-            qc.invalidateQueries({ queryKey: ['legal'] })
-            await qc.refetchQueries({ queryKey: ['legal'], type: 'all' })
-            navigate({ to: '/knowledge/laws/edit/$id', params: { id: r.id } })
+            try {
+              const r = await createLegalFn({ data: { title: m.knowledge_laws_index_untitled(), jurisdiction: '', category: '', tags: [] } })
+              // invalidate 已触发活跃查询 refetch，无需再显式 refetch（双份请求）
+              qc.invalidateQueries({ queryKey: ['legal'] })
+              await navigate({ to: '/knowledge/laws/edit/$id', params: { id: r.id } })
+            } catch (e) {
+              toastError(e, m.common_operationFailed())
+            }
           }}
           createLabel={m.knowledge_laws_index_add()}
         />

package/src/routes/_nav/knowledge/summary/index.lazy.tsx

@@ -84,30 +84,31 @@ interface ReportItem {
 function generateMockData(months: string[]): ReportItem[] {
   const items: ReportItem[] = []
   for (let year = START_YEAR; year <= CURRENT_YEAR; year++) {
-    for (let m = 0; m < 12; m++) {
-      const weeks = getWeeksInMonth(year, m)
+    // 注意：循环变量不得命名 m（会遮蔽 paraglide 的 m 导入）
+    for (let mi = 0; mi < 12; mi++) {
+      const weeks = getWeeksInMonth(year, mi)
       for (let w = 1; w <= weeks; w++) {
-        const range = getWeekDateRange(year, m, w)
+        const range = getWeekDateRange(year, mi, w)
         items.push({
-          id: `w-${year}-${m}-${w}`,
+          id: `w-${year}-${mi}-${w}`,
           type: 'weekly',
-          title: '周报',
+          title: m.knowledge_summary_weekly(),
           year,
-          month: m,
+          month: mi,
           week: w,
           dateRange: `${range.start} ~ ${range.end}`,
-          summary: '周报内容',
+          summary: m.knowledge_summary_weeklyMockSummary(),
         })
       }
-      const mRange = getMonthDateRange(year, m)
+      const mRange = getMonthDateRange(year, mi)
       items.push({
-        id: `m-${year}-${m}`,
+        id: `m-${year}-${mi}`,
         type: 'monthly',
-        title: '月报',
+        title: m.knowledge_summary_monthly(),
         year,
-        month: m,
+        month: mi,
         dateRange: `${mRange.start} ~ ${mRange.end}`,
-        summary: '月报内容',
+        summary: m.knowledge_summary_monthlyMockSummary(),
       })
     }
   }
@@ -115,7 +116,16 @@ function generateMockData(months: string[]): ReportItem[] {
 }
 
 function SummaryPage() {
-  const months = JSON.parse(m.summary_months()) as string[]
+  // 翻译串为 JSON 数组字面量：解析一次 + 容错（非法 JSON 降级空数组，不整页崩溃）；
+  // 原实现每次渲染 JSON.parse 产生新引用，令下方 useMemo 恒失效全量重算
+  const months = useMemo(() => {
+    try {
+      const parsed: unknown = JSON.parse(m.summary_months())
+      return Array.isArray(parsed) ? parsed.map(String) : []
+    } catch {
+      return []
+    }
+  }, [])
   const [reportType, setReportType] = useState<ReportType>('all')
   const [year, setYear] = useState(CURRENT_YEAR)
   const [month, setMonth] = useState<number | undefined>()

package/src/routes/_nav/notifications/route.tsx

@@ -23,7 +23,8 @@ export const Route = createFileRoute('/_nav/notifications')({
           listNotificationsFn({ data: pageParam ? { cursor: pageParam } : {} }),
         initialPageParam: undefined as string | undefined,
         getNextPageParam: (lastPage: NotificationListResult) =>
-          lastPage.hasMore ? lastPage.items[lastPage.items.length - 1].id : undefined,
+          // .at(-1) 防御 hasMore=true 而 items 为空的服务端边界 bug（[-1].id 会抛 TypeError）
+          lastPage.hasMore ? lastPage.items.at(-1)?.id : undefined,
       }),
     ]).catch(() => {
       // 预取失败降级为客户端 fetch（与旧行为一致），不阻塞页面

package/src/routes/_nav/notion-like/route.tsx

@@ -1,4 +1,3 @@
-import { m } from '@/paraglide/messages.js'
 // SPDX-License-Identifier: AGPL-3.0-or-later
 // AllBlue - 理想之海
 // Copyright (C) 2026 AllBlue Contributors
@@ -19,6 +18,7 @@ import { m } from '@/paraglide/messages.js'
 import { createFileRoute } from '@tanstack/react-router'
 import { PlaceholderPage } from '@/components/shared-kit/pages/placeholder-page'
 import { FileText } from 'lucide-react'
+import { m } from '@/paraglide/messages.js'
 
 function NotionLikePage() {
   return <PlaceholderPage title={m.nav_notionEditor()} icon={FileText} />

package/src/routes/_nav/pricing-02/route.tsx

@@ -1,4 +1,3 @@
-import { m } from '@/paraglide/messages.js'
 // SPDX-License-Identifier: AGPL-3.0-or-later
 // AllBlue - 理想之海
 // Copyright (C) 2026 AllBlue Contributors
@@ -19,6 +18,7 @@ import { m } from '@/paraglide/messages.js'
 import { createFileRoute } from '@tanstack/react-router'
 import { PlaceholderPage } from '@/components/shared-kit/pages/placeholder-page'
 import { CreditCard } from 'lucide-react'
+import { m } from '@/paraglide/messages.js'
 
 function PricingPage() {
   return <PlaceholderPage title={m.nav_pricing()} icon={CreditCard} />

package/src/routes/_nav/projects/$projectId/$storyId/route.lazy.tsx

@@ -23,6 +23,7 @@ import { LucideIconByName } from "@/components/shared-kit/icons/lucide-icon-pick
 import { PROJECT_MODULE_META } from "@/lib/project-module-meta";
 import type { ProjectModuleItem } from "@/types/project";
 import { m } from "@/paraglide/messages.js";
+import { getLocale } from "@/paraglide/runtime.js";
 
 const STATE_VARIANT: Record<string, "default" | "secondary" | "outline" | "destructive"> = {
   done: "secondary",
@@ -71,7 +72,7 @@ function ModuleRow({ item }: { item: ProjectModuleItem }) {
         {PRIORITY_LABEL_KEYS[item.priority]?.() ?? item.priority}
       </Badge>
       <span className="hidden text-xs text-muted-foreground md:block">
-        {new Intl.DateTimeFormat("zh-CN", { month: "short", day: "numeric" }).format(new Date(item.updatedAt))}
+        {new Intl.DateTimeFormat(getLocale(), { month: "short", day: "numeric" }).format(new Date(item.updatedAt))}
       </span>
       <ChevronRight className="size-4 text-muted-foreground" />
     </div>

package/src/routes/_nav/projects/$projectId/index.lazy.tsx

@@ -115,7 +115,7 @@ function ProjectDetailPage() {
             <LayoutGrid className="size-4 text-muted-foreground" />
             <h2 className="text-base font-semibold">{m.projects_detail_knowledgeBase()}</h2>
           </div>
-          <p className="py-4 text-center text-sm text-muted-foreground">功能开发中</p>
+          <p className="py-4 text-center text-sm text-muted-foreground">{m.common_placeholder_developing()}</p>
         </div>
 
         <div className="grid gap-6 lg:grid-cols-3">