development tech stack - WangYajun369/ai-writing-platform GitHub Wiki
技术栈
适用版本：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 |
图片裁剪对话框 |
工具函数
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 |
构建产物清理 |
相关文档