1. 完成第一份温室故事
准备一个纯文本编辑器、Python 3.11 或更新版本,以及约 20 分钟。无需编程经验或 StoryOrbit 账号。我们要创作《温室里的最后一束光》:闭馆前,访客来到 Rowan 身边,一株幼苗有些萎蔫。读者可以帮忙、提问,也可以离开。
从完整起始稿出发
Section titled “从完整起始稿出发”下载页面下方的 ZIP,解压到新文件夹。在能看到 check.py 与 requirements.txt 的解压目录内打开终端。start/pack.json 是练习稿,finished/pack.json 是完整参考答案。两份都是有效的 Pack。建议另存副本再修改。
macOS 或 Linux:
python3 -m venv .venv.venv/bin/python -m pip install -r requirements.txt.venv/bin/python check.py start/pack.jsonWindows PowerShell:
py -3 -m venv .venv.venv\Scripts\python.exe -m pip install -r requirements.txt.venv\Scripts\python.exe check.py start/pack.json首次安装依赖需要联网,之后校验可以离线运行。成功时会显示 Structural check passed: Creator Pack 0.3 和 Schema 的 SHA-256。如果找不到 Python,先安装 Python 3.11 或更新版本;如果找不到 check.py,请切换到解压目录。
写邀请,不替读者作决定
Section titled “写邀请,不替读者作决定”打开 start/pack.json。JSON 用双引号包住名称和字符串,用逗号分隔字段,用方括号表示列表,用花括号表示对象。不能写注释,也不能保留末尾多余的逗号。请使用纯文本编辑器,而不是排版软件。
将 manifest.title 改为 温室里的最后一束光,将 manifest.revision 从 1 改为 2。保留 pack_id、入口的 id arrival 及对应的 runtime 入口。ID 用来连接结构,标题才是给人看的名称。
替换 entries[0].opening 中的字符串,用一个短段落呈现长凳、Rowan 和干燥的土壤,留出可以回应的事物。“你立刻信任 Rowan 并拿起水壶”替读者决定了行动;“Rowan 放下一只小浇水壶”则保留了选择空间。下方完成稿只是一种写法,不是必须照抄的句子。
再次执行校验,然后把命令最后的路径改为 finished/pack.json 检查参考答案。预期:两份都通过,练习稿出现新标题和一个非空开场段落。这里一个段落字符串不能包含换行;后续课程会使用多个段落组成的列表。
理解“通过”的含义
Section titled “理解“通过”的含义”校验器只对照附带的确切 Schema 检查 JSON 结构,不运行故事、不评价文笔、不检查图片字节、不批准权利,也不发布作品。示例的来源记录保留待审核状态。第 9 课会解释服务准入与私有试玩。
试着暂时删掉开场,观察错误中的 JSON 路径,然后恢复并确认通过。现在你拥有一份完整的小草稿,可以继续创作,而不是只有从字段文档中复制来的片段。
请以 UTF-8 纯文本保存,并保留 pack.json 文件名。运行校验器前先保存修改:它读取磁盘上的文件,编辑器中尚未保存的内容不会计入检查结果。
在本地检查作品
在解压目录中创建环境并安装一次固定版本的依赖,然后检查两份文件。修改之后再次检查起始稿。每课都可以使用相同命令。
macOS / Linux
python3 -m venv .venv
.venv/bin/python -m pip install -r requirements.txt
.venv/bin/python check.py start/pack.json
.venv/bin/python check.py finished/pack.jsonWindows PowerShell
py -3 -m venv .venv
.venv\Scripts\python.exe -m pip install -r requirements.txt
.venv\Scripts\python.exe check.py start/pack.json
.venv\Scripts\python.exe check.py finished/pack.json完成稿的预期输出: Structural check passed: Creator Pack 0.3 随后显示确切 Schema SHA-256。这是结构检查,不代表服务准入或真实试玩通过。
完成稿中的可用片段
此片段直接取自经过检查的下载文件,并非完整 Pack。请在 start/pack.json 中修改相应字段,或对照 finished/pack.json。
{
"manifest": {
"pack_id": "last-light-greenhouse-zh-cn",
"revision": 2,
"title": "温室里的最后一束光",
"language": "zh-CN",
"source_documents": []
},
"opening": [
"最后一束阳光落在温室的长凳上。Rowan 站在一株低垂的幼苗旁,放下一只小浇水壶。 “还没关门呢。愿意和我一起看看这个小家伙吗?” 土壤摸起来很干。身后回家的小路依然敞开着。"
]
}