小白记账

小白记账是面向零会计基础个体工商户的本地优先 Windows AI 记账与申报协作软件。

当前版本为 0.9.0 本地内测版，包含：

• 产品章程、架构、设计系统和质量维护规范
• 可交互的经营首页、待确认、票据、流水、账簿和报税日历界面
• 整数金额领域模型与第一组自动化测试
• Tauri 桌面容器与 SQLite 本地账本
• UTF-8 CSV 流水导入、整批校验、文件去重和交易去重
• 经营/个人收支确认、追加式审计历史和幂等保存
• 个人收支自动排除在经营收入、经营支出与利润汇总之外
• 经营主体名称、主体类型和地区的本地建档、修改与重启恢复
• 建档字段的前后端双重校验，以及单一主体约束
• SQLite 在线备份、结构校验与 SHA-256 完整性校验
• 恢复前自动安全快照、损坏备份拒绝和失败回退
• SQLCipher 账本与备份加密，密钥由当前 Windows 用户的 DPAPI 保护
• 旧版明文账本与可用备份在首次启动时自动迁移为加密格式
• 手工记账、流水搜索与筛选，以及保留原始记录的追加式纠错
• 基于当前有效流水的确定性账簿汇总，自动排除个人收支
• Excel 可直接打开的 UTF-8 CSV 账簿导出与独立 SHA-256 校验文件

本地运行

npm install
npm run dev

质量检查

npm test
npm run build

Windows 发布构建需要 Rust 和 Visual C++ Build Tools。当前开发环境的 Build Tools 位于 C:\VSBuildTools2022，可运行 scripts\verify.ps1 做完整检查。

当前边界

首次启动时界面展示明确标记的演示数据。Windows 客户端可完成经营主体建档、手工记账、CSV 导入、确认与纠错、账簿导出、加密备份和恢复。票据识别、AI 与真实申报尚未接入，相应页面仅说明开放条件，产品不会计算或提交任何真实税务数据。

可使用 流水导入示例.csv 验收导入与重复导入，使用 待确认流水示例.csv 验收确认保存。

详细约定见 docs/。