Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 14 additions & 4 deletions plugins/loan-calculator/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# 贷款计算器(loan-calculator)

> 一个面向房贷场景的多功能 ZTools 插件:房贷计算、方案对比、提前还款、浮动利率模拟、真实利率(IRR 反算)、历史记录。
> 一个面向房贷场景的多功能 ZTools 插件:房贷计算、贷款计算器(通用)、方案对比、提前还款、浮动利率模拟、真实利率(IRR 反算)、历史记录。

本插件为**单文件 HTML 插件**(无需构建),以 `index.html` 为主入口,`preload.js` 提供历史记录的本地持久化能力,所有计算与界面均在渲染进程内完成,开箱即用。

Expand All @@ -19,6 +19,14 @@
- 结果展示:月供、利息总额、还款总额;饼图(本金/利息占比)+ 月供趋势图
- 一键**导出 CSV**、**复制结果**

### 💰 贷款计算器(通用)

- 沿「房贷计算器」框架生成的**通用贷款**页签,**去除**购房套数、贷款类型(LPR)、加点 BP 等抵押专属输入,仅保留:贷款金额(元)、利率类型、利率、期数、还款方式
- **利率类型**三选,默认**年利率**:年利率 / 月利率 / 日利率(期数单位随类型在「月 / 天」间自动切换)
- **还款方式**三种:等额本息 / 等额本金 / **先息后本**(前 N-1 期仅还利息,末期利息+本金)
- 结果展示:每期还款、利息总额、还款总额;饼图(本金/利息占比)+ 剩余本金趋势图
- 一键**导出 CSV**、**复制结果**,并支持存入历史记录

### ⚖️ 方案对比

- 方案 A / 方案 B 双栏**等宽**并排对比
Expand Down Expand Up @@ -99,7 +107,7 @@ loan-calculator/

## 🚀 安装与使用

1. 下载构建产物 `loan-calculator-1.9.0.zpx`(见 `releases/`,或 PR 附件)。
1. 下载构建产物 `loan-calculator-1.9.2.zpx`(见 `releases/`,或 PR 附件)。
2. 在 ZTools 中「导入插件 / 安装本地插件」,选择该 `.zpx` 文件。
3. 通过指令 `贷款计算器` / `房贷` / `loan` 唤起,或在插件列表点击打开。

Expand Down Expand Up @@ -133,7 +141,7 @@ node tests/test-variable-rate.js
node tests/test-method-switch.js
```

当前测试覆盖:浮动利率核心计算(32)、中途切换还款方式(12)、导出 CSV / 跨页签交互修复(101)、真实利率 IRR 反算(27),共 **173 条断言全部通过**。
当前测试覆盖:浮动利率核心计算(32)、中途切换还款方式(12)、导出 CSV / 跨页签交互修复(101)、真实利率 IRR 反算(32)、贷款计算器通用页签(29)、贷款计算器 QA 校验(27),共 **233 条断言全部通过**。

---

Expand All @@ -150,7 +158,9 @@ node tests/test-method-switch.js
| v1.7.0 | 四项交互修复:①切公积金隐藏商业利率区 ②房贷结果一键加入方案对比(A,原 A→B) ③方案对比 A/B 等宽 ④跨页签自动缓存 |
| v1.8.0 | 四项功能优化:①组合贷贯穿对比/提前还款/利率演变三页 ②多页 CSV 导出 + 历史批量管理(搜索/筛选/多选/批量删除/重命名) ③利率联网健壮性(超时/重试/失败区分)+ LPR 走势图 ④DTI 跨页评估 + 等额本息/本金智能建议 |
| v1.8.1 | 新增「分期利率」页签:依据 PRD 用 IRR 法反算真实月利率,输出名义年化 APR、实际年化 IRR、总利息与还款明细;内置余额归零校验,支持复制/CSV 导出/历史保存。优化「每期还款」输入提示:根据分期方式(等额本息/等额本金/先息后本)与本金、期数、手续费实时给出每期还款下限,并在参数异常时提示具体阈值 |
| v1.9.0 | 作者改为 Samson;「分期利率」页签更名为「真实利率(IRR)」(更贴合由月供反算真实年化利率的本质),并与「历史记录」页签互换位置(真实利率置第 5、历史记录置第 6);提示文案实时回显实际填入的本金与期数 |
| v1.9.0 | 作者改为 Samson;「分期利率」页签更名为「真实利率(IRR)」(更贴合由月供反算真实年化利率的本质),并与「历史记录」页签互换位置(真实利率置第 5、历史记录置第 6);提示文案实时回显实际填入的本金与期数。新增「贷款计算器」通用页签(沿房贷框架、去除抵押专属输入,支持日/月/年利率与先息后本还款方式),修复校验失败时按钮死锁 |
| v1.9.1 | 10 项体验与稳健性优化:统一金额格式化 `fmtYuan2`、重构贷款明细构建、清理冗余代码、`showLoanErr` 无错误时清空提示、利率类型上限校验、输入无障碍属性补齐、输入实时重算防抖、表格/复制文本重构、结果区防止溢出等 |
| v1.9.2 | 「贷款计算器」切换年利率 / 月利率 / 日利率时自动填入合理默认值(4.9 / 0.4 / 0.013),避免切换后利率为空导致误算;补齐 README 与页面版本号一致性 |

---

Expand Down
Loading
Loading