项目结构与本地文件

文件夹就是项目边界

Plova 不把项目抽象成只存在于数据库里的空间。打开的工作区目录就是项目根目录，Markdown 源文件仍可以被其它编辑器、Git 和备份工具读取。

一个典型项目可以包含：

我的项目/
├── 项目说明.md
├── 章节/
├── 角色/
├── 设定/
├── 参考资料/
└── 项目管理数据

实际目录由创作模板决定，不同项目不必拥有相同栏目。

项目说明

快速完成一次结构认识

先打开项目说明，确认目标、边界和全局规则；再查看栏目与类型对应的目录。正文、字段、关系和版本各自承担不同职责，不要仅靠文件夹名称推断类型。

检查结果：你能从一个文档追溯到它的类型、父级、关联资料和本地路径，也知道哪些信息应写回项目说明。

“项目说明”不是普通内容卡片，而是项目级契约。适合记录：

• 项目目标、边界和当前阶段。
• 目标读者、平台、规模或预计字数。
• 全局规则、世界规则和长期约束。
• 故事时间别名等全项目共享配置。

当 AI 创建或审查内容文档时，项目说明会作为上层背景参与约束。

内容栏目

内容栏目对应一类需要长期维护的文档，例如角色保存在 角色/，章节保存在 章节/。目录负责物理组织，内容类型负责解释栏目里的文档应该有什么信息字段、关系和正文结构。

不要仅凭目录是否为空判断一个内容类型是否存在。已配置但暂时没有文档的类型仍然有效。

项目管理数据

Plova 会在项目内保存结构配置、类型定义、视图状态、索引和协作所需的管理数据。它会跟随项目迁移和备份，一般不需要手工编辑。

需要修改内容类型、信息字段或正文结构时，优先使用 项目主页 → 栏目设置。需要备份时，将整个项目目录纳入 Git 或其它备份系统。

迁移项目

1. 保存所有正在编辑的文档。
2. 完成本地 Git 提交或完整备份。
3. 关闭 Plova 中的项目。
4. 移动整个项目根目录，不要只移动正文子目录。
5. 从启动页使用“打开工作区”选择新位置。

迁移后首次打开会重新确认文件、索引和 Git 状态。

预期结果：新位置能够正常打开项目，栏目、正文、关系和版本记录仍然存在；旧位置不会继续被当作另一个项目同时编辑。

结构异常时怎么处理

• 栏目存在但没有文档时，先确认这是否只是尚未创建内容，不要直接删除类型配置。
• 外部工具移动或改名文件后，重新打开项目或刷新索引，再检查链接和关系。
• 项目管理数据无法读取时，停止手工修改隐藏配置，先从“版本与同步”检查最近可恢复版本。
• 迁移后内容缺失时，确认选择的是完整项目根目录，而不是某个正文子目录。