DSH Game Studio
Küçük bir oyunu tek cümleyle tarif edin — DeepSeek Harness sohbetinin kenar çubuğunda oynayın, yapay zeka görselleriyle değiştirin, tek bir HTML dosyası olarak dışa aktarın.
10 ajan aracı • canlı kenar çubuğu önizlemesi • 2D ve 3D voksel şablonları • önce maliyet kontrolü yapan OpenAI veya Codex görselleri • kendi kendine oynayan oynanış testleri • sürüm geçmişi • tek dosya dışa aktarma
English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Français · Español · Deutsch · Português · Русский · हिन्दी · Türkçe · ไทย · Tiếng Việt · Bahasa Indonesia
Paket: @zseven-w/dsh-game-studio · Güncel eklenti sürümü: 0.1.0-rc.5 · DSH 0.2.1-rc.5 ile test edildi
Ajan çalışırken oyun sağ kenar çubuğunda oynanır; altında seçmeniz için numaralandırılmış yapay zeka görsel adayları bekler
## Neden DSH Game Studio
Ajandan günlük dille bir oyun isteyin — "3D bir oyun: kırmızı bir panda ormanda bambu filizleri toplar ve yaban domuzlarından kaçar" — ajan da şablondan bir oyun oluşturur, çalıştığını kontrol etmek için oynar ve hemen oynayabileceğiniz bir kenar çubuğunda gösterir. Karakterler kodla çizilmiş modeller olarak başlar; gerçek görseller istediğinizde ajan OpenAI veya Codex oturumunuzla aday görseller üretir, numarasıyla birini seçersiniz ve oyun onu yerine koyar. Her değişiklik geri dönebileceğiniz bir sürümdür ve bitmiş oyun çevrimdışı tek bir HTML dosyası olarak dışa aktarılır.
| | |
| --- | --- |
| 🎮 **İlk yanıttan itibaren oynanabilir** | İki şablon — 2D üstten görünüşlü bir oyun ve aynı döngünün 3D voksel dünyasındaki hali (three.js) — ajan bunları tarif ettiğiniz oyuna dönüştürür: karakterler, kurallar, seviyeler, ekranlar. |
| 🖥️ **Canlı kenar çubuğu önizlemesi** | Oyun sohbetin yanındaki korumalı bir panelde çalışır, her değişiklikte yeniden derlenir ve altında görsel yuvalarını, adayları ve sürümleri listeler. Yatay oyunlar geniş bir sahne alır. |
| 🎨 **Önce maliyet kontrolüyle kendi görselleriniz** | `game_studio_generate_asset`, OpenAI görsel API'si veya yerel Codex CLI ile yuva başına numaralandırılmış adaylar üretir. Herhangi bir harcama yapılmadan önce hizmeti, görsel sayısını ve beklenen maliyeti gösteren bir onay kartı alırsınız. Sohbete eklediğiniz bir resim referans olabilir. |
| 🤖 **Kendi kendine oynayan oynanış testleri** | `game_studio_playtest` en son kodu başsız (headless) bir Chrome veya Edge'de oynar ve aşamaları, skoru, kare hızını, betik hatalarını ve ekran görüntülerini raporlar. Yön tuşlarıyla yönetilmeyen oyunlar (ızgaralar, kartlar, nişan alma, ritim…) `window.__autoplay` tanımlar, böylece oynanış testi oyunun gerçek döngüsünü oynar. |
| 🕰️ **Sürüm geçmişi** | Oyunu değiştiren her derleme kaydedilir; `game_studio_restore_version` kodu, kuralları ve görselleri birlikte geri getirir. |
| 📦 **Tek dosya dışa aktarma** | `game_studio_export` ağ erişimi olmayan, bağımsız bir HTML dosyası yazar — istediğiniz tarayıcıda açın veya herhangi bir statik barındırma hizmetine koyun. |
| 📱 **Telefonunuzda deneyin** | `game_studio_share` kenar çubuğunda bir QR koduyla yerel ağınızda geçici, salt okunur bir bağlantı — veya herhangi bir ağdaki arkadaşlarınızın oynayabilmesi için Cloudflare Quick Tunnel (`cloudflared`) üzerinden geçici bir herkese açık bağlantı — açar. |
| 🌐 **GitHub Pages'te yayınlayın** | `game_studio_publish` derlenmiş HTML'yi (veya tüm oyun duvarını) oturum açılmış `gh` hesabınızın altındaki herkese açık bir depoya gönderir ve bilgisayarınızı kapattıktan sonra da açık kalan kalıcı bir bağlantı için GitHub Pages'i etkinleştirir. |
| 🗂️ **Oyunlarım** | Kenar çubuğundaki **+** ile **Game Studio · My games**'i seçin: çalışma alanındaki her oyun son test görüntüsüyle bir kutucuk olarak listelenir; 2D/3D süzgeci ve tarih, sürüm ya da ada göre sıralama vardır. Tıklayıp oynayın; agent da token da gerekmez. Ayrıca yayınlanmış oyunlara kendi oyunlarınızın yanında göz atıp oynamak için çevrimiçi oyun kaynaklarına (`owner/repo`, GitHub depo URL'si veya GitHub Pages URL'si) abone olabilirsiniz. **Export wall**, yerel oyunlarınızı arkadaşlarınıza gönderebileceğiniz tek bir çevrimdışı sayfada toplar. |
## Onunla yapılan oyunlar
Testlerimizden dört oyun. Her biri yeni bir oturumda, altındaki tek cümleyle başladı (istemler Çinceden çevrildi); bazıları sonradan aynı oturumdaki isteklerle düzeltildi, belirtildiği gibi. Oynanış, her oyunun kendi otomatik oynatıcısıyla kaydedildi.
Ay Işığı Tilkisi: Fener Adası — 3D voksel şablonu, gerçek oynanış
“Küçük bir oyun yap: yavru bir tilki ay ışığındaki ormanda fener toplasın ve dikenli canavarlardan kaçsın.”
2D şablon; karakterler sonra seçilen yapay zekâ görselleriyle değiştirildi |
“3D bir oyun yap: yavru bir tilki voksel bir adada fener toplasın ve dikenli canavarlardan kaçsın.”
3D voksel şablon; fener modeli sonraki bir istekte yeniden yapıldı |
“3D bir oyun yap: yavru bir penguen buzdağında balık toplasın ve foklardan kaçsın.”
3D; kırmızı şapka sonraki bir istekle eklendi |
“3D bir oyun yap: bir kızıl panda bambu ormanında bambu filizi toplasın ve yaban domuzlarından kaçsın.”
3D; karakterler sonra yapay zekâ görselleriyle değiştirildi, orman 3D kaldı |
## Ne kadar iyi çalışıyor
Gerçek bir DSH içinde DeepSeek-V4.1-Flash ile ölçüldü; her oyun yeni bir oturumda tek bir cümleden üretildi ve bağımsız bir oynanış testiyle puanlandı (2026-11-04/05):
- **Topla ve kaç oyunları** (şablonların kendi alanı): 10 farklı isteğin 10'u da ilk denemede oynanabilir durumdaydı; oyun başına ortanca süre yaklaşık 14 dakika.
- **Diğer türler** — 3'lü eşleştirme, kutu itme, kule savunma, basketbol, platform, ritim, yarış, kart savaşı, çiftçilik, kafe yönetimi: 10'unun tamamı oynanabilir çıktı ancak ortanca yaklaşık 26 dakika sürdü. `__autoplay`, özel görsel yuvaları ve yatay mod desteği eklendikten sonra dördü yeniden çalıştırıldı ve 8–18 dakika sürdü. Örneklem küçüktür.
## Araçlar
| Araç | Ne yapar |
| --- | --- |
| `game_studio_create` | `collector` (2D) veya `voxel` (3D) şablonundan oynanabilir bir oyun oluşturur, derler ve kenar çubuğunda gösterir. Başlığı, bir görsel stilini, `orientation` (dikey veya yatay) değerini ve `slots` — oyunun kullanıcının dilinde adlandırılmış kendi görsel yuvalarını — alır. |
| `game_studio_build` | `game.json` veya `game.js` düzenlendikten sonra yeniden derler, önizlemeyi yeniler ve kısa bir notla bir sürüm kaydeder. |
| `game_studio_playtest` | En son kodu başsız (headless) modda (telefon boyutunda dikey veya 960×540 yatay) oynar ve aşamaları, en iyi skoru, canları, fps değerini, hataları ve ekran görüntülerini raporlar; `characters: true` yalnızca karakterlerin yakın çekimlerini döndürür. |
| `game_studio_generate_asset` | İsteğe bağlı olarak bir referans resmi takip ederek `openai` veya `codex` ile bir yuva için 1–4 aday görsel üretir. Harcama yapmadan önce onay ister. Codex arka planda çalışır. |
| `game_studio_apply_asset` | Bir adayı numarasına göre oyuna yerleştirir, yeniden derler ve yeniler. |
| `game_studio_revert_asset` | Bir yuvanın önceki görseline geri döner. |
| `game_studio_versions` | Kaydedilen sürümleri en yeniden başlayarak listeler. |
| `game_studio_restore_version` | Tüm oyunun daha önceki bir sürümünü geri yükler. |
| `game_studio_export` | Tek bir bağımsız, çevrimdışı HTML dosyası dışa aktarır. |
| `game_studio_share` | Yerel ağda geçici, salt okunur bir bağlantı açar (veya kapatır) ya da bağlantıya sahip herkesin oynayabilmesi için `cloudflared` üzerinden geçici bir herkese açık bağlantı oluşturmak üzere `public: true` alır. |
| `game_studio_list` | Çalışma alanındaki oyunları başlık, 2D/3D, derleme durumu ve sürüm sayısıyla listeler; agent "o penguen oyununu" adından bulur. |
| `game_studio_export_wall` | Oyun duvarını dışa aktarır: derlenmiş her oyun için bir kutucuk içeren çevrimdışı bir HTML sayfası; kutucuğa tıklayınca oyun açılır. |
| `game_studio_publish` | Derlenmiş oyunu (veya oyun duvarı için `wall: true`) yerel oturum açılmış `gh` CLI üzerinden GitHub Pages'te yayınlar ya da silmek için `remove: true` alır. Önce onay ister ve yalnızca kendi `.dsh-game-studio.json` işaretçisini taşıyan depolara yazar. |
Kenar çubuğunun düğmeleri (uygula, geri al, derle, dışa aktar, geri yükle, paylaş, yayınla) aynı işlemleri `/game-studio` komutu üzerinden çağırır.
## Görsel hizmetleri ve harcama
| Hizmet | Gereksinimler | Maliyet | Notlar |
| --- | --- | --- | --- |
| **OpenAI** (GPT Image) | DSH kimlik bilgilerinde veya ortamda bir API anahtarı (varsayılan olarak `OPENAI_API_KEY`) | Görsel başına anahtarınıza faturalandırılır; onay kartı bir tahmin gösterir | Parti başına yaklaşık bir dakika. `openaiBaseUrl`, OpenAI uyumlu bir ağ geçidini kabul eder. |
| **Codex CLI** | Kurulu ve oturum açılmış Codex (`codex login`) | Codex planınıza sayılır; API anahtarı gerekmez | Görsel başına birkaç dakika sürer, arka planda çalışır ve bittiğinde bildirir. |
`imageProvider: auto` (varsayılan), anahtarı ayarlandığında OpenAI'ı, aksi halde Codex'i kullanır. `confirmSpending` açıkken (varsayılan) siz kartı onaylayana kadar hiçbir şey üretilmez. Sprite'lar sunulmadan önce şeffaf arka plan ve kadraj açısından kontrol edilir ve yuvaya sığdırılır.
## Güvenlik ve gizlilik
- Oyunlar, ağ erişimini engelleyen bir içerik güvenlik politikasına sahip korumalı bir iframe içinde çalışır; dışa aktarılan dosyalar hiçbir ağ isteği yapmaz.
- Makinenizin dışına gönderilen tek şey, seçtiğiniz görsel hizmetine gönderilen istemler — ve verirseniz referans resimdir.
- Paylaşım bağlantısı salt okunurdur, yalnızca o oyunun derlemesini sunar ve belirlediğiniz sürenin sonunda (varsayılan olarak 30 dakika) kapanır. Yerel bağlantılar yalnızca yerel ağınızı dinler; herkese açık bağlantılar yalnızca `127.0.0.1` adresini dinler ve onayınızdan sonra Cloudflare (`trycloudflare.com`) üzerinden tünellenir.
- GitHub Pages'te yayınlama (`game_studio_publish`), yerel oturum açılmış `gh` CLI'nizi kullanır (eklenti GitHub belirtecinize asla dokunmaz), onayınızdan sonra yalnızca derlenmiş HTML'yi **herkese açık** bir depoya yükler ve kendi `.dsh-game-studio.json` işaretçisini taşımayan mevcut hiçbir depoya yazmayı kabul etmez.
- Çevrimiçi oyun kaynakları, DSH'ye veya çalışma alanınıza erişimi olmadan korumalı bir iframe (`sandbox="allow-scripts"`) içinde sağlayıcının kendi sitesinde çalışır ve yerel oyun duvarınızı dışa aktarırken veya yayınlarken asla kopyalanmaz ya da iletilmez.
- API anahtarları DSH kimlik bilgilerinden veya ortamdan okunur ve asla projelere, günlüklere veya araç sonuçlarına yazılmaz.
## Gereksinimler
- DeepSeek Harness `0.2.1` veya üzeri (web veya masaüstü), Node.js `24.11` veya üzeri.
- Oynanış testleri için aynı bilgisayarda Google Chrome veya Microsoft Edge.
- Yapay zeka görselleri için bir OpenAI API anahtarı veya oturum açılmış Codex CLI. İkisi de olmadan oyunlar kodla çizilmiş karakterleriyle çalışmaya devam eder.
- İsteğe bağlı: geçici herkese açık paylaşım bağlantıları için `cloudflared` (macOS'te `brew install cloudflared`); GitHub Pages'te yayınlamak için `gh` (`brew install gh` ve `gh auth login`).
## DSH'ye kurulum
npm'den bir DSH profiline kurun:
```sh
dsh plugin --profile web add @zseven-w/dsh-game-studio@latest
dsh web
```
## Hızlı başlangıç
Bir çalışma alanı klasöründe oturum açın ve örneğin şunları isteyin:
- `Küçük bir oyun yap: bir yavru kedi mutfakta robot süpürgeye çarpmadan kurutulmuş balıkları çalsın.`
- `3D bir oyun yap: küçük bir şövalye kalede altın toplasın ve iskeletlerden kaçsın; 60 saniyede 20 altın toplamak kazandırsın.`
- `6×6 ızgarada bir 3'lü eşleştirme oyunu yap; kazanmak için 60 saniyede 1000 puana ulaşılsın.`
Ardından şunları deneyin:
- `Kahraman için yapay zekayla 2 yeni görsel üret; kenar çubuğundan seçeceğim.`
- `Kahramanın görünümü için eklediğim resmi takip et.`
- `Tek bir HTML dosyası olarak dışa aktar.`
## Yapılandırma
Bunları profilinizin `cordis.patch.yml` dosyasındaki `config` altında ayarlayın:
| Seçenek | Varsayılan | Anlamı |
| --- | --- | --- |
| `imageProvider` | `auto` | `auto`, `openai` veya `codex`. |
| `openaiModel` | `gpt-image-2.5-flare` | OpenAI görsel modeli; sonuçların karşılaştırılabilir kalması için sabitleyin. |
| `openaiBaseUrl` | OpenAI | OpenAI uyumlu temel URL, örn. bir şirket ağ geçidi. |
| `openaiCredential` | `OPENAI_API_KEY` | Anahtarı tutan kimlik bilgisinin veya ortam değişkeninin adı. |
| `codexPath` | `PATH` üzerinde veya giriş kabuğu aracılığıyla bulunur | Codex CLI çalıştırılabilir dosyası. |
| `codexModel` | Codex'in varsayılanı | Codex görsel çalıştırmaları için model. |
| `codexReasoningEffort` | `low` | Codex görsel çalıştırmaları için akıl yürütme çabası. |
| `codexTimeoutMinutes` | `15` | Bu sürenin sonunda bir Codex görselinden vazgeç. |
| `confirmSpending` | `true` | Her üretimden önce onay iste. |
| `cloudflaredPath` | `PATH` üzerinde veya Homebrew'da bulunur | Geçici herkese açık paylaşım bağlantıları için `cloudflared` çalıştırılabilir dosyası. |
| `ghPath` | `PATH` üzerinde veya Homebrew'da bulunur | GitHub Pages'te yayınlamak için GitHub CLI (`gh`) çalıştırılabilir dosyası. |
| `githubRepo` | `dsh-games` | GitHub Pages için herkese açık GitHub deposu adı (oturum açılmış hesabınızın altında). |
## Oyun projesi biçimi
Her oyun, çalışma alanınızda düz bir klasördür:
- `game.json` — başlık, görsel stili, yönelim, görsel yuvaları ve kurallar. Kurallar serbest biçimlidir: her anahtar oyuna `window.GAME.rules` olarak iletilir.
- `game.js` — ajanın düzenlediği oyun kodu. Oynanış testleri için `window.__gameState()` işlevini, yön tuşlarıyla yönetilmeyen oyunlar için isteğe bağlı olarak `window.__autoplay(state)` işlevini ve kenar çubuğunun kodla çizilmiş karakterleri göstermesi için `window.__renderSlots(size)` işlevini dışa açar (2D şablonu bunları `drawCharacter()` içinde çizer).
- `assets/` — her yuvanın resmi ve her birinin nereden geldiğinin kaydı olan `ASSETS.json`. Bir yuvanın dosyasının üzerine doğrudan çizim yapabilirsiniz; stüdyo bunu sizin düzenlemeniz olarak kaydeder.
- `dist/index.html` — güncel derleme; `.studio/` sürümleri, adayları ve oynanış testi çalıştırmalarını tutar.
## Geliştirme
```sh
npm ci
npm run build # lib/index.js, lib/client.js and the bundled three.js runtime
npm test # node --test; playtest tests are skipped when no Chrome or Edge is found
```
## Ekosistem
- [DSH Crew](https://github.com/ZSeven-W/dsh-crew) — Claude Code / Codex üzerinden DSH ajanlarına iş gönderin
- [DSH iOS](https://github.com/ZSeven-W/dsh-ios) — sohbet içinde canlı bir iOS Simülatörü veya USB iPhone
- [DSH Android](https://github.com/ZSeven-W/dsh-android) — sohbet içinde canlı bir Android emülatörü veya USB cihazı
- [DSH Noema](https://github.com/ZSeven-W/dsh-noema) — DSH için uzun süreli bellek
- [DSH OpenPencil](https://github.com/ZSeven-W/dsh-openpencil) — bir sohbet içinde `.op` tasarım belgelerini inceleyin ve düzenleyin
## Teşekkür & Lisans
- [three.js](https://github.com/mrdoob/three.js) — voksel oyunlarına dahil edilen 3D çalışma zamanı (MIT).
- [qrcode-generator](https://github.com/kazuhikoarase/qrcode-generator) — Kazuhiko Arase — kenar çubuğunun paylaşım panelindeki QR kodu (MIT).
- [Playwright](https://github.com/microsoft/playwright) (`playwright-core`) — oynanış testleri için tarayıcıyı yönetir (Apache-2.0; çalışma zamanı bağımlılığı).
- Şablonlar, sprite'lar ve voksel modelleri bu projeye özgüdür.
- Tam bildirimler için [THIRD_PARTY_NOTICES.md](./THIRD_PARTY_NOTICES.md) dosyasına bakın.
**Lisans**: MIT