# @fluixi/head 中文文档

规范地址：https://npmcn.com/package/%40fluixi/head/

版本：1\.0\.0-alpha\.108
npm 元数据更新时间：2026-11-07T01:10:16.533Z
中文译文更新时间：2026-11-15T02:15:11.291Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40fluixi/head
原文对照：https://npmcn.com/package/%40fluixi/head/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：248 kB，49 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：@fluixi/reactive ^1\.0\.0-alpha\.108
- 首次发布：2026-07-10T03:16:59.351Z
- 最新版本发布：2026-11-07T01:08:37.179Z
- 近 30 天下载量：6156（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：56（近 12 个月 56 个）

## 中文简介

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

## 安装

```sh
npm install @fluixi/head
```

也可以使用：`pnpm add @fluixi/head`、`yarn add @fluixi/head`、`bun add @fluixi/head`

## README

# @fluixi/ 头

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

```ts
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=' }),
});
```

## 它会做什么

-   **反应**:通过一个信号(或读取一个函数),文档更新直播:
    
    ```ts
    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 是什么？

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 和提交记录判断。