---
title: "Devin Desktop (Windsurf) rules：路径和格式 · DotsAgent"
description: ".devin/rules/*.md 的存放位置、格式和 front matter，全局副本与嵌套副本的合并方式，以及哪些工具会读取它。核验日期：2026-10-01。"
url: https://dotsagent.io/zh/instructions/files/windsurf-rules
---

.devin/rules/*.md

# Devin Desktop (Windsurf) rules：存放位置及工具读取方式

自 2026-06-02 起，Windsurf 更名为 Devin Desktop。它会从 .devin/rules/ 读取规则文件，同时仍支持 .windsurf/rules/ 和旧版 .windsurfrules。每条规则是否生效取决于其触发方式：始终生效、按 glob 匹配、由模型选择或手动调用。

## 存放位置

- 工作区：.devin/rules/*.md（首选）或 .windsurf/rules/*.md（备用）。
- 旧版单文件：工作区根目录下的 .windsurfrules，仍会读取。
- 全局：~/.codeium/windsurf/memories/global_rules.md，始终生效。
- 任意目录中的 AGENTS.md。
- 系统级（Enterprise）：/Library/Application Support/Devin/rules/*.md、/etc/devin/rules/*.md 或 C:\ProgramData\Devin\rules\*.md。

## 格式

使用 Markdown；工作区规则以 YAML frontmatter 开头。trigger 可设为 always_on、model_decision、glob 或 manual；glob 规则需提供 glob 模式，model_decision 规则需提供 description。global_rules.md 上限为 6,000 个字符，每个工作区规则文件上限为 12,000 个字符。

Front matter 键： `trigger``globs``description`

`.devin/rules/*.md`

```
---
trigger: glob
globs: **/*.test.ts
---

# Test files

- Use Vitest and import describe, it and expect explicitly.
- Test one behaviour per case and name it in plain English.
- Mock network calls with the helpers in test/mocks/.
- Never call real payment APIs from a test.
```

## 优先级与合并

.devin/ 的优先级高于 .windsurf/。系统规则会与工作区规则和全局规则合并，不会覆盖它们；global_rules.md 和根目录下的 AGENTS.md 始终生效。规则会从工作区、其子目录以及一直到 git 根目录的父目录中查找。

## 可读取该文件的工具

| 工具 | 支持情况 |
| --- | --- |
| [Cline](https://docs.cline.bot/features/cline-rules) | 会检测旧版 .windsurfrules 文件。 |

## 提示

- 在 .devin/rules/ 中创建新规则；仅为旧版安装保留 .windsurf/rules/。
- 对于仅在相关时才应由 agent 引入的指导内容，使用 trigger: model_decision，并提供清晰的 description。
- 自动生成的 Memories 仅适用于旧版 Cascade agent，不适用于现为默认选项的 Devin Local。

通过一个表单，为五种工具生成 AGENTS.md 和对应的规则文件。 [打开 AGENTS.md 生成器 →](https://dotsagent.io/zh/instructions)

## 其他指令文件

[AGENTS.md](https://dotsagent.io/zh/instructions/files/agents-md)

[CLAUDE.md](https://dotsagent.io/zh/instructions/files/claude-md)

[GEMINI.md](https://dotsagent.io/zh/instructions/files/gemini-md)

[.cursor/rules/*.mdc](https://dotsagent.io/zh/instructions/files/cursor-rules)

[.github/copilot-instructions.md](https://dotsagent.io/zh/instructions/files/github-copilot-instructions)

[.clinerules/](https://dotsagent.io/zh/instructions/files/cline-rules)

[~/.openclaw/workspace/AGENTS.md](https://dotsagent.io/zh/instructions/files/openclaw-workspace)

## 来源

1. [docs.windsurf.com](https://docs.windsurf.com/windsurf/cascade/memories)/windsurf/cascade/memories
2. [devin.ai](https://devin.ai/blog/windsurf-is-now-devin-desktop)/blog/windsurf-is-now-devin-desktop
3. [docs.devin.ai](https://docs.devin.ai/desktop/devin-desktop-faq)/desktop/devin-desktop-faq

为 AI agent 开发者提供的独立参考资料。与此处提及的任何厂商均无关联。

© 2026 DotsAgent · 事实核查日期：2026年10月1日