「最小 ipedia-meta」长什么样?——匿名示例、键对照与用途边界

HDGP protocols:匿名形状示例 + 键对照 + 机检/摘要/验稿边界;与字段导读、tag/发布面两篇互补,不把双轨当主轴。

Track: hdgp Category: protocols Intent: explain Updated: 2026-05-15

摘要(结论先行)

7 条要点;与下方 ipedia-metasummary 数组逐字一致。

  • 仅有「一份合法 JSON」并不代表读者或 CI 已理解其约束;`ipedia-meta` 的价值在于键语义稳定、可与正文与编辑政策交叉核对,而不仅是语法可通过校验。
  • 文内匿名示例采用与 IPedia 模板一致的 `ipedia-meta` 内联 JSON 形态,示例内 `summary` 为 5 条;正式稿件通常 `summary` 为 7 条并与文首列表逐字一致。
  • 键对照表逐项说明各键的人类可读含义,并标出与 §2–§4 的对应关系,便于把「字段责任」从「段落修辞」里拆出来。
  • 在用途边界上:机检侧重可解析与必填字段齐全及轨道单选;对外搜索摘要可安全复用 `title` 与 `summary`;主系统验稿仍以正文与站内政策为准,Meta 不能替代法务或监管结论。
  • 反模式包括:嵌入示例与正文事实冲突、`summary` 条数与文首列表不一致、在 Meta 中暗示已具备 Judge、Engine、认证或监管背书。
  • 与 HDGP-Core 的关系限于 Meta-only 字段语义对齐;本示例使用虚构项目与虚构链接,不暗示已绑定某 tag、某发布面或任何生产部署。
  • 延伸阅读以中性锚文本链向两篇 protocols 与 governance 三文,避免本篇重复展开双轨叙事或合规导流细则。

正文

读者任务 → 匿名示例块 → 键对照表 → 用途边界与反模式 → HDGP-Core 一句 → 延伸阅读。

1. 读者任务:为什么「有一份 JSON」还不够

语法上合法的 JSON 只保证能被解析;ipedia-meta 在 IPedia 流程里承担的是契约头:同一页面上,机器、搜索摘要生成器、编辑与(若接入的)主系统验稿脚本,都应能读到同一套键并得到不与正文打架的结论。若键齐全但语义与正文矛盾,或 summary 与文首列表字数不同,则「有 JSON」反而放大误读——读者会以为机检已通过即代表内容已获背书。

关于 Meta-only 与运行时、双轨、承诺过度的完整讨论,请参阅 governance 轨三篇及前两篇 protocols(见下文「延伸阅读」);本篇只保留上段定位,不展开成长论述。

2. 匿名示例:最小内联块(summary 示例 5 条;正式稿常扩至 7 条)

下面示例使用虚构项目名 Riverbend Meta Lab 与 example.org 下虚构路径(RFC 保留用途域名,非真实产品主页)。字符串内不使用裸 ASCII 双引号 U+0022,统一用中文直角引号「」包裹需强调的短语,避免嵌套引号截断内联 JSON。

说明:页面顶部 id="ipedia-meta"本篇真实稿件元数据;下列 id="riverbend-meta-shape-demo" 仅为形状演示,避免与机检用的唯一 ipedia-meta 冲突。

正式稿件仍须满足仓库内公开文档《IPedia 文章验收工作流》(docs/IPEDIA_ARTICLE_AUDIT_WORKFLOW_v1.md)与随稿校验脚本所约定的最小字段集;summary 条数允许 3–7,IPedia 当前惯例为 7 条并与文首 <li> 逐字一致——精神同「先写可机读摘要、再写人读正文」,不必抄具体校验脚本。文章 HTML 骨架见 IPedia 仓库中的 article-template.v1.html(GitHub)

3. 键对照表(键名 → 含义 → 正文位置)

