Obsidian 收件箱

§4.1打开它

收件箱默认关闭。在 inkbrush.config.ts 里打开:

inbox: {
  dir: '~/vault/inbox',        // 要监听的文件夹(支持 ~/)
  ignore: ['daily-'],          // 可选:按文件名前缀跳过
},

启动时文件夹里已有的文件只标记为「已见」,不导入——只有之后新放进来的笔记才自动同步。更早的存量可以通过 API 明确补录,所以打开收件箱绝不会冷不丁把十年的 vault 旧账一次倒进站点。

§4.2导入器做什么

每篇进来的笔记是被转换,不是被复制:

• 内嵌的图片按 vault 的附件目录解析,文件复制到导入笔记的旁边,内嵌写法转成标准图片语法——日后删除笔记,它的附件跟着一起删
• 命中站内真实笔记的 [[双链]] 保留为链接,解析规则与站内各处同一套;其余摊平成普通强调并给出警告
• 高亮变成真正的 <mark> 元素,frontmatter 元数据变成标题下方的一行来源标注,description 从第一段实质内容里提炼

转换后的笔记还要过和手工保存同一道构建关——会弄坏页面的笔记被拒收,而不是被导入。

每次导入都以整篇为单位记进修订日志(via: inbox):⟲ 把它列为一条备查记录,撤销一次导入走 git。开着 autocommit,每次导入和任何编辑一样变成一条 git 提交;关着,导入的文件就是普通的工作区改动,自己审阅、自己提交。