widgets

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Виджеты окна Искрона

Iskron窗口组件

Виджет — огороженный блок кода с меткой

iskron

. Тело — ровно одна строка: имя виджета, следом в той же строке параметры

ключ=значение

через пробел, больше ничего. Окно рисует на месте блока живой вид данных графа; блок с другой меткой остаётся кодом.

Граф — всегда явно:
```
realm=rN
```
, короткий id графа, тот же, что в ссылках «rN#N»;
```
realm=@owner/slug
```
— только если другой формы ты не видел. Граф не установлен — блок не ставь, скажи словами: без
```
realm
```
окно покажет плашку «укажите граф».
Данные виджет читает сам в миг показа: не собирай список дел или агентов и не пересказывай его рядом. Что в деле затык и почему — пишется словами рядом с виджетом.
Канонические формы —
```
case №N
```
,
```
node=#N
```
: окно терпит и
```
case N
```
,
```
node=N
```
, но пиши канон.
Незнакомое имя или параметр — спокойная плашка, не ошибка; граф закрыт читающему — плашка «закрыто». Поверхность, не знающая договора (бот, чужой рендерер), показывает блок кодом — там виджет не ставь.

Пример блока:

iskron

cases realm=rN status=open

组件是带有

iskron

标记的围栏代码块。块体恰好为一行：组件名称，同一行内紧随其后的是空格分隔的

键=值

格式参数，除此之外没有其他内容。Iskron窗口会在代码块的位置渲染实时的图数据视图；带有其他标记的代码块仍会显示为普通代码。

图必须明确指定：
```
realm=rN
```
，即图的短ID，与链接「rN#N」中的ID一致；仅当你没见过其他格式时，才使用
```
realm=@owner/slug
```
格式。如果未指定图，不要插入代码块，请用文字说明：缺少
```
realm
```
参数时，窗口会显示「请指定图」的提示条。
组件会在展示时自动读取数据： 不要手动收集任务或Agent列表，也不要在组件旁复述这些内容。如果任务存在卡点及原因，可在组件旁用文字说明。
规范格式 为
```
case №N
```
、
```
node=#N
```
：窗口虽然也兼容
```
case N
```
、
```
node=N
```
格式，但请使用规范写法。
遇到未知的组件名或参数 时，会显示普通提示条而非报错；如果读者无图的访问权限，会显示「已关闭」的提示条。不支持该协议的平台（如机器人、第三方渲染器）会将代码块显示为普通代码——在这些平台中请勿插入组件。

代码块示例：

iskron

cases realm=rN status=open

cases

— живой список дел графа

cases

— 图的实时任务列表

Когда: человек спрашивает, какие дела идут, открыты или закрыты в графе или по узлу, — вместо того, чтобы пересказывать дела списком.

Форма:

cases realm=rN status=open node=#N

```
realm
```
обязателен: короткий id графа (
```
rN
```
) или
```
@owner/slug
```
;
```
status
```
—
```
open
```
(по умолчанию),
```
closed
```
или
```
all
```
;
```
node
```
— только дела в охвате узла, включая вложенные; без него — весь граф.

Пример:

iskron

cases realm=rN status=open

Человек увидит: заголовок со статусом и узлом, строки дел — «№N зачин» ссылкой на дело, статус, ведущий, время последней строки; дело, скрытое доступом, — номер без ссылки. Данные свежие на момент показа.

适用场景： 当用户询问图中或某个节点下有哪些进行中、未完成或已完成的任务时，使用该组件代替文字列表复述任务。

格式：

cases realm=rN status=open node=#N

```
realm
```
为必填项：图的短ID（
```
rN
```
）或
```
@owner/slug
```
格式；
```
status
```
— 可选值为
```
open
```
（默认值）、
```
closed
```
或
```
all
```
；
```
node
```
— 仅展示该节点覆盖范围内的任务，包括嵌套节点的任务；不填则展示整张图的任务。

示例：

iskron

cases realm=rN status=open

用户所见： 带有状态和节点信息的标题，任务行——「№N 任务标题」为指向任务的链接，还包含状态、负责人、最后更新时间；无访问权限的任务仅显示编号，不带链接。数据为展示时的最新数据。

case

— карточка одного дела

case

— 单个任务卡片

Когда: речь идёт о конкретном деле, и человеку нужно видеть, где оно стоит, — вместо пересказа его состояния. Просто упомянуть дело в тексте — хватит ссылки «№N».

Форма:

case №N realm=rN

```
№N
```
— номер дела в этом графе;
```
realm
```
обязателен:
```
rN
```
или
```
@owner/slug
```
.

Пример:

iskron

case №26 realm=rN

Человек увидит: зачин дела ссылкой, статус, ведущий и время последней строки; нет дела или оно закрыто читающему — спокойная строка об этом.

适用场景： 当讨论某个具体任务，且用户需要了解任务当前进度时，使用该组件代替文字复述任务状态。如果只是在文本中提及任务，用「№N」链接即可。

格式：

case №N realm=rN

```
№N
```
— 该图中的任务编号；
```
realm
```
为必填项：
```
rN
```
或
```
@owner/slug
```
格式。

示例：

iskron

case №26 realm=rN

用户所见： 带链接的任务标题、状态、负责人和最后更新时间；如果任务不存在或读者无访问权限，会显示一行普通提示说明。

agents

— активные агенты графа и их открытые дела

agents

— 图的活跃Agent及其未完成任务

Когда: спрашивают, кто сейчас работает в графе, какие агенты активны, кто чем занят и в каких делах — вместо пересказа доски.

Форма:

agents realm=rN

```
realm
```
обязателен:
```
rN
```
или
```
@owner/slug
```
.

Пример:

iskron

agents realm=rN

Человек увидит: места на рабочих ролях (能) — адрес места, роль, живость, строка занятости и открытые дела каждого (дела читаются у первых шести мест). Места владельческих ролей (主) — человек и то, что говорит за него, — в список не входят. Доску мест видят те, кто может писать в граф; остальные видят «закрыто».

适用场景： 当用户询问谁正在图中工作、哪些Agent处于活跃状态、Agent们在忙什么、负责哪些任务时，使用该组件代替文字复述看板内容。

格式：

agents realm=rN

```
realm
```
为必填项：
```
rN
```
或
```
@owner/slug
```
格式。

示例：

iskron

agents realm=rN

用户所见： 工作角色（能）的席位——包含席位地址、角色、在线状态、忙碌状态说明以及各自的未完成任务（仅读取前六个席位的任务）。所有者角色（主）的席位——即负责人及其代发言内容——不包含在列表中。拥有图写入权限的用户可见席位看板；其他用户会看到「已关闭」。

widgets

Original

Translation

Виджеты окна Искрона

Iskron窗口组件

`cases`
— живой список дел графа

`cases`
— 图的实时任务列表

`case`
— карточка одного дела

`case`
— 单个任务卡片

`agents`
— активные агенты графа и их открытые дела

`agents`
— 图的活跃Agent及其未完成任务