网页演示：上传、发布与版本

网页演示项目用来托管 HTML 幻灯片（如 Reveal.js、Slidev 等工具导出的静态文件），并生成一个固定不变的演示链接。它与文档项目共用项目首页，但没有编辑器：所有操作都在发布页 /d/<项目 ID>/publish 完成。

创建

在项目首页 新建项目 中选择类型 网页演示。创建后直接进入发布页。

上传

点击顶栏的 上传演示（已有版本时显示为 上传新版本）：

• 接受 .html、.htm 或 .zip 文件。
• HTML 最大 10 MB；ZIP 解压后最大 50 MB，单文件最大 10 MB，最多 1000 个文件。对话框会显示你剩余的存储空间（每位用户合计 500 MB）。
• 入口文件 可以留空：默认使用 index.html，或压缩包中唯一的 HTML 文件。找不到时会提示选择入口文件。
• ZIP 里如果只有一个顶层文件夹，会自动去掉这一层。
• 压缩包中允许的文件类型：HTML、CSS、JS、JSON、常见图片、字体（woff / woff2 / ttf / otf）、mp4 / webm、mp3 / ogg / wav、txt、PDF。其他类型会被拒绝。

每次上传只生成 草稿，不会改变线上版本。上传成功后提示“预览已就绪，可以发布了”。上传过程中可以取消；如果服务器已经保存完成，这个版本仍会保留在历史中。

预览与发布

• 预览 区默认显示草稿。预览其他历史版本时，点 回到草稿 返回。
• 发布状态 卡片显示当前状态（尚未上传 / 草稿 / 有未发布的更改 / 已发布 / 已过期 / 已下线）、草稿版本号和线上版本号。
• 顶栏主按钮随状态变化：发布草稿 · 版本 N、发布演示、重新发布 或 复制演示链接。
• 演示链接 形如 /p/<slug>，首次发布时生成，之后重新发布、下线再发布都保持不变。

发布设置

• 访问范围：
  • 持链接可访问：任何拿到链接的人都能看。
  • 登录后可访问：需要登录 KloseDoc 账号。
  • 仅项目成员：只有项目成员能看。
• 到期时间：可选，必须是未来的时间。到期后链接显示已过期，重新发布即可恢复。

发布只切换线上版本，不改变已保存的访问范围和到期时间。修改设置后需要明确点击保存。

下线

更多操作 → 下线 会让固定链接停止访问，历史版本全部保留。之后重新发布会恢复同一个链接。

版本历史

发布页右侧列出所有版本，每页 30 条。每条显示版本号、时间、来源（浏览器、GitHub 提交或 Agent 令牌名）、入口文件和状态（草稿 / 线上版本 / 草稿 · 线上 / 历史版本）。

每个版本的操作：

• 预览：在预览区查看该版本。
• 恢复为草稿：把该版本变成新的草稿，原草稿保留在历史中，线上版本不变，需要再发布才生效。也可以用它把当前线上版本恢复为草稿。
• 下载版本：下载 slides-version-N.zip。
• 删除版本：只能删除既不是草稿也不是线上版本的历史版本，删除后立即释放配额，其他版本的编号不变。

如果其他人同时修改了版本，会提示“版本已更新，请重新确认最新版本后操作”。

分享

顶栏 分享 打开分享对话框：

• 显示演示链接和当前访问范围，修改 会跳到发布设置。
• 展开 邀请成员 可以按邮箱邀请成员。演示项目的成员只能查看已发布的演示，不能上传或发布。

从 GitHub 同步

更多操作 → GitHub 集成 可以把演示来源绑定到 GitHub 仓库中已经构建好的静态目录：

1. 连接 GitHub（复用文档项目的 GitHub 授权），再点 连接仓库。
2. 选择仓库、分支（默认仓库默认分支）、构建目录（默认 dist）和 入口文件（默认 index.html）。点 保存来源。
3. 点 同步最新版本，KloseDoc 从该分支最新提交读取构建目录并生成一个草稿。

规则：

• 只读取已提交到仓库的静态文件，不执行构建脚本，不读取仓库根目录，不自动发布。
• 同一提交不会重复生成草稿，提示“此提交已在版本历史中”。
• 同步时发现草稿或来源配置有变化会返回冲突，不覆盖他人的操作。
• 不支持符号链接、submodule 和 Git LFS 文件；大小限制与手动上传相同。
• 断开仓库连接 不会删除任何版本，也不会改动 GitHub。
• 服务器未配置 GitHub App 时，此功能显示为不可用。

用 Agent 更新

更新演示 → 用 Agent 更新 提供给 Codex、Claude Code 等 Agent 使用的提示词：

• 操作 可选 上传并发布 或 仅上传草稿。
• 高级选项 中填写构建目录和入口文件后，会生成可复制或下载的 klosedoc.json（包含项目 ID、输出目录和入口文件，不含令牌），放在本地项目目录中供 Agent 读取。

令牌和 MCP 客户端配置在项目首页的“Agent 接入”中管理，见Agent 接入。

演示查看页

访客打开 /p/<slug> 会看到深色顶栏、标题和 全屏 按钮。对于 Reveal.js 演示，顶栏还提供 上一页 / 下一页、页码计数，并支持键盘 ← → 翻页；其他框架的演示在页面内按自身方式操作。

访问范围为“登录后可访问”或“仅项目成员”时，未登录访客会被引导到登录页。

配额