Topic Bookmarks Reorganizer Cn

---
name: topic-bookmarks-reorganizer-cn
description: 将浏览器导出的书签 HTML 中用户指定的主题目录重新分类整理，按 URL 去重，并导出可直接导入浏览器的 Netscape 书签文件。用于用户要求分析书签导出、提取一个主题目录、重分组链接与子目录并生成可导入 HTML 的场景。
license: MIT
---

# Topic Bookmarks Reorganizer（中文）

把一个书签导出文件中的目标主题目录重整为更清晰、可导入的新文件。

## 何时使用

当用户有以下需求时使用本技能：
- 分析一个书签导出 HTML，并定位用户指定的主题目录
- 重新分门别类该目录下的链接与子目录
- 按 URL 去重
- 输出只包含该主题目录的可导入 HTML

## 不要使用

以下场景不应使用本技能：
- 输入不是浏览器书签导出 HTML
- 用户仅需要文字建议，不需要处理文件
- 用户需求与书签整理无关（如纯 JSON/PDF/Docx 处理）

## 使用说明

1. 先向用户确认必要参数：
- 输入书签文件路径
- 主题目录名称
- 输出文件路径

2. 先跑分析与预览：

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

3. 视情况调整参数：
- `--mode auto`：自动选择分类策略
- `--mode generic`：使用通用分类策略
- `--no-dedupe-url`：不做 URL 去重

4. 生成最终文件：

```bash
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 zh
```

5. 交付前检查并汇报：
- 确认输出文件存在
- 汇总输入链接数、输出链接数、去重移除数
- 确认输出仅包含一个顶层目录（目标主题目录）

## 输出要求

- 输出必须是 Netscape 书签格式，可直接导入浏览器
- 输出仅保留目标主题目录
- 尽量保留原 `<A ...>` 属性（如 add-date/icon）
- 目录结构按高层分类重组，便于后续维护