让每一件物品的价值，都有迹可循。
Valora（中文名：值谱）是一款面向个人物品、数码产品和长期消费品的资产价值管理 App。它不是传统记账软件，而是把购买记录转化为日均成本、生命周期和价值洞察，帮助你从“我花了多少钱”进一步理解“这件东西到今天为止值不值”。
A clean personal asset tracker that turns purchases into daily cost, lifecycle, and value insights.
- 当前版本：
0.80 - 英文名：Valora
- 中文名：值谱
- Flutter 包名：
valora_assets - Android applicationId：
com.valora.assets - GitHub 仓库：https://github.com/QuentinCrane/Valora
- 当前重点：Android APK 构建与本地优先体验
- 数据策略：本地优先，云端同步为可选能力
开源前请确认你拥有本项目代码、图标、图片、模型、文案和第三方素材的公开授权。如果项目中存在个人数据、私有备份、签名证书或未授权资源，请先移除后再推送到 GitHub。
当前目录就是建议发布到 GitHub 的 App 仓库根目录。外层
archives/、宣传站、本地压缩包和构建产物不进入源码仓库。APK 请通过 GitHub Releases 作为附件发布。
Valora关注的不是“这笔钱花掉了”，而是这件物品在之后的每一天里是否继续产生价值。
它适合记录和复盘：
- 手机、平板、电脑、相机、耳机、手表等数码产品。
- 家电、家具、通勤装备、摄影器材等长期消费品。
- 软件订阅、课程、工具、配件等有持续使用周期的支出。
- 闲置、转卖、归档、换新前需要复盘价值的物品。
核心关键词：
物品资产管理、日均成本、生命周期、价值趋势、消费复盘、可视化分析。
不是记账，而是价值复盘
普通记账关心“我花了多少钱”，Valora关心“这笔钱到今天为止值不值”。一个 8000 元手机用了 4 年，日均成本可能已经很低；一个 500 元配件用了 3 天就闲置，反而可能更不划算。
日均成本视角
Valora会根据购买价格和使用天数计算日均成本。随着使用时间增加，用户能直观看到“用得越久越值”的过程。
日均成本 = 已消耗成本 / 持有天数
生命周期管理
每件物品不只是一条消费记录，而是一个有状态的资产：新购入、高频使用、稳定使用、闲置、转卖、报废、归档。它帮助用户判断一件东西是否还在发挥价值。
目标日均 / 值得线
用户可以设置目标，比如手机希望用到日均 5 元以下、相机至少使用 3 年、耳机用满 1000 天。App 会根据当前使用时间计算距离目标还有多久、是否已经达标、是否因为提前闲置而不划算。
个人资产图鉴
Valora不是一张冷冰冰的表格。它支持物品封面、主体抠图、贴纸描边和图标化展示，让资产管理更像一本清爽的个人资产图鉴。
完整资料包备份
Valora不只导出 JSON，也可以导出包含数据库、资产数据、报告、CSV、封面和贴纸媒体文件的完整 ZIP 资料包。迁移设备或恢复数据时，可以尽量保留物品记录和视觉封面之间的关系。
使用收益参与价值回收
一些资产的价值不只来自二手转卖，也来自它们帮助你创造的收益。Valora支持记录使用收益，并把收益分摊到参与资产上，让价值回收口径变成：
价值回收 = 二手卖出回收 + 使用收益
Valora 的液态玻璃视觉效果使用了第三方 Flutter 组件 liquid_glass_easy。该组件用于实现实时背景捕获、形状折射、动态镜片、模糊与 Optical Border 光学边界等能力。当前依赖版本为 2.0.1，许可为 MIT。
Valora 仅作为依赖使用该组件，并基于自身界面设计调整视觉参数。根据该组件的 MIT 许可要求，公开分发源码或 APK 时请保留仓库根目录的 THIRD_PARTY_NOTICES.md，其中包含 liquid_glass_easy 的版权声明、许可来源和完整 MIT 许可文本。
当前仓库已保留应用图标、产品定位、功能清单、页面结构、技术指南和构建说明，足够让访问者理解项目是做什么的、如何运行、如何参与。
正式公开前建议继续补充 3-5 张脱敏截图，优先展示：首页资产总览、资产详情生命周期、分析页趋势排行、封面/贴纸编辑，以及设置里的备份同步入口。
截图可以放在 docs/assets/screenshots/，并在 README 中引用。不要提交包含个人资产、账号、WebDAV 地址或其他隐私内容的真实截图。
- 首页仪表盘：总资产、日均成本、服役/退役/卖出状态、资产总览胶囊、高成本提醒、最近物品和紧凑卡片概览。
- 资产管理：记录名称、分类、标签、价格、购买日期、封面、状态、目标周期、备注、估算剩余价值、使用收益和归档状态。
- 添加与编辑：支持新增资产/心愿、编辑信息、删除或归档物品，并提供中文自然语言日期输入和 Android Material 风格日期选择。
- 资产详情：展示购买价格、购买日期、已使用天数、当前日均成本、目标日均、生命周期进度、价值变化和成本下降趋势。
- 分析页面：提供日均成本趋势、目标预测曲线、总投入趋势、分类占比、高成本排行、最划算物品、生命周期分布和价值复盘，并支持点击钻取到明细或资产详情。
- 封面制作系统：支持 AI 贴纸封面、裁切白框封面、手动勾勒贴纸、多候选结果、贴纸缩放定位、完整显示/铺满、边缘清理、手动橡皮、恢复笔和撤销修边。
- 快照管理：支持创建、查看、恢复、重命名和删除资产快照，便于回看资产状态变化。
- 分类与标签：提供分类图标池、颜色色板、智能推荐、自定义 Emoji、已有标签点选和新增标签自动加入当前表单。
- 设置体系：整合总览、数据、外观交互和系统入口，集中管理分类、标签、备份、云端、触感、提示条、原生能力和分享恢复。
- 应用内提示与触感：提示条避开底部按钮，支持主动关闭和横滑关闭；触感反馈、Android 原生震动和紧凑提示条可在设置中控制。
- 数据备份：支持 JSON、CSV、Markdown 报告、SQLite 副本、媒体清单和完整资料包 ZIP 的导出、分享与恢复。
- 可选云同步：支持 WebDAV、坚果云、Nextcloud 和自定义 WebDAV 地址。
- Android 小组件：提供资产总览、心愿清单、日均成本、资产体检、快速记录、到期提醒和资产快照。
Valora（值谱）
├── 首页
│ ├── 数据总览
│ ├── 日均成本
│ ├── 资产概览
│ ├── 高成本提醒
│ └── 最近物品
│
├── 资产
│ ├── 物品列表
│ ├── 分类筛选
│ ├── 搜索排序
│ ├── 物品详情
│ └── 归档 / 删除
│
├── 添加
│ ├── 名称
│ ├── 价格
│ ├── 日期
│ ├── 分类
│ ├── 图片
│ ├── 使用收益
│ └── 目标周期 / 值得线
│
├── 分析
│ ├── 日均成本趋势
│ ├── 目标预测曲线
│ ├── 分类占比
│ ├── 生命周期分析
│ ├── 高成本排行
│ ├── 价值象限
│ └── 价值复盘
│
├── 封面
│ ├── AI 贴纸
│ ├── 白框裁切
│ ├── 手动勾勒
│ └── 修边调整
│
├── 快照
│ ├── 快照列表
│ ├── 恢复快照
│ ├── 重命名
│ └── 删除
│
└── 设置
├── 总览
├── 数据
├── 外观交互
└── 系统
Valora的界面目标是清爽、现代、轻量、理性，并带一点高级感。
- 主色调倾向：
#7CC6F2+#FFFFFF - 风格参考：Apple 风格、浅蓝白色调、干净卡片、柔和阴影、圆角设计。
- 深色模式：不是纯黑，而是保留深蓝调和玻璃质感。
- 数据呈现：图表可点击、卡片紧凑、信息密度合理。
- 响应式体验：手机端保持双列资产卡片，小平板/宽屏扩展为 3 列，大平板可扩展到 4 列或 5 列。
- 系统交互：优先使用 Android 官方预测式返回机制和 Flutter 官方预测式返回转场，页面视觉效果尽量轻，不抢系统手势。
- 动效体验：页面转场、返回动画、数字刷新、底部导航、提示条和震动反馈都应轻量克制，并受设置项控制。
README 只保留产品和开源入口。更具体的技术栈、环境配置、构建命令、目录说明、权限解释和开源检查项请查看：
快速构建 Debug APK：
flutter clean
flutter pub get
dart format .
flutter analyze
flutter build apk --debug输出位置：
build/app/outputs/flutter-apk/app-debug.apk
首次推送 GitHub 前，建议检查：
- 不提交
android/local.properties、.env、key.properties、*.jks、*.keystore等本机路径或签名密钥。 - 不提交
build/、.dart_tool/、.gradle/、APK/AAB、临时日志和个人备份 ZIP。 - APK 安装包建议上传到 GitHub Releases，并命名为类似
Valora-v0.80-android.apk的公开文件名。 - Flutter App 建议提交
pubspec.lock，这样其他人能复现当前依赖解析结果。 - 保留或替换当前
LICENSE文件。本仓库默认采用 Apache License 2.0，并提供NOTICE项目归属说明。 - 保留
THIRD_PARTY_NOTICES.md，其中包含liquid_glass_easy的版权声明和完整 MIT 许可文本；Release notes 中继续声明该组件的使用与归属。 - 如果后续添加截图，先确认截图不包含个人资产、账号、WebDAV 地址或其他隐私信息。
- 如果使用 GitHub，建议启用
.github/workflows/flutter.yml中的格式化、静态分析和 Debug APK 构建检查。
欢迎通过 Issue 或 Pull Request 改进项目。更完整的流程见 CONTRIBUTING.md。提交 PR 前请尽量保证：
- 代码已格式化：
dart format . - 静态分析通过：
flutter analyze - 至少能构建 Debug APK：
flutter build apk --debug - 涉及数据迁移、备份恢复、原生桥接或权限变更时，在 PR 描述中写清测试方式和影响范围。
本项目使用 Apache License 2.0。项目归属和补充声明见 NOTICE。如果你正式发布前希望改成 MIT、GPL-3.0 或其他协议，请同步替换 LICENSE、NOTICE 和本段说明。