feat(inbox): 统一收件箱——剪贴板/灵感/导入三路合并 + 24h 去重

Author: Aparencia

client/src/features/inbox/lib/inboxRepository.ts

@@ -0,0 +1,99 @@
+/**
+ * 统一收件箱数据访问层 — inbox_items 表 IPC 封装
+ * Unified inbox repository — thin db IPC bridge for inbox_items
+ *
+ * @ai-context: 三路来源（clipboard / inspiration / import）统一收件。
+ * 剪贴板收藏带内容去重（同文本 24h 内不重复入箱，返回既有 id）。
+ * 非 Electron 环境或 IPC 失败时静默降级，收件箱 UI 不阻塞。
+ * @ai-context: Three ingestion sources converge here; clipboard capture
+ * dedupes identical text within 24h. Methods degrade silently outside
+ * Electron so the inbox UI never breaks.
+ */
+import type { InboxItem } from '../types';
+
+const TABLE = 'inboxItems';
+
+/** 内容去重窗口（毫秒）：同文本 24h 内不重复入箱 */
+const DEDUP_WINDOW_MS = 24 * 60 * 60 * 1000;
+
+function getApi(): typeof window.electronAPI | undefined {
+  return window.electronAPI;
+}
+
+/** 从正文派生标题：首行截断 */
+function deriveTitle(content: string): string {
+  const firstLine = content.split('\n')[0]?.trim() ?? '';
+  return firstLine.length > 40 ? `${firstLine.slice(0, 40)}…` : firstLine;
+}
+
+/** 读取全部收件箱条目（新→旧） */
+export async function listInboxItems(): Promise<InboxItem[]> {
+  const api = getApi();
+  if (!api) return [];
+  try {
+    const rows = await api.db.query<InboxItem[]>(TABLE, 'getAll');
+    return (rows ?? []).sort((a, b) => b.created_at.localeCompare(a.created_at));
+  } catch {
+    return [];
+  }
+}
+
+/**
+ * 收藏剪贴板文本到收件箱（去重后写入）。
+ * @returns { id, duplicated }——duplicated=true 表示 24h 内已存在同文本
+ */
+export async function captureClipboardText(text: string): Promise<{ id: string; duplicated: boolean } | undefined> {
+  const trimmed = text.trim();
+  const api = getApi();
+  if (!api) return undefined;
+  if (!trimmed) return undefined;
+
+  try {
+    // 去重：遍历现有条目，命中同文本且在窗口期内则直接返回既有 id
+    const existing = await listInboxItems();
+    const now = Date.now();
+    const dup = existing.find((i) => {
+      if (i.content !== trimmed) return false;
+      const age = now - new Date(i.created_at).getTime();
+      return age >= 0 && age < DEDUP_WINDOW_MS;
+    });
+    if (dup) return { id: dup.id, duplicated: true };
+
+    const id = crypto.randomUUID();
+    await api.db.insert(TABLE, {
+      id,
+      source: 'clipboard',
+      title: deriveTitle(trimmed),
+      content: trimmed,
+      status: 'new',
+      created_at: new Date().toISOString(),
+    });
+    return { id, duplicated: false };
+  } catch {
+    return undefined;
+  }
+}
+
+/** 更新条目状态（settled=已沉淀 / archived=已归档，可逆原则：不物理删除） */
+export async function updateInboxStatus(id: string, status: InboxItem['status']): Promise<boolean> {
+  const api = getApi();
+  if (!api) return false;
+  try {
+    await api.db.update(TABLE, id, { status });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/** 删除条目（垃圾清理用，与归档二选一） */
+export async function deleteInboxItem(id: string): Promise<boolean> {
+  const api = getApi();
+  if (!api) return false;
+  try {
+    await api.db.delete(TABLE, id);
+    return true;
+  } catch {
+    return false;
+  }
+}

client/src/features/inbox/pages/InboxPage.tsx

@@ -0,0 +1,209 @@
+/**
+ * 统一收件箱页 — 三路来源待沉淀项汇聚与操作
+ * Unified inbox page — convergent tray for pending captures
+ *
+ * @ai-context: 展示 inbox_items 全部条目（来源/状态筛选）。剪贴板来源由
+ * 全局快捷键 Ctrl+Shift+B 实时灌入（capture-clipboard → ShortcutRoot →
+ * inboxRepository）；inspiration/import 来源已具备 schema 与筛选位，
+ * 待后续管线接线。操作：沉淀（settled）/ 归档（archived，可逆）/ 删除。
+ * @ai-context: Lists inbox_items with source/status filters. Clipboard items
+ * flow in live via the global shortcut; inspiration/import sources are
+ * schema-ready for future pipelines. Actions: settle / archive / delete.
+ */
+import { useCallback, useEffect, useMemo, useState } from 'react';
+import { Inbox, CheckCircle2, Archive, Trash2, Clipboard } from 'lucide-react';
+import { useToast } from '@/components/ui';
+import RitualHeader from '@/features/inspiration/components/RitualHeader';
+import { SOURCE_META, STATUS_META } from '../types';
+import type { InboxItem } from '../types';
+import { listInboxItems, updateInboxStatus, deleteInboxItem } from '../lib/inboxRepository';
+import { cn } from '@/lib/utils';
+
+type SourceFilter = 'all' | InboxItem['source'];
+type StatusFilter = 'all' | InboxItem['status'];
+
+export default function InboxPage() {
+  const { toast } = useToast();
+  const [items, setItems] = useState<InboxItem[] | null>(null);
+  const [sourceFilter, setSourceFilter] = useState<SourceFilter>('all');
+  const [statusFilter, setStatusFilter] = useState<StatusFilter>('all');
+
+  const load = useCallback(async () => {
+    const rows = await listInboxItems();
+    setItems(rows);
+  }, []);
+
+  useEffect(() => {
+    void load();
+  }, [load]);
+
+  const filtered = useMemo(() => {
+    if (!items) return [];
+    return items.filter(
+      (i) =>
+        (sourceFilter === 'all' || i.source === sourceFilter) &&
+        (statusFilter === 'all' || i.status === statusFilter),
+    );
+  }, [items, sourceFilter, statusFilter]);
+
+  const handleSettle = async (item: InboxItem) => {
+    const ok = await updateInboxStatus(item.id, 'settled');
+    if (ok) {
+      toast({ type: 'success', message: '已标记为沉淀' });
+      void load();
+    }
+  };
+
+  const handleArchive = async (item: InboxItem) => {
+    const ok = await updateInboxStatus(item.id, 'archived');
+    if (ok) {
+      toast({ type: 'info', message: '已归档（可再标记回待沉淀）' });
+      void load();
+    }
+  };
+
+  const handleDelete = async (item: InboxItem) => {
+    const ok = await deleteInboxItem(item.id);
+    if (ok) {
+      toast({ type: 'info', message: '已删除' });
+      void load();
+    }
+  };
+
+  const counts = useMemo(() => {
+    const c: Record<string, number> = { all: items?.length ?? 0 };
+    for (const s of ['clipboard', 'inspiration', 'import'] as const) {
+      c[s] = items?.filter((i) => i.source === s).length ?? 0;
+    }
+    return c;
+  }, [items]);
+
+  return (
+    <div className="mx-auto flex max-w-3xl flex-col gap-6 px-kb-lg py-kb-xl">
+      <RitualHeader title="收件箱" note="万物入井 待时而序">
+        <div className="flex items-center gap-1.5 rounded-full border border-border/40 bg-bg-secondary/60 px-3 py-1.5 text-c1 text-text-tertiary backdrop-blur-xl">
+          <Clipboard className="w-3.5 h-3.5" />
+          Ctrl+Shift+B 随时收藏
+        </div>
+      </RitualHeader>
+
+      {/* ── 筛选栏 ── */}
+      <div className="flex flex-col gap-2 rounded-2xl border border-border/30 bg-bg-secondary/40 p-3 backdrop-blur-xl">
+        <div className="flex flex-wrap items-center gap-1.5">
+          <button
+            onClick={() => setSourceFilter('all')}
+            className={cn(
+              'rounded-full px-3 py-1 text-c1 font-medium transition-colors',
+              sourceFilter === 'all' ? 'bg-brand-600/20 text-brand-400' : 'text-text-tertiary hover:text-text-secondary',
+            )}
+          >
+            全部 {counts.all}
+          </button>
+          {(Object.keys(SOURCE_META) as InboxItem['source'][]).map((s) => (
+            <button
+              key={s}
+              onClick={() => setSourceFilter(sourceFilter === s ? 'all' : s)}
+              className={cn(
+                'rounded-full px-3 py-1 text-c1 font-medium transition-colors',
+                sourceFilter === s ? 'bg-brand-600/20 text-brand-400' : 'text-text-tertiary hover:text-text-secondary',
+              )}
+            >
+              {SOURCE_META[s].label} {counts[s]}
+            </button>
+          ))}
+        </div>
+        <div className="flex items-center gap-1.5">
+          {(Object.keys(STATUS_META) as InboxItem['status'][]).map((s) => (
+            <button
+              key={s}
+              onClick={() => setStatusFilter(statusFilter === s ? 'all' : s)}
+              className={cn(
+                'rounded-full px-2.5 py-0.5 text-c1 transition-colors',
+                statusFilter === s ? 'text-text-primary underline underline-offset-4' : 'text-text-tertiary hover:text-text-secondary',
+              )}
+            >
+              {STATUS_META[s].label}
+            </button>
+          ))}
+          {statusFilter !== 'all' && (
+            <button onClick={() => setStatusFilter('all')} className="text-c1 text-text-tertiary hover:text-text-secondary">
+              清除
+            </button>
+          )}
+        </div>
+      </div>
+
+      {/* ── 条目列表 ── */}
+      {items === null ? (
+        <div className="space-y-2">
+          {[0, 1, 2].map((i) => (
+            <div key={i} className="h-24 animate-pulse rounded-2xl bg-bg-secondary/60" />
+          ))}
+        </div>
+      ) : filtered.length === 0 ? (
+        <div className="kb-ritual-empty py-kb-xl">
+          <Inbox className="mx-auto mb-2 w-8 h-8 text-text-tertiary/40" />
+          <p className="kb-ritual-empty-title">{items.length === 0 ? '收件箱尚空' : '没有匹配的条目'}</p>
+          <p className="kb-ritual-empty-note">
+            {items.length === 0 ? '选中内容后按 Ctrl+Shift+B 收藏到这里' : '换个筛选条件试试'}
+          </p>
+        </div>
+      ) : (
+        <div className="flex flex-col gap-2.5">
+          {filtered.map((item) => (
+            <div
+              key={item.id}
+              className="flex flex-col gap-2 rounded-2xl border border-border/30 bg-bg-secondary/50 p-4 backdrop-blur-xl transition-colors hover:border-accent-400/40"
+            >
+              <div className="flex items-center gap-2">
+                <span className={`rounded-full px-2 py-0.5 text-c1 font-medium ${SOURCE_META[item.source].badge}`}>
+                  {SOURCE_META[item.source].label}
+                </span>
+                <span className={`rounded-full px-2 py-0.5 text-c1 font-medium ${STATUS_META[item.status].badge}`}>
+                  {STATUS_META[item.status].label}
+                </span>
+                <span className="ml-auto text-c1 text-text-tertiary">
+                  {new Date(item.created_at).toLocaleString()}
+                </span>
+              </div>
+              {item.title && <p className="text-b2 font-medium text-text-primary">{item.title}</p>}
+              <p className="line-clamp-3 whitespace-pre-wrap text-c1 text-text-secondary">{item.content}</p>
+              <div className="flex items-center justify-end gap-1.5">
+                {item.status === 'new' && (
+                  <button
+                    onClick={() => void handleSettle(item)}
+                    className="flex items-center gap-1 rounded-full bg-emerald-500/10 px-3 py-1 text-c1 font-medium text-emerald-400 transition-colors hover:bg-emerald-500/20"
+                  >
+                    <CheckCircle2 className="w-3.5 h-3.5" /> 标记沉淀
+                  </button>
+                )}
+                {item.status !== 'archived' && (
+                  <button
+                    onClick={() => void handleArchive(item)}
+                    className="flex items-center gap-1 rounded-full bg-bg-tertiary px-3 py-1 text-c1 font-medium text-text-tertiary transition-colors hover:text-text-secondary"
+                  >
+                    <Archive className="w-3.5 h-3.5" /> 归档
+                  </button>
+                )}
+                {item.status === 'archived' && (
+                  <button
+                    onClick={() => void handleSettle(item)}
+                    className="rounded-full bg-bg-tertiary px-3 py-1 text-c1 font-medium text-text-tertiary transition-colors hover:text-text-secondary"
+                  >
+                    恢复待沉淀
+                  </button>
+                )}
+                <button
+                  onClick={() => void handleDelete(item)}
+                  className="flex items-center gap-1 rounded-full bg-bg-tertiary px-3 py-1 text-c1 font-medium text-text-tertiary transition-colors hover:text-semantic-error"
+                >
+                  <Trash2 className="w-3.5 h-3.5" /> 删除
+                </button>
+              </div>
+            </div>
+          ))}
+        </div>
+      )}
+    </div>
+  );
+}

client/src/features/inbox/types.ts

@@ -0,0 +1,34 @@
+/**
+ * 统一收件箱类型 — 与 schema v9 inbox_items 表一一对应
+ * Unified inbox types — mirror schema v9 inbox_items 1:1
+ *
+ * @ai-context: 三路来源（clipboard 剪贴板收藏 / inspiration 灵感 /
+ * import 知识入籍）统一汇聚；status 三态（new 待沉淀 / settled 已沉淀 /
+ * archived 已归档）受 schema CHECK 约束，状态迁移可逆。
+ * @ai-context: Sources are CHECK-constrained in schema; status transitions
+ * are reversible (archive never deletes).
+ */
+
+/** 收件箱条目行结构（snake_case 直通 db IPC） */
+export interface InboxItem {
+  id: string;
+  source: 'clipboard' | 'inspiration' | 'import';
+  title: string;
+  content: string;
+  status: 'new' | 'settled' | 'archived';
+  created_at: string;
+}
+
+/** 来源元信息（UI 徽章与筛选共用） */
+export const SOURCE_META: Record<InboxItem['source'], { label: string; badge: string }> = {
+  clipboard: { label: '剪贴板', badge: 'bg-cyan-500/15 text-cyan-400' },
+  inspiration: { label: '灵感', badge: 'bg-amber-500/15 text-amber-400' },
+  import: { label: '导入', badge: 'bg-violet-500/15 text-violet-400' },
+};
+
+/** 状态元信息 */
+export const STATUS_META: Record<InboxItem['status'], { label: string; badge: string }> = {
+  new: { label: '待沉淀', badge: 'bg-emerald-500/15 text-emerald-400' },
+  settled: { label: '已沉淀', badge: 'bg-blue-500/15 text-blue-400' },
+  archived: { label: '已归档', badge: 'bg-bg-tertiary text-text-tertiary' },
+};