Felis/docs/assets/icons/README.md

Felis 图标

基于参考图片手工临摹。矢量文件仅使用路径、形状、渐变和蒙版，没有嵌入位图。所有彩色导出均来自 ../felis-logo.svg。

文件	用途
../felis-logo.svg	1040 × 640 紧裁透明矢量原稿
../felis-logo.png	README 用图，保留现有 540 × 341 尺寸
felis-reference.svg / .png	保留参考图的 1254 × 1254 白底构图
felis-icon.svg	居中的方形透明图标
felis-app.svg / .png	浅绿圆角应用图标，1024 × 1024
felis-app-dark.svg / .png	深绿圆角应用图标，1024 × 1024
felis-maskable.svg / .png	不透明方形背景，猫脸位于中心安全圆内
felis-monochrome.svg	紧裁黑色单色版，眼睛和鼻子镂空
felis-mask.svg	方形单色版，供 Safari 固定标签使用
png/icon-{size}.png	透明图标：16、20、24、32、40、48、64、96、128、180、192、256、512、1024 px
felis.ico	Windows 多分辨率图标：16、24、32、48、64、128、256 px
felis.icns / felis.iconset/	macOS 图标及 16、32、128、256、512 pt 的 1× / 2× PNG
preview.png	图标套装预览

网页资源已放入 panel/public/，并由 panel/index.html 引用：SVG / ICO / PNG favicon、180 px Apple Touch Icon、Safari 固定标签图标，以及 192 / 512 px 普通和 maskable 图标。site.webmanifest 提供应用名称和图标元数据，不提供离线缓存。

网页通过 panel/src/assets/felis-logo.svg 引用白底圆角方形图标。桌面侧栏和手机导航使用 28 px，登录与初始化页头使用 44 px。它沿用套装中 felis-app.svg 的构图，将图标底色改为白色。构建时生成带内容哈希的文件名，重新导出会同步更新这个文件。

标签页图标单独向下偏移以对齐视觉中心，SVG、PNG、ICO 和 Safari 固定标签使用相同位置；应用图标保持原来的构图。仅重新导出标签页资源可给下方命令加上 --favicons-only。

修改矢量原稿后可重新导出；需要 Node.js 和 sharp，macOS 的 ICNS 导出还使用系统 iconutil。在仓库根目录运行：

NODE_PATH=/path/to/node_modules node scripts/generate-icons.cjs

NODE_PATH 指向已安装 sharp 的 node_modules。导出工具不会增加面板的运行依赖；非 macOS 平台仍会生成其余格式和 iconset。