全部命令 · 写匠

命令行 aiwriter 的每一条命令，按 aiwriter --help 的四组排。怎么装进终端、先学哪几条，见命令行入门。

这一页跟着最新版写；你装的版本旧一点的话，以 aiwriter --help 为准。

每条命令加 --help 看完整用法。例如 aiwriter find --help。也可以写 aiwriter help find。

项目 · 新建、打开、项目设置、多项目、偏好、回收站、诊断日志

命令	做什么
`aiwriter new`	新建项目。
`aiwriter init`	把一个已有文件夹设为写匠项目。
`aiwriter open`	打开既有项目并登记进项目库。
`aiwriter classify`	看一个路径归谁管、打开它该怎么办。
`aiwriter read-file`	读一份不属于任何项目的文件（散页）。
`aiwriter write-file`	把正文写回一份散页（正文从标准输入读）。
`aiwriter deinit`	取消写匠管理：从项目库撤下，项目文件夹里的东西都不动。
`aiwriter restore-tree`	项目结构文件坏了时，换回上一版或某一份备份。
`aiwriter check-tree`	按 schema 检查项目结构文件（tree.json、cache.json）。
`aiwriter tidy-lost`	列出树上多出来的「丢失」记录；加 --apply 才收掉。
`aiwriter portable-names`	列出名字要改的卡；加 --apply 才改成通用的名字。
`aiwriter project`	单个项目：看与改项目设置、复制成新项目、给同号的副本换编号。
`aiwriter site-root`	找网站根目录：以「/」开头的图片地址，在哪个文件夹下找得到最多（只看，不设）。
`aiwriter projects`	多项目管理（列表 / 统计 / 从模板新建）。
`aiwriter templates`	列出项目模板（新建项目可选骨架）。
`aiwriter pref`	读写本机的一条设置（跟着当前账号）。
`aiwriter prefs`	你的偏好：版式、排版指令、规则、参考资料、文风。
`aiwriter beta`	内测功能开关（本机·默认关·重启写匠后生效）。
`aiwriter trash`	回收站：`restore` 还原得回来，`purge` / `rm` 彻底删除不可恢复。
`aiwriter log`	诊断日志：打开目录、在访达中选中、导出。
`aiwriter licenses`	写匠（命令行与桌面）用到的开源组件与许可证全文（离线）。

写作 · 卡片、大纲、查找替换、引用、版本

命令	做什么
`aiwriter add`	新增卡片。
`aiwriter add-image`	把一张图收进卡片所在文件夹的 images/，印出正文里该写的地址。
`aiwriter ls`	列出所有卡（按大纲顺序）。
`aiwriter show`	看卡正文。
`aiwriter edit`	改正文；改之前那一版先留在历史里，可以回去。
`aiwriter set-body`	只写正文，不留一版（写匠自动保存用）。下次留一版时，这些改动一并记下。
`aiwriter insert-at`	在正文的指定位置插入文本（按字节偏移，光标定位用）。
`aiwriter rename`	改标题（=改文件/目录名·id 不变）。
`aiwriter status`	设状态标记：待写 / 草稿 / 修改中 / 定稿 / 归档。
`aiwriter tag`	给卡片贴标签（时间 / 情绪 / 地点 / 人物 / 母题 / 其他）。
`aiwriter note`	卡片备注：写给自己看的话，不进成品。
`aiwriter layout`	版面：给卡标封面、正文页、金句页这类版面，怎么排由这本书的版式卡定。
`aiwriter insert`	插入：插一张卡（空白卡、带版面的卡），可撤回。同一个 `--idem` 重试不会多插。
`aiwriter mv`	移动到某个文件夹（--to <文件夹 id>；省略=移到项目根）。
`aiwriter up`	同级上移。
`aiwriter down`	同级下移。
`aiwriter move-to`	拖拽落点：移到某张卡之前或之后。
`aiwriter sort`	按名称 / 按修改时间重排某一层（只改顺序·一个文件都不动）。
`aiwriter rm`	删进回收站（还原得回来，见 `trash`）。
`aiwriter import`	把外面的文件或文件夹收进这个项目。
`aiwriter split`	把一张卡拆成一个文件夹和几张子卡。
`aiwriter reflow`	一句一段：把一张卡的正文按句拆开，每句成一段，仍是同一张卡。
`aiwriter dup`	复制一张卡（或一整个文件夹），副本紧跟在原来那一张后面。
`aiwriter merge`	组合文件夹的子卡 → 一张卡（拆分的逆操作）。
`aiwriter unmerge`	还原组合：把组合成这张的那几张从回收站拿回来。
`aiwriter order`	把一层排成给定的次序（`--ids` 列先后）。
`aiwriter find`	全文检索（这本作品里找；`--scope` 只找某一篇/某一章）。
`aiwriter replace`	查找替换：把找到的字换成另一段字。
`aiwriter refs`	这张卡的引用：它引了谁、谁引了它。
`aiwriter link`	这张卡的地址（引用它的时候写这个）；加 --list 把几张卡排成一串链接。
`aiwriter version`	版本历史：项目里存下的每一刻，回得去。
`aiwriter md`	一张 md 卡解析成的树：`aiwriter md ast <卡>`。
`aiwriter doc`	卡的写匠文档树：`aiwriter doc tree <卡>`。

