mindfs

人在外面,也能连回家里的 AI 智能体干活

开源 🏷️定价信息待确认 ⚠️ 链接可跳转,访问体验不确定 智能体 🍴 复刻 135 🐛 待处理 26
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 1886
维护状态 活跃
是否开源 开源
定价模式 🏷️定价信息待确认

项目预览

mindfs 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类智能体
开发团队a9gent
定价模式🏷️定价信息待确认
价格说明定价信息待确认
访问状态⚠️ 链接可跳转,访问体验不确定
是否开源是
开源协议AGPL-3.0
主要语言TypeScript
GitHub 星标★ 1886
上线时间2026-03-31 00:00:00
代码更新2026-11-06
仓库体积14.8 MB
本站数据更新2026-11-06
维护状态活跃
收录时间2026-09-22
浏览次数7

项目介绍

MindFS 是一个用 TypeScript 开发的开源项目,定位为个人 AI 智能体与工作站的远程访问层。它解决的核心问题是:用户在本机或服务器上跑着各种 AI agent、脚本和本地数据,但离开电脑后就无法查看进度、下发指令或调取文件。MindFS 把这些本地能力包装成可通过网络访问的服务,让你在手机、平板或另一台电脑上随时连接自己的 agent 和工作站数据。核心能力包括:统一的访问入口管理多个 agent 会话、远程读取工作站上的文件与运行状态、以及把本地算力和数据安全地暴露给授权设备。它适合自建 AI 工作流的开发者、需要随时盯任务进度的研究者,以及希望把个人 AI 助手随身携带的重度用户。项目处于成长阶段,星标约 1800,社区正在积累中。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-09-22 · 当前星标 ★ 1886

使用教程

难度:入门 约 10 分钟 部署方式:命令行工具 7 步

环境要求

  • 支持 macOS(Intel 与 Apple Silicon)、Linux(x86-64/ARM64/ARMv7)、Windows(x86-64/ARM64)
  • 运行已编译二进制无需 Node.js、Docker 或守护进程管理器
  • 安装包小于 10 MB,安装脚本会自动检测操作系统与架构
  • 仅从源码构建时才需要 Go 1.22+ 与 Node.js 20+

安装与启动步骤

  1. 1macOS/Linux 安装

    官方安装脚本会自动识别系统与架构,从 GitHub Releases 下载对应二进制并加入 PATH。

    curl -fsSL https://raw.githubusercontent.com/a9gent/mindfs/main/scripts/install.sh | bash
  2. 2Windows 安装

    在 PowerShell 中执行该命令,脚本同样会自动检测系统架构并完成安装。

    irm https://raw.githubusercontent.com/a9gent/mindfs/main/scripts/install.ps1 | iex
  3. 3自定义安装路径

    需要把二进制装到其他目录时,用 --prefix 指定路径,例如 /your/path。

    curl -fsSL https://raw.githubusercontent.com/a9gent/mindfs/main/scripts/install.sh | bash -s -- --prefix /your/path
  4. 4从源码构建

    仅在上一步不适用或想自行编译时使用,需 Go 1.22+ 与 Node.js 20+,产物为 ./mindfs。

    git clone https://github.com/a9gent/mindfs.git
    cd mindfs
    make build
  5. 5启动服务

    不带参数时管理当前目录,启动后监听本机端口,浏览器即可访问工作台。

    mindfs
  6. 6管理指定目录

    把某个项目目录交给 MindFS 管理,便于远程查看该目录下的会话与文件。

    mindfs /path/to/your/project
  7. 7自定义端口

    默认端口为 7331,如需修改用 -addr 指定监听地址与端口,例如 :9000。

    mindfs -addr :9000 /path/to/your/project

关键配置

配置项必填说明示例
-addr否指定服务监听的地址与端口,默认 7331:9000
--prefix否安装脚本参数,指定二进制安装路径/your/path

如何确认成功

