.windsurfrules 是什么？
Windsurf 的规则文件和文件夹
你在用 Windsurf 这个 AI IDE,或者在仓库里瞄到一个 .windsurfrules。它是你给 Windsurf 项目规则的方式:关于技术栈、约定、命令的指令,让它的 agent 照你想的方式在你项目上干活。
和 Cursor 一样,Windsurf 这东西有新旧两种形态:一个 .windsurfrules 文件,或一个装 Markdown 文件的 .windsurf/rules/ 文件夹。这就是每种是什么、里面写什么。
两种形态：旧的文件，或 .windsurf/rules/ 文件夹
- 仓库根一个
.windsurfrules文件——旧做法,所有规则放一处。 - 一个
.windsurf/rules/文件夹——新形态,装几个 Markdown 文件、Windsurf 一起加载,一个主题一个。规则一多,这样更整齐。想让这样一个文件夹保持好读,看 md 文件怎么整理。
不管哪种,内容一样,而且全是 Markdown。
里面写什么
.windsurfrules 装的和每个 AI 规则文件一样:你的技术栈和架构、代码约定和风格、要跑的命令、以及 agent 该碰和不该碰的边界。它是纯 Markdown,就是用标题和列表描述你的项目。要写一个,语法看 Markdown 怎么写。
.windsurfrules 和其他规则文件
几乎每个 AI 编程工具都有自己这么一个文件。.windsurfrules 是 Windsurf 的:
| 工具 | 它的规则文件 | 出自 |
|---|---|---|
| Windsurf | .windsurfrules 或 .windsurf/rules/*.md | Codeium 的 AI IDE |
| Cursor | .cursorrules 或 .cursor/rules/*.mdc | Cursor 编辑器 |
| Cline | .clinerules（文件或文件夹） | VS Code 编程 agent |
| 跨工具 | AGENTS.md | 通用开放标准 |
按工具的完整地图看 我的 AI 工具读哪个规则文件;最近的近亲看 .cursorrules 是什么 和 .clinerules 是什么;跨工具标准看 AGENTS.md、CLAUDE.md 是什么。
用 NoteLoom 读、改 .windsurfrules
.windsurf/rules/ 文件夹天生合 NoteLoom,因为一个装 Markdown 文件的文件夹正是它擅长打开的。在浏览器里挂载那个文件夹,NoteLoom 把每个 .md 渲染成干净的 reading 视图,用文件树在它们之间切换,用 source 视图改、存回本地。规则文件一多,也好读、好收拾。
先说清边界:NoteLoom 没有任何 AI,也不连接 Windsurf 或任何编程工具。它只打开、渲染、存回本地的 Markdown 文件;agent 听不听规则,在你和 Windsurf 之间。
用起来:用 Chrome / Edge / Arc 打开 app.noteloom.cc,挂载你的 .windsurf/rules/ 文件夹本身(直接选这个文件夹、别选它的父目录),读或改里面的 .md 文件。直接存回本地,不上云、不用账号。
FAQ
.windsurfrules 文件是什么？
.windsurfrules 和 .windsurf/rules/ 有什么区别？
.windsurfrules 该写什么？
.windsurfrules 和 .cursorrules、AGENTS.md 一样吗？
NoteLoom 能打开 .windsurf/rules/ 文件夹吗？
手机或 Safari 能用 NoteLoom 弄吗？
打开你的 .windsurf/rules 文件夹读一遍
用 Chrome / Edge / Arc 打开 NoteLoom,挂载你的 .windsurf/rules/ 文件夹,在干净视图里读或改里面的 Markdown 规则文件。直接存回本地,不用装软件,也不用注册账号。