一个面向真实看车场景的购车落地价计算和多店报价对比工具。它把销售口头报价里容易混在一起的项目拆开：指导价、厂商优惠、开票价、不含税价、购置税、保险/上牌等其他费用、贷款利息与附加费、放弃的全款优惠、以旧换新补贴、地方补贴和赠品估值，并输出首期垫付、确认口径、预计总支出、综合年化成本、报价完整度与跨店可比性提示。
政策和费用口径会随地区、时间、车型目录、发票开具方式变化。本工具用于辅助核算和比价，不替代政府公告、税务机关、商务主管部门、经销商合同和最终发票。
在线版本：
https://ganghaosun.github.io/car-buying-calculator/
第一次使用建议先阅读 新用户使用说明书。说明书按真实看车流程介绍字段填写、全款/贷款口径、结果解读、多店对比、OCR、本地证据、数据备份和常见问题，并明确区分在线版、本地 HTTP 和直接双击 HTML 的功能边界。
最近准备买车时，我发现线下看车时常见的报价方式很不透明：销售会拿纸笔把裸车价、优惠、保险、上牌、购置税、置换补贴、赠品写在一起算一个“最终价格”。用户很难快速判断：
- 优惠到底是直接减开票价，还是后返补贴；
- 购置税的计税基础为什么不是指导价本身；
- 国补、地方补贴、厂商补贴能不能叠加；
- 提车当天真正要垫付多少钱；
- 不同 4S 店报价到底谁更划算；
- 赠品价值是否应该计入实际支出。
这个项目的目标不是做一个“报价单美化器”，而是把每一项费用拆成清晰、可核算、可横向比较的结构，让买车时不被一个总价带着走。
- 基础价格录入：官方指导价、增值税率。
- 厂商优惠拆分：支持添加多个现金优惠/厂家补贴项目。
- 购置税计算：按开票价剥离增值税后计算计税基础。
- 新能源购置税优惠提示：支持新能源车型，并提示 2026-2027 年插混/增程技术门槛需以官方目录为准。
- 燃油车排量区分：支持 2.0L 及以下、2.0L 以上口径。
- 以旧换新补贴：支持不参与、报废更新、置换更新。
- 旧车资格校验：按旧车类型和注册日期提示是否满足报废更新条件。
- 保险费用拆分：支持交强险、车船税、车损险、三者险、驾乘险、医保外用药责任险和自定义保险项。
- 其他费用：上牌费、服务/精品包等非保险费用可以单独录入。
- 其他补贴：地方补贴、市级补贴、区级补贴等可以单独录入。
- 赠品估值：免费保养、贴膜、充电桩等不计入实际支出，但用于综合对比。
- 贷款购车计算：支持首付比例或首付金额二选一、等额本息、等额本金、金融附加费、放弃的全款现金优惠、提前结清期数、违约金比例、月度还款计划和贷款决策总成本。
- 综合年化成本：根据贷款本金、逐期还款、金融服务/GPS 等附加费、放弃的全款优惠和厂家贴息估算综合年化，避免只看名义利率或月供。
- 厂家金融贴息：将厂家/销售承担的贴息单独录入，展示贴息前后金融成本、客户实际还款额和现金流影响；仍需以合同约定为准。
- 贷款方案对比：同一报价可横向比较全款、等额本息和等额本金，并显示首期垫付、首月月供、总利息、金融附加费、贴息和预计总支出。
- 贷款现金流时间轴：按提车日、贴息抵扣和每期月供展开现金流，显示客户现金流、本金、利息和剩余本金。
- 补贴确认分层：其他补贴可标记为已确认、待申请/有条件或销售口头承诺，分别计算“确认口径总支出”和“预计总支出”。
- 长期持有成本：支持 3 年或 5 年测算，录入年里程、能源成本、续保、保养和预计残值，输出年均和总持有成本。
- 报价链接分享：使用压缩后的 URL 片段编码当前报价，接收方打开链接即可查看结果；分享数据会主动排除证据文件和经销商/车型等识别信息。
- 二维码分享：在链接足够短时生成二维码；报价过大时会明确提示改用压缩链接或 JSON 导出，避免生成无法扫描的二维码。
- 计算过程展示：可查看每一步公式和中间值。
- 费用构成图：在结果页用条形图展示开票价、购置税、保险、其他费用、贷款成本、补贴抵扣和赠品估值。
- 报价风险提示：自动提示保险漏填、其他费用偏高、贷款附加成本偏高、后返补贴、赠品估值和新能源目录核验等风险。
- 报价完整度评分：检查车型年款/配置、保险公司与保额、收费确认、补贴条件、金融方案和合同关键条款，显示 0-100 分及待补项。
- 可比性标准化：对比报价时检查车型配置、保险口径、付款方式和贷款条件，不同口径会明确标为“部分项目不可直接比较”。
- 报价报告导出：支持导出 HTML 报价报告、原生可检索 PDF 和 PNG 长图；PDF 在浏览器本地生成，包含核心费用表、风险提示、计算过程摘要和免责声明。
- 结果摘要分享：支持复制或调用浏览器原生分享，把报价摘要发给家人朋友讨论。
- 本地保存报价：把多家 4S 店报价保存到浏览器本地。
- 报价导入/导出：支持报价 JSON 导入导出和 CSV 表格；完整 ZIP 备份会同时保存报价 JSON 与 IndexedDB 证据附件，并可整包恢复。
- 一键复制报价：把已有记录的所有输入项回填到录入页，只修改另一家店的差异项后重新计算；证据附件不会被误复制。
- 报价单证据留存：照片、扫描件和合同附件保存在浏览器 IndexedDB，可查看、下载和随报价删除，不上传服务器。
- OCR 辅助录入：报价单图片可通过浏览器端 OCR 识别指导价、开票价、优惠、购置税、保险和贷款字段；识别结果必须人工确认后再写入表单。
- 多店横向对比：自动标记最低预计成本，生成多店成本图，并支持最多 4 条报价逐项对比；车型配置、保险和贷款条件不一致时给出可比性提示。
- 政策参数外部化：购置税、补贴比例、补贴封顶值、旧车注册时间、政策版本、有效期和核验日期集中在
data/policy.json中；支持导入带来源和有效期的城市政策包。 - 真正离线化：OCR Worker/WASM/中英文模型、二维码、ZIP 和长图运行库全部保存在仓库
vendor/；页面使用系统中文字体栈，不再请求 Google Fonts 或公共 CDN。 - 离线状态提示：页面显示当前网络、记录/证据存储、OCR/二维码本地资源和 PWA 缓存接管状态。
- 主题、键盘与无障碍：支持浅色/深色主题、跳到主要内容、可见焦点、减少动画、对话框语义、
Esc关闭弹窗和Ctrl/Cmd + Enter计算。 - 真实自动化测试：Node.js 单元测试覆盖计算核心和 PDF 生成器；Playwright 覆盖录入、计算、保存、复制、对比、JSON 导入导出、ZIP 备份恢复、长图、PDF 下载、PWA 离线 OCR 和手机尺寸。
- GitHub Actions：每次提交到
main或 Pull Request 自动运行单元测试、政策包校验和 Chromium/Firefox/WebKit E2E 矩阵。 - PWA 支持：包含
manifest.json和sw.js，部署到 HTTPS 后可添加到手机桌面并离线运行已缓存资源。
开票价 = 官方指导价 - 厂商优惠合计
这里的“厂商优惠”按直接影响发票金额处理。如果实际优惠是提车后返现或地方补贴，不建议填在这里，应填到“其他补贴”。
不含税价 = 开票价 ÷ (1 + 增值税率)
默认增值税率为 13%，可手动调整。购置税通常不是直接用含税价乘 10%，而是以不含增值税的计税价格作为基础。
燃油车：
购置税 = 不含税价 × 10%
新能源车在当前页面中按 2026-2027 年“减半并设置单车减免上限”的思路计算：
原始购置税 = 不含税价 × 10%
减免额 = min(不含税价 × 5%, 15000)
实缴购置税 = 原始购置税 - 减免额
不同车型是否进入《减免车辆购置税的新能源汽车车型目录》，以及插混/增程车型技术门槛，应以工信部等主管部门最新目录和公告为准。
保险费用 = 交强险 + 车船税 + 商业险各险种 + 其他保险项
其他费用 = 上牌费 + 服务费/精品包 + 其他非保险收费项
保险价格会受到车型、城市、保险公司、保额、出险记录和是否捆绑销售等因素影响。本工具只做费用拆分和估算，最终应以保险公司正式报价为准。
提车时需垫付 = 开票价 + 购置税 + 保险费用 + 其他费用
这里强调“垫付”，因为很多补贴不是提车当天直接抵扣，而是后续申请或返还。
贷款购车时，页面会把“提车时需垫付”切换为“首期需垫付”：
首期需垫付 = 首付金额 + 购置税 + 保险费用 + 其他费用 + 金融服务费
页面同时计算等额本息和等额本金。等额本息的月供为：
首付金额 = 开票价 × 首付比例，或直接输入首付金额
贷款本金 = 开票价 - 首付金额
月利率 = 年化利率 ÷ 12
月供 = 贷款本金 × 月利率 × (1 + 月利率)^期数 ÷ ((1 + 月利率)^期数 - 1)
贷款实际现金总成本 = 首付金额 + 客户实际还款额 + 购置税 + 保险费用 + 其他费用 + 金融附加费用 - 各类补贴
贷款决策总成本 = 贷款实际现金总成本 + 放弃的全款现金优惠
如果填写厂家贴息，页面会将贴息限制在实际利息范围内：
客户实际还款额 = 贷款总还款 - 实际生效贴息
综合融资成本 = 总利息 + 金融附加费用 + 放弃的全款现金优惠 - 实际生效贴息
决策口径净融资额 = 贷款本金 - 金融附加费用 - 放弃的全款现金优惠 + 实际生效贴息
综合年化通过“决策口径净融资额 = 每期还款现金流折现值”求月度内部收益率，再换算成年化。厂家贴息按提车时等价抵扣估算，因此它是用于横向比较的综合成本指标，不是金融机构披露的法定年化利率。等额本金按每期固定偿还本金、利息随剩余本金下降计算；提前结清按已还期数、剩余本金和违约金估算。正式签约仍应以合同、逐期还款计划和金融机构披露口径为准。
确认口径总支出 = 贷款/全款毛成本 - 已确认补贴
预计总支出 = 确认口径总支出 - 以旧换新补贴 - 待确认/口头承诺补贴
结果页同时展示提车或首期垫付、确认口径总支出和预计总支出。预计总支出可能包含尚未到账的补贴，不应替代合同金额。
综合等效支出 = 预计总支出 - 赠品估值
赠品估值只用于横向比较，不等同于现金支出减少。长期持有成本则在预计总支出基础上增加能源、续保和保养预算，并扣除预计残值：
长期持有成本 = 预计总支出 + 能源费用 + 第2年起续保费用 + 保养费用 - 预计残值
比如“免费保养 2000 元”可能对你有价值，但不能直接视为少付了 2000 元。
贷款结果页会把首期垫付、厂家贴息和每期月供按时间顺序展开。每期记录包含客户现金流、本金、利息和剩余本金，用于回答“提车时需要准备多少钱”和“以后每个月实际流出多少钱”，不等同于银行正式还款计划。
这是纯静态页面，没有后端服务，也不需要数据库。
- 下载或克隆本仓库。
- 推荐使用 GitHub Pages 在线版或通过本地 HTTP 服务打开；双击
index.html仅适合普通计算。 - 输入车型年款、配置、选装、指导价和各项优惠。
- 选择全款或贷款购车；贷款可按首付比例或金额录入，并填写金融机构/方案、期数、名义利率、金融附加费、厂家贴息、放弃的全款优惠和提前结清参数。
- 拆分录入保险费用，并记录保险公司、主要险种与保额口径。
- 点击“立即计算”。
- 在结果页查看费用明细、报价完整度、确认口径、预计总支出、综合年化、贷款方案、现金流、费用构成、风险提示和计算过程。
- 可点击“复制/分享摘要”，把报价结果发给家人朋友讨论。
- 可生成报价链接或二维码；可导出 HTML 报告后打印为 PDF，也可直接导出 PNG 长图。
- 如需测算长期成本，在“长期持有成本”中选择 3 年或 5 年并填入里程、能源、续保、保养和残值参数。
- 点击“保存报价记录”，保存多家 4S 店报价后进入“对比记录”横向比较。
- 在“对比记录”页选择 2 至 4 条报价查看逐项差异和可比性提示；“复制”可回填旧报价，“完整备份”可把报价和证据附件一起导出 ZIP。
- 如有带官方来源和有效期的城市政策 JSON，可从“政策配置状态”导入；没有经过核验的政策不要直接使用。
- 可点击“添加报价单/合同照片”把材料留在本机浏览器，并定期用完整 ZIP 备份；重要原件仍建议在独立位置保存。
- 图片报价单可点击“识别报价单”进行 OCR 辅助录入，逐项核对识别结果后再确认，不要把 OCR 结果直接视为合同数据。
- 可用右上角切换浅色/深色主题；键盘用户可用
Ctrl/Cmd + Enter计算、Esc关闭弹窗。
推荐通过本地 HTTP 服务打开，PWA/Service Worker 在 file:// 下不会完整工作。
# 在仓库根目录执行
python -m http.server 8080然后访问：
http://127.0.0.1:8080/
如果你的 Python 环境不可用，也可以用任意静态服务器，例如 VS Code Live Server、Nginx、Caddy、Node 静态服务等。
Node.js 20 环境下先安装锁定依赖：
npm ci运行计算核心单元测试：
npm test运行 Chromium 端到端测试：
npx playwright install chromium
npm run test:e2e更新 README 截图：
npm run screenshots测试覆盖购置税、补贴分层、贷款综合年化、完整度、可比性、旧记录迁移、分享编码，以及录入、保存、复制、逐项对比、JSON/ZIP 导入导出、证据附件、长图、PWA 离线 OCR、主题、键盘和手机尺寸。
- 推送到 GitHub 仓库。
- 打开仓库
Settings -> Pages。 - Source 选择
Deploy from a branch。 - Branch 选择
main，目录选择/root。 - 保存后等待 GitHub Pages 构建完成。
部署到 HTTPS 后，PWA 安装和离线缓存体验会比本地打开文件更完整。
建议每家店都按同一套口径录入：
- 指导价：填官方指导价或销售报价单上的车辆指导价。
- 厂商优惠：只填直接减少发票金额的优惠。
- 车辆类型：选择新能源/燃油车，并补充细分类别或排量。
- 以旧换新：如果有旧车，选择报废更新或置换更新，并录入旧车类型、注册日期、是否满 1 年。
- 保险费用：拆分交强险、车船税、车损险、三者险、驾乘险等，不要只填一个“保险总价”。
- 其他费用：填上牌、服务费、精品包等所有非保险收费项。
- 其他补贴：填地方补贴、区补、店端后返、置换后返等不在发票中直接抵扣的补贴。
- 赠品：填免费保养、贴膜、脚垫、充电桩、漆面保护等估值。
- 查看风险提示：重点核对保险、服务费、贷款附加成本、后返补贴和赠品承诺。
- 保存报价：记录经销商、车型、备注。
- 对比记录：看“实际支出”和“等效支出”，不要只看销售口头总价。
页面中保留了政策依据入口，建议实际使用前再核对：
- 财政部：https://www.mof.gov.cn/
- 国家税务总局：https://www.chinatax.gov.cn/
- 工业和信息化部：https://www.miit.gov.cn/
- 商务部：https://www.mofcom.gov.cn/
- 国家发展改革委：https://www.ndrc.gov.cn/
特别注意：
- 新能源购置税优惠是否适用，取决于车型是否进入官方目录。
- 插混/增程车型在 2026-2027 年的技术门槛应以最新目录和公告为准。
- 以旧换新补贴通常涉及报废/转让时间、旧车登记时间、本人名下持有时间、新车开票时间、申请材料等条件。
- 地方补贴经常有城市、区县、购车时间、发票地、上牌地、名额、预算总额限制。
- 经销商口头承诺的补贴和赠品，建议写入合同或补充协议。
通用估算参数位于 data/policy.json，包含政策名称、版本号、更新时间、适用地区、有效期、核验日期、官方入口、购置税参数、以旧换新比例和封顶值等信息。线上访问时页面会优先读取该 JSON；如果用户直接用浏览器打开 index.html，页面会使用内置兜底配置，保证纯静态使用不受影响。
data/policy-template.json 是城市政策包字段模板，不包含真实地方补贴金额。导入政策包前应补充主管部门官方来源、适用时间、适用地区、申请条件和已核验参数。页面会在政策过期或生效日期尚未到达时提示复核。
- 所有计算都在浏览器本地完成。
- 报价记录保存在当前浏览器的
localStorage。 - 报价单照片、扫描件和合同附件保存在当前浏览器的 IndexedDB；清理站点数据、更换浏览器或设备会导致这些本地证据丢失。
- 没有业务后端，不上传你的报价、手机号、地址、车辆信息或本地证据。
- OCR、二维码、ZIP 和长图运行库及 OCR 中英文模型均随仓库发布；在 PWA 首次缓存完成后可断网使用，不向公共 CDN 发起请求。
- 分享链接只携带压缩后的计算数据，不携带本地证据、经销商、车型和备注字段；但 URL 仍可能较长，也不具备撤销能力。
- 清理浏览器数据、更换浏览器或更换设备会导致本地记录丢失。
- JSON 只备份结构化报价；“完整备份”导出的 ZIP 同时包含报价和 IndexedDB 证据附件。重要合同原件仍应在独立文件夹或可靠存储中保留。
截至 2026-07-12，项目已形成完整的纯静态 Web/PWA 使用闭环：报价拆解、全款/贷款核算、综合年化、补贴分层、保险拆分、完整度评分、可比性检查、一键复制、长期成本、多店对比、JSON/CSV/ZIP 备份恢复、分享链接、二维码、本地证据、离线 OCR、HTML 报告、原生可检索 PDF、PNG 长图、主题、键盘和无障碍基础能力均已实现。计算核心单元测试、政策包校验和 Chromium/Firefox/WebKit 自动化矩阵已纳入 npm run check；不依赖外部真实设备、真实报价单样本或地方政策数据的工程交付已经完成。
- 暂未内置城市级真实补贴数据库；仓库已提供城市政策包目录、模板、维护说明和校验脚本，但真实政策包必须逐条核验官方来源后再发布。
- 暂未自动识别车型是否进入新能源免税目录。
- 保险费用已支持拆分，但仍属于手动估算，不自动联网获取保险公司报价。
- 贷款方案已估算包含费用、贴息和放弃现金优惠的综合年化，但未接入银行或厂商金融实时合同数据，也不替代金融机构依法披露的年化利率。
- 政策包可以导入带有效期和来源的 JSON，并可通过
npm run policy:validate做结构校验；地方政策仍需人工核验，不会自动联网抓取或判断车型目录资格。 - 报价报告已支持原生 PDF 下载；移动浏览器的下载位置、文件名和打开方式以浏览器自身策略为准。
- 报价链接把结果编码在 URL 中，可能较长；不要在其中填写身份证号、手机号或未脱敏合同内容。
- 本地证据不是电子签名、时间戳存证或法律意义上的合同保全；OCR 仅用于辅助录入，图片模糊、表格复杂或字段口径不一致时可能识别错误。
- 二维码受二维码容量限制，完整贷款现金流或项目较多的报价可能无法生成可扫描二维码，此时应使用压缩链接或 JSON 文件。
当前已支持首付比例或首付金额二选一、贷款本金、期数、名义利率、等额本息、等额本金、服务/GPS 等附加费、放弃的全款优惠、厂家贴息、综合年化、提前结清、月度计划、现金流和全款/贷款方案对比。页面综合年化用于同口径决策，正式贷款仍应核对合同披露年化、总还款额、贴息承担方、服务费和提前结清条款。
.
├── index.html # 主应用，所有 UI 和计算逻辑
├── src/
│ ├── quote-engine.js # 页面和测试共同使用的纯计算引擎
│ ├── quote-schema.js # 报价版本、迁移和分享数据脱敏
│ ├── share-codec.js # 压缩后的 URL 片段编码/解码
│ ├── local-evidence.js # IndexedDB 本地证据附件
│ ├── ocr-adapter.js # 按需加载 OCR 并解析候选字段
│ ├── pdf-report.js # 浏览器本地生成可检索 PDF
│ └── qr-adapter.js # 按需加载二维码生成器
├── vendor/ # 本地 OCR/二维码/ZIP/长图运行库与语言模型
├── package.json # 固定依赖、测试、截图和检查脚本
├── package-lock.json # 可复现依赖锁文件
├── playwright.config.js # Chromium/Firefox/WebKit E2E 矩阵
├── manifest.json # PWA 元信息
├── sw.js # Service Worker v10 完整离线资源缓存
├── icon-192.png # PWA 图标
├── icon-512.png # PWA 图标
├── data/
│ ├── policy.json # 全国通用估算政策参数与来源入口
│ ├── policy-template.json # 城市政策包字段模板
│ └── policy-packs/ # 已核验城市政策包目录（当前不放未核验真实金额）
├── scripts/
│ └── validate-policy-packs.js # 政策包结构、来源和有效期校验
├── tests/
│ ├── calculator.test.js # 直接测试真实计算引擎
│ ├── static-server.js # E2E 与截图使用的本地静态服务器
│ ├── capture-screenshots.js # 可复现 README 截图
│ └── e2e/app.spec.js # 五条浏览器端到端流程
├── .github/
│ ├── ISSUE_TEMPLATE/ # 中文 Issue 模板
│ └── workflows/ci.yml # GitHub Actions 自动测试
├── docs/
│ ├── user-guide.md # 面向新用户的详细中文使用说明书
│ ├── browser-and-device-matrix.md # 自动化矩阵与真机核验模板
│ ├── ocr-benchmark.md # 真实报价单 OCR 样本与指标说明
│ ├── policy-pack-guide.md # 城市政策包维护说明
│ └── screenshots/ # README 与说明书截图
├── THIRD_PARTY_NOTICES.md # 离线运行库的许可证与归属声明
├── LICENSE
└── README.md
- 扩展历史备份迁移、PDF 文本提取和更多边界输入测试。
- 继续完善 OCR 候选字段校验、异常提示和人工确认流程。
- 继续优化移动端排版、表单效率、键盘操作和错误提示。
- 继续增强屏幕阅读器语义、焦点顺序和高对比度模式。
项目代码使用 MIT License。仓库内置的 OCR、二维码、ZIP 和长图运行资源分别使用 Apache-2.0、MIT 或兼容双许可证，版本、用途和完整许可证路径见 THIRD_PARTY_NOTICES.md。
欢迎提交 Issue 和 Pull Request：
- 发现计算错误或页面问题，请附上复现步骤、输入数据和预期结果。
- 政策数据更新请尽量附官方公告链接，并说明适用时间、地区、车型范围。
- 新功能建议可以先在 Issue 中讨论输入字段、计算口径和展示方式，避免过早写死不稳定规则。
| 日期 | 上传或更新内容 | 备注 |
|---|---|---|
| 2026-07-12 | 完成 v1.8.1 和 v1.9.0 工程交付：新增 Chromium/Firefox/WebKit Playwright 自动化矩阵、原生可检索 PDF 生成器、PDF 下载 E2E、PDF 生成单元测试、政策包校验脚本、城市政策包目录、浏览器/真机核验文档、OCR 基准说明和政策包维护说明；将依赖外部真实设备、真实报价单样本和地方政策材料的事项从主动路线图中移出。 | npm run test:e2e:matrix 已通过 13/13；当前项目聚焦可独立验证的纯静态 Web 功能，不把无法独立取得的数据写成待完成开发任务。 |
| 2026-07-11 | 补充 v1.8.1-v1.10.0 后续时间表，明确 Firefox/WebKit、第一轮真机、真实 OCR 基准、原生可检索 PDF 和首批城市政策包的目标日期与完成标准。 | OCR 精度和政策数据按样本及官方来源持续维护，不承诺任意图片完全识别或一次性覆盖全国实时政策。 |
| 2026-07-11 | 完成 v1.8 离线与决策质量增强：本地化 OCR Worker/WASM/中英文模型、二维码、ZIP 和长图运行库，移除 Google Fonts/CDN 依赖；新增离线能力状态、贷款综合年化、放弃全款优惠机会成本、报价完整度评分、配置/保险/贷款可比性检查、一键复制报价、含 IndexedDB 证据的 ZIP 完整备份恢复、PNG 长图、浅色主题、键盘与无障碍基础能力；刷新关键截图。 | 单元测试和 5 条 Chromium E2E 全流程覆盖录入、计算、保存、复制、对比、JSON/ZIP 导入导出、证据附件、长图、PWA 断网重载、真实离线 OCR 和手机尺寸；综合年化是决策估算，不替代金融机构正式披露。 |
| 2026-07-11 | 新增面向首次使用者的详细中文使用说明书，补充在线版、本地 HTTP 与双击 HTML 的能力差异、看车前准备、逐字段录入、结果解读、报价对比、OCR、本地证据、备份恢复、常见问题和功能验证矩阵；扩展压缩分享与 OCR 解析测试。 | 核心计算和主要浏览器流程已实测通过；OCR、二维码、文件下载、本地附件、PWA 和跨浏览器兼容性按条件可用标注，不再笼统表述为所有功能在所有环境均已验证。 |
| 2026-07-10 | 完成 v1.7 功能强化：新增厂家金融贴息字段、客户实际金融成本、贷款现金流时间轴、报价数据版本迁移、压缩结果链接、本地报价单/合同证据留存、OCR 辅助录入和二维码分享入口；刷新贷款现金流截图并补充使用、隐私和限制说明。 | 贴息只按实际利息范围计入客户口径；证据文件留在浏览器 IndexedDB；OCR 结果必须人工确认；报价过大时二维码会提示改用压缩链接或 JSON 导出。 |
| 2026-07-10 | 完成 v1.6 功能强化：新增独立报价计算引擎、补贴确认分层、等额本金、贷款方案对比、提前结清估算、月度还款计划、3/5 年长期持有成本、逐项报价对比、无后端报价链接分享、政策包导入、政策有效期提示、Service Worker 更新提示、GitHub Actions 自动测试，并刷新贷款结果、逐项对比和手机端截图。 | 页面与 Node.js 测试共同使用 src/quote-engine.js；旧版报价 JSON 会自动迁移，地方政策仍需使用带官方来源和有效期的政策包人工核验。 |
| 2026-07-08 | 增加保险费用拆分、报价风险提示、费用构成图、多店成本对比图、HTML 报价报告导出，并将政策参数外部化到 data/policy.json；同步扩展基础测试和 README 截图。 |
本次增强把项目从单纯价格计算推进到购车决策辅助：保险和非保险费用分开核算，风险提示用于现场核对，报告可打印或另存为 PDF；政策配置保留内置兜底，兼容本地直接打开。 |
| 2026-06-28 | 刷新 README 界面截图，替换旧版录入、结果、多店对比和手机端截图，并新增贷款首付设置、计算过程公示、保存报价记录、报价记录详情和手机端结果截图。 | 截图与当前线上功能保持一致，更完整展示首付二选一、贷款真实总成本、导入导出、记录保存和移动端体验。 |
| 2026-06-28 | 完成贷款首付输入收尾优化，支持首付比例和首付金额二选一；统一页面字号层级，减少 10-11px 小字造成的空旷和不协调观感；同步 README 完成状态说明。 | 项目已经具备较完整的公开使用形态，后续继续围绕费用拆分、城市政策配置、金融方案细化和无障碍优化推进。 |
| 2026-06-28 | 补齐报价记录 JSON 导入/导出和 CSV 导出、贷款购车计算、结果摘要复制/分享、政策参数集中配置、基础自动化测试。 | 将此前路线图中最优先的五项转为可用功能；贷款按等额本息估算，政策参数仍需以官方公告和地方细则核验。 |
| 2026-06-28 | 修正应用页政策依据区域，避免写入未稳定核验的以旧换新文号；修复工信部官网链接，并补充国家税务总局入口；新增中文 Issue 模板。 | 公开页面中的政策说明保持谨慎口径，方便使用者按官方公告和当地细则核验；Issue 模板便于国内用户反馈计算问题、功能建议和政策更新。 |
| 2026-06-14 | 更新 README，补充 GitHub Pages 在线体验入口、项目徽章、参与贡献说明和公开更新记录；移除不适合放在线上仓库的内部审阅措辞。 | 在线体验由 main 分支根目录通过 GitHub Pages 发布。购置税、以旧换新、地方补贴等政策口径仍以官方公告和当地执行细则为准。 |
| 2026-06-14 | 梳理后续完善方向，包括报价记录导入/导出、结果分享、政策参数配置、贷款购车计算、保险费用估算、输入校验、主题切换和无障碍优化。 | 这些内容属于后续计划，不写成已完成功能，避免误导使用者。 |
| 2026-06-11 | 添加购车费用计算器 Web 应用、PWA 配置、Service Worker、应用图标、MIT License、README 和界面截图。 | 提供一个纯静态、无后端的购车落地价核算工具，支持购置税拆解、补贴估算、赠品估值和多店报价对比。 |
| 2026-06-11 | 更新应用文案中的政策提示和展示安全处理。 | 明确新能源购置税、以旧换新补贴、地方补贴需要以官方规则核验；对保存后的用户录入文本进行转义后再展示。 |
| 后续计划 | 继续围绕自动化测试、边界输入、移动端体验、无障碍、PDF 文本提取和 OCR 人工确认流程做小步维护。 | 保持纯静态、无账号、无云端业务数据的产品边界；不把外部真实设备、真实样本或政策数据作为默认开发前提。 |
本项目仅用于个人购车预算估算和报价对比。汽车交易、购置税、以旧换新补贴、地方补贴、保险和金融方案都可能受到政策、地区、车型、经销商合同和个人资质影响。请在付款、签合同、开发票、报废/置换旧车、申请补贴前，核对最新官方公告和当地执行细则。