chrome-extension-ui 是一套针对 Chrome 扩展（Chrome Extensions）的 UX/UI 设计与实现指南，优化目标为 Manifest V3。该指南包含 42 条规则，分布在 8 个类别中，并按影响程度划分优先级，用于指导扩展 UI 的开发与代码审查。
用途 该指南用于在构建 Chrome 扩展用户界面时提供设计参考，帮助开发者在弹窗（popup）、侧边栏（side panel）、内容脚本（content script）UI 之间做出选择，并实现可访问、支持键盘导航的界面，同时设计加载状态、错误处理与反馈模式，以及创建选项页和设置持久化。
主要能力（规则类别） 规则按优先级分为以下类别：
- 组件选择（Component Selection，CRITICAL）：包括 comp-popup-vs-sidepanel（持久任务选择侧边栏）、comp-content-script-ui（页面内 UI 使用内容脚本）、comp-single-purpose（为单一用途设计）、comp-minimal-permissions（请求最小权限）、comp-action-tooltip（提供描述性操作提示）。
- 无障碍与导航（Accessibility & Navigation，CRITICAL）：包括 access-keyboard-navigation（完整键盘导航）、access-focus-visible（保持可见焦点指示）、access-aria-labels（图标按钮使用 ARIA 标签）、access-color-contrast（确保足够颜色对比度）、access-focus-trap（避免键盘焦点陷阱）、access-semantic-html（使用语义化 HTML 元素）。
- 弹窗设计（Popup Design，HIGH）：包括 popup-size-constraints（在弹窗尺寸限制内设计）、popup-instant-render（即时渲染弹窗内容）、popup-primary-action（突出主要操作）、popup-auto-close（优雅处理弹窗自动关闭）、popup-external-js（JavaScript 放在外部文件）、popup-dynamic-switch（基于状态使用动态弹窗）。
- 侧边栏体验（Side Panel UX，HIGH）：包括 panel-non-distracting（设计不干扰的侧边栏）、panel-tab-vs-window（选择标签页级还是窗口级面板）、panel-responsive-width（适应可变面板宽度）、panel-page-context（面板内容与页面上下文同步）、panel-lazy-sections（懒加载面板区块）。
- 内容脚本 UI（Content Script UI，MEDIUM-HIGH）：包括 inject-shadow-dom（使用 Shadow DOM 隔离样式）、inject-z-index（覆盖层使用最大 Z-Index）、inject-document-ready（DOM 就绪后注入 UI）、inject-unique-ids（使用唯一 ID 防止冲突）、inject-cleanup（移除时清理注入元素）。
- 视觉反馈（Visual Feedback，MEDIUM）：包括 feedback-loading-states（异步操作显示加载状态）、feedback-error-messages（编写可操作的错误消息）、feedback-badge-status（使用徽章显示概览状态）、feedback-success-confirmation（确认成功操作）、feedback-notifications（谨慎使用通知）、feedback-progress-indication（长时间操作显示进度）。
- 选项与设置（Options & Settings，MEDIUM）：包括 options-embedded-page（简单设置使用嵌入式选项页）、options-sync-storage（跨设备同步设置）、options-auto-save（更改时自动保存设置）、options-sensible-defaults（提供合理默认设置）。
- 图标与品牌（Icons & Branding，LOW-MEDIUM）：包括 brand-icon-sizes（提供所有必需图标尺寸）、brand-distinctive-icon（设计独特的工具栏图标）、brand-badge-text（徽章文本不超过 4 个字符）、brand-consistent-styling（保持一致的视觉风格）、brand-web-store-assets（创建高质量应用商店素材）。
使用方式 该指南建议阅读各个参考文件以获取详细说明和代码示例，包括：章节定义（类别结构与影响级别）、规则模板（添加新规则的模板）。参考文件包括：references/_sections.md（类别定义与排序）、assets/templates/_template.md（新规则模板）、metadata.json（版本与参考信息）。
适用场景 适用于构建新的 Chrome 扩展用户界面、在弹窗/侧边栏/内容脚本 UI 之间做选择、实现可访问且支持键盘导航的界面、设计加载状态与错误处理及反馈模式、创建选项页与设置持久化。
限制 资料未提供具体安装命令、收费信息、价格、平台支持范围或实际使用效果数据，这些内容暂未提供。