成品 · 拼接、纳入成品、导出、字体

命令	做什么
`aiwriter compile`	按大纲顺序把整个项目拼成全文（Markdown），排掉的那几节也在内，不是成品。
`aiwriter stitch`	把某个节点以下收进成品的内容按大纲顺序拼成一篇 Markdown。
`aiwriter scope-of`	这张卡在哪一卷：收录它的目录卡里最小的那张。
`aiwriter work`	设定或查看哪些节点纳入成品。
`aiwriter pdf`	导出 PDF（Typst 排版）。
`aiwriter docx`	导出 Word 文档（.docx）。
`aiwriter ebook`	导出电子书（.epub）。
`aiwriter latex`	导出 LaTeX 源码包（.zip）。
`aiwriter typst`	导出 Typst 源码包（.zip）。
`aiwriter html`	导出网页（单个 .html）。
`aiwriter export-md`	导出 Markdown。
`aiwriter summary`	导出 SUMMARY.md（给 mdBook 与读 SUMMARY 的脚本用·--out 落文件）。
`aiwriter preview-typst`	把 Typst 卡、标准输入里的 Typst 源或 PDF 文件渲染成逐页 PNG。
`aiwriter preview-images`	卡片编辑预览要画的图：正文从标准输入读，交出每个图片地址该画哪个文件。
`aiwriter preview-book`	把整部作品渲染成逐页 PNG。
`aiwriter check-images`	列出正文里进不了成品的图片（找不到 / 以「/」开头 / 网上的 / 出了项目…）。
`aiwriter fetch-images`	把正文里引用的网上图片（http / https）下载进这台电脑的缓存。
`aiwriter font`	排版字体：列出与下载。
`aiwriter style`	给目录卡指定版式卡：这一卷用哪张 typst 卡排。
`aiwriter arrange`	目录卡里调次序、放进或移出一项（连同它底下的子项）。
`aiwriter book`	成品的封面、目录、版式：用哪张封面、按哪张目录卡编、用哪张版式卡排。

AI 与云 · 问答、检索索引、建议、统计、引擎与模型、登录与云备份

命令	做什么
`aiwriter ask`	问一句，把你写过的相关卡片摆出来。
`aiwriter answer`	只要一段回答：命中与前几轮从标准输入读（AI 对话 · Pro 权益）。
`aiwriter chat`	你问过的那些话（列出来 / 看一次 / 删掉 / 开一个新的）。
`aiwriter index`	给这本作品建检索索引（只重建改过的卡·断网可用·不下模型）。
`aiwriter corpus`	跨项目语料库（你写过的一切）。
`aiwriter suggest`	让 AI 提修改建议：句子顺不顺，过渡、评价这类话用得恰不恰当。
`aiwriter apply`	应用一条建议（从标准输入读 JSON）。正文已被改动就不应用，不覆盖你后来写的字。
`aiwriter analyze`	写作统计：整体 / 字词 / 句法 / 篇章 / 元话语 / 文风。本机算，不联网、不计费。
`aiwriter annotate`	标出正文里的元话语（词表比对·纯本地·不联网、不计费）。
`aiwriter terms`	术语：统计成品里反复用到的专门词。本机算，不联网、不计费。
`aiwriter record`	改稿记录：校对提了什么、你怎么处置的。只记事实，不判对错。
`aiwriter revise`	从你亲手改过的地方学，找出别的章里同样要改的（只给建议，不动正文）。
`aiwriter engine`	选用本地引擎或云端引擎，或查看现在用的是哪个。
`aiwriter model`	向量模型（AI 检索的底座）：看状态 / 下载 / 删除 / 本机开关。
`aiwriter ai`	云端 AI 能力（Pro 权益·需先 `aiwriter auth login`）。
`aiwriter auth`	云端账号：登录、退出登录、看状态。
`aiwriter backup`	云备份：把你全部的项目加密备份到云端，换台电脑也取得回来。
`aiwriter serve`	后台：在写作之外替你做备份、建检索索引（桌面打开时自动起，关掉就停）。

