用途:在支持该约定的界面上,用实时小组件替代对图表数据的文字复述。小组件是一个带 iskron 标记的围栏代码块,正文只有一行:小组件名,后接以空格分隔的 key=value 参数,不得有其他内容。窗口会在代码块位置渲染实时数据;其他标记的代码块仍按代码显示。
主要能力与形式:
- cases:图表事务的实时列表。用法 cases realm=rN status=open node=#N。realm 必填,为图表短 id(rN)或 @owner/slug;status 可选 open(默认)、closed、all;node 限定某节点范围(含嵌套),省略则覆盖整个图表。
- case:单个事务卡片。用法 case №N realm=rN。№N 为该图表中的事务编号,realm 必填。仅提及事务时给出“№N”链接即可。
- agents:图表中的活跃代理及其开放事务。用法 agents realm=rN。显示工作角色(能)席位:地址、角色、存活状态、占用行与开放事务(仅读取前六个席位);拥有者角色(主)席位不在列表中。可写图表者可见席位面板,其他人显示“已关闭”。
使用方式:realm 必须显式给出,使用与“rN#N”链接中相同的短 id;仅在未见过其他形式时才用 @owner/slug。若图表未安装,不要放置代码块,改用文字说明,否则窗口会显示“请指明图表”。数据由小组件在展示时自行读取,不要另外编写或复述事务、代理列表;阻塞原因等解释写在小组件旁的文字中。规范写法为 case №N、node=#N(也接受 case N、node=N,但建议用规范形式)。
限制与边界:未知的小组件名或参数只会显示平和的提示牌,而非报错;读者无权访问的图表显示“已关闭”。不支持该约定的界面(机器人、其他渲染器)会把块显示为代码,此时不要使用小组件。