用途:在设计 Ditto 新功能的事件结构时使用,帮助判断应复用现有 NIP、扩展已有 NIP,还是自定义新 kind,并给出标签与内容结构的规范建议。
主要能力:
一、NIP 与自定义 kind 的选择。先浏览 NIP 索引并详读候选 NIP,优先扩展现有 NIP 而非新建 kind,即使需做少量结构妥协;仅当无 NIP 覆盖核心功能、数据结构本质不同或存储特性需求不同(regular/replaceable/addressable)时才新造 kind。若存在可生成新 kind 编号的工具,则必须调用,不得随意选号。自定义 kind 必须带 NIP-31 alt 标签,提供人类可读的用途说明。
二、kind 范围与存储语义。Regular(1000 ≤ kind < 10000)永久存储;Replaceable(10000 ≤ kind < 20000)每个 pubkey+kind 仅保留最新;Addressable(30000 ≤ kind < 40000)以 pubkey+kind+d-tag 标识,仅保留最新组合。低于 1000 的为 legacy,存储按 kind 而定。
三、标签设计。kind 表结构、tags 表语义,不要因数据类别不同就新造 kind。中继只索引单字母标签,分类应使用 t,使 '#t': ['electronics'] 类过滤在中继层生效;多字母标签会导致低效的客户端过滤。示例:const events = await nostr.query([{ kinds: [30402], '#t': ['electronics'] }]);。Ditto 特定细分(社区应用、地区变体)可用 t 值并据此查询,通用平台不宜如此以免割裂内容。
四、content 与 tags 划分。content 放大型自由文本或既有行业标准 JSON(如 GeoJSON、FHIR、Tiled 地图),kind 0 是结构化 JSON 放 content 的例外;tags 放可查询元数据与结构化数据。仅标签事件可用 content: ""。需要按字段过滤时,该字段必须是标签,中继不索引 content。
五、NIP.md。记录 Ditto 自定义 kind 及对现有 NIP 的扩展,新造 kind 或改动自定义结构时更新标签列表、content 格式与用途;若与现有 NIP 形态相同则注明引用而非重复规范。标准 NIP(如 NIP-84、NIP-23)不写入 NIP.md。
使用方式:在铸造新 kind、扩展现有 NIP 标签、判断现有 NIP 是否够用或记录自定义 kind 时加载本技能;若现有 kind 已覆盖用途、只需在 Ditto UI 渲染,则应改用 nostr-kind-rendering 技能。设计完成后还需进行渲染注册。
限制:资料未提供具体命令、安装方式、收费或平台信息,暂未提供。