@fluixi/head

中文文档
1.0.0-alpha.108发布于 2026/11/07MITTypeScriptESM + CJS零依赖近 30 天下载 6156

Fluixi的SSR-First SEO和文档头管理——标题,元,Open Graph,Twitter,JSON-LD,Canonic,hreflang,站点地图和机器人.

中文使用文档
文档目录6 节
  1. 它会做什么
  2. 表面
  3. JSON-LD 帮手
  4. 构成部分
  5. 部件和机器人
  6. 状态

@fluixi/ 头

内地, 反应性,安全部门改革第一 Fluixi 的 SEO & 文档头管理. 无外文库:是框架的核心部分.

import { seo, jsonld } from '@fluixi/head';

seo({
  title: 'Home',
  titleTemplate: '%s · Fluixi',
  description: 'A fine-grained reactive framework.',
  canonical: 'https://fluixi.com/',
  og: { type: 'website', image: 'https://fluixi.com/og.png', siteName: 'Fluixi' },
  twitter: { card: 'summary_large_image', site: '@fluixi' },
  jsonLd: jsonld.website({ name: 'Fluixi', url: 'https://fluixi.com', searchUrl: 'https://fluixi.com/s?q=' }),
});

它会做什么

  • 反应:通过一个信号(或读取一个函数),文档更新直播:
    const title = $signal('Dashboard');
    seo(() => ({ title: title() })); // document.title tracks the signal — no reload
    
  • 安全部门改革第一数字 : renderHead(registry) 将解析后标记序列化为 <head> 标记加加 <html> 属性; 客户端调节器重用这些标签 按键 - 没有水合不匹配.
  • 重复: 一个标题, 一个描述, 一个可重复标记( extra) og:image, (中文(简体) ), hreflang 候补,JSON-LD)积累. 最后的写法胜于单数.
  • 嵌入式继承: 从布局注册,然后是页面; 子值覆盖, 数组合并 .
  • 类型:每个属性被打入,包括"开放图形","推特","机器人","图标","验证"等.

表面

title, (中文(简体) ), titleTemplate, (中文(简体) ), description, (中文(简体) ), keywords, (中文(简体) ), author, (中文(简体) ), robots (字符串或对象), canonical, (中文(简体) ), lang, (中文(简体) ), themeColor, (中文(简体) ), viewport, (中文(简体) ), charset, (中文(简体) ), generator, (中文(简体) ), applicationName, (中文(简体) ), referrer, (中文(简体) ), colorScheme, (中文(简体) ), manifest, (中文(简体) ), 打开图 (包括多幅图像,视频,音频, 文章/书籍/简介), 微博 纸牌, JSON-LD( 日语), (中文(简体) ), alternates (雷夫朗语), feeds (俄文), icons (favicon/apple/mask/shortcut/ms-tile), (中文(简体) ), verification (google/bing/yandex/利息), base,以及 meta编号 :link编号 :script 逃生舱.

JSON-LD 帮手

jsonld.organization · person · website · webPage · searchAction · article · blogPosting · faq · product · breadcrumb · videoObject · event · localBusiness · softwareApplication · custom。 。 。 .

构成部分

<Title>, (中文(简体) ), <Meta>, (中文(简体) ), <Link>, (中文(简体) ), <Script>, (中文(简体) ), <Base>, (中文(简体) ), <JsonLD>:不做任何产品,登记元数据, 在服务器+客户端上的工作(在更新文档活性时传递的信号).

部件和机器人

纯发电机: generateSitemap(entries) (上个mod / changefreq / 优先级 / hreflang / 图像 / 视频, chunkSitemap + 键 generateSitemapIndex (50克拆分)和 generateRobots(opts) (规则 / 主机 /站点地图, 环境意识 不允许全部预览).

状态

这是 引擎 (第1阶段):登记册+分辨率/dedupe + SSR序列化+被动客户端 调节 + JSON-LD + 组件 + sitemap/robots 发电机,经过充分测试.

计划整合(第二阶段): seo 路由导出 + 嵌入式铺放线 @fluixi/router, (中文(简体) ), 自动 <head> 输入 @fluixi/server 安全部门改革/流程管道, robots.txt编号 :sitemap.xml 排放量 @fluixi/start 构建、 演示板、 SIO 验证器和图像元数据 输油管.

版本与发布记录

@fluixi/head 共发布 56 个版本,首次发布于 2026/07/10;过去 12 个月发布了 56 个版本。

版本发布日期距今
1.0.0-alpha.108latest2026/11/078 天前
1.0.0-alpha.1072026/11/0511 天前
1.0.0-alpha.1062026/11/0213 天前
1.0.0-alpha.1052026/11/0115 天前
1.0.0-alpha.1042026/11/0115 天前
1.0.0-alpha.1032026/10/2620 天前

关于 @fluixi/head 的常见问题

@fluixi/head 是什么?

Fluixi的SSR-First SEO和文档头管理——标题,元,Open Graph,Twitter,JSON-LD,Canonic,hreflang,站点地图和机器人.

如何安装 @fluixi/head?

在项目目录运行 npm install @fluixi/head,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@fluixi/reactive(^1.0.0-alpha.108)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@fluixi/head 支持 TypeScript 吗?

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

@fluixi/head 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@fluixi/head 可以商用吗?

@fluixi/head 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@fluixi/head 的下载量有多少?

根据 npm 官方下载统计,@fluixi/head 在 2026/10/15 – 2026/11/13 这 30 天内被下载 6,156 次,日均约 205 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@fluixi/head 还在维护吗?

最新版本 1.0.0-alpha.108 发布于 2026/11/07(8 天前);至今共发布 56 个版本,其中过去 12 个月发布了 56 个;首次发布于 2026/07/10。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。