带子命令的那几条

上面几条后面还要再接一个词，比如 aiwriter backup status。

aiwriter version

版本历史：项目里存下的每一刻，回得去。

命令	做什么
`aiwriter version status`	看版本历史开没开、记在哪个仓。
`aiwriter version save`	存一刻。没有改动就不存；跳过的文件逐条列出。
`aiwriter version log`	列出存下的每一刻（新的在前·分页）。
`aiwriter version show`	打印某一刻某个文件的正文（只读·不改磁盘）。
`aiwriter version counts`	每张卡各在多少刻里改过。
`aiwriter version migrate`	把旧的历史点并进版本历史，每一点保留原来的时间。
`aiwriter version restore`	把一个文件回滚到某一刻（回滚前那一版先存进历史，还能回去）。
`aiwriter version deleted`	列出历史里删过、现在已经不在的卡（回收站里没有了的也在内；只读）。
`aiwriter version recover`	拿回一张删过的卡：按删之前那一版另建一张，放回原来的文件夹，不覆盖现有的卡。
`aiwriter version record-check`	查早先的版本历史里有没有混进改稿记录（只读）。
`aiwriter version slim`	给版本历史瘦身：只留文字卡和作品结构，图片等不再占历史的地方。
`aiwriter version pack`	把版本历史里零散的小文件打成一个包，占的地方更小。
`aiwriter version relocate`	把写匠以前建在项目根的版本历史挪进项目的 `.aiwriter/` 里。
`aiwriter version where`	项目此刻在 git 仓的哪个分支、是不是另一个工作树。

aiwriter chat

你问过的那些话（列出来 / 看一次 / 删掉 / 开一个新的）。

命令	做什么
`aiwriter chat ls`	列出最近的对话。
`aiwriter chat show`	看某一次对话说了什么。
`aiwriter chat rm`	删掉某一次对话（连同里面的问答）。
`aiwriter chat new`	开一个新对话。
`aiwriter chat add`	往某次对话里记一轮问答（问句 + 回话 + 当时摆出来的那批卡片）。
`aiwriter chat answer`	把小文的回答补记到已经记下的那一轮。

aiwriter tag

给卡片贴标签（时间 / 情绪 / 地点 / 人物 / 母题 / 其他）。

命令	做什么
`aiwriter tag set`	设某一维的值（只替换这一维，不动别的维）。
`aiwriter tag rm`	删标签：给了 `--value` 删那一条，不给就删这一维全部。
`aiwriter tag list`	看标签。不带参数看整个项目的维度总览。`--card` 看某张卡，`--dim` 看某一维下有哪些卡。

aiwriter style

给目录卡指定版式卡：这一卷用哪张 typst 卡排。

命令	做什么
`aiwriter style set`	指定版式卡，卡片编号或短号都行。用法：`aiwriter style set <目录卡> <版式卡>`。
`aiwriter style unset`	取消指定，回到按导出时选的版式排。
`aiwriter style show`	看这张目录卡指定了哪张版式卡。

aiwriter arrange

目录卡里调次序、放进或移出一项（连同它底下的子项）。

命令	做什么
`aiwriter arrange move`	挪一项（连同子项）到另一行的前、后或里面。
`aiwriter arrange insert`	把一张卡放进目录卡，插在某一行的前、后或里面。
`aiwriter arrange remove`	移出一项，卡片文件不动。用法：`aiwriter arrange remove <目录卡> <行号>`。
`aiwriter arrange undo`	撤回一次挪、放、移。从标准输入读那一次 `--json` 输出里的 `receipt`。

