8000 feat: 界面图标描边从 1.75 统一为 2 by qqqqqf-q · Pull Request #1648 · felinics/Memoh · GitHub
[go: up one dir, main page]

Skip to content

feat: 界面图标描边从 1.75 统一为 2 - #1648

Draft
qqqqqf-q wants to merge 2 commits into
felinics:mainfrom
qqqqqf-q:feat/memoh-212-icon-stroke-2
Draft

qqqqqf-q wants to merge 2 commits into
felinics:mainfrom
qqqqqf-q:feat/memoh-212-icon-stroke-2

Conversation

@qqqqqf-q
@qqqqqf-q qqqqqf-q commented Oct 22, 2026 •
Copy link
Copy Markdown
Member

Author

  • Human
  • Agent

Type

  • bug
  • feat
  • test

Summary

这是有意做的设计调整,不是 lint 或类型修复顺手带上的改动。 描边值由人工在整站 1.75 / 2 对照预览后决定;#1640(Web 类型检查清零)没有改动任何图标描边。

问题:界面图标同时有两种描边。#1177 建立的图标层 @memohai/icon/ui 用 withUiStroke 把描边设为 1.75,apps/web 另有 14 处手写 :stroke-width="1.75" 跟随;其余约 200 个直接使用 lucide 的文件是默认的 2。同一个侧栏、同一个菜单里两种粗细并存:改动前,聊天页有 13 个图标是 1.75、109 个是 2,设置页是 23 个对 112 个。

为什么选 2:用 Inter 的实测竖笔粗细换算图标的理想描边(理想描边 = 文字竖笔 × 24 ÷ 图标尺寸):

位置 文字 图标 理想描边 更贴近
按钮、横幅标题 14px / 450 16px 2.06 2
设置页导航 14px / 430 16px 1.97 2
主侧栏 14px / 450 18px 1.83 1.75
下拉菜单 14px / 360 16px 1.67 1.75
输入框下方一行、字段报错 13px / 360 14px 1.77 1.75

两者整体接近持平:2 贴合最常见的按钮和导航组合,1.75 贴合 360 字重的文字。最终选 2,还因为它与 Lucide 当前默认一致,迁移成本较低。但图标标准不由第三方默认值代管:本次由图标层自己导出并读取描边变量,未来调整时有明确的工程入口。

改动

  • packages/icons/src/ui/index.ts:导出 uiIconStrokeWidth = 2,所有图标层导出通过 withUiStroke 读取它,不再把设计标准寄托在 Lucide 默认值上。
    • ShortcutIcon 的箭头头部按共享变量的 8/7 计算,当前为 2.29,保持头部略重于箭杆。
    • ErrorIcon 也经过共享入口;其内部填充几何按当前描边 2 调整,若以后改变变量需重新校准。
  • apps/web:删除 14 处 :stroke-width="1.75",删除侧栏 Search 重复的 :stroke-width="2";check-draw、share、fork-split、appearance 四个自绘线框图标的默认描边改为引用 uiIconStrokeWidth。
  • packages/icons/README.md:明确笔画由 uiIconStrokeWidth 统一决定;写明输入框下方的会话控件行(Computer、Folder、Agent、Permission)使用 variant="quiet",只变文字颜色,不使用 ghost 底色。
  • apps/web/src/lib/ui-icon-contract.test.ts:描边断言读取共享变量;新增一项检查,要求直接导入的 Lucide 图标的内置默认值等于该变量(lucide-vue-next 0.562 无法全局设置默认值);quiet 文字触发器不再被要求额外设置 tone="muted",因为 quiet 本身就是 muted-foreground 起步、hover 变 foreground。

配套 PR 与不在本 PR

  • felinics/ui 的 3 组生产组件(子菜单指示、CopyButton、Toaster)由 felinics/ui#39 删除 1.75 覆盖,Linear 为 MEMOH-227。本 PR 当前不改变 packages/ui gitlink;合并顺序为 ui#39 → 更新本 PR 的子模块指针并复验 → 本 PR。
  • felinics/ui showcase 和 ui-owners skill 中的 1.75 说明不在 ui#39 的最小改动范围内;模型选择下拉箭头的 1.5 也不在本 PR。
  • 直接从 lucide-vue-next 导入的其它图标仍取 Lucide 内置默认值,目前由契约测试检查它与 uiIconStrokeWidth 一致;@lucide/vue 迁移不在本 PR。

