信号

端点 / 输出

链接索引

/llms.txt

全文版本

/llms-full.txt

Markdown 交付

/<slug>.md 或 Accept: text/markdown

结构化数据

JSON-LD WebSite + Person/Organization + BlogPosting + BreadcrumbList（交由 SEO 插件处理）

面向 AI 的主题

每页主题 → JSON-LD keywords + about DefinedTerm 实体（可通过 agentimus_topic_links 过滤器选择加入 Wikidata sameAs）+ /<slug>.md 中的 Topics: 行；静态（由编辑设置）或从标签与分类派生

AI 描述

每页一行摘要 → JSON-LD description + /<slug>.md 开头部分 + 权威的 <meta name="description">（替换主题自带的，交由 SEO 插件处理）；由编辑设置，回退到摘要或约 30 字的内容总结。设置中的子开关可将其限制为仅 JSON-LD + .md 表面

写作助手（可选）

每个 Agentimus 界面上的羽毛笔按钮都会打开一个抽屉：简要提示 → 可编辑大纲 → 文章并行编写每个部分（每个部分对应 /assistant/compose-section + 一次润色调用；长文章不受单次响应的上限限制，失败的部分单独重试，写入中途刷新可恢复）→ 完整预览（标题、真实块、AI 描述、主题、建议的分类/标签、草稿/待定选择）→ 创建草稿直接进入编辑器。草稿写入与可读性面板评分的同一标准——可提升的开篇摘要、适合引用的段落长度、简洁的句子、引用的来源（readability_rules()，其段落上限源自 PageCheck 自身的阈值）。仅限创建：草稿文章在编辑器中打开，修订在编辑器中进行（抽屉旧的编辑路径及其安全块门控已移除——该门控存在是因为抽屉只能处理自己写入的块，而拒绝真实文章是对正确问题的错误答案）。形状按类型区分：Assistant::shape_for() 将分层类型写为 PAGE——不虚构章节、不设图片槽位、不设分类法，只有所有者知道的事实处使用 [placeholder]——MCP 创建运行相同的提示词。图片以填充了 alt 文本的占位块形式到达：每个图片块上都有从 alt 文本生成图片、特色图片（AI）侧边栏面板，以及三个作用域的询问 AI——单个块、多块选择（BlockSettingsMenuControls，因为 InspectorControls 在多选时从不渲染）、或返回大纲范围编辑列表的文档规划器，该列表针对重新读取的锚点映射逐项应用（replaceBlocks 会生成新的 clientId，因此过期的 id 会静默无效）。服务端与 MCP 使用相同的经过审计的写入路径（Assistant.php → ContentWriter），由 enable_agent_writes + 用户自身权限门控，每次生成都通过 Assist::generate() 路由（限速、遵循内容指南），状态限制为 draft|pending——助手永远不能发布

使用 AI 写作（可选）

编辑器中的**"使用 AI 起草"从页面自身内容编写 AI 描述，"使用 AI 建议"填充主题；"使用 AI 修复"**针对每条 AI 可读性警告起草修复方案（开篇摘要一键插入，其余仅复制）。通过 WordPress 7.0 AI Client 路由——使用你自己的提供商密钥，插件绝不处理；在设置 → 连接器下配置提供商之前保持隐藏

AI 能力

