1.8.0

中文

Asset Track 1.8.0 建议所有用户升级。这个版本合并了原计划 1.7.1 中的两个严重修复：特定规则下的循环冲突，以及应用规则后月账单无法保存的问题。1.7.1 不单独作为正式发布版本。

主要更新

• 代付现在支持创建和保存独立匹配规则，仍使用支出分类，适合 AA、聚餐和代付回款。
• 导入账单、应用规则、批量编辑和保存提示更清晰，被过滤条目可以在预览中检查。
• 数据库模式升级到 schema 11，旧 schema 9/10 会自动备份并迁移到最新版本。
• 商品总览、年度周期消费、导入字段确认和流水编辑布局更紧凑。
• README 和用户手册补充了 Obsidian 文件系统访问警告的边界说明：该能力只用于本地 SQLite、保护快照和备份恢复管理。

升级说明

• 升级前会自动在数据目录创建 backups/before-schema11-*.db 保护备份。
• 需要 Obsidian 1.13.0 或更高版本，建议先升级到当前最新 1.13.x 桌面版。
• Release 资产仍然只包含 main.js、manifest.json 和 styles.css。

English

Asset Track 1.8.0 is recommended for all users. It includes two serious fixes originally prepared for 1.7.1: rule-loop conflicts under specific rule setups, and monthly draft save failures after applying rules. Version 1.7.1 is not published separately.

Highlights

• Daifu transactions can now use their own matching rules while still using expense categories.
• Bill import, rule application, batch edits, and save feedback are clearer; filtered rows can be reviewed in the import preview.
• The database schema upgrades to schema 11; older schema 9/10 databases are backed up and migrated automatically.
• Product overview, annual recurring spending, import field mapping, and transaction editing layouts are more compact.
• The README and user guide clarify Obsidian's Direct Filesystem Access warning: it is used only for local SQLite, protection snapshots, and backup/restore management.

Upgrade notes

• A protective backups/before-schema11-*.db copy is created automatically before migration.
• Obsidian 1.13.0 or later is required. Update to the latest available 1.13.x desktop release before installing or updating.
• Release assets remain the standard three files: main.js, manifest.json, and styles.css.

1.7.0

Asset Track 1.7.0

中文

Asset Track 1.7 将月度账单结算扩展为统一的规则与流水操作流程。

• 规则支持仅商品、仅交易对手、交易对手 + 商品三种精确匹配范围，并加入固定优先级、字段重写、重复检测、冲突报告和重写链校验。
• 导入、应用规则、批量编辑、收入/代付转换、历史分类回写以及商品/交易对手统一，统一采用预览、确认、草稿、保存流程，并在保存时重新校验 revision 和前置值。
• 流水页增加出账、入账、理财 Tab，支持逐项、按商品汇总和按交易对手汇总视图；汇总流水可直接创建规则。
• 新增保护流水、批量修改交易对手/商品/分类、类型转换和本地操作审计；操作记录包含成功、跳过、失败及前后字段信息。
• 分类定义支持保存说明；数据健康直接展示商品-分类冲突处理表；商品总览支持历史筛选、商品/交易对手编辑、分类回写和直接创建规则。
• 加仓和提现支持绑定理财账户；月度分析按账户展示本金、本月加仓/提现、市值、流动资金、仓位、收益率和上月对比。
• 年度分析区分总资产与市场净资产，并优化近 12 个月趋势；表格统一列宽、居中控件、下拉框样式和规则最近月份展示。
• 可选 AI 分类使用 Obsidian SecretStorage 保存 API Key，只发送选中的可分类流水，保护流水默认不发送，支持按状态查看和重试，不自动创建永久规则。
• 分析、规则统计、数据健康和商品总览采用按需读取窗口与页面级缓存，减少大数据量下的重复查询。
• 数据库升级至 schema 10；打开 schema 9 数据库时会先创建保护备份，再执行可回滚的 9→10 迁移。
• 代付与支出的多对多关系暂不纳入本版本。

English

Asset Track 1.7 expands monthly bill settlement into a consistent rule and transaction-operation workflow.

