​

Canvas plugin yeniden düzenlemesi

​

Amaç

• ajanın kullanabildiği canvas aracı Canvas plugin tarafından kaydedilir
• Canvas Node komutlarına yalnızca Canvas plugin bunları kaydettiğinde izin verilir
• A2UI ana makine/kaynak dosyaları Canvas plugin altında bulunur
• Canvas belge somutlaştırması Canvas plugin altında bulunur
• CLI komut uygulaması Canvas plugin altında bulunur veya plugin’e ait bir çalışma zamanı barrel’ı üzerinden yetki devreder
• belgeler ve plugin envanteri Canvas’ı deneysel ve plugin destekli olarak tanımlar

​

Kapsam dışı hedefler

• Bu yeniden düzenleme kapsamında yerel uygulamanın Canvas kullanıcı arayımını yeniden tasarlamayın.
• Ayrı bir ürün kararı Canvas’ın silinmesi gerektiğini belirtmediği sürece iOS, Android veya macOS’tan Canvas protokolü/istemci desteğini kaldırmayın.
• En az bir başka paketle birlikte gelen plugin aynı bağlantı noktasına ihtiyaç duymadığı sürece yalnızca Canvas için geniş kapsamlı bir plugin hizmeti çerçevesi oluşturmayın.

​

Mevcut dal durumu

