Skip to main content
构建与托管站点

Sites 站点构建与托管

Qoder Sites 让你在 Qoder CLI 里直接构建、发布和管理网站——从静态页面到带数据库、Server Functions 与对象存储的 Agent App。共有三个使用入口：
  • 会话内自然语言（推荐）：在交互式会话里描述目标，内置的 Sites Skills 会驱动构建、发布与管理流程。
  • /sites 面板：在 TUI 里可视化管理站点、共享策略与环境变量。
  • qoder sites 终端子命令：面向脚本与自动化的机器可读 JSON 接口。

在会话中构建与管理

交互式会话内置以下 Sites Skills，用自然语言表达意图即可触发：
Skill用途
sites:sites-building从零或从现有项目构建网站，打包并准备发布
sites:sites-build-agent-app构建带数据库后端的 Agent App
sites:sites-hosting发布草稿、跟踪发布进度、恢复已发布站点
sites:sites-management日常管理：站点信息、共享策略、环境变量、数据、日志与分析
例如：「帮我把 dist 发布成站点」「把这个站点改成仅指定成员可见」「看看昨天的访问分析」。 发布、删除、修改共享策略、删除 Secret 等写操作，Agent 都会先向你明确复述影响并获得确认后才执行；确认与幂等语义由 Skills 编排，无需你手工构造请求。

/sites 面板

在交互式会话中输入 /sites 打开面板，可以：
  • 列表：浏览我拥有的、以及共享给我的站点
  • 详情：查看站点状态、当前部署与进度
  • 发布 / 暂停 / 恢复 / 删除：发布从就绪状态的部署中选择；删除需要二次确认
  • 共享：在私有 / 指定成员（按邮箱或 UID 邀请）/ 组织 / 公开之间切换访问策略，公开需要额外确认
  • 环境变量（Secrets）：添加、替换与删除；值只写不可读回
面板仅在本地交互式 TUI 中可用。

终端子命令 qoder sites

qoder sites list                # 列出你的站点
qoder sites operations          # 列出可用操作目录
qoder sites describe <operation> # 查看操作入参 JSON Schema
qoder sites <operation> [--input <JSON> | --input-file <path>]
  • 交互式终端中输出为人类可读的渲染（操作按分组罗列、错误摘要、格式化 JSON）；管道、重定向或带 --session 的调用（会话内 Skills 的固定契约）始终输出单行 JSON（{"schemaVersion": 1, ...}），适合脚本解析
  • list 列出你的站点（--input '{"scope":"shared"}' 查看共享给你的）；operations 列出可用操作目录；describe <operation> 输出该操作入参的 JSON Schema，是操作参数的权威来源
  • 退出码：0 成功；2 无效输入；3 需要登录或会话；4 冲突；5 写结果未知（重试前先查询状态）；6 已取消；1 其他

适合直接调用的操作

只读查询操作适合在脚本与自动化中直接使用： list_sites、get_site、get_analytics、get_site_access、check_subdomain、get_function_logs、list_storage_objects、get_operation 
qoder sites list_sites --input '{"page": 1}'
qoder sites describe get_analytics

由 Skills 驱动的操作

以下能力由会话内 Skills 携带会话上下文（--session）调用，属于 Agent 工作流的一部分：
  • 构建与发布流水线：prepare_site、publish_site、get_publish_status、get_context
  • 数据库管理：get_database_schema、create_database_migration、apply_database_migration、query_database_rows 等
  • 存储与各类写操作：upload_storage_file、delete_storage_object、update_access_policy、delete_project 等带确认、幂等与引用（ref）语义的操作
需要使用这些能力时，请在会话中表达意图，由 Agent 完成确认与调用；手工构造这些请求会绕过确认保护。

登录与网络

终端子命令使用本机的 Qoder 登录态，未登录时会引导登录（参见认证）；会话内调用使用当前会话的身份，不会回退到其他本地登录。网络路由遵循 CLI 当前的网络配置（参见网络）。

下一步