• Rules now support exact item-only, counterparty-only, and counterparty-plus-item scopes with fixed priority, field rewrites, duplicate detection, conflict reporting, and rewrite-chain validation.
• Imports, rule application, bulk edits, income/daifu conversion, historical category backfills, and item/counterparty renames follow a preview, confirmation, draft, and save workflow with revision and before-value revalidation.
• The Transactions page adds Outgoing, Incoming, and Investment tabs, with individual, item-summary, and counterparty-summary views; summary groups can create rules directly.
• Added protected rows, bulk counterparty/item/category edits, type conversion, and local operation auditing with success, skipped, failed, and before/after details.
• Category definitions now persist descriptions. Data health opens item-category conflict results directly; Item overview supports history filters, item/counterparty editing, category backfills, and direct rule creation.
• Investment deposits and withdrawals can be assigned to an investment account. Monthly analysis shows each account's principal, current-month flows, market value, liquid funds, position, return, and previous-month comparison.
• Annual analysis distinguishes total assets from market net assets and improves the recent 12-month trend; tables now use consistent column widths, centered controls, differentiated selects, and latest-month rule reporting.
• Optional AI classification uses Obsidian SecretStorage for the API key, sends only selected classifiable rows, excludes protected rows by default, supports status-based retries, and never creates permanent rules automatically.
• Analysis, rule statistics, data health, and item overview now use bounded read windows and page-level caching to reduce repeated queries on larger datasets.
• The database upgrades to schema 10; opening a schema 9 database creates a protection backup before the rollback-safe 9-to-10 migration.
• The many-to-many relationship between daifu and expenses remains out of scope for this release.

1.6.0

Release v1.6.0

中文更新

• 重整主导航为“分析 / 记录 / 配置”，并将资产账户、流水、借款、固定资产拆分为独立页面。
• 各记录区块支持独立保存、放弃并重载；切换页面、月份或编辑范围时，会提示处理未保存修改。
• 数据健康直接展示商品-分类冲突处理表；商品总览支持筛选、搜索、创建规则、编辑商品和编辑分类。
• 匹配规则改为仅按收支类型和商品匹配；交易对方仍保留在流水和历史详情中，但不参与规则匹配。
• 年度分析补充年末总资产、净资产、现金、借款和当年出现过的固定资产；月度分析以总资产展示资产变化，年度与月度储蓄率及对账状态口径保持一致。
• 统一表格、输入框、下拉框和复选框的布局与样式，压缩页面顶部操作区，并在新增行后自动滚动到编辑位置。
• 补充重复规则、未来借款限制及数据健康、商品和分类编辑相关的中英文提示。

English updates

• Reorganized the primary navigation into Analysis, Records, and Configuration, with separate pages for Accounts, Transactions, Debts, and Fixed assets.
• Each record section now supports independent save or discard-and-reload actions, with unsaved-change confirmation when switching pages, months, or editing scopes.
• Data health now opens the item-category conflict table directly. Item overview supports filtering, search, rule creation, item editing, and category editing.
• Matching rules now use only transaction type and item. Counterparty remains available in transactions and history details, but does not participate in rule matching.
• Annual analysis now shows year-end total assets, net assets, cash, debt, and fixed assets recorded during the year. Monthly analysis uses total assets for asset changes, while annual and monthly savings and reconciliation wording remain aligned.
• Standardized the layout and styling of tables, inputs, selects, and checkboxes, compacted the page action area, and auto-scrolls to newly added rows for editing.
• Added user-facing mappings for duplicate-rule validation, future-debt restrictions, and data-health, item-editing, and category-editing messages.

Asset Track 1.5.0

Release v1.5.0

状态：月流水事实链路更新。要求 Obsidian 1.13.0 或更高版本；安装或更新前，
请先将 Obsidian 桌面版升级到当前最新的 1.13.x 版本。

发布声明

v1.5.0 把借款从独立顶层入口整合到月流水页，让借款新增、继承、还清和对账差额都在
同一个月度结算流程中完成。本版本不改变 SQLite schema、数据库路径、备份格式或既有
data.json 兼容字段。

用户可见更新

• 借款区块位于月流水页内：上月未还借款会自动出现在后续月份，用户在对应月份新增借款
  或勾选“本月还清”。
• 借款仍写入全局 debt_manager 事实表，不写入月度借款快照；历史月份不能覆盖未来月份
  已还清的借款事实。
• 月流水顶部对账差额会读取草稿中的借款变化，新增借款、修改当月借款金额或勾选本月还清
  后立即刷新，不再等保存后才反映借款影响。
