mirror of
https://github.com/agentscope-ai/ReMe.git
synced 2026-08-28 05:25:04 +00:00
ab66f2bb56
* docs: update ReMe documentation URL * docs: localize ReMe Studio social image * docs(AGENTS): update agent guidelines and repository documentation structure - Clarify coding agent guidance for keeping changes small and consistent - Revise project principle descriptions for clarity and modern terminology - Expand repository map with detailed component and folder explanations - Add configuration and CLI usage instructions, including syntax and merging rules - Elaborate on component, step registration, and application lifecycle processes - Define jobs, steps, and state handling conventions for stateless design - Specify workspace and file safety policies, including path restrictions and locking - Update validation commands and testing environment recommendations - Clarify coding and test conventions, including style and dependency policies - Distinguish documentation boundaries and update website content contribution notes - Reinforce change guardrails to avoid breaking backward compatibility and data loss - Improve svg diagram formatting and textual details in auto dream and proactive flow image * style(docs): fix font-family syntax in SVG style definitions - Correct quotation marks around font-family names in memory-as-file.svg - Standardize font-family formatting by removing unnecessary quotes in reme-blog-architecture.svg - Ensure consistent CSS style formatting within SVG files for better rendering fidelity * docs: add ReMe blog to news * style(docs): inline svg styles and improve text formatting - Convert multiline SVG style tags into single-line for compactness in multiple figures - Remove redundant line breaks in subtitle text elements for consistency - Shorten descriptive texts in SVG figures for clarity and conciseness - Adjust font sizes and text for better readability in SVG elements - Correct whitespace issues in Chinese markdown document for improved formatting - Remove unused style blocks from framework structure SVG for cleaner code
94 lines
3.6 KiB
Markdown
94 lines
3.6 KiB
Markdown
# Auto Resource `Beta`
|
||
|
||
Auto Resource 是 ReMe 的资源解读入口，目前处于 **Beta**。资源文件先进入 `resource/`（推荐按日期放置），再被解读成 daily
|
||
资源卡片；卡片文件名由 LLM 生成的 frontmatter `name` 决定，并通过 `source_resource`
|
||
追溯原始文件。
|
||
|
||
<p align="center">
|
||
<img src="../figure/auto-memory-resource.svg" alt="ReMe Auto Memory 与 Auto Resource 写入 daily 记忆卡片的流程" width="92%">
|
||
</p>
|
||
|
||
关于 workspace 分层、`resource/` 和 `daily/` 的通用文件语义，见 [Memory as File](./memory_as_file.md)。对话进入 daily 的流程见
|
||
[Auto Memory](./auto_memory.md)。
|
||
|
||
```text
|
||
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/` 根目录，此时使用应用时区中的今天。
|
||
|
||
示例目录：
|
||
|
||
```text
|
||
workspace/
|
||
resource/
|
||
quick-note.txt # 进入今天的 daily
|
||
2026-06-20/
|
||
market-report.md
|
||
meeting-notes.csv
|
||
```
|
||
|
||
当前 Beta 版本更适合处理文本类资源，例如 `md`、`txt`、`json`、`jsonl`、`csv`、`yaml`、`html`。
|
||
|
||
## 资源卡片
|
||
|
||
每个资源文件会生成一张 daily 资源卡片。创建时先使用资源文件 stem 作为临时路径，Agent 写入后，系统会根据 frontmatter `name`
|
||
重命名文件：
|
||
|
||
```text
|
||
resource/2026-06-20/market-report.md
|
||
↓
|
||
daily/2026-06-20/市场报告要点.md
|
||
```
|
||
|
||
资源卡片通过 frontmatter 关联原始文件：
|
||
|
||
```yaml
|
||
source_resource: "[[resource/2026-06-20/market-report.md]]"
|
||
```
|
||
|
||
如果资源文件更新，Auto Resource 会通过 `source_resource` 找到对应卡片并更新；如果资源文件删除，对应的 daily note 也会被清理。旧版本按
|
||
stem 生成的 `daily/YYYY-MM-DD/<resource_stem>.md` 仍作为 fallback 兼容。
|
||
|
||
## 当天索引
|
||
|
||
资源卡片会进入和 Auto Memory 相同的 daily 记忆层。当天的 `YYYY-MM-DD.md` 会作为索引页，把这些资源卡片组织起来：
|
||
|
||
```text
|
||
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](./auto_dream.md)；默认实时检索会
|
||
索引 daily 卡片和 digest 节点。若还要直接检索原始资源文件，可运行 `reme reindex`，详见 [Memory Search](./memory_search.md)。
|