记忆是用于跨对话共享和持久化上下文的系统。

在 Cascade 中有两种机制:记忆(可由 Cascade 自动生成)和规则(可由用户在本地和全局级别手动定义)。

如何管理记忆

通过点击 Cascade 右上角滑动菜单中的 自定义 图标,可以随时访问和配置记忆和规则。要编辑现有记忆,只需点击它,然后点击 编辑 按钮。

记忆

在对话过程中,如果 Cascade 遇到它认为有助于记住的上下文,可以自动生成并存储记忆。

此外,您可以随时要求 Cascade 创建记忆。只需提示 Cascade“创建…的记忆”即可。

Cascade 自动生成的记忆与其创建时所在的工作区相关联,Cascade 会在认为它们相关时检索它们。在一个工作区中生成的记忆在另一个工作区中不可用。

创建和使用自动生成的记忆不消耗点数

规则

用户可以显式定义自己的规则供 Cascade 遵循。

规则可以在全局级别或工作区级别定义。

global_rules.md - 应用于所有工作区的规则

.windsurfrules - 工作区级别存储库,包含与 globs 或自然语言描述相关的规则。

要开始使用规则,请点击 Cascade 右上角滑动菜单中的 自定义 图标,然后导航至 规则 面板。在这里,您可以点击 + 全局+ 工作区 按钮,分别在全局或工作区级别创建新规则。

您可以在 https://windsurf.com/editor/directory 找到 Windsurf 团队整理的示例规则模板,帮助您开始使用。

规则文件每个限制为 6000 个字符。超出 6000 个字符的任何内容将被截断,Cascade 将不会知晓它们。

如果您的全局规则和本地规则总计超过 12,000 个字符,优先级将给予全局规则,其次是工作区规则。超出 12,000 个字符的任何规则将被截断。

最佳实践

为了帮助 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>