用途
Entity Optimizer 是面向机器的实体权威登记技能。它记录实体身份与识别事实及其证据来源，但不拥有定位、品牌语调、主张审批或页面文案。适用于：审计实体的识别情况、调和实体身份、更新权威知识图谱事实、审查待处理实体提案、发现并合并重复 ID、记录已验证的 Wikidata QID 与 sameAs 集合，以及诊断 AI 系统混淆实体的原因。
能力与层级边界
本登记负责机器可读身份：规范类型、别名、schema 类型、QID、sameAs、域名、消歧证据与已观察到的识别状态。narrative-registry 负责人工可读的规范：定位、信息体系、语调、命名与已批准描述；offer-claims-registry 负责主张佐证。实体描述可以引用叙事规范，但必须携带 narrative_canon_id、narrative_canon_version 与 claims_projection_offset，且不覆盖上述任一登记。
使用方式
技能以单个稳定、非 PII 的实体聚合 ID 为单元。读取 memory/events/entities.ndjson、memory/projections/entities.json、叙事与主张投影、已验证来源记录以及可选的渲染视图；通过 scripts/registry-events.py 写入授权实体事件。仅具备宿主能力的 entity-optimizer 主体可接受/拒绝提案或 upsert/转换权威实体状态；其他技能只能追加 operation: propose。具备宿主能力的记忆管理主体可在明确授权下注销或擦除记录。
完成条件为：六类诊断信号（结构化数据、知识库、NAP+E 一致性、第一方内容、第三方佐证、AI 识别）均有 Pass/Partial/Fail/Unknown 观察结论并附来源、观察日期与证据类型；身份冲突得到解决或保持开放；每项接受变更均有事件 ID/偏移/修订；且 verify entities 通过。
数据来源与命令
优先采用组织主页面、结构化数据、已验证平台资料、带引用的 Wikidata 陈述及带日期的用户提供观察。无密钥辅助工具可用于调和：
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/connectors/kg.py" reconcile "<entity>"
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/connectors/kg.py" entity "<QID>"
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/connectors/pageviews.py" "<Article_Title>" --months 12
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/connectors/gdelt.py" '"<entity>"' --days 30
页面浏览量与被提及次数仅为识别代理指标，不是权威性评分。工具拒绝或引擎未观察到的情况记为 Unknown，而非 Partial 或 Fail。
适用场景
审计组织的实体识别、审查待处理实体提案并调和重复 ID、记录已验证 QID 与 sameAs、诊断 AI 系统混淆实体，以及按需从已接受的投影状态重新生成人工可读视图。
限制
姓名、标志、域名或描述相似不足以合并记录，需有已验证的交叉链接或用户确认。Unknown 必须与 Partial 区分：若无站得住脚的关注度依据，不得推断缺少维基百科页面即为缺陷，也不得制造关注度或引用。对自然人，需在持久化前确认适用的合法依据、最小化字段、使用化名聚合 ID，并禁止在事件中包含原始邮箱、电话、邮寄地址与凭据；此前的擦除/注销会阻止重建，直到用户明确授权新的合法记录。以上为运营指引，不构成法律建议。
遇到缺少目标身份、未经验证的合并、无适用依据的自然人记录、重大叙事/主张冲突或缺少写入授权时应停止。不得手工编辑 memory/events/entities.ndjson 或 memory/projections/entities.json，不得直接向 HOT 记忆写入规范事实，不得从抓取的联系人列表创建个人档案，也不得从过期笔记重建已被擦除的主体。单文件夹独立安装仅可准备有限提案；缺少已验证的根运行时/schema/目录时无法追加、投影、接受/拒绝或声称权威实体真相。首次持久化写入前需征得同意。
后续技能
Schema 实现：serp-markup-builder；AI 可引用页面工作：geo-content-optimizer；新页面：content-writer；规范冲突：narrative-registry；归档/擦除：memory-management。