aiwriter book

成品的封面、目录、版式：用哪张封面、按哪张目录卡编、用哪张版式卡排。

命令	做什么
`aiwriter book show`	看成品现在的封面、目录、版式、注释；给 `--arrange` 看那一卷自己的封面。
`aiwriter book set`	改几项，没给的照旧。例如 `aiwriter book set --style manuscript`。
`aiwriter book candidates`	封面、目录、版式各能选哪些卡。版式只列只有规则的卡与正在用的。
`aiwriter book page-shape`	这本书的版式排出来，页面是什么形状：页宽、页高、宽高比、是不是横向。

aiwriter work

设定或查看哪些节点纳入成品。

命令	做什么
`aiwriter work show`	看成品现在收了哪些（不给 id 看整体；给了 id 看那一个节点）。
`aiwriter work in`	收进成品（不给 id = 项目根）。
`aiwriter work out`	排出成品：导出与拼接都不带它（不给 id = 项目根）。
`aiwriter work follow`	跟着上一级：清掉这个节点自己的设定，由上一级决定（不给 id = 项目根）。

aiwriter corpus

跨项目语料库（你写过的一切）。

命令	做什么
`aiwriter corpus find`	跨项目全文检索（你写过的一切）。
`aiwriter corpus register`	把当前项目登记进语料库。
`aiwriter corpus ls`	列已登记的项目。

aiwriter projects

多项目管理（列表 / 统计 / 从模板新建）。

命令	做什么
`aiwriter projects ls`	列出项目库里的项目，带字数、卡数。
`aiwriter projects stats`	当前项目统计（--project 指定其他）。
`aiwriter projects dir`	查看当前项目根位置（默认 `<家目录>/aiwriter`·可自定义）。
`aiwriter projects move-to`	把项目库里的项目搬到新目录，复制、核对后删掉旧的。散落各处的项目一并收拢。
`aiwriter projects new`	从模板新建项目 → `<dir>/<title>.aiw`。
`aiwriter projects forget`	从项目库移出（只删登记，不碰磁盘上的文件）。
`aiwriter projects relink`	项目文件夹改名或挪动后，给出新位置把它认回来（只改登记，不碰文件）。
`aiwriter projects prune`	从项目库移出文件夹已不在的项目。只删登记，不碰磁盘上的文件。访问不到的跳过。
`aiwriter projects trash`	项目回收站，放 `projects rm` 删掉的项目。可以列出、还原、清空，或彻底删除一个。
`aiwriter projects trash ls`	列已删项目。
`aiwriter projects trash restore`	还原一个已删项目。回收站路径见 `aiwriter projects trash ls`。
`aiwriter projects trash purge`	清空已删项目：彻底删除全部（不可恢复）。
`aiwriter projects trash rm`	彻底删除一个已删项目，删了收不回。回收站路径见 `aiwriter projects trash ls`。
`aiwriter projects rm`	删除项目：移进写匠回收站，可以还原。同时从项目库移出。项目放在哪里都行。

aiwriter project

单个项目：看与改项目设置、复制成新项目、给同号的副本换编号。

命令	做什么
`aiwriter project settings`	列出这个项目的全部设置：名字、现在的值、一句说明。
`aiwriter project set`	改一项设置；`--clear` 清掉回到默认。
`aiwriter project copy`	把一个项目复制成新项目 → `<dir>/<新名>.aiw`（版本历史不带）。
`aiwriter project renumber`	给这个项目换一个新编号。在访达里复制出来、与另一个项目同号时用。换了之后两个项目各自备份。

aiwriter pref

读写本机的一条设置（跟着当前账号）。

命令	做什么
`aiwriter pref get`	读一条偏好。
`aiwriter pref set`	写一条偏好。

aiwriter beta

内测功能开关（本机·默认关·重启写匠后生效）。

命令	做什么
`aiwriter beta list`	列出内测功能与开没开。
`aiwriter beta on`	打开一项：`aiwriter beta on <id>`（重启写匠后生效）。
`aiwriter beta off`	关上一项：`aiwriter beta off <id>`（重启写匠后生效）。

