Share

外观
风格

chrome-site-search

2026年2月7日 · 工具

Chrome 自定义搜索批量管理

目标：批量管理 Chrome 地址栏“网站搜索快捷词”，支持从历史记录自动发现候选站点，并可用 AI 优化关键词。

脚本位置

  • tools/chrome-site-search.ts
  • <REDACTED_TOKEN>（站点与预置配置，可直接改）

你可以直接改 chrome-site-search.config.json：

  1. bundles：预置包（例如 media）
  2. catalog：smart 模式可选站点库

支持能力

  1. 列出 Profile
  2. 列出现有搜索引擎（keywords）
  3. 从历史记录扫描候选站点
  4. 导出为 JSON（可编辑）
  5. 从 JSON 批量写回 Web Data
  6. 可选 AI 优化关键词（--ai）
  7. 预置场景直达（preset，不依赖历史频次）
  8. 智能场景（preset --bundle smart，AI + 历史 host 统计）
  9. 合并推荐（recommend：media + scan(+AI) + managed 锁定清单）
  10. 锁定管理（managed list/pin，保证确认过的条目长期保留）
  11. 屏蔽管理（managed block/unblock，永久排除不想要的 host）

常用命令

# 1) 看有哪些 Chrome profile
bun tools/chrome-site-search.ts profiles

# 2) 扫描候选（每个 host 只留 1 条）
bun tools/chrome-site-search.ts scan --profile Default --top 20 --min-hits 3 --per-host 1

# 3) 扫描 + AI 优化关键词
bun tools/chrome-site-search.ts scan --profile Default --top 20 --min-hits 3 --per-host 1 --ai

# 3.1) 预置媒体搜索（bilibili / youtube / 图片搜索）
bun tools/chrome-site-search.ts preset --profile Default --bundle media --dry-run

# 3.2) 智能推荐（AI 根据历史 host 推荐）
bun tools/chrome-site-search.ts preset --profile Default --bundle smart --top 8 --dry-run

# 3.3) 合并推荐（推荐默认方案：media + scan --ai + managed）
bun tools/chrome-site-search.ts recommend --profile Default --top 8 --min-hits 2 --per-host 1 --dry-run

# 4) 导出候选到 JSON（先人工微调）
bun tools/chrome-site-search.ts export --profile Default --top 20 --min-hits 3 --per-host 1 --ai --out <REDACTED_TOKEN>

# 5) dry-run 检查写入
bun tools/chrome-site-search.ts apply --profile Default --file <REDACTED_TOKEN> --dry-run

# 6) 真正写入（必须先退出 Chrome）
bun tools/chrome-site-search.ts apply --profile Default --file <REDACTED_TOKEN>

# 6.1) 直接导出并应用预置媒体搜索
bun tools/chrome-site-search.ts preset --profile Default --bundle media --out /tmp/chrome-preset-media.json --dry-run
# 确认后（且 Chrome 已退出）:
bun tools/chrome-site-search.ts apply --profile Default --file /tmp/chrome-preset-media.json

# 6.2) 一键推荐并应用（默认启用 AI；确认后自动写入 managed）
bun tools/chrome-site-search.ts recommend --profile Default --top 8 --min-hits 2 --per-host 1

# 7) 查看/写入 managed 锁定清单
bun tools/chrome-site-search.ts managed list --profile Default
bun tools/chrome-site-search.ts managed pin --profile Default --file <REDACTED_TOKEN>
bun tools/chrome-site-search.ts managed block --profile Default --host douyin.com
bun tools/chrome-site-search.ts managed unblock --profile Default --host douyin.com

安全说明

  1. apply 前脚本会提示 Chrome 进程；建议先完全退出 Chrome
  2. 写入前自动备份 Web Data 到同目录 <REDACTED_TOKEN>
  3. JSON 导入要求：
    • keyword 不能有空格
    • url 必须包含 {searchTerms}
    • 同一文件内 keyword 不能重复
  4. managed 状态文件默认在 <REDACTED_TOKEN>

AI 模式说明

  • 开关：--ai
  • 用途：把规则生成的 keyword 做“更短更好记”优化
  • 模型：默认 fast 档（通常 gemini-2.5-flash-lite）
  • 失败兜底：AI 调用失败会自动回退到规则关键词，不阻塞流程

推荐策略说明（避免“推荐错位”）

  1. scan/export 是“从历史行为推断”，可能会命中你不想要的站点
  2. 明确目标场景（例如影音搜索）时，优先用 preset --bundle media
  3. preset --bundle smart 会基于历史 host + AI 从 catalog 里选站点
  4. 默认不会覆盖已存在的完全相同 URL，会自动避开 keyword 冲突

长期管理方法（推荐）

  1. 以后统一用 recommend，不要手动散着跑
  2. 你确认过并写入的条目，会自动进 managed（锁定清单）
  3. 之后再次推荐时会合并 managed，避免“后续更新把已确认条目弄丢”
  4. 对于不想再出现的站点，用 managed block --host 永久屏蔽
#chrome#搜索#脚本#效率#ai#shared