# 静态播放器
> 在桌面端用独立窗口运行本地静态全景项目，并提供最近项目记录。

## 1. 页面信息

- 网页地址：https://9kvr.cn/tour/workbench/static-player
- 所属模块：全景工作台
- 页面用途：让已发布或离线导出的静态全景项目在本地直接运行。桌面端可拖入或选择 HTML 入口文件，程序把入口所在目录当作站点根目录加载资源并在独立窗口播放；网页端无本地文件能力，引导用户下载桌面端。
- 适用用户：需要在本地运行已导出静态全景项目的桌面端用户
- 访问条件：公开访问

## 2. 功能说明

- 桌面端：拖拽 HTML/HTM 入口文件或点击选择文件
- 入口所在目录作为站点根目录，自动加载依赖资源
- 最近项目列表：最多保留 10 个，记录入口路径、名称与上次打开时间
- 打开前重新校验文件有效性，失效条目标记“文件失效”且不可打开
- 支持删除单条记录与清空全部记录
- 网页端展示“下载桌面端”引导

## 3. 业务说明

### 使用前提

本地运行静态全景项目需要桌面端。网页端不具备本地文件访问能力，请先下载桌面端。

## 4. 使用说明

1. 在桌面端进入本页
2. 读取最近项目或拖入/选择 HTML 入口文件
3. 校验通过后在独立窗口打开
4. 打开成功后该项目写入最近项目并置顶

## 5. 规则与限制

- 只接受 html/htm 扩展名文件
- 入口路径作为最近项目的唯一标识，重复打开只更新时间并移到首位
- 最多保留 10 条最近项目
- 网页端不提供本地文件服务，只能下载桌面端

## 6. 状态与异常

- 非桌面端显示“下载桌面端”面板，不显示拖拽区
- 最近项目读取中显示“正在读取...”；无记录显示空状态
- 拖拽悬停时高亮
- 拖入非 HTML 文件时提示请拖入 HTML 或 HTM 文件
- 入口校验失败时提示具体原因
- 最近项目读取失败时提示

## 7. 相关文档

- [VR 工作台欢迎页](https://9kvr.cn/site/tour/workbench/welcome.md)
- [全景作品播放页](https://9kvr.cn/site/tour.md)
- 上级目录索引：[/tour](https://9kvr.cn/site/tour/llms.txt)

## 8. 文档信息

- 事实来源：芊云全景官网页面核验
- 文档构建时间：2026-10-20 19:04:23
- 数据获取/快照时间：不适用（静态产品知识）
- 可信状态：已核验