wehub-resource-sync
98 lines
4.0 KiB
Markdown
98 lines
4.0 KiB
Markdown
<!-- WEHUB_ZH_README -->
|
||
> [!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 <repository-url>
|
||
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 辅助。
|