安装与启动
Windows 用户下载安装包，双击安装后从桌面或开始菜单启动。
下载：StarWeave-Studio-Setup-2.41.2.exe
安装位置：%LOCALAPPDATA%\Programs\星织工坊
数据位置：IndexedDB（浏览器存储），可在设置里导出备份不需要 Node.js、Android Studio 或其它编译软件；便携版解压后双击主程序即可。
第一次创作
- 打开「剧情」页，点「新建章节」。
- 点「添加指令」→ 台词，填说话人与文本。
- 继续添加背景、立绘、音乐，拖拽调整顺序。
- 点上方「预览」或指令行的 ▶ 从任意一行开始试玩。
- 发布前到「工具」页看问题清单与健康度。
指令速查
| 指令 | 用途 | 关键参数 |
|---|---|---|
| 台词 | 显示对话/旁白 | 说话人、文本、语音 |
| 背景 | 切换场景背景 | 素材、转场、时长 |
| 立绘 | 显示/移动/隐藏角色 | 角色、差分、位置 |
| 选项 | 分支选择 | 提示、选项、跳转、条件 |
| 条件 | 按变量跳转 | 条件组、目标、否则目标 |
| 变量 | 加减/赋值/切换 | 变量、操作、值 |
| QTE | 限时点击 | 秒数、次数、成功/失败 |
| 章节卡 | 章节过场 | 标题、副标题、时长 |
| 结局 | 结算并解锁结局 | 标题、正文 |
| 成就 | 触发成就 | 成就 |
完整 22 种指令在编辑器的「添加指令」面板里都有中文说明。
素材导入
素材页支持按钮、拖拽、整文件夹、ZIP、剪贴板粘贴、URL 六种导入方式。
- 图片：png / jpg / webp / gif / avif / bmp / svg
- 音频：mp3 / wav / ogg / flac / m4a / aac / opus
- 视频：mp4 / webm / mkv / avi / mov（可作背景）
- 字体：ttf / otf / woff / woff2（随工程打包）
大于 1.5MB 的图片会自动压缩到 2048px WebP；单文件上限 64MB。
打包 Windows
发布页 →「生成安装包 Setup.exe」，选择保存位置即可，不需要任何外部编译软件。
生成内容：
· Setup.exe（安装到 %LOCALAPPDATA%\Programs\作品名）
· 桌面 / 开始菜单快捷方式
· 安装器内置运行时与 7za，无需联网也可以生成免安装便携版文件夹，双击其中的 exe 直接运行。
打包 Android / TapTap
发布页 →「生成 Android APK」。编辑器内置 JRE、aapt2、apksigner、zipalign 与模板，填好信息后直接出已签名 APK。
- 游戏名称：工程设置里的作品名 → APK 应用名
- 包名：工程设置里的包名，留空自动生成
com.starweave.<工程id> - 版本：meta.version → versionName / versionCode
- 图标：工程设置里的图标（PNG）→ APK launcher icon
APK 使用内置调试签名，正式上架建议换成自己的 keystore；TapTap 后台上传即可。
Web 与 Steam
Web：导出 Web 包，解压后双击 index.html 即玩；也可以上传到任意静态站点。
Steam：导出 Steam 包，得到 game 目录、steam_appid.txt、depot 脚本与成就图标，用 steamcmd 上传。
steamcmd +login <账号> +run_app_build ../scripts/steam_app_build.vdf模板说明
新建工程时可选：空白、校园、悬疑、科幻、奇幻、日常、恋爱、恐怖。每套模板自带章节、占位台词、结局与开始场景，可直接改成自己的故事。
常见问题
导入大文件失败？
工程主存储已迁移到 IndexedDB；如果仍失败，检查磁盘/浏览器存储配额，或先压缩图片再导入。
打包 APK 失败？
确认安装包完整（resources/android 存在）；错误会显示缺少的组件名。杀毒软件可能拦截 java.exe，请加入白名单。
更新提示 SHA256 不一致？
服务器上的安装包与版本信息不一致。请在后台上传安装包并保存版本，系统会自动写入大小与 SHA256。
手机显示键盘说明？
请确认安装的是 APK（平台标记 android），而不是把 Windows 包放进手机。