应启用content-seo密度校验、配置forced_keywords语义权重替代方案、启用hermes curator seo健康扫描预检。具体包括安装并启用content-seo技能、设density_threshold为2.8%、添加--strict-density标志；在config.yaml中定义关键词权重与同义词；升级至v0.12.0+后使用--hook=seo-scan-preoutput触发预检替换。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您使用 Hermes Agent 生成技术类文章，但发现输出内容中关键词重复密度过高、语义生硬、存在被搜索引擎判定为关键词堆砌的风险，则可能是由于默认生成策略未启用密度控制与语义稀疏机制。以下是解决此问题的步骤：
一、启用 content-seo 技能包的密度校验模块
该模块基于 Hermes Agent 社区生态中的 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 自托管部署" --strict-density，系统将强制拦截并重写所有密度＞3%的段落。
二、配置 forced_keywords 的语义权重替代方案
该方法放弃硬性关键词注入，转而通过 YAML 配置定义关键词的语义权重向量，使 Hermes Agent 在生成过程中优先调用同义表达、技术缩写与上下位词，自然稀释主词密度。
1、编辑项目根目录下的.hermes/config.yaml文件。
2、在generation:区块下新增如下结构：
forced_keywords:
- term: "Hermes Agent"
weight: 0.6
synonyms: ["Hermes", "HA", "智能体Hermes"]
- term: "自托管"
weight: 0.5
synonyms: ["本地部署", "私有化运行", "离线托管"]
3、保存后执行：hermes reload config，使语义权重配置即时生效。
4、后续所有生成任务将按权重比例自动轮换使用主词与同义词，避免同一词汇在单篇内出现超过22次（以1000字为基准）。
三、启用 Hermes Curator 的 SEO 健康扫描预检
该方法利用 Hermes Curator 的技能治理能力，在文章生成完成但尚未输出前，插入一次轻量级 SEO 合规性快扫，对已生成草稿执行关键词密度热力分析、隐藏文本检测与段落分布均衡度评估。
1、确认 Hermes 版本 ≥ v0.12.0，执行：hermes curator status验证模块可用。
2、在生成指令末尾添加钩子参数：--hook=seo-scan-preoutput。
3、当系统检测到某段落中“Hermes Agent”出现≥5次/150字符，将自动触发替换逻辑：保留首次出现，其余替换为“该智能体”“本框架”“该开源Agent”等指代短语。
4、扫描通过后才允许内容输出至终端或 API 响应体；若未通过，返回含定位信息的警告日志，不提交最终结果。
