CardPulse v0.2.0

CardPulse v0.2.0

本次发布使用正式版本号，整合此前桌面预览版功能，并修复日期刷新与浏览器多标签数据覆盖问题。后续常规修复使用递增的正式版本号发布。

下载与升级

系统	安装包
macOS 13+ · Apple 芯片	CardPulse-0.2.0-mac-arm64.dmg
macOS 13+ · Intel	CardPulse-0.2.0-mac-x64.dmg
Windows 10 / 11 · x64	CardPulse-0.2.0-win-x64.exe

Mac 同时提供 ZIP，所有下载均提供 SHA256SUMS.txt 校验清单。

升级前导出 .cardpulse 加密备份并退出旧版，然后覆盖安装。新版沿用现有应用标识、数据目录、密码和加密库格式，无需重新导入；不要删除原应用数据目录。忘记密码无法恢复加密数据。应用暂不提供自动更新，后续可从 GitHub Releases 下载安装新版。

本次更新

• 日期自动刷新：按香港日期每 30 秒检查截止日，重新聚焦窗口或页面可见性变化时也会检查。Pulse、自定义活动和已展开的逐笔说明同步更新，跨日、半年及年度切换不再需要修改数据触发计算。
• 浏览器多标签冲突保护：保存、恢复和清空在同一个 IndexedDB 事务中检查密文是否变化，阻止旧页面覆盖新修改或写回已删除数据。冲突时保留当前页面修改，可先导出加密备份，再刷新或锁定后解锁最新数据；不自动合并。网页用户升级后需重新加载所有旧标签页。
• 保留此前的多银行标准 CSV、HSBC 原生 PDF、交易核对与结单删除、日期筛选、自定义现金回赠活动、Pulse 计算明细和逐笔说明。
• 默认离线、本机加密存储，继续支持简体／繁體中文、四种配色及跨网页／桌面的加密备份；三语言 README 同步更新。

验证与已知限制

• 70 项核心测试、11 项浏览器回归及生产构建通过。
• Mac 安装包检查架构、签名、DMG／ZIP 完整性、离线 PDF 资源及打包源码一致性；Apple 芯片原生运行，Intel 包通过 Rosetta 验证，非 Intel 硬件验收。打包应用完成导入、人工核对、汇率保存、加密备份恢复和重启持久化测试。
• Windows x64 包由 macOS 交叉构建并做静态校验，尚未经过原生 Windows 运行验收。
• Mac 仅使用 ad-hoc 签名，无 Apple Developer ID 签名或公证；Windows 无 Authenticode 发布者签名。正式版本号不改变这些签名与验证限制。
• 内置奖赏模型仍需人工核验银行最新条款与资格；退款不追溯原交易、不回补额度，自定义活动独立估算。暂不支持更多银行原生 PDF、阶梯／积分活动、自动更新、云同步或遥测。

English

CardPulse v0.2.0 is a regular release, bringing the desktop preview features together with Hong Kong date rollover updates and atomic browser vault conflict protection. Pulse, custom campaign totals, and open explanations now refresh as dates change. Stale browser tabs cannot overwrite, restore over, or clear newer vault data; unsaved edits remain available for encrypted backup export.

Export an encrypted backup, quit the previous app, then install over it. Application identity, local data paths, passwords, and encrypted formats are unchanged. Future routine fixes will use incrementing regular version numbers. Updates are downloaded manually from GitHub Releases.

70 core tests, 11 browser tests, and the production build pass. Apple silicon packages run natively; Intel builds are exercised through Rosetta. Windows builds are cross-compiled and statically checked, without native Windows runtime acceptance. Mac downloads use ad-hoc signing without Developer ID notarization; Windows downloads are unsigned. A SHA-256 manifest is included.

CardPulse v0.2.0-beta.3 — Reward Explanations & Desktop Update

CardPulse v0.2.0-beta.3

本版完善奖赏计算说明和按日期核对交易的流程，保持默认离线运行及本机加密保存。

下载与升级

系统	安装包
macOS 13+ · Apple 芯片	CardPulse-0.2.0-beta.3-mac-arm64.dmg
macOS 13+ · Intel	CardPulse-0.2.0-beta.3-mac-x64.dmg
Windows 10 / 11 · x64	CardPulse-0.2.0-beta.3-win-x64.exe

Mac 同时提供 ZIP。可用 SHA256SUMS.txt 核对下载文件的 SHA-256。

升级前建议导出 .cardpulse 加密备份，然后退出旧版再安装。新版沿用原有应用数据目录和加密库格式；不要手动删除保险库或系统应用数据目录。忘记密码无法恢复加密记录。

本次更新

