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.
14 KiB
प्रत्यक्ष रिमोट पहुँच
प्रत्यक्ष पहुँचले server password प्रयोग गरी CodeNomad को HTTP/HTTPS listener मा जोड्छ। यो Remote Control भन्दा अलग हो: pairing लाई LAN binding वा inbound port चाहिँदैन, र कुनै मार्ग चुपचाप अर्कोमा फर्कँदैन।
पहुँच मार्ग रोज्नुहोस्
| मार्ग | व्यवस्थापन गर्नुपर्ने कुरा |
|---|---|
| उही मेसिनको browser | loopback binding राख्नुहोस्; छापिएको local URL प्रयोग गर्नुहोस्। |
| LAN वा VPN | पहुँचयोग्य interface मा bind, अभिप्रेत client मा firewall सीमित र trusted HTTPS प्रयोग गर्नुहोस्। VPN ले CodeNomad listener कन्फिगर गर्दैन। |
| SSH forwarding | backend loopback-bound राखी वास्तविक छापिएको port forward गर्नुहोस्। tunnel ले transport जोगाउँछ तर CodeNomad authentication प्रतिस्थापन गर्दैन। |
| Reverse proxy | backend private/loopback interface मा राख्नुहोस्; proxy मा trusted TLS terminate, upstream hop सुरक्षित र direct-access tool लाई चाहिने दीर्घकालीन SSE तथा WebSocket समर्थन गर्नुहोस्। |
| Remote Control | host बाट device pair गर्नुहोस्; सीमित सतह र आयुका लागि Remote Control हेर्नुहोस्। |
binding ले firewall नियम, port forwarding, DNS वा VPN बनाउँदैन। प्रमाणीकरणविहीन HTTP listener Internet मा सार्वजनिक नगर्नुहोस्। workspace root security sandbox होइन; server सार्वजनिक गर्नुअघि सुरक्षा पढ्नुहोस्।
प्रत्यक्ष पहुँच सक्षम
- host मा सेटिङहरू → रिमोट पहुँच खोली प्रत्यक्ष पहुँच (स्थानीय नेटवर्क, उन्नत) विस्तार गर्नुहोस्।
- सर्भर पासवर्ड मा पासवर्ड सेट गर्नुहोस् वा पासवर्ड परिवर्तन गर्नुहोस् रोजी नयाँ पासवर्ड र पासवर्ड पुष्टि गर्नुहोस् भरेर पासवर्ड बचत गर्नुहोस्। runtime-supplied password यहाँ बदल्न मिल्दैन; सुरक्षा हेर्नुहोस्।
- अन्य IP हरूबाट जडान अनुमति दिनुहोस् लाई लिस्निङ मोड (Listening mode) अन्तर्गत चालू गर्नुहोस्। restart चेतावनी पढेर अस्थायी अवरोधका लागि तयार हुँदा मात्र अहिले रिस्टार्ट गर्नुहोस् रोज्नुहोस्।
- restart पछि रिफ्रेस गरी पहुँचयोग्य ठेगानाहरू जाँच्नुहोस्। अर्को device मा पहुँचयोग्य HTTPS ठेगाना खोल्नुहोस्, वा host मा QR देखाउनुहोस् रोजेर अर्को device बाट scan गरी sign in गर्नुहोस्।
यसले host को direct listening mode बदल्छ, एउटै project वा Remote Control होइन। localhost बाहिर server सुन्दा disclosure स्वतः खुल्छ। automatic restart उपलब्ध नभए CodeNomad हातैले restart गर्नुहोस्; standalone deployment ले launch-time --host मिलाउनुपर्छ। exposure हटाउन switch बन्द गरी restart, वा loopback binding मा CLI पुनःसुरु गर्नुहोस्। यसले paired Remote Control device revoke गर्दैन।
Listener binding तालिका
--host को default 127.0.0.1 हो; localhost त्यही ठेगानामा normalize हुन्छ। सक्षम listener मा यी नियम लागू हुन्छन्:
| Launch/mode | HTTP bind | HTTPS bind |
|---|---|---|
| Standalone, HTTPS मात्र (default) | निजी loopback listener मात्र (तल हेर्नुहोस्) | --host |
| Standalone, HTTP मात्र | LAN/wildcard ठेगानासमेत --host |
सक्षम छैन |
| Standalone, दुवै listener | 127.0.0.1, --host जे भए पनि |
--host |
| नेटिभ desktop backend | host-internal listener समेत HTTP 127.0.0.1 मै रहन्छ |
HTTPS enabled हुँदा --host |
हरेक backend ले Missions जस्ता CodeNomad कै bundled OpenCode plugin का लागि 127.0.0.1 मा HTTP listener पनि राख्छ। HTTP माग नगरिएको भए, वा मागिएको HTTP listener 127.0.0.1 वा 0.0.0.0 बाहेक अर्को ठेगानामा bind भएको भए, backend ले अनियमित 127.0.0.1 port मा निजी HTTP listener थप्छ। यो कहिल्यै छापिँदैन वा जडान ठेगानाका रूपमा दिइँदैन, अरू मेसिनबाट पहुँचयोग्य हुँदैन, र उही प्रमाणीकृत application सेवा दिन्छ।
ठोस LAN ठेगानाले loopback connection स्वीकार नगर्न सक्छ। 0.0.0.0 सबै IPv4 interface हुन्; :: dual-stack wildcard listener हो। browser मा wildcard होइन वास्तविक पहुँचयोग्य ठेगाना प्रयोग गर्नुहोस्। --host मा IPv6 zone identifier समर्थित छैनन्।
standalone HTTPS deployment मा bootstrap प्रक्रिया बाट password सेट गरी चलाउनुहोस्:
codenomad --host 0.0.0.0 --https=true --http=false
loopback-मात्र HTTP का लागि, जस्तै local trusted proxy पछाडि:
codenomad --host 127.0.0.1 --https=false --http=true
9898 वा 9899 port नमान्नुहोस्: नदिएका port व्यस्त भए अर्कोमा जान सक्छन्। स्पष्ट nonzero --https-port, वा HTTP सक्षम हुँदा --http-port, ले port स्थिर गरी bind नसके असफल हुन्छ; 0 ले OS लाई चयन गर्न दिन्छ। छापिएका Local Connection URL, Remote Connection URL र ताजा पहुँचयोग्य ठेगानाहरू त्यस run का आधिकारिक हुन्। पूर्ण server CLI सन्दर्भ हेर्नुहोस्।
Trusted TLS कन्फिगर
आफ्नै certificate दिनुहोस्
- client ले प्रयोग गर्ने hostname वा IP समेट्ने Subject Alternative Names (SANs) भएको certificate ल्याउनुहोस्।
- PEM फाइलका रूपमा दुवै
--tls-key <path>र--tls-cert <path>दिनुहोस्। CA chain/bundle चाहिए--tls-ca <path>थप्नुहोस्। - CodeNomad restart गरी client device बाट certificate र छापिएको HTTPS ठेगाना जाँच्नुहोस्।
custom certificate फाइल startup मा पढिन्छन् र CodeNomad ले पुनःलेख्दैन। renewal र नयाँ फाइल लोड गर्ने restart तपाईंको जिम्मा हो। --tlsSANs ले generated certificate कन्फिगर गर्छ; दिइएको certificate मा नाम थप्न सक्दैन। private key सुरक्षित गर्नुहोस् र host identity जाँचेको certificate मात्र trust गर्नुहोस्।
generated local CA प्रयोग गर्नुहोस्
HTTPS enabled र key/certificate pair नदिँदा CodeNomad ले configuration base मुनि local CA र server certificate बनाउँछ:
| फाइल | उद्देश्य |
|---|---|
tls/ca-cert.pem |
आफूले व्यवस्थापन गर्ने client लाई सुरक्षित वितरण गर्ने public CA certificate। |
tls/ca-key.pem |
CA private key; कहिल्यै नबाँड्नुहोस्। |
tls/server-cert.pem |
Server certificate। |
tls/server-key.pem |
Server private key; कहिल्यै नबाँड्नुहोस्। |
--tlsSANs "host.example.test,192.0.2.10"बाट client-facing सबै DNS नाम/IP थप्नुहोस्। wildcard binding ले SAN का लागि सबै LAN ठेगाना पत्ता लगाउँदैन।- certificate generate/recheck गर्न backend restart गर्नुहोस्।
- trusted माध्यमबाट host/CA प्रमाणित गरी हरेक अभिप्रेत client/browser trust store मा CA certificate मात्र import गर्नुहोस्। वैकल्पिक रूपमा public trusted certificate वा TLS reverse proxy प्रयोग गर्नुहोस्।
generated server certificate 30 दिन चल्छ। expiry को तीन दिनभित्र, आवश्यक SAN छुट्दा, certificate जाँच असफल हुँदा वा private-key फाइल हराउँदा startup ले renew गर्छ। generated CA 365 दिन चल्छ र expiry, certificate जाँच असफल वा private-key फाइल हराउँदा बदलिन्छ; बदल्दा server certificate पनि फेरि जारी हुन्छ। विद्यमान भ्रष्ट, अपठनीय वा नमिलेका private key स्वतः मर्मत हुँदैनन्। client ले replacement CA trust गर्नुपर्छ। निरन्तर in-process renewal छैन: दीर्घकालीन deployment मा expiry अघि सचेत restart मिलाउनुहोस्।
certificate चेतावनी आए रोकिएर hostname, SAN, trust store र expiry जाँच्नुहोस्। verification अक्षम वा चेतावनी क्लिक गरेर जानुलाई deployment प्रक्रिया नबनाउनुहोस्। PWA स्थापना र microphone पहुँच जस्ता remote browser सुविधालाई पनि trusted HTTPS चाहिन्छ।
remote server बचत
- desktop गृह पृष्ठमा CodeNomad सर्भर जडान गर्नुहोस् रोज्नुहोस्। उही बटन खाली सर्भरहरू ट्याबमा र सेटिङहरू → रिमोट पहुँच → सर्भरहरू मा पनि देखिन्छ।
- सर्भरमा जडान गर्नुहोस् मा trusted HTTPS origin सहित सर्भरको नाम र सर्भर URL भर्नुहोस्। स्व-हस्ताक्षरित प्रमाणपत्रहरूको लागि TLS प्रमाणीकरण छोड्नुहोस्। नछान्नुहोस्; बरु trust स्थापित गर्नुहोस्।
- bookmark गर्न बचत गर्नुहोस्, वा बचत र खोल्न जडान गर्नुहोस् रोज्नुहोस्। त्यो server मा sign in गर्नुहोस्।
सुरक्षित सर्भर फेरि खोल्न गृह पृष्ठको सर्भरहरू ट्याबमा त्यसलाई चयन गर्नुहोस्। bookmark यो CodeNomad कन्फिगरेसनका हुन्, remote server का project होइनन्। URL बचतले server सुरु वा access प्रदान गर्दैन। बचत गरिएको सर्भर हटाउनुहोस् ले bookmark हटाउँछ, remote कुराकानी, backend वा credential होइन।
Remote Control मा सर्भर URL मा नयाँ pairing link paste गर्नुहोस्। bookmark ले tunnel origin मात्र राख्छ, one-use code कहिल्यै होइन; device-cookie हराएपछि पुनःpair गर्न Remote Control हेर्नुहोस्।