• 代付、加仓和提现不使用分类；逐项表、商品汇总展开和特殊流水编辑区不再显示分类列、
  分类选择入口或“无需分类”占位。
• 按商品汇总移除“最近日期”列，重新调整收支、商品、次数、总金额、分类和操作列宽，
  并支持按收支和分类排序。
• 保存月份时同时提交月流水、资产、固定资产和月内借款草稿；若存在未来还清借款冲突，
  Repository 会以结构化错误拒绝写入。

Release notes (English)

Asset Track v1.5.0 moves debt handling into the monthly transaction workflow. It requires
Obsidian 1.13.0 or later; before installing or updating, upgrade the desktop application
to the latest available 1.13.x release.

• The monthly transaction page now includes a debt section. Unpaid debts carry forward
  automatically, and users add new debts or mark debts as paid in the relevant month.
• Debts still use the global debt_manager fact table instead of monthly debt snapshots.
  Historical months cannot overwrite a debt that has already been paid in a future month.
• The monthly editor's reconciliation difference now uses draft debt changes, so adding,
  repaying, or changing same-month debt amounts updates the difference immediately before save.
• Proxy payment, investment deposit, and investment withdrawal rows do not use categories.
  Their detail tables and item-summary details no longer show category columns, selectors, or
  “no category required” placeholders.
• Item summary removes the Latest date column, improves column proportions for item and
  category readability, and supports sorting by type and category.
• SQLite schema 9, database paths, backup formats, and compatible data.json fields remain
  unchanged.

Asset Track 1.4.1

Release v1.4.1

日期：2026-08-02

状态：性能与开发维护更新。要求 Obsidian 1.13.0 或更高版本；安装或更新前，
请先将 Obsidian 桌面版升级到当前最新的 1.13.x 版本。

发布声明

v1.4.1 主要用于性能优化和开发维护，不改变财务口径、SQLite schema、数据库路径、
备份格式或既有 data.json 兼容字段。

用户可见更新

• 优化规则匹配和历史规则分析查询，减少重复扫描，在较大数据量下提升商品总览和规则工作台的响应速度。
• 优化生产构建配置，减少 main.js 体积并改善插件加载效率。
• 保持现有分析、流水、规则和资产数据口径；本版本不新增财务事实或数据库迁移。

开发与维护更新

• 分析页按首页、商品、年度和月度职责拆分；编辑器表格、规则历史弹窗和规则创建/商品统一 Modal 分离。
• Repository 抽离通用行转换、校验错误和规则报告职责，保留事务 facade、revision 校验和单事务写入边界。
• 增加规则匹配索引和大数据量回归基准，继续覆盖 Obsidian 1.13 设置边界、Vault 枚举限制和标准三文件构建。

Release notes (English)

Asset Track v1.4.1 is primarily a performance and development-maintenance release. It
requires Obsidian 1.13.0 or later. Before installing or updating, upgrade the desktop
application to the latest available 1.13.x release.

• Optimized rule matching and historical rule-analysis queries to avoid repeated scans and
  improve Item overview and Rules workspace responsiveness on larger datasets.
• Improved the production build configuration to reduce main.js size and improve plugin
  loading efficiency.
• Financial definitions, SQLite schema, database paths, backup formats, and compatible
  data.json fields remain unchanged. No financial fact or database migration is introduced.
• Split analysis pages, editor tables, rule-history modals, and Repository helpers into clearer
  maintenance boundaries while preserving Service/Repository and transaction contracts.
• Added indexed rule-matching coverage and a large-data regression benchmark; the Obsidian 1.13
  settings boundary, Vault-enumeration guard, and standard three-file build remain covered.

兼容边界

• manifest.json 和 versions.json 的最低 Obsidian 版本为 1.13.0。
• SQLite schema 保持 9，不新增表、字段或迁移逻辑。
• 数据库路径、备份格式、账户、月份和既有 data.json 设置保持兼容。
• 正式 Release 只包含 main.js、manifest.json 和 styles.css，不包含 ZIP、sidecar、
  Python 或平台二进制。

验证记录

最终构建已在同一工作树执行：

npm run typecheck
npm run lint
npm test
npm run build
npm run release:check
bash scripts/smoke_test_plugin.sh build
git diff --check

