维维记账支持

支持文本、语音、截图三种输入。调用云端 AI 前会先在本机完成多项预处理：自动识别"万/千/百"金额单位、繁简日期词、多条目分割、借贷场景拦截与收入方向词，并在本机完成可确定的账单分类匹配和财务分析报告生成；上述预处理与本地计算仅在本机完成，不会上传服务器，处理不了的请求才会发送给云端 AI。

截图识别中的 OCR（光学字符识别）完全在本机通过 Apple Vision 框架完成，原始图片不会上传服务器，仅识别后的文字会发送给云端 AI 进行字段解析；语音记账同样仅用于本机实时识别，不会上传或保存原始录音。

AI 对话历史（最近 100 条）通过 SwiftData + CloudKit 在同一 Apple 账户的设备间同步，本机同时保留加密文件缓存以加速离线访问。每次您主动发送消息、发起账单查询或分析时，最近对话内容及完成请求所需的账单上下文可能经自建服务器转发至 DeepSeek；账单上下文最多包含 100 条账单的日期、收支类型、分类、备注和金额。自建服务器仅作即时转发，不持久化保存输入文字、账单上下文或模型回复；DeepSeek 可能依据其 API 缓存与安全机制临时缓存请求内容，具体处理受其适用的隐私政策和服务规则约束。

首次向 DeepSeek 发送内容前，App 会展示独立说明并要求您明确点击同意；未同意时不会发送。可在「我的」-「隐私安全」-「第三方 AI 数据共享」随时撤回，撤回后 AI 请求与 AI 快捷指令会被阻止，但手动记账等核心功能不受影响。

免费用户每日可调用 AI 的次数由远程配置控制，以应用内实际显示为准；所有有效会员（月度、年度和终身会员）使用 AI 记账、识别、对话和账单分析均不限次数。免费次数按日重置，未使用次数不累积。

iCloud 同步是账单同步的唯一通道，自建服务器不存储账单明细。开启后，会在同一 Apple 账户的设备间同步以下内容：当前账单、预算设置、固定账单规则、自定义分类、AI 对话历史（最近 100 条）。

同步由 Apple iCloud 系统调度，可能存在短暂延迟，不承诺实时或秒级完成；首次开启 iCloud 后会先导入已有云端数据，导入未完成前禁止导出与写入，避免本地空状态抢先覆盖云端账本。

iCloud 同步不属于付费会员权益，访客和登录用户均可自行开启或关闭，仅在同一 Apple 账户且系统 iCloud 账户可用时生效。

请按以下顺序排查：

• 两台设备登录同一 Apple 账户，并在系统 iCloud 设置中允许本 App 使用 iCloud；
• 两台设备均已在「我的」-「iCloud 同步」开启同步开关；
• 首次开启同步时，应用会先导入已有云端数据再允许写入，导入未完成前主界面处于只读保护状态；
• 同步由 Apple 系统调度，可能存在短暂延迟，不承诺实时或秒级完成。

如仍未恢复，可在「我的」-「iCloud 同步」-「检查同步」手动触发检查点；若 CloudKit 容器准备失败或账户不可用，应用会自动回退到本机账本，本地记账功能不受影响。

登录后可在微信等 App 中通过系统分享把 CSV 账单发送到维维记账。文件格式兼容维维记账标准 CSV 与微信支付 CSV（自动识别表头列名，支持简繁中英文列名）。导入前会自动预览并与当前账本及文件内重复记录比对去重，确认导入时会再次比对防止预览期间新增账单造成重复，只有可导入记录才会写入。访客模式暂不支持 CSV 导入。

导出为会员功能。进入「我的」-「账单管理」-「导出账单」，可选择全部、按月、按年或自定义日期范围。导出文件为 UTF-8 BOM 编码的 CSV 格式，含日期、类型、金额、分类、备注五个字段并附带汇总区域（总支出、总收入、净收支、账单数量、时间范围），可通过系统分享保存到文件 App 或其他应用。导出文件保存在 App 临时目录，重新导出或离开页面时会被清理。

注：账单导入为免费功能（支持维维记账标准 CSV 和微信支付 CSV 格式）；首次开启 iCloud 后导入未完成时禁止导出，避免覆盖云端已有账本。

