Skip to content

README_ZH.md

Latest commit

 

History

History
146 lines (105 loc) · 5.12 KB

README_ZH.md

File metadata and controls

146 lines (105 loc) · 5.12 KB
Raw

股票均价计算器

English | 中文

你还在为股票补仓后不知道新的持仓均价而发愁？ 分批买入、做 T 之后，成本到底摊到多少了？试试这款浏览器插件——输入各批次的数量与买入价格，加权平均价、总投入、总股数，秒出结果。

一款轻量级的浏览器扩展，用于计算多次分批买入后的加权平均持仓成本。输入各批次的数量与买入价格，即可实时得到平均费用、总投入金额与总持股数量。

Chrome 扩展 License

预览

初始界面 计算结果与历史记录
初始界面 计算结果

界面会根据浏览器语言自动切换中英文。英文界面截图见 images/ScreenShot_EN_01.png 与 images/ScreenShot_EN_02.png。

功能特性

  • 实时计算 — 输入数量与价格后，平均费用、总金额、总量即时更新
  • 多批次录入 — 支持添加多行，模拟多次加仓、补仓场景
  • 历史记录 — 自动保存符合条件的计算结果，最多保留 50 条
  • 一键回填 — 点击历史记录即可恢复当时的输入数据
  • 清空重置 — 一键清除所有输入，重新开始计算
  • 多语言 — 内置中文（简体）与英文，跟随浏览器语言显示
  • 隐私友好 — 仅使用 storage 权限，数据保存在本地，不上传服务器

适用场景

  • 分批买入同一只股票，想知道当前综合持仓成本
  • 做 T、补仓后快速估算新的平均价
  • 对比不同加仓方案下的成本变化

计算说明

扩展采用加权平均算法：

平均费用 = 总金额 ÷ 总数量
总金额   = Σ(数量 × 价格)
总数量   = Σ(数量)

示例： 第一次买入 1000 股 × 10 元，第二次买入 1000 股 × 5 元

项目 数值
总金额 15,000.00
总数量 2,000
平均费用 7.50

安装方法

从源码安装（开发者模式）

  1. 克隆本仓库：

    git clone https://github.com/licc12/Stock-Price-Calculator.git
cd Stock-Price-Calculator

  2. 打开 Chrome（或 Edge、Brave 等 Chromium 内核浏览器），进入扩展管理页：

    • Chrome：chrome://extensions/
    • Edge：edge://extensions/

  3. 开启右上角 开发者模式

  4. 点击 加载已解压的扩展程序，选择项目根目录

  5. 安装完成后，点击工具栏中的扩展图标即可使用

本项目尚未发布到 Chrome 网上应用店，目前仅支持手动加载。

使用说明

  1. 输入数据 — 在「数量」和「价格」栏中填写各批次的买入信息，默认提供两行
  2. 添加行 — 点击「+ 添加一行」录入更多批次
  3. 查看结果 — 顶部卡片实时显示平均费用、总金额与总量
  4. 保存历史 — 当满足以下条件时，失焦后自动写入历史：
    • 至少 2 行有效输入（数量 > 0，价格 ≥ 0）
    • 存在至少 2 种不同的买入价格
  5. 恢复记录 — 点击历史列表中的条目，输入区会自动回填
  6. 删除记录 — 点击历史条目右侧的「删除」按钮
  7. 清空输入 — 点击「清空」按钮重置所有输入行

项目结构

Stock-Price-Calculator/
├── manifest.json          # 扩展清单（Manifest V3）
├── popup/
│   ├── popup.html         # 弹窗页面
│   ├── popup.css          # 样式
│   └── main.js            # 入口逻辑
├── src/
│   ├── calculator.js      # 均价计算核心
│   ├── constants.js       # 常量配置
│   ├── i18n.js            # 国际化
│   ├── storage/
│   │   └── history.js     # 历史记录存储
│   ├── ui/
│   │   ├── inputs.js      # 输入行管理
│   │   ├── result.js      # 结果展示
│   │   └── history.js     # 历史列表
│   └── utils/
│       └── format.js      # 数字格式化
├── _locales/
│   ├── zh_CN/messages.json
│   └── en/messages.json
├── icons/                 # 扩展图标
└── images/                # 截图资源

技术栈

  • Manifest V3 — 最新 Chrome 扩展规范
  • 原生 JavaScript（ES Modules） — 无构建工具依赖，克隆即用
  • Chrome Storage API — 本地持久化历史记录
  • Chrome i18n — 浏览器原生国际化方案

隐私说明

本扩展：

  • 仅申请 storage 权限，用于在本地保存计算历史
  • 不收集、不上传任何用户数据
  • 不访问网页内容，不注入任何脚本
  • 所有计算均在本地完成

开源协议

本项目采用 MIT License 开源。

贡献

欢迎提交 Issue 或 Pull Request。在提交代码前，请确保：

  • 保持现有代码风格与目录结构
  • 新增 UI 文案需同时更新 _locales/zh_CN 与 _locales/en

如果这个项目对你有帮助，欢迎 Star ⭐