文档 · 02

项目与文件

工作区结构

工作区就是你电脑上的本地项目文件夹。当前版本直接打开已有文件夹,不执行导入、复制或迁移;一个 InkCraft 工作区通常包含:

目录用途
大纲总纲、卷大纲、章节细纲、时间线、节拍表
正文章节正文(Markdown,一章一文件)
设定集世界观、人物卡、力量体系等长期设定
审查报告工作流产出的审查结果与改动清单

Agent 理解这个结构:你可以直接问「第 1 卷的节拍表和现在的正文进度对不对得上」。

文件工作区

  • 左侧文件树支持浏览、打开、新建、重命名与删除文件和文件夹。
  • 中间编辑器支持多标签页,正文以「写作」模式(排版视图)或「源码」模式查看。
  • 文件修改实时保存,编辑器顶部显示保存状态。
  • 删除的项目条目会先进入项目回收站,可以在左侧导航中恢复;不会直接从磁盘永久消失。

Agent 如何读写文件

  • 读取:Agent 可以列出目录、读取文件、按关键词或正则搜索项目内容。
  • 写入:对你项目文件的写入默认先生成 patch proposal(修改建议),你在审批卡片中查看差异、选择应用或放弃。未经审批不会覆盖你的正文。

建议

  • 保持大纲与设定集为最新,Agent 的写作与审查都以它们为上下文。
  • 章节文件名保持连续编号(如 第0011章-林晚晴的调查.md),便于 /write 等工作流定位。