构建目录必须且只能包含：

build/main.js
build/manifest.json
build/styles.css

自动化结果（2026-08-02）：

• npm run typecheck：通过；
• npm run lint：通过，0 error、0 warning；
• npm test：22 个测试文件、102 项测试全部通过；
• npm run build：通过，build/main.js 为 1,265,342 bytes；
• npm run release:check：通过，版本为 v1.4.1；
• bash scripts/smoke_test_plugin.sh build：通过，标准三文件与 node:sqlite 冒烟成功；
• npm audit --omit=dev：0 vulnerabilities；
• git diff --check：通过。

最终三文件 SHA-256：

• main.js: 215cdbed0f942cdcd176a55229621607ded15a992aa99ba4ff6e7f351c93b363；

• manifest.json: 518fe11438e654ac9a1af6b993165ad267507e82294624e298484eb859a94b40；

• styles.css: 478053ed8fdae14551b3f2515fd0558245bf8ebbb3e9c3a9d3dfcd4b71a01ef6。

• Release workflow：30740858754，
  Ubuntu 上的安装、typecheck、lint、测试、构建、发行校验、版本核对和三文件检查全部通过；

• GitHub Release：Asset Track 1.4.1，
  已发布中英文具体更新说明，并仅包含 main.js、manifest.json 和 styles.css；

• artifact attestation 已通过 GitHub API 按完整 SHA-256 核对，attestation subject 同时覆盖三项正式资产，
  来源为 refs/tags/1.4.1 的 .github/workflows/release.yml。本地 Sigstore verifier 因环境无法初始化
  可用 verifier，未作为最终判断依据。

Asset Track 1.4.0

Asset Track 1.4.0

中文： 本版本要求 Obsidian 1.13.0 或更高版本。安装或更新前，请先升级到最新可用的 Obsidian 1.13.x 桌面版。

English: This release requires Obsidian 1.13.0 or later. Before installing or updating, upgrade to the latest available Obsidian 1.13.x desktop release.

中文更新

1. 适配 Obsidian 1.13：设置页改用声明式 getSettingDefinitions，文件夹选择使用原生设置控件，移除已弃用的 display()；插件设置不再枚举整个 Vault 的文件。
2. 规则与冲突处理：分类定义聚焦历史流水数，压缩大额、颜色、流水数和操作列的占比；规则处理工作台聚焦冲突解决；规则页移除顶部 hash 和 SQLite 实现提示；统一表头、状态和按钮对齐方式。
3. 流水与月份编辑：优化创建月份与流水月份选择的位置和醒目按钮；新建月份内容为空时删除不再重复确认；流水编辑支持行号样式统一、排序和完整的操作列表头。
4. 分析与商品总览：新增并整理商品总览表，移除健康状态和所属规则列；统一商品总览与其他分析表的颜色、对齐、列宽和金额格式。
5. 统一响应式表格规范：规则、冲突、分类、流水、商品总览等表格统一采用固定资产表的响应式行为，优先使用容器宽度、允许内容换行，减少不必要的横向滚动和空白列。
6. 兼容性与数据安全：继续使用 schema 9、原有数据目录、data.json 设置字段和备份格式；发布包仅包含 main.js、manifest.json 和 styles.css 三个标准文件。

English updates

1. Obsidian 1.13 compatibility: Settings now use declarative getSettingDefinitions with Obsidian native folder controls. Deprecated display() overrides were removed, and plugin settings no longer enumerate every file in the Vault.
2. Rules and conflict handling: The category editor now focuses on historical transaction counts with more compact amount, color, transaction-count, and action columns. The rule workbench focuses on conflict resolution. Hash labels and SQLite implementation text were removed, and headers, statuses, and action controls now share one alignment style.
3. Transaction and month editing: Month creation and transaction-month selection were rearranged with a more prominent creation button. An empty newly created month can be deleted without a duplicate confirmation. Transaction editing now has consistent row-number styling, sorting, and complete operation headers.
4. Analysis and product overview: The product overview was reorganized and no longer includes the Health or Matching rule columns. Its colors, alignment, column widths, and amount formatting now match the other analysis tables.
5. Unified responsive tables: Rules, conflicts, categories, transactions, and product overview tables now follow the fixed-asset table responsive behavior: use the available container width, wrap content when needed, and avoid unnecessary horizontal scrolling or empty columns.
6. Compatibility and data safety: Schema 9, the existing data-directory layout, data.json settings fields, and backup formats remain unchanged. The release contains only the three standard assets: main.js, manifest.json, and styles.css.

