跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.devin.ai/llms.txt

Use this file to discover all available pages before exploring further.

记忆 是用于在对话间共享并持久保留上下文的系统。 在 Devin Desktop 中，这通过两种机制实现：由 Cascade 自动生成的 记忆，以及由用户在全局、工作区或系统级别手动定义的 规则。

​
记忆、规则、工作流程，还是 Skills？

Devin Desktop 提供了多种自定义 Cascade 的方式。使用下表选择最合适的一种：
功能作用激活方式适用场景
规则告诉 Cascade 应如何表现 (例如“使用 bun，不要用 npm”)always_on、glob、model_decision 或 manual (见下文)编码规范、风格指南、项目约束
AGENTS.md按位置划分作用域、零配置的规则自动 —— 根目录 = 始终生效，子目录 = glob无需 frontmatter 的目录级规范
工作流程适用于可重复多步骤任务的提示模板仅支持手动，通过 /[workflow-name] Slash Command 触发部署、PR 评审、发布检查清单
Skills打包了支持文件 (脚本、模板) 的多步骤步骤由模型动态调用，或通过 @mention 调用当 Cascade 需要参考文件来处理复杂任务时 —— 优先考虑这个
记忆Cascade 在对话中自动生成的上下文相关时自动检索让 Cascade 记住一次性事实；对于持久知识，优先使用 规则 或 AGENTS.md
建议： 对于你希望 Cascade 稳定复用的知识，请将其写成 Rule，或添加到你仓库中的 AGENTS.md，不要依赖自动生成的记忆。规则 可纳入版本控制、可与团队共享，还能让你明确控制其激活方式。

​
如何管理记忆

记忆和 规则 可随时通过以下方式访问和配置：在 Cascade 中点击右上角滑出菜单里的 Customizations 图标，或点击右下角的 “Windsurf - 设置”。要编辑现有记忆，只需点开相应记忆，然后点击 Edit 按钮。

​
记忆

在对话过程中，如果 Cascade 遇到它认为值得记住的上下文，就会自动生成并存储记忆。 此外，你也可以随时让 Cascade 创建一条记忆。只需提示 Cascade“创建一条关于……的记忆”。 Cascade 自动生成的记忆会与创建它们的工作区相关联，并存储在本地的 ~/.codeium/windsurf/memories/ 中。Cascade 会在它认为这些记忆相关时调取它们。在一个工作区中生成的记忆无法在另一个工作区中使用，并且不会提交到你的代码仓库。
创建和使用自动生成的记忆不会消耗额度。
自动生成的记忆仅保存在你的机器上。如果你希望 Cascade 持久地记住某些内容——并与你的团队共享——请改为让 Cascade 将其写入 .devin/rules/ (或旧版的 .windsurf/rules/) 中的 Rule 或你代码仓库中的 AGENTS.md。

​
规则

