Glossary

Rho 生态术语权威定义。所有 docs 引用术语时统一回这里。

A

AINP

AI-native Interaction Protocol —— 本文档体系背后的开放协议，定义 AI 生成的 declarative interactive content 标准。

• License: CC BY 4.0
• Vendor-neutral，任何人可实现 AINP-conformant reader
• 协议文档：AINP 协议（英文）
• ⚠️ AINP ≠ Rho——AINP 是协议，Rho 是其参考实现

AI-native

协议的首要设计目标——LLM 可靠生成。具体：语法紧凑、无歧义、机器可校验、错误温和、安全无 eval。 详见 AINP §3.5。

Anchor (STL)

STL 语法中的方括号节点 [NodeName]。用于表达知识图谱节点。 详见 STL syntax。

Annotate

Capability：同行内多色标注（每片段一个 label / 颜色）。 详见 Annotate。

B

Blockquote (markdown)

Markdown 引用块，以 > 开头。AINP 用作 callout marker（> [!INFO]）。

Build-time

AINP pipeline 的前半段——markdown source 转 HTML 字符串（含 marker classes）。在 Node / build pipeline 跑，不需要浏览器。 对照 Runtime。

C

Callout

Capability：单段语义高亮块（INFO / WARN / ZEN / GFM types）。 详见 Callout。

Capability

AINP 协议定义的某项功能。v1 共 15 个 capability。 详见 AINP Part III。

Card (layout)

Layout grid 内的单个卡片。:::card accent=COLOR 声明。

Carrier

AINP 协议的序列化格式。v1 标准 = Markdown。其他 carrier（HTML / JSON）可通过未来扩展。 详见 AINP §3.1。

Computed

Capability：派生值声明 computed name = expression。源 control 变化时自动重算。 详见 Computed。

Conformance

AINP 协议的符合度——reader 实现声明实现哪些 capability + 满足哪些 fallback / safety 要求。 4 levels：Full / Static-only / Reader (no animation) / Partial。 详见 AINP §19。

Container (DSL)

能包含其他 DSL 块的 capability：callout / layout / tabs / stepper / modal / timeline。 详见 Nested DSL。

Container directive

Markdown directive 容器语法，:::name ... :::。AINP 用于 layout cards / tabs / steps / events。

D

Declarative

AINP charter Article 4 —— 所有交互通过声明（"这里有滑块"）表达，不通过命令式代码。 详见 AINP §3.2。

Directive

参见 Container directive。

DSL block

Domain-specific language block —— AINP 协议中体现 capability 的源块（fenced code 或 directive container）。

F

Fallback (carrier)

AINP charter Article 3 —— 协议内容在不支持 reader 里降级为合法 carrier（markdown carrier 下：plain markdown / 代码块字面量）。 详见 Plain-text fallback。

Fallback reader

不支持 AINP 但支持 carrier base format 的 reader（GitHub web / VS Code 默认预览 / cat / Obsidian 默认 等）。

Fenced code block

Markdown 代码块语法 ```。AINP 用 lang label 触发 capability（如 ```layout）。

Frame budget

AINP animation sub-protocol 推荐每帧预算 < 16ms（60fps target）。 详见 AINP 协议。

H

Hydration

Runtime 阶段——把 build-time 输出的"带 marker class 的静态 HTML"在浏览器里激活成可交互组件（slider / chart / 动画）。 详见 Hydration utilities。

I

Implementation

实现 AINP 协议的具体 reader / library / app。

• Reference impl: Rho (@rho/md)
• 其他 impl: 见 AINP 协议
• ⚠️ 跟 Rho 区分——任何人可做新 implementation

Inner processor

支持嵌套 DSL 的解析器机制——容器 capability 解析 inner content 时重新跑完整 markdown + AINP DSL pipeline。 详见 Inner processor。

Interact

Capability：可交互控件 + 输出模板的容器。AINP 所有动态行为的根。 详见 Interact controls。

L

