Moment Collector（拾光）

基于 HarmonyOS NEXT 的影像记录与感官策展应用原型。项目围绕“拍摄、识别、归档、分享”构建完整链路，把一次普通拍照转成带有主题、气味、色彩和描述信息的可检索记忆条目。

本仓库已按公开项目方式整理：

• 已移除硬编码 API Key、JWT 密钥、本机 IP、签名口令等敏感配置
• 已将 AI 与后端配置改为本地占位，需要开发者自行补充
• 已补充建议的忽略规则，避免本地缓存、数据库和签名文件再次提交
• 已补充 LICENSE 与 .env.example 模板，便于公开分发和二次开发

功能概览

• AI 图像解读：根据图片生成标题、描述、冷知识、气味分类与氛围文本
• 图鉴式收藏：按分类、颜色、气味等维度管理记录内容
• 每日挑战与徽章：通过任务和成长体系增强持续使用体验
• 社区与交换：支持基础社交流、点赞评论与“记忆胶囊”概念扩展
• 本地与远程双模式：默认可在 Mock 模式下运行，也可切换到本地后端

技术栈

• HarmonyOS NEXT
• ArkTS / ETS
• Node.js + Express
• SQLite

项目结构

.
├── AppScope/                    # 应用级配置与资源
├── entry/                       # 主模块
│   ├── src/main/ets/            # ArkTS 页面、服务、模型与公共模块
│   └── src/main/backend/        # 本地 Node.js 后端示例
├── build-profile.json5          # HarmonyOS 构建配置（已替换为安全占位）
└── README.md

快速开始

1. 前置环境

• DevEco Studio（支持 HarmonyOS NEXT / API 21）
• Node.js 18+

2. 配置后端

后端示例位于 entry/src/main/backend。

cd entry/src/main/backend
npm install
cp .env.example .env

启动服务：

JWT_SECRET=replace-with-a-random-secret npm start

默认服务地址为 http://127.0.0.1:3000/api/v1。

3. 配置 AI 能力

项目默认不附带任何第三方 AI 凭据。若要启用远程 AI：

1. 参考仓库根目录 .env.example 准备本地配置
2. 将 AI_API_URL 映射到 entry/src/main/ets/common/Constants.ets 中的 API_CONFIG.URL
3. 将 AI_API_AUTHORIZATION 映射到 entry/src/main/ets/common/Constants.ets 中的 API_CONFIG.KEY
4. 将 CLOUD_API_URL 映射到 entry/src/main/ets/common/config/AppConfig.ets 中的 CLOUD_API_URL
5. 未配置时，应用会走降级逻辑或提示未配置

环境变量模板

仓库提供了两个模板：

• 根目录 .env.example：公开仓库配置说明模板，便于整理本地变量
• entry/src/main/backend/.env.example：后端 Node.js 服务实际使用的模板

当前前端并不会自动读取 .env 文件，相关值需要按上面的映射手动写入本地配置文件，提交前再确认不要把真实凭据带回仓库。

公开仓库说明

• build-profile.json5 中的签名材料路径与口令已替换为占位值
• 数据库、签名证书、构建产物、IDE 配置和缓存文件应保持本地，不应提交
• 如果你准备二次开发，建议将运行时密钥统一迁移到环境变量或本地配置文件

当前状态

该项目更适合作为比赛作品、课程展示或 HarmonyOS NEXT 原型工程参考。部分能力带有演示性质，生产环境落地前仍需补充：

• 完整的密钥管理
• 更严格的用户认证与密码加密
• 后端接口鉴权与错误处理强化
• 数据迁移、测试和部署方案

许可证

本仓库当前使用 MIT 许可证，见 LICENSE。