命令行 · 写匠

写匠背后有一个命令行程序 aiwriter：建项目、写卡、导出这些活是它在做，桌面版把它们画成了界面。平时写作用不着它。想批量处理、写脚本，或者让 AI 编程助手替你动手，再来用它。

装进终端

打开写匠，进 设置 › 通用 ›「命令行工具」 那一行，点「安装到终端」。 macOS 会请你输一次电脑密码。装好之后打开「终端」（Windows 上安装写匠时已装好，新开一个 PowerShell 即可），敲：

aiwriter --help

看到「项目」「写作」「成品」「AI 与云」四组命令，就装好了。它跟着写匠一起升级，不用再装第二次。

写匠还在安装盘里、或者直接从「下载」里打开的时候，这一行会先请你把写匠拖进「应用程序」。

macOS 上不想要了：在终端里敲 sudo rm /usr/local/bin/aiwriter，写匠本身不受影响。

桌面版的 42 套模板，命令行里一样挑：


`aiwriter templates`	列出全部模板：图书、论文、长文、幻灯、个人、页册六类
`aiwriter new 雨夜 --template novel`	用「小说」模板建一个项目「雨夜」
`aiwriter projects ls`	列出你所有的项目，带字数、卡数

项目就是一个 <名>.aiw 文件夹，默认建在 ~/aiwriter 下（aiwriter projects dir 看得到）。在项目文件夹里敲命令，不用说是哪一个；在别处，加 --project 指一下：

cd ~/aiwriter/雨夜.aiw
aiwriter ls
aiwriter ls --project ~/aiwriter/雨夜.aiw

下面的 <编号> 用 aiwriter ls --json 里每张卡的 id。


`aiwriter ls`	按大纲顺序列出所有卡
`aiwriter ls --json`	同上，带每张卡完整的编号
`aiwriter show <编号>`	看一张卡的正文
`aiwriter add --title 第一章 --body 雨下了一整夜。`	新建一张卡
`aiwriter edit <编号> --stdin`	改正文：新正文从标准输入给，改之前那一版先留进历史
`aiwriter find 雨`	在这个项目里找
`aiwriter replace --help`	查找替换怎么用
`aiwriter rm <编号>`	删一张卡——进回收站，还原得回来
`aiwriter import ~/Downloads/旧稿.docx`	把旧稿收进来：Word、电子书、网页、字幕、md、txt 都行，原文件不动
`aiwriter tidy run <编号> --item punct`	规范标点；`aiwriter tidy list` 列出全部整理项
`aiwriter version log --path <卡>`	看这张卡存下的每一刻


`aiwriter insert list --kind diagram`	列出内置的图示；`--kind` 换成 `table`、`math`、`image`、`shape`、`jieling`，就是表格、公式、图标、形状、节令
`aiwriter layout list`	这个项目能选的版面
`aiwriter layout set <编号> 封面`	给一张卡标上「封面」版面
`aiwriter layout clear <编号>`	去掉版面，回到正文页

不给 --out，成品落在设置里的默认导出位置。


`aiwriter ask 雨夜`	把你写过的相关卡片摆出来（不联网）
`aiwriter analyze <编号>`	写作统计：整体、字词、句法、篇章、元话语、文风（在你电脑上算，不联网）
`aiwriter revise scan --all`	你反复改过的写法，替你把全书翻一遍，找出还没改到的同类地方；只给建议，不动正文
`aiwriter ai check --file 第一章.md`	云端 AI 校对一张卡，逐句给出改法；会员可用，先 `aiwriter auth login`