Canvas Plugin yeniden düzenlemesi

Canvas az kullanılan ve deneyseldir. Onu temel bir özellik olarak değil, paketle birlikte sunulan bir Plugin olarak değerlendirin. Temel; genel Gateway, Node, HTTP, kimlik doğrulama, yapılandırma ve yerel istemci altyapısını koruyabilir ancak Canvas'a özgü davranışlar extensions/canvas altında bulunmalıdır.

Hedef

Mevcut eşleştirilmiş Node davranışını koruyarak Canvas sahipliğini extensions/canvas konumuna taşıyın:

• aracıya yönelik 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 belgelerinin somutlaştırılması Canvas Plugin altında gerçekleştirilir
• CLI komutu uygulaması Canvas Plugin altında bulunur veya Plugin sahipliğindeki bir çalışma zamanı dışa aktarım modülü üzerinden yetki devreder
• belgeler ve Plugin envanteri Canvas'ı deneme aşamasında ve Plugin destekli olarak tanımlar

Hedef dışı konular

• Bu yeniden düzenlemede yerel uygulamanın Canvas kullanıcı arayımını yeniden tasarlamayın.
• Ayrı bir ürün kararı Canvas'ın silinmesi gerektiğini belirtmedikçe iOS, Android veya macOS'tan Canvas protokolü/istemci desteğini kaldırmayın.
• En az bir başka paketle birlikte sunulan Plugin aynı bağlantı noktasına ihtiyaç duymadıkça yalnızca Canvas için geniş kapsamlı bir Plugin hizmeti çatısı oluşturmayın.

Geçerli dalın durumu

Tamamlananlar:

