XplorOne

Release Notes

软件更新日志 v0.3.9

从软件发布历史中提取最新版本信息,并把关键开发脉络整理成中文官网摘要。

Current 0.3 Stage

当前阶段详细更新

0.3.x 仍属于当前开发阶段,因此从 v0.3.1 到最新版本,全部按完整分类说明展示。

Latest Release

v0.3.9拆分交易与 allocation 统计口径

已支持

2026-04-26

[更新摘要] 本次更新正式引入“拆分交易”能力。XplorOne 现在将账户真实流水保留在父交易上,把分类、成员、项目、税务和可报销等明细记录到独立的分配行中;分类统计、预算、排行和 AI 分类分析都可以基于 allocation effect 层计算,同时不会重复影响账户余额和资金流。

新增

  • -新增 transaction_allocations 数据模型,用于记录收入、支出和退款的分配明细。
  • -新增记一笔「拆分」模式、流水页 split.svg 拆分入口,以及展开查看 allocation 子行的能力。
  • -新增交易分配完整性检查与 CSV 拆分明细导出,同时保留父交易导出的银行流水视角。

变更

  • -分类统计、预算实际数、项目/成员/税务/可报销统计、Top N 和 AI 分类分析改为基于 allocation effect 层计算。
  • -收入、支出和退款写入时同步创建或更新 allocation;转账、借款、还款和余额调整继续保持父交易口径。
  • -备份、恢复、.xpl 和旧数据导入现在会保留或自动补齐 allocation,并在导入/恢复后执行完整性检查。

优化

  • -优化流水页拆分体验,新增分类列展开按钮和与原表格对齐的小号 allocation 子行。
  • -优化记一笔、记多笔和拆分页的下拉菜单、日期时间选择、占位文字字重与双语文案。
  • -优化 AI 录入草稿与国际化提示,使其更好衔接拆分交易创建链路。

修复

  • -修复从流水页打开拆分编辑器时表格溢出弹窗的问题。
  • -修复拆分页空值显示、账户占位和原生控件体验不一致的问题。
  • -修复部分分类统计、报表和导出仍可能依赖父交易 legacy 分类字段的问题。

安全与稳定

  • -阻止未平衡拆分草稿落入正式交易表。
  • -加强 service 层校验,覆盖 allocation 合计、同账本引用、分类类型匹配和退款方向。
  • -账户余额、对账、导入去重和资金流计算继续只读父交易,避免拆分 allocation 重复计入账户流水。

Release Notes

v0.3.8英文桌面体验、已有账本保护与设置页打磨

2026-04-24

[更新摘要] 收口英文桌面体验、已有账本数据保护和设置页体验,新增全局金额符号设置、模型预设持久化和基础英文记账解析。

新增

  • -新增全局金额符号设置,支持 ¥、$、€。
  • -新增模型预设持久化能力,保存模型配置时会记录所选预设 code。
  • -新增基础英文记账解析,支持常见收入、支出、转账、借款、还款、退款、账户、相对日期和 AM/PM 时间表达。

变更

  • -英文界面将 Ledger 相关入口统一调整为 Transactions,覆盖导航、页面标题、操作按钮、确认提示和导出文案。
  • -调整设置页侧边栏顺序,将日常偏好放在账本、模型、授权、数据和归档入口之前。
  • -提醒设置的时间选择从原生时间输入框改为小时/分钟选择器,避免系统本地化造成中英文混排。

优化

  • -优化已有账本数据的显示层语言映射,覆盖账户、分类、项目、模板和 icon/emoji 展示。
  • -优化账户、收支分类、首页、报表、设置和个性化页面的间距、表格对齐与 tooltip 文案。
  • -优化桌面菜单、关于弹窗和检查更新弹窗,补齐中英文文案,并展示当前版本层级和试用信息。

修复

  • -修复切换界面语言后账户名、分类名、项目名可能中英文混用的问题。
  • -修复语言切换后收支分类页和预算页可能出现重复或错误一级分类的问题。
  • -修复设置页滚动方向异常,确保左侧侧边栏固定、右侧子页面滚动。