通过 wp_register_ability 分为两个层级，每个能力像其源界面一样受权限门控。读取（始终注册）： agentimus/read-readiness、read-findings（Findings 界面自身的排名入口，限制为 12 行）、read-audience（人与机器分开计数，绝不求和）、read-ai-visibility、read-ai-traffic、read-request-log、read-edge-traffic、read-search-visibility、read-search-performance、read-search-opportunities、read-google-index（可选的 url 从存储的检查中回答，无配额）、identify-bot、read-content-issues（哪些页面需要处理、每页被标记的原因、以及该判定有多旧——即 read-findings 汇总的列表）、read-terms（此站点已使用的分类和标签，使用写入工具所期望的确切名称）、check-page、preview-schema/-markdown、scan-exposed-files、suggest-internal-links、search-media（标题 + _wp_attachment_image_alt，受 upload_files 门控）。写入（仅在 enable_agent_writes 开启时注册——默认关闭，需要 MCP 服务器开关，关闭意味着这些能力在任何界面上都不存在）： create-content/update-content（草稿优先；分类和标签按名称使用 wp-admin 自身的创建规则，特色图片按附件 ID 或侧载 URL，AI 描述/主题在同一次调用中）、write-description、write-topics、write-search-fields（焦点关键词和 SEO 标题——决定页面在搜索结果中呈现方式的两个字段，也是代理最后两个无法触及的字段）、以及 apply-fix（从只能启用文档化功能的封闭词汇表中执行可读性检查自身的修复措施）。status=publish 需要第三个开关（agent_writes_publish）加上用户自身的发布权限

MCP 服务器（可选）

/wp-json/agentimus/v1/mcp — WordPress MCP Adapter 内置于插件中（Composer 供应商、Jetpack-autoloader 仲裁）位于 enable_mcp_server 开关之后（设置 → 发现，默认关闭；WP 6.9+）。外部 MCP 客户端（Claude Code、Claude Desktop、Codex）使用应用密码进行身份验证，并获得上述确切的能力——二十个只读工具，加上仅在写入开关开启时的六个写入工具，以及四个资源（llms.txt、llms-full.txt、discovery.json、代理卡片），以 meta.mcp.uri 声明；端点被关闭的资源永远不会注册（服务器的自我描述说明其运行的是哪个层级）——适配器的通用执行任意能力默认服务器保持抑制，每次调用都在 Agent Access 中审计，关闭开关会硬断开实时客户端。开关关闭时，库永远不会加载，端点也不存在

XML 站点地图

/agentimus-sitemap.xml — 可选回退方案，仅在 WordPress 核心或 SEO 插件均未提供站点地图时生成（站点地图索引 + 分页子站点地图）

爬虫策略

robots.txt 内容信号 + 训练爬虫黑名单

发现层

/.well-known/discovery.json（+ agent-card.json、mcp.json）

变更馈送

/agentimus-changes.json?since= — 最近添加、更新和移除的内容以 JSON 形式提供，使代理只获取增量（在 discovery.json 中通告；默认开启）

爬取强制（可选）

在生成的端点上对黑名单、伪造"扫描器"或已证实冒充的用户代理进行硬阻止（403）——ACME 安全，默认关闭；可选的机器人身份验证（前向确认反向 DNS + 运营商发布的 IP 范围，通过所有者可编辑的已验证机器人注册表），因此伪造的机器人名称无法获得白名单资格，已证实的伪造者会被拒绝

钩子

类型

签名

用途

wpdiscovery_register

action

( Registry $registry )

注册你的资源并提供你自己的 /.well-known 文档。完整 schema 请参见 integrate-your-plugin.php。

agentimus_entity_types

filter

( string[] $types ): string[]

向设置 → 身份中添加可选的 schema.org 实体类型。

agentimus_cache_flushed

action

()

在 Agentimus 重新生成其文档后运行 —— 清除你的 CDN / 页面缓存。

agentimus_booted

action

( Plugin $plugin )

在插件启动后运行 —— 配套插件或 Pro 附加组件在此注册其功能。

Hook

Type

Signature

Purpose

agentimus_envelope

filter

( array $envelope, Registry $registry ): array

整个组装好的 discovery.json — 添加 x-<vendor> 扩展键。

agentimus_documents

filter

( array $docs, Registry $registry ): array

将 Agentimus 无法自动检测的标准文档添加到 documents 映射中。

agentimus_schema_url

filter

( string $url ): string

发现文档的 $schema URL；返回 '' 以省略它。

agentimus_well_known_routed

filter

( string[] $names ): string[]

路由你提供的扁平 /.well-known/<name>，使其在每个主机上都能解析。

agentimus_well_known_nested

filter

( string[] $names ): string[]

路由精确匹配的嵌套 /.well-known/<dir>/<file>。

