在 VSCode 侧边栏实时查看自选基金估值、涨跌幅与收益，支持加减仓操作、多维度排序、拖拽排序、行情中心大盘数据、AI 分析等功能。摸鱼理财两不误！
📑 目录 (Table of Contents)
🔮 项目背景 (Project Background)
- 上班想偷偷看看基金涨跌？打开浏览器太明显，手机也不方便？💰
- 那就直接在 VSCode 里看吧！侧边栏一瞥，涨跌尽收眼底，摸鱼理财两不误 🐟
- 灵感来源于浏览器端的基金查看插件，将核心功能迁移到 VSCode 环境中，让开发者在写代码的间隙就能关注持仓动态
✨ 主要功能 (Key Features)
- 📊 实时估值：基于天天基金 JSONP 接口，实时获取基金估算净值和涨跌幅
- 📋 侧边栏展示：TreeView 形式展示基金列表，展开查看详细信息
- 🎨 涨红跌绿：图标、Tooltip、详情项均直观标识涨跌状态
- 🔄 多维排序：支持按涨跌幅、估算收益、持有额、持有收益、持有收益率进行升降序排序
- 🖱️ 拖拽排序：默认排序下可拖拽调整基金顺序
- ➕ 加仓/减仓：选择历史净值日期买入，直接输入买入金额自动为你精算持有份额，也支持按照卖出金额快速减仓。
- ✏️ 修改持仓：自由修改总份额和成本价；如份额清仓记为 0 时则不再弹窗询问成本，丝滑一气呵成。
- 📤 导入/导出：JSON 格式导入导出基金列表，支持合并或覆盖
- 📌 状态栏摘要：底部状态栏显示总日收益和百分比，仅亏损时显示绿色提醒
- ⏰ 自动刷新：交易时间内自动刷新数据，间隔可配置。智能识别周末和法定节假日，非交易日停止刷新
- 🧠 AI 智能分析：接入多种 AI 大模型（OpenAI, 阿里云百炼, 硅基流动, DeepSeek 等），自动生成专业投资诊断报告
- 🔍 搜索/筛选：侧边栏内置搜索框，按名称或代码实时筛选基金列表，支持一键清除
- 📈 行情中心：侧边栏可折叠节点，展示四大指数实时数据；行情 Webview 包含大盘资金统计、资金流向折线图（ECharts）、行业/风格/概念/地域板块排行（支持今日/5日/10日切换）
- 📅 开市/休市提示：行情中心 item 前实时显示「开市」/「休市中」状态
- 💾 数据持久化：基金列表、排序方式保存到 VSCode 用户全局配置
- 🎨 界面优化（🆕）：全新表格视图设计，支持按列排序、调整列宽；Tooltip 样式统一优化；状态栏仅亏损时显示绿色警示，减少色彩干扰
💻 系统要求 (System Requirements)
- VSCode 版本：1.82.0 及以上
- 操作系统：Windows / MacOS / Linux
- 网络：需要访问天天基金 API（
fundgz.1234567.com.cn）和东方财富行情 API
🚀 快速开始 (Quick Start)
1. 安装插件
在 VSCode 扩展市场搜索 "基金助手" 或 "Fund Helper" 并安装，安装完成后在侧边栏中找到 📈 图标。
2. 添加基金
点击侧边栏标题栏的 + 按钮，输入基金名称或代码进行搜索，选择要添加的基金。
3. 导入持仓
如果已有持仓数据，可以通过标题栏 ... → 导入基金列表 导入 JSON 文件：
{
"funds": [
{ "code": "020256", "cost": "1.6399", "num": "7317.33" },
{ "code": "110020", "cost": "2.1500", "num": "5000.00" }
]
}
4. 开始使用
添加基金后，插件会自动获取实时估值数据。
- 🔺/🔻 图标直观显示涨跌
- 悬浮基金查看详细 Tooltip（涨红跌绿高亮）
- 悬浮排序栏查看持仓概览
- 展开基金查看详情信息
- 使用 inline 按钮（
+ - ✏ 🗑）快速操作
- 点击「🔍 搜索 / 筛选基金...」快速找到指定基金
- 点击「行情中心」节点展开查看四大指数，再点展开「查看行情详情」打开完整行情 Webview
⚙️ 配置说明 (Configuration)
在 VSCode 设置中搜索 fund-helper，可配置以下选项：
| 配置项 |
说明 |
默认值 |
fund-helper.funds |
自选基金列表（{code, cost, num}） |
[] |
fund-helper.refreshInterval |
数据刷新间隔（秒），设为 0 关闭自动刷新 |
30 |
fund-helper.sortMethod |
排序方式 |
default |
fund-helper.hideStatusBar |
隐藏状态栏金额（hover 时显示） |
false |
fund-helper.aiProvider |
AI服务商(openai/aliyun/deepseek等) |
openai |
fund-helper.aiApiKey |
AI服务的 API Key |
"" |
fund-helper.aiModel |
使用的 AI 模型 (如 gpt-3.5-turbo) |
gpt-3.5-turbo |
fund-helper.aiApiEndpoint |
AI API 自定义请求地址 |
https://api.openai.com/v1 |
也可通过侧边栏 ... More Actions 快速修改刷新间隔或一键开关自动刷新。
⭐ 如何使用 AI 分析功能：
- 点击标题栏的 ⚙ （配置AI） 按钮。
- 按照向导选择对应的 AI 提供商，输入您的 API Key 和对应的模型。
- 点击 测试连接，成功后点击 完成配置。
- 返回基金列表点击标题栏的 💡 （AI 分析） 按钮，即可生成详细的持仓分析报告。
💥 更新日志 (Changelog)
🗺️ TODO (Roadmap)
- [x] 支持查看基金历史走势图（Webview 详情页）
- [x] 支持 Webview 详情页展示更丰富的基金信息
- [x] 行情中心：大盘指数、资金流向、板块排行
- [ ] 支持自定义涨跌颜色主题
- [ ] 支持多组合切换（如：A股组合、港股组合）
- [ ] ...
🔧 技术实现 (Technical Implementation)
- 基于 VSCode Extension API 开发，使用 TreeView 构建侧边栏界面
- 使用
fundgz.1234567.com.cn JSONP 接口获取基金实时估值
- 使用
fundsuggest.eastmoney.com 接口进行基金搜索
- 使用
api.fund.eastmoney.com 接口获取历史净值
- 使用
push2.eastmoney.com 接口获取大盘指数与资金流向
- 使用
data.eastmoney.com 接口获取板块排行（通过宿主进程代理解决 CORS）
- 使用 ECharts 绘制资金流向折线图与板块柱状图
- 技术栈：TypeScript、VSCode Extension API、ECharts
⚠️ 免责声明 (Disclaimer)
- 本插件仅供学习和个人使用，不构成任何投资建议。
- 基金投资有风险，入市需谨慎。插件展示的数据均为估算值，实际收益以基金公司公布为准。
- 本项目与天天基金、东方财富等平台无任何关联，仅为个人学习项目。
📄 开源协议 (License)
- 本项目采用 MIT 协议 开源，您可以自由使用、修改和分发。
| |
