# @directus-labs/seo-plugin 中文文档 规范地址：https://npmcn.com/package/%40directus-labs/seo-plugin/ 版本：1\.2\.1 npm 元数据更新时间：2026-11-03T20:29:15.687Z 中文译文更新时间：2026-11-12T12:07:17.663Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40directus-labs/seo-plugin 原文对照：https://npmcn.com/package/%40directus-labs/seo-plugin/?lang=original 项目主页：https://github.com/directus-labs/extensions#readme 源码仓库：https://github.com/directus-labs/extensions ## 关键信息（来自 npm 元数据） - 包体积（解压后）：183 kB，4 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - 运行依赖：3 个 - 首次发布：2025-02-12T20:44:51.318Z - 最新版本发布：2026-11-03T20:18:04.395Z - 近 30 天下载量：4972（2026-10-13 至 2026-11-11，npm 官方下载统计） - 已发布版本数：6（近 12 个月 3 个） ## 中文简介 Directus 的 SIO 插件 ## 安装 ```sh npm install @directus-labs/seo-plugin ``` 也可以使用：`pnpm add @directus-labs/seo-plugin`、`yarn add @directus-labs/seo-plugin`、`bun add @directus-labs/seo-plugin` ## README # SEO 插件 ![SEO Interface thumbnail](https://raw.githubusercontent.com/directus-labs/extensions/main/packages/seo-plugin/docs/seo-plugin-bundle.png) 一个强大的SEO管理扩展,帮助您优化搜索引擎和社交媒体共享的内容,就在Directus内部. 它包括一个管理元数据的综合界面和一个显示组件,用于监测标准电子数据状况. ## 关键特性 QQ - 标题和元描述( 有模板支持) - 视觉搜索结果预览 - **重点关键词分析** (新来 - 社会媒体形象和 **预览** (新来 - 子项目配置 - 搜索引擎索引控制 - 自定义 SIO 字段支持( 类似 Canonic URL,自定义元标记, JSON- LD等) - 使用从布局视图中预览的悬浮状态监视 **接口** (在项目视图中显示) ![SEO Interface](https://raw.githubusercontent.com/directus-labs/extensions/main/packages/seo-plugin/docs/seo-plugin-interface.png) _注意:界面现在使用标签来更好的组织(Basic, Advance, C自定义字段, keyword)._ **显示** (在布局视图中显示) ![SEO Display](https://raw.githubusercontent.com/directus-labs/extensions/main/packages/seo-plugin/docs/seo-plugin-display-ideal.png) ## SEO数据 - **标题**(原始内容存档于2018-03-26) (英语). The most successive SEO number. 应具有说服力并包含您的主要关键词(建议长度:45-60个字符) - **元描述**:您页面的搜索结果摘要. 使其参与提高点击率(建议长度:130-160个字符) #### 关键词分析( New!) ![SEO Interface Keyphrase](https://raw.githubusercontent.com/directus-labs/extensions/main/packages/seo-plugin/docs/seo-plugin-interface-keyphrase.png) - **焦点键句**: 您希望页面排列的主要关键词或短语. - **分析**: 提供关键词在标题,元描述,URL sult,以及主要内容字段中的存在和用法的反馈. 突出问题,改进,取得好成绩. #### 社会媒体 - **OG 图像**: 在社交媒体上共享页面时出现的图像 。 增强社会参与至关重要. - **社会预览**:可视化不同平台共享的内容将如何外观. #### 搜索引擎控制器 - **无索引**: 告诉搜索引擎在搜索结果中不要显示此页面 - **无跟随**: 防止搜索引擎在页面上跟踪链接 #### 项目设置 - **更改频率**: 网页的更新频率(选项:始终、小时、每日、每周、每月、每年、永远) - **优先权**: 相对于其他页面的页面重要性(0.0至1.0,默认:0.5) #### 其他字段 - **其他字段**:针对特定需要自定义 SEO 字段( 如 Cononic URL,自定义元标记, JSON- LD等) ### 数据结构 SEO数据作为JSON存储,以简单和灵活. OG 图像存储文件 `filename_disk` (单位:千美元)`.`) (中文(简体) ). 和一个裸体的UUID工作 `/assets/`,因为资产端点读取前36个字符为文件ID. ```json { "title": "This is the Directus SEO Plugin.", "meta_description": "A powerful SEO management extension that helps you optimize your content for search engines and social media sharing, right within Directus. It includes a comprehensive interface for managing metadata and a display component for monitoring SEO status.", "og_image": "f5d20d13-e86a-4aaa-ab1c-241925b89ea3.jpg", "focus_keyphrase": "Directus SEO", "additional_fields": { "canonical_url": "https://directus.io/", "custom_meta_tag": "This is a custom meta tag" }, "sitemap": { "change_frequency": "monthly", "priority": "0.5" }, "no_index": false, "no_follow": false } ``` ## 使用量 SEO插件由两个部分组成: ### 1\. SEO接口 界面为管理标准电子数据元数据提供了一个综合表格,分为标签: - **基本标签**数字 : - 有字符计数和最佳长度验证的页标题字段(45-60个字符) - 有验证的元描述 (130-160个字符) - 搜索结果预览 - 社交媒体打开图形( OG) 上传图像 - 社交媒体共享预览(新!) - **高级标签**数字 : - 搜索引擎能见度控制( 无索引, 无跟随) - 项目配置选项 - **自定义字段标签**数字 : - 支持添加自定义 SEO 相关字段( 如 Cononic URL,自定义元标记) - **键口标签** (新语: - 焦点密钥词输入 - 详细分析标题、说明、流言和内容中的关键词用法 - 反馈分为问题、改进和良好结果 ![SEO Interface Progress Bar](https://raw.githubusercontent.com/directus-labs/extensions/main/packages/seo-plugin/docs/seo-plugin-interface-progress.png) Page Title 和 meta 描述字段显示一个进度栏来帮助您根据 SIO 最佳做法跟踪字符计数和最佳长度 . 要填充标题或元描述字段,请使用模板 `Apply Template` 按钮将模板应用到字段. ![SEO Interface Template](https://raw.githubusercontent.com/directus-labs/extensions/main/packages/seo-plugin/docs/seo-plugin-interface-template.png) ### 2\. SEO 显示 紧凑状态指标显示: - 社会平等局总体健康状况 - 快速概述缺失或无效的字段 - 悬浮时搜索预览( 可选) - 所需领域和可选领域的现状 ![SEO Display Layout](https://raw.githubusercontent.com/directus-labs/extensions/main/packages/seo-plugin/docs/seo-plugin-display-layout.png) ![SEO Display Ideal](https://raw.githubusercontent.com/directus-labs/extensions/main/packages/seo-plugin/docs/seo-plugin-display-ideal.png) ![SEO Display Hidden](https://raw.githubusercontent.com/directus-labs/extensions/main/packages/seo-plugin/docs/seo-plugin-display-hidden.png) **图标的解释:** - 绿色检查标记:所有配置的字段都有效. - 黄色警告:一些已配置的字段无效 . - 红色错误 : 至少缺少一个需要的字段(包括根据需要标记的附加字段) - 有斜线图标的灰眼: 没有启用此项的索引字段隐藏在搜索引擎中 ## 配置 {} 要使用 SEO 插件, 请在您想要管理 SEO 的任何( 和所有) 收藏中添加一个新字段( 例如帖子、 文章或页面) 。 字段类型应该是 `json`。为外地推荐的密钥只是 `seo` 但你可以使用任何你想要的钥匙. ### 接口选项 ![SEO Interface Configuration](https://raw.githubusercontent.com/directus-labs/extensions/main/packages/seo-plugin/docs/seo-plugin-interface-config.png) - **类型**数字 : `json` - **组**数字 : `standard` - **选项**: 可配置模板、 OG 图像、 站点映射设置、 自定义字段和 **焦点密钥句设置** (新来 界面可以配置如下选项: 1. **标题模板** - 配置 SIO 标题的模式, 这样您就可以使用项目中的字段生成标题 - 使用 `{{fieldName}}` 语法 2. **说明模板** - 配置元描述的图案, 以便您使用项目中的字段生成描述 - 使用 `{{fieldName}}` 语法 3. **社交媒体形象** - 切换以启用/禁用 Open Graph 图像上传和社交媒体预览 . - 默认禁用 4. **焦点键句** - 切换到启用/失效密钥句分析选项卡 . - 默认禁用 - **粘结字段**: 选择您收藏中包含 URL sult 进行分析的字段. - **内容字段**:选择一个或多个包含主要内容进行分析的字段(如:WYSIWYG,Markdown). 5. **搜索引擎控制器** - 切换到在高级标签中显示/ hide noindex/ no follow 选项. - 默认禁用 6. **项控件** - 切换到高级标签中启用/失效的站点映射配置 . - 启用时,包括: - 默认更改频率( 预设为"每周" ) - 默认优先级( 预设为" 0. 0" ) - 编辑 SEO 字段后, 默认会随项一同保存 。 从未被触摸过 SIO 字段的项目 `null`,因此在前端应用相同的默认值. - 默认禁用 7. **自定义 SEO 字段** - 切换到启用/禁用自定义字段标签 . - 默认禁用 - 标记字段 **需求** 显示星号、 自定义字段标签上的错误图标并显示 SIO 显示中的错误。 他们不会阻碍储蓄,因为价值 生活在一个JSON领域。 要执行,请使用屏蔽的流程 `items.create` 编号 : `items.update` 检查 `seo.additional_fields`。 。 。 . ### 翻译内容 要保持每个语言的SEO,请在您的翻译收藏中添加SEO字段(例如翻译界面创建的翻译字段). `articles_translations`) (中文(简体) ). 模板 密钥句分析 和弹道检查 然后使用该语言的字段. 在列表中查看每种语言的最低限度就业标准状况: - **建议:** ,选择核心 **翻译** 显示并添加到其模板中(例如:. `{{seo}}`) (中文(简体) ). 单元格显示默认语言或用户语言的状态,并按其状态盘旋列出每一种语言. - A 类 `translations.seo` 栏也起作用。 它显示一个芯片,在各种翻译中状况最差;徘徊列出每个翻译的状况. 它无法显示语言名称,因为显示器不接受该列的语言字段. ### 翻译 界面和显示都遵循每个用户的Directus语言. 包括:英语,德语,西班牙语,法语,意大利语,日语,朝鲜语,荷兰语,波兰语,葡萄牙语(巴西),越南语,汉语(简化后). 区域变体如: `es-MX`, (中文(简体) ), `fr-CA`,以及 `pt-PT` 使用最近的一个。 添加或修补语言,编辑或添加文件 `src/lang/` 键与 `en-US.ts` 并登记在 `src/lang/index.ts`。缺失的密钥返回英语. ### 显示选项 ![SEO Display Configuration](https://raw.githubusercontent.com/directus-labs/extensions/main/packages/seo-plugin/docs/seo-plugin-display-config.png) - **类型**数字 : `json` - **图标**数字 : `search` - **选项**: 搜索预览切换 显示组件可以配置为: 1. **显示搜索预览** - 切换以启用/ 无法在悬浮时预览搜索结果 - 显示页面在搜索结果中的显示方式 - 默认禁用 ## 安装 从 Directus 市场安装扩展 。 见 [正式指南](https://docs.directus.io/extensions/installing-extensions.html) 更多信息. 或者如果您喜欢手动安装 : ```bash npm install @directus-labs/seo-plugin ``` ## 路线图 **计划:** - 支持翻译标题和元描述字段 - 外地标签和说明翻译 **也许:** - 在模板中添加对关系字段的支持 ## 捐款额 欢迎捐款! 请在提交公关前添加一个问题,描述您想要添加的功能. ## 常见问题 ### @directus-labs/seo-plugin 是什么？ Directus 的 SIO 插件 ### 如何安装 @directus-labs/seo-plugin？ 在项目目录运行 npm install @directus-labs/seo-plugin，或使用 pnpm add / yarn add / bun add。 ### @directus-labs/seo-plugin 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/directus-labs\_\_seo-plugin 是否存在。 ### @directus-labs/seo-plugin 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @directus-labs/seo-plugin 可以商用吗？ @directus-labs/seo-plugin 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @directus-labs/seo-plugin 的下载量有多少？ 根据 npm 官方下载统计，@directus-labs/seo-plugin 在 2026/10/13 – 2026/11/11 这 30 天内被下载 4,972 次，日均约 166 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @directus-labs/seo-plugin 还在维护吗？ 最新版本 1\.2\.1 发布于 2026/11/04（8 天前）；至今共发布 6 个版本，其中过去 12 个月发布了 3 个；首次发布于 2025/02/13。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。