架构概览¶

Tinyleaf 是一个完全基于 Python 标准库构建的 Web 应用。

组件结构¶

graph TB
    subgraph 浏览器
        CM[CodeMirror 6 编辑器]
        PDF[PDF.js 预览]
        PP[项目页面]
    end
    subgraph 服务端["Python HTTP 服务器"]
        S[ThreadingHTTPServer]
        H[handlers.py — 路由与 API]
        R[registry.py — 项目注册表]
        C[compiler.py — LaTeX 编译]
        G[git_ops.py — Git 操作]
        V[vendor.py — JS 模块管理]
    end
    浏览器 -- "HTTP / SSE" --> S
    S --> H
    H --> R
    H --> C
    H --> G
    H --> V

模块概览¶

模块	职责
`cli.py`	CLI 参数解析、服务器启动
`server.py`	HTTP 路由、静态文件服务、SSE 支持
`handlers.py`	API 请求分发、文件操作、项目管理
`registry.py`	线程安全的项目注册表 CRUD（`projects.json`）
`compiler.py`	LaTeX 编译任务（本地或 Docker）
`git_ops.py`	Git status、diff、commit、push、pull、log
`vendor.py`	下载和管理本地 JS 模块（CodeMirror、PDF.js）

关键设计决策¶

零依赖 — 后端仅使用 Python 标准库
精简前端 — HTML 标记、CSS 和 JS 分别拆分为 index.html、css/app.css 和 js/app.js，无需构建步骤
SSE 编译流 — 通过 Server-Sent Events 实时推送编译日志
注册表模式 — 项目通过名称到路径的映射存储在 JSON 文件中，而非目录列举
线程安全 — 使用 threading.Lock + 原子 os.replace 确保并发安全
本地 JS 模块 — CodeMirror 6 和 PDF.js 在首次启动时下载到本地，CDN 作为回退