Cascade 记忆系统：跨对话共享上下文

在 Windsurf 中，有两种方式可以在对话中 共享和持久化上下文：

  1. Memories（记忆）：Cascade 自动生成 的上下文记忆。
  2. Rules（规则）：用户手动定义的规则，可以在 本地 或 全局 级别生效。

1️⃣ Memories（自动生成的记忆）

📌 作用：

  • Cascade 自动检测有用的上下文，并将其存储为记忆。
  • 这些记忆 绑定到当前工作空间，不会跨工作空间共享。
  • 你可以随时手动创建记忆，例如输入： 
    1. create a memory of [你想保存的内容]
  • 不会消耗 Flow Action 额度。

📍 如何管理 Memories？

  1. 在 Windsurf 设置中管理

    • 点击 Windsurf - Settings（编辑器右下角）
    • 选择 Settings 选项卡
    • 点击 Manage（管理）旁边的 Cascade-Generated Memories

  2. 从 Cascade 窗口管理

    • 点击 Cascade 窗口右上角的三点按钮
    • 选择 Manage Memories（管理记忆）

2️⃣ 自定义规则（Rules）

你可以通过规则文件 手动定义 Cascade 的行为，让 AI 始终遵循你的规则。

📌 规则文件：

  • global_rules.md 👉 适用于所有工作空间
  • .windsurfrules 👉 仅适用于当前本地工作空间

⚠ 如果 global_rules.md 和 .windsurfrules 总字符数超过 12,000，
优先级：
✅ 全局规则 (global_rules.md) > ✅ 本地规则 (.windsurfrules)

💡 最佳实践：

  • 规则要简单、清晰、具体，避免模糊或冗长的描述。
  • 不要写太基础的规则（例如：“写出优质代码”），Cascade 已经默认遵循这些规则。
  • 使用 Markdown 格式（列表、编号）让规则更易理解。

✅ 示例 1：简单规则格式

  1. # Coding Guidelines 
  2. - 我的项目使用 Python  
  3. - 代码尽量使用早返回（early return）  
  4. - 创建新函数或类时，必须添加文档注释

✅ 示例 2：XML 规则格式

  1. <coding_guidelines>
  2. - 我的项目使用 Python
  3. - 代码尽量使用早返回（early return）
  4. - 创建新函数或类时，必须添加文档注释
  5. </coding_guidelines>

📍 如何管理规则？

1. 在 Windsurf 设置中编辑规则

  • 进入 Windsurf - Settings
  • 选择 Settings
  • 点击 Edit Rules（编辑规则）
  • 选择 Set Global AI Rules 或 Set Workspace AI Rules

2. 规则文件 .windsurfrules 添加到 .gitignore

⚠ 为了防止规则文件被提交到 Git 仓库，建议将 .windsurfrules 添加到 .gitignore！

🚀 记忆 vs 规则：适用场景对比

功能 Memories（记忆） Rules（规则）
创建方式 自动（Cascade 生成） / 手动创建 由用户手动编写 .windsurfrules
作用范围 仅限当前工作空间 本地规则适用于单个工作空间，全局规则适用于所有工作空间
生效方式 在需要时自动调用 持续生效，AI 始终遵循
使用成本 不消耗 Flow Action 额度 不消耗 Flow Action 额度
适用场景 临时性、动态上下文（如当前项目进展） 长期性、稳定的开发规范（如编码风格）

总结

1️⃣ Memories 👉 自动存储对话上下文，适用于动态信息，不需要手动管理。
2️⃣ Rules 👉 手动定义 Cascade 规则，适用于代码风格、最佳实践等稳定的开发规范。
3️⃣ Memories + Rules 结合使用，让 Cascade 更智能地理解你的需求，提高工作效率！ 🚀