运维123 - 思维导图
type: channel
link: https://www.sddts.cn/index.php/category/%E6%80%9D%E7%BB%B4%E5%AF%BC%E5%9B%BE/
description: 思维导图
items: tmmpr 终端思维导图工具技术分析

tmmpr 终端思维导图工具技术分析
type: item
date: 2026-01-25T21:59:20+00:00
description: tmmpr 终端思维导图工具技术分析一、概述1. 项目简介A. 是什么tmmpr（terminal mind mapper）是一个基于 Linux 终端的思维导图应用程序，允许用户在无限画布上创建、组织和连接笔记。它将终端环境转变为数字白板，支持通过键盘高效操作。B. 核心价值在无图形界面环境中实现可视化思维整理纯键盘操作，符合 Vim 用户习惯轻量级实现，无需复杂的图形环境依赖C. 技术栈语言：Rust 2024 Edition框架：Ratatui 0.30.0（TUI 框架）终端处理：Crossterm 0.29.0数据序列化：Serde + Serde_json二、核心架构1. 应用结构graph TB A[main.rs] --> B[app.rs] A --> C[input.rs] A --> D[ui.rs] A --> E[states/] A --> F[utils/] E --> E1[StartState] E --> E2[MapState] E --> E3[SettingsState] C --> C1[事件处理] C --> C2[按键映射] D --> D1[render_start] D --> D2[render_map] D --> D3[render_settings]2. 状态管理应用采用状态机模式，通过 Screen 枚举管理三个主要界面：状态职责渲染函数Start启动界面，提供新建、打开、最近文件功能render_startMap核心思维导图编辑界面render_mapSettings设置配置界面render_settings3. 核心数据结构pub struct App { pub running: bool, // 主循环控制 pub screen: Screen, // 当前界面状态 } pub enum Screen { Start(StartState), Map(MapState), Settings(SettingsState), }三、工作原理1. 主循环机制sequenceDiagram participant M as main() participant T as Terminal participant A as App participant E as Event Handler participant R as Renderer M->>T: 初始化终端 M->>A: 创建 App 实例 loop 主循环 A->>E: handle_events() E->>A: 更新状态 A->>R: 判断是否需要重绘 alt 需要重绘 A->>T: terminal.draw() T->>R: 调用对应 render 函数 end A->>A: 检查 running 状态 end M->>T: 恢复终端2. 视口与画布系统无限画布实现坐标系统：正坐标空间（0,0 到无穷大）视口管理：通过 viewport_offset 控制可见区域导航方式：hjkl 键移动视口，H/J/K/L 快速移动渲染优化按需重绘：通过 needs_clear_and_redraw 标志控制增量更新：仅在状态变化时重绘界面四、功能模块1. 多模式操作tmmpr 采用类 Vim 的模式系统：模式功能切换键Normal视口导航、通用命令默认模式Visual选择和管理笔记v 键进入Visual (Move)移动笔记位置m 键切换Visual (Connection)管理笔记连接c/C 键切换Edit文本编辑i/a 键进入2. 笔记与连接系统笔记属性位置坐标（x, y）文本内容颜色标识连接端口（上下左右）连接管理支持多对多连接自定义连接颜色可配置连接侧边连接旋转和删除功能3. 数据持久化自动保存可配置自动保存间隔防止数据丢失备份系统打开文件时自动备份运行时定期备份可配置备份频率（每日、每周等）五、技术特性1. Rust 2024 Edition项目使用最新的 Rust 2024 Edition，这意味：采用最新的语言特性和优化改进的错误处理机制更好的编译器诊断2. 依赖分析从 Cargo.toml 可看出项目的精简设计：[dependencies] ratatui = "0.30.0" # TUI 框架 crossterm = "0.29.0" # 跨平台终端操作 color-eyre = "0.6.5" # 错误处理 serde = { version = "1.0.228", features = ["derive"] } serde_json = "1.0.149" # JSON 序列化 home = "0.5.12" # 目录路径解析 chrono = { version = "0.4.43"…