{"id":50430534,"url":"https://github.com/xynrin/xynrin-fedora","last_synced_at":"2026-05-31T14:01:39.182Z","repository":{"id":356866627,"uuid":"1234369687","full_name":"Xynrin/xynrin-fedora","owner":"Xynrin","description":"我的 Fedora KDE 一键配置仓库：install.sh 幂等入口 + fish/vscode/kde 美化 + 国内镜像切换 + 中文维护手册","archived":false,"fork":false,"pushed_at":"2026-05-19T13:54:19.000Z","size":4734,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-19T16:39:32.959Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Xynrin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-10T05:03:53.000Z","updated_at":"2026-05-19T13:58:01.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Xynrin/xynrin-fedora","commit_stats":null,"previous_names":["xynrin/xynrin-fedora"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Xynrin/xynrin-fedora","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xynrin%2Fxynrin-fedora","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xynrin%2Fxynrin-fedora/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xynrin%2Fxynrin-fedora/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xynrin%2Fxynrin-fedora/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Xynrin","download_url":"https://codeload.github.com/Xynrin/xynrin-fedora/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xynrin%2Fxynrin-fedora/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33733754,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-31T02:00:06.040Z","response_time":95,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-05-31T14:01:37.612Z","updated_at":"2026-05-31T14:01:39.173Z","avatar_url":"https://github.com/Xynrin.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"![logo](images/logo.png)\n\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"https://readme-typing-svg.demolab.com?font=Fira+Code\u0026weight=600\u0026size=42\u0026duration=3500\u0026pause=600\u0026color=CBA6F7\u0026center=true\u0026vCenter=true\u0026width=600\u0026lines=xynrin-fedora;Fedora+44+KDE+%E4%B8%80%E9%94%AE%E7%BE%8E%E5%8C%96;%E5%B0%8F%E7%99%BD+%C2%B7+%E5%8F%8B%E5%A5%BD\" alt=\"title\" /\u003e\n\n**🌸 一条命令让 Fedora 44 KDE 变得好看、好用、带中文输入法 🌸**\n\n[![CI](https://github.com/Xynrin/xynrin-fedora/actions/workflows/ci.yml/badge.svg)](https://github.com/Xynrin/xynrin-fedora/actions/workflows/ci.yml)\n[![Release](https://github.com/Xynrin/xynrin-fedora/actions/workflows/release.yml/badge.svg)](https://github.com/Xynrin/xynrin-fedora/releases)\n![Fedora](https://img.shields.io/badge/Fedora-44-294172?logo=fedora\u0026logoColor=white)\n![Plasma](https://img.shields.io/badge/Plasma-6.x-1d99f3?logo=kde\u0026logoColor=white)\n![License](https://img.shields.io/badge/License-GPLv3-a6e3a1)\n![Shell](https://img.shields.io/badge/Shell-fish%20%2B%20bobthefish-cba6f7)\n\n[一键安装](#-一键安装) · [TUI 入口](#-tui-入口) · [模块清单](#-模块清单) · [日常命令](#-日常命令) · [常见问题](#-常见问题)  \n📖 [Wiki](https://github.com/Xynrin/xynrin-fedora/wiki) · 🐛 [Issues](https://github.com/Xynrin/xynrin-fedora/issues) · 📦 [Releases](https://github.com/Xynrin/xynrin-fedora/releases)\n\n\u003c/div\u003e\n\n---\n\n## ✨ 一键安装\n\n```bash\nbash \u003c(curl -fsSL https://raw.githubusercontent.com/Xynrin/xynrin-fedora/main/bootstrap.sh)\n```\n\n\u003e [!IMPORTANT]\n\u003e - 请用**普通用户**运行（不要 `sudo bash …`），脚本内部会按需申请 sudo 密码\n\u003e - 仅支持 **Fedora**（非 Fedora 系统会立即退出），推荐 **Fedora 44**\n\u003e - 全程 ~15 分钟，破坏性操作（如更换默认 shell）会先征求同意\n\u003e - 启动后会显示**免责声明**，需输入 `yes` 显式同意才会继续\n\n```mermaid\nflowchart LR\n    A[bootstrap.sh] --\u003e B[检测 Fedora]\n    B --\u003e|失败| X[退出]\n    B --\u003e|通过| C[基础依赖]\n    C --\u003e D[install.sh]\n    D --\u003e E[KDE 美化\u003cbr/\u003e3 套主题选 1]\n    E --\u003e F[fish + bobthefish\u003cbr/\u003e+ Nerd Fonts]\n    F --\u003e G[~/.local/bin\u003cbr/\u003eup + xynrin]\n    G --\u003e H[完成]\n    H --\u003e I[终端输入 xynrin\u003cbr/\u003e打开 TUI]\n```\n\n---\n\n## 🎨 KDE 美化方案（交互式三选一）\n\n| 编号 | 风格 | Plasma 主题 | 图标 | 光标 |\n|:---:|---|---|---|---|\n| **1** | 🌿 现代简约 | Layan | Tela | Bibata |\n| **2** | 🍬 绚丽多彩 | Sweet | Candy | Sweet |\n| **3** | 🌑 暗黑质感 | Orchis | Colloid | Nordic |\n\n安装时会列菜单，输入数字即可。SDDM 登录界面会同步换主题与背景。\n\n---\n\n## 🐠 Fish + bobthefish 圆角终端\n\n- 🐟 **fish** 安装并设为默认 shell（询问后再切，可拒）\n- 🪄 **fisher** + **bobthefish** 主题，原生圆角分段 + Nerd Font 图标\n- 🔤 **Nerd Fonts**：FiraCode / MesloLGS / JetBrainsMono 自动下载到 `~/.local/share/fonts`\n- 🚀 现代 CLI：eza / bat / zoxide / fzf / fastfetch / ripgrep / fd\n\n---\n\n## 🏠 TUI 入口\n\n部署完成后终端输入：\n\n```bash\nxynrin\n```\n\n弹出 fzf 驱动的 TUI，左列菜单 / 右列说明：\n\n| 菜单 | 作用 |\n|---|---|\n| 系统更新 | 调用 `up` 一键更新 dnf + flatpak + 清理 |\n| 软件安装 | 从 applist fzf 多选，dnf/flatpak 自动分流 |\n| 美化切换 | 重选 KDE 主题方案 |\n| 美化卸载 | 卸载主题包，恢复 Breeze |\n| 恢复初始 | 从 `~/.config/.xynrin-backup` 还原最近备份 |\n| 系统信息 | OS / 内核 / Plasma / GPU / 包数量摘要 |\n| 命令速查 | 浏览所有 `xf-*` 命令文档 |\n\n横幅由 [oh-my-logo](https://github.com/shinshin86/oh-my-logo) 在安装时生成并缓存到 `~/.config/xynrin-fedora/banner.ansi`，无 npx 时自动回落 ASCII 图形。\n\n---\n\n## 📦 模块清单\n\n| 模块 | 默认 | 做什么 |\n|------|:---:|------|\n| **`repos`** | ✅ 必跑 | 启用 RPM Fusion free / nonfree + Flathub |\n| **`kde-theme`** | ✅ | 3 套主题方案选 1，含 SDDM |\n| **`fonts-cjk`** | ✅ | Noto CJK + JetBrains Mono + fcitx5 拼音 |\n| **`terminal`** | ✅ | fish + bobthefish + Nerd Fonts + ~/.local/bin |\n| **`apps`** | ✅ | 浏览器 / 音视频 / 办公 / 通讯 |\n| **`gpu`** | ✅ | NVIDIA akmod / AMD mesa-freeworld / Intel VAAPI |\n| **`cleanup`** | ✅ 兜底 | 隐藏开发工具图标，桌面投放使用说明 |\n\n---\n\n## 🛠️ 日常命令\n\n| 命令 | 一句话 |\n|------|------|\n| **`xynrin`** | 打开 TUI 主入口（fzf 菜单） |\n| **`up`** | 一键更新：dnf + flatpak + 清理（小白友好彩色 UI） |\n| **`xf-help`** | fzf 驱动的命令速查 TUI |\n| **`xf-self-update`** | 拉最新仓库重新部署 |\n| **`xf-update`** | 进阶版更新（含 fwupdmgr 固件） |\n| **`xf-clean`** | 深度清理：autoremove + journal + flatpak unused |\n| **`xf-info`** | 系统状态摘要（贴 issue 用） |\n| **`xf-theme dark\\|light`** | 命令行切 KDE + GTK 主题 |\n\n完整文档：[`docs/COMMANDS.md`](docs/COMMANDS.md)\n\n---\n\n## 🚀 install.sh 命令参考\n\n```bash\n./install.sh                   # 弹 FZF 菜单（默认全选）\n./install.sh --all             # 跳菜单，全装，所有 confirm 走默认\n./install.sh --only apps       # 只装某个模块（逗号分隔可多个）\n./install.sh --only kde-theme,fonts-cjk\n./install.sh --dry-run         # 只预览，不真动\n```\n\n**环境变量**\n\n| 变量 | 默认 | 作用 |\n|---|---|---|\n| `XF_DOTFILES_FORCE` | `1` | dotfiles 强刷 + 备份；设 `0` 保留宿主机已有配置 |\n| `XF_BACKUP_DIR` | `~/.config/.xynrin-backup` | 备份目录 |\n| `XF_SKIP_CN_MIRROR` | `0` | 设 `1` 跳过 TUNA 镜像切换（境外用户） |\n| `XF_NONINTERACTIVE` | `0` | `--all` 自动设 `1`，跳过所有 confirm |\n| `XF_AGREE` | `0` | 设 `1` 跳过免责声明确认（自动化场景） |\n\n---\n\n## ✅ 系统要求\n\n- **Fedora 44** KDE Spin（41+ 兼容，但以 44 为基线）\n- 普通用户（UID ≥ 1000），不能用 root 直接跑\n- x86_64 / aarch64\n\n---\n\n## ❓ 常见问题\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e注销重登后输入法没反应\u003c/b\u003e\u003c/summary\u003e\n\n```bash\npgrep -u $USER fcitx5 || setsid fcitx5 -d \u0026\n```\n\n不行就：系统设置 → 自启动 → 添加 `fcitx5`，再重启一次。\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003efish 装上但没图标 / 颜色\u003c/b\u003e\u003c/summary\u003e\n\n99% 是字体没装好或终端字体没切到 Nerd Font。\n\n1. 检查字体：`fc-list | grep -i nerd`\n2. 终端（Konsole）→ 设置 → 编辑当前配置 → 外观 → 选择字体改为 `FiraCode Nerd Font` 或 `MesloLGS NF`\n3. 仍不行：`xf-self-update` 强刷配置\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eKDE 主题没换\u003c/b\u003e\u003c/summary\u003e\n\n```bash\n# TUI 里走\"美化切换\"重选一次\nxynrin\n\n# 或者命令行\nsetsid plasmashell --replace \u0026\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e默认 shell 换 fish 后想换回 bash\u003c/b\u003e\u003c/summary\u003e\n\n```bash\nchsh -s /bin/bash\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e装失败的软件在哪看\u003c/b\u003e\u003c/summary\u003e\n\n```\n~/Documents/xynrin-fedora-install-failed.txt\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e安装日志\u003c/b\u003e\u003c/summary\u003e\n\n```\n/tmp/xynrin-fedora-install.log\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e想回滚 dotfiles\u003c/b\u003e\u003c/summary\u003e\n\n打开 TUI → 恢复初始（仅适用于美化后没装其他软件的场景）\n\n或手动：\n\n```bash\nls ~/.config/.xynrin-backup/\ntar -xzf ~/.config/.xynrin-backup/plasma-*.tar.gz -C ~/.config/\n```\n\u003c/details\u003e\n\n---\n\n## 🎨 自定义\n\n| 想改 | 改哪里 |\n|---|---|\n| 加/减软件 | `applist-kde.txt` / `applist-common.txt` |\n| 加 KDE 主题方案 | `scripts/20-kde-theme.sh` 中 `THEME_OPTIONS` 数组 |\n| fish 别名 / 缩写 | `kde-dotfiles/.config/fish/conf.d/*.fish` |\n| 添加 fish 函数 | `kde-dotfiles/.config/fish/functions/\u003cname\u003e.fish` |\n| bobthefish 配色 | `kde-dotfiles/.config/fish/config.fish` 中 `theme_color_scheme` |\n| 加 `xf-*` 工具 | `kde-dotfiles/.local/bin/\u003cname\u003e` |\n| TUI 菜单项 | `kde-dotfiles/.local/bin/xynrin` 中 `MENU` 数组 |\n\n---\n\n## 📁 仓库结构\n\n```\nxynrin-fedora/\n├── install.sh                    # 主入口（7 步流程）\n├── bootstrap.sh                  # 在线引导（严格 Fedora 检测）\n├── VERSION                       # 版本号（release 时与 tag 校验）\n├── applist-{common,kde}.txt      # 软件清单\n├── docs/COMMANDS.md              # 命令速查文档\n├── .github/workflows/\n│   ├── ci.yml                    # ShellCheck + Fedora dry-run\n│   └── release.yml               # tag 触发，多架构打包发布\n├── scripts/\n│   ├── 00-utils.sh               # 公共工具\n│   ├── 10-repos.sh               # RPM Fusion + Flathub\n│   ├── 15-cn-mirror.sh           # TUNA 镜像（仅 CN）\n│   ├── 20-kde-theme.sh           # 3 套主题方案选择\n│   ├── 30-fonts-cjk.sh           # 中文字体 + fcitx5\n│   ├── 40-terminal.sh            # fish + bobthefish + Nerd Fonts\n│   ├── 50-apps.sh                # FZF 多选装软件\n│   ├── 60-gpu.sh                 # 显卡驱动\n│   └── 90-cleanup.sh             # 收尾\n└── kde-dotfiles/\n    ├── .config/                  # fish / starship / fastfetch / fcitx5...\n    └── .local/bin/               # xynrin / up / xf-* 工具\n```\n\n---\n\n## 📜 License\n\n[GPL-v3](LICENSE)  ·  作者 **Xynrin** `\u003cxynrin@163.com\u003e`\n\n\u003cdiv align=\"center\"\u003e\n\n如果对你有用，给个 ⭐ 鼓励一下\n\n\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxynrin%2Fxynrin-fedora","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxynrin%2Fxynrin-fedora","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxynrin%2Fxynrin-fedora/lists"}