你的文字是你的

就是一堆普通文件

写匠项目就是一个文件夹。里面的卡片就是 .txt / .md / .typ 文件。

不锁进私有数据库，不加密成只有写匠读得懂的格式。你随时可以用别的编辑器打开它们，复制路径喂给别的工具。

你看到的文件夹结构，就是大纲：文件夹是章，卡片是节。

项目文件夹里还有一个 .aiwriter 目录，记着你排的顺序与卡片状态。删进回收站的卡也搬在那儿（所以捡得回来），版本历史同样存在这个文件夹里。

所以搬家就把整个项目文件夹一起拷：只拷走 .txt / .md / .typ，字都在，顺序、回收站和历史都没了。

项目名称不是文件夹名。 在项目设置里改项目名称，只改写匠里显示的名字，盘上的文件夹照旧。项目在盘上的哪儿，项目设置里「文件夹」那一行写着；鼠标停在项目卡上也能看到。

在访达里打开

在访达里双击一份 .md：

它在某个项目里：写匠打开那个项目，停在这张卡上。
它不在任何项目里：只打开它自己那一扇窗，项目库不会跟着出来。

要回到项目库，点程序坞里的写匠图标，或者菜单栏「窗口 › 写匠主窗口」。

版本历史

版本历史默认开着，不用你去开。 写匠一边写一边留痕，你按 ⌘S 亲手留的那些刻也在同一条时间轴上（一个实心点、一个空心点，分得开）。你不必先搞懂差别——要回去的时候，挑那一刻就是了。

历史存在项目自己的 .aiwriter/ 文件夹里；项目放在你自己的 git 仓里时也一样，写匠不往你的仓里写。不想记，在「项目设置 › 存档」里关掉「记录版本历史」。关掉以后的改动不再留版本，改坏了无法退回；已经记下的历史不删。

删掉的先进回收站，不是当场抹掉。回收站不用先打开，一直都在。

项目放在 git 仓里

项目的文件夹，或它上面任何一层是 git 仓，这个项目的正文就由 git 接力：换到另一台电脑，正文用 git 带过去；写匠的云备份只接上次序、状态、标签和版本历史，不换那台电脑上的正文。

平常写的分支上，写匠什么都不多显示。

项目的文件夹被切到了别的分支，或者项目在另一个工作树里，侧栏项目名旁会出现一个淡色的「⑂ 分支名」。点开它，看这个项目现在在哪个分支、文件夹在哪。

分支是在写匠外面被切走的，那一刻写作页顶上会说一句。点「知道了」，写匠就把现在这个分支当成你平常写的分支，⑂ 随之收起；点开 ⑂ 选「以后就在这个分支写」也是一样。写匠不替你切分支。

项目设置里也能看到它在哪个分支、是不是另一个工作树。

项目放在哪儿

设置 › 通用 里「位置」那一节有两块，用法一样：点右边的 ⚙ 展开，选「换位置…」挑一个文件夹，再点一下 ⚙ 收起。

项目位置：写匠的项目放在哪个文件夹。选好新文件夹后，写匠先告诉你要搬几个项目、搬到哪里、旧位置那份会删掉，点「搬」才开始，点「取消」或按 Esc 什么都不动。每个项目都核过搬全了，才删旧位置那份；中途哪一个不成，旧位置原样留着。搬的时候那一行写着正在搬哪个项目、第几个，可以随时点「停止」。想回到默认的文件夹，点「恢复默认」。
导出位置：导出的成品默认放在哪儿。只管以后，已经导出的文件不动。

云备份

免费档到此为止：你的稿件只在自己的电脑上，不涉及云备份。

Pro / Pro+ 可以在 设置 › 通用 › 云备份 打开「自动备份」：写匠开着时每 30 分钟备份一次，含版本历史，加密存放在云端。想马上备份一次，点「立即备份」。容量与档位见定价。改稿记录（你对 AI 建议点了采纳或忽略时，写匠在项目里记下的那一笔）也在项目里，会随项目一起加密备份。

自动备份的开关跟着账号走：在任何一台电脑上关掉，你所有电脑上的写匠都不再自动备份，项目本身不受影响；云端已有的备份保留，随时可以取回或删除。

换台电脑：登录同一个账号，在云备份那一节点「查看并取回…」，挑要取回的项目。

有些文件默认不备份：压缩包、安装包、音频、视频和超过 50 MB 的文件。云备份那一节会写「几个文件没备份」，点后面的「查看」列出来；想带上哪一个，点它后面的「也备份」，改主意了点「不备份」改回去。整个项目不想备份，在 项目设置 › 存档 里把「云备份」选成「不备份」；设置页「不备份：」后面列着这些项目，点名字直达它的项目设置。

「云端」和「云盘」是两回事：「云端」是写匠的云备份；「云盘」是你电脑上的同步盘（iCloud 云盘这类）。项目放在同步盘里、有文件还没下载到这台电脑时，这些文件这一趟不备份。下载下来后，下一趟照常带上。

你主动送去云端 AI 处理的那部分内容，是另一回事——模型要读到才能处理。

离线

登录一次之后，写作、整理、导出都在本机完成。断网照写；只有你打开或点下去的那几件事才会联网上传。