Movi MCP v1

fileman

杂乱文件夹输入，井然有序的资料库输出

你将获得什么 • 安装 • 工作原理 • 生态系统

---

fileman 是一款本地优先的文件整理工具。放入一个杂乱的文件夹，即可获得清单、整理方案和一键应用功能。未经你同意，原始文件绝不会移动。

┌──────────────────────────────────────┐
│  LOCAL-FIRST          ████████ 100%  │
│  SOURCE-TRACEABLE     ████████ 100%  │
│  TYPING REQUIRED      ░░░░░░░░   0%  │
│  VIBES                ████████ ZERO  │
│                                FILLER│
└──────────────────────────────────────┘

AI 辅助文件分类。以清单为先，绝不破坏原文件。

你将获得什么

界面	内容
fileman cli	扫描、规划并生成清单。只有你点头后才会应用。
fileman webui	浏览整理方案。批准、编辑，或退回重新处理。
fileman mcp	同一套引擎，以 MCP 服务形式提供，供任何 Agent 使用。
contracts & manifest	方案可比较差异、可审核，也可作为凭据。
public skills	安装到 Claude/Codex/OpenClaw。交给它一个文件夹，即可获得一个资料库。

重要

默认采用本地优先模式。不进行隐蔽遥测，不往返云端。除非你明确将数据发送到别处，否则数据始终留在你的设备上。

安装

git clone https://github.com/xiaojiou176-open/fileman.git
cd fileman
# follow the per-stack quickstart in INSTALL.md or docs/

三条命令。不用 curl | sh，无需登录。运行前先看清要运行的内容。

安装遇到问题？打开你常用的 Agent，对它说 "Read AGENTS.md and bootstrap fileman for me."。让 Agent 自己修复。详细说明请见：docs/。

工作原理

这个仓库分为七层，恰好对应 git log 中的七次提交。新工作以小型、命名明确的 PR 提交。不搞 50 个文件、内容不明的神秘提交。

层	内容
chore: scaffold	许可证、治理规范、质量门禁和 CI 脚手架。
feat(core)	核心引擎，也是 fileman 存在的理由。
feat(modules)	软件包、适配器、服务和插件。第二层楼。
feat(contracts)	架构、配置和公开边界。其他代码在这里交互。
test:	凭据。本层中的所有内容都必须可以运行。
feat(ops)	脚本、基础设施、CI 辅助工具和构建连接代码。
docs:	面向公众的文档。漂亮的门面。

git log 就像一张楼层平面图。看一眼，就能了解整体结构。

生态系统

fileman 属于 yard 家族：七个 yard，同一种理念：结构化输入、结构化输出、结构化证明。

仓库	内容
switchyard	模型和 Agent 运行时切换面板
browserclickyard	你的 AI 负责点击，浏览器听从指令
noteyard	你的 Apple Notes 永远不会真正消失
dealyard	让价格互相竞争，你只需坐着旁观
docyard	输入文档网站，输出 Markdown，无需手动抓取
fileman (你正在这里)	杂乱文件夹输入，井然有序的资料库输出
proofyard	每项声明都附带凭据

跨家族精选： BeamMe · BrewMe · OpenVibeCoding · proofyard.

为这个仓库点个 Star

如果 fileman 帮你省下了一次点击、一个小时或一场头疼，那点个 Star 又不花钱。公平交易。⭐

Yifeng[Terry] Yu 的其他项目

• switchyard — 模型和 Agent 运行时切换面板
• browserclickyard — 你的 AI 点击，浏览器听从
• BeamMe — 将你的 Agent 配置传送到任意星球
• BrewMe — 一觉醒来，新闻已经泡好
• OpenVibeCoding — AI 通宵编码，你早上发布

许可证

MIT — 小字条款，大自由。