上手实验:一条命令跑通 novel-writer

推荐路线:novel-writer(无需任何 API key)

零基础三步上手卡:如果你从没用过终端——Windows 按 Win 搜索"终端"或"PowerShell",Mac 按 Command + 空格 搜索"终端",打开后就是一个能敲字的黑框。敲命令、按回车,就这么简单。

前置条件:电脑装了 Node.js(自带 npm)。这是本课的推断,未经实测验证:npx 是 npm 自带命令,因此需要 Node.js 环境;实测记录本身没有记载环境要求。如果你的终端敲 npx -v 没有反应,先去 nodejs.org 装一个再回来。

打开终端,敲这一条命令:

npx -y [email protected] init my-novel --plugins authentic-voice

这条命令拆开看:

• npx -y:不全局安装,直接下载并运行指定版本,用完不污染你的系统环境。
• [email protected]:npm 上的包名和版本号。0.20.0 发布于 2025-10-26。
• init my-novel:在当前目录初始化一个叫 my-novel 的项目。
• --plugins authentic-voice:装上 authentic-voice 插件。

本课 2026-08-06 在本机实测执行成功:不需要任何付费 API key,不需要全局安装。这是本课三条路线里唯一做到这一点的。

跑完你会看到什么

生成的项目目录里包含(以下为实测记录):

my-novel/
├── spec/                        # 故事规格文档
├── stories/                     # 故事内容
├── experts/                     # 专家角色
├── .claude/commands/            # 斜杠命令定义
├── plugins/authentic-voice/     # 插件
└── .specify/

并且会自动执行 git init,总共生成 55 个 markdown 文件。

初始化输出里会告诉你七步命令流:

/constitution → /specify → /clarify → /plan → /tasks → /write → /analyze

先立创作宪法,再写故事规格,澄清模糊点,做计划,拆任务,写正文,最后综合验证。另外还有一组追踪命令:/plot-check、/timeline、/relations、/world-check、/track——它们就是把"一致性外置"落成了具体命令。

⚠️ 必讲卡点:斜杠命令不在终端里敲

这是新手卡死率最高的一个坑。

/specify、/write 这些斜杠命令,是在 AI 助手的对话框里使用的,不是在终端敲。初始化输出的提示原话就是让你"在 Claude Code 中打开项目"。

类比:微信里的 @ 只能在聊天框用,写在纸上没人会被叫到。

另外,命令前缀因 AI 助手而异(据项目 README,本课未逐一实测):Claude Code 用 /novel.命令,Gemini 用 /novel:命令。

进阶路线:Long-Novel-GPT(可选,需 API key)

如果你愿意折腾 Docker 且有可用的模型 API:

docker run -p 80:80 --env-file .env -d maoxiaoyuz/long-novel-gpt:latest

先下载 .env.example 改名为 .env 填好配置,然后访问 http://localhost。它 2.2 版本内置实时显示 API 调用成本,支持文心、豆包等国内可用的模型提供方。

诚实条款:以上依据项目 README(2026-08 核查),未经本课实测。

一个已知坑:容器启动后再改 .env 不会生效,必须关掉容器重新 docker run。类比:保温箱设定温度,设完再拧旋钮没用,得关机重设。

关于 gpt-author:路线已删除

原本这里有第三条路线,现在删了。理由上一节讲过:仓库停更两年、写死的模型 ID 全部退役,学员照做第一步就会报错。

但请注意区分——它作为"生成→自评→改进"链式调用的设计案例依然成立。

工具会停更,方法论比工具活得久。

这句话是本课认同并采纳的经验之谈,不是可验证的实证结论,请知道它的分量。这个区分本身就是一堂课。

🔧 动手做:跑通并记录你的第一手数据(10 分钟)

1. 打开终端,cd 到一个你放得下新文件夹的位置(桌面即可)。
2. 执行:npx -y [email protected] init my-novel --plugins authentic-voice
3. 跑完后截图:终端的成功输出 + 生成的目录结构。
4. 在《工具选型报告》里记录你的真实花费:0 元、0 个 API key。这是你自己测出来的一手数据,可信度高于任何 README 自述。
5. 打开 spec/ 目录,随便看一个 markdown 文件,写一句话:它和你之前手工做的设计包,哪一部分是对应的?

你会看到:my-novel 目录存在,里面有 spec/、stories/ 等子目录,在该目录下敲 git status 能正常响应。

为什么:第 4 步是本节的真正价值——你亲手把一个"别人说的成本"换成了"我测的成本"。第 5 步则是让你意识到:工具生成的是骨架,内容还得靠你之前的设计功底去填。

/constitution 我要写一部【题材,如都市轻悬疑】的长篇小说,主角是【一句话人设】。请帮我确立这部书的创作宪法:文风、价值观、以及绝对不写的内容(禁区)。写完后先让我确认,不要直接往下走。