这个条目是故意保留的,它演示的是架构里的一条降级路径。
不是所有作品都能内嵌
本站的核心机制是用 iframe 把作品嵌进页面。但这条路径有个前提:作品得是一个能在浏览器里跑的网页应用。
桌面应用、命令行工具、需要本地权限的程序都不满足这个前提。它们只能:
- 放一张截图或封面
- 配一段说明
- 给一个下载或仓库链接
在前面的方案讨论里,这一点被明确列为需求——允许降级。所以数据模型里有一个 demo.interactive 字段:它为 false 时,详情页根本不渲染试玩组件,而是走封面加外链的分支。
为什么要留一个这样的条目
因为“能内嵌”和“不能内嵌”是两条完全不同的代码路径。如果只准备可交互的作品,那条降级分支就会一直没被跑过——等到真接入一个桌面应用时才发现有 bug。
留一个真实的降级样本,等于给这条分支留了个探针。
接入真实桌面作品时
把这个文件的 frontmatter 换成真实信息即可,正文和结构都不用动。这也正好说明了数据模型的意图:新增作品只是新增一个 Markdown 文件。