Project Graph：节点图思维整理工具

项目简介

Project Graph 是一款用于头脑风暴、知识整理与项目规划的桌面节点图工具。它不要求你的想法只有一个中心、一个方向或一种层级：你可以先把零散的想法放上画布，再通过连接、分组与布局逐步梳理关系，在无限画布上从局部细节走向整体结构。

应用使用 React + TypeScript + Tauri 构建，画布基于 Canvas 2D，可运行于 Windows、macOS 与 Linux。

主要功能

一张画布可以承载多种表达方式：

你想做的事	可以使用的能力
整理阅读笔记与知识体系	文本、图片、LaTeX 公式、引用块和嵌套分组
分析系统、流程与依赖	树形结构、网络关系、多种连线与自动布局
快速记录与展开思路	键盘生长节点树、自定义快捷键、涂鸦
汇集不同形式的材料	拖入文字、图片、音频和视频
按自己的习惯工作	深浅主题、可配置菜单与 JavaScript 扩展

思路跟得上输入速度：通过键盘向不同方向展开节点树，再用画布调整布局，适合边阅读边整理、快速拆解问题，以及记录不断分叉的想法。

从画图到自己的工作流：

• 组织与连接：分组框、双向引用和孪生关联，帮助内容跨越单一层级。
• 保存与恢复：撤销、重做、自动保存和备份，支持持续整理工程。
• 导入与导出：在画布与文本等格式之间转换，配合已有工具使用。
• 扩展能力：通过 JavaScript 添加快捷键、节点类型、对话框和主题。

安装与使用

1. 前往最新正式版或官网下载页，选择适合系统的安装包。
2. 新建工程，创建节点、连接内容，或拖入已有材料。
3. 阅读使用文档，了解移动缩放、节点树与快捷键。

如果想从源码运行，需要准备 Node.js 26+、项目指定版本的 pnpm、Rust，以及 Tauri 对应平台的系统依赖：

git clone https://github.com/graphif/project-graph.git
cd project-graph
pnpm install
pnpm dev

pnpm dev 启动桌面开发环境，由 Tauri 自动启动 Vite 并等待 http://localhost:1420 就绪，无需在另一个终端重复启动前端。常用命令：

命令	用途
pnpm dev	启动桌面开发环境
pnpm --filter @graphif/project-graph dev	仅启动前端开发服务
pnpm --filter @graphif/project-graph type-check	TypeScript 类型检查
pnpm test	运行测试
pnpm lint	检查代码规范

注意事项

• 正式版以 Releases 为准，开发中的改动与待验收问题记录在更新日志中，不代表已经发布。
• 前端服务断开后，已打开的桌面窗口可能继续显示旧页面；1420 是固定端口，冲突时会直接报错而不会自动切换。
• 首次运行测试或修改 Rust 所有权辅助程序后，需先运行 cargo test --manifest-path app/src-tauri/Cargo.toml --test project_ownership_helper 准备本地辅助程序，再运行 pnpm test。
• 桌面应用使用 GPL-3.0 许可证，工作区内各复用包的许可证请查看对应目录中的 LICENSE。

---

本作品整理自 GitHub 开源项目 graphif/project-graph，原作者 @graphif。中文介绍由 AI 根据项目 README 整理，以原仓库为准。