Verification

• Cross-platform CI passed on Ubuntu, macOS, and Windows.
• The release workflow passed typecheck, lint, tests, build, release validation, tag/version checks, standard asset checks, and artifact attestations.

Asset Track 1.3.0

Release v1.3.0

更新

• CSV/XLSX/XLS 导入允许缺少日期列或保留空日期，并统一默认到所选月份 1 日；非空
  异常日期、空/非数字金额和未映射收支值仍会进入无效统计并阻止进入流水草稿。
• 空交易状态可显示为“（空状态）”，新映射默认允许导入空状态；状态过滤、忽略类型、
  跨月和无效行分别统计。
• 月流水对空商品、零金额和缺少分类的流水显示警告并允许先保存；无法解析的日期、金额
  和收支类型仍阻止保存。警告在重新打开月份时恢复显示。
• 规则页升级为规则工作台：健康摘要、商品/分类冲突、规则冲突、无规则商品、规则解释、
  商品变体统一和分类批量回溯形成闭环。后台匹配层级不暴露给用户。
• 规则审计状态与实际覆盖范围分开计算；某个交易对方已有规则时，其余交易对方的同名商品
  会显示为部分覆盖，并可只针对未覆盖流水创建建议规则。
• 商品统一和分类迁移都支持选择流水、预览旧分类/影响月份/revision，并在单个 SQLite
  事务中提交；商品统一可按收支、分类和商品搜索加载多个商品组，创建规则直接保存并刷新
  当前冲突面板，分类与规则保存分别报告结果。
• 关闭带有未保存内容的编辑视图时，取消放弃会在当前插件会话中重新打开并恢复月流水、
  借款、分类或规则草稿；外部 revision 变化仍会阻止旧草稿覆盖保存。
• 分类删除失败和确认均使用弹窗；普通表格和 Modal 表格统一表头、正文字号、上下居中、
  语义列宽和窄窗口自动换行，不可排序表头使用静态文本而不是禁用按钮。
• 年度分析的周期消费排序按钮统一增加间距和换行行为，避免按钮彼此粘连。
• 创建新月份的限制改为点击创建按钮后才显示具体提醒，不再常驻占位文字。
• 英文界面补齐导入、日期、金额、目录、数据库校验、规则和回溯错误文本；中文业务值与
  用户创建的账户、分类、商品、交易对方和说明仍按数据库原文保存，未映射中文系统错误
  不会直接泄漏到英文界面。

Asset Track 1.2.0

主要更新

• 新增基础货币、标准/会计金额格式、平账容差和大额支出阈值设置，所有界面金额统一使用 Intl.NumberFormat。
• 资产分析并列提供“资金投入资产”和“市场净资产”：前者继续用于稳定对账，后者使用理财市值与理财账户现金反映真实财富趋势。
• 年度分析新增只读周期消费面板，按商品汇总最近 12 个有数据月份中的周期分类支出，并支持按商品、累计金额和最近日期排序。
• 新流水日期默认当前编辑月份 1 日；收入和提现显示正向，支出、代付和加仓显示负向，数据库仍保存绝对金额。
• 月度草稿改用 reducer 动作维护 dirty 状态，增加 React Error Boundary，并移除账单导入的 Data URL/Base64 中间副本。

兼容性

• SQLite schema 保持 9。
• 数据库路径、备份格式和现有中文业务枚举不变，无需迁移用户数据库。
• total_assets 保留为资金投入资产兼容字段。
• 最低 Obsidian 版本仍为 1.9.10，继续仅支持桌面版。

验证

• TypeScript typecheck 和 ESLint 通过。
• 15 个测试文件、56 项测试全部通过。
• Ubuntu、macOS 和 Windows CI 全部通过。
• 生产构建、release:check 和 git diff --check 通过。
• 用户工程版测试通过。

Release 包含标准三文件：main.js、manifest.json、styles.css。

1.1.0

Full Changelog: 1.0.5...1.1.0

1.0.5

Full Changelog: 1.0.4...1.0.5