# v0.4.0 — 岁月涟漪 · 梦境 · 最后一天整理 · 看门狗

发布日期：2026-11-01

这是一次**存储布局升级**：本地记忆目录重构，自动迁移；不改人设，不需要重新导入。

## 记忆布局

```
岁月涟漪/
  日档/YYYY/MM/YYYY-MM-DD.md
  月响/YYYY/YYYY-MM.md
  年轮/YYYY.md
梦境/YYYY/MM/YYYY-MM-DD.md
锚/ 余页/ 元/
```

- 月档 → **月响**；梦/梦志 → **梦境**，夜梦按年月日分级；
- 日档、月响、年轮统一归入**岁月涟漪**；
- 迁移脚本：`node scripts/migrate-layout.mjs`（默认 dry-run）→ `--apply`；幂等，改写条目 `path`，
  旧目录清空后移除；真实数据已按此迁移，旧目录已清空。

## 最后一天自动整理

- 每月最后一天 23:50 后自动把当月日档/夜梦整理成 `status: final` 的月响；
- 每年 12-31 23:50 后自动给年轮追加「年轮定格」；
- 错过最后一天则由次日 `rollMonthly` 自动补；
- 10 月已补：60 条、12 天，月响已生成并同步思源。

## 四级整理与优先度

- 整理方向：日档 → 夜梦 → 月响 → 年轮；
- 首轮记忆快照按「锚点 → 日档近况 → 梦境 → 月响 → 年轮」注入；归档只给路径和摘要，细读用
  `memory_fs`（Inline/Spill）；
- 月响/年轮带 `thread`、`source_days`、`source_dreams` 和「来源（链式召回）」，可沿引用回落。

## 思源

- 修复 `document metadata is not ready`：逐级创建父文档 + 重试；
- 新路径：
  - `/一页永恒/岁月涟漪/日档/...`
  - `/一页永恒/岁月涟漪/月响/... · 月响`
  - `/一页永恒/岁月涟漪/年轮/... · 年轮`
  - `/一页永恒/梦境/YYYY/MM/... · 夜梦`
- 旧 `/日`、`/月`、`/年`、`/梦` 文档在迁移完成后已清理；本地已实际验证月响/年轮可见。

## 看门狗

- `memory/watchdog.js` 在维护 tick 巡检目录、旧路径残留、当月/当年文件、计数；
- 自动补齐月响/年轮骨架；异常写 `元/看门狗.log`，状态进 `service.maintenance.status().watchdog`。

## 验证

- 202 项测试通过；`npm run check` 生成一致。
- 迁移演练、最后一天 final、看门狗、思源月响 hpath 均有测试。

## 升级

1. 重启 DSH（加载 0.4.0）；
2. 本地记忆已自动迁移；如需在其他机器迁移：`node scripts/migrate-layout.mjs --apply`；
3. 同步一次思源（`/cyrene 同步`），确认「岁月涟漪」「梦境」分组出现。

旧的 0.3.x 快照仍保留在 `~/.dsh/cyrene-philia093-0-snapshots/`；本次大规模改动前另存了完整备份。