Kanal sunumu yeniden düzenleme planı

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Durum

• ReplyPayload.presentation anlamsal ileti kullanıcı arayüzünü taşır.
• ReplyPayload.delivery.pin gönderilen ileti sabitleme isteklerini taşır.
• Paylaşılan ileti eylemleri, sağlayıcıya özgü components, blocks, buttons veya card yerine presentation, delivery ve pin alanlarını sunar.
• Core, Plugin tarafından bildirilen giden yetenekler üzerinden sunumu işler veya otomatik olarak daha basit bir biçime düşürür.
• Discord, Slack, Telegram, Mattermost, MS Teams ve Feishu işleyicileri genel sözleşmeyi kullanır.
• Discord kanal denetim düzlemi kodu artık Carbon destekli kullanıcı arayüzü kapsayıcılarını içe aktarmaz.

​

Sorun

• Core, buildCrossContextComponents üzerinden Discord biçimli bir bağlamlar arası işleyici kancasına sahiptir.
• Discord channel.ts, DiscordUiContainer üzerinden yerel Carbon kullanıcı arayüzünü içe aktarabilir; bu da çalışma zamanı kullanıcı arayüzü bağımlılıklarını kanal Plugin denetim düzlemine çeker.
• Ajan ve CLI, Discord components, Slack blocks, Telegram veya Mattermost buttons ve Teams veya Feishu card gibi yerel yük kaçış yolları sunar.
• ReplyPayload.channelData hem aktarım ipuçlarını hem de yerel kullanıcı arayüzü zarflarını taşır.
• Genel interactive modeli vardır, ancak Discord, Slack, Teams, Feishu, LINE, Telegram ve Mattermost tarafından zaten kullanılan daha zengin düzenlerden daha dardır.

​

Hedefler

• Core, bildirilen yeteneklere göre bir ileti için en iyi anlamsal sunuma karar verir.
• Eklentiler yetenekleri bildirir ve anlamsal sunumu yerel aktarım yüklerine işler.
• Web Denetim Kullanıcı Arayüzü, sohbetin yerel kullanıcı arayüzünden ayrı kalır.
• Yerel kanal yükleri, paylaşılan ajan veya CLI ileti yüzeyi üzerinden sunulmaz.
• Desteklenmeyen sunum özellikleri otomatik olarak en iyi metin gösterimine düşürülür.
• Gönderilen bir iletiyi sabitleme gibi teslim davranışları sunum değil, genel teslim meta verisidir.

​

Hedef olmayanlar

• buildCrossContextComponents için geriye dönük uyumluluk uyarlama katmanı yoktur.
• components, blocks, buttons veya card için herkese açık yerel kaçış yolları yoktur.
• Core içinde kanala özgü yerel kullanıcı arayüzü kitaplıkları içe aktarılmaz.
• Paketlenmiş kanallar için sağlayıcıya özgü SDK aralıkları yoktur.

​

Hedef model

type MessagePresentationTone = "neutral" | "info" | "success" | "warning" | "danger";

type MessagePresentation = {
  tone?: MessagePresentationTone;
  title?: string;
  blocks: MessagePresentationBlock[];
};

type MessagePresentationBlock =
  | { type: "text"; text: string }
  | { type: "context"; text: string }
  | { type: "divider" }
  | { type: "buttons"; buttons: MessagePresentationButton[] }
  | { type: "select"; placeholder?: string; options: MessagePresentationOption[] };

type MessagePresentationButton = {
  label: string;
  value?: string;
  url?: string;
  style?: "primary" | "secondary" | "success" | "danger";
};

type MessagePresentationOption = {
  label: string;
  value: string;
};

• interactive metin bloğu presentation.blocks[].type = "text" değerine eşlenir.
• interactive düğmeler bloğu presentation.blocks[].type = "buttons" değerine eşlenir.
• interactive seçim bloğu presentation.blocks[].type = "select" değerine eşlenir.

​

Teslim meta verileri

type ReplyPayloadDelivery = {
  pin?:
    | boolean
    | {
        enabled: boolean;
        notify?: boolean;
        required?: boolean;
      };
};

• delivery.pin = true, başarıyla teslim edilen ilk iletiyi sabitle anlamına gelir.
• notify varsayılan olarak false değerindedir.
• required varsayılan olarak false değerindedir; desteklenmeyen kanallar veya başarısız sabitleme, teslimi sürdürerek otomatik olarak daha basit bir davranışa düşer.
• El ile yapılan pin, unpin ve list-pins ileti eylemleri mevcut iletiler için kalır.

​

Çalışma zamanı yetenek sözleşmesi

type ChannelPresentationCapabilities = {
  supported: boolean;
  buttons?: boolean;
  selects?: boolean;
  context?: boolean;
  divider?: boolean;
  tones?: MessagePresentationTone[];
};

type ChannelDeliveryCapabilities = {
  pinSentMessage?: boolean;
};

type ChannelOutboundAdapter = {
  presentationCapabilities?: ChannelPresentationCapabilities;

  renderPresentation?: (params: {
    payload: ReplyPayload;
    presentation: MessagePresentation;
    ctx: ChannelOutboundSendContext;
  }) => ReplyPayload | null;

  deliveryCapabilities?: ChannelDeliveryCapabilities;

  pinDeliveredMessage?: (params: {
    cfg: OpenClawConfig;
    accountId?: string | null;
    to: string;
    threadId?: string | number | null;
    messageId: string;
    notify: boolean;
  }) => Promise<void>;
};

