# InsightFlow Chrome Extension

一键将网页内容导入 InsightFlow 知识库的 Chrome 扩展。

## 功能特性

- 📄 **保存整个页面** - 自动提取正文内容并保存
- ✏️ **保存选中内容** - 只保存您选中的文本
- 🔗 **保存链接** - 快速保存网页链接
- 🔄 **自动同步** - 剪辑后自动同步到服务器
- 📎 **浮动按钮** - 页面右下角快速访问按钮
- 🎯 **智能提取** - 自动识别正文，过滤广告和导航

## 安装方法

### 开发者模式安装

1. 打开 Chrome 浏览器，进入 `chrome://extensions/`
2. 开启右上角的"开发者模式"
3. 点击"加载已解压的扩展程序"
4. 选择 `chrome-extension` 文件夹

### 配置

1. 点击扩展图标，选择"设置"
2. 填写您的 InsightFlow 服务器地址
3. 输入 Chrome 扩展令牌（从 InsightFlow 插件管理页面获取）
4. 点击"保存设置"
5. 点击"测试连接"验证配置

## 使用方法

### 方式一：扩展图标
1. 点击浏览器工具栏上的 InsightFlow 图标
2. 选择"保存整个页面"或"保存选中内容"

### 方式二：右键菜单
1. 在网页任意位置右键
2. 选择"Clip page to InsightFlow"或"Clip selection to InsightFlow"

### 方式三：浮动按钮
1. 在页面右下角点击 📎 按钮
2. 快速保存当前页面

### 方式四：快捷键
- `Ctrl+Shift+S` (Windows/Linux)
- `Cmd+Shift+S` (Mac)

## 文件结构

```
chrome-extension/
├── manifest.json      # 扩展配置
├── background.js      # 后台脚本
├── content.js         # 内容脚本
├── content.css        # 内容样式
├── popup.html         # 弹出窗口
├── popup.js           # 弹出窗口脚本
├── options.html       # 设置页面
├── options.js         # 设置页面脚本
└── icons/             # 图标文件夹
    ├── icon16.png
    ├── icon48.png
    └── icon128.png
```

## 开发

### 本地开发

1. 修改代码后，在 `chrome://extensions/` 页面点击刷新按钮
2. 查看背景页控制台：扩展卡片 > 背景页 > 控制台

### 打包发布

1. 确保所有文件已保存
2. 在 `chrome://extensions/` 页面点击"打包扩展程序"
3. 选择 `chrome-extension` 文件夹
4. 生成 `.crx` 和 `.pem` 文件

## API 集成

扩展通过以下 API 与 InsightFlow 服务器通信：

### 导入网页内容
```
POST /api/v1/plugins/chrome/import
Content-Type: application/json
X-API-Key: {token}

{
    "token": "if_ext_xxx",
    "url": "https://example.com/article",
    "title": "文章标题",
    "content": "正文内容...",
    "html_content": "<html>..."
}
```

### 健康检查
```
GET /api/v1/health
```

## 隐私说明

- 扩展仅在您主动点击时收集网页内容
- 所有数据存储在您的 InsightFlow 服务器上
- 不会收集或发送任何个人信息到第三方

## 许可证

MIT License