数据格式说明

明文优先

写匠不会把你的项目锁进私有数据库或加密格式。一个写匠项目就是：

• 一个普通文件夹，你自己命名、自己组织内部结构；
• 内部按你的实际组织方式存放卡片文件（纯文本 / Markdown）；
• 一份轻量记录，记下当前把哪个文件夹设为「作品」等信息。

这意味着你随时可以用其他编辑器、其他工具打开、检索、迁移这些文件——写匠不是唯一能读懂它们的软件。

树即大纲

写匠没有一套独立于文件系统之外的「大纲数据」。你在 Finder（或写匠的文件树面板）里看到的文件夹结构，本身就是大纲；选定一个文件夹「设为作品」，就标出了当前作品的范围。你不必再单独维护一套目录。

版本历史与回收站

• 自动保存与手动「存为版本」是两套独立机制：自动保存按需触发、覆盖式保存当前内容；「存为版本」由你主动执行，会留下一个带时间戳、可回看的历史点。
• 删除的内容会先进入回收站，而不是立即物理删除，避免误操作造成不可恢复的损失。

写匠当前不默认初始化 Git、不提供分支/合并/远端同步界面——本地版本历史是一套独立于 Git 的轻量机制，不要将两者混淆。

跨项目检索复用

写匠会为你写过的所有项目建立可检索的索引（⌘I 万能插入），但这份索引只是为方便你快速找回旧内容而自动生成的，你的卡片原文始终以明文形式留在各自项目的文件夹里。