DanielleNguyen/WindsurfAPI

1---2title: WindsurfAPI3emoji: "🌊"4colorFrom: indigo5colorTo: blue6sdk: docker7pinned: false8---9 10# WindsurfAPI on Hugging Face Spaces11 12这个 Space 运行的是 `WindsurfAPI` 的 Docker 版本。13 14## 运行说明15 161. 镜像构建时会下载官方 Linux x64 `tar.gz` 安装包，并自动提取 `language_server_linux_x64`172. 运行时从 Hugging Face Space Secrets / Variables 生成 `.env`183. 持久化文件保存在挂载桶的 `/data/windsurf/state/`194. 外部服务端口固定为 `7860`20 21## HF Space 最终填写清单22 23| 名称 | 位置 | 是否必填 | 说明 |24|---|---|---|---|25| `API_KEY` | Secret | 必填 | 对外 API 的访问密钥 |26| `CODEIUM_API_KEY` | Secret | 可选预置 | Windsurf / Codeium API Key；不填也可启动 |27| `CODEIUM_AUTH_TOKEN` | Secret | 可选预置 | `windsurf.com/show-auth-token` 获取的 token；不填也可启动 |28| `DEFAULT_MODEL` | Variable 或 Secret | 推荐 | 默认模型，不填走 `claude-4.5-sonnet-thinking` |29| `MAX_TOKENS` | Variable 或 Secret | 推荐 | 默认最大输出 token，不填走 `8192` |30| `LOG_LEVEL` | Variable 或 Secret | 推荐 | 日志级别，不填走 `info` |31| `DASHBOARD_PASSWORD` | Secret | 推荐 | Dashboard 访问密码 |32| `LS_PORT` | Variable 或 Secret | 可选 | LS gRPC 端口，不填走 `42100` |33| `CODEIUM_API_URL` | Variable 或 Secret | 可选 | 上游接口地址，不填走官方默认值 |34 35如果没有预先填写 `CODEIUM_API_KEY` 或 `CODEIUM_AUTH_TOKEN`，服务仍然可以启动，之后可以通过以下方式添加账号：36 371. Dashboard 一键登录382. Token 登录393. 批量导入40 41## 不要在 HF Space 里填写这些42 43- `PORT`：启动时会强制写成 `7860`44- `LS_BINARY_PATH`：启动时会强制写成 `/opt/windsurf/language_server_linux_x64`45- `HF_TOKEN`：这是 GitHub Actions 推送 Space 仓库用的，不是运行时变量46- `HF_SPACE_REPO`：这是 GitHub Actions 发布目标，不是运行时变量47- `HF_LS_DOWNLOAD_URL`：这是 GitHub Actions 构建发布包时替换 `Dockerfile` 用的，值应为官方 Linux x64 `tar.gz` 下载链接，不是运行时变量48 49## 持久化文件50 51- `/data/windsurf/state/.env`52- `/data/windsurf/state/accounts.json`53- `/data/windsurf/state/proxy.json`54- `/data/windsurf/state/model-access.json`55- `/data/windsurf/state/runtime-config.json`56 57## 部署来源58 59这个 Space 仓库由 GitHub Actions 从主仓库的 `huggingface/` 发布目录自动同步生成。60