# chrome_plugins_text_save

**Repository Path**: RicheFactory/chrome_plugins_text_save

## Basic Information

- **Project Name**: chrome_plugins_text_save
- **Description**: 一款用于保存网页文本片段的 Chrome 插件，支持选中文本快速保存、分类管理与便捷复用
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-07
- **Last Updated**: 2026-09-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 文本收藏助手 Chrome 插件

一款用于保存网页文本片段的 Chrome 插件，支持选中文本快速保存、分类管理与便捷复用。

## 功能特性

- ✅ **选中文本即保存** - 选中网页文字自动弹出保存按钮
- ✅ **分类管理** - 支持自定义分类标签（默认：优美语句、技术短句、创意灵感）
- ✅ **管理面板** - 浏览、搜索、筛选、复制、编辑、删除已保存内容
- ✅ **数据导出/导入** - 支持JSON格式的备份与恢复
- ✅ **使用频率统计** - 自动记录文本被复制使用的次数
- ✅ **本地存储** - 数据保存在本地 chrome.storage，确保隐私

## 项目结构

```
chrome_plugins/
├── manifest.json                    # 插件清单
├── background/
│   └── background.js                # 后台脚本
├── content-script/
│   ├── content-script.js            # 内容脚本（选中文本浮窗、保存弹窗）
│   └── content-script.css           # 内容脚本样式
├── panel/
│   ├── panel.html                   # 管理面板页面
│   ├── panel.css                    # 管理面板样式
│   └── panel.js                     # 管理面板脚本
├── popup/
│   ├── popup.html                   # 工具栏弹窗
│   └── popup.js                     # 弹窗脚本
├── icons/
│   ├── icon16.png                   # 16x16 图标
│   ├── icon48.png                   # 48x48 图标
│   └── icon128.png                  # 128x128 图标
└── README.md                        # 说明文档
```

## 安装使用

### 开发模式安装（开发者模式）

1. 打开 Chrome 浏览器，访问 `chrome://extensions/`
2. 打开右上角「**开发者模式**」开关
3. 点击「**加载已解压的扩展程序**」
4. 选择本插件所在目录 `chrome_plugins`
5. 安装完成后，工具栏会显示插件图标

### 使用说明

#### 保存文本
1. 在任意网页中**选中**一段文字
2. 选中文本上方会弹出"**保存**"按钮浮窗
3. 点击保存按钮，在弹窗中选择分类（可多选）
4. 可输入自定义分类后回车添加
5. 点击"**保存**"完成

#### 查看管理面板
- 点击工具栏中的插件图标，**直接弹出收藏列表**
- 底部"管理面板"按钮可进入完整编辑界面（添加/删除分类、编辑条目等）

#### 管理面板功能
- **搜索**：顶部搜索框输入关键词实时过滤
- **分类筛选**：点击分类标签进行筛选（多选）
- **排序**：支持最新/最早/使用频率排序
- **复制**：点击卡片"复制"按钮将文本复制到剪贴板
- **编辑分类**：点击"编辑"按钮管理全部分类
- **删除**：点击"删除"按钮移除条目
- **导出/导入**：底部按钮支持 JSON 格式备份
- **清空**：底部"清空"按钮清空所有数据

#### 工具栏弹窗 (Popup)
点击工具栏图标即可在小型弹窗内直接查看已收藏的列表：
- 内置搜索框,实时过滤
- 横向分类筛选条(默认含"全部")
- 卡片式列表,每条显示文本预览、来源、时间、分类
- 点击文本可展开/收起
- 卡片底部"复制"按钮一键复制
- "删除"按钮移除条目(自定义确认弹窗)
- 顶部统计徽章显示当前过滤后条数
- 监听 storage 变化,新收藏实时出现
- 底部按钮: 管理面板 / 刷新 / 导出 JSON

## 数据存储

- 所有数据存储在 `chrome.storage.local` 中
- 每个保存项包含：
  - `id`: 唯一标识（时间戳）
  - `text`: 保存的文本内容
  - `categories`: 分类标签数组
  - `sourceUrl`: 来源网页URL
  - `sourceTitle`: 来源网页标题
  - `createdAt`: 保存时间（ISO格式）
  - `useCount`: 使用次数

## 配色方案

- **主色调**：`#4285F4`（Google 蓝）
- **辅助色**：`#EA4335`（红）、`#FBBC05`（黄）、`#34A853`（绿）
- **中性色**：`#202124`（文本）、`#5F6368`（次要文本）、`#DADCE0`（分割线）、`#F1F3F4`（背景）

## 注意事项

- Chrome Manifest V3 规范
- 仅支持现代 Chrome 浏览器（Chrome 88+）
- 后期可扩展 Google 账户云端同步功能