Files.md核心主张在 AI 时代你的第一大脑比第二大脑更重要。一、项目定位私人思考的静谧空间Files.md是一款**本地优先Local-first**的 Markdown 笔记应用其核心设计理念可以概括为极简主义只保留必要功能“限制激发创造力”隐私至上数据不离开设备无需服务器LLM 友好纯.md文件格式便于 AI 助手理解与扩展⚡零依赖无需安装浏览器即可运行支持离线使用用作者的话说“以纯本地文件形式拥有你的数据以自控软件打开这些文件。用文件和你的大脑来增长知识用 LLM 来扩展软件。纯文件和自控软件可以穿越时代。”二、技术架构亮点2.1 本地优先架构Local-first Architecture存储模式数据位置跨设备同步服务器需求适用场景纯本地模式设备本地文件夹❌ 无无需服务器最大隐私保护云文件夹同步iCloud/Dropbox/Google Drive✅ 有云服务商托管无需自建服务器自托管同步服务器自建服务器✅ 有单个 Go 二进制内网设备同步托管同步服务api.files.md✅ 有官方托管即开即用2.2 文件结构规范项目采用预定义但灵活的目录结构 根目录 ├── Chat.md # 聊天记录快速捕获入口 ├── brain/ # 知识笔记 │ └── Note.md ├── category/ # 分类目录 ├── Read.md # 待读清单 ├── Watch.md # 待看清单 ├── Shop.md # 购物清单 ├── Later.md # 待办事项 ├── journal/ # 日志记录 │ └── 2024.08 August.md ├── habits/ # 习惯追踪 ├── media/ # 图片资源 ├── archive/ # 归档 └── config.json # 配置文件2.3 性能考量作者对性能有着深刻理解Mutex lock/unlock 25 ns 从 SSD 随机读取 4K 150,000 ns 1 ms 1,000,000 ns结论文件系统和互斥锁的性能开销在实际应用中可忽略不计不必过度优化。三、核心交互设计3.1 聊天式快速捕获Chat-like Flow应用采用类聊天界面的交互模式打开聊天窗口发送消息选择存储位置笔记、日志、任务、清单消息自动保存为.md文件条目这种设计降低了记录想法的认知负担——懒人思维捕获的最佳实践。3.2 Telegram Bot 集成提供 Telegram 聊天机器人FilesMDBot实现移动端快速记录无干扰写入入口跨平台消息同步3.3 快捷键设计快捷键功能[插入文件链接CmdK文件搜索CmdN新建文件CmdM移动文件CmdD删除文件CmdEnter打开聊天Cmd]/Cmd[前后文件导航四、第二大脑批判性反思4.1 问题延迟思考的陷阱作者引用 Joan Westenberg 的观点“越复杂的系统越多地将思考工作推迟给’未来会整理的自己’——但那个自己从未到来。”PKM个人知识管理工具的常见陷阱Obsidian 的图谱视图营造全知幻觉复杂的模板和插件提供虚假的掌控感每添加一条笔记带来多巴胺但第一大脑并未提升4.2 解决方案主动思考而非被动收集在使用 Files.md 的过程中作者提出以下原则从零结构开始不要预设文件夹每条笔记一个想法脱离上下文也能理解立即应用新知识不为未来的自己囤积链接相关笔记形成知识网络定期回顾并深入思考关键洞见工具不重要你的思考才重要。4.3 笔记可能导致的经验缺失作者警示阅读和笔记容易让我们误以为自己理解了我们知道但并未真正理解或实践知识成为障碍——拒绝新体验因为已经知道疗愈情感创伤必须通过情感层面而非阅读笔记。五、深度思考方法论5.1 作者的实践路径作者分享了自己产生洞见的具体案例在brain和dev文件夹记录新想法在 Web App 中链接相关笔记输入[反复浏览笔记并深入思考发现跨领域连接如脑科学 软件开发产生洞见并撰写文章如 Cognitive Load in Software Development)5.2 添加笔记前的三问每次记录新知识时问自己这如何 sharpen 我的判断力或扩展我的分类体系这如何让我以不同视角看待世界这如何让我采取不同行动六、工程哲学与代码准则6.1 设计原则代码量越少灵活性越高避免不必要的依赖所有依赖纳入vendor目录10 年后打开/web/index.html仍可直接运行无构建系统每个 PR 应减少或简化代码而非增加6.2 后端规范编写测试不使用get*前缀错误是业务逻辑的一部分不 panic使用错误包装添加方法上下文真实实现优于 Mock/Stub6.3 前端规范使用PATCHED标记就地修改的库避免竞态条件异步流程中断禁止构建系统——保持纯 HTML/JS6.4 术语表Glossary术语定义filename文件名含扩展名如note.md作为 ID 使用header去除扩展名并大写的文件名如Notebody文件内容dir分类目录如happinessuserID实际为chatIDctime元数据变更时间权限、位置、重命名mtime内容修改时间用于同步七、架构决策记录ADR精选项目采用ADRArchitecture Decision Records记录关键决策时间决策内容2026.05.20添加 LaTeX 支持20 字体文件文本 数学覆盖绝大部分场景2026.05.06Today.md→Chat.md用户更易理解聊天概念2025.09.21从[[wikilinks]]回归标准 Markdown 链接确保跨平台兼容2025.06.29所有消息默认进入Chat.md简化默认流程2025.06.14使用 WASM 复用 Go 代码后被移除改用 JS 实现2024.11.11移除 Wikilinks 支持仅用纯 Markdown 链接2024.08.08尽早清洗原则——数据一进入就清洗而非在 Path 方法中八、实用脚本工具项目提供一系列命令行工具位于cmd/目录# 向日志添加 Whoop 健身数据go run /abs/path/to/files.md/cmd/whoop/whoop.go# 将 Wikilinks 转换为 Markdown 链接go run /abs/path/to/files.md/cmd/tomdlinks/tomdlinks.go.# 插入反向链接go run /abs/path/to/files.md/cmd/backlink/backlink.go# 调整日志时间戳时区变更后使用go run /abs/path/to/files.md/cmd/shifttime/shifttime.go九、LLM 集成友好性项目提供 files.md/llms.txt可复制到CLAUDE.md或AGENTS.mdAI 助手可理解项目结构可基于用户需求扩展功能一个人或一个 LLM 可以将整个项目放入脑海十、总结Files.md 的核心价值主张设计哲学金字塔 隐私 ↑ 深度思考 ↑ ⚡ 极简交互 ↑ 纯文件格式 ↑ ️ 自控软件适用人群Zettelkasten / 第二大脑实践者日志记录者任务与清单管理需求者重视隐私、讨厌复杂工具的人愿意用大脑思考而非囤积笔记的人项目的终极愿景“在 AI 时代第一大脑依然如往昔般珍贵。”附录快速开始打开 app.files.md推荐 Chrome点击地址栏右侧安装 Files.md选择本地文件夹以持久化数据使用CmdShiftR强制刷新获取更新参考资料主站files.mdGitHubzakirullin/files.md作者文章Cognitive Load in Software Development相关文章I Deleted My Second Brain
