1dabb5110f
docs(help): bring the user guide back in line with the current app The help was written on 2026-10-14 and about forty user-visible changes merged since without touching it, so several pages described controls that no longer exist: Missions still listed four playbooks and a Save step for preferences that now save on each change, the depth editor kept its old names, notifications still had their former switches, and voice input pointed to a microphone button that is not in the composer. Every English page was re-checked claim by claim against the current labels (English UI messages) and behaviour, then the nine translations were updated to match, using each locale's own UI labels. Notable corrections: Missions (Compare two models, autosaving defaults with Apply to / Global / Reset, Subsession nesting depth, prepared hand-offs, retired-task interrupts, the named causes of "Mission Control is unavailable", standalone server support); conversations and history (reasoning/tool durations, token lines adding up the cleanup selection, presets including Nothing, timeline markers following Message content, in-place reveal of long text, Open in session, focus after send, Queue message / Steer now, Retrying); settings (notification routing table and defaults, Stats, Mode, info tips, Server setting badge, localized native menus); shortcuts (72 actions, Clear shortcut, Ctrl/Cmd+K); voice (More actions entries, Save status); files (live Workspace refresh, Show 200 more); OpenCode, install, server and updates (2.1.1 recommended, OpenCode 2 beside an older installation, version card first, private loopback listener for Missions, preview releases offered once all builds are published); providers, integrations, browser, SideCars, desktop and remote pages. Translations also repaired older drift, mainly the project-tab closing passages. The Chat settings table header (Default state, its title, item column, the thinking row and its accessible label) was still English in eight locales; it is now translated so the help can cite what users see. AGENTS.md now asks every PR changing user-visible behavior to update the affected help pages in the same PR, since CI validates structure and links but not whether the text still matches the UI; it also corrects the needs-input notification default. USER_HELP.md no longer claims native menus stay English. Validation: npm run test:help (all ten locales, 25 pages, heading ids unchanged), a full help build, and the i18n and transcript-visibility unit tests.
6 KiB
Destek ve kaynak derlemeleri
Hata raporları, güncel sürümler ve katkılar için depoyu kullanın. Sorun giderme kılavuzu, bir sorunu bildirmeden önce güvenli kurtarmayı kapsar.
Hata bildirin
- Ayarlar → Bilgi → Tanılama öğesini açın.
- GitHub sorun formunu açmak için Hata bildir öğesini seçin.
- Önceden doldurulan sürüm/istemci bilgilerini inceleyin. En küçük yeniden üretme örneğini, beklenen davranışı ve gerçek sonucu ekleyip GitHub üzerinden gönderin.
Eylem, CodeNomad ve OpenCode sürümlerini (kurulu olandan farklıysa çalışan OpenCode hizmetininki dahil), işletim sisteminizi, istemci türünü (web tarayıcısında tarayıcının kullanıcı aracısıyla birlikte) ve sunucunun işletim sistemini önceden doldurur. Dinleyici adreslerini, çalışma alanı yollarını, kimlik bilgilerini veya konuşma metnini önceden doldurmaz. Formu açmak bir sorun göndermiyor.
Daha fazla tanılama gerekiyorsa Panoya kopyala veya .txt indir ayrı rapor üretir. Bu kapsamlı rapor yerel yolları ve ağ adreslerini içerebilir: eklemeden önce inceleyip hassas bilgileri gizleyin. Otomatik rapor kimlik doğrulama sırlarını hariç tutsa da ekran görüntüsü veya günlük alıntısı sır içerebilir.
GitHub formunun alanları uyumsuzsa CodeNomad aynı rapor bilgileriyle düz bir sorun bildirimi açar. Formu okumadaki geçici hata açılmasını engellemez. Her zaman sorun listesini elle kullanabilirsiniz.
Topluluk ve sürümler
| Kaynak | Kullanım |
|---|---|
| CodeNomad deposu | Kaynak, proje etkinliği ve belgeler. |
| Sorunlar | Tekrarlanabilir bir hatayı veya özellik isteğini açmadan önce mevcut raporları arayın. |
| Çekme istekleri | Önerilen değişiklikleri inceleyin veya bir katkıyı koordine edin. |
| Son sürüm | Kararlı indirme paketleri. |
| Tüm sürümler | Yayınlanan önizlemeler ve sürüm notları. |
| Neural Nomads | Proje kuruluşu. |
| MIT lisansı | Lisans koşulları. |
CodeNomad kontrolleri yerine yerel OpenCode yapılandırmasıyla ilgili sorunlar için, OpenCode belgelerine ve yukarı akış sürümleri'ye bakın.
Kaynaktan derleyin
.node-version ile sabitlenen Node.js 24.20.0, npm, Git ve uyumlu OpenCode CLI kullanın. Komutları geliştirme çalışma kopyasında çalıştırın:
git clone --branch dev https://github.com/NeuralNomadsAI/CodeNomad.git
cd CodeNomad
npm ci --workspaces --include=optional
npm run dev
npm run dev, Electron geliştirme ana bilgisayarını başlatır. Tauri'yi kullanmak için önce Rust araç zinciri dahil olmak üzere platform oluşturma önkoşullarını'yi yükleyin ve ardından şunu çalıştırın:
npm run dev:tauri
Geliştirme değişiklikleri, bağımsız olarak çalışan OpenCode arka plan programının yüklü sürümünü değil, geliştirme ana bilgisayarını etkiler. Yerel paketlemenin uygun hedef araçlara ihtiyacı vardır; hedef işletim sistemi üzerinde derlemeleri tercih edin.
Derleyin ve doğrulayın
| Komut, depo kökünden | Amaç |
|---|---|
npm run build |
Electron uygulama kaynaklarını oluşturun. |
npm run build:tauri |
Tauri uygulamasını yerel önkoşullarıyla derleyin. |
npm run build:ui |
Tarayıcı kullanıcı arayüzünü oluşturun. |
npm run build --workspace @neuralnomads/codenomad |
Bağımsız sunucuyu ve paketlenmiş varlıkları oluşturun. |
npm run build:linux --workspace @neuralnomads/codenomad-electron-app |
Electron Debian sürümünü paketleyin. |
npm exec --workspace @codenomad/tauri-app -- tauri build --bundles appimage |
Bir Linux Tauri AppImage'ı paketleyin. |
npm run typecheck |
Kökün yapılandırılmış TypeScript çalışma alanlarını kontrol edin. |
npm run test:help |
Tüm genel yardım yerel ayarlarını ve bağlantılarını doğrulayın. |
npm run build:help |
dist/help'de bağımsız kamu yardımını oluşturun. |
Yardım derlemesi çalışan CodeNomad veya OpenCode hizmeti gerektirmez. Paketleme için BUILD.md, kapsamlı doğrulama ve PR kuralları için CONTRIBUTING.md sayfalarına bakın; hedef pakette gerçekten bulunan betikleri kullanın.
Paket haritası ve katkı
| Paket | Sorumluluk |
|---|---|
packages/server |
Çalışma alanı/API/Git kontrolleri, OpenCode bağlantısı, kimlik doğrulama, olaylar ve ses. |
packages/ui |
SolidJS çalışma alanı, kontroller, yerelleştirme ve tarayıcı yardımı giriş noktası. |
packages/electron-app |
Electron pencereler, yerel entegrasyon ve paketleme. |
packages/tauri-app |
Tauri pencereler, platform entegrasyonu ve paketleme. |
packages/remote-tunnel |
Arka uç tarafı OpenTunnel taşıma çalışma zamanı. |
- Örtüşen çalışmayı uygulamaya koymadan önce ilgili konunun kapsamını tartışın.
devüzerinden dal oluşturup değişikliği odaklı tutun.- Etkilenen alan için kontrolleri çalıştırın, davranışın yanı sıra kullanıcı yardımını da güncelleyin ve PR'nizi
dev'de hedefleyin.
Herkese açık yardım kaynakları docs/help/<locale>/ dizinindedir. Çeviride her İngilizce başlığın açık kimliğini, düzeyini ve sırasını koruyun; çevrilmiş başlıklar derin bağlantıları bozmamalıdır. Yardım bakım sözleşmesi sıkı eksiksizlik denetimlerini ve statik yayımlama hattını açıklar.