安全与稳定

  • -降低升级期间误改已有账本数据的风险,默认数据 seed 只在空数据或明确旧默认数据场景下执行。
  • -优化已有账本的语言切换方式,通过展示层本地化而不是向账本写入翻译后的重复数据。
  • -强化模型配置存储,保存接口配置时同步保留预设元数据,提升模型设置恢复和启用流程的可靠性。

Release Notes

v0.3.7双语 AI 对话与英文查询体验

2026-04-24

[更新摘要] 重点优化 AI 对话系统的中英文体验。XplorOne 可以根据用户本次输入语言生成中文或英文回答,并提升英文查询、本地解析和连续追问体验。

新增

  • -新增对话系统语言上下文判断能力,可根据本次输入、同会话上一条明确语言和界面语言兜底决定回答语言。
  • -新增基础英文查询本地解析能力,支持 this month total income、how much did I spend this month、account balance 等常见问题。
  • -新增同一查询会话内的时间追问能力,例如 and last month?、那上个月呢?会复用上一条查询并切换时间范围。

变更

  • -AI 对话回答语言不再被界面语言强制决定,优先跟随用户本次输入语言。
  • -查询、分析、自由对话与录入草稿的新生成文案开始按响应语言输出。
  • -前端会随聊天请求传入当前界面语言,并根据后端返回的 response_language 渲染按钮语言。

优化

  • -优化查询回答、补问、表格标题、表格列名、金额与周期标签的双语展示。
  • -优化分析与自由对话的系统提示词,使英文问题更自然地得到英文回答。
  • -优化录入草稿的标题、字段名、缺失字段提示、确认、取消与提交结果的双语体验。

修复

  • -修复英文界面下输入中文问题时,回答可能仍按英文输出的问题。
  • -修复只追问时间范围时,系统无法复用上一条查询上下文的问题。

已知问题

  • -英文自然语言记账解析尚未纳入本轮更新,例如 spent 20 on lunch from cash 会在后续版本单独实现。

Release Notes

v0.3.6预算页加载与首页预算缓存共享

2026-04-23

[更新摘要] 重点优化预算页加载链路和首页预算缓存共享,减少重复请求和切页时的假卡顿。

变更

  • -预算页主加载从旧的聚合接口收口为 list_budget_months 与 get_budget_month 两条轻量链路。
  • -首页与预算页开始共享 renderer 预算缓存。

优化

  • -优化预算页请求去重、离页取消和加载触发条件。
  • -优化从首页进入预算页时的体验,已命中的预算数据会优先复用。

修复

  • -修复预算页可能反复补发同月请求的问题。
  • -清理临时预算耗时日志,恢复开发态 StrictMode。

Release Notes

v0.3.5预算稳定性与本地预览错误反馈

2026-04-23

[更新摘要] 重点收口预算页数据加载、全年预算保存和本地预览错误文案。

变更

  • -预算页切换为更集中的预算加载主链,月份列表和当前月份详情可一次返回。
  • -保存为全年预算语义调整为真正覆盖当年 1 至 12 月。
  • -侧边栏中文命名继续产品化调整,报表改为图表,沟通改为对话。

优化

  • -优化预算页缓存、月份摘要同步、表内 loading 和乐观更新体验。
  • -优化预算余额显示、年份胶囊、筛选触发器和底部合计对齐。
  • -优化本地预览 runtime 错误文案,中英文 fallback 更统一。

修复

  • -修复切换月份后左侧摘要和右侧表格状态不一致的问题。
  • -修复预算页部分预览超时与错误提示链路不清晰的问题。

Release Notes

v0.3.4现金流报表与图表缩放

2026-04-23

[更新摘要] 新增现金流进出报表,并统一多张镜像趋势图的坐标缩放口径。

新增

  • -新增「现金流进出」报表页,统计口径与流水页资金流保持一致。

变更

  • -收入与支出、现金流进出的月度趋势图统一共享同一纵轴上限。
  • -流水页侧边栏筛选触发器统一为 时间范围 / Time Range 风格。

优化

  • -优化收支页、账户页与现金流页的资源、图标、边距和趋势图区结构。
  • -优化现金流报表的中英文标题、侧边栏入口顺序和图标资源。

修复

  • -修复上下镜像柱图因独立缩放导致视觉比例误导的问题。

Release Notes

