development tech stack

技术栈

适用版本：1.7.0　|　最后核对：2026-09-05

---

总览

层级	技术	版本
桌面框架	Tauri	v2
前端框架	React	19
语言	TypeScript	6
构建工具	Vite	8
样式方案	TailwindCSS	4（CSS-first，无配置文件）
富文本编辑器	TipTap	3.26
状态管理	Zustand + Jotai	5 / 2.20
路由	React Router	v7
后端语言	Rust	2021 Edition
数据库	SQLite（rusqlite bundled）	WAL 模式
连接池	r2d2	—
Agent 引擎	Rust 原生（commands/agent/）	v1.1 起内嵌，无需 Python
包管理（前端）	pnpm	≥ 11

---

前端依赖

核心框架

依赖	说明
react / react-dom	UI 框架
react-router-dom	SPA 路由（v7，懒加载页面）
@tauri-apps/api	Tauri 前端核心 API

状态管理

依赖	说明
zustand	领域业务状态（booksStore / aiStore / preferencesStore / taskCardsStore / vocabStore / ttsConfig / pluginStore）+ appStore 汇聚出口
jotai	UI 原子状态（stores/uiAtoms.ts 21 个 + lib/toast.ts 2 个 = 23 个 atom）

富文本

依赖	说明
@tiptap/react / @tiptap/starter-kit	编辑器核心与基础扩展
@tiptap/extension-*	表格（4 件套）、图片、颜色、文本样式、下划线、任务列表、字符计数
@tiptap/extension-code-block-lowlight	代码块语法高亮
lowlight	语法高亮引擎（common 语言集；工具栏 CODE_LANGUAGES 暴露 34 种）
katex	LaTeX 数学公式渲染

UI 工具

依赖	说明
clsx	类名合并（src/lib/utils.ts 的 cn()；项目未引入 tailwind-merge）
class-variance-authority	组件变体管理
lucide-react	图标库
react-markdown + remark-gfm	AI 消息的 Markdown 渲染（含 GFM 表格/删除线）
react-diff-viewer-continued	版本快照 diff 对比
@tanstack/react-virtual	虚拟化滚动（书库、大纲面板）
@dnd-kit/core + @dnd-kit/utilities	大纲拖拽排序、任务卡看板拖拽（v1.5.0）
react-image-crop	图片裁剪对话框

工具函数

依赖	说明
date-fns	日期处理

---

Tauri 插件

插件	用途
tauri-plugin-http	HTTP 请求（AI API 调用）
tauri-plugin-dialog	原生文件对话框
tauri-plugin-fs	文件系统访问
tauri-plugin-shell	Shell 命令执行
tauri-plugin-updater	应用更新
tauri-plugin-deep-link	深度链接（com.ukcoder.timewrite://）
tauri-plugin-notification	系统通知（任务卡提醒中心，v1.5.0）

---

Rust 依赖

Crate	用途
tauri	应用框架 + 事件推送
rusqlite（bundled）	SQLite 数据库
r2d2 + r2d2_sqlite	连接池（max_size=10）
serde / serde_json	序列化（统一 camelCase）
reqwest	HTTP 客户端（stream / rustls-tls / gzip / brotli）
futures-util	异步流处理（StreamExt）
tokio	异步运行时
uuid	UUID 生成
chrono	时间处理
aes-gcm	AES-256-GCM 备份加密
sqlite-vec	KNN 向量检索（chunks_vec 镜像表，语义检索由全量内存余弦改为 SQLite KNN，v1.6.0）
anyhow	错误处理

---

Python 依赖（Agent 服务）— v1.1 起已移除

v1.0 的 Python Agent（FastAPI @9877）与 Bridge（tiny_http @9876）已随 Agent 迁移整体移除： agent/ 目录、scripts/setup-agent.ts、scripts/check-python-versions.ts 均已删除， 应用不再需要任何 Python 运行环境。Rust Agent 引擎依赖见上表（reqwest / tokio 等）。

---

工程化工具

工具	说明
scripts/check.mjs	项目完整性自检（200 项，支持 --fast）
scripts/check-npm-versions.ts / check-rust-versions.ts	前端 / Rust 依赖版本校验
scripts/node-manager.ts	Node 版本管理
scripts/clean.ts	构建产物清理

---

相关文档

• 项目结构
• 状态管理
• Agent 架构