topic-bookmarks-reorganizer

主题书签整理器

概述

将浏览器书签导出文件中由用户指定的一个主题文件夹重新整理为更清晰、可导入的 Netscape HTML 文件。此工作流会分析源导出文件，提取目标主题目录，重新归类链接和子文件夹，移除重复 URL，并确保输出文件可导入浏览器。

使用场景

用户提出以下一项或多项需求时，请使用此技能：

• 分析一个书签导出文件，并查找用户指定的主题文件夹
• 重新分类该主题下的链接和子文件夹
• 按 URL 移除重复链接
• 输出可导入浏览器的新 HTML 文件
• 输出中仅保留目标主题文件夹

不要使用

以下情况请勿使用此技能：

• 输入不是书签导出 HTML 文件
• 用户只需要手动撰写帮助，不涉及文件处理
• 用户要求处理无关的 JSON/PDF/Docx 转换

说明

1. 索取所需输入：

• 导出文件路径
• 目标主题文件夹名称
• 输出文件路径

2. 先以报告模式运行脚本：

python3 scripts/reorganize_topic_bookmarks.py \
  --input /path/to/bookmarks.html \
  --output /tmp/topic-preview.html \
  --topic-folder "<topic-folder-name>" \
  --mode auto \
  --lang en \
  --report /tmp/topic-report.json \
  --print-report

3. 仅在需要时与用户确认最终选项：

• 使用 --mode auto 自动选择策略
• 使用 --mode generic 采用通用策略
• 使用 --no-dedupe-url 保留重复 URL

4. 生成最终输出：

python3 scripts/reorganize_topic_bookmarks.py \
  --input /path/to/bookmarks.html \
  --output /path/to/topic-bookmarks-reorganized.html \
  --topic-folder "<topic-folder-name>" \
  --mode auto \
  --lang en

5. 验证并报告：

• 确认输出文件存在
• 报告输入链接数、输出链接数和移除的重复项数量
• 确认输出恰好包含一个顶层文件夹：目标主题

输出要求

• 输出格式为 Netscape 书签 HTML，可导入浏览器
• 输出中仅包含目标主题文件夹
• 链接保留原始 <A ...> 属性（例如 add-date/icon）
• 文件夹结构重新整理为高级别分类