Skip to content

重设计 BiliNote Web 与浏览器扩展工作台 UI,移除 Tauri #54

Closed

Description

@El1mir

重做当前产品的完整视觉系统与各页面体验。现有设计.md 已删除,旧 Ember 视觉风格不作为约束;必须保留产品现有功能与业务行为。范围是主 Web 应用 + 浏览器扩展,全量移除 Tauri 并在文档/changelog 说明。视觉方向已由用户确认:深石墨、冷白、青绿;浅色默认、深色完整支持;动效专业流畅。请调度员先做需求评审,再将本总任务拆为非重叠、可并行的实现工作包,明确地基依赖和验收。

验收标准

  1. 主 Web 工作台、Reader、Settings、Onboarding 和扩展 Popup、Options、Sidepanel 均按本规格重设计;完整保留现有用户功能,功能回归检查通过。
  2. 所有页面使用统一 semantic tokens;浅色为默认主题,深色主题覆盖全部页面、表单、弹层、状态和阅读内容,无旧 Ember terracotta/warm-neutral 视觉残留。
  3. 在 375、768、1024、1440 CSS px 验证 Web 响应式布局;扩展在实际 Popup/Options/Sidepanel 尺寸验证,无溢出、遮挡或不可达功能。
  4. 核心文字对比度达到 WCAG AA(普通文字≥4.5:1),非文本 UI 对比度≥3:1;状态同时有文字/图标,不只靠颜色表达。键盘可完成主要流程,Dialog/Drawer 焦点约束和恢复正确,触控目标≥44px,支持 prefers-reduced-motion。
  5. 页面状态覆盖加载、空、成功、失败、禁用、保存中/完成和后端不可用;Cookie/设置读取失败不能将空值写回覆盖原值,危险恢复/删除有确认。
  6. 动效使用集中 token,动作明确、可中断,普通交互 120–300ms;不使用持续装饰动画或 transform:scale(0),减少动态模式下关闭非必要动画。
  7. 彻底移除 Tauri 路由检测、配置、入口、脚本和仅供 Tauri 使用的依赖/文档;Web 统一走 BrowserRouter,更新相关文档或 changelog;无 Tauri 构建入口/运行时引用残留。
  8. cd BillNote_frontend && pnpm exec vitest run && pnpm exec tsc -b && pnpm lint && pnpm build 全部通过;cd BillNote_extension && pnpm typecheck && pnpm test && pnpm test:e2e && pnpm build 全部通过。提交截图/对比度结果作为验收证据。

阅读范围

路径:BillNote_frontend/src/ember、BillNote_frontend/src/services、BillNote_frontend/src/store、BillNote_frontend/src/hooks、BillNote_frontend/src/utils、BillNote_frontend/src-tauri、BillNote_frontend、BillNote_extension/src、BillNote_extension、docs、README.md、CHANGELOG.md