• Pulse 计算明细：展示人民币／港币基础返现、年度额外奖赏、两半年额度及本年度退款扣回；逐笔说明适用范围、排除原因和待确认渠道。
• 自定义活动说明：展示净消费门槛、消费与奖赏封顶、剩余额度和实际退款扣回；说明计入或排除的首个原因，支持筛选及每页 25 笔分页。
• 日期筛选：按记账起止日期查阅与导出，包含起止当天；支持重置，日期倒置时提示并禁止导出。表格筛选不改变奖赏估算范围。
• 工作区维护：清空数据或成功恢复备份后清理活动草稿，失败／取消恢复保留当前草稿；删光尚未保存的导入交易后正确恢复空库状态。
• 备份与汇率：只有手动汇率的工作区也可导出加密备份；缺少汇率时，港币相关人民币折算明确显示待折算。
• 简体／繁體界面和简中、繁中、英文 README 同步更新。计算说明按需生成，不改变加密库结构。

本版补充现有模型的解释，不代表最新银行条款或登记资格已获核验。Pulse 当前模型先合并两个半年封顶后的奖赏，再按本年度匹配退款扣回；不追溯退款原单，不回补已使用额度。自定义活动仍独立估算，不自动叠加。封顶按周期汇总，不分配为单笔奖赏。

验证与已知限制

• 68 项核心测试、9 项浏览器回归、生产构建通过；另以 300 组混合数据对照原 Pulse 计算器，结果一致。
• Apple 芯片 Mac 打包应用通过启动、离线 PDF、Pulse 说明、人工修正、备份恢复、结单删除及重启持久化测试；Intel 包通过 Rosetta 验证，非 Intel 硬件验收。
• Windows x64 安装包由 macOS 交叉构建，检查可执行文件、离线资源与应用版本；尚未经过原生 Windows 运行验收。
• Mac 使用 ad-hoc 签名，未进行 Apple Developer ID 签名或公证；Windows 无 Authenticode 发布者签名。首次启动可能出现系统提示，请核对来源及校验和后按系统提示决定是否运行。
• 暂无自动更新、云同步或遥测。更多银行原生 PDF、阶梯／积分模型等支持边界以 README 为准。

English

This beta adds Pulse calculation breakdowns, shared paginated transaction explanations for Pulse and custom campaigns, posting-date filters, campaign draft cleanup, and rate-only encrypted backups. Missing FX conversions remain unknown. Existing calculation results and the encrypted workspace format are preserved.

68 core tests and 9 browser tests pass. A 300-dataset comparison matches the previous Pulse calculator exactly. Mac packages are tested on Apple silicon, with Intel builds exercised through Rosetta. Windows builds are cross-compiled and statically checked, without native Windows runtime acceptance testing. Mac downloads use ad-hoc signing without Developer ID notarization; Windows downloads are unsigned.

Export an encrypted backup and quit the old app before installing. Mac ZIP downloads and a SHA-256 manifest are included. No automatic updater is provided.

CardPulse v0.2.0-beta.2 — Transaction Review & Desktop Update

CardPulse v0.2.0-beta.2

macOS / Windows 本地桌面测试版。结单解析、奖赏估算和加密保存均在本机完成，无需账号或业务服务器。

下载与升级

系统	安装包
macOS 13+ · Apple 芯片	CardPulse-0.2.0-beta.2-mac-arm64.dmg
macOS 13+ · Intel	CardPulse-0.2.0-beta.2-mac-x64.dmg
Windows 10 / 11 · x64	CardPulse-0.2.0-beta.2-win-x64.exe

Mac 同时提供 ZIP。下载后可与 SHA256SUMS.txt 比对 SHA-256。

升级前建议在旧版导出 .cardpulse 加密备份，然后退出应用，再安装新版。新版继续使用原有应用数据目录；忘记密码无法恢复加密数据。不要手动删除保险库文件或应用数据目录。

本次更新

• 交易核对：修正分类与支付渠道，立即重新计算 Pulse 及自定义活动奖赏；保留修改前后记录，随加密库与备份保存。
• 结单删除：按导入关联删除指定结单及交易，保留其他结单、活动和汇率；删除后可重新导入。旧版导入记录仍可关联。
• CSV 导出：增加当前支付渠道，便于查阅修正结果。
• 恢复保护：检查数据版本、重复记录 ID、交易与结单嵌套字段、修改记录；损坏或不支持的数据在恢复前被拒绝。
• 同步简体、繁體中文界面及简中、繁中、英文 README。

交易修正和结单删除均需点击“保存到加密库”才持久保存。删除结单时，关联交易的人工修正记录也会删除；原始 PDF / CSV 文件不受影响。选择支付渠道不会自动确认活动登记资格。

验证与已知限制

• 63 项核心测试、3 项浏览器回归通过；Mac Apple 芯片安装包进行真实启动、加密 PDF、交易修正、备份恢复、结单删除及重启持久化验证。Intel 包通过 Apple 芯片机器上的 Rosetta 验证，并非 Intel 硬件验收。
• Windows 安装器由 macOS 交叉构建，检查 x64 可执行文件及离线资源；尚未进行原生 Windows 运行验收。
• Mac 使用 ad-hoc 签名，未进行 Apple Developer ID 签名或公证；Windows 没有 Authenticode 发布者签名。首次启动可能出现系统提示，请核对来源与校验和后按系统提示决定是否运行。
• 暂无自动更新、云同步或遥测。保留默认离线运行及手动汇率；仅主动更新参考汇率时联网。其他银行原生 PDF 及复杂奖赏模型仍以 README 支持范围为准。

English

This desktop beta adds transaction category/channel corrections with encrypted change history, immediate reward recalculation, selective statement deletion, payment channels in CSV exports, and stricter vault/backup validation. Changes persist after a manual vault save. Back up your encrypted vault and quit the previous app before upgrading.

Downloads cover macOS 13+ on Apple silicon and Intel, plus Windows 10/11 x64. Mac ZIP archives and a SHA-256 manifest are included. Mac packages use ad-hoc signing without Developer ID notarization; Windows packages are unsigned. Intel Mac tests use Rosetta. Windows builds are cross-compiled and statically checked, without native Windows runtime acceptance testing. No automatic updater is included.

CardPulse v0.2.0-beta.1 — macOS & Windows Desktop Preview

CardPulse 桌面预览版

首个 macOS / Windows 本地桌面版本。无需账号、Node.js 或业务服务器。结单解析、活动计算和 AES-256-GCM 加密存储均在本机完成。

下载

设备	安装包
Apple 芯片 Mac，macOS 13+	CardPulse-0.2.0-beta.1-mac-arm64.dmg
Intel Mac，macOS 13+	CardPulse-0.2.0-beta.1-mac-x64.dmg
Windows 10 / 11 x64	CardPulse-0.2.0-beta.1-win-x64.exe

Mac 另提供 ZIP。下载后可与 SHA256SUMS.txt 比对 SHA-256。

本版内容

• 独立 Electron 应用，界面支持简体／繁體中文和四套配色。
• 默认离线启动；手动填写汇率，只有主动点击联网更新才请求公开参考汇率。
• 桌面记录保存到本机加密文件；主密码不会保存或上传。
• .cardpulse 加密备份导出与恢复，可迁移网页版数据。
• 应用内加密 PDF 密码重试、本地 PDF Worker 与字体资源。
• 保留银行工作区、自定义活动、标准 CSV 导入及交易导出。

安装和已知限制

• 这是测试版。 52 项单元测试、2 项浏览器回归通过。Apple 芯片 Mac 安装包通过真实启动、加密 PDF、备份恢复及重启持久化测试；Intel Mac 包通过 Apple 芯片机器上的 Rosetta 实测，并非 Intel 硬件验收。
• Windows 安装器在 macOS 上交叉构建；x64 PE、图标、版本与离线资源已检查，尚未进行原生 Windows 运行验收。
• Mac 使用 ad-hoc 签名，未使用 Apple Developer ID 签名／公证；Windows 无 Authenticode 发布者签名。系统可能阻止首次启动。确认下载来源和校验和后，按系统提供的“仍要打开”或 SmartScreen 提示自行决定是否运行，不要关闭全局安全保护。
• 暂无云同步、遥测或自动更新。银行原生 PDF 适配、奖赏模型和自定义活动边界仍以 README 为准。
• 恢复备份会在确认后替换目标设备上的数据；忘记备份密码无法恢复，请先备份已有记录。

安装、数据目录和开发说明见仓库的简体、繁體及英文 README。

English

First offline-first CardPulse desktop beta for macOS 13+ (Apple silicon / Intel) and Windows 10/11 x64. No account or business backend is required. Includes local encrypted storage, portable encrypted backups, explicit opt-in reference-rate retrieval, Chinese locales, themes, bank workspaces, and custom cash-reward campaigns.

Mac downloads use ad-hoc signing without Developer ID notarization. Windows downloads have no Authenticode publisher signature. Verify the SHA-256 manifest and read the installation notes before running.

Apple silicon builds passed packaged-app tests; Intel builds were exercised through Rosetta. The Windows installer is cross-built and statically checked, not yet natively runtime-tested. This release is a preview, not a claim of full bank-format or reward-rule coverage.