# Fund-Plugins

**Repository Path**: zxinrun/fund-plugins

## Basic Information

- **Project Name**: Fund-Plugins
- **Description**: 基金实时净值插件（Chrome）
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 基金实时涨跌 Chrome 插件

一个基于 Chrome Extension Manifest V3 的基金行情插件，用于查看自选基金的估算涨跌幅、估算时间，并支持手动刷新、自动刷新、排序和涨跌汇总。

## 功能特性

- 输入 6 位基金代码并加入自选列表
- 自选基金列表持久化保存到 `chrome.storage.local`
- 打开 popup 时立即刷新全部基金数据
- popup 打开期间每分钟自动刷新一次
- 支持手动刷新
- 支持按涨跌幅排序
- 支持上涨 / 下跌基金数量汇总
- 支持删除已关注基金
- 基金名称超出时省略显示，悬停后延迟展示完整名称
- 使用深色金融终端风格界面

## 项目结构

```text
Fund-Plugins/
├── manifest.json
├── popup.html
├── popup.css
├── popup.js
├── icons/
│   ├── icon16.png
│   ├── icon48.png
│   └── icon128.png
├── fundcodeSearch.ts
└── README.md
```

## 技术说明

- **扩展规范**：Manifest V3
- **前端技术**：原生 HTML / CSS / JavaScript
- **本地存储**：`chrome.storage.local`
- **数据来源**：`fundgz.1234567.com.cn`
- **请求方式**：通过 `fetch()` 拉取接口返回的 JS 文本，再解析其中的 JSONP 数据体

## 数据展示内容

每只基金会展示以下信息：

- 基金名称
- 基金代码
- 估算涨跌幅
- 估算时间
- 异常信息或上次刷新备注（如有）

颜色规则：

- 上涨：红色
- 下跌：绿色
- 平盘：灰色

## 使用方法

### 1. 快速导入到 Chrome

推荐不要直接拖动整个目录，而是使用 Chrome 提供的“加载已解压的扩展程序”方式：

1. 打开 Chrome 浏览器
2. 进入 `chrome://extensions/`
3. 打开右上角“开发者模式”
4. 点击“加载已解压的扩展程序”
5. 选择当前项目根目录：
   - `/Users/zhang/Programs/Personal/Fund-Plugins`

后续开发时：

- 修改代码后，回到扩展管理页点击当前插件卡片上的刷新按钮即可重新加载
- 建议把插件固定到工具栏，便于反复打开 popup 调试
- 只要目录里包含 `manifest.json`，就不需要反复拖动整个文件夹

### 2. 打包扩展程序

如果需要把当前未打包的扩展程序打包为安装包，可以直接使用 Chrome 自带的打包功能：

1. 打开 `chrome://extensions/`
2. 打开右上角“开发者模式”
3. 点击“打包扩展程序”
4. 在“扩展程序根目录”中选择当前项目目录：
   - `/Users/zhang/Programs/Personal/Fund-Plugins`
5. “私钥文件”第一次可以留空，Chrome 会自动生成
6. 点击“打包扩展程序”

打包完成后，通常会在项目同级目录生成：

- `Fund-Plugins.crx`
- `Fund-Plugins.pem`

说明：

- `.crx` 是扩展安装包
- `.pem` 是私钥文件，后续如果还要继续更新同一个插件，需要保留该文件
- 如果私钥丢失，重新打包后会被识别为另一个插件

### 3. 使用插件

1. 点击浏览器工具栏中的插件图标
2. 在输入框中输入 6 位基金代码
3. 点击右侧加号按钮添加基金
4. 插件会自动拉取并展示基金估算信息
5. 可以使用右上角刷新按钮手动刷新
6. 可以使用列表上方的排序按钮按涨跌幅排序
7. 可以通过右侧垃圾桶按钮删除基金

## 刷新机制

- popup 打开时立即刷新
- popup 保持打开时，每 60 秒自动刷新一次
- popup 关闭后不会在后台继续刷新
- 正在刷新时会禁用部分交互控件，避免重复触发

## 存储结构

当前插件主要使用以下本地存储字段：

- `watchlist`：基金代码数组
- `fundCache`：基金数据缓存对象

## 开发说明

核心文件说明：

- `manifest.json`：扩展配置、权限、图标与 popup 入口
- `popup.html`：popup 页面结构
- `popup.css`：深色金融风格界面样式
- `popup.js`：基金添加、删除、刷新、排序、汇总、渲染等核心逻辑

## 注意事项

- 基金代码必须为 6 位数字
- 若接口返回异常，单只基金失败不会影响其他基金刷新
- 当前数据依赖第三方接口，若接口不可用则会显示错误状态
- `fundcodeSearch.ts` 当前未接入 popup 主流程，仅保留在项目中

## 后续可扩展方向

- 支持更多排序方式
- 增加平盘数量汇总
- 增加基金搜索联想
- 增加自定义刷新频率
- 增加更完整的基金详情页