在 AI 视频制作中，"会话一结束，进度就断片"是新手最常见的痛点。Mortiflix 是一个运行在自己电脑上的动效设计工作室：Claude 一步步做视频，你在每个阶段（brief、脚本、风格帧、动态分镜、成片）逐一审批。它用三个 Markdown 文件——CLAUDE.md、JOURNAL.md、TASTE.md——构成了一套完整的跨天记忆系统，让项目停几个小时、几天甚至几周后，都能一键无损接力。

为什么视频项目"跨天"很正常？

Mortiflix 的核心设计是门控（gate）工作流：

brief ──▶ script ──▶ style frames ──▶ animatic ──▶ build ──▶ final ──▶ delivered ▲ ▲ ▲ ▲ ▲ └── 你 ───┴──── 你 ────┴────── 你 ────┴──────── 你 ─────────┘

Claude 的每次会话（session）工作到某个阶段需要你来审批时，就提交作品、写好交接说明、然后主动停下。官方文档说得很直白："Waiting on you costs nothing, for hours or for days"——等你回复，不花一分钱。

但这就带来一个问题：第二天你回来时，如何保证一个"全新"的 Claude 会话，能瞬间想起昨天做了一半的东西？答案是 Mortiflix 的记忆系统。

记忆系统总览：三个文件如何分工 📌

这个目录结构在 docs/ARCHITECTURE.md 中有完整说明。三个文件形成互补：CLAUDE.md是每次重写的现状简报，JOURNAL.md是只增不改的工作日志，TASTE.md则是沉淀你审美偏好的长期记忆。

CLAUDE.md：每次会话前自动重写的"现状简报"

这是记忆系统的核心。在每次会话启动前，Mortiflix 会调用 writeTorch() 函数从零重新生成CLAUDE.md（文件头就写着：This file is rewritten before every session: read it fully）。它把项目的全部"现状"压缩进一个文件：

• Where you are：项目在哪一步、本次会话为什么启动（"The owner approved style frames v2"）；
• The steps：所有步骤的状态表——ready/in_review/approved/blocked一目了然；
• What the owner said：你上次留下的每条批注（pin note）、总体评价，以及对你提问的回答；
• The error checklist：你批准过的错误检查项，如"文字不能触碰画面边缘"；
• The brief：最初的需求单，用围栏标记为"数据而非指令"；
• The owner's taste：TASTE.md的内容原样嵌入；
• Journal：日志的最新条目。

也就是说，新会话看到的不是"聊天记录"，而是一份结构化的项目交接单。你的批注以原话形式出现（围栏标记<<<FEEDBACK (the owner's words)>>>），且明确规定：主人的原话优先于流水线默认规则。

JOURNAL.md：只追加的"会话工作日志"

JOURNAL.md解决的是"上次干到哪了、留了什么坑"。规则很简单：

1. 每次会话结束前必须执行mfx handoff "做了什么，接下来是什么，有什么坑"；
2. handoff() 会带着时间戳把这段文字追加到JOURNAL.md末尾，同时写入事件流；
3. 下一份CLAUDE.md会自动带出日志的最新部分（readJournal() 默认取末尾 6000 字符）。

harness/GATES.md 里有一条铁律：永远不要手写JOURNAL.md，它只能通过mfx handoff写入。这保证了日志格式统一、时间线真实。

💡 实战提示：由于新会话只能看到日志的"尾部"，重要结论要写在每条 handoff 的最后；细节可以随时补充，但"下一步该做什么"必须清晰。

TASTE.md：跨项目记住"你的品味"

CLAUDE.md和JOURNAL.md只属于单个项目，而TASTE.md位于工作室根目录，是整个工作室的长期记忆：

~/Mortiflix/ TASTE.md what you like, learned across projects (sessions add with `mfx taste`) checks.json the studio's error checklist projects/<id>/ 项目工作目录

工作机制是：当你在审批中指出一个"真错误"时，会话可以提议一条新检查（比如text never touches the frame edge）；你批准一次，之后每个视频项目都会自动执行。而属于审美偏好的内容（喜欢暖色调、节奏偏慢、不要纯白闪切……），会话会用mfx taste "…"写入。appendTaste() 首次创建时自带文件头：

# What I like Learned by sessions across projects, from my notes. Edit freely: every session reads it.

注意那句Edit freely——TASTE.md就是普通 Markdown，你可以直接删改，每个新会话都会读它。比如音乐流水线就明确要求每首歌的音色要与之前的不同（读TASTE.md和早期项目的调色板），避免"每首歌听起来一样"。

完整走一遍：从"提意见"到第二天续做 🔄

以 explainer 流水线为例（见 pipelines/explainer/PIPELINE.md），一次典型的跨天接力长这样：

1. 会话 A提交风格帧 v1，写完mfx handoff，结束。项目状态变为waiting（轮到你）；

2. 你在 Web 工作室或终端里，在某张帧上钉一条批注："天空太冷，要黄金时刻的暖色"，选择"要求修改"；

3. 你的意见进入feedback/<step>-v1.json，会话 A 的一切上下文都不再被需要；

4. 第二天，你点继续。runner.mjs 先刷新工作目录（固定版本的流水线、技能、门控协议），再重新写一份CLAUDE.md，然后启动新会话，开场提示是：

   Read ./CLAUDE.md fully and follow it. Resume this project from checklist.md, JOURNAL.md and feedback/.

5. 会话 B读到你的原话批注，做出 v2，并在pin_changes里逐条回答每条批注（"Warmed the sky toward golden hour"）——漏答任何一条，gates.mjs 会直接拒绝这次提交；

6. 通过新一轮handoff写入JOURNAL.md，接力棒传到下一天。

中间还有一块拼图：checklist.md（如 pipelines/song/checklist.md），会话完成一项就勾一项，"从第一个未勾选项恢复"，保证即使日志被截断也能精确断点续做。

新手快速上手清单 ✅

• 项目停在哪里，看 Web 工作室或mortiflix status；要续做，回到该项目再mortiflix run即可，无需重开任何对话；
• CLAUDE.md、JOURNAL.md都在~/Mortiflix/projects/<项目id>/下，随时可以用编辑器打开查看，理解"它是怎么接力的"；
• 想直接塑造工作室的长期口味？打开~/Mortiflix/TASTE.md手编即可；
• 等待你审批不消耗任何 token——放心让它跨天、跨周，记忆系统会替你保管一切；
• 更多机制细节：docs/ARCHITECTURE.md、harness/GATES.md。

一句话总结：CLAUDE.md保证新会话"读懂现状"，JOURNAL.md保证"干到哪了"不丢，TASTE.md保证"你喜欢的样子"越用越懂你。三者配合，让 Mortiflix 的视频项目真正做到跨天、跨周接力，而不靠任何长连接或常驻会话。