| name | conversation-mining |
| description | 统一检索和使用 Claude Code / Codex / AntiGravity 的历史对话。支持按日期、关键词、会话 ID、Conversation Reference、Conversation Prompt 找回原文，也支持在用户明确要求时，对指定会话或某天会话做提炼、总结、笔记整理。 |
Conversation Mining
What This Skill Does
- 找回某天 / 某条 / 某组历史对话
- 读取
Conversation Reference / Conversation Prompt
- 打开或更新本地对话查看器
- 在用户明确要求时，对指定会话做总结、提炼、笔记整理
- 翻译 AI 对话为人类可读的结构化摘要（翻译模式）
Modes
搜索模式
- 默认模式
- 优先保留原文，不抢先摘要
- 适合：找回灵感、找原句、找上下文、找某天讨论
提炼模式
- 只有用户明确说“总结 / 提炼 / 整理笔记”时使用
- 必须基于明确范围：
- 会话 ID
- 日期
- Conversation Reference
- Conversation Prompt
- 用户指定的一组会话
翻译模式
- 触发条件：用户粘贴对话文本片段并说"翻译/看不懂/解释/人话"，或给对话 ID + 翻译请求
- 典型场景：用户在 Codex / Claude / AG 里看不懂一段对话，复制过来让你翻译
流程
- 导出最新对话：运行
python3 ~/.claude/skills/conversation-mining/export_all.py --days 7，确保索引包含近一周内容（--days 0 会导出空列表，不要用）
- 定位会话（优先使用搜索索引）：
- 先读
~/.claude/exported_conversations/search_index.json，在 entries 中按 keywords/title 模糊匹配关键词（纯 JSON 读取，毫秒级）
- 如果索引不够精确 → 再 fallback 到
conversations.json 的 messages 全文搜索，或在 /Users/lizeyu/Documents/ZeYu-AI-Brain/LOCAL-LARGE-FILES/agent-context/conversation-transcripts/ 下的 md 文件中 Grep 搜索
- 如果用户给了对话 ID（如
codex-20260327-e35f554d）→ 在 conversations.json 中按 id 字段查找
- 取匹配度最高的会话
- 读取完整 transcript：从定位到的会话的
transcript_path 读取完整 markdown
- 结合项目上下文翻译：用 Grep/Read 查阅项目代码，理解术语实际含义
输出结构
## 核心意图
（一句话说清楚这段对话在做什么）
## 关键决策
| 决策 | 理由 | 状态 |
|------|------|------|
| ... | ... | 已确认/待定 |
## 架构图（如果涉及）
（用 Mermaid 或 ASCII 画图）
## 下一步行动
1. ...
2. ...
## 未决事项
- ...
术语对照
- 项目特有术语（如 "106W" / "Nomos-era" / "projection primitives"）必须用 Grep/Read 查阅项目代码确认实际含义，不能猜测
- 在输出中附上：术语 → 实际对应的文件/函数/概念
Main Files
- 导出脚本：
~/.claude/skills/conversation-mining/export_all.py
- 查看器：
~/.claude/skills/conversation-mining/viewer.html
- 索引：
~/.claude/exported_conversations/conversations.json
Common Commands
python3 ~/.claude/skills/conversation-mining/export_all.py
python3 ~/.claude/skills/conversation-mining/export_all.py --date 2026-03-18
python3 ~/.claude/skills/conversation-mining/export_all.py --days 7
Guidance
- 如果用户要”找”，先定位再给原文
- 如果用户要”总结”，先明确范围再总结
- 如果用户已经给了
Conversation Reference / Conversation Prompt，优先按它的 conversation id 和 transcript 路径处理
- AntiGravity 内容提取是尽力模式，部分会话可能只有标题或摘要
新增：增量导出 + 搜索索引
- 导出脚本现在支持增量模式：第二次运行
--days 7 只重写有变化的 transcript，不变化的不重写
- 每次导出自动生成
search_index.json（轻量关键词索引），搜索时优先用它而不是全量 Grep
--clean 参数可清理 conversations.json 中不存在的孤立 transcript 文件
