exafunction--windsurf-demo/README.md

Note

本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。
English · 原始项目 · 上游 README
原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。

Windsurf Demo App

这是一个演示应用及相关任务，用于展示 Windsurf Editor. 的强大功能。

整个应用由 Cascade 在 Windsurf Editor 中从零编写，你还可以继续添加更多内容！

前置要求

• Python 3.7 或更高版本
• Node.js 和 npm

快速开始

1. 克隆仓库：

git clone <repository-url>
cd windsurf-demo

2. 安装 Python 依赖：

pip3 install -r requirements.txt

3. 启动 Flask 服务器：

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 并一次性接受所有更改。点击开始观看视频：

这展示了 Cascade 的以下能力：

• 使用工具搜索现有代码库。
• 以自洽的方式创建跨文件、多处的编辑更改。
• 允许你一次性接受多处更改。

2. 演示融入人类操作（Human Actions）

目前分数没有衰减机制，因此大玩家即使不移动或不继续成长也会一直保持体型。我们来添加一个衰减机制。新建一个 Cascade，只需说 "Hi" 即可启动 Cascade。现在，前往 static/js/config.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 的运行大致如下：

这展示了 Cascade 的以下能力：

• 推理你在文本编辑器中所执行的操作，并从语义上引用它们。
• 与你完全基于同一份代码库状态工作，无需你为 copilot 或 agent 单独界定问题范围。

3. 演示工具访问能力

打开 Cascade（Command + L），并输入 "Run all tests in static/js"。你可能需要向 Cascade 提供更多关于仓库的信息，但通常你会看到以下情况。点击开始观看视频：

这展示了 Cascade 的以下能力：

• 对你的现有代码库进行迭代推理。
• 建议终端命令并在 Cascade 内执行它们。
• 通过识别并推理相关代码来调试堆栈跟踪（stacktrace）。
• 针对问题建议修复方案，直接向你的文件提出编辑建议。
• 允许你检视 diff，并逐行接受 diff。

关于 Cascade 的要点

这些任务应能展示 Windsurf Editor 如何对你的代码库进行深度联合推理、访问广泛的工具集，并融入你作为开发者的操作。

Cascade 并不总是完美，你常常需要追问 Cascade 以修复意外的副作用，或在更复杂的任务中完全接管、暂时忽略 AI。这完全没问题！Cascade 是你仍可信任并与之迭代的最强大的 AI 助手。

更多 Windsurf Editor 功能

查看我们的 Docs 获取更多示例，以及如何使用 Autocomplete、Supercomplete、Command 等功能！编辑器各处都集成了 AI，让你能在需要时、在需要的地方获得最优的 AI 辅助。