ldm-session-handoff

会话交接

目标是让下一次会话能核对原始记录，并快速恢复决定、产出、进度和待办。

按用户请求选择产物

• 完整交接：对话全记录、路由器、重启提示语。
• 用户明确说“只导出原文”时：只生成对话全记录。
• 用户明确说“只更新路由器”时：读取现有记录和产出后更新路由器。
• 用户明确说“只要重启提示语”“不用导出”或“不要创建文件”时：只给提示语；若缺少可靠上下文，明确哪些信息待补。

用户说“加载交接 Skill”“使用交接 Skill”“会话存档”“保存对话”或“准备退出重启”时，默认做完整交接；即使同一句还提到“给我重启提示语”，也不能因此跳过对话全记录和路由器。只有用户用“只”“仅”“不用导出”“不要创建文件”等明确措辞缩小范围时，才改为单项产物。

完整交接流程

1. 确认当前会话、主题和保存目录。优先使用用户已配置的存档根目录；否则使用当前工作区中的明确目录。
2. 通过平台原生导出能力或本 Skill 的脚本读取 user/assistant 原文。不要凭记忆生成“全记录”。
3. 生成路由器，只保留恢复任务需要的决定、产出、进度、待办和新教训。
4. 核对文件存在、消息数量级合理、来源标记准确。
5. 报告所有产物的绝对路径，最后直接给出可复制的重启提示语。

格式见 references/formats.md。只有需要选择或排查导出后端时才读 references/export-backends.md。

原文真实性

• “对话全记录”必须来自可核查的会话数据源。
• 默认保留 user/assistant 可见文本，过滤工具调用、工具输出、推理记录、环境注入和空占位。
• 不把摘要、路由器或模型回忆标成原文。
• 导出不完整时写明已获得的范围和“待补存”，不要声称数据必然永久存在。
• 单条截断会损失原文；只有用户要求控制体积或平台限制无法避免时才截断，并在文件头记录阈值和数量。

路由器

路由器是导航，不复述整段对话。至少写清：

• 关键决策及其理由。
• 已完成产物的绝对路径与状态。
• 正在进行的工作、已做到哪里、下一步是什么。
• 尚未解决的问题和明确待办。
• 只有本次新出现且可复用的经验教训。

外部链接只记录需要继续使用的最终入口。敏感凭证不写入路由器。

导出工具

• Hermes SQLite：scripts/export_transcript.py
• Claude Code / Codex JSONL：scripts/export_jsonl_transcript.py

脚本只负责导出原文，不负责生成路由器。先用 --list 找到会话，再指定会话和输出路径；本机存在多个后端时不要猜测。

当前活跃会话不会出现在 --list 中。导出步骤：session_search 搜当前对话关键词 → 从结果提取 session_id → export_transcript.py --session <id> --output <绝对路径>。此路径对活跃会话和已结束会话同样有效。

完成检查

• 交付内容与用户请求的产物范围一致。
• 全记录文件头写明数据源、会话标识、时间范围、消息数和导出方式。
• 完整交接时，两个文件均已报告绝对路径，重启提示语已直接发给用户。
• 失败和截断情况如实标注，没有用摘要冒充原文。

Pitfalls

1. 永远不要声称"导不出来"（2026-09-04/09-08 实战教训）

用户明确要求导出时，不得以"当前活跃session"为由放弃。导出路径：session_search 提取 session_id → export_transcript.py --session <id>。这招对活跃会话和已结束会话都有效。

此错误已导致用户暴怒两次。如果 --list 找不到，换 session_search；如果 session_search 也找不到，如实报告，但先试完两条路再说。

2. 重启提示语和路由器中必须使用绝对路径（2026-09-04/09-08 实战教训）

• ❌ ~/Documents/Hermes_Workspace/...（~ 不是绝对路径，用户会暴怒）
• ✅ /Users/likai/Documents/Hermes_Workspace/...

所有文件路径一律用 /Users/likai/ 开头。包括重启提示语、路由器产出清单、用户给的指引。用户已多次纠正此问题。