启动后在浏览器打开 http://localhost:7331,能看到 MindFS 界面即表示运行成功。

常见问题

Q:需要先安装 Node.js 或 Docker 吗?

A:不需要。生产版是静态编译的单一二进制,内置全部 Web 资源,主机上无需 Node.js、Docker 或守护进程管理器。

Q:怎么修改默认端口?

A:启动时加 -addr 参数,例如 mindfs -addr :9000 /path/to/your/project,然后访问对应端口。

Q:如何卸载 MindFS?

A:重新下载安装脚本并以 --uninstall(Windows 为 -Uninstall)执行,会移除二进制、内置 Web 资源、默认 agents.json 及 PATH 条目。

Q:卸载会删除我的配置和数据吗?

A:默认保留用户配置和项目 .mindfs/ 数据;在 macOS/Linux 加 --purge(Windows 为 -Purge)可额外清理用户级配置与日志。

Q:源码构建需要什么环境?

A:需要 Go 1.22+ 和 Node.js 20+,克隆仓库后执行 make build,产物为当前目录下的 ./mindfs。

注意事项

  • 安装脚本从 release-notes.md 首行读取最新版本号,再下载匹配的二进制。
  • 项目内的 .mindfs/ 目录不会被自动删除,即使执行带 --purge 的卸载命令。
  • 自定义安装路径后请确认该路径已加入 PATH,否则可能无法直接运行 mindfs。

核心亮点

  • 把本地 agent 和工作站数据统一暴露成远程可访问入口,解决离开电脑就断联的问题
  • TypeScript 实现,前端开发者容易读懂和二次开发
  • 支持多设备访问同一套个人 AI 环境,手机也能查看任务进度

不足之处

  • 项目较新,远程访问的安全模型和权限控制细节需要自行评估
  • 文档和社区生态尚在早期,遇到问题可参考的案例有限

适用场景

  • 通勤路上用手机查看家里跑的 AI 任务进度并追加指令
  • 出差时远程调取工作站上的文件交给 agent 继续处理
  • 多台设备共享同一套个人 AI 智能体环境,随时切换使用

替代项目

OpenHands、Dify、n8n

上一篇:skillpack

下一篇:dothething

同类项目推荐

personal-agent-template 开源

三渠道个人 AI 助理,记忆需你点头才保存

Open-source template for a durable personal AI agent — web chat, Slack, Linear, and···

★ 483 2026-09-14
Director 开源

用智能体编排视频生成与编辑,自动化视频工作流

AI video agents framework for next-gen video interactions and workflows.

★ 1574 2026-08-09
autoresearch 开源

扔个问题给它,全网资料自动整理成报告

Claude Autoresearch Skill — Autonomous goal-directed iteration for Claude Code. Ins···

★ 6811 2026-08-09
jarvis-assistant-vocal 开源

说法语就能控灯光、开直播、打电话的本地语音助手

Assistant vocal local en francais : Claude ou Ollama (offline), domotique Hue, OBS, ···

★ 546 2026-09-15
golutra 开源

把多个AI助手拧成一股绳,自动跑完复杂活

Multi-agent AI orchestration platform for automation, workflows, and developer tools···

★ 3866 2026-08-09
OpenSwarm 开源

用 Discord 指挥 AI 开发团队,自动完成编码任务

OpenSwarm — Autonomous AI dev team orchestrator powered by Claude Code CLI. Discord···

★ 871 2026-08-09
tau 开源

一个能自动换模型干活的终端 AI 助手

Your adaptive AI agent for your work.

★ 425 2026-10-01
ai-factory 开源

告别繁琐配置,用规范驱动快速构建 AI 智能体。

You want to build with AI, but setting up the right context, prompts, and workflows ···

★ 1157 2026-08-09
Capsomnia 开源

把 Caps Lock 变成合盖不休眠的物理开关,一按即用

A tiny macOS app that turns Caps Lock into a physical keep-awake switch for closed-l···

★ 444 2026-08-09