chthollyphilechthollyphile/folia-major/AGENTS.md

folia-major

AGENTS.md11k starsChanged 3 months agoAGPL-3.0View on GitHub

本仓库的项目规则按 skill 组织。这里放整个项目统一的开发规范和 skill 索引，细节在各 skill 里。改代码的任务（文档、文案、简单修复和发版准备除外）按 development-workflow 走到交付：每次修改都自检；一个 PR 或完整功能做完时（不是每次提交或修改）派独立子代理审查，逐条核实再修复。算不算简单修复，读这个 skill 的“什么时候审查”一节判断（碰了时序、持久化、平台接口、依赖版本、凭据、热路径的都不算），拿不准就走完整流程。不要主动移除项目中的注释，也不要在没有明确指令的情况下修改、删除或翻译 @note 注释。新建文件时，在导入行结束后写一行注释说明这个文件；复杂的函数写一句注释说明它做什么。项目内置了开发者日志系统，需要打日志时直接用它，不要另造：console.log / info / warn / error，行首写 [模块名]。渲染进程和主进程的行都在应用内“设置 → 开发者”的面板里可见（“运行日志”开关）；再打开其下的“写入本地文件”，还会写入 `logs/r

Reads credentials

Create a free account to mount

Aug 28, 2026灯音詩行丨願你的世界，永遠有繽紛色彩🌈 #初見歡迎 #降落歡迎【灯理Akari🍫丨Scintillating Songlines #72】 — Akari Ch. 灯理【DreamCity所屬】8.4k views · 16 comments
Sep 26, 2026灯音詩行丨突突突突突一會，就一會，真的！ #初見歡迎 #降落歡迎【灯理Akari🍫丨Scintillating Songlines #77】 — Akari Ch. 灯理【DreamCity所屬】6.8k views · 17 comments
Sep 17, 2026灯音詩行丨客官今天想聽點什麼~可點歌唷 #初見歡迎 #降落歡迎【灯理Akari🍫丨Scintillating Songlines #75】 — Akari Ch. 灯理【DreamCity所屬】4.8k views · 10 comments
Aug 30, 2026灯間晨話丨工作陪伴雜談～事情總會一點一點一點一點一點做完的(ง •_•)ง #初見歡迎 #降落歡迎【灯理Akari🍫丨Daylight Chats #15】 — Akari Ch. 灯理【DreamCity所屬】4.1k views · 1 comment
Sep 12, 2026燕雲十六聲丨續攤陪我玩燕雲十六聲，初見不見山！ #初見歡迎 #降落歡迎【灯理Akari🍫丨Where Winds Meet #2】 — Akari Ch. 灯理【DreamCity所屬】3.8k views · 9 comments

19 more on YouTube

Oct 10, 2026燕雲十六聲丨燕一下！也可以來跟我隨便聊天ouo #初見歡迎 #降落歡迎【灯理Akari🍫丨Where Winds Meet #3】 — Akari Ch. 灯理【DreamCity所屬】3.2k views · 5 comments
Sep 22, 2026灯語書屋丨日本語朗讀《銀河鐵道の夜》——在星河盡頭，尋找「真正的幸福」 #初見歡迎 #降落歡迎【灯理Akari🍫丨Glowing Galleries #15】 — Akari Ch. 灯理【DreamCity所屬】2.7k views · 9 comments
Sep 1, 2026TOEM丨好療愈的感覺(‾◡◝)一場相片冒險！📸 #初見歡迎 #降落歡迎【灯理Akari🍫丨TOEM #1】 — Akari Ch. 灯理【DreamCity所屬】2.4k views · 2 comments
Sep 4, 2026燕雲十六聲丨續攤陪我玩燕雲【灯理Akari🍫丨Where Winds Meet #1】 — Akari Ch. 灯理【DreamCity所屬】2.1k views · 4 comments
Sep 8, 2026TOEM丨喀嚓喀嚓相片冒險📸！怎麼第二部還沒賣RRRR #初見歡迎 #降落歡迎【灯理Akari🍫丨TOEM #2】 — Akari Ch. 灯理【DreamCity所屬】1.6k views · 5 comments
Oct 26, 2026What If Every Song Had A Lyric Video 😯 — LinoDev1.1k views
Sep 5, 2026Shift At Midnight丨和嘟比CB的恐怖夜班生存挑戰！ #初見歡迎 #降落歡迎【灯理Akari🍫】 — Akari Ch. 灯理【DreamCity所屬】1.1k views · 2 comments
Oct 11, 2026Folia: Живые тексты песен на весь экран #shorts — Синтез718 views
Oct 18, 2026folia-major 自架歌詞播放器：用 Docker 部署自己的沉浸式聽歌頁 — GitCovery632 views
Jul 6, 2026GitHub 开源音乐播放神器！Folia：把歌词变成艺术品的沉浸式音乐播放器 | 每一帧都能当壁纸 — 艾先生科技说545 views
Aug 11, 2026盛世天下丨大結局！從才人到九五之尊，今晚見證傳奇落幕 🌸 #初見歡迎 #降落歡迎【灯理Akari🍫丨盛世天下 #7】 — Akari Ch. 灯理【DreamCity所屬】398 views · 5 comments
Jul 5, 2026가사가 예술이 되는 음악 플레이어 Folia — Repocast | GitHub 일일 브리핑253 views · 1 comment
Oct 18, 2026塞壬唱片-MSR - Radiant — Lumi208 views
Jul 5, 2026GitHub - chthollyphile/folia-major: 专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方网易云播放器 — GitHub Daily Trend AI Podcast116 views
Oct 19, 2026Folia: Free Animated Lyrics Player. Lyrics, but Cinematic — ITG Now95 views
Jul 5, 2026chthollyphile/folia-major - Gource visualisation — Gourcer30 views
Oct 9, 2026أداة folia-major: مشغل الموسيقى الذي يحيّي كلماتك #Shorts — Manea Alblooshi18 views · 1 comment
Oct 14, 2026Folia Lyric Stage | ClawFactory Night Shift — Trollefsen Labs9 views
Jul 5, 2026Сеньор — это не стаж. Это 7 репозиториев в арсенале · meetily Rust GitHub #Shorts — GitHub Находки4 views

On GitHub · 24

Oct 28, 2026chore(folia): bump to v0.7.23 — appflare/catalog0 reactions
Oct 26, 2026Upstream v0.7.22: adaptation merge required — Leeacc/folia-dilink-android0 reactions
Oct 24, 2026chore(folia): bump to v0.7.22 — appflare/catalog0 reactions
Oct 24, 2026同步上游 — azkbzxf/spw-folia0 reactions
Oct 19, 2026Upstream v0.7.21: adaptation merge required — Leeacc/folia-dilink-android0 reactions

19 more on GitHub

Oct 19, 2026[Feature] Add Folia Music Player to the App Store — 1Panel-dev/1Panel0 reactions · 1 comment
Oct 18, 2026perf(i18n): 去掉 flattenLocale 启动时的重复拷贝 — MaybeJustLikeThis/folia-major0 reactions
Oct 18, 2026chore(folia): bump to v0.7.21 — appflare/catalog0 reactions
Oct 16, 2026chore(folia): bump to v0.7.20 — appflare/catalog0 reactions
Oct 14, 2026chore(folia): bump to v0.7.19 — appflare/catalog0 reactions
Oct 12, 2026chore(folia): bump to v0.7.18 — appflare/catalog0 reactions
Oct 11, 2026chore(folia): bump to v0.7.17 — appflare/catalog0 reactions
Oct 10, 2026应用top.izuna.foliamajor，mpris无法启用以及在KDE下任务栏预览无法显示媒体控制按钮 — flatpark/flatpark0 reactions · 3 comments
Oct 9, 2026chore(folia): bump to v0.7.16 — appflare/catalog0 reactions
Oct 8, 2026chore(folia): bump to v0.7.15 — appflare/catalog0 reactions
Oct 8, 2026folia-major: 0.7.9 -> 0.7.15 — NixOS/nixpkgs0 reactions · 2 comments
Oct 5, 2026chore(folia): bump to v0.7.13 — appflare/catalog0 reactions
Oct 2, 2026chore(folia): bump to v0.7.12 — appflare/catalog0 reactions · 2 comments
Sep 30, 2026chore(folia): bump to v0.7.11 — appflare/catalog0 reactions · 1 comment
Sep 27, 2026folia-major: 0.7.7 -> 0.7.9 — NixOS/nixpkgs0 reactions · 2 comments
Sep 26, 2026feat: enable PCM24 and PCM32 encoding for Folia audio output — chthollyphile/folia-ffmpeg-build0 reactions · 1 comment
Sep 17, 2026folia-major: 0.7.4 -> 0.7.7 — NixOS/nixpkgs0 reactions · 2 comments
Aug 18, 2026[Bug]: 使用Folia播放器切歌情况下无法正常识别歌曲信息 — Fervent-Tempo/AF-Media-Bar0 reactions · 4 comments
Aug 9, 2026fix: 隔离 legacy 请求的 Axios 默认配置 — yakult-green-tea/qq-music-api0 reactions

On the web · 7

Oct 18, 2026Folia 独家深度评测：从多源音乐聚合到全屏沉浸式歌词动画的工程重构 · musen · AI 解读站 — musen-ai.com
Oct 18, 2026Deep Dive into Folia: Engineering the Immersive Lyrics and Multi-Source Audio Engine · musen AI Academy — musen-ai.com
Oct 8, 2026Folia: An Open-Source Music Player Built Around Full-Screen Lyric Animations · Zendot — zendot.org
Jul 12, 2026Folia - Folia Major 开源音乐播放器｜自带绚丽动态歌词｜AI 自定义歌曲视觉主题｜兼容 Navidrome / 网易云 / 本地无损音乐 - 格律诗的软件世界 — jamecling.com
Jul 6, 2026周一上线：被 Claude 封号算工伤吗？贾扬清据报离开 NVIDIA，Cursor 推出 iOS 版-CSDN博客 — blog.csdn.net

2 more on the web

Jul 6, 2026周一上线：被 Claude 封号算工伤吗？贾扬清据报离开 NVIDIA，Cursor 推出 iOS 版本周AI圈动态纷呈 - 掘金 — juejin.cn
Jul 4, 2026Folia 深度解析：开源全屏沉浸式歌词音乐播放器，网易云 + Navidrome + 本地多端同步 - Text Matrix — txtmix.com

On Bluesky · 5

Jul 4, 2026🚀 Skyrocketing！ 🚀 (200+ new stars) 📦 chthollyphile / folia-major ⭐ 747 (+353) 🗒 TypeScript 专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方网易云播放器 — @github-trending-js.bsky.social2 likes and reposts · 1 reply
Oct 17, 2026🎉 Celebrating！ 🎉 (500+ new stars) 📦 chthollyphile / folia-major ⭐ 7,430 (+559) 🗒 TypeScript 专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器 — @github-trending-js.bsky.social1 likes and repost · 1 reply
Oct 5, 2026🔥 Hot Repo！ 🔥 (100+ new stars) 📦 chthollyphile / folia-major ⭐ 3,521 (+131) 🗒 TypeScript 专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器 — @github-trending-js.bsky.social1 likes and repost
Oct 29, 2026🚀 Skyrocketing！ 🚀 (200+ new stars) 📦 chthollyphile / folia-major ⭐ 10,139 (+241) 🗒 TypeScript 专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器 — @github-trending-js.bsky.social0 likes and reposts · 1 reply
Jul 4, 2026🚀 Skyrocketing！ 🚀 (200+ new stars) 📦 chthollyphile / folia-major ⭐ 921 (+319) 🗒 TypeScript 专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方网易云播放器 — @github-trending.bsky.social0 likes and reposts · 1 reply

In this repository14 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- codebase-navigationSkill
- development-workflowSkill
- file-modularizationSkill
- frontend-runtime-guardrailsSkill
- glossary-alignmentSkill
- kugou-provider-alignmentSkill
- online-song-omni-routingSkill
- prepare-folia-releaseSkill
- readme-referenceSkill
- reuse-project-utilitiesSkill
- run-desktopSkill
- settings-feature-integrationSkill
- testing-strategySkill

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free