账单导入与同步采用四级去重决策，避免重复入账：

• sameStableIdentity：稳定身份（如 uuid）完全一致，自动合并；
• safeBusinessMatch：业务字段（金额、日期、分类、备注）与创建时间完全一致，自动合并；
• ambiguous：仅业务字段相同但创建时间不同，保留并计入待人工核对，不自动删除；
• distinct：判定为不同记录，正常写入。

不确定的同业务记录不会以金额/日期相似度强行删除，避免误删真实账单。

当购买入口开放时，月度/年度会员通过 Apple 自动续期订阅，终身会员为一次性购买；价格和周期以 App Store 购买页显示为准。更换设备或重装后，请先登录原购买使用的 Apple 账户和原绑定的维维记账账号，再进入会员页面点击「恢复购买」。如果入口暂未显示，说明购买功能当前未开放，但已有会员权益仍可正常查看。

同一笔 Apple 会员交易只能绑定一个维维记账账号。请确认当前设备使用原购买 Apple 账户，并登录购买时绑定的维维记账账号。切换维维记账账号不会自动转移会员，应用内也不提供自行解绑或转移；如无法登录原账号，请联系技术支持，并提供维维记账用户名、购买商品、预计购买时间和错误截图。请勿提供 Apple 账号密码、银行卡号或完整支付凭证。

Apple Sandbox 和 TestFlight 内购属于测试交易，不会实际扣取正式费用，也不能激活生产环境中的正式会员。正式会员请通过 App Store 正式版本完成购买；测试人员应使用单独的 Sandbox 测试环境。

TestFlight 版本会通过 AppTransaction.shared 验签自动选择沙盒服务端环境：数据库 cash_ai_sandbox 与 Keychain service 均与生产环境隔离，确保测试数据不会污染正式库；服务端响应会附带 X-Service-Environment 标识，客户端发现环境不一致时立即失败关闭。iCloud 账单数据通过 CloudKit 私有数据库容器 iCloud.cash.nbalaw.cn.sandbox 同步，Debug 连接该容器的 Development 环境，TestFlight 与 App Store 正式版连接其 Production 环境。

月度和年度会员由 Apple 管理自动续费。请至少在当前订阅期结束前 24 小时前往 Apple 账户的订阅管理中关闭自动续费；关闭后，当前已付费周期内的会员权益仍然有效。退款申请由 Apple 按 App Store 规则审核，维维记账不直接处理扣款或退款。

会员权益状态共 5 种，与 Apple 订阅状态一一对应：

• active：有效，正常享有权益；
• grace_period：宽限期，仍享权益（Apple 系统扣费失败但允许继续使用一段时间）；
• billing_retry：账单重试期，不享有权益，需更新付款方式；
• expired：已到期；
• revoked：已撤销（如退款）。

订阅的自动续费状态与权益状态分两个独立维度管理：关闭自动续费仅影响下一周期，不影响当前已付费周期内的有效权益；只有当前周期到期后，权益状态才会按 Apple 返回的状态更新为 expired 或其他值。

同一 Apple 账户下如存在多笔有效订阅（例如同时有月度和终身），系统会按终身 > 年度 > 月度的优先级合并展示，您只需关注当前生效的最高权益。各订阅的自动续费状态独立管理，不受合并展示影响。

支持。在绑定 Apple 账号或账号迁移场景下，可将原账号（数据来源）的账单、预算、固定账单规则、自定义分类和 AI 对话历史合并到目标账号。

合并为破坏性操作，不可撤销：合并完成后，原账号的服务器侧资料和当前设备上的本地数据将被清除；如已开启 iCloud 同步，删除变更会按 Apple 系统调度同步到 iCloud。

合并过程通过备份 staging + Keychain job secret 实现可恢复性，避免网络中断或 App 退出导致中途失败造成数据丢失；提交前失败可从备份回滚，已提交但清理中断可使用 Keychain 中的合并任务继续收尾。请在合并前确认已备份必要数据。