agentimus_well_known_specs

filter

( array $specs ): array

用管理它的标准来标记 /.well-known 名称（name => label）。

agentimus_signed_surfaces

filter

( string[] $surfaces ): string[]

你的配套签名器签署哪些发现文档。

agentimus_mcp

filter

( array $mcp, array $resources ): array

在 /.well-known/mcp.json 处公布的 MCP 描述符。

agentimus_mcp_card_server

filter

( string $id, array $servers ): string

固定 MCP 服务器卡片描述哪个服务器（'' = 自动）。

agentimus_mcp_server_abilities

filter

( string[] $names ): string[]

Agentimus 通过自己的 MCP 服务器向外部代理暴露的能力（默认：其九个只读能力）。裁剪以缩小离开站点的内容范围。

agentimus_bootstrap_mcp_adapter

filter

( bool $bootstrap ): bool

完全否决加载捆绑的 MCP Adapter 库（例如自行管理适配器的主机），与所有者的 enable_mcp_server 设置无关。

agentimus_agent_skills

filter

( array $skills, array $resources ): array

Agent Skills 索引中的条目。

agentimus_post_types

filter

( string[] $types, string[] $available ): string[]

哪些文章类型对代理可见（每种类型都会获得一个 llms.txt 部分）。

agentimus_post_type_source

filter

( string $source, string $post_type ): string

将文章类型的 llms.txt 部分（以及 Agent 预览选择器）归因于你的插件。

agentimus_changes_max

filter

( int $max ): int

变更馈送窗口的大小 — 它能容纳的最新条目数（默认 200，最大 2000）。

agentimus_tombstone_retain_days

filter

( int $days ): int

删除在变更馈送中保留多久才被清除（默认 90）。

agentimus_page_checks

filter

( array $checks, array $stats, WP_Post $post ): array

添加、调整或删除编辑器中显示的每页"可读性"检查。

agentimus_ai_assist_enabled

filter

( bool $enabled ): bool

是否提供编辑器的"使用 AI 起草"/"使用 AI 修复"辅助功能（默认：当 WordPress 中配置了支持文本的 AI 提供商时开启）。

agentimus_markdown_source

filter

( ?string $html, WP_Post $post ): ?string

为页面构建器内容提供渲染后的 HTML（null = 正常渲染）。

agentimus_topic_exclude

filter

( string[] $slugs ): string[]

要从 llms.txt 主题列表和每页派生主题中省略的主题/分类别名。

agentimus_derive_taxonomies

filter

( string[] $taxonomies, WP_Post $post ): string[]

哪些分类法自动填充文章的主题以供 AI 使用（默认 category、post_tag）。供应商可添加例如 product_cat；术语会流经派生开关、排除列表和上限。

agentimus_post_topics

filter

( string[] $topics, WP_Post $post ): string[]

添加或完善文章的主题供 AI 使用列表（→ JSON-LD keywords + Markdown）。之后会重新规范化（去重、设上限）。

agentimus_topic_links

filter

( string[] $urls, string $topic, WP_Post $post ): string[]

主题的参考 URL（Wikidata、Wikipedia…）→ schema.org about sameAs。核心不提供任何内容（无自动查找）；由你映射。即插即用示例：topic-links-wikidata.php。

agentimus_topic_suggestions

filter

( string[] $pool ): string[]

编辑器"主题供 AI 使用"框中的自动补全池（默认：已使用的主题 + 标签/分类 + 专业知识）。

agentimus_topic_meaningful

filter

( bool $meaningful, string $name, ?object $term ): bool

自动派生的分类术语是否成为主题。默认丢弃纯数字名称（"67"、杂散 ID）；如果数字确实是主题（例如"1984"），返回 true 以保留。

agentimus_llms_full_item_max_bytes

filter

( int $bytes ): int

llms-full.txt 版本的每项字节上限。

agentimus_llms_full_avg_item_bytes

filter

( int $bytes ): int

用于在管理后台估算 llms-full.txt 的平均条目大小。

agentimus_yield_surface

filter