aiwriter layout

版面：给卡标封面、正文页、金句页这类版面，怎么排由这本书的版式卡定。

命令	做什么
`aiwriter layout set`	给这张卡标一个版面，如封面、正文页、金句页。`--json` 返回 `{id, layout}`。
`aiwriter layout clear`	去掉这张卡的版面，回到正文页。`--json` 返回 `{id, layout: null}`。
`aiwriter layout list`	列出这本书能选的版面（版式卡里定义的那几种）。
`aiwriter layout preview`	出缩略图：用这张卡自己的内容，在这本书能选的每种版面下各排一页。头一张是不标版面的样子。

aiwriter insert

插入：插一张卡（空白卡、带版面的卡），可撤回。同一个 --idem 重试不会多插。

命令	做什么
`aiwriter insert list`	列内置的款。只读。
`aiwriter insert text`	交出要插进编辑缓冲区的文字。只读，不改卡片。缓冲区全文从标准输入读。
`aiwriter insert apply`	插一张卡：建在锚卡后面、同一层，可以同时编进一张目录卡。
`aiwriter insert undo`	撤回一笔插入：目录卡里那一行删掉、版面去掉、新卡进回收站。

aiwriter trash

回收站：restore 还原得回来，purge / rm 彻底删除不可恢复。

命令	做什么
`aiwriter trash ls`	列回收站。
`aiwriter trash restore`	还原一项（name 取自 `trash ls`）。
`aiwriter trash purge`	清空本项目回收站：彻底删除全部已删卡片/文件夹（不可恢复）。
`aiwriter trash rm`	彻底删除一项（name 取自 `trash ls`·不可恢复）。

aiwriter md

一张 md 卡解析成的树：aiwriter md ast <卡>。

命令	做什么
`aiwriter md ast`	一张 md 卡解析成的树。`--json` 返回 `{id, 树}`。

aiwriter doc

卡的写匠文档树：aiwriter doc tree <卡>。

命令	做什么
`aiwriter doc tree`	卡的写匠文档树。`--json` 返回 `{id, 树}`。

aiwriter note

卡片备注：写给自己看的话，不进成品。

命令	做什么
`aiwriter note show`	看这张卡的备注。`--json` 返回 `{id, 有, 正文, 指纹, 图}`。没有备注时 `有` 为 false，正文为空。
`aiwriter note set`	写这张卡的备注。正文为空就是删掉备注里的字，图留着。`--json` 返回 `{id, 指纹}`。
`aiwriter note rm`	删这张卡的备注，连同里面的图，进回收站。`note restore` 取得回来。
`aiwriter note restore`	取回这张卡最近一次删掉的备注。这张卡已有备注时不取。
`aiwriter note ls`	列出有备注的卡。卡已不在的另列一处。
`aiwriter note add-image`	把一张图收进这张卡的备注，印出备注里该写的地址。

aiwriter terms

术语：统计成品里反复用到的专门词。本机算，不联网、不计费。

命令	做什么
`aiwriter terms collect`	采集高频术语：列出候选与译名对照。
`aiwriter terms keep`	把术语、译名对照记进这个项目的参考（一次记成一条）。
`aiwriter terms unkeep`	撤回一次记进：删掉那一条采集来的参考。

aiwriter engine

选用本地引擎或云端引擎，或查看现在用的是哪个。

命令	做什么
`aiwriter engine use`	设默认引擎。
`aiwriter engine status`	看现在的引擎，不计费。
`aiwriter engine local`	本地引擎现在的状态：装没装、在不在跑。不联网。
`aiwriter engine abilities`	列出本地引擎的三件活儿（对话 / 校对 / 排版）各用哪个模型。
`aiwriter engine probe`	探测引擎通不通、往返多少毫秒。不计费。

aiwriter model

向量模型（AI 检索的底座）：看状态 / 下载 / 删除 / 本机开关。

命令	做什么
`aiwriter model status`	看向量模型在不在、下了多少。本机 AI 索引关着时，`--json` 的 `ai_index_off` 为真。
`aiwriter model download`	下载向量模型（断点续传；已经下好就跳过）。
`aiwriter model remove`	删掉本机的向量模型（没下完的一并删）。
`aiwriter model off`	本机不建 AI 索引：不算向量，对话里只按关键词找；已经算好的留着，再打开接着用。
`aiwriter model on`	重新打开本机的 AI 索引。
`aiwriter model warm`	预热向量模型，让升级后第一次按意思搜不用等。

aiwriter serve

后台：在写作之外替你做备份、建检索索引（桌面打开时自动起，关掉就停）。

命令	做什么
`aiwriter serve status`	后台在不在跑、有哪些活。
`aiwriter serve submit`	交给后台一件事：备份、补检索索引或预热（索引用 --project 指定项目）。
`aiwriter serve stop`	让后台停下。

aiwriter backup

云备份：把你全部的项目加密备份到云端，换台电脑也取得回来。

命令	做什么
`aiwriter backup run`	现在备份一次。
`aiwriter backup status`	用了多少空间、每台电脑上次什么时候备份。
`aiwriter backup skipped`	列出没备份的大文件：压缩包、音频、视频、安装包、超过 50 MB 的文件。
`aiwriter backup keep`	这个大文件也备份。
`aiwriter backup list`	列出云端的每一次备份。
`aiwriter backup restore`	把云端的备份取回这台电脑的新位置，已有的东西不动。
`aiwriter backup delete`	删掉云端的全部备份（这台电脑上的稿子不受影响）。
`aiwriter backup auto`	看或设自动备份：不给是看，on 打开，off 关闭。

aiwriter auth

云端账号：登录、退出登录、看状态。

命令	做什么
`aiwriter auth login`	登录：默认走邮箱验证码。
`aiwriter auth logout`	退出登录（这台电脑的登录在云端一并作废）。
`aiwriter auth status`	查登录状态。
`aiwriter auth handoff-token`	生成一次性登录令牌，打印到标准输出。未登录时报错。

aiwriter prefs

你的偏好：版式、排版指令、规则、参考资料、文风。

命令	做什么
`aiwriter prefs list`	列出偏好（不给类型就全列）。
`aiwriter prefs show`	打印一条偏好的内容。
`aiwriter prefs add`	加一条：`--file <文件>` 或把内容经管道喂进标准输入。
`aiwriter prefs remove`	删一条：移入偏好回收站，还原得回来（见 `prefs trash`）。
`aiwriter prefs trash`	偏好回收站：删掉的偏好先进这里，`restore` 还原得回来。
`aiwriter prefs trash ls`	列偏好回收站。
`aiwriter prefs trash restore`	还原一条（编号取自 `prefs trash ls`）。原来的名字已被新的占了，还原成「名字（还原）」。
`aiwriter prefs trash rm`	从回收站移除一条（编号取自 `prefs trash ls`·不可恢复）。
`aiwriter prefs trash purge`	清空偏好回收站（不可恢复）。
`aiwriter prefs disable`	停用一条：留着，但不再自动带上。只认 reference、prompt、view。
`aiwriter prefs export`	导出偏好到一个文件（规则、参考资料、版式、排版指令、视角、文风）。
`aiwriter prefs import`	从导出的文件导入偏好：先说新增、相同、冲突各几条，冲突默认保留你的。
`aiwriter prefs enable`	恢复停用的那一条（内置视角默认停用的也用它启用）。
`aiwriter prefs never`	记一条规则：别把「原文」改掉。不给 `--becomes`，就是任何改动都别提。
`aiwriter prefs reader`	设视角的读者是谁、在做什么，内置视角「实务工作者」要用。不给这句话就清掉，用时从稿子里推断。
`aiwriter prefs todo`	列出待处理的偏好：没启用的、没搬过来的。
`aiwriter prefs ai`	AI 做版式（云端 · Pro 权益 · 需先 `aiwriter auth login`）。

aiwriter record

改稿记录：校对提了什么、你怎么处置的。只记事实，不判对错。

命令	做什么
`aiwriter record decide`	记下你对建议的处置：采纳 / 忽略 / 忽略并立下规矩。从标准输入读一批事件。
`aiwriter record list`	看这个项目的改稿记录记了多少。
`aiwriter record fsck`	核一遍改稿记录有没有漏记（只读）。
`aiwriter record repair`	封过的记录卷坏了或丢了，从这台电脑的镜像里取回。坏的那份挪进 damaged/ 留着。
`aiwriter record export`	把你在写匠里亲手改的导成一份文件，给本机模型学。
`aiwriter record learn`	把你在版本历史里亲手改的切成样本，供归纳习惯用。
`aiwriter record purge`	删掉这个项目的改稿记录。先预演，再带指纹确认；删了收不回。
`aiwriter record show`	看某一卷记录里记了什么。
`aiwriter record archive`	把你在 git 里改稿的提交收进版本历史，再学一遍你的写法。
`aiwriter record learn-git`	从写匠之外的 git 仓学你的写法。先加 `--dry-run` 看哪些提交认作你的。

aiwriter revise

从你亲手改过的地方学，找出别的章里同样要改的（只给建议，不动正文）。

命令	做什么
`aiwriter revise pairs`	你的亲笔改动拆成了哪些改动，按字词 / 句子 / 段落 / 篇章分。
`aiwriter revise rules`	你反复做的字词习惯：改过几次、定稿里还留几处。
`aiwriter revise scan`	按你的字词习惯扫一遍，列出别处还没改的地方。
`aiwriter revise induce`	把你亲手改过的地方归纳成习惯，存成待看。云端归纳没开时，先用本机找到的字词习惯。
`aiwriter revise cards`	列出你的习惯（待看 / 用 / 不用）。
`aiwriter revise mark`	按 id 定已有的习惯用不用：`--as use` 用，`--as skip` 不用。
`aiwriter revise new`	新建一条习惯：原句 → 改成，加一句可选的说明。
`aiwriter revise edit`	改一条你新建的习惯（给什么改什么）。
`aiwriter revise prescreen`	按你在用的习惯预筛几张卡，找到的地方作为建议贴回原文，到「文风」里逐条看。
`aiwriter revise seed`	导入现成的亲笔改动记录（JSONL，一行一处），当习惯的起步料。
`aiwriter revise adopt`	采用一条习惯：给出改前、改后两段字，以后扫描按它找还没这样改的地方。

aiwriter ai

云端 AI 能力（Pro 权益·需先 aiwriter auth login）。

命令	做什么
`aiwriter ai apply-spans`	从标准输入读 JSON，逐条校验后批量应用建议。
`aiwriter ai check`	AI 校对：逐句找错，给出指到原文位置的修改建议（长卡自动分段）。
`aiwriter ai batch`	一次跑很多段（校对或建议）：几段同时跑，每段做完就写进结果文件，断了重跑接着来。
`aiwriter ai typeset`	AI 排版：把 md / txt 正文排成 Typst 源（本机编译验证，编译不过不输出）。
`aiwriter ai coach`	建议：从语感、节奏、意象逐句给修改建议，附理由，采纳与否由你（长卡自动分段）。
`aiwriter ai view`	请几个视角各读一遍正文，指出问题、提出疑问。
`aiwriter ai analyze`	AI 分析：节奏统计、意象分类、风格概括（长卡分段抽样）。
`aiwriter ai last`	看这张卡上次留下的分析或排版结果（只读）。
`aiwriter ai segment`	只列分段计划、不执行，供预估确认。给出 steps、预计最多消耗字数、计划指纹。
`aiwriter ai capabilities`	各项 AI 能力的上限：一次最多送多少字、多少句，长稿怎么分段。

aiwriter font

排版字体：列出与下载。

命令	做什么
`aiwriter font list`	列出可下载的字体，标出已安装的。
`aiwriter font download`	下载字体到字体目录（位置用 `aiwriter font dir` 看）。
`aiwriter font installed`	列出已安装的字体（字体目录下的 otf / ttf / ttc）。
`aiwriter font dir`	打印字体目录路径。

aiwriter log

诊断日志：打开目录、在访达中选中、导出。

命令	做什么
`aiwriter log open`	在访达中打开日志目录。
`aiwriter log reveal`	在访达中选中一个日志文件。
`aiwriter log export`	导出全部日志与环境信息为一个 zip。

每条命令都认的选项

选项	做什么
`--project <PROJECT>`	项目目录：`<名>.aiw` 或 `<名>.aiwriter`。不给就用当前目录。
`--json`	输出 JSON。