网页剪藏工具 Pro - 详细功能与使用指南
📌 概述
网页剪藏工具 Pro 是一款强大的浏览器扩展脚本，专为高效收集和整理网络内容而设计。它无缝集成思源笔记和AI技术，能够在不离开当前网页的情况下，一键将有价值的内容保存到您的思源笔记中，并自动生成精准的标签。该工具采用现代化UI设计，提供流畅的用户体验和丰富的自定义选项。
✨ 核心功能
1. 智能内容提取
- 使用 Mozilla Readability 技术精准提取正文内容
- 自动过滤广告、导航栏等无关元素
- 保留原始内容的结构和重要格式
2. AI驱动的标签生成
- 基于文章标题和内容自动生成3-5个精准标签
- 支持提供自定义标签，AI会智能生成补充标签，避免重复
- 标签生成规则：两字中文名词，简洁精准，概括核心主题
3. 笔记本管理
- 实时获取思源笔记中的笔记本列表
- 支持选择任意笔记本保存内容
- 记住上次选择的笔记本，提升操作效率
4. 智能文件组织
- 按月自动创建文件夹（格式：YYYY-MM）
- 自动清理文件名中的非法字符
- 结构化存储路径：
/web-clips/{年月}/{标题}.md
5. 用户体验优化
- 可拖动的浮动按钮，自由调整位置
- 响应式现代化UI设计，支持深色模式
- 无缝动画过渡和加载状态提示
- 双击按钮快速进入设置
6. 高级配置选项
- 指定特定网站激活脚本
- 自定义后端服务URL
- 保存按钮位置偏好
🛠️ 安装与配置
前提条件
- 安装 Tampermonkey 浏览器扩展
- 拥有思源笔记实例（本地或云服务）并启用API
- 有效的AI服务API（如智谱AI、OpenAI等）
首次配置
- 双击浮动按钮打开设置面板
- 填写后端服务地址（需要自行部署服务端）
- （可选）设置激活站点列表，每行一个域名，支持通配符
- 点击"保存"按钮
💡 提示：首次使用时，如果未完成配置，脚本会自动弹出设置窗口
🎯 使用指南
基本剪藏流程
触发剪藏面板：
- 单击页面右下角的绿色闪电⚡️按钮
- 或通过Tampermonkey菜单选择"网页剪藏工具 Pro"
选择目标笔记本：
- 面板打开后，从下拉菜单中选择希望保存到的笔记本
- 首次使用时需要等待笔记本列表加载
自定义内容：
- 标题：默认为当前页面标题，可修改
- 链接：默认为当前页面URL，可修改
- 自定义标签：（可选）输入与内容相关的标签，用逗号或空格分隔
执行剪藏：
- 点击"开始剪藏"按钮
- 等待处理完成（显示加载动画）
- 成功后会显示"剪藏成功！生成标签：xxx"
高级使用技巧
1. 精准标签控制
- 在"自定义标签"字段预先输入您希望确保包含的标签
- AI会识别这些标签并生成补充性标签，避免重复
- 例如：输入"技术，编程"，AI可能补充"算法，框架，工具"
2. 位置自定义
- 按住浮动按钮可拖动到任意位置
- 位置偏好会自动保存，下次访问时保持相同位置
3. 快速设置访问
- 双击浮动按钮可直接打开设置面板
- 无需通过浏览器菜单
4. 站点过滤
- 在设置中配置"激活网站列表"
- 支持通配符，例如：
*.example.com news.ycombinator.com github.com - 留空表示在所有网站激活
🔧 技术细节
数据流程
- 用户点击剪藏按钮
- 提取当前页面HTML
- 通过Readability提取正文内容
- 转换为Markdown格式
- 调用AI服务生成标签
- 合并自定义和AI生成的标签
- 按月组织文件路径
- 通过API保存到指定思源笔记
文件组织结构
思源笔记笔记本根目录/
└── web-clips/
├── 2023-12/
│ ├── 文章标题1.md
│ └── 文章标题2.md
├── 2024-01/
│ ├── 最新科技趋势.md
│ └── 人工智能发展报告.md
└── ...
❓ 常见问题
1. 为什么看不到浮动按钮？
- 检查是否在配置的激活站点列表中
- 检查Tampermonkey是否启用
- 尝试刷新页面
2. 剪藏失败怎么办？
- 检查后端服务是否正常运行
- 验证API配置是否正确
- 查看浏览器控制台错误信息
- 通过Tampermonkey菜单重新打开设置面板检查配置
4. 为什么AI不生成标签？
- 检查AI服务API配置是否正确
- 确认内容是否足够丰富以生成有意义的标签
- 尝试增加更多自定义标签引导AI
💡 最佳实践
- 定期整理：虽然脚本按月组织内容，建议定期检查和整理笔记
- 标签策略：结合自定义标签和AI生成标签，建立个人知识体系
- 多设备同步：确保思源笔记开启同步，实现在所有设备上访问剪藏内容
- 内容预览：剪藏前可先预览提取的内容，确保准确性
提示：本工具为开源项目，欢迎提交反馈和改进建议。合理的使用将极大提升您的信息收集和知识管理效率！