Skip to content

dogxii/iGoods

Repository files navigation

✨ iGoods · 电子好物仓库

你的电子好物仓库 —— 手动记录 + AI Agent,让每一件好物都值得被记住。

在线体验 → · GitHub →


预览

主页

展开查看更多预览
主页(网格视图) 好物详情 + AI 卡片
主页 详情
消费画像 分享卡片
消费画像 分享

💡 理念

iGoods 是一个纯正向的好物知识库。只收录你认可的东西,用「值」「很值」「真香」「封神」四档评价拉开层次。你只需要写一句主观评价,AI 帮你扩写成一张完整的好物推荐卡片。

踩雷的东西?单独放进「踩雷本」,不和好物混在一起。


✨ 核心功能

📝 好物记录

  • 名称、品牌、价格、分类、购买日期
  • 「值 → 很值 → 真香 → 封神」四档主观评价
  • 使用频率标记
  • 优点标签(快捷 + 自定义)
  • 自定义场景标签
  • 照片上传(自动压缩为 WebP,存 localStorage)

🤖 AI Agent

  • 好物卡片生成:基于一句话评价,AI 扩写完整推荐(适用场景、适合人群、使用建议)
  • 消费画像:分析消费偏好,生成个性化洞察
  • 查重检测:识别与已有物品功能重复的新购计划
  • 流式输出:打字机效果实时显示 AI 生成过程
  • 本地 Fallback:未配置 API 时使用规则引擎生成基础卡片

支持 OpenAI 兼容格式的 API(OpenAI、DeepSeek、阿里云百炼、Groq、OpenRouter 等)。

⚠️ 踩雷本

独立区域记录不值得买的东西,不污染好物库。下次购物前翻翻这里,避免重蹈覆辙。

📊 消费画像

  • 好物总数 / 总花费 / 均价 / 封神数
  • 评价等级分布(动画柱状图)
  • 分类偏好排行
  • 价格区间分布
  • AI 消费洞察(个性化分析,带缓存避免重复请求)

🔍 筛选与搜索

  • 全文搜索(名称、品牌、标签、评价)
  • 分类筛选(多选 AND)
  • 评价等级筛选
  • 多维排序(时间、价格、评价)
  • 网格 / 列表视图切换(偏好持久化)

🖼️ 分享卡片

  • 一键生成精美好物推荐卡片(含 AI 内容)
  • 3× 高清分辨率,本地渲染不上传
  • 支持下载 PNG 或复制到剪贴板

📦 快速开始

# 安装依赖
bun install

# 启动开发服务器
bun dev

# 构建生产版本
bun run build

# 预览构建产物
bun run preview

🌐 部署到 Vercel

方式一:直接部署(推荐,无需配置环境变量)

用户在应用内自行配置 AI API Key,Key 只存在浏览器本地,不经过服务器。

  1. Fork 本仓库
  2. Vercel 导入该仓库
  3. 框架预设选 Vite,其余默认
  4. 点击 Deploy — 完成 ✅

方式二:开启内置 AI(需额外部署 Cloudflare Worker)

为访客提供每日免费 AI 额度,无需用户自备 API Key。

第一步:部署 Cloudflare Worker

详见 worker/README.md,部署完成后记录:

  • Worker URL(如 https://igoods-ai-proxy.xxx.workers.dev
  • 签名密钥(SIGNING_SECRET,部署时自己设置的 32 位随机字符串)

第二步:在 Vercel 配置环境变量

进入 Vercel 项目 → SettingsEnvironment Variables,添加:

变量名 说明
VITE_BUILTIN_AI_URL https://your-worker.workers.dev Worker 地址,末尾不带 /
VITE_BUILTIN_AI_SIGNING_SECRET your-32-char-secret 与 Worker 中设置的完全一致

⚠️ VITE_ 前缀的变量在构建时注入,添加后必须点击 Redeploy 才生效。

第三步:重新部署

Vercel 项目主页 → Deployments → 最新一次 → 右上角 Redeploy


🔐 隐私

  • 所有数据存储在浏览器 localStorage 中,无需注册登录
  • AI API Key 仅保存在本地,不会上传到任何服务器
  • 分享卡片在本地渲染生成,不上传图片
  • 无后端、无数据库、无埋点追踪

📄 License

MIT © dogxi

About

记录你的电子好物,手动记录 + AI Agent,让每一件好物都值得被记住。

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors