文档 · 02
项目与文件
项目结构
一个 InkCraft 项目通常包含：
| 目录 | 用途 |
|---|---|
| 大纲 | 总纲、卷大纲、章节细纲、时间线、节拍表 |
| 正文 | 章节正文（Markdown，一章一文件） |
| 设定集 | 世界观、人物卡、力量体系等长期设定 |
| 审查报告 | 工作流产出的审查结果与改动清单 |
Agent 理解这个结构：你可以直接问「第 1 卷的节拍表和现在的正文进度对不对得上」。
文件工作区
- 左侧文件树支持浏览、打开、重命名与删除文件。
- 中间编辑器支持多标签页，正文以「写作」模式（排版视图）或「源码」模式查看。
- 文件修改实时保存，编辑器顶部显示保存状态。
Agent 如何读写文件
- 读取：Agent 可以列出目录、读取文件、按关键词或正则搜索项目内容。
- 写入：对你项目文件的写入默认先生成 patch proposal（修改建议），你在审批卡片中查看差异、选择应用或撤销。未经审批不会覆盖你的正文。
建议
- 保持大纲与设定集为最新，Agent 的写作与审查都以它们为上下文。
- 章节文件名保持连续编号（如
第0011章-林晚晴的调查.md），便于/write等工作流定位。