「邻里好物」让好物在邻里间流转:按距离发现附近的闲置、手机号登录后借用 / 归还、发布自己的好物。全体用户共享同一份数据——物品存在云端(GitHub Issues 承载,用户对 GitHub 全程无感),任何人打开网站看到的都是同一份列表。
- 地理位置:发布闲置时自动获取定位并保存;列表默认展示距离用户 x 公里内的物品(x 为可配置参数,见
src/lib/geo.ts的DEFAULT_RADIUS_KM/RADIUS_OPTIONS),按距离由近到远排序;无定位物品显示「距离未知」并排在末尾 - 手机号登录:本机身份标记;写操作凭登录手机号匹配发布者 / 借阅人(换设备用同一号即可管理)
- 联系方式二选一:发布时在「楼号门牌」或「手机号」中选择一种填写(楼号优先);展示时楼牌号在前
- 共享数据层:每条物品 = 一条带
item标签的 Issue - 站内完成所有操作(用户无感 GitHub):前端不持有 Token——
- 发布 / 借用 / 归还 / 下架 / 上架:浏览器调用 Cloudflare Worker 薄代理(
cloudflare-worker/,ADR-0001),代理持 GitHub Token 写 Issues;Token 永不进客户端 - GitHub Issue 评论命令已关闭,避免公开仓库被评论改状态
- 代理未部署时读操作仍可用(快照 → 种子兜底),写操作友好提示「云端服务尚未开通」
- 发布 / 借用 / 归还 / 下架 / 上架:浏览器调用 Cloudflare Worker 薄代理(
- 状态筛选:默认不展示已借出物品,可通过「显示已借出」开关切换;「我的发布 / 我的借用」双大卡互斥切换(点击其一自动取消另一个)
- 图片上传:发布时可上传单张图片(自动压缩),不上传时显示「小主没有上传图片哦」
npm install
npm run dev # 本地开发
npm run test # vitest 单测(GitHub 数据契约 + 状态机 + 距离 + 冒烟)
npm run build # 类型检查(vue-tsc) + 构建 dist/
npm run preview # 本地预览构建产物仓库已开启 Settings → Pages → Source: GitHub Actions(build_type: workflow)。.github/workflows/deploy.yml 触发 push / issues / issue_comment:
- (评论事件)
scripts/handle-comment.mjs只记录日志,不再改 Issue scripts/gen-items.mjs从 Issues 生成public/items.json快照(坐标约 110m 网格、图片白名单)npm run build→ 部署 Pages
写操作代理(Cloudflare Worker,用户无感 GitHub 的关键):
cd cloudflare-worker
wrangler deploy
wrangler secret put GITHUB_TOKEN # 仅本仓 issues 写权限 PAT
wrangler secret put SITE_KEY # 可选;需与 src/lib/api.ts 的 SITE_KEY 一致前端 API_PROXY 为运行时自动判定:*.github.io 走 Worker;*.pages.dev / 自建服务器走同源 /api,一份构建两处可用。
主站是 Direct Upload 项目(未接 git 集成,push 不会自动构建),仓库 CI 只发镜像:
CLOUDFLARE_API_TOKEN=<token> npm run deploy:pages脚本做四件事:npm run build → 写入 dist/_routes.json(仅 /api/* 走 Worker)→ wrangler pages functions build 把 cloudflare-pages/functions 编译为 dist/_worker.js(wrangler 检测的是 cwd/functions 而非 dist/functions,故显式编译)→ wrangler pages deploy dist --project-name linli-haowu --branch main(--branch main 必须:项目 production_branch=main、git 分支是 master,不加会被当作 preview,主站不更新)。Token 需 Cloudflare Pages: Edit + Zone: Read(权限在 https://dash.cloudflare.com/profile/api-tokens 创建);项目名以 npx wrangler pages project list 为准。
线上地址(主站):https://linli-haowu.pages.dev/
GitHub Pages 镜像:https://sljdxde.github.io/idle-items-sharing-cloudbase/
workers.dev 在部分国内网络不可达;有一台服务器时可整站托管加速:
# 服务器(非 root 用户即可):上传 dist/ 与 server/proxy-server.mjs 到 ~/linli/
echo '<GitHub PAT>' > ~/linli/.token && chmod 600 ~/linli/.token
nohup node ~/linli/proxy-server.mjs > ~/linli/server.log 2>&1 & # 监听 127.0.0.1:8087
# nginx 80 端口 server_name <服务器IP> 反代到 127.0.0.1:8087(client_max_body_size 10m)server/proxy-server.mjs 与 Worker 同契约:/api/* 代理写操作,其余路径服务 dist/ 静态站。
说明:写操作(发布 / 借用 / 归还 / 管理)经代理在站内完成,用户无需 GitHub 账号;读操作任何访客无需登录。
├── index.html # Vite 入口
├── src/
│ ├── lib/ # types / github(Issues 读取) / api(写代理) / geo / itemOps / contact / image / validate
│ ├── stores/ # Pinia:items(物品与筛选) / auth(本机手机号标记)
│ ├── components/ # Navbar / MyPanel / Toolbar / Card / BorrowModal / ManageModal / LoginBox / Toast
│ ├── pages/ # Home / Publish / Detail / Mine / Borrows(hash 路由)
│ └── styles/ # Memphis 设计 tokens + 基础样式
├── scripts/ # gen-items.mjs(Issues→快照) / handle-comment.mjs(评论写通道已关)
├── cloudflare-worker/ # 写代理 + 共用安全原语
├── server/ # 自建 Node 代理(同契约)
├── tests/ # vitest 单测 + 生产包冒烟门禁
├── legacy/ # v1/v2 历史版本存档
└── docs/adr/ # 架构决策记录