( bool $yield, string $surface ): bool

将某个表面（llms_txt、robots 等）让渡给你自己的生产者。

agentimus_defer_schema

filter

( bool $active ): bool

是否输出前端 JSON-LD（为 SEO 插件让位）。

agentimus_schema_for_post

filter

( array $node, WP_Post $post ): array

替换文章的 JSON-LD 节点（例如 Product）。

agentimus_post_description

filter

( string $desc, WP_Post $post ): string

文章 AI 描述的最终决定（编辑器值 → 摘要/概述回退）。供给 JSON-LD description、.md 开头和 meta 标签；之后会重新清理（去除标签、设上限）。

agentimus_emit_meta_description

filter

( bool $emit, WP_Post $post ): bool

Agentimus 是否在此请求中管理页面的 <meta name="description">。返回 false 将 <head> 留给你的主题。（对于专门的 SEO 插件已自动让位。）

agentimus_schema_graph

filter

( array $graph ): array

对整个 JSON-LD @graph 的最后修改机会。

agentimus_faq_pairs

filter

( array $pairs, WP_Post $post ): array

贡献额外的 FAQPage 问答对。

agentimus_sitemap

filter

( array $sitemap ): array

声明 Agentimus 无法自动检测的站点地图。

agentimus_sitemap_max_urls

filter

( int $max ): int

限制生成的站点地图中的 URL 数量。

agentimus_rest_discovery

filter

( bool $enabled ): bool

REST 命名空间自动发现的总开关。

agentimus_rest_namespaces

filter

( string[] $namespaces ): string[]

要在发现文档中发布的 REST 命名空间。

agentimus_rest_skip_namespaces

filter

( string[] $namespaces ): string[]

要从发现中排除的 REST 命名空间。

agentimus_discoverable_ability

filter

( bool $discoverable, string $name, mixed $ability ): bool

包含或排除单个 WP 能力。

agentimus_serve_security_txt

filter

( bool $serve ): bool

Agentimus 是否生成 security.txt。

agentimus_security_txt

filter

( string $body ): string

编辑最终的 security.txt 正文。

agentimus_security_txt_expires_days

filter

( int $days ): int

security.txt 的 Expires 窗口，以天为单位。

agentimus_readiness_checks

filter

( array $checks, Settings $settings ): array

添加或调整管理后台 Discovery Hub 的就绪检查。

agentimus_signing_secret_key

filter

( string $key ): string

从常量或保险库提供 Ed25519 签名密钥。

agentimus_exposed_paths

filter

( string[] $paths, Settings $settings ): string[]

暴露文件扫描探测的敏感路径列表。

agentimus_verified_bot_domains

filter

( array $map ): array

可验证机器人 rDNS 映射（注册表令牌 → 反向 DNS 域后缀），来源于所有者可编辑的注册表。

agentimus_verifier_registry

filter

( array $entries ): array

所有者编辑后的有效已验证机器人注册表 — 两种验证方法（rDNS 域和已发布的 IP 范围文件）的来源。

agentimus_trusted_proxies

filter

( string[] $cidrs ): string[]

用于真实客户端 IP 解析的可信代理/CDN CIDR。仅当直接对端是已验证的代理时才接受转发的标头 — 它不能用于伪造源 IP。

agentimus_referral_beacon

filter

( bool $enabled ): bool

可选"CDN 模式"推荐信标的总开关（在浏览器中统计 AI 访问）。

agentimus_markdown_cache

filter

( bool $cache ): bool

启用或禁用每篇文章的 .md 缓存（默认开启）。

agentimus_flagged_ip_retention_days

filter

( int $days ): int

可选标记 IP 存储的保留窗口（默认约 14）。

Hook

Type

Signature

用途

agentimus_deny_request

filter

( bool $deny, string $ua ): bool

Guard 对是否对请求返回 403 的最终决定权。

agentimus_block_allowlist

filter

( string[] $allowed ): string[]

绝不能被硬性阻止的客户端（搜索引擎 + 你的列表）。

agentimus_verify_bots

filter

( bool $on ): bool