• Hedef kanalı ve çalışma zamanı bağdaştırıcısını çözümle.
• Sunum yeteneklerini iste.
• Desteklenmeyen blokları işlemeden önce daha basit biçime düşür.
• renderPresentation çağır.
• İşleyici yoksa sunumu metin yedeğine dönüştür.
• Başarılı gönderimden sonra, delivery.pin istenmiş ve destekleniyorsa pinDeliveredMessage çağır.

​

Kanal eşlemesi

• presentation alanını çalışma zamanına özel modüllerde components v2 ve Carbon kapsayıcılarına işle.
• Vurgu rengi yardımcılarını hafif modüllerde tut.
• Kanal Plugin denetim düzlemi kodundan DiscordUiContainer içe aktarımlarını kaldır.

• presentation alanını Block Kit’e işle.
• Ajan ve CLI blocks girdisini kaldır.

• Metin, bağlam ve ayırıcıları metin olarak işle.
• Hedef yüzey için yapılandırıldığında ve izin verildiğinde eylemleri ve seçimi satır içi klavyeler olarak işle.
• Satır içi düğmeler devre dışı olduğunda metin yedeğini kullan.
• ACP konu sabitlemesini delivery.pin alanına taşı.

• Yapılandırıldığında eylemleri etkileşimli düğmeler olarak işle.
• Diğer blokları metin yedeği olarak işle.

• presentation alanını Adaptive Cards olarak işle.
• El ile pin/unpin/list-pins eylemlerini koru.
• Graph desteği hedef konuşma için güvenilirse isteğe bağlı olarak pinDeliveredMessage uygula.

• presentation alanını etkileşimli kartlara işle.
• El ile pin/unpin/list-pins eylemlerini koru.
• API davranışı güvenilirse gönderilen ileti sabitleme için isteğe bağlı olarak pinDeliveredMessage uygula.

• presentation alanını mümkün olduğunda Flex veya şablon iletilerine işle.
• Desteklenmeyen bloklar için metne geri dön.
• LINE kullanıcı arayüzü yüklerini channelData alanından kaldır.

• Sunumu ölçülü biçimlendirmeyle metne dönüştür.

​

Yeniden düzenleme adımları

1. ui-colors.ts dosyasını Carbon destekli kullanıcı arayüzünden ayıran ve extensions/discord/src/channel.ts içinden DiscordUiContainer kaldıran Discord sürüm düzeltmesini yeniden uygula.
2. ReplyPayload, giden yük normalleştirme, teslim özetleri ve kanca yüklerine presentation ve delivery ekle.
3. Dar bir SDK/çalışma zamanı alt yolunda MessagePresentation şeması ve ayrıştırıcı yardımcıları ekle.
4. İleti yetenekleri olan buttons, cards, components ve blocks yerine anlamsal sunum yeteneklerini koy.
5. Sunum işleme ve teslim sabitleme için çalışma zamanı giden bağdaştırıcı kancaları ekle.
6. Bağlamlar arası bileşen oluşturmayı buildCrossContextPresentation ile değiştir.
7. src/infra/outbound/channel-adapters.ts dosyasını sil ve kanal Plugin türlerinden buildCrossContextComponents kaldır.
8. maybeApplyCrossContextMarker işlevini yerel parametreler yerine presentation ekleyecek şekilde değiştir.
9. Plugin-dispatch gönderim yollarını yalnızca anlamsal sunum ve teslim meta verilerini kullanacak şekilde güncelle.
10. Ajan ve CLI yerel yük parametrelerini kaldır: components, blocks, buttons ve card.
11. Yerel ileti aracı şemaları oluşturan SDK yardımcılarını kaldır ve yerine sunum şeması yardımcılarını koy.
12. Kullanıcı arayüzü/yerel zarfları channelData alanından kaldır; kalan her alan gözden geçirilene kadar yalnızca aktarım meta verilerini tut.
13. Discord, Slack, Telegram, Mattermost, MS Teams, Feishu ve LINE işleyicilerini taşı.
14. İleti CLI, kanal sayfaları, Plugin SDK ve yetenek yemek kitabı belgelerini güncelle.
15. Discord ve etkilenen kanal giriş noktaları için içe aktarım yayılım profillemesi çalıştır.

​

Testler

• Sunum normalleştirme testleri.
• Desteklenmeyen bloklar için sunum otomatik düşürme testleri.
• Plugin dispatch ve Core teslim yolları için bağlamlar arası işaretleyici testleri.
• Discord, Slack, Telegram, Mattermost, MS Teams, Feishu, LINE ve metin yedeği için kanal işleme matrisi testleri.
• Yerel alanların kaldırıldığını kanıtlayan ileti aracı şema testleri.
• Yerel bayrakların kaldırıldığını kanıtlayan CLI testleri.
• Carbon’u kapsayan Discord giriş noktası içe aktarım tembelliği regresyonu.
• Telegram ve genel yedeği kapsayan teslim sabitleme testleri.

​

Açık sorular

• delivery.pin ilk geçişte Discord, Slack, MS Teams ve Feishu için de mi uygulanmalı, yoksa önce yalnızca Telegram mı?
• delivery sonunda replyToId, replyToCurrent, silent ve audioAsVoice gibi mevcut alanları da içine almalı mı, yoksa gönderim sonrası davranışlara odaklı mı kalmalı?
• Sunum doğrudan görselleri veya dosya referanslarını desteklemeli mi, yoksa medya şimdilik kullanıcı arayüzü düzeninden ayrı mı kalmalı?

​

İlgili

• Kanallara genel bakış
• İleti sunumu