用途:search-history 用于在本地聊天历史中做关键词检索,覆盖 Claude Code 与 Codex CLI 两类工具的 JSONL 历史文件,将两者的历史对等作为搜索对象,展示匹配的会话与对话片段。只有在用户显式调用 /search-history(或 Codex 中的 $search-history)时才使用,不会自动触发。
主要能力与参数:keyword 为必填检索词,多个词以空格分隔时按 AND 检索;--claude 只查 Claude Code 历史;--codex 只查 Codex CLI 历史;--all 同时查两者(默认);--days N 限定最近 N 天(默认 30)。若未提供关键词,会先向用户索要;未指定目标工具时搜索两者。
数据来源与检索方式:Claude Code 索引为 ~/.claude/history.jsonl,会话本体在 ~/.claude/projects/<encoded-path>/<sessionId>.jsonl;Codex CLI 索引为 ~/.codex/history.jsonl,会话本体在 ~/.codex/sessions/YYYY/MM/DD/rollout-<timestamp>-<uuid>.jsonl。检索以 grep 先在索引中筛出命中项并取得 sessionId,再用 find + grep 定位会话文件,最后抽取关键词上下文(前后各 2 行)以还原对话语境;Codex 侧会按 --days 缩小日期目录,并从 session_meta 行补充 cwd、时间等信息。结果按工具分组列出,文件过多时最多呈现前 20 条,并附带恢复会话提示:claude --resume <sessionId>、codex resume <sessionId>(最近会话可用 codex resume --last;不存在 --resume 标志)。
适用场景:需要回溯过去在 Claude Code 或 Codex CLI 中讨论过的内容、定位某次会话及其项目位置、或想重新进入某个历史会话时。
限制:该技能为只读,不编辑或删除历史文件;不批量 cat 大量文件,先 grep 再最小读取;因会话内容可能含敏感信息,输出仅限关键词周边上下文;按 JSONL 逐行解析,损坏行会被跳过。上述为资料中明确的约束,未提及的计费或平台信息暂未提供。