面向中文读者的花谱(花譜 / KAF)非官方资料站。项目整理人物简介、2018 年以来的活动轨迹、代表专辑、视觉作品和官方平台入口;资料与图片来源集中列在页面底部。
- 人物介绍:花谱的基本资料、所属团队和主要活动形式。
- 成长轨迹:按年份整理重要作品、演出和活动节点。
- 代表作品:收录《観測α》《魔法α》《狂想β》《寓話》《深愛》等原创专辑。
- 视觉档案:浏览站内收录的插画与演出视觉,并支持放大查看。
- 官方入口:汇总官方网站、哔哩哔哩、YouTube 等官方账号。
- React 19、TypeScript、Vite
- Motion 与 Scrollama
- Yet Another React Lightbox
- Noto Sans SC、Noto Serif SC 自托管字体
- Vitest、Testing Library、Playwright
页面支持桌面端和移动端。系统开启“减少动态效果”后,成长轨迹会改为普通列表,内容不会缺失。
项目使用 mise 固定 Node.js 和 pnpm 版本。安装好 mise 后,在仓库目录运行:
mise run install
mise run dev常用命令:
| 命令 | 用途 |
|---|---|
mise run dev | 启动本地开发服务器 |
mise run build | 类型检查并生成生产构建 |
mise run test | 运行 Vitest 测试 |
mise run check | 运行格式、Lint、测试和构建检查 |
mise run e2e-install | 安装 Playwright Chromium |
mise run e2e | 运行浏览器端回归测试 |
使用 mise tasks ls 可以查看全部任务。
生产站点托管在 Cloudflare Pages。代码推送不会自动上线;需要发布时,在 GitHub Actions 中运行 Deploy Cloudflare Pages 工作流即可。工作流会自动完成质量检查、生产构建、静态资源校验、部署和线上可用性检查。
也可以使用 GitHub CLI 一键触发:
gh workflow run deploy-cloudflare-pages.yml --ref main| 路径 | 内容 |
|---|---|
src/content/kaf.ts | 人物、时间线、专辑和官方链接数据 |
src/pages/HomePage/ | 首页组件与各内容区块 |
src/assets/kaf/ | 图片素材、响应式派生文件和来源记录 |
tests/ | 单元测试、组件测试和 Playwright 回归测试 |
人物和作品资料集中维护在 src/content/kaf.ts。新增或替换图片时,需要同步记录来源、署名和使用条件,详见 素材来源与使用说明。
本项目是非官方、非商业粉丝站,与花谱及 KAMITSUBAKI STUDIO 无隶属关系。花谱、KAMITSUBAKI STUDIO、作品名称、图片及其他相关素材的权利归各自权利人所有。项目所用字体和第三方依赖遵循各自许可证。
如权利人希望调整或移除相关内容,请通过仓库的 Issue 联系。