Add plugin: loan-calculator v1.7.0

plugins/loan-calculator/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ztocwst
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

plugins/loan-calculator/README.md

@@ -0,0 +1,155 @@
+# 贷款计算器（loan-calculator）
+
+> 一个面向房贷场景的多功能 ZTools 插件：房贷计算、方案对比、提前还款、浮动利率模拟、历史记录。
+
+本插件为**单文件 HTML 插件**（无需构建），以 `index.html` 为主入口，`preload.js` 提供历史记录的本地持久化能力，所有计算与界面均在渲染进程内完成，开箱即用。
+
+---
+
+## ✨ 功能特性
+
+### 🏠 贷款计算器（房贷）
+
+- 支持三种贷款类型：**商业贷款 / 公积金 / 组合贷**
+- 支持两种还款方式：**等额本息 / 等额本金**
+- 利率模式：**最新利率（自动回填）** 与 **自定义**
+  - 商业贷款利率基于最新 LPR（5 年以上 3.5%）+ BP 加点
+  - 公积金利率为政策固定值，按首套/二套 × 5 年内/5 年以上四档自动回填
+- 输入校验：金额、年限、利率、加点实时校验并提示
+- 结果展示：月供、利息总额、还款总额；饼图（本金/利息占比）+ 月供趋势图
+- 一键**导出 CSV**、**复制结果**
+
+### ⚖️ 方案对比
+
+- 方案 A / 方案 B 双栏**等宽**并排对比
+- 自动计算差额（月供差、利息差、总额差）与百分比
+- 支持商业/公积金利率与 BP 加点分别配置
+- 当前房贷结果可**一键加入方案 A**（原 A 自动移至 B），组合贷自动换算等效固定利率
+- 一键**导出对比 CSV**
+
+### 💰 提前还款
+
+- 支持**一次提前还款**与**多次时间线提前还款**
+- 双策略对比：月供不变缩短期限 / 期限不变减少月供
+- 对比**不提前还款**方案，量化节省利息
+- 可选对接理财收益率（vs 投资），评估提前还款是否划算
+- 一键**复制 / 导出**完整报表
+
+### 📈 浮动利率模拟
+
+- 基于历史 LPR 变化 + BP 加点变化逐月模拟还款计划
+- 时间线支持多个节点（月份、LPR、BP），每个节点可独立切换还款方式
+- 内置预设：「近 3 年 LPR 走势」「每年降 10BP」
+- 固定 vs 浮动对比卡片、月供变化曲线、利率变化节点表
+- 360 期逐月明细，**导出 CSV**
+
+### 🕘 历史记录
+
+- 自动保存最近 10 条计算方案（localStorage 持久化，跨会话保留）
+- 支持回填、删除、清空
+- 浮动利率方案可完整回填至浮动利率 Tab
+
+### 🔄 跨页签缓存
+
+- 所有页签输入/配置自动缓存，切换或重载不丢失
+- 仅对「已计算」的页签在初始化时自动重算，避免未配置出乱数
+
+---
+
+## 📁 项目结构
+
+```
+loan-calculator/
+├── publish/                # 发布根目录（与中心仓库 plugins/loan-calculator/ 一一对应，独立 git 仓库）
+│   ├── plugin.json         # 插件配置（ZTools 识别入口）
+│   ├── index.html          # 主入口（UI + 全部计算逻辑，单文件无构建）
+│   ├── preload.js          # 预加载脚本（历史记录本地持久化桥接）
+│   ├── logo.png            # 插件图标（128×128 PNG）
+│   ├── README.md           # 项目说明（本文件）
+│   ├── LICENSE             # MIT 开源协议
+│   └── .gitignore
+├── tests/                  # 端到端测试（jsdom，本地开发用，不参与发布）
+│   ├── test-export-csv.js
+│   ├── test-variable-rate.js
+│   └── test-method-switch.js
+└── releases/               # 历史构建产物 .zpx / .zip（本地归档，不参与发布）
+```
+
+> 发布时 `ztools publish` 在 `publish/` 目录下执行，仅该目录内的 7 个文件进入中心仓库 `plugins/loan-calculator/`；`tests/` 与 `releases/` 始终留在本地，不会发布。
+
+---
+
+## 🚀 安装与使用
+
+1. 下载构建产物 `loan-calculator-1.7.0.zpx`（见 `releases/`，或 PR 附件）。
+2. 在 ZTools 中「导入插件 / 安装本地插件」，选择该 `.zpx` 文件。
+3. 通过指令 `贷款计算器` / `房贷` / `loan` 唤起，或在插件列表点击打开。
+
+### 配置说明（plugin.json 关键字段）
+
+| 字段 | 含义 |
+|---|---|
+| `name` | 插件唯一标识 `loan-calculator`（对应中心仓库目录 `plugins/loan-calculator/`） |
+| `title` / `pluginName` | 展示名称「贷款计算器」 |
+| `main` | 主入口 `index.html` |
+| `logo` | 图标 `logo.png` |
+| `preload` | 预加载脚本 `preload.js` |
+| `features[].code` | 功能标识 |
+| `features[].cmds` | 触发指令 |
+| `pluginSetting.single` | `true`（单实例） |
+| `pluginSetting.height` | 内嵌窗口高度 `640` |
+
+---
+
+## 🧪 本地开发 / 测试
+
+插件为纯前端单文件，无需 `npm install` 即可运行；测试基于 `jsdom`（需安装）：
+
+```bash
+# 安装测试依赖（仅需一次）
+npm install jsdom --workspace=../node_modules  # 或放入本地 node_modules
+
+# 运行端到端测试
+NODE_PATH=<jsdom 所在 node_modules> node tests/test-export-csv.js
+node tests/test-variable-rate.js
+node tests/test-method-switch.js
+```
+
+当前测试覆盖：浮动利率核心计算（32）、中途切换还款方式（12）、导出 CSV / 跨页签交互修复（100），共 **144 条断言全部通过**。
+
+---
+
+## 📋 版本历史
+
+| 版本 | 要点 |
+|---|---|
+| v1.1.0 | 基础房贷计算 + 历史记录 + 图表 + CSV 导出 |
+| v1.2.0 | 浮动利率模拟（逐月可变利率） |
+| v1.3.0 | 浮动利率支持按节点切换还款方式 |
+| v1.4.0 | 11 项交互优化（输入校验 / tooltip / 复制 / 恢复默认 / 多 Tab 导出） |
+| v1.5.0 | 公积金四档利率 + 切换自动回填（联网核实 2026-08 最新 LPR） |
+| v1.6.0 | 交互界面现代化重设计（设计令牌 / sticky 导航 / 精致化控件） |
+| v1.7.0 | 四项交互修复：①切公积金隐藏商业利率区 ②房贷结果一键加入方案对比（A，原 A→B） ③方案对比 A/B 等宽 ④跨页签自动缓存 |
+
+---
+
+## 📸 截图
+
+> 请在此处补充插件运行截图 / 演示 GIF（在 PR 描述中直接拖入图片，GitHub 会自动上传）。
+> 建议包含：房贷计算主界面、方案对比、提前还款、浮动利率模拟、历史记录。
+
+---
+
+## ✅ 发布自检清单
+
+- [ ] `plugin.json` 字段完整（`name` / `title` / `description` / `version` / `main` / `logo` / `features` 齐全且格式正确）
+- [ ] 插件可正常加载运行，无控制台报错
+- [ ] 已提供功能截图 / 演示 GIF
+- [ ] 已阅读并遵守 ZTools 插件规范（无恶意代码、不收集用户隐私、不请求无关权限）
+- [ ] `README.md` 文档完整（功能、结构、使用、版本历史、自检清单）
+
+---
+
+## 📄 开源协议
+
+[MIT License](./LICENSE) © 2026 ztocwst