# @aphrody/m3-os-themes 中文文档

规范地址：https://npmcn.com/package/%40aphrody/m3-os-themes/

版本：1\.4\.7
npm 元数据更新时间：2026-10-23T03:51:46.524Z
中文译文更新时间：2026-11-08T00:11:26.299Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40aphrody/m3-os-themes
原文对照：https://npmcn.com/package/%40aphrody/m3-os-themes/?lang=original
项目主页：https://github.com/aphrody-labs/bun-distribution/tree/os/packages/m3-os-themes#readme
源码仓库：https://github.com/aphrody-labs/bun-distribution

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：71.8 kB，13 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2026-10-05T08:05:00.933Z
- 最新版本发布：2026-10-23T03:51:46.339Z
- 近 30 天下载量：1961（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：8（近 12 个月 8 个）

## 中文简介

材质3 OS主题发电机和安装器(Windows 11,GNOME Shell,COSMIC,Chromium浏览器)由@aphody/m3-tokens动态色彩角色所衍生出.

## 安装

```sh
npm install @aphrody/m3-os-themes
```

也可以使用：`pnpm add @aphrody/m3-os-themes`、`yarn add @aphrody/m3-os-themes`、`bun add @aphrody/m3-os-themes`

## README

# @aphrody/m3-os-主题

从种子颜色生成并安装材质 3 OS 主题( Windows 11, GNOME Shell, COSMIC, Chromium 浏览器),其颜色角色为 `@aphrody/m3-tokens/dynamic-color`。 。 。 .

```sh
bun add -d @aphrody/m3-os-themes
```

```sh
bunx --bun m3-os-themes generate --target all --seed '#6750a4' --mode auto --out ./m3-os-themes-out
```

许可证: Apache-2.0(`LICENSE`) (中文(简体) ). 安装指南 : [文件/材料/立方米/INSTALL.md](https://github.com/aphrody-labs/bun-distribution/blob/os/docs/material/m3/INSTALL.md)。 。 。 .

全部使用( 在 Aphrody 检查中) `yolo m3 os-themes` 采用相同的参数:

```sh
m3-os-themes <install|generate|uninstall> \
  --target windows|gnome|cosmic|chromium|all --seed '#6750a4' --mode light|dark|auto \
  [--name Aphrody] [--variant tonalSpot] [--out dir] [--icons dir] [--dry-run] [--apply]
```

-   `generate` 仅写入 `--out` (默认) `./m3-os-themes-out`) (中文(简体) ).
-   `--icons <dir>` (GNOME和COSMIC)还安装了免费桌面图标主题 `~/.local/share/icons` 财务报告和审定财务报表 选择它( 设置) `icon-theme`; COSMIC 系统 `com.system76.CosmicTk/v1/icon_theme`(三); `--uninstall` 恢复 上一个图标主题。 构建完整的材料符号主题 `bun packages/material-design-icons/scripts/export-theme.ts --out dist/icons`,然后通过 `--icons dist/icons/freedesktop/Aphrody-M3`。 。 。 .
-   `install` 财务报告和审定财务报表 `uninstall` 除非 `--apply` 给出. `--apply` 生成文件,然后为主机OS运行目标脚本.

| 目标 | 艺术品 | 安装器 |
| --- | --- | --- |
| 窗口 | `M3-<name>-{light,dark}.theme`,壁纸,登记值(`Themes\Personalize` `AppsUseLightTheme`编号 :`SystemUsesLightTheme`编号 :`ColorPrevalence`, DWM 系统 `AccentColor`编号 :`ColorizationColor`, (中文(简体) ), `Explorer\Accent`(中文(简体) ) | `install-windows.ps1` (第一次拍摄时的镜头), `-Uninstall` 恢复, `-WhatIf`(中文(简体) ) |
| 小精灵 | `~/.local/share/themes/M3-<name>/{gnome-shell,gtk-3.0,gtk-4.0}` 医务科, `~/.config/gtk-4.0/gtk.css` | `install-gnome.sh` (设定:gtk主题、色彩方案、口音颜色、用户主题; `--uninstall`(中文(简体) ) |
| 宇宙间 | 宇宙主题 `~/.config/cosmic/com.system76.CosmicTheme.{Dark,Light}.Builder/v1/` 财务报告和审定财务报表 `M3-<name>-<mode>.ron` | `install-cosmic.sh` (枪声, `--uninstall`(中文(简体) ) |
| 铬 | MV3主题 `{light,dark}/manifest.json` + 图像, `BrowserThemeColor` 政策JSON和 `.reg` 克罗姆、边缘、勇敢、克罗姆 | `install-chromium.sh`, (中文(简体) ), `install-chromium.md` (无包装) |

测试生成存储器或临时目录中的所有内容, 并且绝不触及系统 : `bun test test/`。COSMIC 密钥布局和 GNOME 壳牌选择器遵循上游格式和 未在COSMIC或GNOME现场会议上行使.

待定(工作项目C1):一次Bun分叉船 `bun:cosmic` (宇宙-配置读取/写出),替换手写 宇宙配置写入 `src/cosmic.ts`编号 :`install-cosmic.sh` 通过它验证密钥。 同一候选人 粗口:手卷起的 `.desktop` 解析器在 `crates/ui/drive/src/file_opening/linux.rs` 页:1 `freedesktop-desktop-entry`) (中文(简体) ).

## 常见问题

### @aphrody/m3-os-themes 是什么？

材质3 OS主题发电机和安装器\(Windows 11,GNOME Shell,COSMIC,Chromium浏览器\)由@aphody/m3-tokens动态色彩角色所衍生出\.

### 如何安装 @aphrody/m3-os-themes？

在项目目录运行 npm install @aphrody/m3-os-themes，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 m3-os-themes，可以用 npx m3-os-themes 直接运行。

### @aphrody/m3-os-themes 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @aphrody/m3-os-themes 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @aphrody/m3-os-themes 可以商用吗？

@aphrody/m3-os-themes 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @aphrody/m3-os-themes 的下载量有多少？

根据 npm 官方下载统计，@aphrody/m3-os-themes 在 2026/10/06 – 2026/11/04 这 30 天内被下载 1,961 次，日均约 65 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @aphrody/m3-os-themes 还在维护吗？

最新版本 1\.4\.7 发布于 2026/10/23（16 天前）；至今共发布 8 个版本，其中过去 12 个月发布了 8 个；首次发布于 2026/10/05。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。