安装指南
系统要求
| 平台 | 最低版本 | 支持状态 | 备注 |
|---|---|---|---|
| Windows 10/11 | 1809 (build 17763) | 已支持 | x64 NSIS 安装包（v0.8.0 起 EV 代码签名） |
| macOS | 11 Big Sur | 已支持 | Apple Silicon + Intel，dmg（v0.8.0 起已签名并公证） |
| 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 - 安装界面为简体中文，按提示走完即可
- 桌面快捷方式与开始菜单条目会自动创建
v0.8.0 起安装包已使用 EV 代码签名证书签名，正常情况下不会出现「Windows 已保护你的电脑」的提示。如果仍然出现（旧版本安装包，或公司电脑安全策略较严），点击「更多信息 → 仍要运行」即可。
3. 首次启动
启动 StoryLoom 后：
- 首启引导：第一次打开会显示三步引导（配置 AI 供应商 / 建立第一部作品 / 开始创作 · 建设定集），之后直接进入书架。左侧导航依次是 书架 / 写作 / 设定集 / 商品库 / 发布 / MCP，底部是设置。
- 配置 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\ 下对应子目录 |
| 应用日志 | %LOCALAPPDATA%\com.storyloom.app\logs\ |
| API Key（加密） | 本机加密存储，不以明文落盘 |
开发版与正式版数据隔离：开发版的媒体目录、数据库使用
dev-前缀（如dev-storyboard_videos），与正式版互不干扰。
卸载
控制面板 → 程序与功能 → StoryLoom → 卸载。
卸载前若想保留稿件，请先在应用内导出完整工程包（见 导入导出与投稿），或手动备份
%APPDATA%\com.storyloom.app\目录。