echo/README.md

Echo

Echo 是一个本地优先的个人记账 App，当前重点是自动记账、储值账户语义、AI 分类与本地账本分析。

当前文档入口

• 主说明：design/README.md
• 项目现状与阶段规划：design/echo-阶段总结与规划.md
• 设计/规划整理结论：design/设计整理-2026-03-12.md
• 版本与协作约定：design/版本与协作约定.md

常用命令

npm run dev
npm run build
npm run rules:sync
npm run rule:smoke
npm run version:sync
npm run release:patch
npm run release:minor
npm run release:major

版本管理

当前版本管理机制保留这套：

• package.json.version 是单一版本源。
• npm run version:sync 会同步 Android versionCode/versionName。
• npm run release:* 负责 bump 版本、同步 Android、提交 release commit 并打 tag。

建议按下面的方式使用：

• 日常开发不要直接在 main 上堆改动，开 feat/* 或 fix/* 分支。
• main 只保留已验证、准备发版的内容。
• release 必须在干净工作区执行。

当前仓库已经加了两条保护：

• 只能在 main 分支执行 release。
• 工作区有未提交改动时禁止 release。

目录说明

• src/：前端页面、状态、服务、SQLite 与 AI/通知逻辑。
• android/：Capacitor Android 工程和通知监听原生实现。
• scripts/：规则同步、版本同步、发布脚本。
• design/：当前说明文档、历史设计稿和整理索引。

说明

• 通知规则单一来源：src/config/notificationRules.js
• 修改通知规则后，需要执行一次 npm run rules:sync
• 当前 AI 第一阶段使用本地 DeepSeek Key，正式发布前仍建议切到后端代理模式