Layout

Capability：N 列 grid + cards。 详见 Layout。

M

Marker class

AINP 输出 HTML 上的 CSS class（前缀 rho-），让 reader 识别 + hydrate。 e.g., rho-callout, rho-tabs, rho-interact。 详见 HTML output schema。

Mini DSL

AINP 协议内的纯函数表达式语言，用在 {} 占位符 + computed 声明里。 不是 JavaScript——无 eval / 无 IO / 无副作用。 详见 Computed §expression mini DSL 或 AINP §20。

Modal

Capability：点击展开浮层。 详见 Modal。

Modifier (STL)

STL 语法中 ::mod(key=value, key=value) 部分，附在边后表达边的属性。

N

Namespace

Capability：让多个 interact 块共享 state——namespace finance 声明。 详见 Shared state。

Nested DSL

任意 DSL 块可嵌入其他 DSL 块。 详见 Nested DSL。

P

Plain-text fallback

参见 Fallback (carrier)。

Profile (scenario)

AINP 协议的典型应用场景 capability set（Education / Calculator / Data viz / Animation / Documentation / AI-Generated）。 详见 AINP 协议。

R

Reactive store

AINP runtime 内存里的 state 容器，按 namespace 隔离。Source variables / computed 都存这。

Reactive update

Source 变化 → 拓扑传播到所有 dependent computed → template 重渲染。详见 AINP §7。

Reader (AINP-conformant)

实现 AINP 协议的 reader / library / app。不限 vendor / language。

Rho

scos-lab 维护的 AINP 参考实现：

• npm library @rho/md（当前包名 stl-md，rename 中）
• Desktop reader app Rho（Tauri 2 + React 19）
• Cloud SaaS cloud.rho.md（建设中）
• Documentation site rho.md/docs.html（即本站）

⚠️ Rho ≠ AINP——Rho 是 AINP 的实现，不是协议本身。

Runtime

AINP pipeline 后半段——HTML 注入 DOM 后 hydrate 成 interactive components。必须在浏览器跑。 对照 Build-time。

S

Sanitizer (SVG)

剥离危险 SVG 元素 / 属性 (<script> / on* event / javascript: URLs / etc.)。 详见 AINP §17.3。

scos-lab

AINP 协议作者 + Rho 参考实现的维护组织。

• GitHub: scos-lab
• Email: [email protected]

Slider

AINP interact 控件之一：slider name min max initial step。

Spec

AINP 的早期 v0.0-v0.6 历史版本叫 "Markview Display Spec"，统一在 AINP v1 后保留作历史参考。

State container

AINP 唯一的 state-mutable capability：interact。其他容器全是结构容器（不持有 state）。

Stepper

Capability：序列步骤展示，含 Prev/Next。 详见 Stepper。

STL

Semantic Tension Language —— scos-lab 的另一开放协议，用 [A] -> [B] ::mod(...) 语法表达知识图谱关系。 AINP 内含一个 capability：STL syntax highlighting（仅高亮，不解释 STL 语义）。

T

Tabs

Capability：同空间多视图切换。 详见 Tabs。

Template

interact 块的输出部分，三种类型：

• template stl: —— 文本 / STL 输出（实际任意纯文本）
• template vega-lite: —— Vega-Lite chart spec
• template svg: —— SVG 场景

详见 Interact text template。

Timeline

Capability：垂直时间线展示事件序列。 详见 Timeline。

Timer

Capability：自动跳变数值，驱动动画。4 modes: loop / once / pause / pingpong。 详见 Timer。

V

Vega-Lite

外部图表库——AINP 通过 template vega-lite: 集成。 详见 Interact + Vega-Lite chart 或 Vega-Lite 官网。

缩略词速查

See also

• AINP v1 protocol document —— 协议权威定义
• Writer's Guide —— 写作者
• Developer Reference —— 集成开发者
• AI/LLM Guide —— AI 生成集成
• Comparison with other tools
• FAQ