用户可以明确地定义自己的规则，供 Cascade 遵循。 规则可以在全局、工作区或系统级别定义，也可以从 AGENTS.md 文件中识别出来。
作用域位置说明
全局~/.codeium/windsurf/memories/global_rules.md单个文件，适用于所有工作区。始终生效。最多 6,000 个字符。
工作区.devin/rules/*.md (首选) 或 .windsurf/rules/*.md (回退)每条规则对应一个文件，每个文件都有各自的激活模式。每个文件最多 12,000 个字符。工作区根目录中的旧版单文件 .windsurfrules 也仍会被读取。
AGENTS.md工作区中的任意目录由同一规则引擎处理——根目录级别 = 始终生效，子目录 = 自动对该目录进行 glob 匹配。
系统 (Enterprise)因操作系统而异 (例如 /etc/devin/rules/，旧版 /etc/windsurf/rules/)由 IT 部署，终端用户仅可读取。

​
规则发现

Devin Desktop 会自动从多个位置发现规则，从而支持更灵活的组织方式。.devin/ 目录是首选位置并具有更高优先级，而 .windsurf/ 则作为向后兼容的后备保留：
  • 当前工作区和子目录：当前工作区及其子目录中所有的 .devin/rules (以及旧版 .windsurf/rules) 目录
  • Git 仓库结构：对于 Git 仓库，Devin Desktop 还会向上搜索到 Git 根目录，以查找父目录中的规则
  • 支持多个工作区：当同一工作区中打开了多个文件夹时，系统会对规则去重，并以最短相对路径显示

​
规则 存储位置

规则 可以存储在以下任一位置 (优先使用 .devin/，且其优先级高于 .windsurf/) ：
  • 你当前工作区目录中的 .devin/rules 或 .windsurf/rules
  • 你工作区任意子目录中的 .devin/rules 或 .windsurf/rules
  • git 根目录之前的各级父目录中的 .devin/rules 或 .windsurf/rules (适用于 git 代码仓库)
当你创建新规则时，它会保存在当前工作区的 .devin/rules 目录中，不一定是在 git 根目录下。 要开始使用 规则，请点击 Cascade 右上角侧边滑出菜单中的 Customizations 图标，然后进入 规则 面板。在这里，你可以分别点击 + 全局 或 + 工作区 按钮，在全局级别或工作区级别创建新规则。
你可以在 https://windsurf.com/editor/directory 找到由 Devin Desktop 团队整理的示例规则模板，帮助你快速上手。
每个工作区规则文件最多可包含 12,000 个字符。全局规则文件最多可包含 6,000 个字符。

​
激活模式

每条 工作区 规则都会在其 frontmatter 中通过 trigger 字段声明一种激活模式。这决定了规则内容何时会提供给 Cascade，以及会占用多少上下文窗口：
Modetrigger: valueHow it reaches CascadeContext cost
始终开启always_on完整的规则内容会在每条消息中都包含在系统提示中。每条消息都会占用
模型决策model_decision系统提示中只会显示 description。当 Cascade 判断该描述相关时，会读取完整的规则文件。始终包含 Description；完整内容按需加载
Globglob当 Cascade 读取或编辑与 globs 模式匹配的文件时，会应用该规则 (例如 *.js、src/**/*.ts) 。仅在触及匹配文件时
手动manual该规则不会出现在系统提示中。你可以在 Cascade 输入框中键入 @rule-name 来激活它。仅在被 @ 提及时
全局规则文件 (global_rules.md) 和根目录下的 AGENTS.md 文件不使用 frontmatter——它们始终处于开启状态。
带有 frontmatter 的 工作区 规则示例： 
---
trigger: glob
globs: **/*.test.ts
---

所有测试文件必须使用 `describe`/`it` 块，并模拟外部 API 调用。

​
最佳实践

为帮助 Cascade 更有效地遵循你的规则，建议采用以下最佳实践：
  • 保持规则简单、简洁且具体。过长或含糊的规则可能会让 Cascade 难以理解。
  • 无需添加通用规则 (例如 “编写优质代码”) ，因为这些内容已经内置于 Cascade 的训练数据中。
  • 使用项目符号、编号列表和 Markdown 来组织你的规则。与冗长的段落相比，这些格式更便于 Cascade 遵循。例如：
# Coding Guidelines 
- My project's programming language is python
- Use early returns when possible
- Always add documentation when creating new functions and classes
  • XML 标签是传达信息并将相似规则归类到一起的有效方式。例如：
<coding_guidelines>
- My project's programming language is python
- Use early returns when possible
- Always add documentation when creating new functions and classes
</coding_guidelines>

​
系统级规则 (Enterprise)

Enterprise 组织可以部署适用于所有工作区的全局系统级规则，终端用户若无管理员权限则无法修改。这非常适合用于强制执行组织范围内的编码标准、安全策略和合规要求。 系统级规则从操作系统特定的目录中加载。优先使用 Devin 目录并具有更高优先级，同时保留旧版 Windsurf 目录作为后备： macOS: 
/Library/Application Support/Devin/rules/*.md
/Library/Application Support/Windsurf/rules/*.md   # legacy fallback
Linux/WSL： 
/etc/devin/rules/*.md
/etc/windsurf/rules/*.md   # 旧版回退
Windows： 
C:\ProgramData\Devin\rules\*.md
C:\ProgramData\Windsurf\rules\*.md   # legacy 回退
将你的规则文件 (.md 文件) 放在与你所用操作系统对应的目录中。系统会自动加载这些目录中的所有 .md 文件。

​
系统规则的工作方式

系统级规则会与工作区规则和全局规则合并，为 Cascade 提供额外上下文，同时不会覆盖用户定义的规则。这样一来，组织既可以建立基线标准，也仍然允许团队添加项目级自定义配置。 在 Devin Desktop UI 中，系统级规则会显示“System”标签，终端用户无法删除。
重要：系统级规则应由你的 IT 团队或安全团队管理。请确保你的内部团队按照你的组织的策略要求处理部署、更新和合规。你可以使用标准工具和工作流程来实现这一点，例如移动设备管理 (MDM) 或配置管理。