• extensions/canvas konumuna paketle birlikte sunulan Plugin paketi eklendi.
• extensions/canvas/openclaw.plugin.json eklendi.
• Aracı canvas aracı src/agents/tools/canvas-tool.ts konumundan extensions/canvas/src/tool.ts konumuna taşındı.
• createCanvasTool temel kaydı src/agents/openclaw-tools.ts dosyasından kaldırıldı.
• Canvas ana makine uygulaması src/canvas-host konumundan extensions/canvas/src/host konumuna taşındı.
• Testler, paketleme ve harici herkese açık Canvas yardımcıları için Plugin sahipliğindeki uyumluluk dışa aktarım modülü olarak extensions/canvas/runtime-api.ts korundu.
• Canvas belgelerinin somutlaştırılması 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 konumuna taşındı.
• Canvas ana makine URL'si ve kapsamlı yetenek yardımcıları extensions/canvas/src konumuna taşındı.
• Canvas Node komutu varsayılanları sabit kodlanmış temel listelerden çıkarılarak Plugin nodeInvokePolicies bölümüne taşındı.
• plugins.entries.canvas.config.host konumuna Plugin sahipliğinde Canvas ana makine yapılandırması eklendi.
• Canvas ve A2UI HTTP sunumu Canvas Plugin HTTP rotası kaydının arkasına taşındı.
• Plugin sahipliğindeki 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 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 sahipliğinde barındırılan medya çözümleyicileri eklendi.
• Canvas'ın üst komut yolunu elle belirtmeden openclaw nodes canvas komutunu Plugin sahipliğinde bir Node özelliği olarak bildirebilmesi için api.registerNodeCliFeature(...) eklendi.
• Üretimdeki extensions/canvas/runtime-api.js içe aktarımları src/** dosyalarından 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 sunulan Plugin varlık kancalarıyla değiştirildi.
• Çalışma zamanındaki eski ü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çiminde yeniden yazması için Canvas doctor geçişi korundu.
• Eski aracı Canvas protokolü uyumluluğu Gateway protokolü v4'ün arkasından kaldırıldı. Yerel istemciler ve Gateway'ler artık yalnızca pluginSurfaceUrls.canvas ile node.pluginSurface.refresh kullanıyor; kullanımdan kaldırılan canvasHostUrl, canvasCapability ve node.canvas.capability.refresh yolu bu deneysel yeniden düzenlemede kasıtlı olarak desteklenmiyor.
• Oluşturulan Plugin envanteri Canvas'ı içerecek şekilde güncellendi.
• docs/plugins/reference/canvas.md konumuna Plugin başvuru belgeleri eklendi.

Temelin sahipliğinde kaldığı bilinen Canvas yüzeyleri:

• apps/ altındaki yerel uygulama Canvas işleyicileri Canvas Plugin yüzeyini kasıtlı olarak kullanmaya devam ediyor
• apps/ altındaki yerel uygulama Canvas protokolü/istemci işleyicileri
• yayımlanan yapıt çı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 sahipliğinde

Hedef yapı

extensions/canvas şunların sahibi olmalıdır:

• Plugin manifestosu ve paket meta verileri
• aracı aracı kaydı
• Node çağırma komutu ilkesi
• 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

Temel yalnızca genel bağlantı noktalarının sahibi olmalıdır:

• Plugin keşfi ve kaydı
• genel aracı aracı kayıt defteri
• genel Node çağırma ilkesi kayıt defteri
• genel Gateway HTTP/kimlik doğrulama 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 sunulan Plugin varlık kancası keşfi

Yerel uygulamalar protokol istemcileri olarak Canvas komut işleyicilerini koruyabilir. Bunlar Plugin çalışma zamanının sahibi değildir.

Geçiş adımları

1. plugins.entries.canvas.config.host öğesini Plugin sahipliğindeki yapılandırma yüzeyi olarak değerlendirin.
2. Belgeleri Canvas'ın deneysel ve paketle birlikte sunulan bir Plugin olarak tanımlanacağı şekilde güncelleyin.
3. Odaklanmış Canvas testlerini, Plugin envanteri denetimlerini, Plugin SDK API denetimlerini ve çalışma zamanı sınırlarından etkilenen derleme/tür kapılarını çalıştırın.

Denetim kontrol listesi

Yeniden düzenlemenin tamamlandığını belirtmeden önce:

• rg "src/canvas-host|../canvas-host" hiçbir etkin kaynak içe aktarımı döndürmez.
• rg "canvas-tool|createCanvasTool" src temel sahipliğinde bir Canvas aracı uygulaması bulmaz.
• rg "canvas.present|canvas.snapshot|canvas.a2ui" src/gateway genel Plugin ilkesi testleri dışında sabit kodlanmış izin listesi varsayılanları bulmaz.
• rg "extensions/canvas/runtime-api" src --glob '!**/*.test.ts' boş sonuç döndürür.
• rg "canvas-documents" src boş sonuç döndürür.
• rg "registerNodesCanvasCommands|nodes-canvas" src boş sonuç döndürür; Canvas Plugin, iç içe Plugin CLI meta verileri aracılığıyla openclaw nodes canvas komutunu kaydeder.
• rg "createCanvasHostHandler|handleA2uiHttpRequest" src/gateway 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 sahipliğindeki yolları bulur.
• pnpm plugins:inventory:check başarılı olur.
• pnpm plugin-sdk:api:check başarılı olur veya oluşturulan API temel çizgileri kasıtlı olarak güncellenip incelenir.
• Hedeflenen Canvas testleri başarılı olur.
• Canvas ana makinesi/A2UI yolları için değişen hat testleri başarılı olur.
• PR gövdesi Canvas'ın deneysel ve Plugin destekli olduğunu açıkça belirtir.

Doğrulama komutları

Yineleme sırasında hedefli yerel denetimleri kullanın:

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.tspnpm test src/gateway/server.plugin-node-capability-auth.test.ts src/gateway/server-import-boundary.test.tspnpm test extensions/canvas/src/config-migration.test.ts src/commands/doctor-legacy-config.migrations.test.tspnpm 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.tspnpm tsgo:extensionspnpm plugins:inventory:checkpnpm plugin-sdk:api:check

Çalışma zamanı dışa aktarım modülü, gecikmeli içe aktarım, paketleme veya yayımlanan Plugin yüzeyleri değişirse göndermeden önce pnpm build komutunu çalıştırın.