用途:查询本机 Chrome 浏览历史,回答“找那个看过的页面”“最近在研究什么”“某主题花了多少时间”“下载过什么”“是否访问过某站点”等问题。仅支持 macOS,读取的是历史数据库,不含当前打开的标签页、书签、密码、自动填充和 Cookie,也不支持 Safari。
安装与验证:先安装 CLI,可用 npx -y @mvanhorn/printing-press-library install chrome-history --cli-only,或回退到 go install github.com/mvanhorn/printing-press-library/library/productivity/chrome-history/cmd/chrome-history-pp-cli@latest(需 Go 1.26.6+),并确保二进制目录在 PATH 中,用 chrome-history-pp-cli --version 验证。
使用方式:先执行 chrome-history-pp-cli sync 建立本地快照,chrome-history-pp-cli doctor 做健康检查;若数据库不可读,需在系统设置中授予终端完全磁盘访问权限。查询命令直接读取已有快照,无需每次先 sync。主要命令包括 search、visited、topic、list、searches、domains、report、heatmap、profile、dwell、journeys、timeline、rabbitholes、graph、downloads、sql(只读)、mcp 等,均支持 --json 与 --select 便于解析。
可选归档:默认关闭,archive enable 后配合 sync --accumulate 可保留 Chrome 后续清理或用户清除的历史,读取时自动使用更完整的归档;可用 archive status/disable/clobber/reset/vacuum 管理。
限制:仅 macOS;不覆盖实时标签页、书签、密码等;静态域名分类较粗,Chrome Journeys 聚类有噪声,建议由智能体根据 --json 的标题与 URL 自行推断主题;所有数据仅保存在本机。