安装指南
系统要求
| 平台 | 最低版本 | 支持状态 | 备注 |
|---|---|---|---|
| Windows 10/11 | 1809 (build 17763) | ✅ 已支持 | x64 NSIS 安装包 |
| macOS | 11 Big Sur | ✅ 已支持 | Apple Silicon + Intel，dmg（未公证，首次打开需解隔离） |
| Linux | Ubuntu 20.04 / Debian 11 | ✅ 已支持 | AppImage / deb（x64） |
硬件方面：
- 内存 ≥ 4 GB（推荐 8 GB）
- 磁盘 ≥ 300 MB 可用空间（生图/视频缓存会占用更多）
- 一个能联网的环境（AI 调用走云端 API）
Windows 安装
1. 下载安装包
从 下载页 获取 StoryLoom_x64-setup.exe。
2. 运行安装程序
- 双击
StoryLoom_x64-setup.exe - 安装界面为简体中文，按提示走完即可
- 桌面快捷方式与开始菜单条目会自动创建
如果系统提示「Windows 已保护你的电脑」，点击「更多信息 → 仍要运行」。这是因为内测版本尚未购买完整 EV 签名证书，正式版上线后此提示会消失。
3. 首次启动
启动 StoryLoom 后：
- 进入主界面：左侧导航列出 项目 / 写作 / Story Bible / 设置 等入口。
- 配置 AI 供应商：到「设置 → AI 供应商」添加至少一个聊天供应商并填入 API Key，否则 AI 功能不可用。详见 配置 AI 供应商。
- 创建第一个项目：见 创建第一个项目。
WebView2 运行时
StoryLoom 基于 Tauri，界面由系统 WebView2 渲染。Windows 10/11 通常已内置；若启动后白屏 / 黑屏，多半是 WebView2 缺失或过旧——从微软官网下载 WebView2 Evergreen Runtime 安装后重启。
数据目录位置
| 内容 | 位置 |
|---|---|
| 小说工程 / 角色卡 / 世界观（SQLite） | %APPDATA%\com.storyloom.app\ |
| 分镜 / 媒体产物（图片·视频·音频） | %APPDATA%\com.storyloom.app\ 下对应子目录 |
| 应用日志 | %APPDATA%\com.storyloom.app\logs\ |
| API Key（加密） | 本机加密存储，不以明文落盘 |
开发版与正式版数据隔离：开发版的媒体目录、数据库使用
dev-前缀（如dev-storyboard_videos），与正式版互不干扰。
卸载
控制面板 → 程序与功能 → StoryLoom → 卸载。
卸载前若想保留稿件，请先在应用内导出项目，或手动备份
%APPDATA%\com.storyloom.app\目录。