应启用seo-keywords-v2技能、配置forced_keywords、使用cli参数追加、启用content-seo密度校验模块、设置语义权重替代方案。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您使用 Hermes Agent 生成技术类或营销类文章，但发现输出内容关键词密度不足、搜索引擎可见性偏低、或缺乏自然语义分布，则可能是由于默认技能未启用 SEO 关键词注入与密度调控机制。以下是解决此问题的步骤：
一、启用内置 SEO Keywords 技能
该技能基于 Hermes Agent 的自进化能力，在任务执行过程中自动识别核心实体、技术术语与长尾语义关系，并将高频高相关词汇注入标题、首段及 H2 标签中，确保关键词自然分布且符合搜索引擎友好结构。
1、启动 Hermes Agent 交互终端，输入 /skills 查看当前已激活技能列表。
2、检查是否存在名为 seo-keywords-v2 的技能条目；若未出现，执行命令：/skill install seo-keywords-v2。
3、确认安装成功后，输入 /skill enable seo-keywords-v2 启用该技能。
4、在新会话中发起文章生成请求，例如：“写一篇关于 Hermes Agent 自托管部署的教程”，系统将自动嵌入“Hermes Agent 自托管”“本地部署 Hermes”“SQLite 记忆存储”等高权重关键词。
二、手动注入关键词配置文件
该方法绕过技能调度，直接修改运行时环境变量，强制指定关键词集合，适用于需严格控制 SEO 元素的发布场景，确保每篇输出均包含预设核心术语。
1、定位项目根目录下的 .hermes/config.yaml 文件。
2、在 generation: 区块下新增字段：forced_keywords: ["Hermes Agent", "SEO文章生成", "关键词优化", "营销自动化"]。
3、保存文件后重启 Hermes Agent 进程，确保配置热加载生效。
4、调用 hermes generate --topic "Hermes Agent SEO文章实战指南"，生成内容首段与各小标题将强制包含所列关键词。
三、通过 CLI 参数动态追加关键词
该方式无需修改任何配置文件或启用技能，适合单次高精度 SEO 输出，关键词仅对当次生成生效，不影响全局行为，特别适用于 A/B 测试或渠道定制化内容分发。
1、在终端中执行完整命令：hermes generate --topic "Hermes Agent 营销内容创作流程" --keywords "SEO文章写作, AI营销工具, 关键词排名优化, 自动化内容生成"。
2、注意关键词之间使用英文逗号分隔，且不得含空格或引号以外的特殊字符。
3、生成完成后，检查输出 Markdown 中的标题、首段及 H2 标签是否已嵌入全部指定关键词。
四、启用 content-seo 技能包的密度校验模块
该模块实时分析生成文本的关键词分布热力图，自动识别连续重复、段落内超频、首尾过度集中等堆砌特征，并在输出前执行动态降权重改写，防止被搜索引擎判定为关键词堆砌。
1、在 Hermes Agent 终端中执行命令：/skill install content-seo。
2、安装完成后，输入：/skill enable content-seo，确保其处于激活状态。
3、进入技能配置子菜单：/seo config，将 density_threshold 参数设为 2.8%（符合百度与 Google 双平台安全阈值）。
4、发起生成请求时追加 --strict-density 标志，例如：hermes generate --topic "Hermes Agent SEO营销实战" --strict-density，系统将强制拦截并重写所有密度 >3% 的段落。
五、配置 forced_keywords 的语义权重替代方案
该方法放弃硬性关键词注入，转而通过 YAML 配置定义关键词的语义权重向量，使 Hermes Agent 在生成过程中优先调用同义表达、技术缩写与上下位词，自然稀释主词密度，提升语义丰富度与可读性。
1、编辑项目根目录下的 .hermes/config.yaml 文件。
2、在 generation: 区块下新增如下结构：
forced_keywords:
- term: "SEO文章"
weight: 0.7
synonyms: ["SEO内容", "搜索引擎优化文章", "排名导向型文案"]
- term: "关键词优化"
weight: 0.6
synonyms: ["关键词布局", "词频调控", "SEO密度管理"]
3、保存后执行：hermes reload config，使语义权重配置即时生效。
4、后续所有生成任务将按权重比例自动轮换使用主词与同义词，避免同一词汇在单篇内出现超过 22次（以1000字为基准）。
