feat: 托管 Oneko 像素猫（FEATURES.oneko）

[wutongyuonce]

摘要

为 YuBlog 接入托管 Oneko 像素猫，放在 FEATURES.oneko 开关后；默认 classic 皮肤。请合并前确认行为，本 PR 不自动合并。

配置形状

oneko: FeatureConfig<OnekoConfig>  // OnekoConfig = { skin?: string }
// 默认
oneko: [true, { skin: 'classic' }]
// 关闭：false 或 [false, { … }]

行为（已确认 SPEC）

ON	OFF
跟随光标、睡觉、气泡、记位置、季节帽、reducedMotion=hide、页脚隐藏开关、顶栏避让	喵叫、激光、抓取、零食、跟随焦点、栖息、打字打盹
托管 CDN https://oneko.dhrv.pw/oneko.js	不自托管

View Transitions

BaseLayout 内联引导脚本用 window.__yublogOnekoBooted 只注入一次 CDN module，换页不重建第二只猫。

改动文件

• src/types.ts / src/config.ts — 类型与默认开
• src/layouts/BaseLayout.astro — 挂载
• src/components/base/Footer.astro —「隐藏小猫」
• src/components/nav/NavBar.astro — data-oneko-zone="avoid"
• docs/Oneko 像素猫.md + 项目解析／站点行为 SPEC／CHANGELOG

校验

• pnpm exec tsc --noEmit（Node 22）通过
• eslint（改动源文件）通过

合并前请看

• 本机 dev：猫出现、换页仍一只、页脚可隐藏
• FEATURES.oneko = false 后不再挂载／无按钮
• 文档与皮肤署名：见 docs/Oneko 像素猫.md、oneko docs

就绪后请用户自行合并。

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
wutong-yu-blog	Ready	Preview	Oct 17, 2026 4:04pm UTC