安装与首次启动

这一页带你装好桌面版并打开它。完成后，你会在世界选择页看到四个内置世界。

开始之前

• macOS：Apple Silicon 芯片，macOS 13.5 及以上。
• Windows：x64。
• 其他系统暂时没有安装包，可以从源码运行。

1. 下载

打开 Releases 页面，下载对应系统的安装包：macOS 是 .dmg，Windows 推荐文件名以 -win-x64.exe 结尾的安装程序。不想安装时选 Windows .zip；另保留单文件自解压 portable.exe。

每次发布都附带 SHA256SUMS.txt，可以用它核对下载的文件。

2. 安装并打开

安装包目前没有签名，系统第一次打开时会拦截。这是预期的，按下面处理一次即可。

macOS

把 Covel 拖进“应用程序”。如果打开时提示“已损坏，无法打开”，应用并没有损坏：安装包没有签名和公证，macOS 会拦截浏览器下载的应用。点“取消”，在终端运行下面这一行，再重新打开：

xattr -dr com.apple.quarantine /Applications/Covel.app

Windows

运行安装程序。如果提示“已保护你的电脑”，点“更多信息”，再点“仍要运行”。如果浏览器拦下了下载，先在下载列表里选择“保留”。

免安装 ZIP 要先右键“全部解压”，再运行解压目录里的 Covel.exe；不要直接从压缩包窗口启动，也不要只移动 EXE。以后直接打开这个目录里的程序，不再重复解压。

单文件 portable.exe 每次启动都会重新解压，并显示静态准备提示；退出后会清理解压目录。需要经常使用又不想安装时，优先选 ZIP。系统安全扫描可能发生在提示出现之前。三种下载形式都使用同一套数据目录，不会把存档移到 EXE 旁边。

3. 看到世界选择页

第一次打开时会出现新手引导，第一步是选择界面语言：每种语言都用它自己的文字列出，选中后界面立刻切换。你可以跟着它走，也可以点“先浏览世界”跳过，之后在世界选择页点“新手引导”随时重看。

关掉引导后，你会看到世界列表，里面有四个内置世界：

世界	玩法
雾港・裂潮纪	传统叙事的黑暗奇幻调查
遥风学园	舞台模式的校园群像
Emberback Relay	科幻边境悬疑，英文写成，另有中文版
提灯古冢・初次远征	经典跑团地城探索，开局配点，掷骰检定

看到这个列表，安装就完成了。

NOTE

现在可以浏览世界。生成剧情需要可用的模型，下一页会说明如何连接。开始时缺少密钥会提示你填写，也可以选择“仍然开始”，稍后配置。

遇到问题

现象	处理
macOS 提示“已损坏”	按上面的步骤运行 xattr 命令
Windows 提示“已保护你的电脑”	“更多信息” → “仍要运行”
窗口打开后一直是空白或加载状态	查看日志 ~/.covel/data/logs/desktop.log 和 server.log，位置见数据、备份与升级
重复打开没有出现第二个窗口	这是正常的：Covel 只运行一个实例，再次打开会聚焦已有窗口

下一步

连接模型