summersec agent-chat-history：本地 Agent 历史对话按日检索（中文）
执行顺序（Agent 照做）
- 已有日期
YYYY-MM-DD：用${CLAUDE_SKILL_DIR}定位脚本并运行下方命令；若当前环境不支持该变量，再进入 skill 根目录agent-chat-history/执行；需要给下游贴结果时优先--json。 - 没有日期：只问用户一句，确认要查询的
YYYY-MM-DD（本地时区日界），再问是否只要提示词、是否限定某一客户端。 - 任务匹配：只要用户提示词 →
--prompts-only（可加--include-claude-global-history）；只要路径/文件线索 → 默认列表模式，必要时加--sqlite-keys。 - 无命中或偏少：提示尝试
--claude-scan all；仍不对则读 references/storage-paths.md 核对自定义安装路径。
优先：固定日期用脚本（省 token）
不要先把本文件整篇读进上下文。 优先直接执行脚本：
python "${CLAUDE_SKILL_DIR}/scripts/query_history.py" --date YYYY-MM-DD
python "${CLAUDE_SKILL_DIR}/scripts/query_history.py" --date YYYY-MM-DD --prompts-only --json
常用参数（完整表与 JSON 形状见 references/query-history-script.md）：
| 参数 | 含义 |
|---|---|
--date |
必填，本地日历日 YYYY-MM-DD |
--prompts-only |
只提取用户侧提示词（Cursor 为启发式，可能不全） |
--json |
结构化输出，便于原样贴回或只摘 prompts 数组 |
--mode |
all（默认）或 claude / codex / cursor 只查一类 |
路径规则与手工命令见 references/storage-paths.md、references/query-examples.md。
Gotchas（易错点）
- Cursor：从
state.vscdb已知 key 启发式抽取，版本变更后可能漏项或混入非纯用户句。 - Codex：依赖
history.jsonl行内ts（Unix 秒）；无ts的行不会进入结果。 - 非默认数据目录（
CODEX_HOME、CLAUDE_CONFIG_DIR、Cursor--user-data-dir、Flatpak/Snap）：脚本只覆盖常见布局，须对照storage-paths.md自行定位后再查。
何时仍需要读正文 / references
- 要在 SQLite 里深挖 JSON 或新版本 key 名。
- 用户只描述「上周某次」等模糊时间：先澄清日期再跑脚本。
摘要（三客户端）
| 客户端 | 要点 |
|---|---|
| Claude Code | ~/.claude/projects/**/*.jsonl + 可选 history.jsonl；列表模式用 mtime 落在本地日 |
| Codex | history.jsonl 行内 ts（Unix 秒）落在本地日 |
| Cursor | workspaceStorage/<hash>/ 目录 mtime + state.vscdb；--sqlite-keys 仅列表模式下列 key |
边界
路径与 DB key 随版本变化；未开启持久化或清理缓存可能导致无命中。只读；勿删改他人数据。