refactor: 个人自用，移除登录与云同步全链路
站点只给本人用，云乐坊 SSO 授权、收藏/历史云同步、获客归因和账号切换记账都没有收益，却被登录状态检查和同步失败提示持续打扰。 - 删除 useYunlefunAuth / yunlefunAuth / yunlefunSsoConfig / yunlefunAuth 适配器、useUserDataSync / userDataSync / userData 适配器、三个 client 插件与 /auth/callback 回调页 - 抽出 adapters/cloudbase.ts，让「反馈一下」和匿名筛选信号不再依赖登录态；cook-feedback 云函数保留 - 删除 cook-user-data 云函数与 cook_user_data 权限规则，移除 @yunlefun/sso 依赖 - 「我的」页删掉登录按钮、账号卡、四个统计格和退出登录；「关于」页删掉项目作者、致谢名单和上游宣传链接 - 本地收藏/历史与导出导入保留，删除同步专用的 lastUid 记账 取舍见 docs/decisions/0005-drop-login-and-sync.md
This commit is contained in:
toor
trae-solo-agent
@@ -1,34 +0,0 @@
|
||||
# 注册来源记录与发布
|
||||
|
||||
Cook 在文档初次进入时记录来源。`firstTouch` 保存在当前域名的 localStorage，30 天后重新采集；`registerTouch` 保存在当前标签的 sessionStorage，每次文档进入更新。SPA 内跳页不会把原落地渠道改成站内页面。`/auth/*` 回调不采集，以免把统一登录、GitHub 或微信授权页计入获客来源。存储被禁用时，本次文档以内存降级，来源失败不会阻止登录。
|
||||
|
||||
可读存储被清空或损坏时，以当前存储状态为准，不能从旧内存恢复已删除的来源。访问存储被拒绝时使用经过校验的内存上下文；若已知新写入失败且存储仍保留完全相同的旧值，使用当前文档的新来源，防止旧活动回流。可观察的删除或值变化会清除此降级状态。首次与本次入口超过 30 天均失效，不长期保留旧活动。
|
||||
|
||||
来源只携带落地域名、路径、外部 referrer 域名以及 `utm_source`、`utm_medium`、`utm_campaign`。`yunle.fun`、其全部子域、`cook.yunyoujun.cn` 和当前域名的站内跳转不会计入外部 referrer，避免 SSO 或 Apps 往返被统计成获客渠道。查询、hash 和凭证不会写入来源记录。没有 referrer/UTM 表示来源缺失，不能据此断言为直接访问。
|
||||
|
||||
登录前读取同一份 `{ version: 1, firstTouch, registerTouch }`，同时覆盖 Web 顶层重定向和 Apps host bridge。来源为客户端上报数据；统一登录服务依据 Registry 验证应用入口并依据 Auth 判断账号是否真正新注册，不能按 Cook 首次登录或公开资料创建时间判断。后续登录不会覆盖账号已保存的注册来源。
|
||||
|
||||
## 本地联调
|
||||
|
||||
新协议在 `@yunlefun/sso@0.7.0`，正式依赖使用 npm registry 的锁定版本。需要联调尚未发布的改动时，可用本地 `YunLeFun/ylf` checkout 的实际构建/打包产物验证：
|
||||
|
||||
```sh
|
||||
node scripts/qa/verify-acquisition-sdk.mjs --sdk-root=/path/to/ylf
|
||||
# 可选：同时验证当前应用的构建与类型（包括已有工作区改动）
|
||||
node scripts/qa/verify-acquisition-sdk.mjs --sdk-root=/path/to/ylf --build --typecheck
|
||||
```
|
||||
|
||||
脚本构建 SDK 并生成临时 tarball，短暂切换已有 node_modules 的 SSO 软链接，运行定向测试和 lint，最后恢复旧软链接。它不修改 package.json、lockfile 或 pnpm override，也不发布 npm。运行时避免并发安装依赖。
|
||||
|
||||
## 发布顺序
|
||||
|
||||
1. 先发布账户私有来源集合/写入 API 与统一登录、SSO 服务端（它们可先接收可选字段并继续兼容旧客户端）。
|
||||
2. 从 `YunLeFun/ylf` 发布已验证的 `@yunlefun/sso@0.7.0`；该版本给现有 PKCE 协议增加可选来源字段。
|
||||
3. 在 Cook 解析并更新 0.7.0 的 lockfile，复核保留当前其他依赖改动，再执行 frozen install、typecheck 和构建并发布。
|
||||
4. 发布 Apps 的来源透传代码。
|
||||
|
||||
`@yunlefun/sso@0.7.0` 已由公开的 `YunLeFun/ylf` 仓库通过 OIDC 发布，附带 GitHub Actions provenance。Cook 的 lockfile 使用实际 registry integrity，安装与发布不依赖临时本地路径或 override。`minimumReleaseAgeExclude` 只为已核验的自有版本 `@yunlefun/sso@0.7.0` 提供精确例外，其余依赖继续遵循 24 小时等待和供应链策略。
|
||||
|
||||
Cook 主域名 `cook.yunyoujun.cn` 对应 EdgeOne Upload 项目 `yunyoujun-cook`，发布时使用该项目名；`cook.yunle.fun` 是另一个 Git 集成项目。云乐坊容器内的发布仍按各自流程验收。
|
||||
|
||||
历史用户最多保留来自 SSO 时间关联的应用入口推断；不能把 GA 总体流量比例回填为某个 UID 的外部渠道。各域名、不同浏览器和被清除的存储也无法恢复此前未采集的触达。
|
||||
@@ -49,6 +49,8 @@ NUXT_PUBLIC_CLARITY_DOMAINS=cook.yunyoujun.cn,cook.yunle.fun
|
||||
|
||||
直接进入 `/auth` 或携带常见凭证参数的页面时不加载脚本。已加载的页面导航到这类 URL 前调用 Clarity `stop`，并在本次文档生命周期内停止业务事件；重新加载普通页面后恢复。脚本加载或事件发送失败不会阻断 Cook 操作。
|
||||
|
||||
站点已无登录流程，`/auth` 分支保留为通用兜底：一旦将来引入带授权码的回调页，它不会被回放采集。
|
||||
|
||||
代码不调用 `identify`，也不会替访客发送“已同意”的信号。有同意管理需求的部署应连接真实的用户选择；Clarity 对 EEA、英国、瑞士的访问有同意信号要求，未提供时部分功能受限。站点隐私说明应包含实际使用的统计服务。
|
||||
|
||||
## 验收
|
||||
@@ -56,7 +58,7 @@ NUXT_PUBLIC_CLARITY_DOMAINS=cook.yunyoujun.cn,cook.yunle.fun
|
||||
1. 部署后在允许的生产域名访问首页，确认 `https://www.clarity.ms/tag/ks1ebw03i5` 只加载一次。
|
||||
2. 检查 Clarity 采集请求成功及负载中的固定事件名，再在后台录制时间线确认新漏斗事件；仪表板汇总可能延迟，HTTP 204 不代表汇总已经展示。
|
||||
3. 切换页面、选择食材、打开菜谱，验证功能正常；阻断 Clarity 域名后重复验证。
|
||||
4. 查看一条回放，确认账号和自建内容被遮罩；登录回调入口不应加载脚本。
|
||||
4. 查看一条回放，确认自建内容被遮罩；带凭证参数的 URL 不应加载脚本。
|
||||
5. 中国大陆访问效果需要用目标运营商网络实测，不能用本机可访问代替全部用户的可达性结论。
|
||||
|
||||
Clarity 官方当前提供免费服务。普通回放保留 30 天，标记或收藏的会话及热力图可保留 9 个月；单项目每日最多保存 10 万条会话回放，超过后可能抽样。它适合行为分析，不替代长期原始事件仓库。
|
||||
|
||||
+8
-12
@@ -1,6 +1,6 @@
|
||||
# Web 应用
|
||||
|
||||
Cook 只保留 Web 一套代码，服务普通浏览器和云乐坊容器。技术栈：
|
||||
Cook 只保留 Web 一套代码。技术栈：
|
||||
|
||||
- [Nuxt 4](https://nuxt.com/)（Vue 3，CSR-only，静态生成）
|
||||
- [Ionic](https://ionicframework.com/) + [Nuxt Ionic](https://ionic.nuxtjs.org/)（Web UI 框架，与 Capacitor 无关）
|
||||
@@ -8,17 +8,13 @@ Cook 只保留 Web 一套代码，服务普通浏览器和云乐坊容器。技
|
||||
|
||||
原生 App（iOS / Android）的代码已随 [0004 只保留 Web，移除 Capacitor 原生壳](/decisions/0004-web-only) 一并移除。
|
||||
|
||||
## 云乐坊 SSO
|
||||
## 没有账号体系
|
||||
|
||||
Web 端有两种登录路径：
|
||||
站点没有登录，也没有云端同步。收藏、浏览历史和自己记的菜谱都存在浏览器 localStorage，
|
||||
换设备或清浏览器数据前需要在设置页导出 JSON 再导入，详见
|
||||
[0005 个人自用，去掉登录与云同步](/decisions/0005-drop-login-and-sync)。
|
||||
|
||||
- **在云乐坊 App 容器内**：通过宿主注入的 `window.ylf` JSAPI 直接请求宿主授权面板，用户不离开当前页面。
|
||||
- **在普通浏览器中**：走顶层重定向到云乐坊授权页，授权完成后回到
|
||||
`https://cook.yunyoujun.cn/auth/callback`，由该页面换回登录票据。
|
||||
## 云乐坊容器
|
||||
|
||||
回跳地址必须是已在云乐坊登记的 HTTPS 地址，且不能带 `?platform=native` 之类的原生标记。
|
||||
PKCE 能阻止授权码被旁路窃取，但不能阻止恶意客户端主动冒充公开客户端发起授权，
|
||||
因此不要放宽回跳地址的登记要求。
|
||||
|
||||
回跳域名有多个时（`cook.yunyoujun.cn`、`cook.yunle.fun`），按当前页面 origin 选对应的那个，
|
||||
`yunlefunSsoRedirectUris` 里没登记的域名会直接判定为配置错误并拒绝登录。
|
||||
被云乐坊 App（`window.ylf` JSAPI）内嵌时会按宿主的展示形态、安全区与胶囊位置调整布局，
|
||||
实现见 `utils/yunleHost.ts`。这是 Web 被第三方 App 容器加载时的适配层，与账号无关。
|
||||
+1
-1
@@ -93,7 +93,7 @@ pnpm eval:search # 用真实信号评估当前排序：前 10 命中率、MR
|
||||
1. 在 CloudBase 控制台新建三个集合，权限都设为「仅管理端可读写」：`cook_recipe_feedback`、`cook_search_signals`、`cook_feedback_quota`。
|
||||
2. 部署云函数：`tcb fn deploy cook-feedback`（配置见 `cloudbaserc.json`）。
|
||||
3. 给 `cook-feedback` 设置环境变量 `COOK_FEEDBACK_EXPORT_TOKEN`（一串足够长的随机字符），并开启 HTTP 访问服务，得到一个访问地址。
|
||||
4. 让未登录用户也能调用 `cook-feedback`：在控制台开启匿名登录或允许未登录访问该函数。否则只有登录用户能提交，未登录用户会被引导去 GitHub。
|
||||
4. 让未登录用户也能调用 `cook-feedback`：在控制台开启匿名登录或允许未登录访问该函数。站点本身没有登录功能，前端也不携带任何账号信息，所以这一项是必需的。
|
||||
5. 本机 `.env` 填 `COOK_FEEDBACK_URL`（第 3 步的地址）和 `COOK_FEEDBACK_TOKEN`（同一个口令），之后就能 `pnpm feedback:pull`。
|
||||
|
||||
云函数对每个设备（或账号）每天最多接受 200 次提交；同一个人对同一道菜的同一类问题每天只记一次。
|
||||
|
||||
Reference in New Issue
Block a user