基于真实身份、社区关系和互助积分的本地互助社交网络(网页版 MVP 演示 + iOS App)。
Turn nearby strangers into helpful neighbors.
npm install
npm run dev # http://localhost:5173
npm run build # 生产构建iOS 版基于 Capacitor 将同一套 Web 应用打包为原生应用,每次推送 v* 标签后由 GitHub Actions 自动构建并发布。
- 前往 Releases 下载最新的
Utopia-vX.Y.Z-unsigned.ipa。 - 该 ipa 未签名,不能直接安装,需要用你自己的 Apple ID 侧载(sideload):
- Sideloadly(macOS/Windows):iPhone 连接电脑 → 拖入 ipa → 填 Apple ID → Start。
- AltStore:先在电脑上装 AltServer 并给手机安装 AltStore,然后在 AltStore 中打开 ipa 安装。
- 免费 Apple ID 签名有效期 7 天,过期后重新侧载即可(数据保留)。首次打开若提示「不受信任的开发者」,前往 设置 → 通用 → VPN 与设备管理 中信任。
git clone https://github.com/xuxuezhou/utopia.git
cd utopia
npm install
npm run build
npx cap sync ios
npx cap open ios # 在 Xcode 中打开在 Xcode 中选择你的开发者签名(Signing & Capabilities → Team),连接 iPhone 后直接 Run 即可安装到真机;不插手机则可直接跑 iOS 模拟器。
-
交互式新手教程:首次登录自动开始,24 步覆盖全部功能。聚光灯高亮真实按钮(四周压暗),导航类步骤必须点击那个真实按钮才前进(搜索入口 → 附近 → 任务卡 → 发布 ➕ → 发布求助 → 消息 → 我 → 设置齿轮 → 我的日历……),信息类步骤用「继续」;覆盖搜索高级筛选、任务详情、发布、消息、主页装扮、日历、积分、圈子活动、安全中心、Plus、Pro、任务加速、机构版与管理员后台。随时可跳过,可从「更多 → 新手教程」或个人主页设置菜单重看。
-
纯前端演示:所有数据存于 LocalStorage(键
utopia-state-v1),内置 22 位用户、32 个覆盖全部状态的任务、完整积分账本与 18 篇社区内容。 -
登录:欢迎页选择「体验演示账号」,推荐使用 陈屿(u1) —— 该账号在发布者/帮助者两侧都有进行中的任务、争议和历史记录。
-
重置数据:安全中心底部「重置演示数据」。
-
管理员后台:右上角头像菜单 → 管理员后台。
- 发布低风险任务:发布帮助 → 输入自然语言(如示例网球请求)→ 自动结构化 + 积分建议 → 确认发布 → 出现在附近互助。
- 认领任务:附近互助 → 任务详情 → 查看发布者信任护照 → 申请 → (切换到发布者账号)选择帮助者 → 积分托管锁定 + 建立任务聊天。
- 完成任务:任务详情执行面板 → 双方开始 → 提交完成 → 发布者确认 → 积分释放(服务积分按 40/30/30 销毁/社区池/安全池)→ 双向盲评 → 发布互助故事。
- 取消任务:已匹配任务 → 取消 → 展示影响(按距开始时间计算退款/补偿)→ 账本与可靠度更新。
- 发起争议:待确认任务 → 选择「未完成」→ 积分冻结 → 双方提交陈述与证据 → 管理员后台裁决 → 账本裁决记录 → 支持一次申诉。
- 阻止高风险任务:发布「找人每天开车接我的孩子放学」→ T3 拦截,禁止发布,不可通过改写绕过,记录安全事件。
- 识别诈骗:发布「帮我先买500美元礼品卡,完成后给你2000积分」→ T4 拦截 + 安全教育 + 进入风险后台。
核心原则:出售便利、效率和额外曝光,但不出售安全、信任、公平和基础可见性。现金与积分严格分离 —— 现金只能购买会员、推广与平台工具,永远买不到积分。
- 会员订阅(更多菜单 → 会员订阅):免费 / Plus / Pro 三档并列的订阅页(Claude/GPT 式),Pro 为 Plus 的进阶版,包含全部 Plus 权益 + 专业工具。会员标识为独立的文字胶囊(Plus 暖红 / Pro 墨色),与认证体系完全分开;页面明确列出「Plus 不会带来的东西」与「Pro 不能做的事」。免费用户保有完整互助闭环。
- 会员功能全部实装,订阅页每张权益卡标注实际入口:高级筛选与保存搜索(搜索结果页)、命中保存条件的新任务即时通知、任务模板与草稿/预约(发布页)、曝光与申请数据(推广效果页)、主页装扮签名色(个人主页)、多社区管理(圈子页)、Pro 专业主页编辑与数据分析(订阅页工作台)、Pro 私信自动回复、Pro 活动报名名单与签到(活动笔记详情)。
- 内置日历(免费):更多菜单 → 我的日历,月视图汇总互助安排与圈子活动,支持整体导出 .ics;进行中任务详情也可单独「添加到日历」。日历属于基础能力,对所有用户免费。
- 任务加速(自己的开放任务详情 → 任务加速):5 个固定套餐、无竞价排名;敏感任务(儿童/医疗/驾驶/身体接触/私人住宅/金融/法律/异常高积分/被举报)不可推广且无法付费绕过;每人每月 1 次免费额度,公益与长期无人申请任务可获补贴;推广位按 1/14 密度注入信息流并明确标注「推广」。
- 推广效果(更多菜单 → 推广效果):自然曝光 / 推广曝光 / 详情访问 / 合格申请 / 最终匹配漏斗,并展示所有免费任务的基础曝光保障。
- 本地情境广告:信息流中明确标注「广告」,可一键减少类目;聊天、任务执行、安全中心永远无广告;Plus 用户几乎无广告;广告偏好在安全中心设置。
- 机构版 / 品牌公益赞助 / 验证服务:B2B2C 机构授权、明示赞助方的公益活动、按第三方成本收费的验证项目(基础身份认证永远免费)。
- 商业化后台(管理员后台 → 商业化):现金收入总览、推广订单、机构客户、赞助活动、现金流水(与积分账本零交集)与商业化红线清单。
演示路径:登录陈屿 → 首页发现流可见「推广」任务卡与「广告」卡 → 打开自己的「周三晚羽毛球三缺一」→ 任务加速 → 用免费额度购买 → 详情出现「任务加速」标注;更多 → Utopia Plus → 开通(演示支付)→ 首页广告消失,积分余额分毫不变。
Vite · React 19 · TypeScript · Tailwind CSS 4 · React Router 7 · Immer · Capacitor 8(iOS)
src/lib/types.ts— 核心数据实体(User/Task/LedgerEntry/Dispute/…)src/lib/store.tsx— 业务状态机:托管、释放、退款、争议冻结与裁决;余额永远从账本推导src/lib/risk.ts— 无外部 AI 的降级实现:关键词风险分级(T0–T4)、自然语言任务解析、积分建议、聊天风控src/lib/monetize.ts— 商业化规则:加速套餐与推广资格、每月配额、推广密度(1/14)、Plus/Pro 权益与反向承诺、广告红线src/data/seed.ts— 初始模拟数据src/pages/Admin.tsx— 管理员后台(审核/事件/争议/账本/积分经济/审计)ios/— Capacitor 生成的 iOS 原生工程(SPM 依赖,无 CocoaPods).github/workflows/ios-release.yml— 推送v*标签时自动构建未签名 ipa 并发布 GitHub Release