W-Spaces 部署

将静态网站部署到 W-Spaces（wspaces.app）。通过 API 创建项目、推送 HTML 文件，并部署至可访问的线上 URL。

配置

获取您的 API 密钥

1. 注册：scripts/wspaces_auth.sh --register --email you@example.com --password yourpass --name "Your Name"
2. 验证邮箱（请查收收件箱）
3. 登录：scripts/wspaces_auth.sh --login --email you@example.com --password yourpass
4. 从响应中复制 API 密钥

设置 API 密钥

export WSPACES_API_KEY="wsk_live_xxxx..."

或存入 .env 文件：

WSPACES_API_KEY=wsk_live_xxxx...

操作命令

创建项目

scripts/wspaces_project.sh --create --name "My Landing Page"

响应中将包含项目 ID 和 slug。

推送 HTML 代码

# 从文件推送
scripts/wspaces_push.sh --project  --file ./index.html

# 从内联 HTML 推送
scripts/wspaces_push.sh --project  --html "
Hello
"

部署至线上 URL

scripts/wspaces_deploy.sh --project 

结果示例：https://.wspaces.app

列出所有项目

scripts/wspaces_project.sh --list

查看项目详情

scripts/wspaces_project.sh --get --id 

查看部署记录

scripts/wspaces_deploy.sh --list --project 

常用工作流

部署一个落地页

# 1. 创建项目
scripts/wspaces_project.sh --create --name "Startup Landing"
# → 项目 ID：abc-123

# 2. 推送代码
scripts/wspaces_push.sh --project abc-123 --file ./index.html

# 3. 部署
scripts/wspaces_deploy.sh --project abc-123
# → https://startup-landing-xyz.wspaces.app

更新已有站点

# 推送新代码（生成新版本）
scripts/wspaces_push.sh --project abc-123 --file ./index.html

# 重新部署
scripts/wspaces_deploy.sh --project abc-123

从零开始的完整流程

请向您的 agent 发出以下指令：

• “创建一个名为 My Portfolio 的 W-Spaces 项目”
• “将此 HTML 推送到我的 W-Spaces 项目”
• “将我的项目部署到 wspaces.app”

API 密钥管理

# 创建额外的 API 密钥
scripts/wspaces_auth.sh --create-key --name "CI/CD Key"

# 列出所有密钥
scripts/wspaces_auth.sh --list-keys

# 撤销指定密钥
scripts/wspaces_auth.sh --revoke-key --id 

API 参考文档

完整 API 文档请参阅 wspaces-api.md。

故障排查

“WSPACES_API_KEY 未设置”

export WSPACES_API_KEY="wsk_live_xxx..."

“API 密钥无效”

• 该密钥可能已被撤销 —— 请重新登录并生成新密钥
• 检查复制时是否误带多余空格

“请先验证您的邮箱”

• 请检查收件箱中是否有验证邮件
• 务必在登录前完成邮箱验证

“项目未找到”

• 请使用 scripts/wspaces_project.sh --list 核对项目 ID