登录后进入「我的」-「隐私安全」-「注销账号」，按页面提示完成安全再认证。已绑定 Apple 登录的账号必须完成新的 Apple 授权，服务端会使用该授权码撤销 Sign in with Apple 令牌；未绑定 Apple 的密码账号验证当前密码。撤销失败时账号不会被删除。注销维维记账账号不会取消 Apple 自动续期订阅；如仍有有效会员，请先在 Apple 账户的订阅管理中关闭自动续费。已绑定该账号的 Apple 会员交易在注销后不能自动绑定到新账号，注销前如有疑问请先联系技术支持。

注销流程通过 CloudSyncDeletionCoordinator 与待注销恢复机制确保安全：先确认 iCloud 数据已成功导入本机再执行删除，避免云端数据与本机数据不一致；注销中途失败时，下次启动应用可恢复或取消该流程，不会产生半完成状态。

应用会在 iCloud 可用时提交删除变更；如需自行确认或清除，请在系统设置中的 iCloud 存储里删除"维维记账"数据。

进入「我的」-「隐私安全」开启应用解锁开关，可选择 Face ID / Touch ID 生物识别或自定义手势密码（4-9 点连接，至少 4 个点）。开启后冷启动或从后台回到前台都需要验证。

开启应用锁后，应用进入后台时立即覆盖隐私遮罩（在 App 切换器中也以遮罩显示），防止他人通过后台预览查看您的账单内容；手势密码使用 SHA-256 加盐摘要（salt + SHA-256）存储，仅用于本地比对，不记录明文路径，也不上传服务器。

账单数据仍仅存于本机或 iCloud 私有数据库；生物识别信息由 Apple 系统本地处理，本应用不获取面容或指纹数据。

账单明细仅存本机或 iCloud 私有数据库，自建云服务器不保存账单明细；账单同步的唯一通道是 Apple iCloud 私有数据库，在同一 Apple 账户设备间自动同步，且同步内容仅限账单、预算、固定账单规则、自定义分类和 AI 对话历史（最近 100 条）。

同时支持 Face ID / Touch ID 或手势密码应用解锁，进入后台立即覆盖隐私遮罩，防止他人未经授权查看；密码使用 Argon2id 哈希存储，API 请求通过 HTTPS 传输，登录令牌使用 Keychain 安全保存并按环境隔离（生产环境与沙盒环境使用不同的 Keychain service 和 storage 目录）。

支持四种预算类型，可在预算页面按月设置并查看使用进度：

• 总预算：月度总支出预算；
• 分类预算：按分类单独设置月度预算；
• 月度预算：仪表盘读取的月度整体预算；
• 独立年度预算：年度统计读取的独立预算，与月度预算分别保存、互不换算。

固定账单会按周期自动添加到对应日期，便于纳入预算统计。预算设置写入 SwiftData 并通过 iCloud 私有数据库同步，不上传自建服务器。

可在系统「快捷指令」App 中搜索或添加维维记账的相关指令，包括自动记账、截图识别账单、草稿确认/取消、字段编辑等。具体添加地址由远程配置控制，请以应用内「我的」-「快捷指令」入口的引导为准。

支持灵动岛与实时活动（Live Activity）展示截屏记账草稿状态，可在锁屏或灵动岛中查看草稿进度，无需进入应用即可确认或取消（需 iOS 16.1 及以上，且设备支持灵动岛时显示灵动岛样式）。

进入「我的」-「通用设置」-「货币」选择"跟随语言"或具体货币。支持人民币、美元、新台币、港元、日元、韩元、澳门元、欧元、英镑、澳元、加元、瑞士法郎、印度卢比、马来西亚林吉特、俄罗斯卢布、新加坡元、泰铢共 17 种货币。该设置仅影响本机展示，不会转换账单实际金额，也保存在本机不上传服务器。

记账等级根据您的累计记账天数展示，共 9 级（黑铁到王者），断账不重置。等级仅在本机展示，不上传服务器，也不影响功能使用。

这些权限仅在您主动使用截图识别、拍照识别或语音记账时调用。

我们通常会在 3 个工作日内查看并处理。管理员回复后，「我的」-「意见反馈」入口会出现红色数字徽章提示未查看条数；打开页面后徽章自动消失，多设备间同步清零。