打包 .kip 与分发

把完整项目打成一个 .kip 故事包,交给桌面阅读器或网页书库导入,并安全地发布更新。

.kip 是 Kiny 的故事包:把作品清单、全部 .kin 源码、主题、角色表、图片、音频和字体等项目文件收进一个文件,方便下载和转发。Kiny 桌面阅读器与网页书库都以它作为导入格式。

它和独立网页解决的是两件事:独立网页让读者点开链接就读;.kip 让读者把作品导入自己的阅读应用和书架。

从编辑器打包

先修完问题面板里的错误。错误存在时,“导出故事包(.kip)…”会被禁用。

打开 文件 → 导出故事包(.kip)…,选择文件名与保存位置。项目若有未保存改动,编辑器会询问是否全部保存并继续;只有保存成功后才开始打包。默认文件名取作品名,例如 雾港之夜.kip

故事包会保留项目内的相对目录结构,同时跳过:

  • . 开头的隐藏文件和隐藏目录;
  • 项目里已有的 .kip,避免把上一次的包再套进去;
  • 带 Kiny 导出标记的独立网页目录,避免把同一套作品副本重复打包。

打包失败时,编辑器会报错,并清掉未写完的半成品。

它本质上是一份快照

.kip 记录的是点击导出那一刻已经保存到磁盘的项目。之后继续修改正文或替换资源,不会自动更新读者手里的旧包;需要重新导出并分发新文件。

同一个 .kip 每导入一次,桌面阅读器和网页书库都会把它当成一条新的书架记录,不会按作品名覆盖旧版。发布更新时可以让读者先导入新版、确认能打开,再自行删除旧条目。因为两次导入有各自的书架标识,旧条目的存档不会自动搬到新条目。

.kip 使用 ZIP 兼容的封装,源码和资源没有加密。不要把 API 密钥、私人笔记或其它不准备公开的文件放进项目目录;故事逻辑可以执行 JavaScript,也只应从可信来源导入故事包。

怎么交给读者

分发时只需提供生成的那一个 .kip 文件。可以放在下载页、网盘或版本附件里,也可以直接发给测试读者。不要先解压,也不要只挑出里面的 .kin 文件。

正式发布前做一次接收端测试:

  1. .kip 复制到项目目录之外,模拟读者真正拿到的文件。
  2. Kiny 阅读器的当前版本导入并从头读一遍开场。
  3. 再用网页书库导入,检查封面、主题、图片和声音。
  4. 建一份手动存档,退出阅读后确认可以继续。

读者侧的导入方式、书架和存档差异见下一篇读者怎么读。若不想让读者安装或导入任何东西,则使用导出独立网页