强制开启/关闭机器人身份验证（反向 DNS + 已发布的 IP 范围），覆盖设置。

agentimus_reverse_dns

filter

( ?string $host, string $ip ): ?string

覆盖反向 DNS 检查中的 PTR 查询 — 返回主机名（无则返回 ''），或返回 null 以使用原生解析器。

agentimus_forward_dns

filter

( ?array $ips, string $host ): ?array

覆盖正向 A/AAAA 查询 — 返回 IP 字符串数组，或返回 null 以使用原生解析器。

agentimus_engine_signatures

filter

( array $signatures ): array

在 token 边界匹配真实爬虫的结构化签名。

agentimus_generic_ua_tokens

filter

( string[] $tokens ): string[]

被视为低信号的一般性 user-agent token。

agentimus_agent_map

filter

( array $map ): array

user-agent → 活动日志的友好标签。

agentimus_spoof_signatures

filter

( string[] $signatures ): string[]

标记伪造/旧设备扫描器的平台特征。

agentimus_known_agents

filter

( array $catalog ): array

已知代理目录（user-agent → 标签）。

agentimus_known_scanners

filter

( string[] $known ): string[]

作为一键阻止建议提供的扫描器 user-agent。

agentimus_known_trainers

filter

( string[] $known ): string[]

为 robots.txt 阻止而提供的 AI 训练器 user-agent。

agentimus_ai_referral_sources

filter

( array $map ): array

needle → "来自 AI 的流量"的友好名称。包含点的 needle 会匹配 referrer 主机（及其任何子域名）以及携带该主机的 utm_source；不带点的 needle 永远无法等于主机，因此它只匹配 utm_source — 这正是携带 utm_source=perplexity 的助手被计入的方式。

agentimus_unknown_sources_max_rows

filter

( int $max ): int

选择加入的"查找遗漏的 AI 来源"表的行数上限。0 禁用上限。

agentimus_activity_skip_self

filter

( bool $skip ): bool

是否跳过记录已登录管理员的命中。注意这是从已登录的 cookie 评估的，而不是当前用户，因此它在不携带 nonce 的 REST 路由上仍然有效。

agentimus_activity_retention_days

filter

( int $days ): int

代理命中保留多长时间。覆盖设置 → 访问日志值。仪表板仍然最多报告 30 天。同时提高 agentimus_activity_max_rows，否则行数上限无论如何都会丢弃额外的天数。

agentimus_bypass_shared_cache

filter

( bool $on ): bool

强制 AI 端点不可缓存（发送 Cache-Control: no-store），以便共享缓存/CDN 无法从活动日志中隐藏代理获取。覆盖 设置 → 缓存与 CDN 开关。

agentimus_purge_on_change

filter

( bool $on ): bool

在内容变更时开启/关闭 AI 文件的自动缓存清除。覆盖 设置 → 缓存与 CDN 开关。

agentimus_purge_urls

filter

( string[] $urls ): string[]

Agentimus 在内容变更时要求页面缓存删除的确切 URL（添加你自己的，或缩减集合）。

agentimus_purge_url

action

( string $url )

清除时每个 URL 触发一次 — 挂钩它以支持 Agentimus 无法原生检测的页面缓存。（agentimus_purged 使用整个列表触发一次。）

agentimus_new_agent_seconds

filter

( int $seconds ): int

用于待审查活动面板的"新代理"窗口。

agentimus_burst_min_hits

filter

( int $hits ): int

标记突发的最小命中数。

agentimus_heavy_min_hits

filter

( int $hits ): int

标记重度使用的最小命中数。

agentimus_threats_limit

filter

( int $limit ): int

"待审查活动"面板中的最大行数。

agentimus_default_settings

filter

( array $defaults ): array

默认设置数组。

agentimus_settings

filter

( array $settings ): array

读取时的实时合并设置数组。

agentimus_sanitize_settings

filter

( array $clean, array $input ): array

保存时验证/强制转换伴随添加的字段。

agentimus_settings_reset

action

()

当所有者重置设置时运行。