2026-06-24

2026-06-24 daniel 工作日志

NovaSwap 用户端（fomopaddapp） 全天主线 FEAT-017 选币体验收尾 + 第三方代币 logo 全链统一，并完成 FEAT-016/017 对齐后的测试服多轮迭代与正式服上线。承接 06-23 的 listed 选币弹窗对接，今日：① 选币列表并入「用户自添加币」；② 排查并根治第三方代币 logo 在兑换页/详情页与收藏页不一致——建「地址→logo」注册表，listed/allCoins/收藏三源统一灌入；③ 按 PM 诉求支持「搜索阶段（收藏前）即显示三方币 logo」，与 zz 对齐走 udf/symbols；④ 修复添加流动性确认弹窗大数额溢出裁切；⑤ 多轮 test 部署 + 正式服 bsc:prod 上线。

另在 fomoadmin 管理后台 完成 FEAT-017 选币展示 v1.1 收口 3 项：选币展示对接 BE v1.1 入参 symbol→token_address 破坏性变更、预览基础币 BNB/USDT 补真实 logo、登录失效跳转改硬刷新修复遮罩残留。

今日完成

—— NovaSwap 用户端（fomopaddapp）——

选币弹窗：用户自添加币（listed ∪ userAddedTokens）

• be29ea29：FEAT-017 初版选币列表为纯后台 listed，丢了旧的「按地址搜到→添加→常驻列表」能力。改为后台清单 ∪ userAddedTokens：搜到点「添加」写 localStorage 常驻、跨会话保留、可「移除」；后台清单币 / USDT 不显添加/移除。useListedDisplayTokens 暴露 listedAddresses，CurrencyRow 据此区分后台币与自添加币。（期间「删添加按钮」一度提交后按需求回退保留。）

第三方代币 logo 全链统一（注册表方案）

• 根因：各界面 logo 取数源不同——选币弹窗用 WrappedTokenInfo.logoURI（listed）正常、收藏页直接用收藏接口 logo 正常，但兑换页选币下拉（普通 Token 无 logoURI）走 getTokenLogoURL→trustwallet 占位、代币卡片只读 /coin，第三方币（HDM）显占位/字母；Logo 组件还用 /coin 覆盖传入 src。
• 41269750 / 5ea5df87：新建 tokenLogoRegistry（地址→logo，localStorage 持久化），App 挂载从 listed 灌入；getTokenLogoURL / Logo（优先于 /coin）/ TokenDetail 卡片 / 非 RWA 详情页头部 TokenHeader 统一按地址消费——一处建库、四处生效。
• 6b07593b：FISTA 等不在 listed 的第三方币，logo 仅由收藏接口下发→兑换页仍占位。补充让 useV2FavoriteList（全站收藏星标共享）+ useGetAllCoins（app 级）也按地址灌注册表，汇集 listed + allCoins + 收藏 三源。

搜索阶段取三方币 logo（收藏前可见，PM 诉求）

• af08eff6 / 3f279076：陌生三方币（不在 listed/收藏/allCoins）在「收藏前」搜索阶段无 logo 源——死循环（看不到 logo 就不收藏）。与 zz 对齐：logo 加在 GET /udf/symbols（symbol = pair 地址；token 地址会 unknown_symbol）。前端粘地址搜到币时先 GET /api/token/{addr} 拿 pair_address → GET /udf/symbols 取 logo → 写注册表，本次 render 即显示。fetchSymbolInfo 增 logo 字段，新增 fetchTokenInfo。

添加流动性确认弹窗适配

• 984720d9：「您将收到」LP 代币数额固定 text-[48px]、flex 行无收缩约束，遇极小 LP 值（USDT/CUSDT 前导零多）撑出弹窗被右侧裁切。改为按字符长度自适应降档字号（48/30/24px）+ min-w-0 break-all 换行 + logo flex-shrink-0；noLiquidity 符号分支同样加固。

部署

• 测试服多轮：每次合并 master-v2 → 还原测试服 deploy.sh → build:bsc:test → 提交产物 → push origin test（7d268d03 → … → 051386ef）。
• 正式服上线：FEAT-016/017 对齐后 build:bsc:prod（含混淆，.env.bsc.production SUPPORTED_CHAINS=56）→ 提交产物 → push origin master-v2（989ff0b6 → 7678e9d9，9 个源码提交 + 正式服产物全部同步）。

—— fomoadmin 管理后台 ——

