> [!NOTE] > 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。 > [English](./README.en.md) · [原始项目](https://github.com/Exafunction/windsurf-demo) · [上游 README](https://github.com/Exafunction/windsurf-demo/blob/HEAD/README.md) > 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。 # Windsurf Demo App 这是一个演示应用及相关任务，用于展示 [Windsurf Editor](https://windsurf.ai/). 的强大功能。 整个应用由 Cascade 在 Windsurf Editor 中从零编写，你还可以继续添加更多内容！ ## 前置要求 - Python 3.7 或更高版本 - Node.js 和 npm ## 快速开始 1. 克隆仓库： ```bash git clone cd windsurf-demo ``` 2. 安装 Python 依赖： ```bash pip3 install -r requirements.txt ``` 3. 启动 Flask 服务器： ```bash python3 app.py ``` 4. 打开浏览器并访问： ``` http://localhost:5000 ``` 5. 开始游戏！ ## 了解 Cascade 的任务 1. **演示对知识的深度推理（Deep Reasoning）** 新建一个 Cascade，并粘贴输入："Create random variability in how much value food cells add to the player, and make the sizes reflect the value." Cascade 应会按以下方式运行，之后你可以查看 diff 并一次性接受所有更改。点击开始观看视频： [](https://youtu.be/dsB3hHz-Nfw) 这展示了 Cascade 的以下能力： - 使用工具搜索现有代码库。 - 以自洽的方式创建跨文件、多处的编辑更改。 - 允许你一次性接受多处更改。 2. **演示融入人类操作（Human Actions）** 目前分数没有衰减机制，因此大玩家即使不移动或不继续成长也会一直保持体型。我们来添加一个衰减机制。新建一个 Cascade，只需说 "Hi" 即可启动 Cascade。现在，前往 `static/js/config.js`，在文件中某处添加以下常量。点击开始观看视频： ```js // Score decay mechanics export const BASE_DECAY_RATE = 0.02; // Base rate of score decay per second export const DECAY_SCALE_FACTOR = 0.2; // How much size affects decay rate ``` 现在，回到 Cascade 并输入 "Continue."。Cascade 的运行大致如下： [](https://youtu.be/aHrUPrO0Pxk) 这展示了 Cascade 的以下能力： - 推理你在文本编辑器中所执行的操作，并从语义上引用它们。 - 与你完全基于同一份代码库状态工作，无需你为 copilot 或 agent 单独界定问题范围。 3. **演示工具访问能力** 打开 Cascade（Command + L），并输入 "Run all tests in static/js"。你可能需要向 Cascade 提供更多关于仓库的信息，但通常你会看到以下情况。点击开始观看视频： [](https://youtu.be/Cq0HJ6y-nh8) 这展示了 Cascade 的以下能力： - 对你的现有代码库进行迭代推理。 - 建议终端命令并在 Cascade 内执行它们。 - 通过识别并推理相关代码来调试堆栈跟踪（stacktrace）。 - 针对问题建议修复方案，直接向你的文件提出编辑建议。 - 允许你检视 diff，并逐行接受 diff。 ### 关于 Cascade 的要点 这些任务应能展示 Windsurf Editor 如何对你的代码库进行深度联合推理、访问广泛的工具集，并融入你作为开发者的操作。 Cascade 并不总是完美，你常常需要追问 Cascade 以修复意外的副作用，或在更复杂的任务中完全接管、暂时忽略 AI。这完全没问题！Cascade 是你仍可信任并与之迭代的最强大的 AI 助手。 ## 更多 Windsurf Editor 功能 查看我们的 [Docs](https://docs.codeium.com) 获取更多示例，以及如何使用 Autocomplete、Supercomplete、Command 等功能！编辑器各处都集成了 AI，让你能在需要时、在需要的地方获得最优的 AI 辅助。