v0.3.3类型检查清零与管理页体验

2026-04-22

[更新摘要] 重点清零前端类型检查历史问题,并继续完善成员、项目与管理页体验。

新增

  • -新增成员管理页的完整新增链路。
  • -新增多个共享 normalize reader,统一整理前端读取的执行结果。

变更

  • -多个页面不再直接把 result.data 硬断言为业务类型,改为先走 shared normalize。
  • -成员页、项目页、账户页和收支页开始统一使用同一套 SVG 操作按钮。

优化

  • -优化成员管理页与项目管理页的缓存体验,切回页面时优先显示旧数据并后台刷新。
  • -优化分组表格圆角、补色、状态胶囊和操作列视觉。
  • -优化流水页、收支页、账户页与日历页的标题高度、边框、圆角和范围胶囊。

修复

  • -修复 renderer 历史 typecheck 错误,npm run typecheck 恢复为可用门槛。
  • -修复多个页面读取返回对象时类型不稳的问题。

Release Notes

v0.3.2流水页资金流口径与收支统计拆分

2026-04-22

[更新摘要] 重点拆分流水页资金流口径和收支页收入支出口径,同时继续补齐提醒中心与英文显示细节。

变更

  • -流水页主汇总与时间 bucket 改为资金流口径:净流量 / 流入 / 流出。
  • -英文同步调整为 Net Flow / Cash Inflow / Cash Outflow。
  • -单账户视角下,相关转账会按流入或流出计入统计;全局视角仍不计普通转账。

优化

  • -优化流水页顶部资金流说明,减少和收支报表口径混淆。
  • -优化收支页、账户页跳转流水页时的筛选联动。
  • -优化提醒中心英文模式下的标题、正文、预算阈值与备份提醒文案。
  • -优化英文界面下的日期显示与范围胶囊表达。

修复

  • -修复流水页和收支页统计口径混用导致的理解偏差。

Release Notes

v0.3.1设置页与报表页英文模式补齐

2026-04-21

[更新摘要] 重点补齐设置页和报表页英文模式残留,并修复一处报表国际化运行时错误。

变更

  • -设置页多个面板的标题、弹窗、状态提示与 Web 预览 fallback 文案继续收口为中英文。
  • -报表分组下的基础报表页面继续接入词典层。

优化

  • -优化英文界面下文件选择、路径打开、恢复与导入确认体验。
  • -优化 Reports 子导航的英文长标签显示。
  • -更新 XplorOne Codex 技能文档,使只读查询边界更清晰。

修复

  • -修复报表页内部子组件漏传 t 导致 t is not defined、页面白屏的问题。

History Highlights

历史开发信息搬迁

第一次搬迁时,除了最新版本,也把 CHANGELOG 中的 0.3、0.2 与早期开发脉络整理到官网。

0.3 系列:产品化发布线

0.3 系列围绕拆分交易、allocation 统计、英文体验、双语 AI、预算稳定、现金流报表和商业授权基础持续推进。

  • 新增拆分交易、allocation effect 查询与分类/预算/项目/成员/税务/可报销统计口径。
  • 强化首页、日历、流水、预算、报表、设置与管理页的国际化和稳定性。
  • 补齐商业授权基础、英文查询解析、英文记账解析和连续追问体验。

0.2 系列:本地优先与发布基础

0.2 系列把 XplorOne 从早期桌面财务工作台推进到更清晰的发布线,重点是 MCP、归档、预算并库、打包和隐私边界。

  • 新增 XplorOne Read-Only MCP v1 基线、Codex / WorkBuddy client token 管理基础。
  • 新增 .xpl 单文件归档导出与导入,并将独立预算库并入主库。
  • 新增 Windows portable / NSIS 发布基础、隐私验包脚本和 Electron safeStorage token 加密。

早期开发版本 v0.0.5 - v0.1.9

早期版本记录了 XplorOne 从单页原型逐步演进为多模块本地财务工作台的过程。

  • 建立账户、分类、成员、项目、流水、首页概览、基础报表和多账本能力。
  • 搭建 AI 查询、AI 录入、AI 分析、自由对话以及预算管理的早期链路。
  • 持续重排导航、工具栏、图表、表格、仓储层、service 层和共享契约。