FEAT-017 选币展示对接 BE v1.1（破坏性变更）

• a7f2ec7：入参 symbol → token_address —— BE v1.1 因「山寨币同 symbol 不同 contract」把展示配置索引粒度从 symbol 改为 token_address。前端同步：写操作入参改地址（加入 / 移除 / COMMON BASE 改 {token_address}、拖拽重排改 {token_addresses:[]}）；mapRow 新增 tokenAddress（唯一键 + 所有写操作入参）+ pairAddress；所有 v-for :key 由 symbol 改 tokenAddress（symbol 不再唯一会撞 key），代币池表加 row-key="tokenAddress"，基础币无地址回退 symbol；api.js 更新 4 端点 JSDoc 入参提示 + 修正 common-base @see 重命名后的路径。

FEAT-017 选币展示预览微调

• 8a11487：预览基础币 BNB/USDT 补真实 logo —— 前端实时预览里硬展示的基础币原为占位图标，新增 public/bnb.png / public/USDT.png，BASE_COINS.logo 指向之；基础币仍前端硬展示、不归后台管的设计不变。

登录态体验修复（非 FEAT-017）

• 372584e：登录失效跳转改硬刷新，修复重新登录后阴影遮罩残留 —— hash 路由下 location.href='/#/login' 只改 #fragment 不整页刷新，401 时若有 Element Plus 弹层打开，其遮罩 .el-overlay / body 滚动锁会残留盖屏、重新登录走 SPA 仍不清，需手动硬刷新才好。两处 401（响应拦截器 + doAjax）收敛为 redirectToLogin()：清本地态 + 提示 + window.location.reload() 强制整页重置；加 redirecting 去重，并发多个 401 只跳一次、只弹一个 toast。

关键决策

• logo 统一走「地址→logo 注册表」：listed / allCoins / 收藏三源按地址汇集、localStorage 持久化，任一处见过的 logo 全站复用；不在任何源的纯陌生币回退首字母（无源，符合预期）。
• 主网 USDT 限制无需改码：限制走跨链 getAllQuoteTokenAddresses（含 56 的 0x55d398…），主网/测试网 USDT 早已同样受限（不可收藏 / 无详情 / 详情链接回退 /swap）。
• 搜索 logo 走 udf/symbols（按 pair 地址）：zz 指定 logo 加在第三方币详情接口 udf/symbols，symbol 为 pair 地址，前端先 token→pair 再取 logo。
• （fomoadmin）展示配置索引粒度 = token_address（非 symbol）：山寨币同 symbol 多合约会撞，唯一键与所有写操作入参统一用合约地址；symbol 仅作展示 + 基础币兜底 key。
• （fomoadmin）登录失效统一硬刷新 + 去重：hash 路由 + Element Plus 遮罩组合下唯有整页 reload 能彻底清残留遮罩；并发 401 只跳一次避免叠多个提示。

阻塞与问题

• 搜索阶段 logo 待 zz 在 /udf/symbols 填充 logo 字段：实测当前恒空，前端已就绪（有则显、空则忽略），zz 填充后自动生效，无需前端再动。
• （已解决）一次 git commit 撞瞬时 .git/index.lock：源码先被推上去、build 产物后补提交；确认锁已消失、无活跃 git 写进程后重试，最终源码 + 正式服产物完整同步。
• （fomoadmin）FEAT-017 三页仍待 QA 在 test-api 真实登录态过 AC（用户统计 / 第三方代币 / 选币展示，含 v1.1 token_address 改造、登录态修复）。
• （fomoadmin）COMMON BASE 文档口径 + 平台 RWA 缺图代币 logo 端点待 zz：story-05 AC5 / QA-007 字面与群里口径不一（功能已按原型保留并适配 v1.1）；平台 RWA 缺图代币 logo 上传 BE 仅 third-party/logo，待确认是否本期范围。

明日计划

• 跟进 zz 填充 udf/symbols.logo 后，验证搜索阶段三方币 logo 即时显示。
• 配合 QA 对 test / 正式服回归：logo 全链一致、USDT 限制、添加流动性弹窗适配、用户自添加币。
• （fomoadmin）跟进 QA 对 FEAT-017 三页（含 v1.1 token_address 改造、登录态修复）的复测反馈，按需收口；待 zz 确认 COMMON BASE 文档口径 + 平台 RWA 缺图代币 logo 是否本期范围。