键名 人类可读含义(一句话) 与正文关系
title 页面主标题;宜与 <h1> 一致或显式声明差异规则 §2 示例 title;§4 勿与正文标题语义冲突
summary 3–7 条短句;正式稿须与文首摘要列表逐字一致(本篇顶部 ipedia-meta 为 7 条)。§2 Riverbend 块仅 5 条,属刻意缩略的演示形态,不是生产稿形态。 §2 演示 5 条 vs 本篇正式 7 条的对照见上;§4 禁止正式稿在条数或措辞上与文首列表不一致。
track 三选一:hdgp / xyrang / intdone;本篇固定 hdgp §4 禁止跨轨串题
category 栏目 slug;本篇为 protocols 与 governance 栏目区分
intent explain / compare / migrate / compliance / index 等 影响检索归类;勿与正文体裁矛盾
audience 读者画像;含 G=Government 时与全站 HDGP 文一致 §2 示例已对齐全站口径
risk_tags 风险域标签;仅用站内已稳定枚举(如 misinfo、security、abuse) 勿引入未定论枚举名
scope_boundary 「不做什么、不承诺什么」的可解析陈述 §4 禁止写进运行时能力暗示
sources ≥2 条 {title,url};须 HTTPS、无追踪参数 示例用虚构 URL;真稿须可验证权威链
updated_at ISO 日期或 YYYY-MM-DD 可与 doc-release-tag-and-published-surface 一文对照发布面
relationship_disclosure 利益关系与维护方披露 与编辑规范关联方口径一致

4. 用途边界与反模式(短)

机检:解析成功、必填键存在、track 单选、sources 数量与 URL 形态合法。

搜索摘要:可复用 title + summary 作 snippet,前提是 summary 已与正文对齐,否则会「摘要卖一件、正文讲另一件」。

主系统验稿:Meta 是输入线索,不是判决书;法务、监管与采购结论仍在正文与政策文档链中完成。

反模式:① 示例 JSON 写「不提供法律意见」而正文仍做合规结论式表述;② 文首 7 条与 summary 数组长度或文字不一致;③ 在 scope_boundarysummary 里写「已通过某认证」「默认开启 Judge」等——均与 Meta-only 及 IPedia 禁区精神冲突。

5. 与 HDGP-Core 的一句关系

HDGP-Core 提供 Meta-only 字段语义参考;本篇示例体现键名与边界语言可对齐,不暗示 Riverbend 或任何真实部署已绑定某 Git tag、某静态发布面或 Judge/Engine;与第二篇 protocols 的「发布面与 tag」主题仅作呼应,不重复论证。

6. 延伸阅读(中性锚文本)

protocols

governance

来源与引用

2 个可验证入口;与 ipedia-meta.sources 一致。

  1. HDGP-Core(Meta-only baseline)· core.hdgp-protocol.com (镜像 GitHub Pages; 仓库 GitHub) —— Meta-only 字段语义与声明层对齐的事实锚点。
  2. Introducing JSON —— 合法 JSON 与内联解析的公开说明;与 §2 引用点一致。

边界声明

置于来源之后;与 ipedia-meta.scope_boundary 一致。

  • 本文不提供法律意见或监管背书;不承诺文末 JSON 草稿或文内匿名示例可不经人工终审直接用于生产。
  • 不评价具体产品或部署是否满足某法规;不暗示对齐 HDGP-Core 字段语义即等同于已部署 Judge、Engine 或已获得任何认证。
  • 不代表主系统、PFaaS 或商业交付方立场。

更新记录

首发与主系统验稿后修订的对外记录。

  • 2026-05-15:外部通读与读者体验 — protocols 三篇统一移除正文「关于 slug」内部说明;本篇键对照表显式区分 §2 Riverbend 演示(5 条)与页顶正式 ipedia-meta(7 条);§2 文章 HTML 骨架改指 GitHub 公开链。
  • 2026-05-15:主系统侧验稿 Accept;§2「最小字段集」改指仓库内工作流文档路径;ipedia-meta.updated_at 与页眉标签同步为 2026-05-15。
  • 2026-05-14:首发定稿 — JSON(ipedia-meta)、摘要 7 条、正文六节、Riverbend 演示块(独立 id)、键对照表、来源 2 条(GitHub + json.org)及后置边界声明;栏目 protocols