前端

前端是 Motif 的 Tauri Webview UI,负责浏览 Vault、阅读论文、编辑 Markdown、导航反链/图谱,以及与本地 ACP Agent 对话。

技术选型

领域 选型 原因
应用 UI React 19 + TypeScript 组件化模型适合复杂桌面工作台,TypeScript 提供类型约束。
构建 Vite Tauri Webview 的快速开发服务器与生产构建。
样式 Tailwind CSS 4 + shadcn/ui 基于 token 的简约 UI 与可访问基础组件。
基础交互 Radix UI shadcn 组件底层的键盘与可访问性行为。
图标 Lucide React 适合桌面工具栏的紧凑图标语言。
Agent UI AI Elements Conversation、PromptInput、Sources、Reasoning、FileTree 等现成模式。
Markdown 编辑 Plate + @platejs/markdown 兼容 Markdown 的 WYSIWYG 编辑,并保留插件扩展空间。
PDF 阅读 react-pdf + pdf.js 根据 metadata 中的远程 URL 在应用内阅读论文。
图谱 react-force-graph-2d Canvas 力导向图,适合 Obsidian 式研究网络。
分栏 react-resizable-panels 实现桌面式可拖拽工作台面板。

布局模型

  • 左侧栏:Vault 文件树与 paper 元信息。
  • 中间栏:Markdown / PDF / HTML 视图切换。
  • 右侧 Preview:Markdown 渲染预览或当前 paper 的 NOTES.md
  • 可选右侧栏:Agent 或 Backlinks。
  • Backlinks 右侧栏:上方反链列表,下方 Graph 面板。

本分区文档

  • ui.md:布局、快捷键、设置、可访问性与交互规则。
  • components.md:AI Elements 组件清单与业务组件接入约定。

交叉引用