Related Issues

Validation

自动检查(Agent 已执行)

  • apps/web/src/lib/ui-icon-contract.test.ts:main 上原有 2 项失败,本分支现在 3 项通过(含直接 Lucide 描边一致性检查)。
  • 改动组件相关的测试(sidebar、settings-sidebar、mobile-bar、main-section、bots 和图标契约):43 个文件、250 项全部通过。
  • node scripts/check-ui-contract.mjs:通过,保留 3 个既有 warning。
  • 改动文件的 ESLint、pnpm --filter @memohai/web typecheck(vue-tsc):均通过。
  • feat: 组件图标描边统一为 2 ui#39 的 pnpm type-check、pnpm build:均通过。

实际界面

宿主机 vite 指向本地 dev 后端。在同一地址 http://127.0.0.1:8212 先后运行 main 和本分支,登录态和界面状态相同;深色主题,1440×900,DPR 2。依次打开 Bot 聊天页、输入框 + 菜单和设置页,统计页面上的 svg[stroke-width]:

页面 main(1.75 / 2) 本分支当前 head(1.75 / 2)
聊天页 13 / 109 0 / 122
聊天页,打开输入框 + 菜单 16 / 109 1 / 124(子菜单箭头,由 ui#39 处理)
设置页 23 / 112 0 / 135

未覆盖

  • 未跑 web Vitest 全量:CI 目前只跑指定的几个测试文件,main 上另有与本改动无关的失败用例。
  • 未在 Desktop 和移动端布局下截图。mobile-top-bar、mobile-nav-sheet、mobile-bar 三处只删除了描边属性。
  • ui#39 合并并更新 gitlink 后,需要重新截取菜单并复核 CopyButton、Toaster。

Screenshots / Recordings

截图取自上述实际运行的界面,左(或上)为 main,右(或下)为本分支变量版。

1. 侧栏:Chat / Files / Schedule / Apps 页签,以及 New Session、Bot Settings 图标。

侧栏前后对比

2. 设置页导航,包括 Keyboard Shortcuts 的 ShortcutIcon。

设置页导航前后对比

3. 输入框:+ 按钮,以及下方 Cloud Computer、Folder、Agent 文字触发器。

输入框前后对比

4. 输入框 + 菜单:Upload、Apps 图标;当前 head 的 Apps 行尾子菜单箭头仍是 1.75,由 ui#39 处理。

输入框加号菜单前后对比

Human QA

  • Human QA passed

图标层 withUiStroke 把描边设为 1.75,apps/web 另有 14 处手写钉值跟随,
而直接使用 lucide 的界面仍是默认 2,同一菜单、同一侧栏里两种粗细混用。
对比整站 1.75 / 2 预览后定为 2:移除 withUiStroke 与全部 1.75 钉值,
图标层沿用 lucide 默认描边。

- ShortcutIcon 箭头头部按原 1.75 : 2 的比例改为 2 : 2.29。
- ErrorIcon 不再是例外,删除对应说明。
- README 写明笔画标准为 2,并记录输入框下方会话控件行使用 quiet。
- ui-icon-contract.test.ts 描边断言改为 2,quiet 文字触发器不要求 tone="muted"。
@github-actions github-actions Bot added change:web Changes web frontend or shared frontend packages feat Adds or improves functionality size:XS PR size uses the larger of added or deleted lines, excluding generated files needs:format Description needs template corrections; removed automatically once fixed labels Oct 22, 2026
@github-actions
github-actions Bot commented Oct 22, 2026 •
Copy link
Copy Markdown
Contributor

Format check passed; removed needs:format.

图标层导出 uiIconStrokeWidth = 2,所有图标层导出和自绘线框图标读取它,不把设计决策寄托在 Lucide 默认值上。

保留 withUiStroke 作为统一入口,ShortcutIcon 箭头头部按共享变量的 8/7 计算;删除 apps/web 剩余的 1.75 钉值和 Search 的重复 2 钉值。

契约测试改为读取共享变量,并覆盖直接导入 Lucide 图标时的默认描边一致性。
@github-actions github-actions Bot removed the needs:format Description needs template corrections; removed automatically once fixed label Oct 23, 2026

This branch has not been deployed

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

Labels

change:web Changes web frontend or shared frontend packages feat Adds or improves functionality size:XS PR size uses the larger of added or deleted lines, excluding generated files

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

0