从零到第一章
一条能照做的完整路径:安装、新建项目、建卷章场景、写第一段、保存与快照、导出;每步写清会看到什么、卡住时怎么办。
一条照着做就能走完的路径
从安装到导出第一章,全程不需要联网。每一步都写清会看到什么、卡住时先检查哪里。
第 1 步:安装并启动
- 在下载区下载当前版本的
.exe安装包,按首页的 SHA-256 核对文件。 - 双击安装。安装范围是当前 Windows 用户,不需要管理员权限。
- 首次运行可能出现 SmartScreen「未知发布者」提示——安装包未做代码签名,核对哈希后选「更多信息 → 仍要运行」。
- 启动后看到项目列表与「新建项目」。
出错怎么办:提示「更新服务不可达」只影响检查更新,不影响写作;可直接从官网下载新版本覆盖安装。
第 2 步:新建项目
- 在项目页点「新建项目」。
- 选择「父目录」,填「书名」。书名会作为项目目录名,上限 64 字,不能包含
/ \ : * ? " < > |。 - 点「创建项目」,回到项目列表能看到刚建的项目卡片。
出错怎么办:提示「目录……已经是一个项目」或「目录……非空」时,换一个书名或父目录;提示「无法创建父目录」时,确认该路径存在且当前用户可写。
第 3 步:建卷、章、场景
- 打开项目,进入工作台,左侧是「章节与场景」树。
- 点栏目标题旁的「+」新建卷;在卷行点「+章」新建章;在章行点「+场景」新建场景。
- 新建场景会生成一个空
.md文件,路径形如manuscript/vol-01/ch-001/s-001.md。
出错怎么办:如果项目提示「只读模式」,通常是项目已在另一个窗口打开,或目录所在磁盘有写保护;关闭另一个窗口,或把项目复制到可写磁盘。
第 4 步:写第一段
- 点刚建好的场景,光标进入正文编辑器。
- 直接输入。停止输入后会自动保存,状态栏显示「已保存 · 时:分:秒」。
- 想立刻落盘时按 Ctrl + S。
出错怎么办:提示「写入文件失败(重试 3 次后仍无法替换,原文未改动)」时,后半句会跟具体原因(被其他程序独占 / 只读或没有写权限 / 磁盘空间不足 / 路径不存在)。按原因关闭占用程序、去掉只读或清理磁盘后,按 Ctrl + S 重试;原文未改动。
第 5 步:保存与快照
- 确认状态栏没有「有未保存的修改…」。
- 打开「章节历史」,点「完成本章(新建快照)」。
- 快照列表出现新的一条,记录本章所有场景文件的清单与内容。
出错怎么办:磁盘满会导致快照失败,先清理空间再重试;失败不会改动正文,未完成的快照目录会被清理。
第 6 步:导出第一章
- 顶栏「导出方式」选「单文件 .md」「单文件 .txt」「分章文件」或「单文件 .docx(Word)」。
- 点「导出」,默认写到项目的
exports/目录。 - 到该目录确认文件内容与章节顺序;Word 的模板开关见 导出 → Word 导出。
出错怎么办:提示目录不存在或没有权限时,在 设置 → 数据与目录 → 导出目录 换一个可写目录。