打包 .kip 与分发
把完整项目打成一个 .kip 故事包,交给桌面阅读器或网页书库导入,并安全地发布更新。
.kip 是 Kiny 的故事包:把作品清单、全部 .kin 源码、主题、角色表、图片、音频和字体等项目文件收进一个文件,方便下载和转发。Kiny 桌面阅读器与网页书库都以它作为导入格式。
它和独立网页解决的是两件事:独立网页让读者点开链接就读;.kip 让读者把作品导入自己的阅读应用和书架。
从编辑器打包
先修完问题面板里的错误。错误存在时,“导出故事包(.kip)…”会被禁用。
打开 文件 → 导出故事包(.kip)…,选择文件名与保存位置。项目若有未保存改动,编辑器会询问是否全部保存并继续;只有保存成功后才开始打包。默认文件名取作品名,例如 雾港之夜.kip。
故事包会保留项目内的相对目录结构,同时跳过:
.开头的隐藏文件和隐藏目录;- 项目里已有的
.kip,避免把上一次的包再套进去; - 带 Kiny 导出标记的独立网页目录,避免把同一套作品副本重复打包。
打包失败时,编辑器会报错,并清掉未写完的半成品。
它本质上是一份快照
.kip 记录的是点击导出那一刻已经保存到磁盘的项目。之后继续修改正文或替换资源,不会自动更新读者手里的旧包;需要重新导出并分发新文件。
同一个 .kip 每导入一次,桌面阅读器和网页书库都会把它当成一条新的书架记录,不会按作品名覆盖旧版。发布更新时可以让读者先导入新版、确认能打开,再自行删除旧条目。因为两次导入有各自的书架标识,旧条目的存档不会自动搬到新条目。
.kip 使用 ZIP 兼容的封装,源码和资源没有加密。不要把 API 密钥、私人笔记或其它不准备公开的文件放进项目目录;故事逻辑可以执行 JavaScript,也只应从可信来源导入故事包。
怎么交给读者
分发时只需提供生成的那一个 .kip 文件。可以放在下载页、网盘或版本附件里,也可以直接发给测试读者。不要先解压,也不要只挑出里面的 .kin 文件。
正式发布前做一次接收端测试:
- 把
.kip复制到项目目录之外,模拟读者真正拿到的文件。 - 用Kiny 阅读器的当前版本导入并从头读一遍开场。
- 再用网页书库导入,检查封面、主题、图片和声音。
- 建一份手动存档,退出阅读后确认可以继续。