Activity

  1. added
    lane/humandsh-flow 受管标签
    and removed on Nov 10, 2026
  2. El1mir commented on Nov 10, 2026

    @El1mir
    OwnerAuthor

    11 问全部裁决完(明细见下方),T-066 转拆包执行,不再单卡顺序做。

    • Q1 是:a11y 已实现(Field aria-describedby/aria-invalid、Tabs roving tabindex、ErrorBoundary 接入、taskUrl 深链)只保持契约 + 复跑既有测试,禁止重写。
    • Q2 是,且你的 Tauri 清单不全:实测 src/ 下 6 个文件含 tauri 引用 —— ember/EmberApp.tsx、ember/pages/OnboardingGuard.tsx、ember/startup/StartupNotice.tsx、ember/startup/StartupScreen.tsx、ember/startup/useBackendEvents.ts、hooks/useCheckBackend.ts(taskUrl.ts 仅注释)。拆 T-b(vite 版本改读 package.json → package.json 去 @tauri-apps/* → 删 src-tauri → README/CHANGELOG,顺序不可颠倒)与 T-a(运行时分支),T-a 独占 EmberApp.tsx。
    • Q3 是:EmberApp.tsx 归 T-a,W0 只新增 tokens/motion/ThemeProvider/ui 原语/AppShell。
    • Q4 是:html[data-theme] + CSS 变量,禁 dark: 散落;Topbar 三态、localStorage、index.html 内联脚本防首帧闪。
    • Q5 是,数字更正:hex 实测 18 处 / 5 文件 —— EmberToaster.tsx(4)、ErrorBoundary.tsx(2)、StartupNotice.tsx(2)、StartupScreen.tsx(2)、BilibiliMark.tsx(8)。品牌粉保留为品牌 token 白名单。
    • Q6 是:新建 specs/021-workbench-redesign/(含 DESIGN.md),005 §12 标注被取代 + ADR。
    • Q7:T-057 已合并(0a896fe,done/merged),无需冻结;T-066 只排除已实现项。
    • Q8 批准自托管字体:@fontsource/inter、@fontsource/source-serif-4、@fontsource/ibm-plex-mono(Google CDN 国内不可用、内网需离线)。
    • Q9/Q10 是:数值同源各自落地;每包 tsc+lint+定向 vitest,集成包跑 build/全量,e2e 不可得显式标 BLOCKED。
    • Q11 八条验收原文已逐字写入各工作包的 acceptance,不改写。
  3. El1mir commented on Nov 10, 2026

    @El1mir
    OwnerAuthor

    Tauri 全量移除完成(验收 7);其余需你拆包,附文件边界

    提交 6fc8d80(35 files, +52/−6545),已推 origin/flow/T-066。flow_pr_open 报 http-403,PR 未生成。

    改动:ember/EmberApp.tsx 只留 BrowserRouter(删 __TAURI_INTERNALS__ 与 HashRouter);删 startup/useBackendEvents.ts、startup/StartupNotice.tsx、pages/OnboardingGuard.tsx;StartupScreen.tsx 改为 HTTP 就绪三态;useCheckBackend.ts 去三条 Tauri 事件通道与 markFailed;删 src-tauri/、.env.tauri、backend/build.bat|sh、.github/workflows/main.yml;package.json 去三个 @tauri 依赖;vite.config.ts 版本改读 package.json、base 固定 /;backend/main.py CORS 去 tauri origin。CHANGELOG/CLAUDE.md/RELEASING.md 同步。

    门禁:vitest exit 0(24 files/151 tests)、tsc -b 0、lint 0、build 0、i18n 0(553 keys)、py_compile 0。CORS 实测:localhost ✅ / tauri.localhost ❌ / chrome-extension ✅。残留 grep 0。
    未跑后端 pytest:检出无 backend/.venv,后端只改 CORS 与注释,已用 py_compile + 正则实测覆盖。

    剩余需拆成写入范围零交集的包:

    • W1 tokens/主题/动效:ember/tokens.css、motion.css、reader.css、src/index.css、index.html
    • W2 原语:ember/ui/*(18)→ 依赖 W1
    • W3 Shell:ember/shell/*、startup/StartupScreen.tsx、pages/NotFoundPage.tsx
    • W4 Workspace:features/workspace/*(16)、pages/WorkspacePage.tsx
    • W5 Reader:features/reader/*(5)
    • W6 Settings:pages/settings/*
    • W7 Onboarding:pages/OnboardingPage.tsx、onboardingStorage.ts、onboardingTranscriber.ts
    • W8 扩展 Popup+Sidepanel:extension/src/popup/*、sidepanel/*、components/*
    • W9 扩展 Options:extension/src/options/*、styles/*
    • W10 回归证据:只写 docs/

    W3–W9 均依赖 W1+W2;i18n/strings.ts 任何包都会写,须指定单一写入者或最后统一补。

  4. El1mir commented on Nov 10, 2026

    @El1mir
    OwnerAuthor

    6fc8d80 已核:作为 T-074 的种子提交保留,不在父卡分支合并。

    • 删除面正确:src-tauri/、.env.tauri、StartupNotice.tsx(Tauri sidecar 诊断)、useBackendEvents.ts(Tauri 事件)、OnboardingGuard.tsx(源码注释写明"Only the Tauri build is intercepted")、三个 @tauri-apps 依赖、backend/build.*、backend/main.py 的 taur[path] 与 tauri.localhost CORS 分支。
    • .github/workflows/main.yml 删的是 "Build & Release Desktop App" 专用流水线(matrix 只有 macos/windows 的 Tauri target),src-tauri 删除后它无法运行,删除成立;但Web 侧从此没有发布流水线,如需 tag 自动发布要在 T-074 里补一条 Web 构建流水线,或确认走 docker-compose 人工发布。
    • 提交自带顺序约束已满足:vite.config.ts 版本先改读 package.json,再删 src-tauri。
    • T-074 开工时以 git cherry-pick 6fc8d80 为起点(会与 T-068 的 token 改动、T-072 的 StartupScreen 重绘有小冲突,按新 token 解)。

    由此同步收窄 T-072 的阅读范围:OnboardingGuard.tsx、startup/useBackendEvents.ts、startup/StartupNotice.tsx 由 T-074 删除,T-072 不再重绘它们,只做 OnboardingPage / NotFoundPage / StartupScreen / ErrorBoundary。

  5. El1mir commented on Nov 10, 2026

    @El1mir
    OwnerAuthor

    W1 地基已提交 cfee166:暖色 Ember 换成石墨/冷白/青绿语义 token,浅色默认 + 深色完整,字体与动效阶梯重建。

    • src/ember/tokens.css 全量重写::root/.dark 两套语义值经 @theme inline 映射,组件只写 bg-canvas/text-ink/border-line-strong/bg-primary。
    • *-ember* 颜色族 → *-primary*(25 文件脚本替换,零残留);ember 仅保留为模块/工具类命名空间——被探针脚本与测试引用,改名会牵连无关文件。
    • 新增 src/ember/theme/theme.ts + ThemeToggle,initTheme() 在 createRoot 前执行,避免刷新闪白。
    • 白字改 on-primary/on-danger:深色 primary #43c7b6 上白字仅 2.08:1,改 #06201d 得 8.18:1。
    • 控件边框 line→line-strong(3.13–3.89:1);warning #9a6700→#926100(canvas 上 4.49→4.93)。

    证据:docs/ui-audit/w1-design-system.md、evidence/w1-contrast-ratios.txt(双主题全 token PASS)、w1-light.png、w1-dark.png、w1-responsive-light.png(375/768)。
    门禁:vitest 24 files/151 tests、tsc -b、lint、build 全 exit 0。

    未做:页面级构图(顶栏/三栏/Reader 衬线列/Settings/Onboarding)与扩展三入口;四档截图与键盘流程复验留到对应工作包。

  6. El1mir commented on Nov 10, 2026

    @El1mir
    OwnerAuthor

    W2 外壳与阅读区已提交 eed0853:顶栏(面包屑+后端存活+主题/语言)、阅读正文衬线 16/28、触摸端 44px 目标。

    • Topbar.tsx 只做定位层,页面自己的 h1 保留;状态是圆点+文字(role="status"),三态 checking/online/offline。
    • useBackendStatus.ts 复用 getBackendBase()(改为导出),30s 探一次 /sys_check;启动门禁那个 hook 是一次性闸门,无法反映中途掉线。刻意不做退避(文件里 ponytail: 注明)。
    • reader.css:.ember-markdown 衬线 + :is(p,li,blockquote) 16/28,无层规则压过 text-body,组件零改动;行宽沿用既有 68ch。
    • tokens.css:@media (pointer: coarse) 下按钮/select 最小 44×44,桌面密度不变,行内链接按 WCAG 2.5.8 豁免。

    证据 docs/ui-audit/w2-shell-and-reader.md + evidence/w2-{375,768,1024,1440}.png、w2-topbar-{light,dark}.png(mock 后端 + 3015 实测,浅/深两态)。门禁 vitest 24/151、tsc、lint、build 全 exit 0。

    仍未做:Workspace 三栏与小屏抽屉化(375/768 目前分组/历史排在表单之前)、Reader 实体页衬线未在运行态核验(mock 未造出 succeeded+markdown 任务)、Settings/Onboarding/扩展三入口、键盘与 Dialog 焦点复验。

  7. El1mir commented on Nov 11, 2026

    @El1mir
    OwnerAuthor

    父卡发生重复派工:一个 worker 与 T-075(run_154)在同一 worktree 抢写。已回复「由 T-075 收口」,要求它不提交、不清理、不动 .t075-run/。

    • 现况:worktree 27 项未提交,全为 T-075 的 W7 产物(docs/ui-audit/021/w7-*.png、w7-acceptance.md、gates.md)+ BillNote_extension/tsconfig.json 一处改动
    • 处置:等 T-075 自停并提交后再做父卡合并,期间父卡不派工
  8. El1mir commented on Nov 11, 2026

    @El1mir
    OwnerAuthor

    在 f657ab2 上独立复验 T-074 四条,与 El1mir 的结论一致(补充:本机真跑的退出码,不是引用对方数字)。

    • pnpm exec tsc -b 0、pnpm lint 0、pnpm build 0(11.81s);dist/index.html 引用 /assets/index-*.js,base 仍是 /。
    • BillNote_frontend/src-tauri/ 不存在;BillNote_frontend/src、package.json、vite.config.ts 的 tauri 命中 0,node_modules/@tauri-apps 不存在,脚本只剩 dev/test/test:i18n/build/lint/preview。
    • EmberApp.tsx 仅 BrowserRouter(:2/:45),无 HashRouter / isTauri;vite.config.ts:14 版本读 package.json。
    • README「部署形态」已写明 Web + 扩展、桌面版移除;CHANGELOG 有对应破坏性变更条目。

    W7 仍然卡在同一个原因:并发 T-075 那轮还没收(mock.py PID 56608 仍活,docs/ui-audit/021/ 下 w7 产物仍全部 untracked,BillNote_extension/tsconfig.json 仍被改着)。我按上一条消息的 A 方案等调度裁决,本轮未改任何文件。

  9. El1mir commented on Nov 11, 2026

    @El1mir
    OwnerAuthor

    已开 PR #65

  10. El1mir commented on Nov 11, 2026

    @El1mir
    OwnerAuthor

    合并没完成(forge-error):读远程 PR 失败(http-403):http-403(已重试 1 次)

  11. El1mir commented on Nov 11, 2026

    @El1mir
    OwnerAuthor

    远程 PR #65 已合并(El1mir,commit 9ab77d9)。收口由系统按车道处理:自动车道的卡随 PR 结束,人车道的卡走正常收口。

  12. El1mir commented on Nov 11, 2026

    @El1mir
    OwnerAuthor

    PR #65 已在远程合并(commit 9ab77d9),本地卡收口为已完成。未关闭远程 PR。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions