MindFS文件与Git指南：远程浏览项目文件、查看提交历史一页全搞定-平芜编程栈

【免费下载链接】mindfs

Access your personal AI agents and workstation data anywhere, anytime through MindFS.

项目地址：https://gitcode.com/gh_mirrors/mi/mindfs

MindFS是一个 AI Agent 远程访问网关，让你随时随地在浏览器里管理工作站上的项目。它内置了完整的文件浏览器和Git 可视化面板：远程浏览项目文件树、预览 Markdown / 图片 / 代码，查看 Git 提交历史、分支状态与代码 Diff——打开一个页面就能全部搞定，无需再开终端敲命令。

概览：一个页面管理文件与Git

MindFS 以单个静态二进制文件分发，安装包不到 10 MB，不依赖 Node.js、Docker 或任何守护进程管理器，支持 macOS（Intel + Apple Silicon）、Linux 与 Windows 全平台。启动后所有数据默认存放在项目目录的.mindfs/中，实现完全自托管。

mindfs /path/to/your/project

随后在浏览器打开http://localhost:7331即可使用；配合中继模式（Relay）还能在公网任意设备访问本地实例，全程无需开放防火墙端口。

远程浏览项目文件：文件树+专用预览器

MindFS 的文件树浏览器支持全目录导航与文件预览，不同格式拥有专属渲染器：

文件类型	预览效果
Markdown	完整渲染，含目录大纲
图片 / 二进制	专用查看器，支持缩放
代码文件	高亮展示，支持行号引用

几个对新手特别友好的细节：

多项目管理：可同时挂载多个目录，会话按项目隔离，互不干扰。
文件 ↔ 会话双向关联：从任意文件一键跳转到创建它的 AI 会话，或从会话查看它改动过的全部文件——排查"这行代码是谁写的"效率极高。
@ 引用文件：在输入框输入@触发路径补全，直接把文件作为上下文交给 Agent。
文件操作：重命名、删除、上传、目录排序等常用操作都集成在文件树中。

文件树的完整前端实现位于 FileTree.tsx，文件读取与预览服务在 file.ts，Git 相关的数据接口封装在 git.ts。

移动端也能用：浏览器 PWA 直接"装"进手机

MindFS 提供移动优化 UI：底部操作栏放在拇指可及范围、独立面板支持滑动切换、输入框自适应软键盘。通过浏览器 PWA 或 Android 应用即可把 MindFS 装到手机主屏幕，原生体验、无需应用商店。

查看Git提交历史：一键展开每次改动的文件

MindFS 内置的Git 历史面板把终端里的git log变成可视化的卡片列表：

提交列表：按时间倒序展示 hash、提交信息与相对时间（如41m、11h），支持"加载更多"翻页；
展开提交：点击任意提交，自动拉取该 commit 变更的文件清单，标注每个文件的新增/删除行数（绿色+/ 红色-）；
状态着色：A新增、D删除、R重命名、M修改、??未跟踪，颜色区分一目了然。

实现上，前端 GitHistoryPanel.tsx 负责渲染列表与展开逻辑，展开时才按需请求该 commit 的文件列表，避免一次性拉取大量数据。

Git状态面板：分支、暂存与提交都在鼠标范围内

Git 状态面板相当于把git status可视化，同时提供常用操作：

🌿分支切换：下拉菜单列出所有本地分支，一键切换当前分支；
📦暂存/弃改：对单个文件执行 stage 或 discard；
🚀Commit / Pull / Push：面板内直接输入提交信息并提交，无需离开页面；
🔢行数统计：每个改动文件旁显示精确的新增与删除行数。

对应源码见 GitStatusPanel.tsx。

Git Diff 可视化：统一视图与并排视图

点击状态面板或提交历史中的任一文件，会打开Git Diff 查看器：

支持**统一视图（Unified）与并排视图（Side by Side）**两种排版，可自由切换；
红删绿增的行高亮之外，还带词级差异标注，行内改动的具体位置一眼可见；
面包屑导航可直接跳转文件路径；关联的 AI 会话会显示在旁——哪个会话改了这个文件，点一下就能看回去。

相关实现见 GitDiffViewer.tsx 与行级差异算法 gitDiffModel.ts。

幕后揭秘：MindFS 如何执行 Git 命令

MindFS 的后端 Git 模块位于 gitview.go。它的思路非常直接：

定位仓库：从管理的目录向上查找 git 仓库根目录；
执行命令：调用系统git获取状态、日志、Diff 等信息；
结构化输出：把命令输出解析成标准 JSON（如HistoryItem含 hash、message、commit_time），供前端渲染。

因此它不依赖任何 Git 库或额外服务，只要系统装了git就能工作；非仓库目录会自动降级为"Git 不可用"，不影响文件浏览功能。

写在最后

需求	MindFS 能力
远程看项目文件	文件树 + 多格式预览 + 多项目隔离
查看提交历史	Git 历史面板，展开即看文件级改动
管理分支与暂存区	状态面板一键切换分支、commit、push
审查代码改动	词级 Diff，统一/并排双视图
手机办公	PWA 安装，移动端优化 UI

从"远程浏览文件"到"审查每一次提交"，MindFS 把文件与 Git 的日常操作浓缩进一个页面。安装启动后，你甚至不需要记任何新命令——所有操作都在鼠标（或手指）可及之处。