跳到正文
StoryLoom
Esc
使用指南目录

入门

安装指南

StoryLoom 安装指南:Windows 10/11(x64 NSIS)、macOS 11+(Apple Silicon 与 Intel dmg)、Linux(AppImage/deb)三平台安装步骤,含 WebView2 缺失与旧版本安装提示的处理办法。

系统要求

平台 最低版本 支持状态 备注
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 后:

  1. 首启引导:第一次打开会显示三步引导(配置 AI 供应商 / 建立第一部作品 / 开始创作 · 建设定集),之后直接进入书架。左侧导航依次是 书架 / 写作 / 设定集 / 商品库 / 发布 / MCP,底部是设置。
  2. 配置 AI 供应商:到「设置 → AI 供应商」添加至少一个对话供应商并填入 API Key,否则 AI 功能不可用(写作、设定集等本地功能不受影响)。详见 配置 AI 供应商。
  3. 创建第一个项目:见 创建第一个项目。

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\ 目录。

下一步

最后更新: