browser-history

🔍 本地 Chrome 历史极速检索

基于 SQLite 的本地 Chrome 历史检索方案,纯文档型设计零隐私风险,帮助用户通过 SQL 查询快速定位过往浏览的网页与视频资源。

收藏
2.7k
安装
602
版本
v1.0.0
CLS 安全性认证2026-06-04
点击查看完整报告 >

使用说明

这是一个专注于本地 Chrome 浏览器历史记录检索的实用型 Skill,通过直接查询 SQLite 数据库文件,帮助用户快速找回曾经访问过的网页、视频或特定站点。该 Skill 采用纯文档形式呈现,仅提供标准化的 SQL 查询示例和系统命令,不涉及任何可执行脚本或远程服务调用。

核心用法上,用户可以通过修改 SQL 语句中的关键词,在 Chrome 历史数据库中执行精确匹配搜索。Skill 提供了四种典型查询场景:基础 URL 和标题模糊搜索、针对 YouTube 视频内容的专项筛选、基于访问频次的热门站点统计,以及按时间倒序的最近浏览记录。针对 Chrome 运行时锁定数据库文件的常见问题,文档还提供了创建临时副本或使用 WAL(Write-Ahead Logging)模式的解决方案,确保查询操作不会被阻塞。此外,配套的 macOS 系统命令可实现一键在 Chrome 中打开目标链接或控制浏览器窗口显示状态。

显著优点体现在隐私安全性和操作透明度上。由于所有查询均在本地执行,直接读取 ~/Library/Application Support/Google/Chrome/Default/History 文件,用户数据不会经过任何第三方服务器,从根本上杜绝了隐私泄露风险。纯文档型设计意味着无隐藏代码、无动态依赖,所有操作逻辑完全可见可查,技术用户可直接审计每个 SQL 语句的安全性。同时,该方法无需安装额外软件,仅依赖系统自带的 sqlite3 工具和 macOS 内置命令,资源占用极低。

然而,该 Skill 存在明显的平台局限性和使用门槛。首先,所有路径和命令均针对 macOS 设计(如使用 osascriptopen -a 命令),Windows 或 Linux 用户需要手动修改数据库路径和系统命令才能使用。其次,使用方式偏向技术化,需要用户具备基本的 SQL 知识和命令行操作经验,缺乏图形界面支持,对非技术用户不够友好。此外,Chrome 数据库结构可能随版本更新而变化,长期使用可能存在兼容性问题。

适合的目标群体主要包括:macOS 平台的知识工作者和研究人员,需要频繁回溯查找参考资料、视频教程或 GitHub 仓库;注重数据隐私的技术用户,希望避免使用云端历史同步或第三方历史管理工具;以及需要快速生成浏览统计报告的数据分析师。

使用该技能可能存在的常规风险包括:直接操作 Chrome 数据库文件可能导致数据损坏(尽管是只读查询,但文件复制操作仍有风险);SQL 查询语句如果构造不当(如缺少 LIMIT 限制),可能返回大量结果导致终端输出混乱;由于 Chrome 可能随时锁定数据库,在复制历史文件时若操作不当可能导致查询失败或数据不一致。建议用户在 Chrome 关闭或空闲时执行查询,并优先使用临时副本方案以确保数据安全。

安全解读

核心用法

browser-history 是一款面向 macOS 用户的本地浏览器历史检索工具,通过直接查询 Chrome 的 SQLite 数据库实现高效搜索。用户可使用 SQL 语句按 URL、标题关键词或访问时间筛选记录,支持基础搜索、YouTube 视频专项检索、高频访问站点排行及最近浏览记录等多种查询模式。当 Chrome 运行时数据库被锁定,可通过复制临时文件或使用 WAL 模式绕过限制。检索结果可直接调用系统命令在 Chrome 中打开,或控制浏览器窗口显隐状态。

显著优点

  • 极致隐私保护:所有操作均在本地完成,零外部网络通信,浏览数据不会上传至任何第三方服务
  • 轻量高效:仅依赖系统自带的 sqlite3openosascript 命令,无需额外安装依赖
  • 灵活查询:支持 SQL 级别的精确筛选,可按域名、关键词、访问频次、时间维度自由组合条件
  • 工作流整合:检索结果可直接唤起 Chrome 打开,支持窗口管理脚本,适合自动化工作流
  • 透明可信:代码完全开源,功能与声明一致,无隐藏行为或数据收集逻辑

潜在缺点与局限性

  • 平台受限:当前仅支持 macOS(~/Library 路径 + osascript),Linux/Windows 用户需自行修改路径
  • 单浏览器支持:仅适配 Chrome,不支持 Safari、Firefox、Edge 等其他浏览器
  • 技术门槛:需要基础的 SQL 知识和命令行操作能力,非技术用户上手成本较高
  • 实时性限制:依赖 last_visit_time 字段的 Chrome 内部时间戳,与人类可读时间存在转换复杂度
  • 无图形界面:纯命令行交互,缺乏搜索建议、自动补全等现代化体验

适合人群

  • 需要快速回溯特定网页、视频或文档的技术工作者
  • 注重隐私、拒绝云端历史同步服务的用户
  • 希望将浏览历史检索整合到自动化脚本(如 Alfred、Raycast、Hammerspoon)的效率工具爱好者
  • 需要统计个人上网行为模式的自我量化研究者

常规风险

| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 数据库锁定 | Chrome 运行时 History 文件被占用 | 复制到临时目录或使用 WAL 模式读取 |
| 误删风险 | 直接操作 SQLite 存在意外修改可能 | 始终使用只读查询,避免 INSERT/UPDATE/DELETE |
| 隐私泄露(本地) | 历史记录包含敏感站点信息 | 确保执行环境可信,避免在共享设备上明文展示结果 |
| 时间戳解析错误 | Chrome 使用微秒级 Windows 纪元时间 | 查询结果需转换,或直接按相对排序使用 |

安全认证摘要

CLS-Certify 扫描评级 S(优秀),得分 85/100。通过静态分析、动态行为、依赖审计、网络分析、隐私合规、威胁情报六项检测,无安全风险发现。来源可信度 T2 级(GitHub 组织仓库)。

browser-history 内容

手动下载zip · 1.2 kB
SKILL.mdtext/markdown
请选择文件