ReMe/docs/zh/auto_resource.md

Auto Resource Beta

Auto Resource 是 ReMe 的资源解读入口，目前处于 Beta。资源文件先进入 resource/（推荐按日期放置），再被解读成 daily 资源卡片；卡片文件名由 LLM 生成的 frontmatter name 决定，并通过 source_resource 追溯原始文件。

关于 workspace 分层、resource/ 和 daily/ 的通用文件语义，见 Memory as File。对话进入 daily 的流程见 Auto Memory。

resource/[YYYY-MM-DD/]<resource_file>
  ├─ step 1: daily/YYYY-MM-DD/<generated_name>.md # 资源解读卡片
  ├─ step 2: source_resource 指回原始资源
  └─ step 3: daily/YYYY-MM-DD.md                  # 当天索引再串起来

它记录什么

它不只是搬运文件内容，而是把资料里以后方便检索和理解的信息提炼出来：

• 核心内容：这份资料主要讲什么。
• 结构脉络：章节、表格、字段、数据组织方式。
• 关键细节：重要数字、名称、日期、结论。
• 背景用途：这份资料为什么存在，和当前工作有什么关系。
• 可行动项：任务、截止时间、后续跟进。

简单说，它负责把“文件存档”变成“资料可用”。

原始资料入口

Auto Resource 以 resource/ 作为原始资料入口。推荐按日期放置，目录日期会决定它进入哪一天的 daily 记忆层；也支持直接放在 resource/ 根目录，首次处理时使用应用时区中的今天。之后即使跨天更新或删除，也会通过精确匹配 source_resource 继续操作原 daily 卡片，不会重复新建卡片或留下孤立链接。

示例目录：

workspace/
  resource/
    quick-note.txt             # 进入今天的 daily
    2026-06-20/
      market-report.md
      meeting-notes.csv

当前 Beta 版本以文本类资源为主，例如 md、txt、json、jsonl、csv、yaml、html；图像资源（png、jpg、jpeg、webp、gif、bmp、tiff、heic）会生成 caption 卡片，见下文图像资源一节。

内部由统一的 AutoResourceStep 接收每批变更，并将每一项交给配置中第一个匹配它的 processor。 AutoImageResourceStep 声明图像后缀匹配规则，AutoTextResourceStep 作为最后的 fallback。后续新增模态时， 只需注册新的 processor、提供独立 prompt 并在 dispatch_steps 中增加一项，无需修改 router。

图像资源

图像文件的解读方式相同：视觉模型写入一张 caption 卡片并链接原图。卡片正文以 ![[resource/...]] 嵌入链接开头，frontmatter 携带 kind: image 与 media_type，文本检索因此可以通过 caption 命中图像内容。

视觉模型优先使用配置中的 as_llm vision 实例，未配置时回退到 default 实例——默认模型具备视觉能力时无需额外配置。宽或高超过 2048px 的图像会降采样，格式不被模型接受的图像会转码；这些处理只发生在请求前的内存副本中，resource/ 下的原图文件不会被修改。图像变更时卡片原地重写；图像删除时卡片随之删除。

在完整解码前，系统会检查图像尺寸，默认上限为 40,000,000 像素；超限图像或 Pillow decompression-bomb 警告只会导致当前资源失败。缩放或转码前，会按 EXIF orientation 校正仅用于请求的内存副本。 尺寸过大的 JPEG 会先使用 decoder-level downsampling，并在需要时再完成最终缩放。 VLM 请求的 MIME 和卡片 frontmatter 中的 media_type 都使用 Pillow 根据实际图像字节识别的格式， 而不是直接信任文件扩展名。

图像预处理使用 core extra 中的 Pillow。HEIC 资源还需要可选的 image-heif extra： pip install "reme-ai[image-heif]"。其他受支持图像格式不会加载或依赖 HEIF 插件。

资源卡片

每个资源文件会生成一张 daily 资源卡片。创建时先使用资源文件 stem 作为临时路径，对应 processor 写入后，系统会根据 frontmatter name 重命名文件：

resource/2026-06-20/market-report.md
        ↓
daily/2026-06-20/市场报告要点.md

资源卡片通过 frontmatter 关联原始文件：

source_resource: "[[resource/2026-06-20/market-report.md]]"

如果资源文件更新，Auto Resource 只会通过精确匹配的 source_resource 找到对应卡片并更新；如果资源文件删除，也只会清理显式关联的 daily note。缺少该来源标记的同 stem 笔记会被视为用户笔记并保留，新资源卡片则会使用无冲突路径。

当天索引

资源卡片会进入和 Auto Memory 相同的 daily 记忆层。当天的 YYYY-MM-DD.md 会作为索引页，把这些资源卡片组织起来：

daily/
  2026-06-20.md
  2026-06-20/
    市场报告要点.md
    会议纪要整理.md

以后想回看这一天处理过哪些资料，先看 YYYY-MM-DD.md；想看某份资料沉淀了什么，再进入对应的资源卡片。

同时保留原始资料

解读后的 daily note 负责“好读”，原始资源负责“可信”。

Auto Resource 不会把原始文件挪走：它仍然留在 resource/ 下的原路径。这样，文本与图像资料会进入 daily 记忆流，原始文件也始终保留在它来时的位置。

后续流向

Auto Resource 只生成 daily 层的资源解读。要把资源中的长期知识沉淀进 digest/，使用 Auto Dream；默认实时检索会 索引 daily 卡片和 digest 节点。手动 reindex 只基于摄取流程已经接受的 chunks 重建检索索引，不会把原始资源文件加入检索范围。 详见 Memory Search。