• extensions/canvas içine paketle birlikte gelen plugin paketi eklendi.
• extensions/canvas/openclaw.plugin.json eklendi.
• Ajanın canvas aracı src/agents/tools/canvas-tool.ts konumundan extensions/canvas/src/tool.ts konumuna taşındı.
• createCanvasTool için temel katmandaki kayıt src/agents/openclaw-tools.ts üzerinden kaldırıldı.
• Canvas ana makine uygulaması src/canvas-host konumundan extensions/canvas/src/host konumuna taşındı.
• extensions/canvas/runtime-api.ts; testler, paketleme ve harici genel Canvas yardımcıları için plugin’e ait uyumluluk barrel’ı olarak korundu.
• Canvas belge somutlaştırması src/gateway/canvas-documents.ts konumundan extensions/canvas/src/documents.ts konumuna taşındı.
• Canvas CLI uygulaması ve A2UI JSONL yardımcıları extensions/canvas/src/cli.ts içine taşındı.
• Canvas ana makine URL’si ve kapsamlı yetenek yardımcıları extensions/canvas/src içine taşındı.
• Canvas Node komutu varsayılanları sabit kodlanmış temel katman listelerinden çıkarılarak plugin nodeInvokePolicies içine taşındı.
• plugins.entries.canvas.config.host konumuna plugin’e ait Canvas ana makine yapılandırması eklendi.
• Canvas ve A2UI HTTP sunumu, Canvas plugin HTTP rotası kaydının arkasına taşındı.
• Plugin’e ait HTTP rotaları için genel plugin WebSocket yükseltme yönlendirmesi eklendi.
• Canvas’a özgü Gateway ana makine URL’si ve Node yeteneği kimlik doğrulaması, genel olarak barındırılan plugin yüzeyi ve Node yeteneği yardımcılarıyla değiştirildi.
• Canvas belge URL’lerinin, temel katmanın Canvas belge iç bileşenlerini içe aktarması yerine Canvas plugin üzerinden çözümlenmesi için plugin’e ait barındırılan medya çözümleyicileri eklendi.
• Canvas’ın üst komut yolunu elle yazmadan openclaw nodes canvas öğesini plugin’e ait bir Node özelliği olarak bildirebilmesi için api.registerNodeCliFeature(...) eklendi.
• src/** içindeki üretim extensions/canvas/runtime-api.js içe aktarımları kaldırıldı.
• A2UI paket kaynağı apps/shared/OpenClawKit/Tools/CanvasA2UI konumundan extensions/canvas/src/host/a2ui-app konumuna taşındı.
• A2UI derleme/kopyalama uygulaması extensions/canvas/scripts altına taşındı ve kök derleme bağlantıları genel, paketle birlikte gelen plugin varlık kancalarıyla değiştirildi.
• Eski çalışma zamanı üst düzey canvasHost yapılandırma diğer adı kaldırıldı.
• openclaw doctor --fix komutunun eski canvasHost yapılandırmalarını plugins.entries.canvas.config.host biçimine yeniden yazması için Canvas doctor geçişi korundu.
• Eski ajan Canvas protokolü uyumluluğu, Gateway protokolü v4 kapsamında kaldırıldı. Yerel istemciler ve Gateway’ler artık yalnızca pluginSurfaceUrls.canvas ile node.pluginSurface.refresh kullanır; kullanımdan kaldırılan canvasHostUrl, canvasCapability ve node.canvas.capability.refresh yolu bu deneysel yeniden düzenlemede kasıtlı olarak desteklenmez.
• Oluşturulan plugin envanteri Canvas’ı içerecek şekilde güncellendi.
• docs/plugins/reference/canvas.md konumuna plugin referans belgeleri eklendi.

• apps/ altındaki yerel uygulama Canvas işleyicileri hâlâ kasıtlı olarak Canvas plugin yüzeyini kullanıyor
• apps/ altındaki yerel uygulama Canvas protokolü/istemci işleyicileri
• yayımlanan artefakt çıktısı, geriye dönük uyumlu çalışma zamanı araması için hâlâ dist/canvas-host/a2ui kullanıyor; ancak kopyalama adımı artık plugin’e ait

​

Hedef yapı

• plugin manifesti ve paket meta verileri
• ajan aracı kaydı
• Node çağırma komutu politikası
• Canvas ana makinesi ve A2UI çalışma zamanı
• Canvas A2UI paket kaynağı ve varlık derleme/kopyalama betikleri
• Canvas belgesi oluşturma ve varlık çözümleme
• Canvas CLI uygulaması
• Canvas belgeleri sayfası ve plugin envanteri girdisi

• plugin keşfi ve kaydı
• genel ajan aracı kayıt defteri
• genel Node çağırma politikası kayıt defteri
• genel Gateway HTTP/kimlik doğrulaması ve WebSocket yükseltme yönlendirmesi
• genel barındırılan plugin yüzeyi URL çözümlemesi
• genel barındırılan medya çözümleyicisi kaydı
• genel Node yeteneği aktarımı
• genel yapılandırma altyapısı
• genel paketle birlikte gelen plugin varlık kancası keşfi

​

Geçiş adımları

1. plugins.entries.canvas.config.host öğesini plugin’e ait yapılandırma yüzeyi olarak ele alın.
2. Belgeleri Canvas’ın deneysel ve paketle birlikte gelen bir plugin olarak tanımlanacağı şekilde güncelleyin.
3. Odaklanmış Canvas testlerini, plugin envanteri kontrollerini, plugin SDK API kontrollerini ve çalışma zamanı sınırlarından etkilenen derleme/tür kapılarını çalıştırın.

​

Denetim kontrol listesi

• rg "src/canvas-host|../canvas-host" hiçbir etkin kaynak içe aktarımı döndürmez.
• rg "canvas-tool|createCanvasTool" src temel katmana ait hiçbir Canvas aracı uygulaması bulmaz.
• rg "canvas.present|canvas.snapshot|canvas.a2ui" src/gateway genel plugin politikası testleri dışında sabit kodlanmış hiçbir izin listesi varsayılanı bulmaz.
• rg "extensions/canvas/runtime-api" src --glob '!**/*.test.ts' boştur.
• rg "canvas-documents" src boştur.
• rg "registerNodesCanvasCommands|nodes-canvas" src boştur; Canvas plugin, iç içe plugin CLI meta verileri aracılığıyla openclaw nodes canvas kaydını yapar.
• rg "createCanvasHostHandler|handleA2uiHttpRequest" src/gateway hiçbir Gateway çalışma zamanı sahipliği döndürmez.
• rg "apps/shared/OpenClawKit/Tools/CanvasA2UI|canvas-a2ui-copy|extensions/canvas/src/host/a2ui" scripts .github package.json yalnızca uyumluluk sarmalayıcılarını veya plugin’e ait yolları bulur.
• pnpm plugins:inventory:check başarılı olur.
• pnpm plugin-sdk:api:check başarılı olur veya oluşturulan API sözleşmesi kayıtları kasıtlı olarak güncellenip incelenir.
• Hedeflenen Canvas testleri başarılı olur.
• Canvas ana makinesi/A2UI yolları için değişen işlem hattı testleri başarılı olur.
• PR gövdesi Canvas’ın deneysel ve plugin destekli olduğunu açıkça belirtir.

​

Doğrulama komutları

pnpm test extensions/canvas/src/host/server.test.ts extensions/canvas/src/host/server.state-dir.test.ts extensions/canvas/src/host/file-resolver.test.ts
pnpm test src/gateway/server.plugin-node-capability-auth.test.ts src/gateway/server-import-boundary.test.ts
pnpm test extensions/canvas/src/config-migration.test.ts src/commands/doctor-legacy-config.migrations.test.ts
pnpm test test/scripts/changed-lanes.test.ts test/scripts/build-all.test.ts extensions/canvas/scripts/bundle-a2ui.test.ts test/scripts/bundled-plugin-assets.test.ts extensions/canvas/scripts/copy-a2ui.test.ts src/infra/run-node.test.ts
pnpm tsgo:extensions
pnpm plugins:inventory:check
pnpm plugin-sdk:api:check