Motif 文档

Motif 是一个本地优先、Agent-first 的科研工作台，由 Tauri 桌面 Host、React 前端和普通文件组成的 Vault 数据模型构成。本文档按工作边界分层：前端 UI、后端/Host 数据契约、开发与产品流程。

技术框架

Motif 桌面应用
├── Frontend Webview
│   ├── React 19 + TypeScript + Vite
│   ├── Tailwind CSS 4 + shadcn/ui + AI Elements
│   ├── Plate Markdown 编辑
│   ├── react-pdf / iframe 阅读器
│   └── react-force-graph-2d 图谱面板
├── Tauri Host
│   ├── Rust + Tauri 2 commands/events
│   ├── 文件系统访问与 Vault IO
│   ├── 双链 / 反链 / 图谱索引
│   ├── 面向 BYOA Agent 的 ACP Client
│   └── 本地配置与可重建缓存
└── Vault
    ├── Markdown 文件与 paper notes
    ├── metadata.json 作为论文元数据事实来源
    ├── papers/<id>/source/ 下的原始来源文件
    └── .motif/cache.sqlite 作为可重建缓存

文档分层

分层 目录 说明
前端 frontend/ 工作台 UI、组件约定、AI Elements 接入、右侧栏行为。
后端 backend/ Tauri command 契约、Vault 数据模型、双链/反链/图谱索引。
测试 test/ 前端 Vitest、Rust 单测、临时 Vault fixture 与验证策略。
开发 development/ 产品需求、路线图、实现 backlog、发布与开发流程。

当前 UI 形态

  • 默认工作台为三栏：文件树、中间内容、Preview/Notes。
  • 可选右侧栏只有两个顶层入口：Agent 与 Backlinks。
  • Backlinks 视图上方显示反链，下方显示 Graph；Graph 不是独立顶层 tab。

关键三方技术

领域 三方库 / 服务
桌面 Host Tauri 2、Rust
前端运行时 React、TypeScript、Vite
样式与 UI Tailwind CSS、shadcn/ui、Radix UI、Lucide
Agent UI AI Elements、Streamdown、Agent Client Protocol
编辑器与阅读器 Plate、react-pdf、pdfjs-dist
图谱 react-force-graph-2d
文档站 MkDocs + Read the Docs 主题

推荐阅读顺序