Slices（时间切片）

每一次对话都是一条由时间切片组成的时间线——一段连续的来回交流，一个 Markdown 文件。

什么是切片

**切片（slice）**是情景记忆（episodic memory）的存储单元：一个以 .md 文件形式保存的独立对话会话，带有 YAML 前置元数据。它是 L2 记忆层——L0 和 L1 在构建时打包，L2（切片）在运行时按需获取。没有数据库，没有二进制格式。只有纯 Markdown 存放在你的仓库中。

每个切片保存一段连续的对话轮次——你和 Previously 在一次交互中交换的消息——以及由 Flash（快速 DeepSeek 调用，在每一轮对话后保持元数据最新）维护的元数据。

生命周期

一个切片有三种状态：open（打开）、**active（活跃）**和 closed（关闭）。

一条规则，没有例外。 唯一的切片触发因素是时间静默——自上一轮对话以来过去 30 分钟（TIME_SILENCE_THRESHOLD_MS = 1,800,000 ms）。容量检查和 Flash 连续性启发式逻辑曾在 M8 中原型验证后被移除。它们永远不会被重新引入。

页面刷新时，tryLoadTodaySlice() 扫描今天的目录，找到最近一个仍标记为 active 的 .md 文件并重新加载——你可以从中断的地方继续。

目录结构

切片存储在 memory/episodic/slices/ 下，采用三层日历层级：

memory/episodic/
  slices/
    2025/
      11/
        21/
          0825.md     -- 一个切片
          0930.md     -- 同一天的另一切片
        _index.json   -- 2025年11月的月度索引
    12/
      ...
  strands.json         -- 全局关键词到切片的索引

一个日历日是一个目录。一个目录可以包含多个切片文件——每个 HHMM 时段一个文件。每个文件最多包含一次不间断的对话。

路径和 slice_id 中的 HHMM 是 UTC 时间——从第一条用户消息的 UTC 日期和时间推导而来。你当地的挂钟时间单独存储在 timezone 前置元数据字段中。这使得路径在不同时区和夏令时切换下保持稳定。

YAML 前置元数据

每个切片文件以 --- 分隔的 YAML 开头。以下是所有字段——全部由 Flash 在关闭或维护期间写入：

空字符串和 undefined 字段会从 YAML 中去除。空数组（open_loops: []）按原样序列化——它们会显示为空白列表。

对话轮次正文

在前置元数据之后，每条消息成为一个二级标题：

## Turn 1 — 2023-04-21T06:10:00.000Z (user)

你的消息正文...

## Turn 2 — 2023-04-21T06:13:00.000Z (agent)

Previously 的回复...

格式始终为 ## Turn N — <ISO_TIMESTAMP> (<role>)，以 em dash 分隔。parseTurns() 函数根据这些标题重建数组。

Strands：基于切片的语义索引

每个切片带有 tags。当一个切片关闭时，updateStrands() 将每个标签编织到 memory/episodic/strands.json 中——一个将关键词映射到切片路径的单一文件：

{
  "work-pressure": [
    "2023/04/21/0610",
    "2023/04/22/0915"
  ],
  "housing-project": [
    "2023/04/21/0610"
  ],
  "trust-crisis": [
    "2023/04/21/0610"
  ]
}

**strand（主题）**就是某个关键词的条目——"某件事情的完整历史"在时间上的贯穿。它是在情景切片之上构建的轻量、无损的语义记忆层。标签在切片关闭时聚合为主题；读取主题用于回忆是未来的里程碑（实验性功能）。

切片如何与 Flash 和 Pro 协同工作

Flash/Pro 分工管控元数据和回忆：

• Flash（DeepSeek-chat，快速）在每一轮对话中运行。它维护切片的前置元数据——focus、summary、decisions、open loops、tags、emotional_tone。它还扫描最近已关闭切片的摘要以进行回忆命中。如果统一的 Flash 调用失败，则使用安全默认值（intent 设为 "chat"，不更新元数据）。
• Pro（主模型）在 Flash 未返回结果或问题需要更丰富上下文时，通过 readMemory 工具读取完整的切片正文执行深度回忆。

当一个切片关闭时，Flash 冻结元数据，切片在磁盘上密封。

存储后端

子系统在两个后端之间透明切换：

所有 I/O 通过管理器中的 fsReadFile/fsWriteFile/fsListFiles 封装函数进行。相同的代码路径在两个环境中均可工作——无需手动切换。

关闭时维护的索引

当一个切片关闭时，两个辅助结构会更新：

1. 月度索引（memory/episodic/slices/YYYY/MM/_index.json）——一个由精简条目（SliceIndexEntry: id、focus、summary、tags、status、start、open_loops、decisions）组成的 JSON 数组。使时间线 UI 能够在无需读取每个文件的情况下浏览标题。
2. 主题索引（strands.json）——上述的关键词到切片的映射。条目经过去重，确保同一切片不会在同一标签下出现两次。

设计原理

• 仅基于时间的切片使系统保持可预测。容量阈值和基于 Flash 的连续性启发式逻辑在当前阶段增加了复杂性而没有带来经过验证的好处——它们在 M8 中被移除。
• 内存中的活跃切片配合定期快照避免了过多的 GitHub API 写入。切片存在于模块级变量中，每 N 个轮次和在 beforeunload 时快照，但绝不在每一轮都写入。
• YAML 前置元数据 + Markdown 正文是所有文档生态系统的原始素材。它在任何 Markdown 查看器中都能渲染，在 git 中差异清晰可见，并且解析器存在于每种语言中。
• 情景与语义分离呼应了 Endel Tulving 1972 年的理论。切片是情景性的（按何时组织）。主题（strands）和记忆节点（memory nodes）是语义性的（按什么组织）。回忆先扫描何时，再检索什么。

相关文档

• 时间线 — 按日期浏览切片的垂直 UI
• Strands — 切片档案的语义标签索引
• 回忆 — Flash 扫描与 Pro 检索
• 记忆模型 — 三层架构