@allbluecn/web-app 0.10.2 → 0.11.0

package/src/components/story/relations/knowledge-select-dialog.tsx

@@ -18,7 +18,7 @@
 import * as React from "react";
 import { useServerFn } from "@tanstack/react-start";
 import { toast } from "sonner";
-import { BookMarked, BookOpenText, Bookmark, Check, ChevronsUpDown, Scale, ShieldCheck, Sprout } from "lucide-react";
+import { BookOpenText, BookMarked, Bookmark, Check, Scale, ShieldCheck, Sprout } from "lucide-react";
 import { Button } from "@/components/ui/button";
 import { Input } from "@/components/ui/input";
 import { Badge } from "@/components/ui/badge";
@@ -40,6 +40,7 @@ import {
   type SearchDocRow,
 } from "@/server/serverFns/story";
 import { generalGroupLabel } from "./general-groups";
+import { KbFilterPopover, type KbFilter } from "@/components/knowledge/kb-filter-popover";
 import type { DocBrief } from "../types";
 import { m } from "@/paraglide/messages.js";
 
@@ -50,24 +51,6 @@ interface KbBrief {
   visibility: string;
 }
 
-type KbFilter = { type: "kb"; id: string } | { type: "general"; group: string } | null;
-
-const GENERAL_GROUP_ICONS: Record<string, React.ComponentType<{ className?: string }>> = {
-  legal: Scale,
-  compliance: ShieldCheck,
-  dictionary: BookMarked,
-  bookmark: Bookmark,
-  summary: Sprout,
-};
-
-const GENERAL_GROUP_META = [
-  { key: "legal" },
-  { key: "compliance" },
-  { key: "dictionary" },
-  { key: "bookmark" },
-  { key: "summary" },
-] as const;
-
 export interface KnowledgeSelectDialogProps {
   open: boolean;
   onOpenChange: (open: boolean) => void;
@@ -98,7 +81,6 @@ export function KnowledgeSelectDialog({
   const [selected, setSelected] = React.useState<Set<string>>(new Set());
   const [loading, setLoading] = React.useState(false);
   const [submitting, setSubmitting] = React.useState(false);
-  const [kbPopoverOpen, setKbPopoverOpen] = React.useState(false);
 
   const linkedIds = React.useMemo(() => new Set(linkedDocs.map((d) => d.id)), [linkedDocs]);
 
@@ -156,7 +138,6 @@ export function KnowledgeSelectDialog({
 
   const handleKbSelect = (filter: KbFilter) => {
     setKbFilter(filter);
-    setKbPopoverOpen(false);
     void loadDocs(filter, search);
   };
 
@@ -281,7 +262,6 @@ export function KnowledgeSelectDialog({
     }
   };
 
-  const activeKb = kbFilter?.type === "kb" ? kbs.find((k) => k.id === kbFilter.id) : undefined;
 
   return (
     <Dialog open={open} onOpenChange={onOpenChange}>
@@ -290,71 +270,17 @@ export function KnowledgeSelectDialog({
           <DialogTitle>{m.story_knowledgeDialog_title()}</DialogTitle>
         </DialogHeader>
 
-        <div className="flex items-center gap-2">
-          <Input
-            placeholder={m.story_knowledgeDialog_searchPlaceholder()}
-            value={search}
-            onChange={(e) => handleSearch(e.target.value)}
-            className="h-8"
-          />
-          <Popover open={kbPopoverOpen} onOpenChange={setKbPopoverOpen}>
-            <PopoverTrigger asChild>
-              <Button variant="outline" size="sm" className="h-8 shrink-0 gap-1">
-                <BookOpenText className="size-3.5" />
-                {activeKb
-                  ? activeKb.name
-                  : kbFilter?.type === "general"
-                    ? generalGroupLabel(kbFilter.group)
-                    : m.story_knowledgeDialog_allKbs()}
-                <ChevronsUpDown className="size-3.5 opacity-50" />
-              </Button>
-            </PopoverTrigger>
-            <PopoverContent align="end" className="w-60 p-1">
-              <button
-                type="button"
-                className="flex w-full items-center justify-between rounded-sm px-2 py-1.5 mt-1 text-sm hover:bg-muted"
-                onClick={() => handleKbSelect(null)}
-              >
-                {m.story_knowledgeDialog_allKbs()}
-                {kbFilter === null && <Check className="size-3.5" />}
-              </button>
-              <div className="border-t px-2 pt-3 text-xs font-medium text-muted-foreground">
-                {m.story_knowledgeDialog_userKbs()}
-              </div>
-              {kbs.map((kb) => (
-                <button
-                  key={kb.id}
-                  type="button"
-                  className="flex w-full items-center justify-between rounded-sm px-2 py-1.5 text-sm hover:bg-muted"
-                  onClick={() => handleKbSelect({ type: "kb", id: kb.id })}
-                >
-                  <span className="truncate">{kb.name}</span>
-                  {kbFilter?.type === "kb" && kbFilter.id === kb.id && <Check className="size-3.5" />}
-                </button>
-              ))}
-              <div className=" border-t px-2 pt-3 text-xs font-medium text-muted-foreground">
-                {m.story_knowledgeDialog_generalKbs()}
-              </div>
-              {GENERAL_GROUP_META.map((group) => {
-                const Icon = GENERAL_GROUP_ICONS[group.key];
-                return (
-                  <button
-                    key={group.key}
-                    type="button"
-                    className="flex w-full items-center justify-between rounded-sm px-2 py-1.5 text-sm hover:bg-muted"
-                    onClick={() => handleKbSelect({ type: "general", group: group.key })}
-                  >
-                    <span className="flex min-w-0 items-center gap-2">
-                      <Icon className="size-3.5 shrink-0 text-muted-foreground" />
-                      <span className="truncate">{generalGroupLabel(group.key)}</span>
-                    </span>
-                    {kbFilter?.type === "general" && kbFilter.group === group.key && <Check className="size-3.5" />}
-                  </button>
-                );
-              })}
-            </PopoverContent>
-          </Popover>
-        </div>
+        <KbFilterPopover
+          search={search}
+          onSearchChange={handleSearch}
+          filter={kbFilter}
+          onFilterChange={(f) => { setKbFilter(f); void loadDocs(f, search); }}
+          userKbs={kbs}
+          searchPlaceholder={m.story_knowledgeDialog_searchPlaceholder()}
+          allLabel={m.story_knowledgeDialog_allKbs()}
+          userKbsLabel={m.story_knowledgeDialog_userKbs()}
+          generalKbsLabel={m.story_knowledgeDialog_generalKbs()}
+        />
 
         <div className="h-80 overflow-y-auto rounded-md border p-1">
           {loading ? (

package/src/components/story/story-list-view.tsx

@@ -79,7 +79,13 @@ export function StoryListView({ stories: initialStories, users: initialUsers, pr
   const [users, setUsers] = useState<UserBrief[]>(initialUsers);
   const [projectId, setProjectId] = useState<string | undefined>(() => {
     try {
-      return localStorage.getItem(STORY_PROJECT_FILTER_KEY) ?? undefined;
+      const stored = localStorage.getItem(STORY_PROJECT_FILTER_KEY) ?? undefined;
+      // 清理过期残留（项目已删除或 localStorage 跨账号残留），避免列表查询空集
+      if (stored && stored !== "__archived__" && !initialProjects.some((p) => p.id === stored)) {
+        localStorage.removeItem(STORY_PROJECT_FILTER_KEY);
+        return undefined;
+      }
+      return stored;
     } catch {
       return undefined;
     }

package/src/components/tiptap/node/table-node/ui/table-move-row-column-button/use-table-move-row-column.ts

@@ -315,8 +315,6 @@ function tableMoveRowColumn({
     const moveOperation =
       finalOrientation === "row" ? moveTableRow : moveTableColumn
 
-    console.log({ from, to, finalOrientation, direction })
-
     const dispatch = (tr: Transaction) => editor.view.dispatch(tr)
 
     if (editor.state.selection instanceof CellSelection) {

package/src/components/workspace/__tests__/activity/workspace-activity-card.test.tsx

@@ -0,0 +1,36 @@
+import { describe, it, expect, vi } from "vitest";
+import { render, screen } from "@testing-library/react";
+import { WorkspaceActivityCard } from "../../activity/workspace-activity-card";
+
+vi.mock("@/components/project/project-activity-list", () => ({
+  ProjectActivityList: ({ activities }: { activities: any[] }) => (
+    <ul data-testid="activity-list">
+      {activities.map((a: any) => (
+        <li key={a.id}>{a.action}</li>
+      ))}
+    </ul>
+  ),
+}));
+
+vi.mock("@tanstack/react-router", () => ({
+  Link: ({ children }: any) => <a>{children}</a>,
+}));
+
+describe("WorkspaceActivityCard", () => {
+  it("渲染活动列表", () => {
+    const ACTIVITIES = [
+      {
+        id: "a1",
+        action: "创建项目",
+        projectId: "p1",
+        userId: "u1",
+        targetType: null,
+        targetId: null,
+        metadata: {},
+        createdAt: new Date(),
+      },
+    ];
+    render(<WorkspaceActivityCard activities={ACTIVITIES} workspaceId="ws1" />);
+    expect(screen.getByTestId("activity-list")).toBeInTheDocument();
+  });
+});

package/src/components/workspace/__tests__/contribution/workspace-contribution-card.test.tsx

@@ -0,0 +1,17 @@
+import { describe, it, expect } from "vitest";
+import { render, screen } from "@testing-library/react";
+import { WorkspaceContributionCard } from "../../contribution/workspace-contribution-card";
+
+vi.mock("@/components/shared-kit/data-viz/contribution-graph-tooltip", () => ({
+  ContributionGraphWithTooltip: ({ title }: { title: string }) => (
+    <div data-testid="contribution-graph">{title}</div>
+  ),
+}));
+
+describe("WorkspaceContributionCard", () => {
+  it("渲染贡献图卡片", () => {
+    const data = [{ date: "2024-01-01", count: 5, level: 3 }];
+    render(<WorkspaceContributionCard data={data} />);
+    expect(screen.getByTestId("contribution-graph")).toBeInTheDocument();
+  });
+});

package/src/components/workspace/__tests__/dialogs/create-workspace-dialog.test.tsx

@@ -0,0 +1,63 @@
+import { describe, it, expect, vi } from "vitest";
+import { render, screen } from "@testing-library/react";
+import { CreateWorkspaceDialog } from "../../dialogs/create-workspace-dialog";
+
+vi.mock("@/components/ui/button", () => ({
+  Button: ({ children, ...props }: any) => <button {...props}>{children}</button>,
+}));
+
+vi.mock("@/components/ui/input", () => ({
+  Input: (props: any) => <input {...props} />,
+}));
+
+vi.mock("@/components/ui/dialog", () => ({
+  Dialog: ({ children }: any) => <div>{children}</div>,
+  DialogContent: ({ children }: any) => <div>{children}</div>,
+  DialogFooter: ({ children }: any) => <div>{children}</div>,
+  DialogHeader: ({ children }: any) => <div>{children}</div>,
+  DialogTitle: ({ children }: any) => <h2>{children}</h2>,
+}));
+
+vi.mock("@/components/shared-kit/icons/lucide-icon-picker", () => ({
+  LucideIconPicker: () => <div data-testid="icon-picker" />,
+}));
+
+vi.mock("@tanstack/react-router", () => ({
+  useRouter: () => ({ navigate: vi.fn() }),
+  Link: ({ children }: any) => <a>{children}</a>,
+}));
+
+vi.mock("@tanstack/react-form", () => {
+  const makeField = (value: string) => ({
+    value,
+    handleChange: vi.fn(),
+    handleBlur: vi.fn(),
+    meta: { errors: [] },
+  });
+  return {
+    useForm: () => {
+      const fields = {
+        name: makeField(""),
+        icon: makeField("folder"),
+        description: makeField(""),
+      };
+      return {
+        handleSubmit: (e: any) => e.preventDefault(),
+        setFieldValue: () => {},
+        state: { values: { name: "", icon: "folder", description: "" } },
+        fields,
+        Field: ({ name, children }: { name: "name" | "icon" | "description"; children: unknown }) =>
+          typeof children === "function"
+            ? (children as (field: unknown) => unknown)(fields[name])
+            : null,
+      };
+    },
+  };
+});
+
+describe("CreateWorkspaceDialog", () => {
+  it("打开时渲染标题", () => {
+    render(<CreateWorkspaceDialog open={true} onOpenChange={() => {}} />);
+    expect(screen.getByRole("heading")).toBeInTheDocument();
+  });
+});

package/src/components/workspace/__tests__/dialogs/delete-workspace-options.test.tsx

@@ -0,0 +1,89 @@
+import type { ReactNode } from "react";
+
+import { render } from "@testing-library/react";
+import { describe, expect, it, vi } from "vitest";
+
+import { DeleteWorkspaceOptions } from "../../dialogs/delete-workspace-options";
+
+vi.mock("@/components/ui/field", () => ({
+  Field: ({ children }: { children: ReactNode }) => <div>{children}</div>,
+  FieldContent: ({ children }: { children: ReactNode }) => <div>{children}</div>,
+  FieldDescription: ({ children }: { children: ReactNode }) => (
+    <p>{children}</p>
+  ),
+  FieldLabel: ({ children }: { children: ReactNode }) => <div>{children}</div>,
+  FieldTitle: ({ children }: { children: ReactNode }) => <span>{children}</span>,
+}));
+
+vi.mock("@/components/ui/radio-group", () => ({
+  RadioGroup: ({ children }: { children: ReactNode }) => (
+    <div data-radix-radio-group>{children}</div>
+  ),
+  RadioGroupItem: () => <input type="radio" />,
+}));
+
+vi.mock("@/components/ui/select", () => ({
+  Select: ({ children }: { children: ReactNode }) => <div>{children}</div>,
+  SelectContent: ({ children }: { children: ReactNode }) => <div>{children}</div>,
+  SelectItem: ({ children }: { children: ReactNode }) => <div>{children}</div>,
+  SelectTrigger: ({ children }: { children: ReactNode }) => (
+    <div data-radix-select-trigger>{children}</div>
+  ),
+  SelectValue: () => <span />,
+}));
+
+vi.mock("@/components/ui/separator", () => ({
+  Separator: () => <hr />,
+}));
+
+describe("DeleteWorkspaceOptions", () => {
+  const baseProps = {
+    projectCount: 2,
+    deleteMode: "transfer" as const,
+    onDeleteModeChange: () => {},
+    storyMode: "transfer" as const,
+    onStoryModeChange: () => {},
+    knowledgeBaseMode: "delete" as const,
+    onKnowledgeBaseModeChange: () => {},
+    targetWorkspaceId: "ws-2",
+    onTargetWorkspaceIdChange: () => {},
+    workspaceOptions: [
+      { id: "ws-2", name: "其他工作区" },
+      { id: "ws-3", name: "另一个工作区" },
+    ],
+  };
+
+  it("转移模式下渲染两组处理选项并显示目标工作区下拉", () => {
+    const { container } = render(<DeleteWorkspaceOptions {...baseProps} />);
+
+    expect(
+      container.querySelectorAll("[data-radix-radio-group]"),
+    ).toHaveLength(2);
+    expect(container.querySelector("[data-radix-select-trigger]")).not.toBeNull();
+  });
+
+  it("清空模式下渲染三组处理选项且无目标工作区下拉", () => {
+    const { container } = render(
+      <DeleteWorkspaceOptions
+        {...baseProps}
+        deleteMode="clear"
+        storyMode="clear"
+      />,
+    );
+
+    expect(
+      container.querySelectorAll("[data-radix-radio-group]"),
+    ).toHaveLength(3);
+    expect(container.querySelector("[data-radix-select-trigger]")).toBeNull();
+  });
+
+  it("无项目时仅渲染知识库处理选项", () => {
+    const { container } = render(
+      <DeleteWorkspaceOptions {...baseProps} projectCount={0} />,
+    );
+
+    expect(
+      container.querySelectorAll("[data-radix-radio-group]"),
+    ).toHaveLength(1);
+  });
+});

package/src/components/workspace/__tests__/dialogs/edit-workspace-dialog.test.tsx

@@ -0,0 +1,68 @@
+import { describe, it, expect, vi } from "vitest";
+import { render, screen } from "@testing-library/react";
+import { EditWorkspaceDialog } from "../../dialogs/edit-workspace-dialog";
+
+vi.mock("@/components/ui/button", () => ({
+  Button: ({ children, ...props }: any) => <button {...props}>{children}</button>,
+}));
+
+vi.mock("@/components/ui/input", () => ({
+  Input: (props: any) => <input {...props} />,
+}));
+
+vi.mock("@/components/ui/dialog", () => ({
+  Dialog: ({ children }: any) => <div>{children}</div>,
+  DialogContent: ({ children }: any) => <div>{children}</div>,
+  DialogFooter: ({ children }: any) => <div>{children}</div>,
+  DialogHeader: ({ children }: any) => <div>{children}</div>,
+  DialogTitle: ({ children }: any) => <h2>{children}</h2>,
+}));
+
+vi.mock("@/components/shared-kit/icons/lucide-icon-picker", () => ({
+  LucideIconPicker: () => <div data-testid="icon-picker" />,
+}));
+
+vi.mock("@tanstack/react-router", () => ({
+  useRouter: () => ({ navigate: vi.fn() }),
+}));
+
+vi.mock("@tanstack/react-form", () => {
+  const makeField = (value: string) => ({
+    value,
+    handleChange: vi.fn(),
+    handleBlur: vi.fn(),
+    meta: { errors: [] },
+  });
+  return {
+    useForm: () => {
+      const fields = {
+        name: makeField("测试"),
+        icon: makeField("folder"),
+        description: makeField(""),
+      };
+      return {
+        handleSubmit: (e: any) => e.preventDefault(),
+        setFieldValue: () => {},
+        state: { values: { name: "测试", icon: "folder", description: "" } },
+        fields,
+        Field: ({ name, children }: { name: "name" | "icon" | "description"; children: unknown }) =>
+          typeof children === "function"
+            ? (children as (field: unknown) => unknown)(fields[name])
+            : null,
+      };
+    },
+  };
+});
+
+describe("EditWorkspaceDialog", () => {
+  it("打开时渲染标题", () => {
+    render(
+      <EditWorkspaceDialog
+        open={true}
+        onOpenChange={() => {}}
+        workspace={{ id: "ws1", name: "测试", icon: "folder", description: null }}
+      />
+    );
+    expect(screen.getByRole("heading")).toBeInTheDocument();
+  });
+});

package/src/components/workspace/__tests__/header/workspace-header.test.tsx

@@ -0,0 +1,40 @@
+import { describe, it, expect, vi } from "vitest";
+import { render, screen } from "@testing-library/react";
+import { WorkspaceHeader } from "../../header/workspace-header";
+
+vi.mock("@/components/ui/button", () => ({
+  Button: ({ children, ...props }: any) => <button {...props}>{children}</button>,
+}));
+
+vi.mock("@/components/ui/dropdown-menu", () => ({
+  DropdownMenu: ({ children }: any) => <div>{children}</div>,
+  DropdownMenuTrigger: ({ children }: any) => <div>{children}</div>,
+  DropdownMenuContent: ({ children }: any) => <div>{children}</div>,
+  DropdownMenuItem: ({ children }: any) => <div>{children}</div>,
+}));
+
+vi.mock("@/components/ui/separator", () => ({
+  Separator: () => <div data-testid="separator" />,
+}));
+
+vi.mock("@/components/shared-kit/icons/lucide-icon-picker/lucide-icon-by-name", () => ({
+  LucideIconByName: () => <div data-testid="icon" />,
+}));
+
+vi.mock("@tanstack/react-router", () => ({
+  Link: ({ children }: any) => <a>{children}</a>,
+}));
+
+describe("WorkspaceHeader", () => {
+  it("渲染工作空间名称", () => {
+    const WORKSPACE = {
+      id: "ws1",
+      name: "测试工作空间",
+      description: null,
+      icon: "folder",
+      _count: { projects: 0 },
+    };
+    render(<WorkspaceHeader workspace={WORKSPACE} onEdit={() => {}} onDelete={() => {}} />);
+    expect(screen.getByText("测试工作空间")).toBeInTheDocument();
+  });
+});

package/src/components/workspace/__tests__/kb/workspace-kb-card.test.tsx

@@ -0,0 +1,154 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { render, screen, fireEvent, waitFor } from "@testing-library/react";
+
+const mocks = vi.hoisted(() => ({
+  invalidate: vi.fn(),
+  setKbs: vi.fn(),
+  renameDoc: vi.fn(),
+  removeDoc: vi.fn(),
+  reorderDocs: vi.fn(),
+}));
+
+vi.mock("@tanstack/react-router", () => ({
+  useRouter: () => ({ invalidate: mocks.invalidate }),
+  Link: ({ to, children, ...rest }: any) => (
+    <a href={typeof to === "string" ? to : "#"} {...rest}>{children}</a>
+  ),
+}));
+vi.mock("@tanstack/react-start", () => ({
+  useServerFn: (fn: any) => async (...args: any[]) => fn(...args),
+}));
+vi.mock("@/server/serverFns/workspace-kb", () => ({
+  getWorkspaceKbCardFn: vi.fn().mockResolvedValue({ kbs: [], quickDocs: [] }),
+  listWorkspaceAvailableKbsFn: vi.fn(),
+  setWorkspaceKbsFn: mocks.setKbs,
+  renameQuickDocFn: mocks.renameDoc,
+  removeQuickDocFn: mocks.removeDoc,
+  reorderQuickDocsFn: mocks.reorderDocs,
+  searchQuickDocCandidatesFn: vi.fn(),
+  addQuickDocsFn: vi.fn(),
+}));
+vi.mock("@dnd-kit/react", () => ({
+  DragDropProvider: ({ children }: any) => <div>{children}</div>,
+  useDroppable: () => ({ ref: null, isDropTarget: false }),
+}));
+vi.mock("@dnd-kit/react/sortable", () => ({
+  useSortable: () => ({ ref: undefined, handleRef: undefined, isDragging: false }),
+}));
+vi.mock("sonner", () => ({
+  toast: { error: vi.fn(), success: vi.fn(), warning: vi.fn() },
+}));
+vi.mock("../workspace-kb-manage-dialog", () => ({
+  WorkspaceKbManageDialog: () => null,
+}));
+vi.mock("../workspace-quick-doc-dialog", () => ({
+  WorkspaceQuickDocDialog: () => null,
+}));
+vi.mock("@/components/ui/tooltip", () => ({
+  Tooltip: ({ children }: any) => <span data-testid="tooltip-wrapper">{children}</span>,
+  TooltipContent: ({ children }: any) => <span>{children}</span>,
+  TooltipTrigger: ({ children }: any) => <span data-testid="tooltip-trigger">{children}</span>,
+}));
+
+import { WorkspaceKbCard } from "../../kb/workspace-kb-card";
+
+const KB = { id: "kb1", name: "团队库", icon: "notebook", visibility: "team" };
+const DOC_ROW = {
+  id: "q1", displayTitle: "接入指南", columnIndex: 0, sortOrder: 0, label: null, icon: null, source: "doc" as const,
+  docId: "d1", kbId: "kb1", kbName: "团队库", docIcon: null,
+  group: null, externalId: null, faviconUrl: null, sourceTitle: "接入指南", url: null, stale: false,
+};
+const STALE_ROW = {
+  ...DOC_ROW, id: "q2", displayTitle: "旧法条", source: "general" as const,
+  docId: null, kbId: null, kbName: null, group: "legal" as const, externalId: "gone",
+  faviconUrl: null, sourceTitle: null, url: null, stale: true,
+};
+const EXTERNAL_URL_ROW = {
+  ...DOC_ROW, id: "q3", displayTitle: "外部工具", source: "general" as const,
+  docId: null, kbId: null, kbName: null, group: "bookmark" as const, externalId: "ext123",
+  faviconUrl: null, sourceTitle: "PNG to ICO", url: "https://tool.xuecan.net/png-to-ico/", stale: false,
+};
+
+beforeEach(() => {
+  vi.clearAllMocks();
+});
+
+describe("WorkspaceKbCard 渲染", () => {
+  it("空数据显示空状态且「前往知识库」禁用", () => {
+    render(<WorkspaceKbCard workspaceId="ws1" data={{ kbs: [], quickDocs: [] }} />);
+    expect(screen.getByText(/快捷知识入口/)).toBeInTheDocument();
+    // 前往知识库图标按钮 disabled，无 aria-label
+    const buttons = screen.getAllByRole("button");
+    const disabledBtn = buttons.find((b) => b.getAttribute("disabled") !== null);
+    expect(disabledBtn).toBeTruthy();
+  });
+
+  it("渲染快捷文档行（5列布局）", () => {
+    render(<WorkspaceKbCard workspaceId="ws1" data={{ kbs: [], quickDocs: [DOC_ROW] }} />);
+    expect(screen.getByText("接入指南")).toBeInTheDocument();
+  });
+
+  it("失效条目显示「源已失效」", () => {
+    render(<WorkspaceKbCard workspaceId="ws1" data={{ kbs: [], quickDocs: [STALE_ROW] }} />);
+    expect(screen.getByText(/源已失效/)).toBeInTheDocument();
+  });
+
+  it("已关联知识库时不显示知识库名称（chip 已移除），前往按钮 tooltip 显示库名", () => {
+    render(<WorkspaceKbCard workspaceId="ws1" data={{ kbs: [KB], quickDocs: [] }} />);
+    // chip 行已移除，但 goToKb tooltip 仍显示库名
+    expect(screen.getByText("团队库")).toBeInTheDocument();
+  });
+});
+
+describe("WorkspaceKbCard 乐观更新", () => {
+  it("删除确认后乐观移除并调 removeQuickDocFn", async () => {
+    render(<WorkspaceKbCard workspaceId="ws1" data={{ kbs: [], quickDocs: [DOC_ROW] }} />);
+    fireEvent.click(screen.getByRole("button", { name: "删除" }));
+    fireEvent.click(screen.getByRole("button", { name: "确认" }));
+    await waitFor(() => {
+      expect(mocks.removeDoc).toHaveBeenCalledWith({ data: { quickDocId: "q1" } });
+    });
+    expect(screen.queryByText("接入指南")).not.toBeInTheDocument();
+  });
+
+  it("重命名提交调用 renameQuickDocFn 且 UI 更新", async () => {
+    render(<WorkspaceKbCard workspaceId="ws1" data={{ kbs: [], quickDocs: [DOC_ROW] }} />);
+    fireEvent.click(screen.getByRole("button", { name: "重命名" }));
+    const input = screen.getByRole("textbox");
+    fireEvent.change(input, { target: { value: "新标题" } });
+    fireEvent.keyDown(input, { key: "Enter" });
+    await waitFor(() => {
+      expect(mocks.renameDoc).toHaveBeenCalledWith({
+        data: { quickDocId: "q1", displayTitle: "新标题" },
+      });
+    });
+    expect(screen.getByText("新标题")).toBeInTheDocument();
+  });
+
+  it("外部 URL 卡片使用 <a href> 而非 Link", () => {
+    render(<WorkspaceKbCard workspaceId="ws1" data={{ kbs: [], quickDocs: [EXTERNAL_URL_ROW] }} />);
+    // 外部 URL 应渲染为普通 <a> 标签，而非 TanStack Router Link（mock 为 <a>）
+    const link = screen.getByText("外部工具").closest("a");
+    expect(link).toBeInTheDocument();
+    expect((link as HTMLAnchorElement).href).toBe("https://tool.xuecan.net/png-to-ico/");
+    expect((link as HTMLAnchorElement).target).toBe("_blank");
+  });
+
+  it("编辑状态下点击行不触发导航", async () => {
+    render(<WorkspaceKbCard workspaceId="ws1" data={{ kbs: [], quickDocs: [DOC_ROW] }} />);
+    // 进入编辑模式
+    fireEvent.click(screen.getByRole("button", { name: "重命名" }));
+    // 编辑态：快捷文档行的主链接不应存在（渲染为 span，无导航能力）
+    const row = document.querySelector("[data-quick-doc-row]");
+    expect(row).toBeInTheDocument();
+    // 主链接区域（包含 title 的 <a>）应不存在
+    const mainLink = row!.querySelector<HTMLAnchorElement>('.flex-1.truncate > a');
+    expect(mainLink).not.toBeInTheDocument();
+    // Input 应存在且可编辑
+    expect(screen.getByRole("textbox")).toBeInTheDocument();
+    // 点击行区域不应有导航（因为没有 Link）
+    fireEvent.click(row!);
+    // 编辑状态应保持（点击行内不会意外退出）
+    expect(screen.getByRole("textbox")).toBeInTheDocument();
+  });
+});

package/src/components/workspace/__tests__/members/workspace-member-item.test.tsx

@@ -0,0 +1,24 @@
+import { describe, it, expect, vi } from "vitest";
+import { render, screen } from "@testing-library/react";
+import { WorkspaceMemberItem } from "../../members/workspace-member-item";
+
+vi.mock("@/components/shared-kit", () => ({
+  UserAvatar: ({ name }: { name?: string }) => <div data-testid="user-avatar">{name?.[0] ?? "?"}</div>,
+}));
+
+const MEMBER = {
+  id: "m1",
+  userId: "u1",
+  role: "member" as const,
+  status: "active" as const,
+  joinedAt: new Date(),
+  user: { id: "u1", username: "张三", email: "zhangsan@example.com" },
+};
+
+describe("WorkspaceMemberItem", () => {
+  it("渲染成员用户名和邮箱", () => {
+    render(<WorkspaceMemberItem member={MEMBER} workspaceOwnerId="owner1" onRemove={() => {}} />);
+    expect(screen.getByText("张三")).toBeInTheDocument();
+    expect(screen.getByText("zhangsan@example.com")).toBeInTheDocument();
+  });
+});