Obsidian FastNote Clipper

一个 Chrome 扩展，配合 Fast Note Sync 服务器，将网页文章一键剪藏到 Obsidian，自动清洁排版、智能分类，支持 AI 增强。

功能特性

• 一键剪藏：点击插件图标，自动提取正文、去除广告和噪声
• 智能分类：根据域名和关键词自动归类（技术 / AI / 设计 / 商业等）
• AI 增强（可选）：
  • 自动生成简洁中文标题（去除网站名等冗余前缀）
  • 一句话摘要
  • 3-5 个关键标签
  • 正文结构化整理（添加小标题、列表、引用块）
• Obsidian Callout 排版：信息块、摘要块美观呈现
• 封面图保留：自动提取文章封面图写入笔记

前置条件

需要自行部署 Fast Note Sync 服务器，该服务器负责将笔记写入你的 Obsidian Vault。

安装

1. 下载本仓库（Code → Download ZIP 或 git clone）
2. 打开 Chrome，进入 chrome://extensions
3. 开启右上角「开发者模式」
4. 点击「加载已解压的扩展程序」，选择本仓库根目录
5. 点击扩展图标 → 右上角设置图标，填写配置

配置

配置项	说明
服务器地址	Fast Note Sync 服务器地址。公网部署建议使用 HTTPS（Chrome 出于安全策略会拦截公网 HTTP 请求）；本地或 localhost 使用 HTTP 即可
API Token	服务器鉴权 Token
Vault 名称	Obsidian Vault 的名称
剪藏文件夹	笔记保存的根目录，默认 Clippings
AI API Key	可选，填写后可开启 AI 增强功能
AI Base URL	默认 https://api.openai.com/v1，支持兼容 OpenAI 格式的服务
AI 模型	默认 gpt-3.5-turbo

笔记结构

剪藏后的笔记文件名为 标题.md，存放在 剪藏文件夹/分类/ 下，格式示例：

Clippings/
  技术/AI/
    用大模型重构搜索体验.md
  商业/
    创业公司如何做冷启动.md

笔记内容包含 frontmatter 属性（title / tags / source / clipped）和 Obsidian Callout 信息块。

项目结构

obsidian-fastnote-clipper/
├── manifest.json
├── icons/
├── lib/
│   ├── Readability.js      # Mozilla Readability，正文提取
│   └── turndown.js         # HTML → Markdown 转换
└── src/
    ├── background/
    │   └── background.js   # Service Worker，处理保存逻辑和 AI 调用
    ├── content/
    │   └── content.js      # 页面内容提取
    ├── popup/
    │   ├── popup.html
    │   └── popup.js        # 剪藏面板 UI
    └── settings/
        ├── settings.html
        └── settings.js     # 设置页面

License

MIT