ThinkTank 是一个以“项目”为管理单元的全栈 Markdown 文档系统。它旨在提供纯粹、高效的文档管理和写作体验。
github地址:https://github.com/cookiejoo/ThinkTank
🔥 核心亮点
Git 仓库镜像 (只读模式):配置 Git 仓库地址,定时自动拉取文档,适合作为团队知识库展示。
在线编辑 (读写模式):创建本地项目,支持在线新建、编辑、删除文档,实时同步到文件系统。
🌟 项目定位
物理层:直接基于磁盘
.md文件树(Source of Truth),数据完全掌控在自己手中。逻辑层:纯文件驱动、轻量级索引,支持成员权限与 AI 向量数据。
体验层:集成了 Vditor 所见即所得编辑器与 react-arborist 高性能文件树,提供流畅的交互体验。
✨ 更多功能
1. 文档编辑与预览
所见即所得:集成 Vditor 编辑器,支持 Markdown 源码对照、大纲导航。
高性能文件树:支持拖拽排序、右键菜单(新建、重命名、删除、隐藏)、状态持久化。
沉浸式阅读:提供纯预览模式 (
/view),专注于内容阅读。可见性控制:支持文档隐藏,灵活管理文档展示。
2. AI 辅助 (Copilot)
智能写作:支持
/ai命令,提供内容续写、润色与纠错功能。项目知识库:自动扫描项目文档,构建上下文,让 AI 更懂你的项目。
🛠️ 技术栈
框架: Next.js 14+ (App Router)
语言: TypeScript
样式: Tailwind CSS
编辑器: Vditor
文件树: react-arborist
后端逻辑: Node.js (
fs-extra,chokidar)Git 操作:
simple-gitAI 引擎: Vercel AI SDK
图表: Mermaid
图标: Lucide React
🚀 快速开始
1. 环境准备
确保你的本地环境已安装 Node.js (推荐 v18+)。
2. 安装依赖
npm install
# 或者
yarn install
# 或者
pnpm install
3. 配置环境变量
在项目根目录创建 .env 文件,并配置文档存储根路径:
THINKTANK_STORAGE_ROOT=./storage
4. 启动开发服务器
npm run dev
打开浏览器访问 http://localhost:3000 即可开始使用。
📸 项目截图
以下是 ThinkTank 的界面预览:


📂 项目结构
.
├── src/
│ ├── app/ # Next.js App Router 页面
│ ├── components/ # React 组件 (UI, Editor, FileTree)
│ └── lib/ # 工具函数 (Git, Files, Utils)
├── storage/ # 默认文档存储目录 (可配置)
├── docs/ # 项目文档
│ └── images/ # 截图资源
├── public/ # 静态资源
├── .env # 环境变量配置
└── package.json # 项目依赖与脚本