OmniRoute/docs/i18n/sw/docs/reference/ENVIRONMENT.md

Environment Variables Reference (Kiswahili)

🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇳🇬 ha · 🇮🇱 he · 🇮🇳 hi · 🇭🇷 hr · 🇭🇺 hu · 🇦🇲 hy · 🇮🇩 id · 🇳🇬 ig · 🇮🇹 it · 🇯🇵 ja · 🇬🇪 ka · 🇰🇭 km · 🇮🇳 kn · 🇰🇷 ko · 🇱🇹 lt · 🇱🇻 lv · 🇮🇳 ml · 🇮🇳 mr · 🇲🇾 ms · 🇲🇹 mt · 🇲🇲 my · 🇳🇵 ne · 🇳🇱 nl · 🇳🇴 no · 🇮🇳 or · 🇮🇳 pa · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇱🇰 si · 🇸🇰 sk · 🇸🇮 sl · 🇷🇸 sr · 🇸🇪 sv · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW

---

Rejea kamili ya kila kigezo cha mazingira kinachotambuliwa na OmniRoute. Kwa kiolezo cha kuanza haraka, angalia .env.example.

Important

Kila kigezo kilichoelezewa hapa lazima pia kionekane katika .env.example, na kila kigezo kilicho katika .env.example lazima kionekane hapa. npm run check:env-doc-sync huhakikisha hili wakati wa commit na katika CI. Ili kuacha kigezo kimakusudi, kiongeze kwenye orodha ya kuruhusu iliyo ndani ya scripts/check/check-env-doc-sync.mjs.

---

Jedwali la Yaliyomo

• 1. Siri Zinazohitajika
• 2. Hifadhi na Hifadhidata
• 3. Mtandao na Bandari
• 4. Usalama na Uthibitishaji
• 5. Utakasaji wa Data Ingizo na Ulinzi wa PII
• 6. Sera za Zana na Uelekezaji
• 7. URL na Usawazishaji wa Wingu
• 8. Proksi ya Trafiki Inayotoka
• 9. Ujumuishaji wa Zana za CLI
• 10. Ujumuishaji wa Wakala wa Ndani na MCP
• 11. Vitambulisho vya Watoa Huduma wa OAuth
• 12. Ubatilishaji wa User-Agent wa Watoa Huduma
• 13. Uoanifu wa Alama Bainishi za CLI
• 14. Watoa Huduma wa API Key
• 15. Mipangilio ya Muda wa Kusubiri
• 16. Uwekaji Kumbukumbu
• 17. Uboreshaji wa Kumbukumbu
• 18. Usawazishaji wa Bei
• 19. Usawazishaji wa Modeli (Dev)
• 20. Mipangilio Mahususi kwa Mtoa Huduma
• 21. Hali ya Proksi
• 22. Utatuzi
• 23. Ujumuishaji wa GitHub
• 24. Sandbox ya Ujuzi (v3.8.0+)
• 27. Mlisho wa Radar (Ukaribishaji Mwenyewe)
• Mazingira ya Usambazaji
• Ukaguzi: Vigezo Vilivyoondolewa / Visivyotumika

---

1. Siri Zinazohitajika

Hizi lazima ziwekwe kabla ya uendeshaji wa kwanza. Bila hizo, programu itakataa kuanza au itafanya kazi kwa mipangilio chaguomsingi isiyo salama.

Kigezo	Kinahitajika	Chaguo-msingi	Faili Chanzo	Maelezo
JWT_SECRET	Ndiyo	(hakuna)	src/lib/auth	Hutia saini/huthibitisha vidakuzi vyote vya kipindi cha dashibodi (JWT). Tengeneza kwa openssl rand -base64 48.
API_KEY_SECRET	Ndiyo	(hakuna)	src/lib/db/apiKeys.ts	Ufunguo wa usimbaji fiche wa AES kwa thamani za funguo za API zilizohifadhiwa katika SQLite. Tengeneza kwa openssl rand -hex 32.
INITIAL_PASSWORD	Ndiyo	CHANGEME	Hati ya uanzishaji	Huweka nenosiri la awali la dashibodi ya msimamizi (linalingana na chaguo-msingi la .env.example — limeachwa likiwa si salama kwa njia iliyo wazi ili kulazimisha libadilishwe). Libadilishe kabla ya matumizi ya kwanza. Baada ya kuingia, libadilishe kupitia Dashibodi → Mipangilio → Usalama.
OMNIROUTE_WS_BRIDGE_SECRET	Ndiyo (uzalishaji)	(halijawekwa)	src/app/api/internal/codex-responses-ws/route.ts	Siri inayoshirikiwa kwa daraja la ndani la WebSocket la Codex Responses. Huthibitisha maombi ya daraja kati ya kipelekaji cha WS cha Electron/kivinjari na OmniRoute. ⚠️ INAHITAJIKA katika uzalishaji — ikiwa haijawekwa, maombi yote ya daraja la WS hukataliwa. Tengeneza kwa openssl rand -base64 32.
OMNIROUTE_SW_BUILD_ID	Hapana	(git SHA)	next.config.mjs, scripts/build/assembleStandalone.mjs	Kitambulisho dhahiri cha kubatilisha akiba ya service worker kwa ganda la PWA (#11779); huwa cha kwanza katika mfuatano wa utatuzi.
SOURCE_VERSION	Hapana	(halijawekwa)	next.config.mjs, scripts/build/assembleStandalone.mjs	Cha pili katika mfuatano — huwekwa na wajenzi wa PaaS (k.m. wa mtindo wa Heroku) kuwa commit iliyotumwa.
NEXT_PUBLIC_SW_BUILD_ID	Hapana	(kinatokana na vingine)	src/shared/components/PwaRegister.tsx	Thamani ya umma ya wakati wa ujenzi ambayo mteja hutumia kusajili /sw.js?v=…; hutokana na viwili vilivyo hapo juu, kisha git SHA.
OMNIROUTE_PEER_STAMP_TOKEN	Hapana (kiotomatiki)	(kiotomatiki kila kuwasha)	src/server/authz/policies/management.ts	Siri ya kila mchakato inayothibitisha kuwa muhuri wa IP ya peer inayoaminika ulitoka kwenye seva ya HTTP ya OmniRoute yenyewe (scripts/dev/peer-stamp.mjs). Middleware ya authz huamini kuwa ombi ni la eneo husika (udhibiti wa loopback/LAN kwa route za LOCAL_ONLY) ikiwa tu muhuri una tokeni hii. Hutengenezwa kiotomatiki kila wakati wa kuwasha — iache ikiwa haijawekwa; iweke thamani isiyobadilika tu kwa usanidi wa michakato mingi unaohitaji kushiriki muhuri huo.

Amri za Kutengeneza

# Tengeneza siri zote nne kwa wakati mmoja:
echo "JWT_SECRET=$(openssl rand -base64 48)"
echo "API_KEY_SECRET=$(openssl rand -hex 32)"
echo "INITIAL_PASSWORD=$(openssl rand -base64 16)"
echo "OMNIROUTE_WS_BRIDGE_SECRET=$(openssl rand -base64 32)"

Caution

Kamwe usiweke faili za .env zenye siri halisi kwenye udhibiti wa matoleo. .gitignore tayari haitajumuisha .env, lakini thibitisha kabla ya kusukuma.

---

2. Hifadhi na Hifadhidata

OmniRoute hutumia SQLite (kupitia better-sqlite3) kwa uhifadhi wote wa kudumu. Vigezo hivi hudhibiti eneo la data, usimbaji fiche na mzunguko wa maisha.

Kigezo	Chaguo-msingi	Faili Chanzo	Maelezo
DATA_DIR	~/.omniroute/	src/lib/db/core.ts	Saraka kuu ya hifadhidata ya SQLite, nakala rudufu na faili za data. Ibadilishe kwa ajili ya volumes za Docker au njia maalum.
OMNIROUTE_ALLOW_DEFAULT_DATA_DIR	(haijawekwa)	src/lib/dataPaths.ts	Njia ya kukwepa ulinzi wa DATA_DIR wa majaribio/tathmini (#10428). Majaribio na uchunguzi wa eval/print wa Node (-e/--eval/-p/--print, ikijumuisha miundo ya --eval=/--print=) bila DATA_DIR huelekezwa kwenye saraka ya muda inayoweza kutupwa ili yasiweze kufungua hifadhidata halisi ya mwendeshaji; iweke kuwa 1 ili kuruhusu tena matumizi ya saraka halisi.
OMNIROUTE_BUILD_SHA	(haijawekwa)	src/lib/monitoring/buildSha.ts	Git SHA ya artifact inayoendeshwa. Huwekwa na npm run build:release; inaweza kuingizwa kwenye containers zinazosambazwa bila sentinel ya dist/BUILD_SHA. Huonyeshwa kama system.buildSha kwenye /api/monitoring/health.
OMNIROUTE_RELEASE_REF	origin/main	scripts/build/buildProvenance.ts	Ref ambayo lango la asili ya pack-artifact hutumia kukagua build SHA (#10427).
OMNIROUTE_ALLOW_CANARY_BUILD	(haijawekwa)	scripts/build/buildProvenance.ts	Weka kuwa 1 ili kuruhusu upakiaji wa build ambayo SHA yake haipo kwenye mkondo wa toleo, huku ikiirekodi kama canary ya kukusudia badala ya kushindwa kwenye lango (#10427).
OMNIROUTE_SMOKE_API_KEY	(haijawekwa)	scripts/ops/deploy-canary.mjs	Ufunguo wa API wa uchunguzi wa smoke wa usambazaji wa canary, unaotumwa kama Authorization: Bearer kwenye /v1/chat/completions. Hutumiwa tu na script ya usambazaji (#10429), kamwe si seva. Hauhusiani na vigezo vya OMNIROUTE_SMOKE_* vya mkusanyiko wa smoke wa CLI unaowashwa kwa hiari (RUN_CLI_SMOKE=1, OMNIROUTE_SMOKE_BASE_URL/MODEL/API_KEY_ENV/TARGETS/TIMEOUT_MS katika tests/integration/upstream-cli-smoke.int.test.ts) — tazama Miunganisho ya CLI → Ukaguzi halisi wa smoke.
OMNIROUTE_BUILDING	(haijawekwa)	src/lib/buildPhase.ts	Ishara ya awamu ya build (#10060): huwekwa kuwa 1 na scripts/build/build-next-isolated.mjs na hurithiwa na kila worker ya build inayoanzishwa ili safu ya DB irejeshe stub isiyofanya operesheni badala ya kupakia addon asili ya better-sqlite3 (ambayo husitisha worker wakati wa kuondoka). Haiwekwi kamwe kwa seva inayoendeshwa.
OMNIROUTE_SKIP_NATIVE_DEP_CHECK	0	scripts/check/check-native-deps.mjs	Weka kuwa 1 ili kuruka ukaguzi wa prebuild wa utegemezi asili wa hiari kwa miti isiyo ya kawaida iliyojumuishwa na mradi. Hii haifanyi utegemezi unaokosekana uweze kujengwa; tumia tu wakati vitegemezi asili vinatolewa kupitia njia nyingine.
OMNIROUTE_DATA_DIR	(haijawekwa)	open-sse/executors/promptql/threadSticky.ts	Jina mbadala la akiba la DATA_DIR, linalokaguliwa tu wakati DATA_DIR haijawekwa. Hutumiwa kupata akiba ya vipindi vya thread-sticky ya kitekelezaji cha PromptQL iliyohifadhiwa kwenye diski (<dir>/promptql-thread-sessions.json); ikiwa hakuna kigezo chochote kilichowekwa, akiba hubaki kwenye kumbukumbu pekee (haihifadhiwi baada ya kuanzisha upya).
OMNIROUTE_PLUGINS_DIR	(haijawekwa)	src/lib/plugins/scanner.ts	Saraka inayosomwa na kichanganuzi cha plugin wakati wa utekelezaji — na saraka kuu ambamo kidhibiti cha plugin husakinisha — ikibatilisha chaguo-msingi linalotokana na saraka ya nyumbani (#11827). Ielekeze kwenye mti wa plugin uliounganishwa kwa bind mount katika Docker/K8s badala ya kuhamisha HOME ili tu kubadilisha eneo la njia ya uchanganuzi (HOME pia hudhibiti tabia nyingine zote zinazohusiana na saraka ya nyumbani). Isipowekwa = ~/.omniroute/plugins, au /tmp/.omniroute/plugins wakati mchakato hautoi kabisa saraka ya nyumbani — hali ya kutogundua kimya kimya ambayo kigezo hiki huondoa. Saraka iliyotatuliwa hurekodiwa mara moja wakati wa kuanza kama scanner.dir_resolved pamoja na ingizo lililochaguliwa. Upande wa seva pekee: plugin za amri za CLI huendelea kutumia OMNIROUTE_PLUGIN_PATH yao wenyewe (sehemu ya 9).
STORAGE_ENCRYPTION_KEY	(tupu = imezimwa)	src/lib/db/encryption.ts	Ufunguo wa AES wa usimbaji fiche wa hifadhidata nzima ya SQLite ikiwa imehifadhiwa. Tengeneza kwa openssl rand -hex 32.
STORAGE_ENCRYPTION_KEY_VERSION	v1	scripts/build/bootstrap-env.mjs, electron/main.js	Lebo ya toleo la ufunguo wa usimbaji fiche. Ongeza thamani wakati wa kubadilisha ufunguo ili kusaidia usimbuaji fiche wa nakala za zamani.
DISABLE_SQLITE_AUTO_BACKUP	false	src/lib/db/backup.ts	Ikiwa true, huruka nakala za kawaida/kabla ya kuandika za faili ya SQLite (kuhifadhi/kufuta bei za models.dev, uandishi wa mipangilio). Nakala zinazofanywa mwenyewe na za kabla ya urejeshaji bado hutekelezwa. Hali hii haizimi nakala ya lazima na ya kudumu ya usalama ya kiendeshaji uhamishaji wala kinga dhidi ya uhamishaji mkubwa kwa DB endelevu iliyopo. Nakala zisizofanywa mwenyewe hupunguzwa hadi zisizidi mara moja kwa kila dakika 60. Settings → Storage ya dashibodi inaweza kuzima nakala rudufu ya kawaida ya kiotomatiki kwa kujitegemea.
OMNIROUTE_CRYPT_KEY	(haijawekwa)	src/lib/db/encryption.ts	Jina mbadala la zamani la STORAGE_ENCRYPTION_KEY. Hukubaliwa kama chaguo la akiba wakati kigezo msingi hakipo.
OMNIROUTE_API_KEY_BASE64	(haijawekwa)	src/lib/db/encryption.ts	Jina mbadala la zamani (muundo uliosimbwa kwa Base64) linalokubaliwa kama chaguo la akiba. Husimbuliwa kiotomatiki kabla ya kutumiwa.
OMNIROUTE_DB_HEALTHCHECK_INTERVAL_MS	(haijawekwa)	src/lib/db/core.ts	Batilisha muda wa ukaguzi wa mara kwa mara wa afya ya SQLite (ms). Ikiwa haijawekwa, thamani chaguo-msingi hutokana na NODE_ENV.
OMNIROUTE_WAL_TRUNCATE_INTERVAL_MS	21600000 (saa 6)	src/lib/db/walMaintenance.ts	Batilisha muda wa mara kwa mara wa wal_checkpoint(TRUNCATE) (ms). Sehemu ya ukaguzi wa kiotomatiki haipunguzi kamwe faili yenyewe ya WAL, na seva inayoendelea kufanya kazi kwa muda mrefu haifungi kamwe DB yake. 0 huzima.
OMNIROUTE_WAL_PASSIVE_INTERVAL_MS	300000 (dakika 5)	src/lib/db/walMaintenance.ts	Batilisha muda wa mara kwa mara wa wal_checkpoint(PASSIVE) (ms). Huweka fremu zinazosubiri za WAL zikiwa ndogo ili TRUNCATE ya mara kwa mara isinakili kamwe mlundiko wa GB nyingi kwenye nyuzi kuu. 0 huzima.
OMNIROUTE_WAL_GUARD_MAX_MB	256	src/lib/db/walMaintenance.ts	Wakati mzunguko wa PASSIVE unapopata faili ya WAL ikiwa juu ya ukubwa huu, huongeza kiwango hadi wal_checkpoint(TRUNCATE) mara moja badala ya kusubiri mzunguko wa polepole.
OMNIROUTE_PRESSURE_SELF_RESTART	false	open-sse/utils/resourcePressure.ts	Weka kuwa 1/true/yes/on ili kuondoa mchakato baada ya shinikizo muhimu la rasilimali kudumu kwa OMNIROUTE_PRESSURE_SELF_RESTART_AFTER_MS, na kuruhusu msimamizi (systemd Restart=always, sera ya kuwasha upya ya Docker) kurejesha mchakato safi badala ya kutoa majibu ya 503 bila kikomo.
OMNIROUTE_PRESSURE_SELF_RESTART_AFTER_MS	120000 (dakika 2)	open-sse/utils/resourcePressure.ts	Muda ambao shinikizo muhimu lazima lidumu kabla ya uondoaji wa kujiwasha upya kutekelezwa.
OMNIROUTE_SQLJS_WASM_PATH	(hugunduliwa kiotomatiki)	src/lib/db/adapters/sqljsAdapter.ts	Njia bayana (kamili au inayohusiana na cwd) ya sql-wasm.wasm wakati wa kutumia adapta mbadala ya WASM ya sql.js. Hugunduliwa kiotomatiki kupitia vitegemezi vya kifurushi na miundo inayowezekana ikiwa haijawekwa.
OMNIROUTE_WAL_TRUNCATE_INTERVAL_MS	21600000 (saa 6)	src/lib/db/core.ts	Batilisha muda wa mara kwa mara wa wal_checkpoint(TRUNCATE) (ms). Sehemu ya ukaguzi wa kiotomatiki haipunguzi kamwe faili yenyewe ya WAL, na seva inayoendelea kufanya kazi kwa muda mrefu haifungi kamwe DB yake. 0 huzima.
OMNIROUTE_BATCH_RETENTION_DAYS	30	src/lib/db/cleanup.ts	Idadi ya siku ambazo sehemu za ukaguzi za kazi ya Batch API iliyofikia mwisho (iliyokamilika/iliyoshindwa/iliyoghairiwa/iliyoisha muda), faili za ingizo/tokeo/hitilafu zinazorejelewa, na safu yake huhifadhiwa na ufagiaji wa kiotomatiki wa usafishaji kabla ya kufutwa. Huanza kutumika tu baada ya BATCH_AND_FILE_AUTO_CLEANUP_ENABLED kuwashwa; hulingana na kipindi cha OpenAI cha kuhifadhi matokeo ya Batch API. Haiathiri njia ya DELETE /api/v1/batches/delete-completed inayotekelezwa na opereta, ambayo hubaki bila masharti (bila kichujio cha umri) kwa mujibu wa muundo wake.
BATCH_AND_FILE_AUTO_CLEANUP_ENABLED	false	src/lib/db/cleanup.ts	Ikiwa true, ruhusu mchakato wa usafishaji otomatiki ufute kazi za Batch API zilizokamilika (na checkpoints zake) zilizopita OMNIROUTE_BATCH_RETENTION_DAYS, na uondoe maudhui ya BLOB ya faili zilizopakiwa baada ya expires_at zake. Imezimwa kwa chaguo-msingi: kila usakinishaji uliopo huhifadhi data hii kama ilivyokuwa hadi mwendeshaji aamue kuiwasha. Pia ni feature flag inayoweza kuhaririwa kupitia dashibodi — angalia docs/reference/FEATURE_FLAGS.md → Wakati wa utekelezaji.
OMNIROUTE_SKIP_DB_HEALTHCHECK	0	src/lib/db/core.ts, src/lib/db/healthCheck.ts	Weka kuwa 1 ili kuruka kabisa ukaguzi wa afya wa DB wakati wa kuanza. Ni muhimu kwa kazi za muda mfupi na majaribio ya ujumuishaji.
OMNIROUTE_FORCE_DB_HEALTHCHECK	0	src/lib/db/core.ts	Weka kuwa 1 ili kulazimisha mzunguko wa ukaguzi wa afya wa DB kuwashwa, hata wakati ambapo kwa kawaida ungerukwa (kwa mfano, kazi za muda mfupi).
OMNIROUTE_SKIP_POSTINSTALL	0	scripts/postinstall.mjs	Weka kuwa 1 ili kuruka maandalizi ya awali ya native-runtime wakati wa npm install. Ni muhimu katika usakinishaji wa CI/headless ambapo sqlite tayari imejengwa.
OMNIROUTE_MIGRATIONS_DIR	(gundua kiotomatiki)	src/lib/db/migrationRunner.ts	Batilisha saraka ambayo migration runner huchanganua. Ni muhimu wakati wa kusambaza migrations zilizofungashwa katika miundo maalum.
OMNIROUTE_EXTRA_MIGRATIONS_DIRS	(haijawekwa)	src/lib/db/migrationRunner/extraDirs.ts	Saraka za ziada za migration kama maingizo ya namespace=dir yaliyotenganishwa kwa kitenganishi cha path cha mfumo (kwa mfano ee=/opt/app/enterprise/db/migrations). Faili zinazopatikana humo hurekodiwa kama <namespace>-<number>, kwa hivyo usambazaji unaotoa migrations zake mwenyewe haugongani kamwe na nafasi za nambari za upstream. Ingizo lenye muundo mbovu, namespace batili au saraka inayokosekana husababisha hitilafu wakati wa kuanza badala ya kuruka schema kimyakimya.
OMNIROUTE_MAX_PENDING_MIGRATIONS	50	src/lib/db/migrationRunner.ts	Kizingiti cha usalama kwa migrations nyingi zinazosubiri (#3416). Uanzishaji husitishwa ikiwa zaidi ya idadi hii ya migrations inasubiri kwenye DB iliyopo (hulinda dhidi ya jedwali la ufuatiliaji lililofutwa). Ongeza thamani hii ili kurejesha nakala rudufu ya zamani; weka kuwa 0 ili kuzima ukaguzi.
OMNIROUTE_INSTALL_UPGRADE_WORKDIR	(<repo>/.install-upgrade)	scripts/check/check-install-upgrade.mjs	Saraka ya kazi ya kizuizi cha toleo cha check:install-upgrade. Inahitaji takribani GB 12 (miundo miwili ya usakinishaji ya takribani GB 3 kila mmoja pamoja na tarball), kwa hivyo haipaswi kuendeshwa kwenye tmpfs ndogo — kwenye runner inayojiendesha yenyewe /tmp ni tmpfs ya GB 12 inayotumia RAM na kizuizi hicho kiliijaza, na kusababisha package kukatwa.
OMNIROUTE_SPEND_FLUSH_INTERVAL_MS	(chaguo-msingi kwenye msimbo)	src/lib/spend/batchWriter.ts	Kipindi cha flush (ms) kwa kiandikaji cha matumizi/gharama kilichowekwa katika batches. Thamani ndogo hupunguza ujumuishaji wa uandishi; thamani kubwa hupunguza ushindani wa DB.
OMNIROUTE_SPEND_MAX_BUFFER_SIZE	(chaguo-msingi kwenye msimbo)	src/lib/spend/batchWriter.ts	Idadi ya juu zaidi ya maingizo ya matumizi yaliyohifadhiwa kwenye buffer kabla ya flush ya lazima. Ongeza katika deployments zenye QPS ya juu; punguza pale ambapo udhibiti wa kumbukumbu ni muhimu zaidi.
OMNIROUTE_PROXY_FETCH_DEBUG	(haijawekwa)	open-sse/utils/proxyFetch.ts	Weka kuwa "true" ili kutoa kumbukumbu za utatuzi za [ProxyFetch] kwenye njia ya relay ya Vercel. Imezimwa kwa chaguo-msingi ili kuepuka kufichua vidokezo vya uelekezaji.
PROXY_LOG_INCLUDE_IPS	false	src/lib/proxyLogger.ts	Weka kuwa "true" au "1" ili kujumuisha IP za mteja/egress na kiambishi awali cha akaunti kwenye mstari wa kina wa kumbukumbu ya mchakato wa [ProxyEgress]. Huwekwa IMEZIMWA kwa chaguo-msingi ili kumbukumbu ya mchakato isifichue IP au kiambishi awali cha akaunti.
OMNIROUTE_DEBUG	(haijawekwa)	bin/cli/commands/quota.mjs	Weka kuwa 1 ili kuchapisha uchunguzi wa muda wa kila ombi ([omniroute] GET <path> completed in Nms) kutoka kwenye amri za quota za CLI kwenda stderr.
OMNIROUTE_HEALTHCHECK_PATH	(otomatiki)	scripts/dev/healthcheck.mjs	Path mahsusi inayokaguliwa na ukaguzi wa afya wa container. Ikiwa haijawekwa, probe huitoa kutoka OMNIROUTE_BASE_PATH; kuiweka hurejesha matumizi ya endpoint ya ufuatiliaji wa kina.
OMNIROUTE_DEBUG_COMPLETION	(haijawekwa)	bin/cli/commands/completion.mjs	Weka kuwa thamani yoyote isiyo tupu ili kutoa uchunguzi wa [omniroute completion] kutoka kwenye paths za cache za ukamilishaji wa shell wa CLI (kusoma/kuonyesha upya/kuandika). Imezimwa kwa chaguo-msingi — cache hizo hushindwa kimyakimya ili cache inayokosekana/iliyoharibika isivunje kamwe ukamilishaji kwa kitufe cha tab.
BATCH_RETRY_DURATION_MS	86400000 (saa 24)	open-sse/services/batchProcessor.ts	Kipindi cha juu zaidi cha kujaribu tena vipengee mahususi vya kundi (ms). Vipengee vinavyozidi kipindi hiki hutiwa alama kuwa vimeshindwa.
BATCH_BACKOFF_BASE_MS	5000	open-sse/services/batchProcessor.ts	Ucheleweshaji wa msingi (ms) kwa ongezeko la kipeo la muda wa kusubiri wakati wa kujaribu tena vipengee vya kundi.
BATCH_BACKOFF_MAX_MS	3600000 (saa 1)	open-sse/services/batchProcessor.ts	Kikomo (ms) cha ongezeko la kipeo la muda wa kusubiri kati ya majaribio ya kurudia vipengee vya kundi.
BATCH_MAX_CONCURRENT	1	open-sse/services/batchProcessor.ts	Idadi ya juu zaidi ya makundi yanayochakatwa kwa wakati mmoja. Ongeza ili kuongeza kasi ya uchakataji; iweke chini ili kuepuka mafuriko ya kufikia vikomo vya kasi.

Important

Kabla ya kubadilisha hifadhidata endelevu iliyopo, kiendeshaji cha uhamishaji huchapisha nakala kamili, inayotambuliwa kwa maudhui chini ya DATA_DIR/db_backups/. Uchapishaji unahitaji mfumo wa faili unaotumia viungo thabiti visivyobatilisha faili vilivyopo ndani ya mfumo mmoja wa faili, pamoja na ulandanishaji wa kudumu wa faili. Vipangishi vya POSIX pia vinahitaji ulandanishaji wa saraka; kwenye Windows, Node inaweza kukataa vishikio vya saraka, kwa hivyo OmniRoute husafisha faili iliyochapishwa na huchukulia ulandanishaji wa ingizo la saraka kama juhudi bora. Ikiwa DATA_DIR iliyopachikwa haiwezi kutoa hakikisho hizo, uanzishaji hushindwa kwa usalama kabla ya kutekeleza uhamishaji. Hamisha DATA_DIR hadi kwenye ujazo wenye uwezo huo; usitumie DISABLE_SQLITE_AUTO_BACKUP kukwepa usalama wa uhamishaji.

Matukio

Tukio	Usanidi
Utengenezaji wa ndani	Acha chaguo-msingi zote. DB iko katika ~/.omniroute/omniroute.db.
Docker	DATA_DIR=/data + pachika ujazo kwenye /data.
Imesimbwa kwa njia fiche inapohifadhiwa	Weka STORAGE_ENCRYPTION_KEY + hifadhi nakala rudufu za ufunguo! Kuupoteza = kupoteza data.
CI/Majaribio	DATA_DIR=/tmp/omniroute-test — ya muda mfupi, usimbaji fiche hauhitajiki.

---

3. Mtandao na Milango

Kigezo	Chaguo-msingi	Faili Chanzo	Maelezo
PORT	20128	src/lib/runtime/ports.ts	Mlango mkuu wa kiolesura cha Dashboard na sehemu za mwisho za API (hali ya mlango mmoja).
OMNIROUTE_BASE_PATH	(tupu = mzizi)	next.config.mjs, scripts/docker/ensure-docker-base-path.mjs	Njia ndogo ya URL ya kuhudumia OmniRoute nyuma ya proksi elekezi (huweka basePath ya Next.js; mielekezo ya uthibitishaji huzingatia basePath). Mfano /omniroute. Katika Docker, thamani hujumuishwa wakati wa docker build (ARG OMNIROUTE_BASE_PATH); picha za mzizi zilizoundwa mapema zinaweza kutumia thamani tofauti ya wakati wa utekelezaji mara moja kontena linapoanza kabla ya Next.js kuwaka. Weka NEXT_PUBLIC_BASE_URL kuwa chanzo cha umma kinachojumuisha njia hiyo ndogo.
NEXT_PUBLIC_OMNIROUTE_BASE_PATH	(tupu = mzizi)	src/shared/hooks/useDisplayBaseUrl.ts	Nakala inayoonekana kwenye kivinjari ya OMNIROUTE_BASE_PATH, iliyoingizwa wakati wa uundaji ili onyesho la sehemu ya mwisho kwenye dashibodi lionyeshe https://host/omniroute/v1 badala ya https://host/v1. Ikiwa haijawekwa, hutumia OMNIROUTE_BASE_PATH. Unda upya baada ya kuibadilisha (basePath ya Next huwekwa wakati wa uundaji).
DASHBOARD_ALLOW_EMBED	(haijawekwa = haiwezi kamwe kuwekwa kwenye fremu)	next.config.mjs, scripts/build/dashboardEmbed.mjs	Uwezeshaji wa hiari wa kupachika kurasa za HTML katika iframe. Ikiwa haijawekwa, kila njia husambazwa ikiwa na frame-ancestors 'none' + X-Frame-Options: DENY. Weka kuwa vscode ili kuhudumia kurasa (dashibodi, kuingia, nyaraka, ukurasa wa mwanzo) zikiwa na frame-ancestors 'self' vscode-webview: na bila X-Frame-Options, ili VS Code Simple Browser iweze kuzionyesha (hali ya dashboardOpen: "editor" ya OmniCopilot). Sehemu ya API (/api, /v1, /v1beta, /a2a, /healthz, lakabu za kiwango cha mzizi) huendelea kutumia vichwa madhubuti kwa vyovyote vile. Ni vscode pekee inayotambuliwa — 1/true haziwezeshi kipengele hiki. Wakati wa uundaji: unda upya baada ya kubadilisha (docker build --build-arg DASHBOARD_ALLOW_EMBED=vscode kwa picha; kuiweka kwenye usakinishaji ulioundwa mapema haina athari).
API_PORT	(haijawekwa)	src/lib/runtime/ports.ts	Ikiwekwa, huhudumia API ya proksi ya /v1/* kwenye mlango huu tofauti.
API_HOST	0.0.0.0	src/lib/runtime/ports.ts	Anwani ya kuunganisha kwa mlango wa API.
DASHBOARD_PORT	(haijawekwa)	src/lib/runtime/ports.ts	Ikiwekwa, huhudumia kiolesura cha Dashboard kwenye mlango huu tofauti.
OMNI_MAX_CONCURRENT_CONNECTIONS	0 (imezimwa)	src/sse/utils/backpressure.ts	Huweka kikomo cha miunganisho ya gumzo inayoendelea kwa wakati mmoja; maombi yanayozidi kikomo hupokea 503 yenye Retry-After. Namba kamili chanya huwezesha kinga hii; ikiwa haijawekwa/ni 0, huizima.
OMNIROUTE_INSTANCE_ID	(haijawekwa)	src/shared/resilience/peerRouting.ts	Kitambulisho thabiti na cha kipekee cha lango hili wakati wa kuunganisha matukio ya OmniRoute kwa mnyororo. Huwezesha ukaguzi wa mizunguko ya rika inayoingia. Herufi zinazoruhusiwa: herufi, tarakimu, ., _, :, na -; upeo wa herufi 64.
OMNIROUTE_PEER_URLS	(haijawekwa)	src/shared/resilience/peerRouting.ts, open-sse/executors/base.ts	URL za msingi za OmniRoute zilizotenganishwa kwa koma ambazo zinaweza kupokea X-OmniRoute-Peer-Trace. Ni URL za upstream zilizoruhusiwa waziwazi pekee zinazopokea metadata ya peer; watoa huduma wengine wote hawaathiriwi.
OMNIROUTE_PEER_MAX_HOPS	4	src/shared/resilience/peerRouting.ts	Idadi ya juu zaidi ya matukio ya OmniRoute yaliyotembelewa awali yanayokubalika kwenye ombi lililounganishwa (1-32). Matukio yanayojirudia au bajeti iliyokwisha hurejesha HTTP 508 Loop Detected.
PROD_DASHBOARD_PORT	20130	docker-compose.prod.yml	Mlango uliochapishwa kwenye upande wa host kwa ajili ya Dashibodi katika hali ya uzalishaji ya Docker.
PROD_API_PORT	20131	docker-compose.prod.yml	Mlango uliochapishwa kwenye upande wa host kwa ajili ya API katika hali ya uzalishaji ya Docker.
OMNIROUTE_PORT	(haijawekwa)	src/lib/runtime/ports.ts	Hupewa kipaumbele kuliko PORT wakati wa kuendeshwa ndani ya Electron au vifungashio vingine.
LIVE_WS_PORT	20129	src/server/ws/liveServer.ts	Mlango wa seva ya ufuatiliaji wa moja kwa moja wa WebSocket katika muda halisi.
LIVE_WS_HOST	127.0.0.1	src/server/ws/liveServer.ts	Anwani ya kuunganisha seva ya moja kwa moja ya WebSocket. Weka kuwa 0.0.0.0 ili kuifanya ipatikane kwenye LAN (pia sanidi LIVE_WS_ALLOWED_ORIGINS).
LIVE_WS_ALLOWED_ORIGINS	(haijawekwa)	src/server/ws/liveServer.ts	Vyanzo vya ziada vilivyotenganishwa kwa koma vinavyoruhusiwa kufungua WebSocket ya moja kwa moja. Vyanzo vya dashibodi vya loopback tayari vinaruhusiwa kwa chaguo-msingi.
LIVE_WS_ALLOWED_HOSTS	(haijawekwa)	src/server/ws/liveServerAllowList.ts	Majina ya host ya ziada yaliyotenganishwa kwa koma yanayoruhusiwa kwa vyanzo vya WebSocket ya moja kwa moja. Tofauti na LIVE_WS_ALLOWED_ORIGINS (URL kamili za vyanzo), hulinganisha sehemu ya host pekee — jambo linalofaa kwa usanidi wa LAN/Tailscale.
NEXT_PUBLIC_LIVE_WS_PUBLIC_URL	(haijawekwa)	src/hooks/useLiveDashboard.ts	URL ya umma ya WebSocket ya dashibodi ya moja kwa moja (upande wa kivinjari). Iweke wakati seva ya WS iko nyuma ya reverse proxy au Cloudflare Tunnel (k.m. wss://ws.my-ai.com/live-ws); kivinjari huunganisha huko badala ya ws://hostname:20132. Sehemu ya pathname pia hutumiwa kama njia ya uboreshaji wa WebSocket (chaguo-msingi: /live-ws).
OMNIROUTE_ENABLE_LIVE_WS	true	src/server/ws/liveServer.ts na scripts/start-ws-server.mjs	Weka kuwa 0 au false ili kulemaza seva ya WebSocket ya muda halisi (imewezeshwa kwa chaguo-msingi, ikiwa imefungwa kwenye loopback). Swichi ya CI/harness inayolemaza hati saidizi ya kujitegemea ya WebSocket ya moja kwa moja.
RELAY_IP_PER_MINUTE	30	src/app/api/v1/relay/chat/completions/route.ts	Kikomo cha kasi ya relay kwa kila (tokeni, IP), maombi/dakika. Huhifadhiwa kwenye kumbukumbu, kwa kila instance. 0 au thamani hasi hulemaza kizuizi cha kipimo cha IP (kikomo cha DB kwa kila tokeni bado kinatumika).
NODE_ENV	production	Kiini cha Next.js	Hudhibiti kiwango cha maelezo ya kumbukumbu, uhifadhi wa muda, ufichuaji wa maelezo ya hitilafu na uboreshaji wa Next.js.
OMNIROUTE_USE_TURBOPACK	1 (Turbopack — chaguo-msingi la msimbo)	package.json / Next.js 16	Turbopack ndiyo kifungashaji chaguo-msingi cha npm run dev na npm run build (ujenzi wa kasi mara 2-3, uliopimwa). Weka kuwa 0 ili kurudi kutumia webpack kwenye Windows, unapokumbana na kutooana kwa viunganishi asilia / kifungashaji, au kwenye mashine zenye RAM ndogo — ujenzi wa toleo la uzalishaji wa Turbopack kwenye mstari huu wa toleo la Next.js (16.2.x) unajulikana kufikia matumizi ya juu zaidi ya kumbukumbu kuliko webpack kwenye grafu kubwa za moduli (marekebisho ya uondoaji kutoka kumbukumbuni ya Turbopack ya Next 16.3 bado si thabiti); kutumia webpack kama mbadala hufikia kiwango cha chini zaidi. Angalia #6409.
OMNIROUTE_SKIP_DB_HEALTHCHECK	(haijawekwa)	src/lib/db/core.ts / src/lib/db/healthCheck.ts	Weka kuwa 1 ili kuruka ukaguzi wa afya ya uadilifu wa SQLite wakati wa kuanzisha. Ni muhimu kwa uanzishaji wa haraka zaidi kwenye hifadhidata kubwa.
NOTIFY_SOCKET	(haijawekwa)	systemd (itifaki ya sd_notify)	Huwekwa na systemd wakati mchakato unaendeshwa chini ya kitengo cha huduma chenye muunganisho wa sd_notify; OmniRoute huisoma (angalia OMNIROUTE_DISABLE_SD_NOTIFY) ili kutuma arifa za READY/WATCHDOG. Haipaswi kamwe kuwekwa na mtumiaji.
OMNIROUTE_DISABLE_SD_NOTIFY	(haijawekwa)	scripts/dev/systemd-notify.mjs	Weka kuwa 1 ili kuzima sd_notify ya systemd (Type=notify / WatchdogSec=) hata wakati inaendeshwa chini ya kitengo cha systemd. Kiarifu hakifanyi chochote nje ya systemd bila kujali mipangilio.
CREDENTIAL_HEALTH_CHECK_INTERVAL	300000	open-sse/config/constants.ts / src/lib/credentialHealth/scheduler.ts	Kipindi (ms) cha kiratibu cha ukaguzi wa afya ya vitambulisho kinachofanya kazi chinichini. Kiwango cha chini: 10000 (sekunde 10).
CREDENTIAL_HEALTH_CACHE_TTL	300000	open-sse/config/constants.ts / src/lib/credentialHealth/cache.ts	TTL (ms) ya hali ya afya ya vitambulisho iliyohifadhiwa kwa muda.
OMNIROUTE_DISABLE_CREDENTIAL_HEALTH_CHECK	false	src/lib/credentialHealth/scheduler.ts	Weka kuwa 1 au true ili kuzima majaribio ya mara kwa mara yanayoendeshwa chinichini kwa miunganisho ya watoa huduma. Watoa huduma za utafutaji (SEARCH_VALIDATOR_CONFIGS katika src/lib/providers/validation/searchProviders.ts, k.m. tavily-search) huondolewa kila wakati kwenye ukaguzi — "uthibitishaji" wao ni hoja halisi inayotozwa na huduma ya juu, kwa hivyo afya yao haikaguliwi kamwe kwa ratiba (#9970).
HOST	0.0.0.0	scripts/dev/run-next.mjs	Anwani ya kuunganisha kwa seva ya ukuzaji/kuanzisha ya Next.js. Ikishawekwa, hubatilisha chaguo-msingi la 0.0.0.0.
HOSTNAME	127.0.0.1	scripts/dev/run-next-playwright.mjs	Anwani ya kuunganisha inayotumiwa na kiendesha Playwright wakati wa kuzindua Next.js. Chaguo-msingi ni 127.0.0.1 kwa majaribio yaliyotengwa. Usitumie kwa omniroute serve — tumia OMNIROUTE_SERVER_HOST badala yake (ganda za POSIX huweka HOSTNAME kiotomatiki kuwa jina la mashine; .env haiwezi kuibatilisha).
OMNIROUTE_SERVER_HOST	0.0.0.0	bin/cli/commands/serve.mjs	Anwani ya kuunganisha kwa omniroute serve. Huepuka mgongano na kigezo cha ganda la POSIX cha HOSTNAME (ambacho kila wakati huwekwa kuwa jina la mashine na bash/zsh). Hurudi kutumia 0.0.0.0 ikiwa haijawekwa. (#6194)

Hali za Mlango wa Mtandao

┌─────────────────────────── Porti Moja (chaguomsingi) ──────────────────────┐
│  PORT=20128                                                                 │
│  → Dashibodi: http://localhost:20128                                        │
│  → API:       http://localhost:20128/v1/chat/completions                    │
└─────────────────────────────────────────────────────────────────────────────┘

┌─────────────────────────── Porti Zilizotenganishwa ─────────────────────────┐
│  DASHBOARD_PORT=20128                                                       │
│  API_PORT=20129                                                             │
│  API_HOST=0.0.0.0                                                           │
│  → Dashibodi: http://localhost:20128                                        │
│  → API:       http://0.0.0.0:20129/v1/chat/completions                     │
│  Matumizi: Fichua API kwa LAN huku ukizuia Dashibodi kwenye localhost.      │
└─────────────────────────────────────────────────────────────────────────────┘

┌─────────────────────────── Docker ya Uzalishaji ───────────────────────────┐
│  PROD_DASHBOARD_PORT=443   PROD_API_PORT=8443                              │
│  → Huweka porti za kontena kwenye porti za seva katika docker-compose.prod.yml. │
└─────────────────────────────────────────────────────────────────────────────┘

---

4. Usalama na Uthibitishaji

Kigezo	Chaguo-msingi	Faili Chanzo	Maelezo
MACHINE_ID_SALT	endpoint-proxy-salt	src/lib/auth	Chumvi inayounganishwa na vitambulishi vya maunzi kwa ajili ya kuunda alama ya kipekee ya mashine. Ibadilishe kwa kila upelekaji ili kuhakikisha utengano.
OMNIROUTE_CLI_SALT	(haijawekwa = chumvi nasibu kwa kila usakinishaji inayohifadhiwa katika <DATA_DIR>/cli-token-salt.json)	src/lib/machineToken.ts	Chumvi ya HMAC ya kutengeneza tokeni ya uthibitishaji ya CLI ya ndani. Kuweka thamani hii hubadilisha tokeni zote za CLI kwenye mashine na daima hupewa kipaumbele kuliko chumvi iliyohifadhiwa. Tazama docs/security/CLI_TOKEN.md.
AUTH_COOKIE_SECURE	false	src/lib/auth	Huweka alama ya Secure kwenye vidakuzi vya kipindi. Lazima iwe true wakati mfumo unaendeshwa nyuma ya HTTPS.
REQUIRE_API_KEY	false	Programu ya kati ya API	Ikiwa true, maombi yote ya proksi ya /v1/* lazima yajumuishe ufunguo halali wa API.
ALLOW_API_KEY_REVEAL	false	src/shared/constants/featureFlagDefinitions.ts	Huruhusu thamani kamili za funguo za API kuonyeshwa katika kiolesura cha Dashibodi. Inaweza kusanidiwa kupitia Alama za Vipengele za Dashibodi; ni hatari ya kiusalama kwenye matukio yanayotumiwa kwa pamoja.
NO_LOG_API_KEY_IDS	(tupu)	src/lib/compliance/index.ts	Vitambulisho vya funguo za API vilivyotenganishwa kwa koma ambavyo havirekodiwi kwenye kumbukumbu za maombi (kwa utiifu wa GDPR).
DEFAULT_RATE_LIMIT_PER_DAY	(haijawekwa = bila kikomo)	src/shared/utils/apiKeyPolicy.ts	Bajeti mbadala ya maombi kwa siku inayotumika kwa funguo za API ambazo safu yake ya rate_limits ni null. Ikiwa haijawekwa au ni tupu: hakuna kikomo kisicho bayana (#2289, #11017). 0 ina maana sawa (bila kikomo). Nambari kamili chanya N huwezesha N/siku, 5N/wiki, 20N/mwezi. Thamani zisizo tupu zilizo na muundo batili hurudi kwenye vipindi vya awali vya 1000/siku, 5000/wiki, 20000/mwezi.
MAX_BODY_SIZE_BYTES	10485760 (MB 10)	src/shared/middleware/bodySizeGuard.ts	Ukubwa wa juu unaoruhusiwa wa mwili wa ombi. Hukataa mizigo inayozidi kikomo hiki.
OMNIROUTE_CHAT_LARGE_BODY_BYTES	262144 (KB 256)	src/shared/middleware/chatBodyAdmission.ts	Miili halisi ya maombi yenye ukubwa unaofikia au kuzidi kiwango hiki huchukua ruhusa nzito ya uingizaji ya atomiki na ya ndani ya mchakato kabla ya kuchanganua JSON (njia ya BYTE, ikijumuisha POST /v1/responses). Njia sawa ya kuepuka wakati kuna nafasi ya kutosha ya #10437 kama ilivyo kwa miundo mizito; bado inadhibitiwa na OMNIROUTE_CHAT_MAX_INFLIGHT_BYTES / #10110 ili #7849 isijirudie.
OMNIROUTE_CHAT_HARD_MAX_BODY_BYTES	52428800 (MB 50)	src/shared/middleware/chatBodyAdmission.ts	Kikomo thabiti cha njia ya gumzo kinachotekelezwa dhidi ya baiti zilizosomwa wakati wa upokeaji wenye mipaka, ikijumuisha maombi yasiyo na Content-Length, yenye thamani batili, au yenye thamani isiyo ya kweli; kinachozidi hupokea 413.
OMNIROUTE_CHAT_MAX_HEAVY_IN_FLIGHT	(haijawekwa — hakuna kikomo cha idadi ya maombi)	src/shared/middleware/chatBodyAdmission.ts	#503-fanout: kikomo hiki cha zamani cha IDADI ya maombi sasa hutumika tu kinapowekwa waziwazi. Kikiachwa bila kuwekwa (chaguo-msingi), ukubali wa gumzo zito badala yake hudhibitiwa na OMNIROUTE_CHAT_MAX_INFLIGHT_BYTES — bajeti ya BYTE inayotokana kiotomatiki, iliyopimwa kulingana na kikomo halisi cha kumbukumbu cha mchakato katika mchakato mmoja (heap moja ya V8). Maombi mawili yanayopishana ya /v1/responses yenye takriban tokeni 750k husababisha heap za ~GiB 12 kusitishwa (#7849) — hili ni onyo la bajeti ya kumbukumbu, si kiwango cha juu kisichobadilika cha bidhaa cha 2. Mchakato wenye afya (heap iliyo chini ya uwiano wa upunguzaji) UNAWEZA kukubali maombi zaidi ya muda mrefu ya /v1/responses kwa wakati mmoja kupitia OMNIROUTE_CHAT_ADMISSION_HEALTHY_HEADROOM. Makumi ya wateja wa muda mrefu wa SSE (40–50) yanategemea heap + OMNIROUTE_CHAT_MAX_INFLIGHT_BYTES / #10110, si “kiwango cha juu cha 2”. Kuongeza thamani hii bila uchanganuzi ili “kutumia host” hurejesha #7849. Zidisha heap kwa kutumia DATA_DIR N zinazojitegemea (#11024); kamwe usitumie replicas>1 kwenye faili moja ya SQLite.
OMNIROUTE_CHAT_MAX_INFLIGHT_BYTES	(hutokana kiotomatiki)	src/shared/middleware/admissionBudget.ts	#503-fanout: ubatilishaji wa bajeti ya baiti za ingizo inayotokana kiotomatiki (25% ya kikomo kikali zaidi cha kumbukumbu cha V8/cgroup, ikigawanywa kwa ukuzaji wa muda wa 8x). Thamani zinazotokana na zinazowekwa waziwazi hubanwa kati ya MiB 8–GiB 2. Body iliyo kubwa kuliko bajeti inayotumika hushindwa mara moja kwa 413 body_exceeds_budget; ushindani kati ya body ambazo kila moja inaweza kuhudumiwa hubaki kuwa wa kujaribiwa tena kwa 503. Wateja 40–50 wa SSE wa muda mrefu kwa wakati mmoja hutegemea bajeti hii + heap, si “kiwango cha juu cha 2” kisichobadilika. Soma chatAdmission.maxInflightBytes / budgetSource / pressureSeverity kwenye /api/monitoring/health kabla ya kurekebisha mipangilio.
OMNIROUTE_CHAT_ADMISSION_HEAP_SHED_RATIO	0.75	src/shared/middleware/chatBodyAdmission.ts	Uwiano wa upunguzaji kutokana na shinikizo la heap (heapUsed / heap_size_limit) kwa ukubali wa mizigo mizito ya BYTE na STRUCTURE (#10183, #10268, #10437). Ombi zito linaloingia kwa wakati mmoja baada ya OMNIROUTE_CHAT_MAX_HEAVY_IN_FLIGHT hupunguzwa kwa 503 inayoweza kujaribiwa tena tu wakati heap PIA iko kwenye au juu ya uwiano huu; kwenye heap yenye afya hukubaliwa kupitia nafasi ya ziada ya hali nzuri badala yake.
OMNIROUTE_CHAT_ADMISSION_HEALTHY_HEADROOM	OMNIROUTE_CHAT_MAX_HEAVY_IN_FLIGHT (chaguo-msingi 1)	src/shared/middleware/chatBodyAdmission.ts	Uwezo wa ziada wenye kikomo kwa njia ya haraka ya heap yenye afya (#10437) kwenye STRUCTURE na BYTE zote mbili (admitChatRequest, ikijumuisha body ≥ OMNIROUTE_CHAT_LARGE_BODY_BYTES). Bila kikomo hiki, kila ombi lenye shughuli nyingi lakini heap yenye afya lilipita ukubali bila kikomo cha juu. Mara idadi hii ya lease za wakati mmoja inapokuwa amilifu kupitia njia ya heap yenye afya, maombi mengine yenye shughuli nyingi huendelea kwenye njia ILE ILE ya kusubiri kwa muda wenye kikomo/kupunguza inayotumiwa chini ya shinikizo halisi la heap. 0 huzima kabisa upitaji huu.
OMNIROUTE_CHAT_HEAVY_MESSAGE_COUNT	200	src/shared/middleware/chatBodyAdmission.ts	Idadi ya ujumbe inayoweka ombi la gumzo katika kundi la uzito mkubwa hata wakati body yake iko chini ya kiwango cha baiti.
OMNIROUTE_CHAT_HEAVY_TOOL_COUNT	64	src/shared/middleware/chatBodyAdmission.ts	Idadi ya zana inayoweka ombi la gumzo katika kundi la uzito mkubwa hata wakati body yake iko chini ya kiwango cha baiti.
OMNIROUTE_CHAT_HEAVY_ESTIMATED_TOKENS	32000	src/shared/middleware/chatBodyAdmission.ts	Makadirio ya kihafidhina ya tokeni kulingana na ukubwa wa string, yanayoweka ombi katika kundi la uzito mkubwa; hiki ni kiwakilishi cha gharama ya ukubali, si utenganishaji wa tokeni wa utozaji wa mtoa huduma.
OMNIROUTE_CHAT_HARD_MAX_MESSAGES	0 (imezimwa)	src/shared/middleware/chatBodyAdmission.ts	Kikomo cha hiari cha historia ya gumzo kinachowashwa kwa kuchagua. Kimezimwa kwa chaguo-msingi: idadi ya ujumbe ni sera ya deployment, si sifa ya jumla ya ombi, na kuweka kikomo hapa hukataa mazungumzo kwa 413 ya mwisho kabla ya pipeline ya compression kuyafanya yaweze kuhudumiwa. Ukuaji wa heap unadhibitiwa na OMNIROUTE_CHAT_MAX_HEAVY_IN_FLIGHT pamoja na upunguzaji kutokana na shinikizo la heap. Weka thamani chanya kwenye deployment zilizo na kumbukumbu finyu zinazohitaji kikomo thabiti; kinapozidi, ombi hupokea 413 iliyopangwa inayohitaji ufupishaji.
OMNIROUTE_MAX_NONSTREAMING_RESPONSE_BYTES	67108864 (64 MB)	open-sse/handlers/chatCore/nonStreamingResponseBody.ts	Kikomo thabiti cha jibu lisilotiririshwa kutoka upstream ambalo huwekwa lote kwenye buffer ya kumbukumbu. Kikizidi, kisomaji cha upstream hughairiwa na ombi hushindwa haraka badala ya kukuza string bila kikomo hadi heap iishe.
OMNIROUTE_FORWARDING_HEADER_BUDGET_BYTES	768	open-sse/handlers/chatCore/responseHeaders.ts	Kiwango cha juu cha baiti za wire zinazotumwa kutoka kwenye header za jibu la upstream. Bajeti inapozidi, header za kipaumbele cha chini (kwa mfano, x-codex-*, x-oai-request-id) huondolewa ili kusalia ndani ya vikomo vya kawaida vya header za reverse-proxy. Weka juu zaidi ili kutuma metadata zaidi ya upstream kwa gharama ya ukubwa mkubwa zaidi wa header za jibu.
CORS_ORIGIN	(haijawekwa)	src/server/cors/origins.ts	Orodha ya zamani ya asili moja inayoruhusiwa na CORS. Kwa usakinishaji mpya, pendelea CORS_ALLOWED_ORIGINS. CORS ni kwa ajili ya viteja vya API vya kivinjari vya asili tofauti pekee; badala yake, uandishi uliothibitishwa wa dashibodi hutumia maombi ya asili ileile pamoja na ulinzi wa CSRF unaofungamanishwa na kipindi.
CORS_ALLOWED_ORIGINS	(haijawekwa)	src/server/cors/origins.ts	Orodha ya asili zinazoruhusiwa na CORS iliyotenganishwa kwa koma. Hakuna alama ya jumla inayotumwa isipokuwa CORS_ALLOW_ALL=true iwe imesanidiwa waziwazi.
CORS_ALLOW_ALL	false	src/server/cors/origins.ts	Njia ya dharura ya wakati wa usanidi pekee ya kurudisha Origin yoyote ya kivinjari. Usiiwashe kwenye usakinishaji wa pamoja au wa uzalishaji.
OUTBOUND_SSRF_GUARD_ENABLED	true	src/shared/network/outboundUrlGuard.ts	Zuia miito ya watoa huduma inayolenga safu za anwani za IP za faragha/loopback/link-local. Zima tu katika mazingira ya majaribio yaliyotengwa.
OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS	false	src/shared/network/outboundUrlGuard.ts	Ruhusu URL za watoa huduma zinazoelekeza kwenye mitandao ya faragha/ya ndani (localhost, 192.168.x.x, 10.x.x.x, n.k.). INAHITAJIKA kwa watoa huduma wanaopangishwa kibinafsi (LM Studio, Ollama, vLLM, Llamafile, Triton, SearXNG). Wakati ni false, dashibodi hukataa uthibitishaji wa URL za ndani.
OMNIROUTE_ALLOW_LOCAL_PROVIDER_URLS	true	src/shared/network/outboundUrlGuard.ts	Ruhusu kuongeza/kuthibitisha watoa huduma kwenye anwani za ndani/faragha (127.0.0.1, localhost, LAN, safu za faragha) — hii inahusu njia ya uthibitishaji wa mtoa huduma pekee. Chaguo-msingi ni true (ya ndani kwanza); weka false ili kutekeleza uzuiaji mkali wa anwani za umma pekee. Vituo vya metadata vya wingu (169.254.169.254, metadata.google.internal) hubaki vimezuiwa bila kujali mpangilio huu. (#5066)
AUDIO_REMOTE_PROVIDER_NODES	false	src/app/api/v1/_shared/audioProviderNodes.ts	Ruhusu njia za /v1/audio/* (unukuzi, matamshi, tafsiri) kutumia nodi ya mtoa huduma inayooana na OpenAI na inayopangishwa nje ya localhost. Imezimwa kwa chaguo-msingi — kuelekeza sauti kwa seva-pangishi ya mbali hubadilisha utambulisho wa trafiki inayotoka na lazima kuwe uamuzi wa wazi wa mwendeshaji. Nodi za loopback/faragha (localhost, 127.0.0.1, 172.16-31.x) zinaruhusiwa kila wakati na haziathiriwi. (#3963)
OMNIROUTE_OIDC_DISABLE_PASSWORD_LOGIN	false	src/app/api/auth/login/route.ts	OIDC inapowashwa, zima kuingia kwa nenosiri ili watumiaji waweze kuthibitisha utambulisho kupitia OIDC Single Sign-On pekee. Lakabu ya moja kwa moja OIDC_DISABLE_PASSWORD_LOGIN pia inakubaliwa; Alama ya Kipengele cha Dashibodi yenye ufunguo huohuo ina kipaumbele. (#10889)
OIDC_DISABLE_PASSWORD_LOGIN	false	src/app/api/auth/login/route.ts	Lakabu ya moja kwa moja ya OMNIROUTE_OIDC_DISABLE_PASSWORD_LOGIN (#10889).

Orodha Hakiki ya Uimarishaji wa Usalama

# Kiwango cha chini cha usalama wa uzalishaji:
AUTH_COOKIE_SECURE=true        # Inahitaji HTTPS
REQUIRE_API_KEY=true           # Thibitisha miito yote ya proksi
ALLOW_API_KEY_REVEAL=false     # Kamwe usifichue funguo kwenye UI
CORS_ALLOWED_ORIGINS=https://your.domain.com
MAX_BODY_SIZE_BYTES=5242880    # Kikomo cha MB 5

---

5. Usafishaji wa Ingizo na Ulinzi wa PII

OmniRoute hutoa ulinzi wa tabaka mbili: uchanganuzi wa uingizaji hasidi upande wa ombi na uondoaji wa PII upande wa jibu.

⚠️ Vikwazo: Mbinu hizi za ulinzi ni utambuzi wa kiheuristiki wa jitihada bora, si ngome kamili dhidi ya uingizaji hasidi wa prompt wala mfumo wa DLP wa PII. Zinaweza kutoa matokeo chanya yasiyo sahihi (prompt halali za persona/RPG kuwekwa alama) na matokeo hasi yasiyo sahihi (leetspeak, nafasi, mifumo isiyo ya Kiingereza). Pekee yake hazitoshi kwa uzingatiaji wa kanuni. Rekebisha hali na uzijaribu dhidi ya trafiki yako kabla ya kuzitegemea.

Upande wa Ombi: Kinga Dhidi ya Uingizaji Hasidi wa Prompt

Kigezo	Chaguo-msingi	Faili Chanzo	Maelezo
INPUT_SANITIZER_ENABLED	true	src/middleware/promptInjectionGuard.ts	Washa uchanganuzi wa ujumbe unaoingia ili kutambua mifumo ya uingizaji hasidi wa prompt.
INPUT_SANITIZER_MODE	warn	src/middleware/promptInjectionGuard.ts	Sera ya uingizaji hasidi: warn = weka tu kwenye kumbukumbu, block = kataa ombi kwa 400. redact ya zamani haiondoi maandishi ya uingizaji hasidi; tumia PII_REDACTION_ENABLED kuandika upya PII ya ombi.
INJECTION_GUARD_MODE	(haijawekwa)	src/middleware/promptInjectionGuard.ts	Jina mbadala la zamani la INPUT_SANITIZER_MODE — tabia sawa.
INPUT_SANITIZER_BLOCK_THRESHOLD	high	src/shared/utils/injectionSeverity.ts	Kiwango cha chini cha ukali ambacho MODE=block hukataa: high (chaguo-msingi), medium, au low. Mifumo ya kiwango cha kati huzingatiwa tu isipokuwa kiwango kipunguzwe.
INJECTION_GUARD_BLOCK_THRESHOLD	(haijawekwa)	src/shared/utils/injectionSeverity.ts	Jina mbadala la zamani la INPUT_SANITIZER_BLOCK_THRESHOLD — tabia sawa.
PII_REDACTION_ENABLED	false	src/lib/guardrails/piiMasker.ts	Ikiwa true, ficha PII katika maombi yanayoingia (bila kutegemea hali ya uingizaji hasidi).
CREDENTIAL_REDACTION_ENABLED	false	src/lib/guardrails/credentialMasker.ts	Ficha mifumo inayojulikana ya funguo za API / tokeni za siri kutoka kwenye data za maombi/majibu. Ni hiari; hufuata PII_REDACTION_ENABLED.

Upande wa Jibu: Kisafishaji cha PII

Kigezo	Chaguo-msingi	Faili Chanzo	Maelezo
PII_RESPONSE_SANITIZATION	false	src/lib/piiSanitizer.ts	Changanua majibu ya LLM ili kutambua PII iliyovuja kabla ya kuyarejesha kwa mteja.
PII_RESPONSE_SANITIZATION_MODE	redact	src/lib/piiSanitizer.ts	redact = ficha PII, warn = weka tu kwenye kumbukumbu, block = ondoa jibu lote.

Kisafishaji cha Muktadha wa Njia Yenye Tokeni cha VS Code

Kigezo	Chaguo-msingi	Faili Chanzo	Maelezo
OMNIROUTE_VSCODE_SANITIZE_CONTEXT	1	src/app/api/v1/vscode/contextSanitizer.ts	Huondoa muktadha wa kihariri kinachotumika uliowekwa kiotomatiki (editorContext, activeEditor, currentFile, selection, openTabs…) kutoka kwenye maombi ya /v1/vscode/[token]/* na huficha maudhui ya faili nyeti zilizoambatishwa waziwazi. Ni salama kwa chaguo-msingi; weka kuwa 0 ili kuizima.

Hali za Matumizi

Hali	Usanidi
Uzingatiaji wa kanuni wa biashara	INPUT_SANITIZER_ENABLED=true, INPUT_SANITIZER_MODE=block, PII_REDACTION_ENABLED=true, PII_RESPONSE_SANITIZATION=true (huzuia uingizaji hasidi + huficha PII ya ombi/jibu; hali hazitegemeani)
Ufuatiliaji pekee	INPUT_SANITIZER_ENABLED=true, INPUT_SANITIZER_MODE=warn — huweka kwenye kumbukumbu lakini haizuii kamwe
Matumizi binafsi	Acha zote zikiwa zimezimwa — hakuna gharama ya ziada

---

6. Sera za Zana na Uelekezaji

Kigezo	Chaguo-msingi	Faili Chanzo	Maelezo
TOOL_POLICY_MODE	disabled	src/lib/toolPolicy.ts	Hudhibiti ufikiaji wa LLM wa zana/uitaji wa vitendaji. allowlist = zana zilizoorodheshwa pekee, denylist = zote isipokuwa zilizoorodheshwa, disabled = hakuna vizuizi.
OMNIROUTE_PAYLOAD_RULES_PATH	./config/payloadRules.json	open-sse/services/payloadRules.ts	Njia ya faili ya JSON yenye kanuni za kubadilisha payload (marekebisho ya upstream kwa kila modeli/itifaki).
OMNIROUTE_PAYLOAD_RULES_RELOAD_MS	5000	open-sse/services/payloadRules.ts	Kipindi cha kupakia upya (ms) faili ya kanuni za payload bila kusimamisha huduma. Kiwango cha chini ni 1000.
OMNIROUTE_PREFER_CLAUDE_CODE_FOR_UNPREFIXED_CLAUDE_MODELS	false	open-sse/services/model.ts	Chaguo la hiari: elekeza vitambulisho vya modeli vya claude-* visivyo na kiambishi awali kutoka kwa viteja vya Claude Code kupitia akaunti ya OAuth ya Claude Code badala ya kuhitaji kiambishi awali cha mtoa huduma. Viambishi awali vilivyobainishwa wazi vya watoa huduma bado vinapewa kipaumbele. Pia inaweza kusanidiwa kupitia kitufe cha kugeuza kwenye dashibodi katika ukurasa wa mtoa huduma wa Claude.
COMBO_CONCURRENCY_PER_MODEL	3	open-sse/services/comboConfig.ts	Kikomo cha miito inayotekelezwa kwa wakati mmoja kwa kila modeli kwa michanganyiko ya round-robin (#9100). Semaphore ya mchanganyiko wa round-robin ilikuwa imewekewa kikomo kisichoweza kubadilishwa cha maombi 3 yanayotekelezwa kwa wakati mmoja kwa kila modeli, hivyo kuweka trafiki yenye miito mingi zaidi kwenye mfululizo nyuma ya kikomo hicho. Huthibitishwa kuwa >= 1, na hubanwa hadi <= 32.
DISABLE_CONTEXT_WINDOW_CHECKS	false	open-sse/handlers/chatCore.ts	Chaguo hatari la hiari linaloruka ukaguzi wa ndani wa OmniRoute wa dirisha la muktadha / kiwango cha juu cha tokeni za ingizo kwa maombi ya moja kwa moja ya modeli moja. Watoa huduma wa upstream bado hutekeleza vikomo vyao halisi; ubanaji wa prompt na kikomo cha tokeni za matokeo cha modeli yenyewe huendelea kutumika. Mpangilio wa kipaumbele unaotumika ni ubatilishaji wa DB ya Feature Flags > kigezo cha mazingira > chaguo-msingi; kuwasha upya hakuhitajiki.
OMNIROUTE_DISABLE_CONVERSATION_TRACKING	(haijawekwa)	open-sse/services/conversationTracker.ts	Weka 1 ili kuacha kukusanya historia ya mazungumzo. resolveConversationId() hurejesha matokeo yasiyofuatiliwa kabla ya kusoma SQLite au kuchanganua historia ya ujumbe, na vitambulisho vya vipindi vilivyotolewa na viteja vinajumuishwa pia. Ushughulikiaji wa vipindi vya uelekezaji haubadiliki na rekodi zilizopo hazifutwi. Hii ni kwa mazingira ya utekelezaji ambayo hayatumii mwonekano wa mazungumzo wa dashibodi na yanataka jedwali la zamu liache kukua.

---

7. URLs na Usawazishaji wa Wingu

Kigezo	Chaguo-msingi	Faili Chanzo	Maelezo
BASE_URL	http://localhost:20128	src/lib/cloudSync.ts	URL ya upande wa seva ambayo kazi za ndani za usawazishaji hutumia kuita /api/sync/cloud. Iache ikiwa URL ya loopback/kontena hata wakati programu inapitishwa hadharani kupitia proksi.
CLOUD_URL	(tupu)	src/lib/cloudSync.ts	URL ya endpoint ya upelekaji wa wingu (kipengele cha kulipia).
CLOUD_SYNC_TIMEOUT_MS	12000	src/lib/cloudSync.ts	Muda wa kuisha wa HTTP kwa maombi ya usawazishaji wa wingu.
OMNIROUTE_BUILD_PROFILE	full	Usanidi wa uundaji wa Webpack	Wasifu wa wakati wa uundaji (weka kuwa minimal ili kuondoa kabisa moduli zenye upendeleo kutoka kwenye kifurushi).
OMNIROUTE_STANDALONE_DIR	Towe la standalone la .build/	scripts/build/colocate-standalone.mjs	Ubatilishaji wa wakati wa uundaji kwa saraka ya towe la standalone inayotumiwa na hatua ya uwekaji pamoja baada ya uundaji. Huu si mpangilio wa wakati wa utekelezaji.
OMNIROUTE_CLOUD_SYNC_SECRET	(tupu)	src/lib/cloudSync.ts	Siri inayoshirikiwa inayotumika kuthibitisha sahihi ya HMAC-SHA256 ya majibu ya Usawazishaji wa Wingu.
OMNIROUTE_CLOUD_SYNC_SECRETS	false	src/lib/cloudSync.ts	Weka kuwa true ili kuruhusu endpoint ya Usawazishaji wa Wingu kubatilisha vitambulisho vya ndani. Chaguo-msingi ni false.
OMNIROUTE_CLOUD_SYNC_ENFORCE_SIGNATURE	false	src/lib/cloudSync.ts	Weka kuwa true ili kukataa jibu la Usawazishaji wa Wingu lisilo na sahihi wakati hakuna siri ya ndani iliyosanidiwa (#13679). Sahihi iliyopo huthibitishwa kila wakati — na hukataliwa kila wakati ikiwa OMNIROUTE_CLOUD_SYNC_SECRET haijawekwa — bila kujali bendera hii. Chaguo-msingi litakuwa kutekeleza uthibitishaji katika v3.9.
OMNIROUTE_ZED_IMPORT_LEGACY_ONE_STEP	false	src/app/api/providers/zed/import/route.ts	Weka kuwa true ili kurudi kwenye tabia ya hatua moja ya v3.8.5 ya "kuingiza kila kitu" bila uthibitisho wa mtumiaji.
NEXT_PUBLIC_BASE_URL	http://localhost:20128	OAuth, Dashibodi, usawazishaji	URL inayoonekana hadharani kwa OAuth redirect_uri, viungo vya Dashibodi, na URL za umma zinazozalishwa. Weka hii kuwa URL thabiti ya umma wakati callback za OAuth au viungo vya kivinjari vinavyozalishwa vinapaswa kutumia host rasmi ya proksi ya nyuma.
NEXT_PUBLIC_CLOUD_URL	(tupu)	Upande wa mteja	Nakala ya upande wa mteja ya CLOUD_URL.
NEXT_PUBLIC_APP_URL	(haijawekwa)	src/shared/services/cloudSyncScheduler.ts	Chaguo la zamani la akiba la NEXT_PUBLIC_BASE_URL.
OMNIROUTE_PUBLIC_BASE_URL	(haijawekwa)	Kitatuzi cha asili ya umma, URL za picha	Asili ya OmniRoute inayoonekana na kivinjari yenye kipaumbele cha juu zaidi, inayotumika kutengeneza URL za umma na kuthibitisha asili ya kivinjari isiyo ya dashibodi. Weka hii wakati OpenWebUI au upelekaji mwingine unafikia OmniRoute kupitia URL ya ndani lakini kivinjari cha mtumiaji lazima kichukue maudhui yaliyotengenezwa kutoka LAN, handaki, au asili ya umma. Usijumuishe /v1.
OMNIROUTE_PROVIDER_MANIFEST_URL	(haijawekwa)	open-sse/config/providerPluginManifestUrl.ts	URL kamili ya manifesti ya programu-jalizi ya mtoa huduma inayotangazwa kwa viteja vya sidecar. Ikiwa haijawekwa, OmniRoute hutengeneza /api/v1/provider-plugin-manifest kutoka kwenye asili ya ombi au HOST/PORT.
OMNIROUTE_PUBLIC_PROTOCOL	http	open-sse/config/providerPluginManifestUrl.ts	Itifaki inayotumika wakati wa kutengeneza URL ya manifesti ya programu-jalizi ya mtoa huduma kutoka HOST/PORT bila asili ya ombi. Weka kuwa https nyuma ya proksi ya umma inayohitimisha TLS wakati hakuna OMNIROUTE_PROVIDER_MANIFEST_URL bayana iliyowekwa.
OMNIROUTE_TRUST_PROXY	(haijawekwa)	src/server/origin/publicOrigin.ts	Hali ya hiari ya kuamini vichwa vya asili ya umma vilivyosambazwa. Haijawekwa = usiamini Forwarded / X-Forwarded-* kwa maamuzi ya usalama. true / loopback huamini host/proto iliyosambazwa kutoka tu kwenye proksi ya loopback iliyowekewa tokeni. private / lan pia huamini wenza wa proksi wa LAN ya faragha. Katika mazingira ya uzalishaji, pendelea NEXT_PUBLIC_BASE_URL bayana.
KIE_CALLBACK_URL	(haijawekwa)	open-sse/utils/kieTask.ts	URL ya umma ya callback kwa kazi zisawazishaji za kie.ai. Ubatilishaji wenye kipaumbele cha juu zaidi kabla ya OMNIROUTE_KIE_CALLBACK_URL na OMNIROUTE_PUBLIC_URL.
OMNIROUTE_KIE_CALLBACK_URL	(haijawekwa)	open-sse/utils/kieTask.ts	Tahajia mbadala ya KIE_CALLBACK_URL. Hutumika kama chaguo la akiba wakati kigezo kikuu hakijawekwa.
OMNIROUTE_PUBLIC_URL	(haijawekwa)	open-sse/utils/kieTask.ts	Asili ya umma inayotumika kuunda URL za callback zisawazishaji. Chaguo la akiba lenye kipaumbele cha chini zaidi kwa callback za kie.ai; pia hutumika kama URL ya jumla ya umma kwa uelekezaji mwingine.
OMNIROUTE_CROF_USAGE_URL	https://crof.ai/usage_api/	open-sse/services/usage.ts	Endpoint ya kutafuta kikomo cha CrofAI inayotumiwa na ukurasa wa Matumizi. Batilisha kwa uelekezaji / data za majaribio.
OMNIROUTE_OPENCODE_QUOTA_URL	https://opencode.ai/zen/go/v1/usage	open-sse/services/opencodeQuotaFetcher.ts	Endpoint rasmi ya matumizi ya OpenCode Go iliyothibitishwa kwa ufunguo wa API na inayotumiwa na ukurasa wa Matumizi. Batilisha kwa uelekezaji / data za majaribio.
OPENCODE_SYNTHESIZE_CLI_HEADERS	true	open-sse/executors/opencode.ts	Unda vichwa vya utambulisho vya OpenCode CLI (User-Agent, x-opencode-client/project, UUID za ombi/kikao) kwenye maombi ya opencode-go/zen ya kwenda upstream ambayo kiteja hakikutuma, ili Cloudflare kwenye trafiki inayotoka kwenye VPS iyakubali (#6210/#5997). Huwashwa kwa chaguo-msingi tangu #10571; zima kwa false/0/no/off.
OPENCODE_USER_AGENT	opencode	open-sse/executors/opencode.ts	User-Agent chaguo-msingi inayotumiwa wakati OPENCODE_SYNTHESIZE_CLI_HEADERS imewashwa na hakuna ubatilishaji wa kila mtoa huduma wa <PROVIDER>_USER_AGENT uliowekwa. Hutumika tu kwa vitekelezaji vya opencode.
OPENCODE_CLIENT	desktop	open-sse/executors/opencode.ts	Thamani ya kichwa cha x-opencode-client kilichoundwa wakati OPENCODE_SYNTHESIZE_CLI_HEADERS imewashwa.
OPENCODE_PROJECT	global	open-sse/executors/opencode.ts	Thamani ya kichwa cha x-opencode-project kinachoundwa wakati OPENCODE_SYNTHESIZE_CLI_HEADERS imewashwa.
OMNIROUTE_OLLAMA_CLOUD_USAGE_URL	https://ollama.com/settings	open-sse/services/usage.ts	URL ya mipangilio ya Ollama Cloud inayotumika kukusanya data ya kiwango kinachoruhusiwa. Batilisha kwa ajili ya relay / data za majaribio.
OLLAMA_USAGE_COOKIE	(haijawekwa)	open-sse/services/usage.ts	Kidakuzi cha Ollama Cloud __Secure-session kinachotumika kukusanya data ya kiwango kinachoruhusiwa kutoka kwenye ukurasa wa mipangilio. Ni nyeti; pendelea sehemu ya Dashibodi ya kila muunganisho wakati akaunti nyingi zimesanidiwa.
OLLAMA_CLOUD_USAGE_COOKIE	(haijawekwa)	open-sse/services/usage.ts	Kigezo mbadala cha mazingira cha kidakuzi cha Ollama Cloud __Secure-session. Ni nyeti; pendelea sehemu ya Dashibodi ya kila muunganisho wakati akaunti nyingi zimesanidiwa.
OMNIROUTE_OLLAMA_USAGE_COOKIE	(haijawekwa)	open-sse/services/usage.ts	Kigezo mbadala cha mazingira cha kidakuzi cha Ollama Cloud __Secure-session kinachotumika kabla ya lakabu fupi. Ni nyeti; pendelea sehemu ya Dashibodi ya kila muunganisho wakati akaunti nyingi zimesanidiwa.
OMNIROUTE_CODEWHISPERER_BASE_URL	https://codewhisperer.us-east-1.amazonaws.com	open-sse/services/usage.ts	Endpointi ya vikomo vya matumizi ya CodeWhisperer (AWS Kiro). Batilisha kwa ajili ya relay / data za majaribio.

Important

Wakati wa kusambaza nyuma ya proksi ya kinyume (nginx, Caddy), weka NEXT_PUBLIC_BASE_URL kuwa URL yako thabiti ya umma (kwa mfano, https://omniroute.example.com) wakati miito ya kurejea ya OAuth au viungo vya umma vinavyozalishwa vinapaswa kutumia jina hilo la mpangishaji. Bila hili, miito ya kurejea ya OAuth inaweza kushindwa kwa sababu redirect_uri haitalingana na viungo vya umma vinavyozalishwa vinaweza kuelekeza kwenye chanzo cha ndani cha kontena.

Dumisha BASE_URL kama URL ya ndani ya loopback/kontena kwa kazi za seva-kwa-seva. Usitumie Origin ya kivinjari au jina la mpangishaji la umma kwa maombi ya ndani yenye vitambulisho yanayojileta yenyewe.

Uandishi kwenye dashibodi ulioidhinishwa hauhitaji URL tuli ya msingi ya umma: dashibodi hutuma maombi yasiyo salama ya chanzo-kimoja yenye tokeni ya CSRF iliyofungamanishwa na kipindi. OmniRoute bado huweka uthibitishaji wa chanzo cha umma mahali pamoja kwa miunganisho ya kivinjari isiyo ya dashibodi: vigezo bayana vya mazingira vya URL ya umma huaminiwa kwanza; vichwa ghafi vya Forwarded / X-Forwarded-* hupuuzwa isipokuwa OMNIROUTE_TRUST_PROXY iwe imewashwa na proksi ya moja kwa moja iwe imetiwa tokeni inayoonyesha kuwa inaaminika. Usitumie mipangilio ya CORS kurekebisha maombi ya dashibodi ya chanzo-kimoja; CORS ni kwa wateja wa kivinjari wa vyanzo tofauti pekee.

---

8. Proksi ya Trafiki Inayotoka

Elekeza miito ya mtoa huduma wa LLM wa juu kupitia proksi ya HTTP au SOCKS5 kwa ajili ya udhibiti wa trafiki inayotoka, uelekezaji wa kijiografia, au kuficha anwani ya IP.

Kigezo	Chaguomsingi	Faili Chanzo	Maelezo
ENABLE_SOCKS5_PROXY	true	open-sse/executors	Wezesha wakala wa proksi ya SOCKS5 kwa miito ya juu. Jiondoe kwa kutumia false.
NEXT_PUBLIC_ENABLE_SOCKS5_PROXY	true	Upande wa kiteja	Ufahamu wa upande wa kiteja kuhusu upatikanaji wa SOCKS5.
PROXY_SKIP_RECENTLY_FAILED	false	src/shared/utils/featureFlags.ts	Bendera ya kipengele ya kujijumuisha (angalia FEATURE_FLAGS.md; ubatilishaji wa DB wa dashibodi una kipaumbele). Makundi ya proksi na mzunguko wa kila akaunti huacha kumhudumia tena mwanachama ambaye ameshindwa hivi karibuni (uchunguzi wa TCP uliokataliwa, au 429 kupitia kwake) kwa kipindi kinachoongezeka mara mbili kila kushindwa kunapojirudia, hadi kikomo. true (au 1, yes) huiwezesha.
HTTP_PROXY	(haijawekwa)	Kiwango cha Node.js	Proksi ya HTTP kwa miito ya juu.
HTTPS_PROXY	(haijawekwa)	Kiwango cha Node.js	Proksi ya HTTPS kwa miito ya juu.
ALL_PROXY	(haijawekwa)	Kiwango cha Node.js	Proksi ya jumla (inaauni socks5://).
OMNIROUTE_PROXY_ECHO_URL	(haijawekwa)	src/lib/proxyEchoTarget.ts	Hufunga lengo la mwangwi wa IP linalotumiwa na uchunguzi wa trafiki ya proksi inayotoka kwenye URL moja. Ikiwa haijawekwa, uchunguzi hujaribu api64.ipify.org kisha api4.ipify.org ili njia za IPv4 pekee zisiripotiwe kuwa hazifanyi kazi (#9694).
NO_PROXY	(haijawekwa)	Kiwango cha Node.js	Majina ya seva/IP yaliyotenganishwa kwa koma ambayo yatapita kando ya proksi.
OMNIROUTE_PROXY_DISPATCHER_CONNECTIONS	32	open-sse/utils/proxyDispatcher.ts	Idadi ya juu zaidi ya soketi zinazoweza kutumika kwa wakati mmoja kwa kila kisambazaji cha proksi ya HTTP/SOCKS kilichohifadhiwa kwenye akiba. Mitiririko ya SSE ya muda mrefu kama vile Codex /v1/responses huhitaji zaidi ya muunganisho mmoja wakati maombi kadhaa yanatumia proksi ileile ya kiwango cha akaunti. Thamani zinazozidi 256 zinawekewa kikomo.
SOCKS_HANDSHAKE_TIMEOUT_MS	10000	open-sse/utils/socksConnectorWithFamily.ts	Muda wa mwisho wa kusubiri mawasiliano ya awali ya SOCKS5 (muunganisho) katika ms. Uongeze wakati seva moja ya lango la makazi inapopokea maombi mengi kwa wakati mmoja (k.m. maombi 100 kwa wakati mmoja) — mawasiliano halisi ya awali yanaweza kuzidi sekunde 10 wakati kundi limejaa ingawa proksi inafikika, jambo ambalo vinginevyo huonekana kimakosa kama [Proxy Fast-Fail] Proxy unreachable. Imewekewa kikomo cha 120000.
PROXY_FAIL_OPEN	false	src/sse/handlers/chatHelpers.ts	Ikiwa false (chaguomsingi), ombi ambalo proksi yake iliyogawiwa imeshindwa kutatuliwa linakataliwa (fail-closed) badala ya kurudi kutumia muunganisho wa moja kwa moja — huzuia uvujaji wa IP halisi. Weka true ili kurejesha urejeaji wa zamani wa DIRECT.
ENABLE_TLS_FINGERPRINT	false	open-sse/executors	Gushi alama ya utambulisho ya TLS kwa kutumia wreq-js (huiga Chrome 124). Hukabili uzuiaji wa JA3/JA4.
TLS_FINGERPRINT_PROVIDERS	(haijawekwa)	open-sse/utils/proxyFetch.ts	Orodha ya watoa huduma wanaoruhusiwa, iliyotenganishwa kwa koma, kwa uelekezaji mpya wa TLS kupitia proksi (open-sse/utils/proxyFetch.ts). TLS ya moja kwa moja hudumisha tabia yake ya awali ikiwa haijawekwa; ni watoa huduma hawa pekee wanaoelekezwa kupitia daraja la alama ya utambulisho la Chrome-124.
OMNIROUTE_TURNSTILE_IGNORE_TLS_ERRORS	false	open-sse/services/claudeTurnstileSolver.ts	Ruhusu muktadha wa kivinjari cha Playwright cha Claude Turnstile kupuuza hitilafu za cheti cha HTTPS.

Hali

Hali	Usanidi
SOCKS5 kupitia handaki la SSH	ALL_PROXY=socks5://127.0.0.1:7890, ENABLE_SOCKS5_PROXY=true
Proksi ya HTTP ya shirika	HTTP_PROXY=http://proxy.corp.com:3128, HTTPS_PROXY=http://proxy.corp.com:3128, NO_PROXY=localhost,internal.corp.com
Kuzuia alama ya utambulisho	ENABLE_TLS_FINGERPRINT=true — inahitaji wreq-js (imejumuishwa)
Utumaji unaodhibitiwa / hakuna ufikiaji wa moja kwa moja	Acha PROXY_FAIL_OPEN=false (chaguo-msingi). Maombi hushindwa kabisa wakati proksi haipatikani badala ya kuvuja kupitia muunganisho wa moja kwa moja.
Mfumo wa zamani / usanidi wa uendelezaji — ruhusu urejeaji wa moja kwa moja	PROXY_FAIL_OPEN=true. Hurejesha tabia ya kabla ya uimarishaji: muunganisho wa moja kwa moja hutumika wakati utatuzi wa proksi unaposhindwa.

Kumbuka (kupita uthibitishaji wa NVIDIA — #3226): Kiungo cha uthibitishaji wa ufunguo wa API wa NVIDIA hukwama kinapoelekezwa kupitia fetch ya proksi ya kimataifa/TLS iliyorekebishwa (kisambazaji cha undici → 504). src/lib/providers/validation.ts::directHttpsRequest() kwa makusudi hupita marekebisho ya proksi kwa mwito huo mmoja wa uthibitishaji kwa kutumia safeOutboundFetch({ bypassProxyPatch: true }). Hili ni jambo lililoandikwa na lenye upeo maalum — haliathiri utumaji wa gumzo/matumizi. Upitaji huu umefungwa kwa upeo na tests/unit/proxy-bypass-scope-guard-3226.test.ts.

---

9. Ujumuishaji wa Zana ya CLI

Hudhibiti jinsi OmniRoute inavyogundua na kuanzisha sidecar za CLI (Claude Code, Codex, n.k.).

Kigezo	Chaguo-msingi	Faili Chanzo	Maelezo
CLI_MODE	auto	src/shared/services/cliRuntime.ts	auto = tafuta katika PATH ya mfumo; manual = tumia njia zilizobainishwa pekee.
CLI_EXTRA_PATHS	(haijawekwa)	src/shared/services/cliRuntime.ts	Vipengee vya ziada vya PATH kwa ajili ya kutafuta faili tekelezi za CLI (vimetenganishwa kwa nukta mbili).
CLI_CONFIG_HOME	(haijawekwa)	src/shared/services/cliRuntime.ts	Batilisha saraka ya nyumbani inayotumika kusoma usanidi wa CLI (~/.claude, ~/.codex). Lazima iwe njia kamili iliyo ndani ya saraka ya nyumbani ya mchakato — au, ndani ya kontena, iwe njia iliyounganishwa kwa bind mount (hivyo ndivyo /host-home inavyofanya kazi). Njia nyingine yoyote itarejea kwenye saraka ya nyumbani.
CLI_ALLOW_CONFIG_WRITES	true	src/shared/services/cliRuntime.ts	Ruhusu OmniRoute kuandika faili za usanidi wa CLI (kuhuisha tokeni, data ya kipindi). Weka kuwa false ili kila jaribio la kuandika usanidi wa CLI lishindwe kwa hitilafu dhahiri ya "uandishi umezimwa".
CLI_CLAUDE_BIN	claude	src/shared/services/cliRuntime.ts	Njia maalum ya faili tekelezi ya Claude CLI.
CLI_CODEX_BIN	codex	src/shared/services/cliRuntime.ts	Njia maalum ya faili tekelezi ya Codex CLI.
CLI_DROID_BIN	droid	src/shared/services/cliRuntime.ts	Njia maalum ya faili tekelezi ya Droid CLI.
CLI_OPENCLAW_BIN	openclaw	src/shared/services/cliRuntime.ts	Njia maalum ya faili tekelezi ya OpenClaw CLI.
CLI_CURSOR_BIN	agent, kisha cursor	src/shared/services/cliRuntime.ts	Njia maalum ya faili tekelezi ya wakala wa Cursor. Isipowekwa, utambuzi hujaribu agent kwanza na ukishindwa hutumia cursor.
CLI_CLINE_BIN	cline	src/shared/services/cliRuntime.ts	Njia maalum ya faili tekelezi ya Cline CLI.
CLI_5DIVE_BIN	5dive	src/shared/services/cliRuntime.ts	Njia maalum ya faili tekelezi ya 5dive CLI.
CLI_5DIVE_STATE_DIR	/var/lib/5dive	src/shared/services/cliRuntime.ts	Saraka ya hali ya mfumo ya 5dive (wasifu wa uthibitishaji unaomilikiwa na root); inaakisi chaguo-msingi la STATE_DIR la 5dive.
CLI_CONTINUE_BIN	cn	src/shared/services/cliRuntime.ts	Njia maalum ya faili tekelezi ya Continue CLI.
CLI_QODER_BIN	qodercli	src/shared/services/cliRuntime.ts	Njia maalum ya faili tekelezi ya Qoder CLI.
CLI_QWEN_BIN	qwen	src/shared/services/cliRuntime.ts	Njia maalum ya faili tekelezi ya Qwen Code CLI.
CLI_AIDER_BIN	aider	src/shared/services/cliRuntime.ts	Njia maalum ya faili tekelezi ya Aider CLI.
CLI_GOOSE_BIN	goose	src/shared/services/cliRuntime.ts	Njia maalum ya faili tekelezi ya Goose CLI.
CLI_GEMINI_BIN	gemini	src/shared/services/cliRuntime.ts	Njia maalum ya faili tekelezi ya Google Gemini CLI — kwa utambuzi na ukaguzi wa afya wa upande wa seva pekee; omniroute run gemini hutafuta faili tekelezi ya gemini kutoka kwenye PATH ya mfumo.
CLI_KILO_BIN	kilocode	src/shared/services/cliRuntime.ts	Njia maalum ya faili tekelezi ya Kilo Code CLI.
CLI_OPENCODE_BIN	opencode	src/shared/services/cliRuntime.ts	Njia maalum ya faili tekelezi ya OpenCode CLI.
CLI_HERMES_BIN	hermes	src/shared/services/cliRuntime.ts	Njia maalum ya faili tekelezi ya Hermes. Inatumiwa kwa pamoja na vipengee vyote viwili vya katalogi (hermes na hermes-agent).
CLI_FORGE_BIN	forge	src/shared/services/cliRuntime.ts	Njia maalum ya faili tekelezi ya ForgeCode CLI.
CLI_JCODE_BIN	jcode	src/shared/services/cliRuntime.ts	Njia maalum ya faili tekelezi ya jcode CLI.
CLI_DEEPSEEK_TUI_BIN	deepseek-tui	src/shared/services/cliRuntime.ts	Njia maalum ya faili tekelezi ya DeepSeek TUI.
CLI_CODEWHALE_BIN	codewhale	src/shared/services/cliRuntime.ts	Njia maalum ya faili tekelezi ya CodeWhale CLI.
CLI_SMELT_BIN	smelt	src/shared/services/cliRuntime.ts	Njia maalum ya faili tekelezi ya Smelt CLI.
CLI_PI_BIN	pi	src/shared/services/cliRuntime.ts	Njia maalum ya faili tekelezi ya Pi (pi-coding-agent).
CLI_CRUSH_BIN	crush	src/shared/services/cliRuntime.ts	Njia maalum ya faili tekelezi ya Crush CLI.
CLI_OMP_BIN	omp	src/shared/services/cliRuntime.ts	Njia maalum ya faili tekelezi ya ajenti ya Oh My Pi (omp).
CLI_LETTA_BIN	letta	src/shared/services/cliRuntime.ts	Njia maalum ya faili tekelezi ya Letta CLI.
CLI_PRIME_AGENT_BIN	prime-agent	src/shared/services/cliRuntime.ts	Njia maalum ya faili tekelezi ya Prime Agent (Prime Intellect).
CLI_WINDSURF_BIN	(hakuna)	src/shared/services/cliRuntime.ts	Njia maalum ya faili tekelezi ya Windsurf. Windsurf hutolewa bila amri chaguo-msingi — utambuzi wa faili tekelezi hubaki umezimwa hadi thamani hii iwekwe.
CLI_DEVIN_BIN	devin	open-sse/executors/devin-cli.ts	Njia maalum ya faili tekelezi ya Devin CLI (v3.8.0). Inatumiwa na kitekelezaji cha Windsurf/Devin.
DEVIN_DESKTOP_VERSION	3.6.27	open-sse/executors/devin-desktop.ts	ide_version ya Devin Desktop. Thamani mbadala lazima zitumie muundo wa x.y.z; thamani batili hurudishwa kwenye chaguo-msingi lililothibitishwa.
DEVIN_DESKTOP_EXTENSION_VERSION	1.48.2	open-sse/executors/devin-desktop.ts	extension_version ya Codeium/language-server iliyojumuishwa, ambayo ni tofauti na ide_version ya Desktop. Thamani mbadala lazima zitumie x.y.z; thamani batili hutumia chaguo-msingi lililojumuishwa.
CLI_DEVIN_AGENTIC_BIN	devin	open-sse/executors/devin-cli-agentic.ts	Thamani mbadala ya Devin CLI inayotumika kwa daraja la kiagentiki pekee. Kitekelezaji hukubali tu chanzo cha juu cha ndani cha ACP stdio.
DEVIN_AGENTIC_HOME	(inahitajika)	open-sse/executors/devin-cli-agentic.ts	Saraka ya nyumbani kamili na iliyotengwa kwa mchakato-tanzu wa Devin wa kiagentiki; njia za daraja zinazokubalika ni /home/bridge na njia za .sandbox za ndani ya jukumu (kwenye Windows, C:\...\.sandbox\...).
DEVIN_AGENTIC_ACP_TIMEOUT_MS	120000	open-sse/executors/devin-cli-agentic.ts	Muda wa juu zaidi wa zamu moja ya Devin ACP kabla ya daraja kusitisha mchakato-tanzu na kurudisha muda wa kuisha ulioelezwa wazi.
DEVIN_BRIDGE_MODEL	devin-cli-agentic/swe-1-7	docker/devin-bridge/compose.yml	Lakabu kuu ya modeli ya Claude Code kwa daraja lililotengwa. Mfumo hai wa majaribio hubadilisha mfano huo na modeli inayorejeshwa na akaunti ya sasa ya Devin.
DEVIN_BRIDGE_SONNET_MODEL	DEVIN_BRIDGE_MODEL	docker/devin-bridge/compose.yml	Lakabu ya daraja lililotengwa inayotumiwa Claude Code inapoomba chaguo-msingi lake la Sonnet.
DEVIN_BRIDGE_OPUS_MODEL	DEVIN_BRIDGE_MODEL	docker/devin-bridge/compose.yml	Lakabu ya daraja lililotengwa inayotumiwa Claude Code inapoomba chaguo-msingi lake la Opus.
DEVIN_BRIDGE_HAIKU_MODEL	DEVIN_BRIDGE_MODEL	docker/devin-bridge/compose.yml	Lakabu ya daraja lililotengwa inayotumiwa Claude Code inapoomba chaguo-msingi lake la Haiku.
DEVIN_BRIDGE_SUBAGENT_MODEL	DEVIN_BRIDGE_MODEL	docker/devin-bridge/compose.yml	Lakabu ya daraja lililotengwa inayotumiwa kwa maajenti-wasaidizi wa Claude Code.
DEVIN_SEAT_API_URL	https://server.codeium.com	open-sse/services/usage/devinCli.ts	Ubatilishaji wa hiari wa API ya usimamizi wa nafasi ya Codeium inayotumiwa na mgao wa Devin CLI (GetUserStatus).
AUGGIE_BIN	auggie	open-sse/executors/auggie.ts	Ubatilishaji wa njia kamili ya faili tekelezi ya Augment (Auggie) CLI inayotumiwa na mtoa huduma wa ndani wa auggie. Ikikosekana, hutumia CLI_AUGGIE_BIN, kisha utafutaji wa PATH.
CLI_AUGGIE_BIN	auggie	open-sse/executors/auggie.ts	Ubatilishaji mbadala wa njia ya faili tekelezi ya Augment (Auggie) CLI (huangaliwa baada ya AUGGIE_BIN).
ZCODE_BIN	zcode	open-sse/executors/zcode.ts	Faili tekelezi inayotumiwa na kiteja cha stdio cha mtoa huduma wa ndani wa zcode. Ikikosekana, hutumia zcode kwenye PATH.
ZCODE_ARGS	—	open-sse/executors/zcode.ts	Safu ya JSON (≤ mifuatano 16) ya hoja za ziada zinazopitishwa kwa faili tekelezi ya zcode inapozinduliwa kupitia cliTools.
ZCODE_CWD	process.cwd()	open-sse/executors/zcode.ts	Saraka ya kufanyia kazi ya mchakato-tanzu wa seva ya programu ya ZCode.
ZCODE_PROVIDER_ID	builtin:zai-coding-plan	open-sse/executors/zcode.ts	Ubatilishaji wa kitambulisho cha mtoa huduma kinachotumwa kwa seva ya programu.
ZCODE_SERVER_RUNTIME_ROOT	~/.zcode/server	open-sse/executors/zcode.ts	Mzizi wa mazingira ya utekelezaji ya seva ya programu ya ZCode (ambapo node na zcode-server.cjs zilizofungashwa zinapatikana).
ZCODE_SERVER_NODE	<runtimeRoot>/node	open-sse/executors/zcode.ts	Faili tekelezi ya Node inayotumiwa kuendesha seva ya programu ya ZCode.
ZCODE_SERVER_ENTRY	<runtimeRoot>/zcode-server.cjs	open-sse/executors/zcode.ts	Hati ya kuingilia ya seva ya programu inayotumiwa kuendesha seva ya ZCode.
ZCODE_STARTUP_TIMEOUT_MS	10000	open-sse/executors/zcode.ts	Muda wa mwisho wa uanzishaji (ms) kabla ya uzinduzi wa seva ya programu ya ZCode kuchukuliwa kuwa umeshindwa.
ZCODE_RPC_TIMEOUT_MS	30000	open-sse/executors/zcode.ts	Muda wa mwisho wa RPC kwa kila ombi (ms) kwa mwito wa seva ya programu ya ZCode.
ZCODE_TURN_TIMEOUT_MS	120000	open-sse/executors/zcode.ts	Muda wa juu zaidi (ms) wa zamu moja ya ZCode kabla ya msimamizi kuikatisha kwa kuisha kwa muda.
ZCODE_POLL_INTERVAL_MS	250	open-sse/executors/zcode.ts	Kipindi cha upigaji kura (ms) kwa ajili ya kukamilika kwa zamu ya ZCode.
HERMES_HOME	~/.hermes	src/lib/cli-helper/config-generator/hermesHome.ts	Saraka ya nyumbani ya Hermes Agent ambako OmniRoute husoma/huandika usanidi wa Hermes CLI. Inalingana na kigezo cha mazingira ambacho kisakinishaji cha Hermes PowerShell huweka kwenye Windows (%LOCALAPPDATA%\hermes).

Usawazishaji Otomatiki wa Wasifu wa CLI

Alama hizi za vipengele huwashwa kwa hiari na kwa chaguo-msingi zimezimwa. Pia zinaweza kuwashwa au kuzimwa kutoka kwenye dashibodi ya CLI Code.

Kigezo	Chaguo-msingi	Faili Chanzo	Maelezo
OMNIROUTE_AUTO_SYNC_CODEX_PROFILES	false	src/shared/constants/featureFlagDefinitions.ts	Baada ya usawazishaji wa modeli za mtoa huduma, huandika upya kiotomatiki faili za wasifu za ~/.codex/*.config.toml kutoka kwenye katalogi ya moja kwa moja. Inahitaji CLI_ALLOW_CONFIG_WRITES; kamwe haibadilishi usanidi amilifu/chaguo-msingi wa Codex, uthibitishaji, mipangilio ya Codex-lb, au chaguo la mtoa huduma.
OMNIROUTE_AUTO_SYNC_CLAUDE_PROFILES	false	src/shared/constants/featureFlagDefinitions.ts	Baada ya usawazishaji wa modeli za mtoa huduma, huandika upya kiotomatiki faili za wasifu za Claude Code za ~/.claude/profiles/<name>/settings.json kutoka kwenye katalogi ya moja kwa moja. Inahitaji CLI_ALLOW_CONFIG_WRITES; kamwe haibadilishi usanidi amilifu/chaguo-msingi wa Claude, uthibitishaji, au chaguo la mtoa huduma.

Mfano wa Docker

# Pachika faili tekelezi za mwenyeji ndani ya kontena na uiambie OmniRoute zilipo:
CLI_EXTRA_PATHS=/host-cli/bin
CLI_CONFIG_HOME=/host-home
CLI_ALLOW_CONFIG_WRITES=true
CLI_CLAUDE_BIN=/host-cli/bin/claude

CLI_CONFIG_HOME huanza kutumika tu wakati njia imeunganishwa kutoka kwa mwenyeji kwa bind mount — iambatanishe na mounts kama ~/.codex:/host-home/.codex:rw (tazama wasifu wa host katika docker-compose.yml). Njia ambayo haipo ndani ya saraka ya nyumbani ya mtumiaji wa kontena wala si bind mount hupuuzwa, kwa sababu chochote kinachoandikwa huko kitatupiliwa mbali kontena linapoundwa upya.

Image huendeshwa kama USER node, kwa hivyo /root ambayo haijaunganishwa si override halali.

Kigezo	Chaguo-msingi	Faili Chanzo	Maelezo
OMNIROUTE_CONTAINER	(otomatiki)	src/shared/utils/containerEnv.ts	Lazimisha utambuzi wa kontena kuwashwa (1/true) au kuzimwa (0/false). Huhitajika tu kwenye mazingira ya utekelezaji ambayo utambuzi wa kiotomatiki hauyatambui.
OMNIROUTE_ALLOW_CONTAINER_CONFIG_WRITE	false	src/shared/services/cliRuntime.ts	Ruhusu uandikaji wa usanidi wa zana za CLI katika njia ya kontena isiyounganishwa hata hivyo. Chaguo sawa la CLI ni --allow-container-write.

Visaidizi vya Binary ya CLI (omniroute)

Vigezo hivi hurekebisha tabia ya binary ya CLI ya omniroute yenyewe (si utambuzi wa sidecar ulioelezwa hapo juu).

Kigezo	Chaguo-msingi	Faili Chanzo	Maelezo
OMNIROUTE_LANG	(mfumo)	bin/cli/i18n.mjs	Lazimisha lugha ya matokeo ya CLI. Locale ya BCP-47 (k.m. en, pt-BR). Hubatilisha vigezo vya mazingira vya locale ya mfumo (LC_ALL, LC_MESSAGES).
OMNIROUTE_SHOW_LOG	(haijawekwa)	bin/cli/runtime/processSupervisor.mjs	Weka kuwa 1 ili kuelekeza stdout/stderr ya seva kwenye terminali katika hali inayosimamiwa. Ni sawa na flag ya --log kwenye omniroute serve.
OMNIROUTE_CLI_TOKEN	(haijawekwa)	bin/cli/api.mjs	Tokeni ya uthibitishaji wa mashine inayoingizwa kama header ya x-omniroute-cli-token. Huzalishwa kiotomatiki katika kazi ya 8.12.
OMNIROUTE_HTTP_TIMEOUT_MS	30000	bin/cli/api.mjs	Muda wa mwisho wa HTTP kwa kila jaribio (ms) kwa maombi ya CLI → seva.
OMNIROUTE_READY_TIMEOUT_MS	60000	bin/cli/utils/pid.mjs	Muda wa juu zaidi (ms) ambao CLI husubiri endpoint ya afya ya seva kabla ya kuchapisha onyo la kuisha kwa muda. Ni muhimu kwa uanzishaji wa awali wa polepole (k.m. Windows). Pia inaweza kuwekwa kupitia --ready-timeout.
OMNIROUTE_VERBOSE	0	bin/cli/api.mjs	Weka kuwa 1 ili kuchapisha uchunguzi wa majaribio upya/backoff kwenye stderr wakati wa amri za CLI.
OMNIROUTE_PLUGIN_PATH	(haijawekwa)	bin/cli/plugins.mjs	Saraka maalum ya ugunduzi wa plugin za CLI (packages za omniroute-cmd-*). Chaguo-msingi ni ~/.omniroute/plugins/ ikiwa haijawekwa. Ni ya CLI pekee — haifikii kamwe kichanganuzi cha plugin cha upande wa seva, kinachoelekezwa na OMNIROUTE_PLUGINS_DIR (sehemu ya 2).

---

10. Miunganisho ya Wakala wa Ndani na MCP

Kigezo	Chaguomsingi	Faili Chanzo	Maelezo
OMNIROUTE_BASE_URL	utambuzi wa kiotomatiki	open-sse/mcp-server/server.ts	URL mahususi inayotumiwa na zana za MCP/A2A kufikia OmniRoute. Hubatilisha utambuzi wa kiotomatiki wa localhost.
OMNIROUTE_API_KEY	(haijawekwa)	Moduli za MCP/A2A	Ufunguo wa API kwa miito ya zana ya ndani ya MCP na ujuzi wa A2A.
OMNIROUTE_API_KEY_ID	(haijawekwa)	open-sse/mcp-server/audit.ts	Kitambulisho cha ufunguo kwa ajili ya kuhusisha rekodi za ukaguzi wa MCP.
ROUTER_API_KEY	(haijawekwa)	Mfumo wa zamani	Jina mbadala la zamani la OMNIROUTE_API_KEY.
OMNIROUTE_A2A_HISTORY_RETENTION_DAYS	30	src/lib/a2a/taskManager.ts	Idadi ya siku ambazo historia ya majukumu ya A2A huhifadhiwa katika hifadhidata ya ndani kabla ya usafishaji wa kila siku kufuta safu. Ikiwa haijawekwa, si namba, au ni <= 0, hutumia 30.
OMNIROUTE_A2A_MEMORY_HITS	1	src/lib/a2a/taskExecution.ts	Kitufe cha kuzima kipengele cha uangalizi cha matokeo ya kumbukumbu ya A2A. Weka kuwa 0 ili kuruka kabisa utafutaji wa kukumbuka kumbukumbu kwa jukumu; thamani nyingine yoyote (ikiwemo kutowekwa) huiweka ikiwa imewashwa.
OMNIROUTE_ISSUE_AGENT_ENABLED	false	src/app/api/issue-agent/runs/route.ts	Huwasha endpoint ya Issue Agent ya nje ya mtandao/ndani kwa uchambuzi wa awali uliorekodiwa. Iache ikiwa imezimwa isipokuwa unaendesha kwa makusudi mitiririko ya kazi ya ndani ya uchambuzi wa awali uliorekodiwa.
OMNIROUTE_ISSUE_AGENT_TIMEOUT_MS	(haijawekwa)	src/lib/issueAgent/execution.ts	Muda wa kusubiri (ms) kwa utekelezaji mmoja wa uchambuzi wa awali uliorekodiwa wa Issue Agent. Huwekewa kikomo cha juu cha ndani; hutumia chaguomsingi lililojengewa ndani ikiwa haijawekwa au si sahihi.
OMNIROUTE_CONTEXT	(muktadha unaotumika)	bin/cli/program.mjs, bin/cli/api.mjs	Muktadha/wasifu wa hali ya mbali wa CLI kwa amri za omniroute; hubatilisha muktadha unaotumika katika hifadhi ya ndani ya miktadha. Ni sawa na --context <name>.
OMNIROUTE_CONTEXT_KEYCHAIN_DISABLED	0	bin/cli/contexts.mjs	Huzima backend ya hiari ya keychain ya mfumo wa uendeshaji ya keytar kwa vitambulisho vya muktadha wa CLI. Inapowashwa, vitambulisho hubaki katika hali ya 0600 ya config.json na CLI hutoa onyo la mara moja kuhusu kutumia njia mbadala; imekusudiwa kwa uendeshaji wa kimakusudi usio na kiolesura/kontena.
OMNIROUTE_MCP_ENFORCE_SCOPES	true	open-sse/mcp-server/server.ts	Hutekeleza udhibiti wa ufikiaji unaotegemea mawanda kwenye miito ya zana za MCP.
OMNIROUTE_MCP_SCOPES	(zote)	open-sse/mcp-server/server.ts	Mawanda yaliyotenganishwa kwa koma: admin, combos, health, models, routing, budget, metrics, pricing, memory, skills.
OMNIROUTE_MCP_COMPRESS_DESCRIPTIONS	false	open-sse/mcp-server/descriptionCompressor.ts	Hubana maelezo ya zana za MCP kabla ya kusimba manifesti. Thamani za kuwasha: 1, true, on.
OMNIROUTE_MCP_DESCRIPTION_COMPRESSION	rtk	open-sse/mcp-server/descriptionCompressor.ts	Algoriti/wasifu wa ubanaji. Thamani za kuzima: 0, false, off.
OMNIROUTE_MCP_FETCH_TIMEOUT_MS	10000	open-sse/mcp-server/fetchTimeout.ts	Kikomo cha muda wa kukatisha (ms) kwa usomaji wa ndani wa usimamizi wa seva ya MCP (afya, ustahimilivu, michanganyiko, mgao, matumizi).
OMNIROUTE_MCP_UPSTREAM_TIMEOUT_MS	60000	open-sse/mcp-server/fetchTimeout.ts	Muda wa kusitisha (ms) kwa hatua za MCP zinazosubiri mtoa huduma (route_request, web_search, web_fetch).
OMNIROUTE_CORPUS_CACHE_SIZE	5	src/lib/localCorpus/configured.ts	Idadi ya juu zaidi ya mifano ya faharasa ya korpasi ya ndani inayohifadhiwa kwenye kumbukumbu (LRU, mmoja kwa kila saraka ya msingi iliyowekewa faharasa). Huwekwa angalau 1.
MODEL_SYNC_INTERVAL_HOURS	24	src/shared/services/modelSyncScheduler.ts	Kipindi cha usawazishaji wa katalogi ya modeli kwa saa.
PROVIDER_LIMITS_SYNC_INTERVAL_MINUTES	70	src/lib/usage/providerLimits.ts	Kipindi cha kuangalia vikomo vya kasi na mgao wa mtoa huduma.
PROVIDER_LIMITS_SYNC_SPACING_MS	1500	src/lib/usage/providerLimits.ts	Pengo (ms) kati ya uletaji mfululizo wa mgao wa OAuth katika usawazishaji wa pamoja; miunganisho ya OAuth huletwa mmoja baada ya mwingine ili kuepuka kutuma maombi mengi kwa ghafla kwa huduma ya juu. 0 hujiondoa (sambamba).
OMNIROUTE_QUOTA_FETCH_MIN_INTERVAL_MS	250	open-sse/services/quotaFetchThrottle.ts	Kipindi cha chini zaidi (ms) kati ya uletaji mfululizo wa mgao kutoka huduma ya juu kwenye njia ya ukaguzi wa awali/ufuatiliaji kwa kila ombi; hutenganisha miito ya mtandao ya wakati mmoja ili akaunti nyingi kwenye IP moja zisitume maombi mengi kwa ghafla kwa huduma ya juu. Imeunganishwa kwenye viletaji vya mgao vya Codex (/wham/usage), DeepSeek, Bailian (sehemu zote mbili za uletaji), OpenCode, na Crof (#6009, #6911). Njia ya jumla ya upelekaji ya usage.ts::getUsageForProvider (github/glm/minimax/nanogpt/xai/n.k.) bado haijajumuishwa — inafuatiliwa kando. Matokeo kutoka akiba hayaathiriwi. 0 huzima; huwekewa kikomo cha 0..5000.
PROVIDER_LIMITS_POST_USAGE_REFRESH_DELAY_MS	5000	src/lib/usage/providerLimits.ts	Ucheleweshaji (ms) kabla ya kuonyesha upya vikomo vya mtoa huduma baada ya tukio halisi la matumizi, ili kuipa API ya mgao ya huduma ya juu muda wa kusajili matumizi.
OMNIROUTE_LOGIN_BROWSER_PATH	gundua-kiotomatiki	open-sse/services/adobeFireflyBrowserLogin.ts	Njia kamili ya faili tekelezi ya Chrome au Edge ya mfumo inayotumika kwa kuingia kwa maingiliano kwenye Adobe Firefly na kufanya usasishaji nje ya skrini.
ADOBE_FIREFLY_BROWSER_REFRESH	imewashwa	open-sse/services/adobeFireflySession.ts	Hudumisha hali ya IMS na hatari ya kivinjari ikiwa mpya kwa kutumia vipindi vya Chrome CDP vinavyohusishwa na akaunti. Weka kuwa 0 ili kuzima usasishaji wa kivinjari.
ADOBE_FIREFLY_SESSION_DISK	imewashwa	open-sse/services/adobeFireflySession.ts	Huhifadhi vipindi vya Adobe vilivyorekebishwa chini ya DATA_DIR hata baada ya michakato kuanzishwa upya. Weka kuwa 0 ili kuweka vipindi kwenye kumbukumbu pekee.
ADOBE_FIREFLY_MIN_SUBMIT_GAP_MS	12000	open-sse/services/adobeFireflySession.ts	Pengo la chini zaidi kwa milisekunde kati ya mawasilisho ya uzalishaji ya Adobe Firefly; 0 huzima uwekaji wa mapengo.
ADOBE_FIREFLY_BATCH_EXTRA_GAP_MS	15000	open-sse/services/adobeFireflySession.ts	Kipindi cha ziada cha utulivu kwa milisekunde baada ya kila wasilisho la tatu la Adobe lililofanikiwa.
ADOBE_FIREFLY_SUBMIT_BASE_DELAY_MS	8000	open-sse/services/adobeFireflyClient.ts	Muda wa msingi wa kusubiri kwa milisekunde baada ya majibu ya muda ya Adobe 408; huunganishwa na nafasi kati ya mawasilisho katika majaribio yasiyozidi matano.
OMNIROUTE_DISABLE_BACKGROUND_SERVICES	false	src/instrumentation-node.ts	Zima huduma zote za chinichini (usawazishaji, uwekaji bei, uonyeshaji upya wa modeli). Ni muhimu kwa CI/majaribio.
OMNIROUTE_ENABLE_RUNTIME_BACKGROUND_TASKS	(haijawekwa)	src/lib/config/runtimeSettings.ts	Lazimisha kazi za chinichini kuwashwa wakati wa utambuzi wa majaribio ya kiotomatiki. Weka 1 ili kubatilisha utaratibu wa kukadiria majaribio.
OMNIROUTE_BUDGET_RESET_JOB_INTERVAL_MS	600000	src/lib/jobs/budgetResetJob.ts	Marudio ya ukaguzi wa kuweka upya bajeti (ms). Kiwango cha chini 10000.
OMNIROUTE_CONNECTION_RECOVERY_INTERVAL_MS	60000	src/lib/quota/connectionRecovery.ts	Mzunguko wa urejeshaji wa mapema wa kipindi cha kupoa kwa muunganisho (ms): huthibitisha upya miunganisho ambayo muda wake wa muda mfupi wa rate_limited_until umekwisha, nje ya njia kuu ya ombi. Kiwango cha chini 5000.
OMNIROUTE_DISABLE_CONNECTION_RECOVERY	false	src/lib/quota/connectionRecovery.ts	Zima kipanga ratiba cha urejeshaji wa mapema wa kipindi cha kupoa kwa muunganisho (urejeshaji wa polepole katika getProviderCredentials bado unatumika).
OMNIROUTE_REASONING_CACHE_CLEANUP_INTERVAL_MS	1800000	src/lib/jobs/reasoningCacheCleanupJob.ts	Mzunguko wa kusafisha akiba ya uhawilishaji (ms). Kiwango cha chini 60000.
OMNIROUTE_REASONING_MIN_BUDGET	haijawekwa (imezimwa)	open-sse/services/reasoningTokenBuffer.ts	Kiwango cha chini cha hiari kwa bajeti za matokeo ya modeli za kufikiri: max_tokens ya mwitaji iliyo katika [256, floor) huinuliwa hadi kiwango hicho cha chini (huku ikidhibitiwa na kikomo cha matokeo ya modeli). Haijawekwa = bajeti za mteja haziongezwi kamwe (#9507).
OMNIROUTE_LOG_EXPORT_CRON	0 * * * *	src/lib/jobs/logExportJob.ts	Usemi wa Cron (UTC) kwa kazi ya kuhamisha kumbukumbu za simu ambayo huondoa data kutoka kila lengwa lililowezeshwa la kuhamisha kumbukumbu.
OMNIROUTE_CONFIG_HOT_RELOAD_MS	5000	src/lib/config/hotReload.ts	Kipindi cha ukaguzi (ms) kwa upakiaji upya wa papo hapo wa usanidi. Thamani iliyo chini ya 1000 hukataliwa.
OMNIROUTE_DISABLE_REDIS_AUTH_CACHE	(imewezeshwa)	src/lib/db/apiKeys.ts	Weka 1 ili kukwepa akiba ya uthibitishaji wa ufunguo wa API inayotumia Redis (hulazimisha usomaji kutoka DB).
OMNIROUTE_RTK_TRUST_PROJECT_FILTERS	0	open-sse/services/compression/engines/rtk/filterLoader.ts	Amini kanuni za vichujio vya miradi ya RTK vinavyosimamiwa na mtumiaji bila ukaguzi mkali wa sahihi.
OMNIROUTE_LITE_MAX_TOOL_LENGTH	2000	open-sse/services/compression/lite.ts	Kikomo cha herufi kwa upunguzaji wa mapema wa matokeo ya zana ya Lite wakati lite.maxToolLength haijawekwa. Masafa 256–1000000. Mpangilio wa dashibodi unapewa kipaumbele kuliko env hii.
OMNI_COMPRESSION_WORKERS	2	open-sse/services/compression/compressionWorkerPool.ts	Idadi ya juu zaidi ya wafanyakazi sawia wa RTK/Caveman wanaotekelezwa kwa ulandanishi; kazi za ziada husubiri kwa mpangilio wa FIFO.
OMNI_COMPRESSION_WORKER_TIMEOUT_MS	120000	open-sse/services/compression/compressionWorkerPool.ts	Muda wa kuisha kwa kila kazi kwa milisekunde. Wafanyakazi waliopitisha muda husitishwa na ombi huendelea bila mabadiliko.
OMNI_COMPRESSION_WORKER_IDLE_MS	60000	open-sse/services/compression/compressionWorkerPool.ts	Muda wa kutotumika kwa milisekunde kabla ya mfanyakazi wa ubanaji ambaye hatumiki kusitishwa.
COMPRESSION_PIPELINE_BREAKER_ENABLED	false	open-sse/services/compression/pipelineEngineBreaker.ts	Swichi kuu ya kivunja saketi cha kila injini katika bomba lililorundikwa la T02. Ya hiari (imezimwa kwa chaguo-msingi) — ikiwa imewashwa, injini inayotupa hitilafu mara kwa mara katika maombi tofauti hurukwa (huendelea licha ya hitilafu) kwa kipindi cha kupoa; ikiwa imezimwa = tabia ya zamani inayofanana kwa kila baiti.
COMPRESSION_PIPELINE_BREAKER_THRESHOLD	3	open-sse/services/compression/pipelineEngineBreaker.ts	Idadi ya kushindwa mfululizo katika maombi tofauti kabla ya kivunja saketi cha injini kufunguka.
COMPRESSION_PIPELINE_BREAKER_COOLDOWN_MS	30000	open-sse/services/compression/pipelineEngineBreaker.ts	Idadi ya milisekunde ambayo injini iliyofunguliwa huendelea kurukwa kabla ya jaribio la hali ya kufunguka kwa sehemu.
COMPRESSION_CCR_RETRIEVAL_RAMP_FACTOR	2	open-sse/services/compression/engines/ccr/index.ts	Mpando wa mrejesho wa uletaji wa CCR wa T08/H8: kila uletaji wa awali wa bloku iliyohifadhiwa huongeza minChars yake inayotumika kwa mstari (maudhui yanayoletwa mara kwa mara hubanwa kwa kiwango kidogo; uletaji >=3 = hayabanwi kamwe). 1 huzima mpando (kuruka kwa jozi kunakotokea kwenye kiwango cha juu pekee).
COMPRESSION_CCR_DURABLE_STORE	true	open-sse/services/compression/engines/ccr/index.ts	Hifadhi endelevu ya vizuizi ya CCR (#9061). Hutumia SQLite kuimarisha hifadhi ya ndani ya kumbukumbu ili kizuizi kiendelee kuwepo baada ya kuondolewa na LRU, kuisha kwa TTL, kuwashwa upya, au ombi la urejeshaji kuelekezwa kwenye instansi nyingine. Weka false ili kuhifadhi vizuizi kwenye kumbukumbu pekee. Vizuizi vinavyozidi 512KB na mazingira ya utekelezaji ya wingu husalia kwenye kumbukumbu pekee bila kujali mpangilio huu.
COMPRESSION_PREFIX_FREEZE_ENABLED	false	open-sse/services/compression/prefixFreeze.ts	Swichi kuu ya T08/H5 ya kufungia kiambishi awali kilichobainishwa kupitia matumizi. Ni ya kuwezeshwa kwa hiari (imezimwa kwa chaguo-msingi) — inapowashwa, kidokezo cha mfumo kilichoonekana mara >= ya kiwango cha juu huchukuliwa kuwa kiambishi awali thabiti kinachoweza kuhifadhiwa kwenye kache na hulindwa dhidi ya ubanaji hata kwa watoa huduma ambao mbinu tuli ya kache haiwatambui (ufungiaji hulinda tu, haubadilishi kamwe).
COMPRESSION_PREFIX_FREEZE_THRESHOLD	3	open-sse/services/compression/prefixFreeze.ts	Idadi ya mara ambazo kidokezo cha mfumo huonekana kabla ya kuchukuliwa kuwa kiambishi awali thabiti kilichofungiwa.
OMNIROUTE_BOOTSTRAPPED	false	src/app/(dashboard)/dashboard/page.tsx	Huwekwa kuwa true na hati ya bootstrap baada ya usanidi wa awali. Hudhibiti mwonekano wa mchawi wa usanidi.
OMNIROUTE_ALLOW_BODY_PROJECT_OVERRIDE	0	open-sse/executors/antigravity.ts	Njia ya dharura: ruhusu body ya ombi kubatilisha sehemu ya mradi wa Antigravity.
ANTIGRAVITY_CREDITS	off	open-sse/services/antigravityCredits.ts	Sera ya salio la Google One AI: off haiingizi salio kamwe, retry huingiza mara moja baada ya hitilafu ya kiwango kinachostahiki ya 429, na always huingiza kwenye ombi la kwanza.
ANTIGRAVITY_ALLOW_SIGNATURE_BYPASS	0	open-sse/translator/request/openai-to-gemini.ts	Ruhusu kitafsiri cha ombi cha Antigravity kuruka uthibitishaji wake mkali wa sahihi ya ombi la CLI wakati huduma ya upstream inapokataa sahihi halisi (hali ya utatuzi/CLI iliyopitwa na wakati). Thamani isiyo sifuri huwezesha urukaji huo.
AGY_TOKEN_FILE	~/.gemini/antigravity-cli/antigravity-oauth-token	src/app/api/providers/agy-auth/apply-local/route.ts	Batilisha njia ya faili ya tokeni ya Antigravity CLI (agy) kwa ajili ya kuleta kiotomatiki taarifa za kuingia za ndani zilizotambuliwa.

Daraja la OAuth CLI (La Ndani)

Kigezo	Chaguo-msingi	Faili Chanzo	Maelezo
OMNIROUTE_SERVER	tambua kiotomatiki	src/lib/oauth/config/index.ts	URL ya seva kwa daraja la uthibitishaji la CLI↔OmniRoute.
OMNIROUTE_TOKEN	(haijawekwa)	src/lib/oauth/config/index.ts	Tokeni ya uthibitishaji kwa daraja la CLI.
OMNIROUTE_USER_ID	cli	src/lib/oauth/config/index.ts	Kitambulisho cha mtumiaji kwa vipindi vya daraja la CLI.
SERVER_URL	(haijawekwa)	src/lib/oauth/config/index.ts	Jina mbadala la zamani la OMNIROUTE_SERVER.
CLI_TOKEN	(haijawekwa)	src/lib/oauth/config/index.ts	Jina mbadala la zamani la OMNIROUTE_TOKEN.
CLI_USER_ID	(haijawekwa)	src/lib/oauth/config/index.ts	Jina mbadala la zamani la OMNIROUTE_USER_ID.

---

11. Vitambulisho vya Mtoa Huduma wa OAuth

Vitambulisho vilivyojengewa ndani kwa ajili ya uendelezaji kwenye localhost. Kwa uwekaji wa mbali, sajili vitambulisho vyako kwenye dashibodi ya wasanidi programu ya kila mtoa huduma.

Kigezo	Mtoa huduma	Maelezo
CLAUDE_OAUTH_CLIENT_ID	Claude Code (Anthropic)	Mteja wa umma — hakuna siri inayohitajika.
CLAUDE_CODE_REDIRECT_URI	Claude Code	Badilisha URI ya uelekezaji upya. Chaguomsingi: https://platform.claude.com/oauth/code/callback
CODEX_OAUTH_CLIENT_ID	Codex / OpenAI	Mteja wa umma.
GEMINI_OAUTH_CLIENT_ID	Gemini (Google)	Inahitaji _SECRET inayolingana.
GEMINI_OAUTH_CLIENT_SECRET	Gemini (Google)	—
KIMI_CODING_OAUTH_CLIENT_ID	Kimi Coding (Moonshot)	Mteja wa umma.
ANTIGRAVITY_OAUTH_CLIENT_ID	Antigravity (Google)	Inahitaji _SECRET inayolingana.
ANTIGRAVITY_OAUTH_CLIENT_SECRET	Antigravity (Google)	—
GITHUB_OAUTH_CLIENT_ID	GitHub Copilot	Mteja wa umma.
GHE_COPILOT_OAUTH_CLIENT_ID	GHE Copilot	Ubadilishaji wa hiari wa kitambulisho cha mteja wa OAuth cha GitHub Enterprise Copilot. Hurejea kwenye chaguomsingi la umma la GITHUB_OAUTH_CLIENT_ID ikiwa hakijawekwa.
WINDSURF_API_KEY	Windsurf / Devin (v3.8)	Njia mbadala ya ufunguo wa API inayotumiwa na open-sse/executors/devin-cli.ts wakati hakuna kitambulisho mahususi cha muunganisho kinachopatikana. Ni ya hiari.
CLI_DEVIN_BIN	Devin CLI (v3.8)	Njia maalum ya faili tekelezi ya Devin CLI (devin). Hutatuliwa na open-sse/executors/devin-cli.ts.
GITLAB_DUO_OAUTH_CLIENT_ID	GitLab Duo (v3.8)	Kitambulisho cha mteja wa OAuth cha GitLab Duo. Sajili programu kwenye https://gitlab.com/-/profile/applications kwa URI ya uelekezaji upya <NEXT_PUBLIC_BASE_URL>/callback na mawanda api, read_user, openid, profile, email. Hurejea kwenye GITLAB_OAUTH_CLIENT_ID.
GITLAB_DUO_OAUTH_CLIENT_SECRET	GitLab Duo (v3.8)	Siri ya mteja wa OAuth ya GitLab Duo. Ni ya hiari — mtiririko wa PKCE hauhitaji siri. Hurejea kwenye GITLAB_OAUTH_CLIENT_SECRET.
GITLAB_DUO_BASE_URL	GitLab Duo (v3.8)	Badilisha URL ya msingi ya GitLab (GitLab inayopangishwa binafsi). Chaguomsingi ni https://gitlab.com. Hurejea kwenye GITLAB_BASE_URL.
GITLAB_BASE_URL	GitLab Duo (v3.8)	Njia mbadala ya zamani ya GITLAB_DUO_BASE_URL. Hutumiwa wakati kibadala cha _DUO_ hakijawekwa.
GITLAB_OAUTH_CLIENT_ID	GitLab Duo (v3.8)	Njia mbadala ya zamani ya GITLAB_DUO_OAUTH_CLIENT_ID inayotumiwa na src/lib/oauth/constants/oauth.ts.
GITLAB_OAUTH_CLIENT_SECRET	GitLab Duo (v3.8)	Chaguo mbadala la zamani la GITLAB_DUO_OAUTH_CLIENT_SECRET linalotumiwa na src/lib/oauth/constants/oauth.ts.
QODER_OAUTH_CLIENT_SECRET	Qoder	—
QODER_OAUTH_AUTHORIZE_URL	Qoder	Weka ili kuwezesha Qoder OAuth.
QODER_OAUTH_TOKEN_URL	Qoder	—
QODER_OAUTH_USERINFO_URL	Qoder	—
QODER_OAUTH_CLIENT_ID	Qoder	—
QODER_PERSONAL_ACCESS_TOKEN	Qoder	Chaguo mbadala la ufunguo wa API wa moja kwa moja (linakwepa OAuth).
QODER_CLI_WORKSPACE	Qoder	Kitambulisho cha nafasi ya kazi cha Qoder CLI.
OMNIROUTE_QODER_WORKSPACE	Qoder	Jina mbadala la QODER_CLI_WORKSPACE.
QODER_CLI_CONFIG_DIR	Qoder	Batilisha saraka ya usanidi ya Qoder CLI (kipindi kilichotengwa cha PAT, huepuka kuharibu uingiaji kupitia kivinjari).
BLACKBOX_WEB_VALIDATED_TOKEN	Blackbox Web	Tokeni ya tk ya upande wa mbele ya kutumwa kama validated kwenye /api/chat. Inahitajika wakati Blackbox inapolazimisha tokeni zilingane; vinginevyo OmniRoute hutumia UUID nasibu kama chaguo mbadala. Tazama suala #2252.
VISION_BRIDGE_BASE_URL	Kinga ya Vision Bridge	URL ya msingi inayooana na OpenAI kwa miito ya vision-bridge isiyo ya Anthropic. Kwa chaguo-msingi hutumia env ya URL ya zamani ya OpenAI au api.openai.com. Ielekeze kwenye mzunguko binafsi wa OmniRoute wa /v1 au endpoint yoyote inayooana na OpenAI (Gemini OpenAI-compat, OpenRouter). Suala #2232. Wakati URL ni /v1 ya OmniRoute yenyewe, ombi dogo la ufafanuzi hutuma x-omniroute-admission-bypass: internal na kuthibitisha utambulisho kwa kitambulisho kilichotatuliwa cha mzunguko binafsi (sk_omniroute sentinel katika hali ya ndani, au OMNIROUTE_API_KEY / ROUTER_API_KEY — #1350) ili upelekaji wenye REQUIRE_API_KEY=true ufanye kazi.
VISION_BRIDGE_API_KEY	Kinga ya Vision Bridge	Ufunguo wa API kwa URL iliyo hapo juu. Hubatilisha vigeu vya env vya OpenAI / Google vya kila mtoa huduma kwa miito ya vision-bridge isiyo ya Anthropic. Miundo ya Anthropic huendelea kutumia njia yake maalum ya ufunguo wa Anthropic. Suala #2232.

Warning

1. Nenda kwenye Google Cloud Console → Credentials
2. Unda OAuth 2.0 Client ID (aina: "Web application")
3. Ongeza URL ya seva yako kama Authorized redirect URI
4. Badilisha thamani za vitambulisho katika .env.

---

12. Ubatilishaji wa User-Agent wa Mtoa Huduma

Batilisha kichwa cha User-Agent kinachotumwa kwa kila mtoa huduma wa juu. Hili hutatuliwa kwa nguvu wakati wa utekelezaji na darasa la msingi la kitekelezaji:

process.env[`${PROVIDER_ID}_USER_AGENT`]

Chanzo: open-sse/executors/base.ts → buildHeaders()

Kigezo	Thamani Chaguo-msingi	Wakati wa Kusasisha
CLAUDE_USER_AGENT	claude-cli/2.1.258 (external, cli)	Anthropic inapotoa toleo jipya la CLI
CLAUDE_DISABLE_TOOL_NAME_CLOAK	false	executors/base.ts + executors/cliproxyapi.ts	Weka kuwa 1/true ili kupeleka majina ya zana za mfumo wa wahusika wengine bila kubadilishwa hadi Anthropic kwenye njia zote mbili zinazoelekezwa kwa Anthropic (OAuth asilia na CLIProxyAPI). Kwa chaguo-msingi, kitekelezaji huunda lakabu za majina ya zana yasiyo ya Claude Code kwa njia thabiti (kwa kutumia ulinganishaji rasmi wa Claude Code pale unapopatikana, vinginevyo PascalCase) na huyarejesha kwenye majibu kupitia _toolNameMap, ili mifumo yenye zana za snake_case isikataliwe kwa kutambuliwa kuwa viteja vya wahusika wengine. Kwa utatuzi pekee.
CODEX_USER_AGENT	codex-cli/0.142.0 (Windows 10.0.26200; x64)	OpenAI inaposasisha Codex CLI
CODEX_CLIENT_VERSION	0.131.0	Batilisha toleo la kiteja cha Codex bila kutegemea mfuatano kamili wa UA
CLAUDE_CODE_CLIENT_VERSION	2.1.258	Batilisha toleo la Claude Code linalotangazwa bila kutegemea CLAUDE_USER_AGENT. Anthropic huzuia baadhi ya modeli kulingana na thamani hii (#12417).
GITHUB_COPILOT_CLI_VERSION	1.0.81-6	Batilisha toleo la Copilot CLI linalotangazwa bila kutegemea GITHUB_USER_AGENT
GITHUB_USER_AGENT	GitHubCopilotChat/0.54.0	GitHub Copilot Chat inaposasishwa
ANTIGRAVITY_USER_AGENT	antigravity/2.0.1 darwin/arm64	Antigravity IDE inaposasishwa
KIRO_USER_AGENT	AWS-SDK-JS/3.0.0 kiro-ide/1.0.0	Kiro IDE inaposasishwa
KIRO_OAUTH_CLIENT_ID	kiro-cli	Batilisha clientId ya msimbo wa kifaa wa kijamii wa Kiro (kitambulisho cha umma)
KIRO_VERIFY_FULL_CRC	false	Chaguo la kujiunga: uthibitishaji kamili wa CRC kwa kila fremu kwenye mtiririko wa matukio wa Kiro (kwa utatuzi wa mitiririko iliyoharibika)
QODER_USER_AGENT	Qoder-Cli	Qoder CLI inaposasishwa
CURSOR_USER_AGENT	Cursor/3.3	Cursor inaposasishwa

Tip

Unaweza kuongeza ubatilishaji wa User-Agent kwa mtoa huduma yeyote kwa kutumia muundo {PROVIDER_ID}_USER_AGENT. Kitekelezaji huunda jina la kigezo cha mazingira kwa nguvu.

---

13. Uoanifu wa Alama ya Utambulisho ya CLI

Inapowezeshwa, OmniRoute hupanga upya vichwa vya HTTP na sehemu za mwili wa JSON ili zilingane na saini halisi ya zana rasmi za CLI. Hii hupunguza hatari ya akaunti yako kuwekewa alama huku ikihifadhi IP ya proksi yako.

Chanzo: open-sse/config/cliFingerprints.ts, open-sse/executors/base.ts

Kwa Kila Mtoa Huduma

Kigezo	Uwezeshaji	Athari
CLI_COMPAT_CODEX	=1	Huiga saini ya ombi la Codex CLI
CLI_COMPAT_CLAUDE	=1	Huiga saini ya ombi la Claude Code
CLI_COMPAT_GITHUB	=1	Huiga saini ya ombi la GitHub Copilot
CLI_COMPAT_ANTIGRAVITY	=1	Huiga saini ya ombi la Antigravity
CLI_COMPAT_CURSOR	=1	Huiga saini ya ombi la Cursor
CLI_COMPAT_KIMI_CODING	=1	Huiga saini ya ombi la Kimi Coding
CLI_COMPAT_KILOCODE	=1	Huiga saini ya ombi la Kilo Code
CLI_COMPAT_CLINE	=1	Huiga saini ya ombi la Cline

Kimataifa

Kigezo	Uwezeshaji	Athari
CLI_COMPAT_ALL	=1	Washa uoanifu wa alama ya utambulisho kwa watoa huduma wote kwa wakati mmoja.

Ubatilishaji wa utambulisho wa Kimi Coding CLI

Kigezo	Chaguo-msingi	Faili Chanzo	Maelezo
KIMI_CLI_VERSION	1.36.0	src/lib/oauth/providers/kimi-coding.ts	Batilisha toleo la Kimi CLI linalotumwa wakati wa miito ya OAuth/API.
KIMI_CODING_DEVICE_ID	(chaguo-msingi lililonaswa)	src/lib/oauth/providers/kimi-coding.ts	Batilisha kitambulisho cha kifaa cha Kimi kilichonaswa kinachotumiwa katika vichwa vya mteja.

Note

Kipengele hiki hufanya kazi pamoja na ubatilishaji wa User-Agent (§12). Mfumo wa alama ya utambulisho hushughulikia mpangilio wa vichwa na mpangilio wa sehemu za mwili, huku ubatilishaji wa User-Agent ukishughulikia mfuatano mahususi wa UA. Vyote viwili vinaweza kuwashwa kwa kujitegemea.

---

14. Watoa Huduma wa Ufunguo wa API

Funguo za API za watoa huduma wanaotumia uthibitishaji wa moja kwa moja. Usanidi unaopendekezwa: Dashibodi → Watoa Huduma → Ongeza Ufunguo wa API.

Kuweka kupitia vigezo vya mazingira ni njia mbadala kwa usambazaji wa Docker au usambazaji usio na kiolesura.

Muundo unaotambuliwa: {PROVIDER_ID}_API_KEY

Kigezo	Mtoa Huduma
DEEPSEEK_API_KEY	DeepSeek
NVIDIA_API_KEY	NVIDIA NIM
JINA_AI_API_KEY	Jina AI (Foundation API + njia mbadala ya Reader)
JINA_API_KEY	Jina AI (jina mbadala la JINA_AI_API_KEY)
GEMINI_API_KEY	Gemini (Google AI Studio) upachikaji + njia mbadala ya gumzo
GOOGLE_API_KEY	Gemini (jina mbadala la GEMINI_API_KEY)

Note

Maingizo tuli ya ${PROVIDER}_API_KEY kwa Groq, xAI, Mistral, Perplexity, Together AI, Fireworks, Cerebras, Cohere, Nebius, na Qianfan yaliondolewa katika v3.8.0 kwa sababu mazingira ya utekelezaji hayayasomi tena — watoa huduma hao hutegemea Dashibodi / data/provider-credentials.json / hifadhidata iliyosimbwa kwa njia fiche pekee. Tazama sehemu ya Ukaguzi: Vigezo Vilivyoondolewa / Visivyotumika iliyo chini ya hati hii kwa njia ya uhamishaji.

Tip

Funguo zilizowekwa kupitia Dashibodi huhifadhiwa zikiwa zimesimbwa kwa njia fiche katika SQLite na hupewa kipaumbele kuliko vigezo vya mazingira.

Jina: Upachikaji wa jina-ai/…, upangaji upya, uainishaji, ugawaji, na jina-search hazitozi ufunguo wa mazingira wa klasta wakati muunganisho wa dashibodi wa jina-ai (au jina-reader inayoshirikiwa) upo — getProviderCredentials hujaza ya kwanza. JINA_AI_API_KEY / JINA_API_KEY hutumiwa tu wakati hakuna ufunguo wa dashibodi unaoweza kutumika. Kumbukumbu za miito huhusisha njia mbadala ya mazingira kama connection_id=env:JINA_AI_API_KEY. Kadi ya Reader (jina-reader, r.jina.ai) haitumiki kamwe kwa /v1/embeddings au /v1/rerank.

Gemini: gemini/gemini-embedding-2 (jina mbadala google/gemini-embedding-2) hutumia kwanza muunganisho wa dashibodi wa gemini. GEMINI_API_KEY / GOOGLE_API_KEY hutumiwa tu wakati hakuna ufunguo wa dashibodi unaoweza kutumika. Kumbukumbu za miito huhusisha njia mbadala ya mazingira kama connection_id=env:GEMINI_API_KEY. Trafiki asilia ya modi nyingi hutumia x-goog-api-key dhidi ya :embedContent / :batchEmbedContents — vipengee N vya input vya OpenAI huwa vekta N.

---

15. Mipangilio ya Muda wa Kuisha

Thamani zote ziko katika milisekunde. Utatuzi umewekwa pamoja katika src/shared/utils/runtimeTimeouts.ts.

Mpangilio wa Ngazi za Muda wa Kuisha

REQUEST_TIMEOUT_MS (ubatilishaji wa jumla)
├─→ FETCH_TIMEOUT_MS (miito kwa watoa huduma wa nje, chaguomsingi: 600000)
│   ├─→ FETCH_HEADERS_TIMEOUT_MS (hurithi kutoka FETCH_TIMEOUT_MS)
│   ├─→ FETCH_BODY_TIMEOUT_MS (hurithi kutoka FETCH_TIMEOUT_MS)
│   ├─→ TLS_CLIENT_TIMEOUT_MS (hurithi kutoka FETCH_TIMEOUT_MS)
│   │   └── TLS_FIRST_BYTE_WATCHDOG_MS (huru, chaguomsingi: 10000)
│   ├── RESPONSES_FIRST_BYTE_TIMEOUT_MS (huru, chaguomsingi: 15000)
│   ├── FETCH_CONNECT_TIMEOUT_MS (huru, chaguomsingi: 30000)
│   └── FETCH_KEEPALIVE_TIMEOUT_MS (huru, chaguomsingi: 4000)
├─→ STREAM_IDLE_TIMEOUT_MS (hurithi kutoka REQUEST_TIMEOUT_MS, chaguomsingi: 600000)
├─→ STREAM_ACTIVE_TIMEOUT_MS (huru, chaguomsingi: 1260000; 0 huzima)
├─→ STREAM_READINESS_TIMEOUT_MS (hurithi kutoka REQUEST_TIMEOUT_MS, chaguomsingi: 80000)
├─→ STREAM_READINESS_MAX_TIMEOUT_MS (huweka kikomo cha nyongeza zinazobadilika za utayari, chaguomsingi: 180000)
└─→ API_BRIDGE_PROXY_TIMEOUT_MS (hurithi kutoka REQUEST_TIMEOUT_MS, chaguomsingi: 30000)
    ├─→ API_BRIDGE_SERVER_REQUEST_TIMEOUT_MS (imetokana na nyingine, chaguomsingi: 300000)
    ├── API_BRIDGE_SERVER_HEADERS_TIMEOUT_MS (chaguomsingi: 60000)
    ├── API_BRIDGE_SERVER_KEEPALIVE_TIMEOUT_MS (chaguomsingi: 5000)
    └── API_BRIDGE_SERVER_SOCKET_TIMEOUT_MS (chaguomsingi: 0 = imezimwa)

Kigezo	Chaguo-msingi	Maelezo
REQUEST_TIMEOUT_MS	(haijawekwa)	Njia ya mkato ya jumla — hubatilisha chaguo-msingi za FETCH_TIMEOUT_MS na STREAM_IDLE_TIMEOUT_MS.
FETCH_TIMEOUT_MS	600000	Muda wa juu wa jumla wa ombi la HTTP kwa miito ya mtoa huduma wa upande wa juu.
STREAM_IDLE_TIMEOUT_MS	600000	Ukimya wa juu zaidi kati ya baiti ghafi za upande wa juu kabla ya kusitisha. Miundo ya kufikiri kwa kina mara chache husitisha kwa zaidi ya sekunde 90.
STREAM_ACTIVE_TIMEOUT_MS	1260000	Muda wa juu zaidi wa jumla wa mtiririko amilifu wa SSE; hauwekwi upya kamwe na baiti za upande wa juu na hautegemei REQUEST_TIMEOUT_MS. Umetokana na timeoutMs kubwa zaidi kwa kila muundo kwenye sajili (1200000, Codex), pamoja na nyongeza ya 60000, ili muundo unaoruhusiwa kutumia bajeti yake yote usikatishwe katikati ya jibu. Weka 0 ili kuizima.
OMNIROUTE_SSE_COMMENTS	(imezimwa)	Ikiwa OmniRoute inaweza kutoa mistari ya maoni ya SSE ya : (kwa mfano, mapigo ya moyo ya : keepalive na vionjo vya mwisho vya metadata vya x-omniroute-*). Imezimwa kwa chaguo-msingi (#10524) kwa sababu viteja vinavyofuata kikamilifu uoanifu wa OpenAI hutumia JSON.parse kwa kila mstari wa SSE na huvurugika kwa maoni ya :; mapigo ya moyo ya data: hayaathiriki. Weka on/true/1/yes ili kujiunga tena. Hutumiwa na open-sse/utils/sseHeartbeat.ts.
STREAM_READINESS_TIMEOUT_MS	80000	Muda wa kupokea tukio la kwanza la SSE ambalo si ping. Hurithi REQUEST_TIMEOUT_MS inapowekwa.
STREAM_READINESS_MAX_TIMEOUT_MS	180000	Kipindi cha juu zaidi kinachobadilika cha utayari wa tukio la kwanza kwa maombi makubwa ya utiririshaji, yanayotumia zana nyingi, au yanayohitaji kiwango cha juu cha kufikiri.
OMNIROUTE_AGENT_GOAL_POLICY_ENABLED	true	Swichi ya kuzima dharura kwa heuristiki ya /goal. Weka false/0/off ili kuzima utambuzi kikamilifu — muda wa juu wa utayari na urejeshaji wa mtiririko haviongezwi kamwe na mwili/vichwa vya ombi, hivyo kupunguza ukuzaji wa muda wa juu unaodhibitiwa na kiteja.
OMNIROUTE_AGENT_GOAL_READINESS_MAX_TIMEOUT_MS	600000	Kipindi cha juu zaidi cha utayari wa tukio la kwanza kwa utekelezaji wa wakala wa /goal uliotambuliwa au maombi yaliyolazimishwa kwa x-omniroute-agent-goal.
OMNIROUTE_AGENT_GOAL_STREAM_RECOVERY	true	Washa urejeshaji wa mapema wa mtiririko kiotomatiki kwa utekelezaji wa wakala wa /goal uliotambuliwa. Weka false/0/off ili kuzima ujiandikishaji mahususi wa lengo. Hii inaweza tu KUONGEZA urejeshaji juu ya chaguo-msingi la mwendeshaji — haibatilishi kamwe uamuzi wa wazi wa kujiondoa kupitia mipangilio ya STREAM_RECOVERY_ENABLED/DB.
OMNIROUTE_CODEX_DROP_NONSTANDARD_EVENTS	true	Ondoa matukio yasiyo ya kawaida ya SSE ya codex.* (kwa mfano, codex.rate_limits) ambayo huharibu responses.stream() ya OpenAI SDK kwa 502. Huwashwa kwa chaguo-msingi (#11014). Weka 0/false/no/off ili kuyapitisha.
OMNIROUTE_CODEX_APPSERVER_WS	(haijawekwa)	Usafirishaji wa hiari wa app-server ya Codex. Endpoint ya WebSocket (ws:///wss://) ya sidecar ya ndani ya codex app-server. Inapowekwa pamoja na tokeni, maombi ya Codex hupitishwa kupitia JSON-RPC kwenda kwenye sidecar badala ya HTTP Responses API. Pia inaweza kuwekwa kwa kila muunganisho kupitia providerSpecificData.codexAppServerUrl. Hutumiwa na open-sse/executors/codex/appServerConfig.ts.
OMNIROUTE_CODEX_APPSERVER_WS_TOKEN	(haijawekwa)	Tokeni ya uwezo/bearer iliyo ndani ya mstari inayowasilishwa kwa app-server. Ubatilishaji kwa kila muunganisho: providerSpecificData.codexAppServerToken.
OMNIROUTE_CODEX_APPSERVER_WS_TOKEN_FILE	(haijawekwa)	Njia ya faili iliyo na tokeni ya uwezo ya app-server (kutoka codex app-server --ws-token-file). Hutumiwa wakati OMNIROUTE_CODEX_APPSERVER_WS_TOKEN haijawekwa. Ubatilishaji kwa kila muunganisho: providerSpecificData.codexAppServerTokenFile.
OMNIROUTE_CODEX_APPSERVER_CWD	/tmp	Saraka ya kufanyia kazi ambamo zamu ya app-server huendeshwa. Ubatilishaji kwa kila muunganisho: providerSpecificData.codexAppServerCwd.
OMNIROUTE_CODEX_APPSERVER_APPROVAL	(haijawekwa)	Sera ya uidhinishaji inayopitishwa kwa zamu ya app-server (kwa mfano, never, on-request). Ubatilishaji kwa kila muunganisho: providerSpecificData.codexAppServerApprovalPolicy.
OMNIROUTE_CODEX_APPSERVER_SANDBOX	(haijawekwa)	Sera ya sandbox inayopitishwa kwa zamu ya app-server (kwa mfano, read-only, workspace-write, danger-full-access). Isipowekwa, kitekelezaji hutumia workspace-write kwa chaguo-msingi (imeimarishwa; hapo awali ilikuwa danger-full-access). Ubatilishaji kwa kila muunganisho: providerSpecificData.codexAppServerSandbox.
OMNIROUTE_CODEX_APPSERVER_AUTO_APPROVE	false	Idhinisha kiotomatiki vidokezo vya uidhinishaji vya app-server yenyewe (utekelezaji wa amri/faili/ruhusa kwenye seva pangishi). Huzimwa kwa chaguo-msingi — vidokezo hukataliwa kiotomatiki; miito ya zana ya harness haiathiriki (husafiri kupitia njia tofauti ya kupitisha item/tool/call). Hukubali true/1/yes. Ubatilishaji kwa kila muunganisho: providerSpecificData.codexAppServerAutoApprove.
FETCH_HEADERS_TIMEOUT_MS	= FETCH_TIMEOUT_MS	Muda wa kupokea vichwa vya majibu.
OMNIROUTE_DIRECT_HEADERS_TIMEOUT_MS	30000 (sekunde 30)	Muda wa juu zaidi wa kusubiri kuanza kwa jibu (ms) kwa kila jaribio la moja kwa moja lisilotumia proksi. Muda ukiisha, jaribio hurudiwa mara moja kwenye soketi mpya; weka 0 ili kuzima kikomo na kudumisha tabia ya awali.
FETCH_BODY_TIMEOUT_MS	= FETCH_TIMEOUT_MS	Muda wa kupokea mwili mzima wa jibu.
FETCH_CONNECT_TIMEOUT_MS	30000	Muda wa mwisho wa kuanzisha muunganisho wa TCP.
FETCH_KEEPALIVE_TIMEOUT_MS	4000	Muda wa mwisho wa kutokuwa na shughuli kwa soketi ya keep-alive.
TLS_CLIENT_TIMEOUT_MS	= FETCH_TIMEOUT_MS	Muda wa mwisho wa proksi ya alama ya kipekee ya TLS (wreq-js).
TLS_FIRST_BYTE_WATCHDOG_MS	10000	Huweka kikomo cha muda hadi baiti ya kwanza kwa mwili wa usafirishaji wenye alama ya kipekee ya TLS wa wreq-js hasa; TLS_CLIENT_TIMEOUT_MS peke yake haiwezi kugundua mwili uliokwama kwa sababu hukamilika mara tu vijajuu vinapowasili (#12656). Muda ukiisha, kisomaji cha wreq hughairiwa na mfumo hurudi kutumia kisambazaji cha moja kwa moja/proksi; 0 huzima kifuatiliaji.
RESPONSES_FIRST_BYTE_TIMEOUT_MS	15000	Kwa kitekelezaji cha OpenCode pekee, na wakati tu alama ya kipengele OPENCODE_RESPONSES_STALL_ROTATION imewashwa (kwa chaguo-msingi imezimwa): huweka kikomo cha kusubiri baiti ya kwanza ya mwili wa jibu la Responses linalotiririshwa baada ya vijajuu vyake (#13484). Mtiririko wa Responses hufunguka kwa response.created, kwa hivyo ukimya unaozidi kipindi hiki ni kukwama: akaunti huwekwa kwenye kipindi cha kusubiri na ombi huhamishiwa kwenye akaunti inayofuata mara moja; kukwama kwa mara ya pili husababisha kushindwa mara moja. 0 huzima ulinzi hata alama ikiwa imewashwa.
API_BRIDGE_PROXY_TIMEOUT_MS	30000	Muda wa mwisho wa hatua ya proksi kwa maombi ya daraja ya /v1.
FIRECRAWL_BASE_URL	https://api.firecrawl.dev	Elekeza kitekelezaji cha Firecrawl cha kuleta data kutoka wavuti kwenye instansi inayopangishwa binafsi (ufunguo wa API ni wa hiari nje ya wingu).
FIRECRAWL_TIMEOUT_MS	30000	Muda wa mwisho kwa kila ombi kwa kitekelezaji cha Firecrawl cha kuleta data kutoka wavuti.
API_BRIDGE_SERVER_REQUEST_TIMEOUT_MS	300000	Muda wa mwisho wa jumla wa ombi la seva kwa daraja.
API_BRIDGE_SERVER_HEADERS_TIMEOUT_MS	60000	Muda wa kutuma vijajuu vya jibu kupitia daraja.
API_BRIDGE_SERVER_KEEPALIVE_TIMEOUT_MS	5000	Muda wa mwisho wa kutokuwa na shughuli kwa keep-alive ya daraja.
API_BRIDGE_SERVER_SOCKET_TIMEOUT_MS	0	Muda wa mwisho wa soketi ghafi (0 = umezimwa).
SHUTDOWN_TIMEOUT_MS	30000	Kipindi cha kusubiri baada ya SIGTERM/SIGINT kabla ya kulazimisha kuondoka.
OMNIROUTE_DEFAULT_FETCH_TIMEOUT_MS	120000	Thamani mbadala inayotumiwa na src/shared/utils/fetchTimeout.ts wakati FETCH_TIMEOUT_MS haijawekwa.
OMNIROUTE_PROVIDER_PROBE_TIMEOUT_MS	8000	Muda wa mwisho (ms) kwa usanidi uliowekwa awali wa validationRead na modelsProbe katika src/shared/network/safeOutboundFetch.ts. Uongeze kwa ncha za mwisho zenye kasi ndogo (Cerebras, Cloudflare AI, Groq) ili kuzuia kubadilika-badilika kati ya hali ya kufanya kazi/kosa kwenye dashibodi. Hurudi kutumia 8000ms kwa thamani batili (<1000) au zisizo za nambari.
OMNIROUTE_RELAY_FETCH_TIMEOUT_MS	25000	Muda wa mwisho wa kuleta data mahususi kwa relay katika open-sse/utils/proxyFetch.ts (#9158). Relay iliyokwama lazima ishindwe kabla ya muda wa mwisho wa mteja/ajenti (~sekunde 30) ili wapigaji waone hitilafu mahususi ya relay badala ya muda wa mwisho wa jumla wa chanzo cha juu. Huwekewa kikomo cha 29000 ili kila wakati ianze kutumika kwanza.
OMNIROUTE_RETRY_BACKOFF_MS	10	Muda wa pamoja wa kusubiri kabla ya kujaribu tena kwa njia za kujaribu mara moja zaidi za moja kwa moja/relay/proksi katika open-sse/utils/proxyFetch.ts (#9158). 0 = jaribu tena mara moja.
OMNIROUTE_CLAUDE_TLS_TIMEOUT_MS	60000	Muda wa mwisho wa ombi asilia la wreq-js (claudeTlsClient.ts).
OMNIROUTE_CLAUDE_TLS_GRACE_MS	10000	Kipindi cha ziada cha mwisho kabisa cha JS kinachoongezwa juu ya muda wa mwisho asilia.
OMNIROUTE_PPLX_TLS_TIMEOUT_MS	30000	Muda wa mwisho wa ombi asilia la wreq-js (perplexityTlsClient.ts).
OMNIROUTE_PPLX_TLS_GRACE_MS	10000	Kipindi cha ziada cha mwisho kabisa cha JS kinachoongezwa juu ya muda wa mwisho asilia.
OMNIROUTE_PPLX_SEARCH_HINT	0 (imezimwa)	Huongeza "Una uwezo uliojengewa ndani wa kutafuta wavuti. Jibu maswali moja kwa moja ukitumia matokeo ya utafutaji." kwenye ujumbe wa mfumo wa mwitaji (perplexity-web/protocol.ts). Imezimwa kwa chaguo-msingi — Perplexity hutafuta hata hivyo, na sentensi hiyo hujitokeza kwenye majibu kama maelezo ya kimeta kwa wateja wa uandishi wa msimbo. Weka 1/true/yes/on ili kuirejesha.
OMNIROUTE_GROK_TLS_TIMEOUT_MS	60000	Muda wa mwisho wa ombi asilia la wreq-js (grokTlsClient.ts).
OMNIROUTE_GROK_TLS_GRACE_MS	10000	Muda wa ziada wa mwisho kabisa wa JS unaoongezwa juu ya muda wa mwisho asilia.
OMNIROUTE_NOTION_TLS_TIMEOUT_MS	30000	Muda wa mwisho wa ombi asilia la wreq-js (notionTlsClient.ts); notion-web huongeza muda huo kwa kila ombi hadi 180000 kwa uzalishaji unaochukua muda mrefu.
OMNIROUTE_NOTION_TLS_GRACE_MS	10000	Muda wa ziada wa mwisho kabisa wa JS unaoongezwa juu ya muda wa mwisho asilia.
OMNIROUTE_BROWSER_POOL	on	Dimbwi la pamoja la kivinjari cha Playwright kwa gumzo la vidakuzi vya wavuti linaloendeshwa kupitia kivinjari (browserPool.ts); weka off ili kulizima.
OBSCURA_BIN	auto-detect	Njia ya faili ya binari ya obscura inayotumiwa kama injini ya msingi na dimbwi la kivinjari pamoja na kitekelezaji cha Cloudflare Playground (open-sse/services/obscura.ts); hutambuliwa kiotomatiki kutoka kwenye PATH ya mfumo ikiwa haijawekwa.
OBSCURA_CDP_ENDPOINT	(haijawekwa)	Elekeza kwenye Obscura ambayo tayari inaendeshwa (http://host:port) badala ya kuanzisha mpya; moduli haimiliki mchakato huo (open-sse/services/obscura.ts).
OBSCURA_PORT	mlango huru wa nasibu	Mlango mahususi wa obscura serve iliyoanzishwa; mlango huru huchaguliwa kiotomatiki ikiwa haujawekwa (open-sse/services/obscura.ts).
WEB_COOKIE_USE_BROWSER	0	Chagua ombi la gumzo la vidakuzi vya wavuti litumie njia inayoendeshwa kupitia kivinjari (browserBackedChat.ts); tumia 1 ili kuiwezesha.
KIMI_WEB_BASE_URL	https://www.kimi.ai	URL ya msingi ya kitekelezaji cha Kimi Web (kimi.ai Connect-RPC ya kimataifa) (kimi-web.ts); ibadilishe kwa anwani za mwisho za kioo/proksi pekee.
KIMI_WEB_CHAT_URL	<KIMI_WEB_BASE_URL>/apiv2/kimi.gateway.chat.v1.ChatService/Chat	Anwani kamili ya mwisho ya gumzo kwa kitekelezaji cha Kimi Web (kimi-web.ts).
OMNIROUTE_LOGIN_BROWSER_PATH	(hutambuliwa kiotomatiki)	Njia ya faili ya kitekelezeka cha Chrome/Edge cha mfumo kwa ajili ya kuingia kwa mwingiliano kupitia kivinjari cha Adobe Firefly (adobeFireflyBrowserLogin.ts); hubatilisha utambuzi wa kiotomatiki wa kila OS.
OMNIROUTE_STANDALONE_DIR	.build/ toleo la standalone	Ubatilishaji wa wakati wa ujenzi wa saraka ya toleo la standalone inayotumiwa na hatua ya kuweka pamoja baada ya ujenzi (scripts/build/colocate-standalone.mjs); ni ya zana za ujenzi, si ya wakati wa utekelezaji.

Majaribio ya shabaha za combo hurithi muda wa mwisho wa ombi la upande wa juu uliotatuliwa (FETCH_TIMEOUT_MS, au REQUEST_TIMEOUT_MS inapotoa chaguo-msingi la fetch). Weka targetTimeoutMs kwenye combo, chaguo-msingi za combo, au ubatilishaji wa mtoa huduma ili tu kufanya urejeaji mbadala wa combo uwe wa haraka zaidi; thamani zilizo juu ya muda wa sasa wa mwisho wa upande wa juu hupunguzwa hadi muda wa mwisho wa upande wa juu.

comboTimeoutMs ni bajeti tofauti ya muda halisi kwa combo nzima katika shabaha zote za uhamishaji baada ya hitilafu. Iache bila kuwekwa au iwe 0 ili kudumisha urudiaji usio na kikomo (kizuizi cha kusimamisha kukwama cha dakika 10 cha COMBO_LOOP_SAFETY_TIMEOUT_MS bado kinatumika). Thamani chanya hubadilisha kinga hiyo kwa combo. Hakikisha comboTimeoutMs ni ndefu kuliko targetTimeoutMs ili uhamishaji baada ya hitilafu bado uwe na muda baada ya shabaha ya kwanza iliyo polepole.

Viwango vya Kikatiza Mzunguko

Urekebishaji wa kikatiza mzunguko katika kiwango cha mtoa huduma. Chaguo-msingi yanaakisi thamani zilizopanuliwa zinazotumiwa tangu v3.6 kwa miunganisho 500+.

Kigezo	Chaguo-msingi	Faili Chanzo	Maelezo
OMNIROUTE_CIRCUIT_BREAKER_OAUTH_THRESHOLD	8	open-sse/config/constants.ts	Kikomo cha hitilafu zinazofuatana kwa watoa huduma wa OAuth kabla ya kivunja mzunguko kuamilishwa.
OMNIROUTE_CIRCUIT_BREAKER_OAUTH_RESET_MS	60000	open-sse/config/constants.ts	Kipindi cha uwekaji upya (ms) kwa kivunja mzunguko cha mtoa huduma wa OAuth.
OMNIROUTE_CIRCUIT_BREAKER_API_KEY_THRESHOLD	12	open-sse/config/constants.ts	Kikomo cha hitilafu zinazofuatana kwa watoa huduma wanaotumia ufunguo wa API.
OMNIROUTE_CIRCUIT_BREAKER_API_KEY_RESET_MS	30000	open-sse/config/constants.ts	Kipindi cha uwekaji upya (ms) kwa kivunja mzunguko cha mtoa huduma anayetumia ufunguo wa API.
OMNIROUTE_CIRCUIT_BREAKER_LOCAL_THRESHOLD	2	open-sse/config/constants.ts	Kikomo cha hitilafu zinazofuatana kwa watoa huduma wa ndani (Ollama, LM Studio, ...).
OMNIROUTE_CIRCUIT_BREAKER_LOCAL_RESET_MS	15000	open-sse/config/constants.ts	Kipindi cha uwekaji upya (ms) kwa kivunja mzunguko cha mtoa huduma wa ndani.
OMNIROUTE_PROVIDER_BREAKER_OAUTH_FAILURE_THRESHOLD	10	open-sse/config/constants.ts	Kivunja mzunguko cha kiwango cha mtoa huduma: hitilafu ndani ya kipindi kabla ya mtoa huduma mzima wa OAuth kuingia katika hali ya kusubiri.
OMNIROUTE_PROVIDER_BREAKER_OAUTH_FAILURE_WINDOW_MS	900000	open-sse/config/constants.ts	Kivunja mzunguko cha kiwango cha mtoa huduma: kipindi kinachosogea cha kuhesabu hitilafu (ms) kwa watoa huduma wa OAuth.
OMNIROUTE_PROVIDER_BREAKER_OAUTH_COOLDOWN_MS	300000	open-sse/config/constants.ts	Kivunja mzunguko cha kiwango cha mtoa huduma: muda wa kusubiri (ms) baada ya kikomo cha mtoa huduma wa OAuth kufikiwa.
OMNIROUTE_PROVIDER_BREAKER_OAUTH_DEGRADATION_THRESHOLD	5	open-sse/config/constants.ts	Mtoa huduma wa OAuth huingia katika hali ya DEGRADED baada ya idadi hii ya hitilafu.
OMNIROUTE_PROVIDER_BREAKER_OAUTH_MAX_BACKOFF_MULTIPLIER	8	open-sse/config/constants.ts	Kizidishi cha juu zaidi cha ongezeko la resetTimeout kwa mtoa huduma wa OAuth.
OMNIROUTE_PROVIDER_BREAKER_OAUTH_BACKOFF_ESCALATION_COUNT	2	open-sse/config/constants.ts	Mtoa huduma wa OAuth huongeza muda wa kusubiri baada ya idadi hii ya mizunguko ya hali ya wazi.
OMNIROUTE_PROVIDER_BREAKER_API_KEY_FAILURE_THRESHOLD	15	open-sse/config/constants.ts	Kivunja mzunguko cha kiwango cha mtoa huduma: hitilafu ndani ya kipindi kabla ya mtoa huduma mzima anayetumia ufunguo wa API kuingia katika hali ya kusubiri.
OMNIROUTE_PROVIDER_BREAKER_API_KEY_FAILURE_WINDOW_MS	1800000	open-sse/config/constants.ts	Kivunja mzunguko cha kiwango cha mtoa huduma: kipindi kinachosogea cha kuhesabu hitilafu (ms) kwa watoa huduma wanaotumia ufunguo wa API.
OMNIROUTE_PROVIDER_BREAKER_API_KEY_COOLDOWN_MS	600000	open-sse/config/constants.ts	Kivunja mzunguko cha kiwango cha mtoa huduma: muda wa kusubiri (ms) baada ya kikomo cha mtoa huduma anayetumia ufunguo wa API kufikiwa.
OMNIROUTE_PROVIDER_BREAKER_API_KEY_DEGRADATION_THRESHOLD	7	open-sse/config/constants.ts	Mtoa huduma anayetumia ufunguo wa API huingia katika hali ya DEGRADED baada ya idadi hii ya hitilafu.
OMNIROUTE_PROVIDER_BREAKER_API_KEY_MAX_BACKOFF_MULTIPLIER	4	open-sse/config/constants.ts	Kizidishi cha juu zaidi cha ongezeko la resetTimeout kwa mtoa huduma anayetumia ufunguo wa API.
OMNIROUTE_PROVIDER_BREAKER_API_KEY_BACKOFF_ESCALATION_COUNT	3	open-sse/config/constants.ts	Mtoa huduma anayetumia ufunguo wa API huongeza muda wa kusubiri baada ya idadi hii ya mizunguko ya hali ya wazi.
OMNIROUTE_PROVIDER_BREAKER_LOCAL_FAILURE_THRESHOLD	2	open-sse/config/constants.ts	Kivunja mzunguko cha kiwango cha mtoa huduma: hitilafu kabla ya mtoa huduma mzima wa ndani kuingia katika hali ya kusubiri.
OMNIROUTE_PROVIDER_BREAKER_LOCAL_FAILURE_WINDOW_MS	300000	open-sse/config/constants.ts	Kivunja mzunguko cha kiwango cha mtoa huduma: kipindi kinachosogea cha kuhesabu hitilafu (ms) kwa watoa huduma wa ndani.
OMNIROUTE_PROVIDER_BREAKER_LOCAL_COOLDOWN_MS	60000	open-sse/config/constants.ts	Kivunja mzunguko cha kiwango cha mtoa huduma: muda wa kusubiri (ms) baada ya kikomo cha mtoa huduma wa ndani kufikiwa.
PIN_DROP_BACKOFF_LEVEL	2	open-sse/services/combo.ts	Kiwango cha ucheleweshaji ambapo mtoa huduma wa pini ya akiba ya muktadha huchukuliwa kuwa na hitilafu ya kudumu na pini huondolewa ili kuruhusu uhamishaji wa kushindwa.
PIN_DROP_GRACE_MS	20000	open-sse/services/combo.ts	Kipindi cha kuzuia kuyumba (ms) kinachoruhusu vipindi vifupi vya muda vya kusubiri kabla ya kuondoa pini ya akiba ya muktadha.

Matukio

Tukio	Usanidi
Uzalishaji wa msimbo wa muda mrefu	REQUEST_TIMEOUT_MS=900000 (dakika 15)
Weka kikomo cha jumla cha muda wa mtiririko	STREAM_ACTIVE_TIMEOUT_MS=1260000 (dakika 21)
Kushindwa haraka kwa API ya uzalishaji	API_BRIDGE_PROXY_TIMEOUT_MS=10000
Miundo ya kufikiri kwa kina	STREAM_IDLE_TIMEOUT_MS=300000 (dakika 5 kati ya vipande)

---

16. Uwekaji kumbukumbu

Mfumo wa uwekaji kumbukumbu huandika kwenye stdout na pia kwenye faili za kumbukumbu zinazozungushwa. Usanidi wote husomwa na src/lib/logEnv.ts.

Kigezo	Chaguo-msingi	Maelezo
APP_LOG_LEVEL	info	Kiwango cha chini cha kumbukumbu: debug, info, warn, error.
APP_LOG_FORMAT	text	Umbizo la matokeo: text (linalosomeka na binadamu) au json (lililopangwa).
APP_LOG_TO_FILE	true	Andika kumbukumbu kwenye faili pamoja na stdout.
APP_LOG_FILE_PATH	logs/application/app.log	Njia ya faili ya kumbukumbu (ikilinganishwa na mzizi wa mradi au DATA_DIR).
APP_LOG_MAX_FILE_SIZE	50M	Ukubwa wa juu wa faili kabla ya kuzungushwa. Hukubali: 50M, 1G, 512K, au baiti za kawaida.
APP_LOG_RETENTION_DAYS	7	Siku za kuhifadhi faili za kumbukumbu za programu zilizozungushwa.
APP_LOG_MAX_FILES	20	Idadi ya juu ya nakala rudufu za faili za kumbukumbu zilizozungushwa.
CALL_LOG_RETENTION_DAYS	7	Siku za kuhifadhi maingizo ya kumbukumbu za maombi/simu kwenye kanzidata.
CALL_LOG_MAX_ENTRIES	10000	Idadi ya juu ya maingizo ya kumbukumbu za simu kwenye bafa ya kumbukumbu ya muda.
CALL_LOGS_TABLE_MAX_ROWS	100000	Idadi ya juu ya safu kwenye jedwali la SQLite la call_logs kabla ya kupunguzwa.
ENABLE_REQUEST_LOGS	(haijawekwa)	Lazimisha uwekaji wa kina wa kumbukumbu za maombi uwashwe au uzimwe, ukipuuza mpangilio wa dashibodi.
MAX_PENDING_REQUEST_AGE_MS	3600000 (saa 1)	Umri wa juu wa maingizo yatima ya kumbukumbu za maombi amilifu kabla ya kusafishwa kwenye kumbukumbu ya muda.
CALL_LOG_PIPELINE_CAPTURE_STREAM_CHUNKS	false	Hifadhi vipande vya mtiririko kwenye vizalia vya pipeline wakati call_log_pipeline_enabled=true. Huwashwa kwa hiari (true) — imezimwa kwa chaguo-msingi ili kuokoa nafasi ya diski.
CALL_LOG_PIPELINE_MAX_SIZE_KB	512	Ukubwa wa juu wa kizalia cha kumbukumbu ya simu cha pipeline katika KB wakati call_log_pipeline_enabled=true.
PROXY_LOGS_TABLE_MAX_ROWS	100000	Idadi ya juu ya safu kwenye jedwali la SQLite la proxy_logs kabla ya kupunguzwa.
PROXY_LOG_INCLUDE_IPS	false	Jumuisha IP za mteja/zinazotoka na viambishi awali vya akaunti kwenye kumbukumbu za dashibodi za [ProxyEgress]. Rekodi za kumbukumbu za proksi kwenye dashibodi/kanzidata huhifadhi maelezo kamili.
APP_LOG_ROTATION_CHECK_INTERVAL_MS	60000 (dakika 1)	Mara ambazo src/lib/logRotation.ts hukagua tena ukubwa wa faili amilifu ya kumbukumbu.
CHAT_LOG_TEXT_LIMIT	65536	Urefu wa juu wa tungo unaohifadhiwa kwenye vizalia vya kumbukumbu za gumzo (chaguo-msingi KB 64).
CHAT_LOG_ARRAY_TAIL_ITEMS	128	Idadi ya vipengee vya safu vinavyohifadhiwa kutoka mwisho wakati wa kufupisha data za kumbukumbu za gumzo.
CHAT_LOG_MAX_DEPTH	6	Kina cha juu cha upachikaji kabla ya data za kumbukumbu za gumzo kufupishwa.
CHAT_LOG_MAX_OBJECT_KEYS	80	Idadi ya juu ya funguo za kitu zinazohifadhiwa kwenye data za kumbukumbu za gumzo (0 = bila kikomo).
CHAT_LOG_MAX_BODY_KB	1024	Ukubwa wa mwili mzima wa ombi/jibu (KB) ambao ukizidi hubadilishwa na muhtasari rahisi badala ya nakala kamili. Ongeza thamani hii ikiwa mazungumzo marefu ya kiwakala yanaonyesha kishikilia nafasi badala ya ujumbe halisi kwenye dashibodi.
CHAT_DEBUG_FILE	false	Ikiwa true, serializeArtifactForStorage huruka ufupishaji unaotegemea ukubwa. Kwa utatuzi pekee.

---

17. Uboreshaji wa Kumbukumbu

Kigezo	Chaguo-msingi	Maelezo
OMNIROUTE_MEMORY_MB	otomatiki (seva halisi); 1024 katika picha ya Docker	Kikomo cha heap cha V8 (MB) kinachopendekezwa kwa Docker/utekelezaji wa kujitegemea. Kikiwa hakijawekwa, hurekebishwa kwa nguvu (~35% ya RAM ya mfumo, kikizuiwa ndani ya [512, 4096]); 512 huwa kiwango cha chini tu wakati jumla ya kumbukumbu haiwezi kusomwa. Kwenye run-standalone.mjs (Docker CMD), thamani iliyobainishwa waziwazi huongezwa kama --max-old-space-size na hushinda alama ya heap ya NODE_OPTIONS inayokinzana (alama ya mwisho ya V8). omniroute serve bado hupendelea alama iliyopo ya heap ya NODE_OPTIONS (#5238). Usiweke zote mbili kwa nambari tofauti — mchakato huandika onyo linalotaja thamani zote mbili na mshindi. Picha rasmi ya Docker huweka 1024 kila wakati, kwa hivyo urekebishaji haufanyiki humo. Coding-agent /v1/responses inahitaji 8192–12288 pamoja na nafasi ya ziada ya cgroup — angalia Mwongozo wa Docker — RAM ya wakati wa utekelezaji.
PROMPT_CACHE_MAX_SIZE	50	Idadi ya juu zaidi ya maingizo ya prompt ya mfumo yaliyohifadhiwa kwenye kashe.
PROMPT_CACHE_MAX_BYTES	2097152 (2 MB)	Ukubwa wa juu zaidi wa jumla wa kashe ya prompt.
PROMPT_CACHE_TTL_MS	300000 (dakika 5)	TTL ya ingizo la kashe ya prompt.
SEMANTIC_CACHE_MAX_SIZE	100	Idadi ya juu zaidi ya majibu ya temperature=0 yaliyohifadhiwa kwenye kashe.
SEMANTIC_CACHE_MAX_BYTES	4194304 (4 MB)	Ukubwa wa juu zaidi wa jumla wa kashe ya kisemantiki.
SEMANTIC_CACHE_TTL_MS	1800000 (dakika 30)	TTL ya ingizo la kashe ya kisemantiki.
OMNIROUTE_CORPUS_CACHE_SIZE	5	Mizizi ya korpasi ya ndani inayoweka faharasa hai ndani ya kumbukumbu kwa wakati mmoja (src/lib/localCorpus/configured.ts). LRU: kikomo kinapofikiwa, faharasa ya mzizi ambao haujatumiwa kwa muda mrefu zaidi huondolewa na kujengwa upya katika hoja inayofuata. Huzuiwa kwa kiwango cha chini cha 1; thamani isiyo ya nambari hurudi kwenye chaguo-msingi.
STREAM_HISTORY_MAX	50	Idadi ya juu zaidi ya matukio ya hivi karibuni ya mtiririko katika bafa ya mwonekano wa moja kwa moja wa Dashibodi.
CONTEXT_LENGTH_DEFAULT	128000	Kikomo cha juu cha urefu wa muktadha mbadala wa kimataifa kwa modeli zisizo na usanidi uliobainishwa waziwazi.
USAGE_TOKEN_BUFFER	100	Nafasi ya ziada ya tokeni inayotengwa wakati wa kufuatilia viwango vya juu vya matumizi.

Mfinyazo

Kigezo	Chaguo-msingi	Maelezo
OMNIROUTE_RTK_TRUST_PROJECT_FILTERS	hakijawekwa	Amini .rtk/filters.json ya mradi bila hash ya .rtk/trust.json. Tumia tu katika mazingira ya maendeleo ya ndani yanayodhibitiwa.

Injini ya Kumbukumbu (mpango wa 21)

Gharama ya mzunguko wa matukio ya kumbukumbu, ujuzi na uonyeshaji upya wa tokeni (#10349)

OmniRoute ni mchakato mmoja wa Node. Uchimbaji/urejeshaji wa kumbukumbu, uingizaji wa ujuzi na uonyeshaji upya wa tokeni za mtoa huduma huendeshwa kwenye mzunguko huo huo wa matukio kama GET /healthz na dashibodi. Si thread ya worker.

Kazi	Msimbo	Chaguo-msingi	Udhibiti wa opereta
Uchimbaji / urejeshaji wa kumbukumbu	src/lib/memory/	memoryEnabled kwenye dashibodi (imewashwa kwa chaguo-msingi)	Zima Mipangilio → Kumbukumbu. Hakuna swichi tofauti ya env ya kusitisha kipengele hiki zaidi ya kukizima kwenye mipangilio.
Uingizaji wa ujuzi	src/lib/skills/injection.ts	skillsEnabled kwenye dashibodi (imewashwa kwa chaguo-msingi)	Zima Mipangilio → Kumbukumbu/Ujuzi (skillsEnabled). Vidhibiti vya sandbox vilivyo hapa chini huwekea mipaka utekelezaji baada tu ya uingizaji kuwa tayari umewashwa.
Uonyeshaji upya wa tokeni	src/sse/services/tokenRefresh.ts	Umewashwa kwa watoa huduma waliounganishwa wa OAuth/wavuti	Tenganisha mtoa huduma au acha tokeni ziendelee kuwa halali; kwa sasa hakuna env ya TOKEN_REFRESH=0.

Ikiwa /healthz ni polepole kwenye mashine isiyo na shughuli, zima kumbukumbu + ujuzi kwanza, kisha ukague mzigo wa katalogi/ubanaji (#10303, #9685). Vipengele hivi huachia utekelezaji kwenye sehemu za await, lakini bado vinashindania thread moja.

Vidhibiti vya safu ya embedding, hifadhi ya vekta na upangaji upya wa matokeo kwa mfumo mdogo wa kumbukumbu endelevu (src/lib/memory/).

Kigezo	Chaguo-msingi	Maelezo
MEMORY_EMBEDDING_CACHE_TTL_MS	300000 (dakika 5)	TTL ya cache ya embedding iliyo kwenye kumbukumbu (kwa kila sahihi ya chanzo/modeli/vipimo).
MEMORY_EMBEDDING_CACHE_MAX	1000	Idadi ya juu zaidi ya maingizo ya LRU yanayohifadhiwa kwenye cache ya embedding.
MEMORY_TRANSFORMERS_MODEL	Xenova/all-MiniLM-L6-v2	Kitambulisho cha repo ya HF kwa pipeline ya ndani ya MiniLM ya hiari ya @huggingface/transformers (~23 MB int8, ~400 MB RAM).
MEMORY_STATIC_MODEL	minishlab/potion-base-8M	Kitambulisho cha repo ya HF kwa kiundaji embedding cha jedwali la utafutaji tuli la potion/Model2Vec. Hupakuliwa inapohitajika hadi kwenye saraka ya cache.
MEMORY_STATIC_CACHE_DIR	<DATA_DIR>/embeddings	Saraka inayotumika kuhifadhi kwenye cache faili za modeli tuli ya potion. Kwa chaguo-msingi huwa chini ya DATA_DIR ikiwa haijawekwa.
HF_HUB_ENDPOINT	https://huggingface.co	Batilisha URL msingi ya Hugging Face Hub inayotumiwa na staticPotion.ts (k.m. endpoint ya kioo kwa usanidi uliotengwa na mtandao).
MEMORY_VEC_TOP_K	20	top-K ya chaguo-msingi inayotumiwa na utafutaji wa vekta wa brute-force wa sqlite-vec ndani ya src/lib/memory/vectorStore.ts.
MEMORY_RRF_K	60	Konstanti k ya Reciprocal Rank Fusion kwa urejeshaji mseto wa FTS5 + vekta (utaratibu wa sqlite-vec).
VECTOR_STORE_DISABLE_VEC	false	Kiungio cha majaribio/uchunguzi katika getVectorStore() (src/lib/memory/vectorStore.ts): ikiwa true, hulazimisha hifadhi ya vekta kuwa null (huiga mazingira ya cloud/WASM bila sqlite-vec), na kushusha urejeshaji wa kumbukumbu hadi utafutaji wa maneno muhimu wa FTS5. Iache bila kuwekwa katika uzalishaji.
NOTION_API_KEY	(haijawekwa)	Ufunguo wa API wa backend ya Notion (hutumiwa na usanidi awali wa backend inayojulikana wa genericBackend.ts).
NOTION_API_URL	https://api.notion.com/v1	URL msingi ya API ya Notion (inaweza kubatilishwa kwa njia mbadala za Notion zinazopangishwa binafsi).
OBSIDIAN_API_KEY	(haijawekwa)	Ufunguo wa API wa backend ya Obsidian Vault (hutumiwa na usanidi awali wa backend inayojulikana wa genericBackend.ts).
OBSIDIAN_API_URL	http://localhost:27123	URL msingi ya API ya Obsidian Vault (inaweza kubatilishwa kwa vault ya mbali).
MEMORY_TYPED_DECAY_ENABLED	false	Swichi kuu ya uozo wa kumbukumbu zenye aina wa TV6. Ni ya hiari (imezimwa kwa chaguo-msingi) — ufagiaji hufuta kumbukumbu zilizooza. Ikiwa imezimwa, access_count/last_accessed_at ni telemetria pekee na hakuna kinachofutwa kamwe.
MEMORY_TYPED_DECAY_EPISODIC_DAYS	30	TTL (siku) ambayo baada yake kumbukumbu ya episodic ambayo haijatumika huoza. 0 huifanya episodic pia kuwa sugu. Aina za kudumu (factual/procedural/semantic) huwa sugu kila wakati. Saa ya uozo huwekewa msingi mpya kulingana na last_accessed_at.
MEMORY_TYPED_DECAY_ACCESS_IMMUNITY	3	Kumbukumbu iliyoingizwa mara >= idadi hii huwa sugu dhidi ya uozo bila kujali aina. 0 huzima kinga ya ufikiaji.
MEMORY_TYPED_DECAY_SWEEP_INTERVAL	0 (imezimwa)	Kipindi (sekunde) cha ufagiaji wa hiari wa mara kwa mara wa uozo katika src/lib/memory/typedDecay.ts. 0/haijawekwa = hakuna ufagiaji wa mara kwa mara. Huhitaji kuwezeshwa mara mbili: pia huhitaji MEMORY_TYPED_DECAY_ENABLED=true.
OMNIROUTE_STRICT_SYSTEM_PROVIDERS	(haijawekwa)	Vitambulisho vya watoa huduma vilivyotenganishwa kwa koma (bila kujali herufi kubwa au ndogo) vinavyokubali ujumbe wa system kwenye index 0 pekee (src/lib/memory/injection.ts). Kwa hawa, kuingiza kumbukumbu katikati ya array kwa njia salama kwa cache si salama katika mazungumzo ya zamu nyingi, kwa hivyo kumbukumbu huunganishwa/huongezwa mwanzoni kama ujumbe wa system unaoongoza. Kwa chaguo-msingi ni xiaomi-mimo/mimo pekee; panua kwa endpoint zinazooana na OpenAI na zinazopangishwa binafsi (k.m. Qwen3.5+/3.6) ambazo template yake ya gumzo hutekeleza kizuizi kilekile cha ujumbe mmoja wa system unaoongoza.

Mfano wa Docker wenye RAM Kidogo

128 ni ya dashibodi pekee. Mawakala wa uandishi wa msimbo kwenye heap hii hupata FATAL ERROR wakati wa /v1/responses ndefu. Usitumie mfano huu kama gateway ya Claude/Codex/Grok.

OMNIROUTE_MEMORY_MB=128
PROMPT_CACHE_MAX_SIZE=20
PROMPT_CACHE_MAX_BYTES=524288        # 512 KB
SEMANTIC_CACHE_MAX_SIZE=25
SEMANTIC_CACHE_MAX_BYTES=1048576     # 1 MB
STREAM_HISTORY_MAX=10

---

18. Usawazishaji wa Bei

Usawazishaji wa kiotomatiki wa data ya bei za modeli kutoka vyanzo vya nje.

Kigezo	Chaguo-msingi	Faili Chanzo	Maelezo
PRICING_SYNC_ENABLED	false	src/lib/pricingSync.ts	Huwasha usawazishaji wa bei wa mara kwa mara.
PRICING_SYNC_INTERVAL	86400 (saa 24)	src/lib/pricingSync.ts	Kipindi cha usawazishaji katika sekunde.
PRICING_SYNC_SOURCES	litellm	src/lib/pricingSync.ts	Vyanzo vya data vilivyotenganishwa kwa koma.

---

Usawazishaji wa ELO wa Arena

Kigezo	Chaguo-msingi	Faili Chanzo	Maelezo
ARENA_ELO_SYNC_ENABLED	true	src/shared/constants/featureFlagDefinitions.ts	Usawazishaji wa mara kwa mara wa ELO wa ubao wa wanaoongoza wa Arena AI, unaoweza kusanidiwa kupitia Dashboard Feature Flags au kuzimwa kwa kutumia false.
MODELS_CATALOG_PREFIX_MODE	dual	src/shared/constants/featureFlagDefinitions.ts, src/app/api/v1/models/catalog.ts	Muundo wa kiambishi awali unaotumiwa kwa vitambulisho vya modeli katika GET /v1/models. dual hutangaza kiambishi awali kifupi cha jina mbadala na kiambishi awali rasmi cha mtoa huduma kwa kila modeli (uoanifu wa matoleo ya awali — takribani huongeza ukubwa wa katalogi mara mbili); alias hutoa kitambulisho kimoja kwa kila modeli; canonical hutoa tu kiambishi awali kamili cha kitambulisho cha mtoa huduma (watoa huduma ambao jina lao mbadala tayari ni kitambulisho rasmi hubaki na ingizo lao moja). Wateja wanaweza kubatilisha mpangilio huu kwa kila ombi kwa kutumia ?prefix=alias. Tazama API_REFERENCE.
ARENA_ELO_SYNC_INTERVAL	86400 (saa 24)	src/lib/arenaEloSync.ts	Kipindi cha usawazishaji katika sekunde.

---

Mtoa Huduma wa PromptQL Playground (Asiye Rasmi/Majaribio)

Daraja la kipindi cha GraphQL lililoundwa kwa uhandisi wa kinyume kwa ajili ya prompt.ql.app (src/shared/constants/providers/web-cookie.ts). Yote ni ya hiari — chaguo-msingi yanaelekeza kwenye endpoints za umma za playground; yabadilishe tu kwa deployment ya PromptQL inayohifadhiwa binafsi/mbadala.

Kigezo	Chaguo-msingi	Faili Chanzo	Maelezo
PROMPTQL_GRAPHQL_ENDPOINT	https://data.prompt.ql.app/promptql/playground-v2-hge/v1/graphql	open-sse/executors/promptql.ts	Endpoint ya GraphQL inayotumiwa kwa shughuli za gumzo/kipindi.
PROMPTQL_CREDITS_ENDPOINT	https://data.pro.ql.app/v1/graphql	open-sse/executors/promptql.ts, open-sse/services/usage/promptql.ts	Endpoint ya GraphQL inayotumiwa kuuliza salio/matumizi ya credits.
PROMPTQL_TOKEN_REFRESH_URL	https://auth.pro.ql.app/ddn/project/token	open-sse/executors/promptql.ts	Endpoint inayotumiwa kujaribu kuonyesha upya tokeni.
PROMPTQL_POLL_TIMEOUT_MS	180000	open-sse/executors/promptql.ts	Muda wa juu zaidi (ms) wa kukagua thread_events kabla muda haujaisha.

---

Mtoa Huduma wa Wavuti wa HyperAgent (Usio Rasmi/Majaribio)

Kiunganishi cha kipindi kilichoundwa kwa uhandisi wa kinyume kwa ajili ya hyperagent.com (src/shared/constants/providers/web-cookie.ts). Si lazima — chaguo-msingi linaelekeza kwenye endpoint ya umma ya malipo/matumizi; libadilishe tu kwa usambazaji wa HyperAgent unaopangishwa binafsi/mbadala.

Kigezo	Chaguo-msingi	Faili Chanzo	Maelezo
HYPERAGENT_USAGE_URL	https://hyperagent.com/api/settings/billing/usage	open-sse/services/usage/hyperagent.ts	Endpoint inayotumika kuleta vifurushi vya salio la malipo/matumizi.

---

Vikomo vya Matumizi vya Kilo Code

Utafutaji wa salio binafsi la USD na matumizi ya Kilo Pass kwa mtoa huduma wa Kilo Code. Si lazima — chaguo-msingi linaelekeza kwenye API ya umma ya Kilo; libadilishe tu kwa relay/fixture ya majaribio. Uthibitishaji hutumia tokeni iliyopo ya ufikiaji ya OAuth ya muunganisho.

Kigezo	Chaguo-msingi	Faili Chanzo	Maelezo
KILO_API_URL	https://api.kilo.ai	open-sse/services/usage/kilocode.ts	URL msingi inayotumika kuleta salio binafsi la Kilo Code na matumizi ya Kilo Pass.

---

Mtoa Huduma wa Wavuti wa Adobe Firefly (Usio Rasmi/Majaribio)

Uonyeshaji upya wa kipindi unaoendeshwa na kivinjari kwa mtoa huduma wa wavuti wa Adobe Firefly (open-sse/services/adobeFireflyBrowserLogin.ts, open-sse/services/adobeFireflySession.ts, open-sse/services/adobeFireflyClient.ts). Si lazima — chaguo-msingi zote zimeboreshwa kwa usakinishaji wa kawaida wa kompyuta ya mezani.

Iliondolewa katika #9255. Mfumo wa zamani wa utekelezaji wa Chrome uliounganishwa na CDP (adobeFireflyChromeRuntime.ts) ulibadilishwa na huduma ya kuingia kupitia kivinjari ya Playwright, na mipangilio yake haipo tena. Vigezo vya ADOBE_FIREFLY_CHROME_ CDP_PORT / VISIBLE / HEADED / PING / FORCE_RESTART, pamoja na ADOBE_FIREFLY_LOGIN_WAIT_MS na ADOBE_FIREFLY_FORTER_WAIT_MS, havisomwi popote katika msingi wa msimbo — kuviweka hakutakuwa na athari.

Kigezo	Chaguo-msingi	Faili Chanzo	Maelezo
ADOBE_FIREFLY_CHROME_HEADLESS	0	open-sse/services/adobeFireflyBrowserLogin.ts	Weka kuwa 1 kwa Chrome halisi isiyo na kiolesura (inajulikana kutofanya kazi kwa uzalishaji; kwa utatuzi pekee).
ADOBE_FIREFLY_BROWSER_REFRESH	1	open-sse/services/adobeFireflySession.ts	Kuwasha/kuzima upashaji joto wa kivinjari kwa hiari na mapema. 0 huzima upashaji joto wa mapema (urejeshaji wa 408 katikati ya bechi bado hutumika).
ADOBE_FIREFLY_SESSION_DISK	1	open-sse/services/adobeFireflySession.ts	Weka kuwa 0 ili kuzima uhifadhi endelevu wa kipindi cha Adobe Firefly kwenye diski.
ADOBE_FIREFLY_MIN_SUBMIT_GAP_MS	(haijawekwa)	open-sse/services/adobeFireflySession.ts	Pengo la chini zaidi (ms) linalolazimishwa kati ya mawasilisho yanayofuatana, likibatilisha chaguo-msingi lililojengewa ndani.
ADOBE_FIREFLY_BATCH_EXTRA_GAP_MS	(haijawekwa)	open-sse/services/adobeFireflySession.ts	Pengo la ziada (ms) linaloongezwa baada ya bechi iliyofanikiwa, likibatilisha chaguo-msingi lililojengewa ndani.
ADOBE_FIREFLY_SUBMIT_BASE_DELAY_MS	(haijawekwa)	open-sse/services/adobeFireflyClient.ts	Ucheleweshaji wa msingi (ms) kabla ya kuwasilisha ombi la uzalishaji, ukibatilisha chaguo-msingi lililojengewa ndani.

---

19. Usawazishaji wa Modeli (Dev)

Kigezo	Chaguo-msingi	Faili Chanzo	Maelezo
MODELS_DEV_SYNC_ENABLED	(hakijawekwa)	src/lib/modelsDevSync.ts	Ubatilishaji wa moja kwa moja wa usawazishaji wa bei wa models.dev. Ikiwa hakijawekwa = heshimu Mipangilio > AI (modelsDevSyncEnabled). 0/false/off/no hupewa kipaumbele kuliko DB na huruka usawazishaji wa mara kwa mara pamoja na uchanganuzi wa SQL/JSON wa getModelsDevPricing() (urejeshaji wakati dashibodi imekwama kwenye kitanzi kilekile cha matukio). 1/true/on/yes hulazimisha usawazishaji kuwashwa. Kuhifadhi/kufuta bei bado huita backupDbFile("pre-write"), ambako hakufanyi chochote chini ya kikomo cha dakika 60 au DISABLE_SQLITE_AUTO_BACKUP.
MODELS_DEV_SYNC_INTERVAL	86400 (saa 24)	src/lib/modelsDevSync.ts	Muda kati ya usawazishaji wa katalogi ya modeli wakati wa utengenezaji, kwa sekunde.
CONTEXT_WINDOW_RECONCILE_INTERVAL	86400 (saa 24)	src/lib/contextWindowResolver.ts	Muda (sekunde) wa kipatanishi kinachojirekebisha cha dirisha la muktadha (5004): huweka madirisha yaliyotangazwa na mtoa huduma kutoka ugunduzi wa /models kama ubatilishaji wa auto:discovery yanapotofautiana na katalogi. Weka kuwa 0 ili kuzima. Hutumia tena data ambayo tayari imesawazishwa (hakuna uletaji mpya); hakiandiki kamwe juu ya ubatilishaji wa manual.

---

20. Mipangilio Mahususi kwa Mtoa Huduma

Kigezo	Chaguo-msingi	Faili Chanzo	Maelezo
OPENROUTER_CATALOG_TTL_MS	86400000 (saa 24)	src/lib/catalog/openrouterCatalog.ts	TTL ya akiba ya katalogi ya modeli za OpenRouter.
MODEL_CATALOG_INCLUDE_NAMES	true	src/shared/constants/featureFlagDefinitions.ts	Jumuisha sehemu za name zinazofaa kuonyeshwa katika majibu ya /v1/models. Zima kwa viteja vinavyotarajia ID pekee.
CATALOG_BUILD_TIMEOUT_MS	8000 (sekunde 8)	src/app/api/v1/models/catalogCache.ts	Kikomo cha muda wa kusubiri katika njia baridi kwa uundaji upya uliounganishwa wa katalogi ya GET /v1/models (#12627). Muda ukiisha, jibu la mwisho halali la 200 hutolewa ikiwa lipo.
OMNIROUTE_SYNCED_CATALOG_STALE_AFTER_MS	2592000000 (siku 30)	src/lib/db/models/activeSyncedCatalog.ts	Umri ambao baada yake orodha ya modeli iliyosawazishwa ya muunganisho huacha kuwa mamlaka ya uelekezaji na huruhusu matumizi ya sajili kama mbadala (#12849). Safu ambazo hazijawahi kuwa na muhuri wa muda huhesabiwa kuwa zimepitwa na wakati.
NANOBANANA_POLL_TIMEOUT_MS	120000	open-sse/handlers/imageGeneration.ts	Muda wa juu zaidi wa kusubiri kazi za utengenezaji wa picha za NanoBanana.
NANOBANANA_POLL_INTERVAL_MS	2500	open-sse/handlers/imageGeneration.ts	Marudio ya ukaguzi wa hali ya kazi za NanoBanana.
ADOBE_FIREFLY_SUBMIT_BASE_DELAY_MS	8000	open-sse/services/adobeFireflyUpscale.ts	Ucheleweshaji wa msingi wa ongezeko la muda kwa kasi ya kielelezo wakati wa kujaribu tena kuwasilisha uboreshaji wa Adobe Firefly.
AWS_REGION	(haijawekwa)	src/lib/providers/validation.ts, open-sse/handlers/audioSpeech.ts	Eneo linalotumiwa kuunda vituo vya mwisho vya AWS Bedrock (Kiro, sauti).
AWS_DEFAULT_REGION	(haijawekwa)	src/lib/providers/validation.ts, open-sse/handlers/audioSpeech.ts	Chaguo mbadala wakati AWS_REGION haijawekwa.
CLOUDFLARE_ACCOUNT_ID	(haijawekwa)	open-sse/executors/cloudflare-ai.ts	ID ya akaunti ya Cloudflare Workers AI.
CLOUDFLARE_PLAYGROUND_CHROME_PATH	(haijawekwa)	open-sse/executors/cloudflare-playground.ts	Njia kamili ya faili tekelezi ya Chrome ya kompyuta ya mezani kwa kitekelezaji cha Cloudflare AI Playground, inayotumiwa wakati ukaguzi wa alama ya utambulisho wa hali isiyo na kiolesura unazuia Chromium iliyojumuishwa na Playwright.
CLOUDFLARE_API_BASE	https://api.cloudflare.com/client/v4	src/app/api/settings/proxy/cloudflare-deploy/route.ts	Batilisha msingi wa Cloudflare REST API unaotumiwa na kisambazaji cha relay cha Workers cha kundi la proksi (#4640 / 9router#1360).
NEXT_PUBLIC_CLOUDFLARE_RELAY_DEFAULT_PROJECT	omniroute-relay	src/app/(dashboard)/dashboard/settings/components/proxy/CloudflareRelayModal.tsx	Jina chaguo-msingi la mradi wa worker linalopendekezwa katika kidirisha cha "Deploy Relay" cha kundi la proksi.
NEXT_PUBLIC_CLOUDFLARE_RELAY_ENABLED	true	src/app/(dashboard)/dashboard/settings/components/proxy/ProxyPoolTab.tsx	Weka kuwa false ili kuficha chaguo la relay ya Cloudflare Workers kutoka kwenye kichupo cha Proxy Pool.
CLOUDFLARED_BIN	gundua kiotomatiki	src/lib/cloudflaredTunnel.ts	Njia maalum ya faili tekelezi ya cloudflared.
CLOUDFLARED_PROTOCOL	http2	src/lib/cloudflaredTunnel.ts	Itifaki ya usafirishaji ya handaki: http2 (chaguo-msingi), quic, au auto.
CLOUDFLARED_CONFIG	(haijawekwa)	src/lib/cloudflaredTunnel.ts	Njia ya config.yml ya cloudflared inayodhibitiwa ndani ya mfumo (yenye tunnel:, credentials-file:, ingress:). Ikiwekwa, OmniRoute huendesha tunnel --config <path> run (handaki lenye jina) badala ya handaki la haraka la muda.
CLOUDFLARED_HOSTNAME	(kutoka ingress ya usanidi)	src/lib/cloudflaredTunnel.ts	Ubatilishaji wa jina la mpangishaji la umma la handaki lenye jina (k.m. ai.example.com), linaloripotiwa kama publicUrl/apiUrl. Lisipowekwa, husomwa kutoka kwenye jina la kwanza la mpangishaji la ingress katika usanidi.
DENO_DEPLOY_API_BASE	https://api.deno.com/v2	src/app/api/settings/proxy/deno-deploy/route.ts	Badilisha anwani msingi ya Deno Deploy REST API inayotumiwa na kisambazaji cha relay cha proxy-pool (#4643 / 9router#1437).
NEXT_PUBLIC_DENO_RELAY_DEFAULT_PROJECT	omniroute-deno-relay	src/app/(dashboard)/dashboard/settings/components/proxy/DenoRelayModal.tsx	Jina chaguo-msingi la programu ya Deno Deploy linalopendekezwa katika dirisha la proxy-pool la "Deploy Relay".
NEXT_PUBLIC_DENO_RELAY_ENABLED	true	src/app/(dashboard)/dashboard/settings/components/proxy/ProxyPoolTab.tsx	Weka kuwa false ili kuficha chaguo la relay ya Deno Deploy kwenye kichupo cha Proxy Pool.
SEARCH_CACHE_TTL_MS	300000 (dakika 5)	open-sse/services/searchCache.ts	TTL ya uhifadhi wa muda wa majibu ya API ya utafutaji (Perplexity, Brave, n.k.).
ENABLE_CC_COMPATIBLE_PROVIDER	false	src/shared/utils/featureFlags.ts	Onyesha kiolesura cha majaribio cha mtoa huduma anayeoana na CC kwa relay za Claude Code pekee.
NINEROUTER_HOST	127.0.0.1	open-sse/executors/ninerouter.ts	Badilisha seva mwenyeji ambapo instansi iliyopachikwa ya 9router husikiliza.
NINEROUTER_PORT	20130	open-sse/executors/ninerouter.ts	Badilisha porti ambapo instansi iliyopachikwa ya 9router husikiliza.
EMBED_WS_PROXY_HOST	127.0.0.1	src/lib/services/embedWsProxy.ts	Seva mwenyeji ya kuunganisha proksi ya WebSocket ya huduma iliyopachikwa (loopback pekee kwa chaguo-msingi).
EMBED_WS_PROXY_PORT	20131	src/lib/services/embedWsProxy.ts	Porti ya seva ya proksi ya WebSocket ya huduma iliyopachikwa.
CLIPROXYAPI_HOST	127.0.0.1	open-sse/executors/cliproxyapi.ts	Seva mwenyeji ya daraja la CLIProxyAPI (muunganisho wa zamani).
CLIPROXYAPI_PORT	5544	open-sse/executors/cliproxyapi.ts	Porti ya daraja la CLIProxyAPI.
CLIPROXYAPI_API_KEY	(tupu)	open-sse/handlers/chatCore/cliproxyapiCredentials.ts	Ufunguo mbadala wa data-plane wakati mpangilio wa cliproxyapi_api_key haupo.
CLIPROXYAPI_MANAGEMENT_KEY	(tupu)	src/lib/services/cliproxyAccountHealth.ts	Ufunguo wa usimamizi wa kusoma hali ya akaunti kutoka kwenye instansi ya CLIProxyAPI inayosimamiwa nje.
CLIPROXYAPI_CONFIG_DIR	~/.cli-proxy-api	src/lib/versionManager/processManager.ts	Saraka ya usanidi wa CLIProxyAPI.
CLIPROXY_BIND_HOST	127.0.0.1	docker-compose.yml	Kiolesura cha seva mwenyeji ambacho docker-compose huchapisha sidecar ya cliproxyapi juu yake (#12578). Juzuu yake ya data huhifadhi vitambulisho vya OAuth/API vya watoa huduma, na picha iliyofungwa toleo haina njia ya kubatilisha api-keys za data-plane kupitia mazingira (isipokuwa config.yaml iliyopachikwa), kwa hivyo 0.0.0.0 huweka wazi huduma yenye vitambulisho kwa LAN nzima.
MUX_SERVICE_PORT	8322	src/lib/services/bootstrap.ts	Badilisha porti ambapo daemoni iliyopachikwa ya upangaji wa mawakala ya Mux (coder/mux) husikiliza (daima 127.0.0.1).
DARIO_HOST	127.0.0.1	open-sse/executors/dario.ts	Seva mwenyeji ya kuunganisha/kuunganisha kwa huduma iliyopachikwa ya Dario (loopback pekee kwa chaguo-msingi).
DARIO_PORT	3456	open-sse/executors/dario.ts	Porti ya huduma iliyopachikwa ya Dario.
DARIO_HOST	127.0.0.1	open-sse/executors/dario.ts	Seva mwenyeji ya kuunganisha/kuunganisha kwa huduma iliyopachikwa ya Dario (loopback pekee kwa chaguo-msingi).
DARIO_PORT	3456	open-sse/executors/dario.ts	Porti ya huduma iliyopachikwa ya Dario.
LOCAL_HOSTNAMES	(tupu)	open-sse/config/providerRegistry.ts	Majina ya ziada ya seva yaliyotenganishwa kwa koma ambayo yanachukuliwa kuwa ya "ndani" (majina ya huduma za Docker, n.k.).

ENABLE_CC_COMPATIBLE_PROVIDER ni kwa ajili ya relay za wahusika wengine pekee zinazokubali wateja wa Claude Code tu. OmniRoute huandika upya maombi ili relay hizo ziyakubali. Ikiwa unataka tu kutumia Claude Code CLI, au huna uhakika relay hizi ni nini, acha hii ikiwa imezimwa na badala yake uongeze mtoa huduma wa kawaida anayeendana na Anthropic.

---

21. Afya ya Proksi

Kigezo	Chaguo-msingi	Faili Chanzo	Maelezo
PROXY_FAST_FAIL_TIMEOUT_MS	2000	src/lib/proxyHealth.ts	Muda wa kusubiri wa ukaguzi wa afya unaoshindwa haraka.
PROXY_LATENCY_WINDOW_HOURS	3	src/lib/db/proxies.ts	Kipindi cha muda (saa) cha kukokotoa wastani wa ucheleweshaji wa proksi zinazofaa katika mkakati wa kundi lililoboreshwa kwa ucheleweshaji.
PROXY_HEALTH_CACHE_TTL_MS	30000	src/lib/proxyHealth.ts	TTL ya akiba ya matokeo ya ukaguzi wa afya.
PROXY_HEALTH_UNHEALTHY_CACHE_TTL_MS	2000	src/lib/proxyHealth.ts	TTL ya akiba ya majaribio ya afya ya proksi yaliyoshindwa. Weka muda huu kuwa mfupi kuliko PROXY_HEALTH_CACHE_TTL_MS ili majaribio ya proksi yanayoishiwa na muda kwa muda chini ya utumiaji sambamba wa kiwango cha juu yarudiwe haraka bila kuzima kushindwa haraka kwa proksi ambazo kwa kweli hazifanyi kazi.
PROXY_HEALTH_ENABLED	true	src/lib/proxyHealth/scheduler.ts	Weka false ili kuzima kipanga ratiba cha afya ya proksi cha chinichini ambacho hukagua proksi zilizosajiliwa mara kwa mara.
PROXY_HEALTH_INTERVAL_MS	600000	src/lib/proxyHealth/scheduler.ts	Kipindi cha ukaguzi wa kipanga ratiba cha afya cha chinichini katika ms (kiwango cha chini 60000).
PROXY_HEALTH_TEST_URL	https://httpbin.org/ip	src/lib/proxyHealth/probeTarget.ts	Lengo la ukaguzi wa ufikivu linalotumiwa na kipanga ratiba na endpoint ya /api/settings/proxies/auto-test. Lielekeze kwenye URL ya ndani/inayopangishwa binafsi ili kuepuka chaguo-msingi la umma.
PROXY_HEALTH_TEST_CONCURRENCY	10	src/lib/proxyHealth/probeTarget.ts	Idadi ya ukaguzi inayoanzishwa kwa wakati mmoja kwa kila kundi, inayotumiwa kwa pamoja na kipanga ratiba na endpoint ya /api/settings/proxies/auto-test. Kiwango cha chini ni 1 na cha juu ni 50.
PROXY_HEALTH_TEST_STAGGER_MS	100	src/lib/proxyHealth/probeTarget.ts	Ucheleweshaji kwa ms kati ya kuondoka kwa ukaguzi wawili ndani ya kundi. Bila ucheleweshaji huu, kundi lote huondoka kwa wakati mmoja na IP ya pamoja ya trafiki inayotoka inaweza kusababisha lengo lenye kikomo cha kasi kuzuia maombi. Weka kuwa 0 ili kuzima utenganishaji huu; kiwango cha juu ni 5000.
PROXY_HEALTH_USE_PROVIDER_TARGET	true	src/lib/proxyHealth/providerProbeTarget.ts	Weka "false" ili kuacha kukagua seva pangishi halisi ya mtoa huduma aliyekabidhiwa proksi (GET /models, bila ufunguo wa API) na badala yake utumie PROXY_HEALTH_TEST_URL kila wakati.
PROXY_HEALTH_AUTO_DEACTIVATE	false	src/lib/proxyHealth/statusPolicy.ts	Ikiwa ni false (chaguo-msingi), ukaguzi wa kiotomatiki wa ufikivu (kipanga ratiba + kitufe cha "Test All" cha /api/settings/proxies/auto-test) ni wa kusoma pekee na kamwe hauandiki hali ya proksi — ni mwendeshaji pekee anayeweka hali kuwa amilifu/isiyo amilifu, kwa hivyo ukaguzi usio thabiti hauwezi kuacha proksi iliyokabidhiwa ikiwa imekwama (#6246). Weka true ili kurejesha tabia ya zamani ya kupima-na-kuweka.
PROXY_POOL_EGRESS_OBSERVATION	false	src/shared/utils/featureFlags.ts	Bendera ya kipengele ya kujijumuisha kwa hiari (angalia FEATURE_FLAGS.md; ubatilishaji wa DB wa dashibodi hupewa kipaumbele). true (au 1, yes) huonyesha uchunguzi wa kusoma pekee wa trafiki inayotoka ya mkusanyiko chini ya mkusanyiko wa proksi kwenye dashibodi (IP tofauti za trafiki inayotoka, miunganisho na idadi kubwa zaidi iliyoonekana nyuma ya IP moja katika saa 24 zilizopita, kutoka kwenye kumbukumbu ya proksi). Haitumiki kamwe kwa uelekezaji.
PROXY_AUTO_REMOVE	false	src/lib/proxyHealth/scheduler.ts	Weka true ili kuruhusu kipanga ratiba kiondoe proksi kiotomatiki baada ya kushindwa mara kadhaa mfululizo.
PROXY_AUTO_REMOVE_AFTER	3	src/lib/proxyHealth/scheduler.ts	Idadi ya kushindwa mfululizo kabla ya kipanga ratiba kuondoa proksi kiotomatiki (wakati PROXY_AUTO_REMOVE=true).
PROXY_AUTO_DISABLE	false	src/lib/proxyHealth/scheduler.ts	Weka true ili kuruhusu kipanga-ratiba kulemaza kwa muda proksi (hali dead, haifutwi kamwe) baada ya kushindwa mara kadhaa mfululizo, badala ya kuiondoa. Mbadala usioharibu wa PROXY_AUTO_REMOVE: proksi huondolewa mara moja kwenye utatuzi wa kundi/mzunguko (kichujio cha hali hai kinachotumiwa na utatuzi wa kundi la upeo tayari huiondoa) na huwashwa tena kiotomatiki mara tu inapoanza kufaulu majaribio tena. Hutumia kizingiti sawa cha PROXY_AUTO_REMOVE_AFTER. Ikiwa bendera zote mbili ni true, PROXY_AUTO_REMOVE hupewa kipaumbele.
OMNIROUTE_CONTROL_PLANE_PROXY_DIRECT_FALLBACK	false	src/shared/constants/featureFlagDefinitions.ts	Ruhusu mitiririko ya uthibitishaji wa OAuth na mtoa huduma ipuuze proksi iliyobandikwa na iunganishwe moja kwa moja wakati ukaguzi wa awali wa ufikikaji wa proksi unaposhindwa. Mpangilio halisi wa kipaumbele ni ubatilishaji wa Hifadhidata ya Bendera za Vipengele > kigezo cha mazingira > chaguo-msingi.
RATE_LIMIT_MAX_WAIT_MS	30000 (sekunde 30)	open-sse/services/rateLimitManager.ts	Muda wa juu zaidi wa kusubiri jibu la 429 kabla ya ombi kushindwa.
RATE_LIMIT_EXECUTION_MAX_WAIT_MS	600000 (dakika 10)	open-sse/services/rateLimitManager.ts	Kikomo cha muda ambao ombi lililoruhusiwa linaweza kubaki likitekelezwa kabla nafasi yake ya kikomo cha kasi kuisha — kimetenganishwa na bajeti ya kusubiri kwenye foleni ili kuanza polepole kwa uletaji data kwenye malango yasiyo ya hatua-za-nyongeza kusisababishe kuisha kwa muda (#12027).
RATE_LIMIT_MAX_QUEUE_DEPTH	0 (imezimwa)	open-sse/services/rateLimitManager.ts	Kikomo cha kupokea maombi kwenye foleni: kataa kwa 429 queue_full mara tu idadi hii ya maombi inapokuwa tayari kwenye foleni. 0 = bila kikomo (chaguo-msingi).
RATE_LIMIT_AUTO_ENABLE	(haijawekwa)	open-sse/services/rateLimitManager.ts	Lazimisha wavu wa usalama wa kuwasha kiotomatiki kikomo cha kasi uwashwe/uzimwe bila kujali mpangilio wa Dashibodi uliohifadhiwa. Hukubali true/1/on ili kulazimisha kuwasha, false/0/off ili kulazimisha kuzima.
PROVIDER_COOLDOWN_ENABLED	(haijawekwa → imezimwa)	open-sse/services/providerCooldownTracker.ts	Ufuatiliaji wa kimataifa wa muda wa kusubiri wa mtoa huduma/muunganisho unaovuka maombi, unaowashwa kwa hiari. UMEZIMWA kwa chaguo-msingi (unaingiliana na Muda wa Kusubiri wa Muunganisho / Kivunja Saketi cha Mtoa Huduma). Hukubali true/1/on ili kuwasha.
PROVIDER_COOLDOWN_MIN_MS	5000	open-sse/services/providerCooldownTracker.ts	Muda wa chini zaidi wa kusubiri (ms) kabla ya kujaribu tena mtoa huduma/muunganisho ulioshindwa. Huongezwa kwa kasi ya kipeo kulingana na kushindwa kwa mfululizo. Hutumiwa tu wakati PROVIDER_COOLDOWN_ENABLED imewashwa.
PROVIDER_COOLDOWN_MAX_MS	300000 (dak 5)	open-sse/services/providerCooldownTracker.ts	Kikomo cha juu cha kipindi cha kusubiri (ms) kabla ya mtoa huduma/muunganisho ulioshindwa kujaribiwa tena bila kujali hali. Hutumika tu wakati PROVIDER_COOLDOWN_ENABLED imewashwa.
STREAM_RECOVERY_ENABLED	(haijawekwa → imezimwa)	src/lib/resilience/settings.ts (thamani ya awali) → open-sse/services/streamRecovery.ts (mantiki)	Ni nini: urejeshaji usioonekana wa mitiririko iliyokatishwa kutoka chanzo cha juu (porti ya free-claude-code). Hushikilia dirisha la mwanzo la SSE hadi STREAM_RECOVERY.HOLDBACK_MS (750 ms) ili ukatishaji wa kabla ya kuthibitisha — unaotokea kabla baiti yoyote haijamfikia mteja — ufunguliwe tena na kujaribiwa upya bila kuonekana. Wakati wa kuwezesha: vyanzo vya juu visivyoaminika/vinavyokatisha mtiririko kwa baiti 0 mara kwa mara unapoanza; iache IMEZIMWA ikiwa huwezi kumudu hadi ms 750 za muda wa ziada kabla ya tokeni ya kwanza kwenye kila mtiririko. Hukubali true/1/on. Huweka thamani ya awali ya mpangilio wa Ustahimilivu unaohifadhiwa; mpangilio wa Dashibodi hutangulia mara tu unapowekwa.
STREAM_RECOVERY_MIDSTREAM_ENABLED	(haijawekwa → imezimwa)	src/lib/resilience/settings.ts (thamani ya awali) → open-sse/services/streamRecovery.ts (mantiki)	Ni nini: mwendelezo katikati ya mtiririko (Awamu ya 4.4) — baada ya ukatishaji wa baada ya kuthibitisha (baiti tayari zimemfikia mteja), tuma ombi upya ukitumia matini isiyokamilika kama ujazaji wa awali wa msaidizi na uunganishe kiambishi kinachokosekana. Kwa mitiririko ya matini wazi inayooana na OpenAI pekee; haiwashi kamwe wakati mwito wa zana unaendelea. Wakati wa kuwezesha: uzalishaji mrefu unaokatishwa katikati ya jibu na unakubali sehemu ya mwisho iliyorejeshwa kuwasili kama fungu moja badala ya tokeni moja baada ya nyingine. Haitegemei STREAM_RECOVERY_ENABLED (wasifu tofauti wa hatari). Hukubali true/1/on.
STREAM_THROUGHPUT_WATCHDOG_ENABLED	(haijawekwa → imezimwa)	src/lib/resilience/settings.ts → open-sse/services/throughputWatchdog.ts	Kifuatiliaji cha hiari cha matokeo yenye manufaa katika mtiririko unaotumika. Hutambua mitiririko inayoendelea kutuma vipande lakini inayosalia chini ya kiwango kilichosanidiwa cha matokeo ya msaidizi; mapigo ya uhai, matukio ya matumizi, tofauti tupu, na awamu za zana/ufikiri hazionekani kimakosa kama maendeleo. Ni tofauti na muda wa kuisha kwa kutofanya kazi na muda wa mwisho usiobadilika.
STREAM_THROUGHPUT_WATCHDOG_WARMUP_MS	30000	src/lib/resilience/settings/normalize.ts	Kipindi cha neema kabla ya kutathmini kiwango cha upitishaji, kilichowekewa mipaka ya ms 0–600000.
STREAM_THROUGHPUT_WATCHDOG_WINDOW_MS	30000	src/lib/resilience/settings/normalize.ts	Dirisha linalosogea la matokeo yenye manufaa, lililowekewa mipaka ya ms 1000–600000; dirisha moja kamili linahitajika kabla ya kusitisha.
STREAM_THROUGHPUT_WATCHDOG_MIN_BYTES_PER_SECOND	4	src/lib/resilience/settings/normalize.ts	Kiwango cha chini cha baiti za UTF-8 za matokeo ya msaidizi kwa sekunde (kiwakilishi cha kihafidhina cha tokeni), kilichowekewa mipaka ya 1–1000000.
STREAM_THROUGHPUT_WATCHDOG_MIN_USEFUL_BYTES	1	src/lib/resilience/settings/normalize.ts	Sampuli ya chini kabisa isiyo sifuri ya matokeo yenye manufaa inayoweza kupimwa, iliyowekewa mipaka ya baiti 1–1000000.
HEALTHCHECK_STAGGER_MS	3000	src/lib/tokenHealthCheck.ts	Kipindi cha mpangilio wa nyakati (ms) kati ya ukaguzi wa afya wa tokeni za watoa huduma wakati wa kuanza.
HEALTHCHECK_JITTER_MIN_MS	500	src/lib/tokenHealthCheck.ts	Tofauti ya muda ya chini kabisa ya nasibu (ms) inayoongezwa juu ya HEALTHCHECK_STAGGER_MS kati ya ukaguzi wa afya wa tokeni za watoa huduma, ili kuzuia maombi mengi kwa ghafla (Suala #1220).
HEALTHCHECK_JITTER_MAX_MS	5000	src/lib/tokenHealthCheck.ts	Tofauti ya muda ya juu kabisa ya nasibu (ms) inayoongezwa juu ya HEALTHCHECK_STAGGER_MS kati ya ukaguzi wa afya wa tokeni za watoa huduma, ili kuzuia maombi mengi kwa ghafla (Suala #1220).
HEALTHCHECK_BATCH_SIZE	20	src/lib/tokenHealthCheck.ts	Ukubwa wa kundi la ukaguzi wa wakati mmoja kwa ajili ya mzunguko wa ukaguzi wa afya ya tokeni wakati wa kuanzisha; thamani kubwa hukagua miunganisho mingi zaidi kwa wakati mmoja, huku thamani ndogo zikipunguza mzigo wa ghafla (Suala #7875, hitilafu iliyojirudia ya #7719).
REQUEST_RETRY	2	src/sse/services/cooldownAwareRetry.ts	Idadi ya majaribio ya kiotomatiki baada ya majibu ya kipindi cha kusubiri yanayohusu modeli kabla ya kurejesha hitilafu kwa mteja.
MAX_RETRY_INTERVAL_SEC	30	src/sse/services/cooldownAwareRetry.ts	Muda wa juu zaidi wa kusubiri unaoongezeka (sekunde) kati ya majaribio ya kipindi cha kusubiri. Huwekewa kikomo na thamani hii bila kujali Retry-After ya huduma ya juu.
HEADROOM_URL	http://localhost:8787	src/lib/headroom/detect.ts	URL ya proksi ya Headroom ya kuokoa tokeni. Mzunguko wa maisha wa dashibodi (api/headroom/*) huanzisha CLI ya ndani ya headroom-ai kwenye anwani ya loopback kwa chaguo-msingi; ibadilishe tu ili kuelekeza kwenye proksi ya nje ya sidecar ya Docker.

Konstanti za kurekebisha urejeshaji wa mtiririko

Tabia ya kusitisha kwa muda urejeshaji imerekebishwa kwa konstanti zilizowekwa moja kwa moja kwenye open-sse/config/constants.ts (STREAM_RECOVERY), zilizoonyeshwa hapa kwa marejeleo — kuzibadilisha kunahitaji kuhariri msimbo, si kigezo cha mazingira:

• STREAM_RECOVERY.HOLDBACK_MS = 750 — muda ambao dirisha la mwanzo la SSE hushikiliwa ili ukatishaji wa mapema uweze kujaribiwa tena kabla baiti yoyote haijatumwa kwa mteja.
• STREAM_RECOVERY.BUFFER_MAX_BYTES = 65536 — kikomo kamili cha dirisha linaloshikiliwa; litume (ondoa akiba + pitisha moja kwa moja) mara tu baiti nyingi hivi zinapokusanyika, bila kujali kipima muda.
• STREAM_RECOVERY.EARLY_RETRY_MAX = 4 — idadi ya juu zaidi ya kufungua upya mtiririko wa huduma ya juu kwa uwazi wakati sehemu inayoshikiliwa bado haijatumwa.

Kikomo cha kiwango cha dirisha linalosogea kwa kila mtoa huduma (hakuna kigezo cha mazingira): mbinu mbadala ya kikomo cha kiwango cha dirisha linalosogea kwa kila mtoa huduma, iliyohamishwa kutoka FCC, ipo kwenye msimbo (open-sse/services/providerDefaultRateLimit.ts, imeunganishwa kupitia open-sse/services/rateLimitManager.ts) lakini hutolewa ikiwa na ramani chaguo-msingi tupu na kwa sasa haina kigezo cha mazingira cha mwendeshaji — huwezeshwa tu kupitia kiunganishi cha majaribio / uhariri wa msimbo. Kwa makusudi haijaorodheshwa kwenye jedwali hapo juu. Kidhibiti cha upelekaji kwa kila (token, IP) ambacho kina mpangilio ni RELAY_IP_PER_MINUTE (§3 Mtandao na Milango).

---

22. Utatuzi

Caution

Vigezo hivi hutoa matokeo ya kina na vinaweza kufichua data nyeti. Usiwahi kuviwezesha katika mazingira ya uzalishaji.

Kigezo	Chaguo-msingi	Faili Chanzo	Maelezo
CURSOR_DEBUG	(hakijawekwa)	open-sse/executors/cursor.ts	Weka 1 ili kuwezesha kumbukumbu za kina za kitekelezaji cha Cursor (vipande vya SSE vilivyosimbuliwa, n.k.).
CURSOR_STREAM_DEBUG	(hakijawekwa)	open-sse/executors/cursor.ts	Jina mbadala linalooana na matoleo ya nyuma la CURSOR_DEBUG.
CURSOR_DUMP_FILE	(hakijawekwa)	open-sse/executors/cursor.ts	Njia ya hiari ya faili inayopokea vipande ghafi vya Cursor vilivyosimbuliwa wakati CURSOR_DEBUG=1.
CURSOR_STREAM_TIMEOUT_MS	300000	open-sse/executors/cursor.ts	Muda wa mwisho wa kutokuwa na shughuli kwa mtiririko (ms) wa kitekelezaji cha Cursor.
CURSOR_KV_GRACE_MS	2000	open-sse/executors/cursor.ts	Kipindi cha neema (ms) baada ya kikomeshi laini cha composer kv_after_text wakati baiti bado zimehifadhiwa kwenye bafa — huupa mwito wa zana wa exec_mcp unaofuata muda wa kukamilisha fremu yake.
CURSOR_TOOL_DIRECTIVE	imewezeshwa (!== "0")	open-sse/executors/cursor.ts	Maagizo ya uthibitishaji wa zana yanayofanya composer-2.5 itoe miito ya zana kwa uhakika. Weka 0 ili kuzima.
OMNIROUTE_SYSTEM_INSTRUCTION_APPEND	(hakijawekwa)	open-sse/translator/request/claude-to-openai.ts, open-sse/translator/response/openai-to-claude.ts	Maandishi ya kidokezo cha mfumo yaliyofafanuliwa na mwendeshaji ambayo huongezwa kwenye ujumbe wa mfumo BAADA ya tafsiri (uingizaji wa baada ya tafsiri), yakifikia njia za codex/Responses na /v1/messages. Pia hutumika kama kiambishi awali cha maagizo kinachoondolewa kwenye vizuizi vya utangulizi wa mfumo vilivyorudiwa. Acha bila kuweka ili kuzima.
CURSOR_IMAGE_FETCH_TIMEOUT_MS	15000	open-sse/utils/cursorImages.ts	Muda wa mwisho wa kuleta kila picha (ms) kwa ingizo la mwonekano la mbali la image_url.
CURSOR_STATE_DB_PATH	(imechunguzwa)	open-sse/utils/cursorVersionDetector.ts	Batilisha utafutaji wa hifadhidata ya hali ya Cursor IDE unaotumika kutambua toleo la IDE.
CURSOR_AGENT_CLI_VERSION	(tambua / bandika)	open-sse/utils/cursorAgentCliVersion.ts	Kitambulisho cha build cha Agent CLI (YYYY.MM.DD-<hash>) kwa x-cursor-client-version: cli-… kwenye Agent Run.
CURSOR_AGENT_BIN	(hakijawekwa)	open-sse/handlers/imageGeneration/providers/cursorAgentImage.ts	Njia ya faili tendaji ya Cursor Agent inayotumika kutengeneza picha. Ikiwa hakijawekwa, kishughulikiaji hutumia providerSpecificData.agentBin kisha PATH.
CURSOR_IMG_TIMEOUT_MS	210000	open-sse/handlers/imageGeneration/providers/cursorAgentImage.ts	Muda halisi wa juu kwa kila picha (ms) kwa kazi za picha za Cursor Agent.
CURSOR_IMG_MAX_CONCURRENT	2	open-sse/handlers/imageGeneration/providers/cursorAgentImage.ts	Kikomo cha utekelezaji sawia kwa nafasi inayoshirikiwa kwa kazi za picha za Cursor.
CURSOR_IMG_MODEL	ombi / auto	open-sse/handlers/imageGeneration/providers/cursorAgentImage.ts	Batilisha --model ya Cursor CLI kwa kazi za picha.
UC_IMAGE_POLL_INTERVAL_MS	2000	open-sse/handlers/imageGeneration/providers/ucImage.ts	Marudio ya ukaguzi wa matokeo ya utengenezaji wa picha wa UC (uncensored.com) (ms).
UC_IMAGE_POLL_TIMEOUT_MS	60000	open-sse/handlers/imageGeneration/providers/ucImage.ts	Muda halisi wa juu wa ukaguzi wa matokeo ya utengenezaji wa picha wa UC (ms).
UC_VIDEO_POLL_INTERVAL_MS	3000	open-sse/handlers/videoGeneration/providers/ucVideo.ts	Marudio ya ukaguzi wa matokeo ya utengenezaji wa video wa UC (uncensored.com) (ms).
UC_VIDEO_POLL_TIMEOUT_MS	300000	open-sse/handlers/videoGeneration/providers/ucVideo.ts	Muda halisi wa juu wa ukaguzi wa matokeo ya utengenezaji wa video wa UC (ms).
CURSOR_DATA_DIR	(imechunguzwa)	open-sse/utils/cursorAgentCliVersion.ts	Batilisha saraka ya data ya Cursor Agent CLI (…/versions/<id>); ni kigezo kilekile kinachotumiwa na agent rasmi.
CURSOR_TOKEN	(hakijawekwa)	scripts/ad-hoc/cursor-tap.cjs	Tokeni ya moja kwa moja ya bearer ya Cursor inayotumiwa na zana za msanidi programu.
OMNIROUTE_LOG_REQUEST_SHAPE	imezimwa (washwa kwa hiari kupitia "1")	src/app/api/v1/chat/completions/route.ts	Rekodi viashiria vya aina/urefu wa maudhui kwa payload kubwa za gumzo wakati "1" imewekwa. Imezimwa kwa chaguo-msingi ili kupunguza kelele kwenye kumbukumbu.
DEBUG_RESPONSES_SSE_TO_JSON	(hakijawekwa)	open-sse/handlers/responseTranslator.ts	Weka true ili kurekodi maelezo ya tafsiri ya SSE→JSON ya Responses API.
DEBUG_CLAUDE_NONSTREAM	(hakijawekwa)	open-sse/handlers/responseTranslator.ts	Weka true ili kuonyesha vipande tupu vya textContent katika njia ya tafsiri ya jibu la Claude (kwa utatuzi pekee).
NEXT_PUBLIC_OMNIROUTE_E2E_MODE	(hakijawekwa)	Mfumo wa majaribio wa E2E	Weka true ili kuwezesha hali ya majaribio ya E2E (uthibitishaji uliolegezwa, viunganishi vya majaribio).

---

23. Muunganisho wa GitHub

Ruhusu watumiaji kuripoti matatizo moja kwa moja kutoka kwenye Dashboard.

Kigezo	Chaguo-msingi	Faili Chanzo	Maelezo
GITHUB_ISSUES_REPO	(hakijawekwa)	src/app/api/v1/issues/report/route.ts	Hazina katika muundo wa owner/repo.
GITHUB_ISSUES_TOKEN	(hakijawekwa)	src/app/api/v1/issues/report/route.ts	Tokeni ya Ufikiaji Binafsi ya GitHub yenye wigo wa issues:write.
GITHUB_TOKEN	(hakijawekwa)	usaidizi wa uchambuzi wa matatizo / ajenti wa wingu	Tokeni ya jumla ya ufikiaji wa GitHub inayotumika kama mbadala wa GITHUB_ISSUES_TOKEN na inayotumiwa na visaidizi vya ajenti wa wingu katika src/lib/cloudAgent/*.

---

Matukio ya Usambazaji

Kwa mwongozo wa SRE wa backend ya relay (tabia ya ts/bifrost/auto, uwekaji wa 9router dhidi ya CLIProxyAPI, na mkakati wa dharura wa kiwango cha juu cha upitishaji), angalia Mkakati wa Backend ya Relay.

Uendelezaji wa Ndani wa Kiwango cha Chini

JWT_SECRET=$(openssl rand -base64 48)
API_KEY_SECRET=$(openssl rand -hex 32)
INITIAL_PASSWORD=dev123
PORT=20128
NODE_ENV=development

Uzalishaji kwa Docker

JWT_SECRET=<iliyotengenezwa>
API_KEY_SECRET=<iliyotengenezwa>
INITIAL_PASSWORD=<iliyotengenezwa>
STORAGE_ENCRYPTION_KEY=<iliyotengenezwa>
DATA_DIR=/data
PORT=20128
API_PORT=20129
NODE_ENV=production
AUTH_COOKIE_SECURE=true
REQUIRE_API_KEY=true
NEXT_PUBLIC_BASE_URL=https://omniroute.example.com
BASE_URL=http://localhost:20128
OMNIROUTE_MEMORY_MB=8192
CORS_ORIGIN=https://your-frontend.example.com

Mfumo Uliotengwa na Mtandao / CI

JWT_SECRET=test-jwt-secret-for-ci
API_KEY_SECRET=test-api-key-secret-for-ci
INITIAL_PASSWORD=testpass
NODE_ENV=production
OMNIROUTE_DISABLE_BACKGROUND_SERVICES=true
APP_LOG_TO_FILE=false

VPS yenye Reverse Proxy (nginx + Cloudflare)

JWT_SECRET=<iliyotengenezwa>
API_KEY_SECRET=<iliyotengenezwa>
STORAGE_ENCRYPTION_KEY=<iliyotengenezwa>
PORT=20128
AUTH_COOKIE_SECURE=true
REQUIRE_API_KEY=true
NEXT_PUBLIC_BASE_URL=https://omniroute.example.com
BASE_URL=http://127.0.0.1:20128
CORS_ORIGIN=https://omniroute.example.com
ENABLE_TLS_FINGERPRINT=true
CLI_COMPAT_ALL=1

---

24. Sandbox ya Skills (v3.8.0+)

Vikomo na mipangilio ya usalama inayotumika wakati mfumo wa Skills (src/lib/skills/) unatekeleza otomatiki zilizofafanuliwa na mtumiaji katika mazingira ya sandbox.

Kigezo	Chaguo-msingi	Faili Chanzo	Maelezo
SKILLS_SANDBOX_TIMEOUT_MS	10000 (sekunde 10)	src/lib/skills/builtins.ts	Muda wa mwisho wa saa halisi kwa kila utekelezaji wa msimbo wa skill katika sandbox. Ni kikomo kamili; chochote kinachochukua muda mrefu zaidi husitishwa.
SKILLS_EXECUTION_TIMEOUT_MS	(hutumia SKILLS_SANDBOX_TIMEOUT_MS kama mbadala)	src/lib/skills/	Muda wa mwisho wa uratibu wa kiwango cha juu wa skill. Weka thamani ya juu kuliko SKILLS_SANDBOX_TIMEOUT_MS ili kuruhusu mitiririko ya kazi ya hatua nyingi.
SKILLS_MAX_FILE_BYTES	1048576 (MB 1)	src/lib/skills/builtins.ts	Idadi ya juu zaidi ya baiti ambazo skill inaweza kusoma kutoka kwenye faili yoyote moja iliyo ndani ya sandbox.
SKILLS_MAX_HTTP_RESPONSE_BYTES	256000 (KB 250)	src/lib/skills/builtins.ts	Idadi ya juu zaidi ya baiti zinazohifadhiwa kutoka kwenye jibu lolote moja la HTTP ndani ya skill.
SKILLS_MAX_SANDBOX_OUTPUT_CHARS	100000	src/lib/skills/builtins.ts	Kikomo kamili cha idadi ya herufi za stdout/stderr zinazorejeshwa kutoka kwenye mwito wa sandbox.
SKILLS_SANDBOX_NETWORK_ENABLED	false	src/lib/skills/builtins.ts	Weka 1/true ili kuruhusu mtandao wa nje kutoka ndani ya sandbox. Kwa usalama, chaguo-msingi ni kutengwa.
SKILLS_ALLOWED_SANDBOX_IMAGES	(tupu)	src/lib/skills/builtins.ts	Orodha inayotenganishwa kwa koma ya images za kontena zinazoruhusiwa kwa utekelezaji wa sandbox. Ikiwa tupu, ni chaguo-msingi lililojengewa ndani pekee.
SKILLS_SANDBOX_DOCKER_IMAGE	(chaguo-msingi lililojengewa ndani)	src/lib/skills/	Image ya kontena inayotumika wakati wa kuanzisha sandbox inayotegemea Docker. Badilisha ili kubainisha image maalum ya msingi iliyoimarishwa.
SKILLS_SANDBOX_RUNTIME	auto	src/lib/skills/sandbox.ts, src/lib/skills/containerProvider.ts	Mazingira ya utekelezaji wa kontena kwa sandbox ya skill: auto | docker | apple | wsl | orbstack | podman. auto huchagua mazingira bora zaidi yaliyosakinishwa kwa kila OS ya mwenyeji (Apple Container/OrbStack kwenye macOS, WSL Container kwenye Windows, Podman kwenye Linux), na hutumia Docker kama mbadala.

Caution

Kuwasha SKILLS_SANDBOX_NETWORK_ENABLED=true hufungua njia ya trafiki inayotoka kwa msimbo wowote wa skill. Iambatanishe na OUTBOUND_SSRF_GUARD_ENABLED=true na sera kali ya CORS_ORIGIN/proksi katika utekelezaji unaoshirikiwa.

---

25. Vikomo vya Watoa Huduma, Taneli, Nakala Rudufu na Mengineyo ya Wakati wa Utekelezaji

Ncha za API za vikomo vya watoa huduma, taneli za mtandao (Tailscale, Ngrok, proksi ya utatuzi ya MITM), hifadhi ya anwani za mtandao wa nje ya 1Proxy, nakala rudufu za hifadhidata na ubatilishaji mdogo wa kila kipengele unaorejelewa na safu ya utekelezaji au hati.

Kigezo	Chaguo-msingi	Faili Chanzo	Maelezo
REDIS_URL	redis://localhost:6379	src/shared/utils/rateLimiter.ts	Mfuatano wa muunganisho wa Redis kwa mfumo wa nyuma wa kidhibiti cha kiwango.
ALIBABA_CODING_PLAN_HOST	(seva ya uzalishaji)	open-sse/services/bailianQuotaFetcher.ts	Batilisha seva inayotumika kuleta vikomo vya mpango wa usimbaji wa Alibaba Bailian.
ALIBABA_CODING_PLAN_QUOTA_URL	inatokana na seva	open-sse/services/bailianQuotaFetcher.ts	Ubatilishaji wa URL kamili ya kikomo kwa Alibaba Bailian.
QWEN_CLOUD_COOKIE	(haijawekwa)	open-sse/services/qwenTokenPlanQuotaFetcher.ts	Kidakuzi cha kipindi cha dashibodi kwa lango la kikomo cha Token Plan binafsi la Qwen Cloud / Model Studio (ufunguo wa API wa uhawilishaji hauwezi kukisoma). Nakili kichwa kizima cha ombi cha Cookie — kina login_qwencloud_ticket — kutoka kwenye mwito wowote wa api.json kwenda cs-data.qwencloud.com katika home.qwencloud.com › Billing › Subscription (F12 › Network). Ni nyeti na kinahusu kipindi mahususi; pendelea sehemu ya Dashibodi ya qwenCloudCookie kwa kila muunganisho.
QWEN_CLOUD_SEC_TOKEN	(haijawekwa)	open-sse/services/qwenTokenPlanQuotaFetcher.ts	Ubatilishaji wa mwenyewe wa sec_token kwa lango la dashibodi la Token Plan. Ni nyeti; ikiwa haijawekwa, kiletaji huitatua kutoka kwenye HTML ya dashibodi kwa kutumia kidakuzi.
QWEN_TOKEN_PLAN_HOST	https://cs-data.qwencloud.com	open-sse/services/qwenTokenPlanQuotaFetcher.ts	Ubatilishaji wa seva ya lango kwa kiletaji cha kikomo cha Token Plan binafsi (kwa mfano, bailian-singapore-cs.alibabacloud.com kwa dashibodi ya Model Studio).
QWEN_TOKEN_PLAN_DASHBOARD_URL	https://home.qwencloud.com/	open-sse/services/qwenTokenPlanQuotaFetcher.ts	URL ya dashibodi inayotumika kutatua sec_token kutoka kwenye HTML ya mtumiaji aliyeingia.
ALIBABA_FREE_TIER_VISION_FE_PATH	/costing-balance/free-quota-image-video	open-sse/services/alibabaFreeTierQuotaFetcher.ts	Ubatilishaji wa njia ya upande wa mbele wa dashibodi kwa ajili ya kuleta kikomo cha kiwango cha bila malipo cha maudhui ya kuona/midia cha Alibaba Model Studio.
ALIBABA_FREE_TIER_MULTIMODAL_FE_PATH	/costing-balance/free-quota-multimodal	open-sse/services/alibabaFreeTierQuotaFetcher.ts	Ubadilishaji wa njia ya kiolesura cha mbele cha dashibodi kwa ajili ya kuleta mgao wa bila malipo wa multimodali wa Alibaba Model Studio.
ALIBABA_FREE_TIER_AUDIO_FE_PATH	/costing-balance/free-quota-audio	open-sse/services/alibabaFreeTierQuotaFetcher.ts	Ubadilishaji wa njia ya kiolesura cha mbele cha dashibodi kwa ajili ya kuleta mgao wa bila malipo wa sauti wa Alibaba Model Studio.
ALIBABA_FREE_TIER_ALLOWLIST_PATH	(haijawekwa)	open-sse/services/alibabaFreeTierAllowlist.ts	Njia ya hiari ya faili ya JSON ya ndani inayobatilisha orodha iliyojengewa ndani ya modeli za maandishi zinazoruhusiwa katika kiwango cha bila malipo cha Alibaba. Ikiwa haipatikani, hutumia $DATA_DIR/alibaba-free-tier-allowlist.json, kisha config/alibaba-free-tier-allowlist.json.
CONTEXT_RESERVE_TOKENS	1024	open-sse/services/contextManager.ts	Tokeni zilizohifadhiwa kwa ajili ya matokeo ya ukamilishaji wakati wa kukokotoa bajeti za vidokezo.
CONTEXT_KEEP_LATEST_IMAGES	2	open-sse/services/contextManager.ts	Idadi ya picha mpya zaidi zilizopachikwa ndani ya maandishi za kuhifadhi wakati wa kuondoa picha za zamani ili zitoshee kwenye dirisha la muktadha (#8560).
MODEL_ALIAS_COMPAT_ENABLED	imewezeshwa	open-sse/services/model.ts	Washa au zima safu ya zamani ya uoanifu wa lakabu za modeli inayotumiwa na viteja vya zamani.
OMNIROUTE_EMERGENCY_FALLBACK	imewezeshwa	open-sse/services/emergencyFallback.ts	Weka false (au 0) ili kuzima mbinu mbadala ya dharura ya kuisha kwa bajeti ambayo huelekeza upya maombi yaliyoshindwa kwenda kwenye modeli ya bila malipo ya nvidia/openai/gpt-oss-120b. Mpangilio wa kipaumbele unaotumika ni ubatilishaji wa hifadhidata ya Feature Flags > kigezo cha mazingira > chaguo-msingi; ikiwa haupatikani, huduma hutumia thamani ghafi ya kigezo cha mazingira.
COMMAND_CODE_CALLBACK_PORT	(haijawekwa)	src/app/api/providers/command-code/auth/shared.ts	Porti ya ndani inayotumiwa kwa miito ya kurudi ya mtindo wa OAuth kutoka kwa kisaidizi cha Command Code CLI.
COMMAND_CODE_VERSION	0.33.2	open-sse/executors/commandCode.ts	Thamani inayotumwa kama kichwa cha x-command-code-version kwenda kwa huduma ya juu ya Command Code. Badilisha ili kuongeza toleo la CLI.
COMMANDCODE_API_URL	https://api.commandcode.ai	open-sse/services/usage/command-code.ts	URL msingi ya huduma ya juu ya matumizi/mgao ya Command Code inayotumiwa na telemetria ya kiletaji mgao cha simu mahiri. Badilisha kwa API ya Command Code inayopangishwa binafsi/mbadala.
MITM_LOCAL_PORT	443	src/mitm/server.cjs	Mlango wa ndani wa kuunganisha kwa proksi ya utatuzi ya MITM.
MITM_DISABLE_TLS_VERIFY	0	src/mitm/server.cjs	Weka 1 ili kuzima uthibitishaji wa TLS wa seva ya juu (kwa usanidi pekee).
MITM_IDLE_TIMEOUT_MS	60000	src/mitm/socketTimeouts.ts, src/mitm/server.cjs	Muda wa kuisha kwa soketi isiyotumika (ms) kwa miunganisho inayopitishwa kupitia proksi; soketi ambazo hazijatumika baada ya muda huu hukatishwa ili kuepuka kuvuja kwa handaki zilizo wazi kwa upande mmoja.
MITM_VERBOSE	1	src/mitm/server.cjs, src/mitm/_internal/bypass.cjs	Kiwango cha maelezo ya kumbukumbu za maamuzi ya uelekezaji: 0 hunyamazisha kumbukumbu, thamani za juu hurekodi maamuzi zaidi ya kupita/uelekezaji.
MITM_ROOT_CA_ENABLED	false	src/mitm/manager.ts	Weka true ili kujumuishwa katika muundo wa CA mzizi + cheti cha mwisho kwa kila seva pangishi (#6684). Usakinishaji mpya huupata kiotomatiki; usakinishaji wenye cheti cha zamani cha mwisho ambacho tayari kinaaminika huendelea kutumia cheti cha zamani cha SAN isiyobadilika isipokuwa ujumuishwe.
MITM_CERT_MODE	legacy	src/mitm/manager.ts, src/mitm/server.cjs	Huwekwa NA kidhibiti cha MITM kwa ajili ya mchakato wa proksi unaoanzishwa (root-ca | legacy) — huakisi uamuzi wa uhamishaji wa cheti; haikusudiwi kuwekwa mwenyewe.
OMNIROUTE_NO_SUDO	0	src/mitm/systemCommands.ts	Weka 1 (thamani ya kweli) ili kuondoa sudo ya mwanzo kutoka kwenye amri za MITM za kuamini cheti — kwa upelekaji usio na mtumiaji mzizi / unaotumia nafasi ya majina ya mtumiaji ambapo mwendeshaji anaiamini CA mwenyewe (kwa mfano, kupitia utaratibu wa vyeti vya ziada vya CA wa Node).
SKIP_ANTIGRAVITY_DNS	(haijawekwa)	src/mitm/dns/provision.ts	Weka true ili kuruka kabisa uandaaji wa maingizo ya DNS katika /etc/hosts kwa majina ya seva pangishi ya proksi ya Antigravity — kwa kontena zisizo na sudo/mtumiaji mzizi.
OMNIROUTE_SKIP_DNS_WRITE	(haijawekwa)	src/mitm/dns/dnsConfig.ts	Weka 1 ili kuruka uandishi kwenye faili ya seva pangishi wakati wa kuongeza/kuondoa maingizo ya DNS — kwa mazingira ya majaribio yaliyotengwa au ya kusoma pekee.
OMNIROUTE_SKIP_SYSTEM_TRUST	0	src/mitm/cert/install.ts, src/mitm/tproxy/caTrust.ts	Kinga ya majaribio/CI pekee: weka 1 ili kufanya usakinishaji/uondoaji wa uaminifu wa cheti usifanye chochote, ili mkusanyiko wa majaribio usiwahi kubadilisha hifadhi ya uaminifu ya OS. Huwekwa kiotomatiki na usanidi wa majaribio na mitiririko ya kazi ya CI.
CHANGELOG_BASE_REF	(otomatiki)	scripts/check/check-changelog-integrity.mjs	Rejeleo msingi lililobainishwa wazi kwa kizuizi cha kuzuia kuliwa kwa CHANGELOG (kwa chaguo-msingi ni tawi msingi la PR katika CI, au release/v* ya juu zaidi).
FREE_PROXY_AUTO_SYNC_ENABLED	false	src/lib/freeProxyProviders/scheduler.ts	Weka true ili kuwezesha kipanga ratiba cha usawazishaji otomatiki wa hifadhi ya proksi zisizolipishwa kinachoendeshwa chinichini. Ni cha hiari na kimezimwa kwa chaguo-msingi.
FREE_PROXY_AUTO_SYNC_INTERVAL_MS	1800000	src/lib/freeProxyProviders/scheduler.ts	Kipindi cha usawazishaji otomatiki katika milisekunde (chaguo-msingi ni dakika 30).
FREE_PROXY_1PROXY_ENABLED	true	src/lib/freeProxyProviders/oneproxy.ts	Wezesha chanzo cha proksi zisizolipishwa cha 1proxy. Weka false ili kukizima.
FREE_PROXY_1PROXY_API_URL	(angalia oneproxy.ts)	src/lib/freeProxyProviders/oneproxy.ts	Ubatilishaji wa URL ya API ya 1proxy.
FREE_PROXY_1PROXY_MAX	500	src/lib/freeProxyProviders/oneproxy.ts	Idadi ya juu zaidi ya proksi zinazopakuliwa kwa kila usawazishaji kutoka 1proxy.
FREE_PROXY_1PROXY_MIN_QUALITY	50	src/lib/freeProxyProviders/oneproxy.ts	Kizingiti cha chini cha alama ya ubora kwa uingizaji kutoka 1proxy.
FREE_PROXY_PROXIFLY_ENABLED	true	src/lib/freeProxyProviders/proxifly.ts	Wezesha chanzo cha proksi zisizolipishwa cha Proxifly. Weka false ili kukizima.
FREE_PROXY_PROXIFLY_QUANTITY	100	src/lib/freeProxyProviders/proxifly.ts	Idadi ya proksi za kupakua kwa kila usawazishaji wa Proxifly.
FREE_PROXY_PROXIFLY_ANONYMITY	elite	src/lib/freeProxyProviders/proxifly.ts	Kichujio cha kiwango cha kutotambulika kwa Proxifly (elite, anonymous, transparent).
FREE_PROXY_IPLOCATE_ENABLED	false	src/lib/freeProxyProviders/iplocate.ts	Washa chanzo cha proksi ya bure cha IPLocate. Huwashwa tu kwa hiari.
FREE_PROXY_IPLOCATE_BASE_URL	https://raw.githubusercontent.com/iplocate/free-proxy-list/main/protocols	src/lib/freeProxyProviders/iplocate.ts	Batilisha URL msingi ya orodha ya proksi ya IPLocate.
FREE_PROXY_WEBSHARE_ENABLED	true	src/lib/freeProxyProviders/webshare.ts	Washa chanzo cha mkusanyiko wa proksi wa Webshare. Weka kuwa false ili kukizima; pia inahitaji FREE_PROXY_WEBSHARE_API_KEY iwe imewekwa.
FREE_PROXY_WEBSHARE_API_KEY	(hakuna)	src/lib/freeProxyProviders/webshare.ts	Tokeni ya API ya akaunti ya Webshare (Authorization: Token <key>). Inahitajika — mtoa huduma hubaki amezimwa bila tokeni hiyo.
FREE_PROXY_WEBSHARE_API_URL	https://proxy.webshare.io/api/v2/proxy/list/	src/lib/freeProxyProviders/webshare.ts	Batilisha URL ya API ya orodha ya proksi ya Webshare.
FREE_PROXY_WEBSHARE_MAX	500	src/lib/freeProxyProviders/webshare.ts	Idadi ya juu zaidi ya proksi zinazoletwa kwa kila ulandanishaji wa Webshare.
NEXT_PUBLIC_VERCEL_RELAY_ENABLED	true	src/app/(dashboard)/…/ProxyPoolTab.tsx	Onyesha/ficha kitufe cha Deploy Vercel Relay kwenye kichupo cha Proxy Pool.
VERCEL_API_BASE	https://api.vercel.com	src/app/api/settings/proxy/vercel-deploy/route.ts	Batilisha URL msingi ya API ya Vercel (kwa ajili ya majaribio).
NEXT_PUBLIC_VERCEL_RELAY_DEFAULT_PROJECT	omniroute-relay	src/app/(dashboard)/…/VercelRelayModal.tsx	Jina chaguomsingi la mradi lililojazwa mapema katika kidirisha cha upelekaji cha Vercel Relay.
TAILSCALE_BIN	(gundua kiotomatiki)	src/lib/tailscaleTunnel.ts	Njia bayana ya faili tekelezi ya tailscale.
TAILSCALED_BIN	(hugunduliwa kiotomatiki)	src/lib/tailscaleTunnel.ts	Njia bainifu ya faili ya programu ya daemon ya tailscaled.
TAILSCALE_AUTHKEY	(haijawekwa)	src/lib/tailscaleTunnel.ts	Ufunguo wa uthibitishaji wa Tailscale ulioshirikiwa mapema kwa ajili ya tailscale up isiyoingiliana / isiyo na kiolesura (hupitishwa kupitia --auth-key=). Usipowekwa, kuingia hurudi kutumia URL ya uthibitishaji inayoingiliana kupitia kivinjari.
NGROK_AUTHTOKEN	(haijawekwa)	src/lib/ngrokTunnel.ts	Huthibitisha vichuguu vya ngrok vinavyotoka.
DB_BACKUP_MAX_FILES	20	src/lib/db/backup.ts	Idadi ya juu zaidi ya faili za nakala rudufu za SQLite zinazohifadhiwa na usafishaji wa nakala rudufu wa mkono/uliopangwa. Picha za uhamishaji hutambuliwa kwa maudhui na hutumiwa tena kwa hali sawa ya DB; haziondolewi ndani ya kipindi cha uhamishaji sawia. Hubatilisha thamani iliyohifadhiwa kutoka Mipangilio → Muda wa kuhifadhi nakala rudufu za hifadhidata.
DB_BACKUP_RETENTION_DAYS	0	src/lib/db/backup.ts	Umri wa juu zaidi (siku) unaohifadhiwa na usafishaji wa nakala rudufu wa mkono/uliopangwa. 0 huzima uondoaji unaotegemea umri. Picha za uhamishaji haziondolewi ndani ya kipindi cha uhamishaji sawia. Hubatilisha thamani iliyohifadhiwa kutoka Mipangilio → Muda wa kuhifadhi nakala rudufu za hifadhidata.
OMNIROUTE_BACKUP_SCHEDULE_JOB_INTERVAL_MS	30000	src/lib/jobs/backupScheduleJob.ts	Kipindi cha kila utekelezaji (ms) cha jukumu la upande wa seva linalotekeleza backup-schedule.json. Lazima kibaki chini sana ya usahihi wa dakika 1 wa cron; thamani zilizo chini ya 5000 au zisizoweza kuchanganuliwa hurudi kuwa 30000.
CONTAINER_HOST	docker	scripts/check-permissions.sh	Kidokezo cha mazingira ya utekelezaji wa kontena kwa ukaguzi wa ruhusa wa sehemu ya kuingilia. Weka kuwa podman kwa topolojia yoyote ya Podman. Kwa sababu kontena haliwezi kubaini iwapo injini ni ya ndani au inafikiwa kupitia Podman Machine, onyo hubaki bila kuegemea topolojia yoyote na huelekeza kwenye contrib/podman/README.md.
QUOTA_STORE_DRIVER	sqlite	src/lib/quota/storeFactory.ts	Mfumo wa nyuma wa hifadhi ya matumizi ya mgao unaoshirikiwa: sqlite (chaguo-msingi) au redis.
QUOTA_STORE_REDIS_URL	(haijawekwa)	src/lib/quota/storeFactory.ts	Mfuatano wa muunganisho wa Redis unaotumika wakati QUOTA_STORE_DRIVER=redis (k.m. redis://localhost:6379).
QUOTA_SATURATION_THRESHOLD	0.5	src/lib/quota/enforce.ts	Uwiano wa kujaa kwa kundi (0..1); unapofikia/kuzidi kiwango hicho, kundi huingia katika hali kali (hakuna kukopa).
QUOTA_SOFT_DEPRIORITIZE_FACTOR	0.7	open-sse/services/combo.ts	Kizidishi cha alama (0..1) kinachotumika kwa lengwa wakati sera ya kiwango laini inapolipa kipaumbele kidogo.
STATUS_SOFT_DEPRIORITIZE_FACTOR	0.5	open-sse/services/combo/autoStrategy.ts	Kizidishi cha alama (0..1) kinachotumika kwa mtoa huduma aliyefikia kikomo (credits_exhausted/rate_limited) katika ukadiriaji wa auto-combo wakati ukomo wa kiwango wa preflight UMEZIMWA (#4540).
QUOTA_CONSUMPTION_RETENTION_DAYS	14	src/lib/db/quotaConsumption.ts	Kipindi cha uhifadhi (siku) kwa vikundi vya quota_consumption kabla ya GC (gcQuotaConsumption).
QUOTA_PREFLIGHT_CUTOFF_ENABLED	false	src/lib/resilience/settings.ts	Hiari (kwa chaguo-msingi IMEZIMWA): huwezesha ukomo thabiti wa kiwango katika uelekezaji otomatiki, ambao huondoa wagombea wenye kiwango kidogo kabla ya ukadiriaji.
OMNIROUTE_AUTO_FREE_FALLBACK_TO_FULL_POOL	false	open-sse/services/autoCombo/virtualFactory.ts	Hiari (kwa chaguo-msingi IMEZIMWA): wakati kichujio cha auto/<category>:<tier> hakilingani na mgombea yeyote aliyeunganishwa, rejesha tabia ya awali ya kutumia mkusanyiko kamili (usiochujwa) badala ya kurudisha mkusanyiko tupu. Chaguo-msingi la KUZIMWA hufanya :free kumaanisha "kiwango cha bure pekee".
OMNIROUTE_CHAOS_MAX_PANEL	5	open-sse/services/autoCombo/virtualFactory.ts	Kikomo cha ukubwa wa paneli (kinachobanwa hadi 1–10) kwa kibadala cha utangazaji cha auto/*:chaos — ombi moja husambazwa kwa modeli za watoa huduma tofauti zisizozidi idadi hii.
OMNIROUTE_CHAOS_MIN_PANEL	(chaguo-msingi la injini)	open-sse/services/autoCombo/virtualFactory.ts	Mpangilio wa kiwango cha chini cha ukubwa wa paneli unaopelekwa kwa kishughulikiaji cha utangazaji wa chaos; kutoweka kwa thamani huhifadhi chaguo-msingi la injini.
OMNIROUTE_CHAOS_PANEL_TIMEOUT_MS	(chaguo-msingi la injini)	open-sse/services/autoCombo/virtualFactory.ts	Muda wa mwisho thabiti (ms) kwa usambazaji wote wa paneli ya chaos; kutoweka kwa thamani huhifadhi chaguo-msingi la injini.
GROK_AUTH_PATH	~/.grok/auth.json	open-sse/services/grokQuotaFetcher.ts	Njia ya auth.json ya Grok CLI inayotumika kuleta kiwango cha kila wiki cha grok-web; ibadilishe kwa majaribio au usakinishaji usio wa kawaida wa CLI.
AGENTBRIDGE_UPSTREAM_CA_CERT	(haijawekwa)	src/mitm/manager.ts	Cheti cha ziada cha CA (PEM) kinachoaminika kwa miunganisho ya juu ya TLS ya AgentBridge.
INSPECTOR_BUFFER_SIZE	1000	src/mitm/inspector/buffer.ts	Idadi ya juu zaidi ya maombi yaliyonaswa yanayohifadhiwa katika bafa ya mzunguko ya Traffic Inspector.
INSPECTOR_MAX_BODY_KB	1024	src/mitm/inspector/buffer.ts	Ukubwa wa juu zaidi wa mwili wa ombi/jibu lililonaswa (KB) kabla ya kukatwa.
INSPECTOR_HTTP_PROXY_PORT	8080	src/mitm/inspector/httpProxyServer.ts	Mlango wa ndani wa proksi ya HTTP ya Traffic Inspector.
INSPECTOR_HTTP_PROXY_AUTOSTART	false	src/mitm/inspector/httpProxyServer.ts	Anzisha kiotomatiki proksi ya HTTP ya kikaguzi wakati wa kuwasha mfumo.
INSPECTOR_TLS_INTERCEPT	false	src/lib/inspector/captureState.ts	Wezesha udukuzi wa TLS (MITM) kwa trafiki ya HTTPS iliyonaswa.
INSPECTOR_LLM_HOSTS_EXTRA	(haijawekwa)	src/lib/inspector/captureState.ts	Majina ya ziada ya seva pangishi (yakitenganishwa kwa koma) yanayochukuliwa kuwa ncha za LLM kwa ajili ya kunasa.
INSPECTOR_MASK_SECRETS	true	src/mitm/inspector/buffer.ts	Ficha siri (vichwa vya uthibitishaji / funguo za API) katika trafiki iliyonaswa.
INSPECTOR_SYSTEM_PROXY_GUARD_MINUTES	30	src/app/api/tools/traffic-inspector/capture-modes/system-proxy/route.ts	Dakika kabla ya ulinzi wa proksi ya mfumo kurejesha kiotomatiki mipangilio ya proksi ya OS.
INSPECTOR_INTERNAL_INGEST_TOKEN	(otomatiki)	src/app/api/tools/traffic-inspector/internal/ingest/route.ts	Tokeni inayothibitisha uingizaji wa ndani wa data iliyonaswa kwenye kikaguzi.
PLAYGROUND_COMPARE_MAX_COLUMNS	4	src/app/(dashboard)/dashboard/playground/	Idadi ya juu zaidi ya safu wima zinazowekwa sambamba katika hali ya kulinganisha ya Playground.
PLAYGROUND_IMPROVE_PROMPT_DEFAULT_MODEL	(haijawekwa)	src/app/(dashboard)/dashboard/playground/	Muundo chaguo-msingi wa kitendo cha Playground cha 'boresha prompt' (hutumia muundo unaotumika ikiwa haijawekwa).
BIFROST_ENABLED	1	src/app/api/v1/relay/chat/completions/bifrost/route.ts	Swichi kuu ya kuzima proksi ya sidecar ya bifrost. Ikiwekwa kuwa 0, route hurejesha 503 ikiwa na header ya X-Bifrost-Killswitch, na opereta huelekezwa kwenye njia ya TS. Tumia hii kuzima sidecar bila kufanya deployment upya (tukio la kipanga njia cha tier-1, ubadilishaji wa funguo).
BIFROST_BASE_URL	(haijawekwa)	src/app/api/v1/relay/chat/completions/bifrost/route.ts	Ikiwekwa, route ya proksi ya sidecar ya Bifrost hupeleka trafiki ya /v1/chat/completions kwenye gateway hii ya Go badala ya kishughulikiaji cha relay cha TS. Haijawekwa → 503 yenye fallback. Slash ya mwisho huondolewa.
BIFROST_PORT	8080	src/lib/services/bootstrap.ts	Port ambayo huduma iliyopachikwa na kusimamiwa ya Bifrost hujifunga kwayo (127.0.0.1:<port>) wakati OmniRoute inadhibiti mzunguko wa maisha wa sidecar ya Bifrost. Chaguo-msingi ni 8080.
BIFROST_API_KEY	(haijawekwa)	src/app/api/v1/relay/chat/completions/bifrost/route.ts	Ufunguo wa API wa gateway ya Bifrost (hutumwa kama Authorization: Bearer ...). Ikiwa haujawekwa, route hutarajia ombi liwe na ufunguo halali wa API wa OmniRoute; ufunguo huu ni wa uthibitishaji wa upande wa gateway pekee.
BIFROST_STREAMING_ENABLED	true	src/app/api/v1/relay/chat/completions/bifrost/route.ts	Ikiwa ni true, route ya sidecar ya Bifrost hutiririsha majibu kupitia SSE kwa njia ya gateway badala ya kitekelezaji cha utiririshaji cha TS. Weka kuwa 0 ili kulazimisha majibu ya JSON yasiyotiririshwa kupitia gateway.
BIFROST_TIMEOUT_MS	30000	src/app/api/v1/relay/chat/completions/bifrost/route.ts	Muda wa mwisho kwa kila ombi wakati wa kutumia proksi kwenda kwenye gateway ya Bifrost (ms). Muda ukiisha, route hurejesha njia ya relay ya TS kupitia header ya X-Bifrost-Fallback.
OMNIROUTE_BIFROST_KEY	(haijawekwa)	src/app/api/v1/relay/chat/completions/bifrost/route.ts	Jina mbadala la BIFROST_API_KEY (hutumiwa na scripts zinazosoma env kupitia OMNIROUTE_*). BIFROST_API_KEY hupewa kipaumbele ikiwa zote mbili zimewekwa.
OMNIROUTE_RELAY_BACKEND	ts / auto	src/app/api/v1/relay/chat/completions/routingBackend.ts	Backend ya relay ya /api/v1/relay/chat/completions: ts | bifrost | auto. ts = relay ya TypeScript (chaguo-msingi ikiwa Bifrost haijasanidiwa); auto huchagua Bifrost wakati BIFROST_BASE_URL imewekwa na BIFROST_ENABLED ≠ 0, ikiwa na fallback ya TS ya kiotomatiki iwapo sidecar haipatikani; bifrost hulazimisha Bifrost (madhubuti, bila fallback). Uthibitishaji/kikomo cha kasi/ulinzi dhidi ya injection/allowlist daima hutekelezwa kwanza katika route ya Next. Majibu huwa na X-Routing-Backend / X-Routing-Fallback / X-Routing-Fallback-Reason.
RELAY_ROUTING_BACKEND	(haijawekwa)	src/app/api/v1/relay/chat/completions/routingBackend.ts	Jina mbadala linalokubalika la OMNIROUTE_RELAY_BACKEND (thamani zilezile za ts | bifrost | auto). OMNIROUTE_RELAY_BACKEND hupewa kipaumbele ikiwa zote mbili zimewekwa.
OMNIROUTE_BIFROST_FAILURE_COOLDOWN_MS	5000	src/app/api/v1/relay/chat/completions/bifrostCooldown.ts	Kipindi cha kusubiri (ms) baada ya hatua kupitia huduma saidizi ya Bifrost kushindwa katika hali ya auto, kabla relay haijajaribu tena huduma hiyo; maombi yanaelekezwa moja kwa moja kwenye njia ya TS kipindi hicho kinapoendelea, kisha huduma hiyo hujaribiwa tena. 0 huzima kipengele hiki. Hutumika tu wakati OMNIROUTE_RELAY_BACKEND=auto.
OMNIROUTE_TLS_CERT	(haijawekwa)	bin/cli/commands/serve.mjs	Njia ya cheti cha TLS cha PEM ili kutoa omniroute serve kupitia HTTPS (sawa na --tls-cert). Lazima ioanishwe na OMNIROUTE_TLS_KEY; seva inayojitegemea kisha hukatisha TLS kwenye kisikilizi hicho hicho (wss:// hufanya kazi bila mabadiliko). Ikiwa haijawekwa → HTTP ya kawaida. Kutoa cheti au ufunguo mmoja pekee, au njia isiyosomeka, huandika onyo kwenye kumbukumbu na kubaki kwenye HTTP.
OMNIROUTE_TLS_KEY	(haijawekwa)	bin/cli/commands/serve.mjs	Njia ya ufunguo binafsi wa TLS wa PEM kwa HTTPS ya omniroute serve (sawa na --tls-key). Lazima ioanishwe na OMNIROUTE_TLS_CERT. Angalia OMNIROUTE_TLS_CERT.
OMNIROUTE_LOCAL_ENDPOINTS_ENABLED	0	src/lib/security/localEndpoints.ts	Swichi kuu ya njia za /api/local/*. Ikiwa haijawekwa au ni 0, njia zote za /api/local/* hurejesha 503 katika mazingira ya uzalishaji. Lazima iwe 1 katika usanidi usiotumia loopback ili kuwezesha kizinduzi cha Redis na vianzishi sawa vya huduma za ndani vya mbofyo 1. Ulinzi wa ziada pamoja na uainishaji wa ulinzi wa njia wa isLocalOnlyPath() (LOCAL_ONLY_API_PREFIXES katika src/server/authz/routeGuard.ts).
OMNIROUTE_LOCAL_ENDPOINTS_TOKEN	(haijawekwa)	src/lib/security/localEndpoints.ts	Tokeni ya Bearer kwa wapigaji wa /api/local/* ambao hawako kwenye loopback (k.m. programu ya eneo-kazi). Ikiwa imewekwa, maombi kutoka kwa IP zisizo za loopback lazima yawe na Authorization: Bearer <token>. Inahitajika wakati OMNIROUTE_LOCAL_ENDPOINTS_ENABLED=1 katika usanidi usiotumia loopback.
OMNIROUTE_REDIS_CONTAINER_NAME	omniroute-redis	bin/cli/commands/redis.mjs	Jina la kontena la kizinduzi cha Redis cha mbofyo 1 (omniroute redis up). Hutumiwa na CLI pamoja na GUI ya RedisLauncherPanel.
OMNIROUTE_REDIS_HOST_PORT	6379	bin/cli/commands/redis.mjs	Bandari ya seva pangishi kwa kizinduzi cha Redis cha mbofyo 1. Ibadilishe ikiwa seva pangishi tayari inatumia 6379. Bandari ya ndani ya kontena hubaki 6379.
OMNIROUTE_REDIS_BIND_HOST	127.0.0.1	bin/cli/commands/redis.mjs	Kiolesura cha seva pangishi ambacho kizinduzi cha Redis cha mbofyo 1 huchapisha kwake. Kizinduzi huanzisha Redis BILA nenosiri, kwa hivyo kufungamanisha na 0.0.0.0 huruhusu kila seva pangishi kwenye LAN yako kufikia Redis bila uthibitishaji — panua ufikiaji huu ikiwa tu utaweka mwenyewe nenosiri kwenye instansi hiyo.
REDIS_BIND_HOST	127.0.0.1	docker-compose.yml	Kiolesura cha seva pangishi ambacho docker-compose huchapisha huduma saidizi ya Redis kwake (#9286). Redis ya compose huendeshwa bila requirepass; makontena ya programu huifikia kupitia mtandao wa compose (redis:6379) — bandari iliyochapishwa ipo tu kwa zana zinazotumika upande wa seva pangishi. 0.0.0.0 huweka Redis isiyo na uthibitishaji wazi kwa LAN nzima.
REDIS_PORT	6379	docker-compose.yml	Bandari ya seva pangishi kwa huduma saidizi ya Redis ya compose.
APP_BIND_HOST	127.0.0.1	docker-compose.yml, docker-compose.prod.yml	Kiolesura cha seva ambacho docker-compose hutumia kuchapisha milango ya dashibodi/API/live-WS ya programu yenyewe (#12568). Kwa kuwa REQUIRE_API_KEY=false ndiyo chaguo-msingi linalosambazwa katika .env.example, 0.0.0.0 hufichua proksi ya LLM ya /v1 isiyohitaji uthibitishaji kwa LAN/WAN nzima — panua ufikiaji tu baada ya kuweka REQUIRE_API_KEY=true au ikiwa proksi ya kinyume iliyo mbele inatekeleza uthibitishaji wake yenyewe.
QDRANT_BIND_HOST	127.0.0.1	docker-compose.yml	Kiolesura cha seva ambacho docker-compose hutumia kuchapisha huduma saidizi ya kumbukumbu ya Qdrant (#12578). Hoja ya ufichuaji kwenye LAN ni sawa na ya REDIS_BIND_HOST.
BIFROST_BIND_HOST	127.0.0.1	docker-compose.yml	Kiolesura cha seva ambacho docker-compose hutumia kuchapisha huduma saidizi ya kipanga njia cha Bifrost (#12578). Hoja ya ufichuaji kwenye LAN ni sawa na ya REDIS_BIND_HOST.
REDIS_KEY_PREFIX	omniroute:	src/shared/utils/rateLimiter.ts	Kiambishi awali cha nafasi ya majina kinachotumika kwa kila ufunguo wa Redis wa OmniRoute (kikomo cha kasi, akiba ya uthibitishaji, hifadhi ya kiwango cha matumizi, kivunja mzunguko cha uanzishaji). Huzuia migongano ya funguo wakati instansi ya Redis inashirikiwa na programu nyingine (#11042).
OMNIROUTE_INTERNAL_SERVICE_TOKEN	(haijawekwa — utaratibu umezimwa)	src/lib/api/internalServiceAuth.ts	Siri inayoshirikiwa kwa miito ya ndani ya REST inayohifadhi utambulisho (#9260): vipengele vya OmniRoute vinavyopigia njia nyingine za ndani za OmniRoute huituma kama x-omniroute-internal-service-token ili utambulisho wa mpigaji wa awali uhifadhiwe. Hulinganishwa kwa kutumia timingSafeEqual.
OMNIROUTE_INTERNAL_SERVICE_TOKEN_FILE	(haijawekwa)	src/lib/api/internalServiceAuth.ts	Kibadala cha faili ya siri cha tokeni ya huduma ya ndani: njia ya faili ambayo maudhui yake yaliyopunguzwa nafasi za pembeni ndiyo tokeni. Huzingatiwa tu wakati kigeu cha ndani hakijawekwa.
OPENROUTER_PROVIDER_STATS_ENABLED	true	src/lib/catalog/openrouterProviderStats.ts	Huboresha orodha ya watoa huduma kwenye dashibodi kwa takwimu za viwango vya kila wiki vya OpenRouter (#9324). Huwashwa kwa chaguo-msingi; weka false ili kuruka kabisa uletaji wa chinichini (hauzuii mchakato na hausababishi hitilafu mbaya kamwe).
OPENROUTER_PROVIDER_STATS_TTL_MS	86400000 (saa 24)	src/lib/catalog/openrouterProviderStats.ts	TTL ya akiba kwa taswira ya takwimu za watoa huduma wa OpenRouter, kwa milisekunde.
OMNIROUTE_REDIS_IMAGE	redis:7-alpine	bin/cli/commands/redis.mjs	Taswira ya Redis inayotumiwa na kizinduzi cha Redis cha mbofyo 1. Badilisha iwe redis:8-alpine au kioo cha sajili ya faragha kulingana na mahitaji.
QDRANT_HOST	qdrant	(wasifu wa klasta wa hiari)	Jina la seva la huduma saidizi ya Qdrant wakati --profile memory inatumika. Chaguo-msingi huelekeza kwenye jina la huduma ya qdrant ndani ya mtandao; libadilishe kwa uwekaji wa nje. Hutumiwa tu wakati qdrantEnabled ni true kwenye msimbo (src/lib/memory/vectorStore.ts:108).
QDRANT_PORT	6333	(wasifu wa hiari wa klasta)	Mlango wa REST wa huduma saidizi ya Qdrant.
QDRANT_GRPC_PORT	6334	(wasifu wa hiari wa klasta)	Mlango wa gRPC wa huduma saidizi ya Qdrant. Hutumiwa na maktaba za kiteja zinazopendelea gRPC badala ya REST kwa operesheni za utiririshaji.
QDRANT_API_KEY	(haijawekwa)	(wasifu wa hiari wa klasta)	Ufunguo wa hiari wa API kwa Qdrant Cloud au nakala ya ndani yenye uthibitishaji. Tupu → hakuna kichwa cha api-key kinachotumwa.
QDRANT_COLLECTION	omniroute-memory	(wasifu wa hiari wa klasta)	Jina la mkusanyiko wa upachikaji wa kumbukumbu za mazungumzo ya OmniRoute. Huundwa wakati wa utekelezaji wa kwanza ukiwa na vipimo vya QDRANT_VECTOR_SIZE.
QDRANT_EMBEDDING_MODEL	text-embedding-3-small	(wasifu wa hiari wa klasta)	Jina chaguomsingi la modeli ya upachikaji lililorekodiwa katika metadata ya mkusanyiko wa Qdrant. Upachikaji halisi huzalishwa na mtoa huduma yeyote ambaye uga wa embeddingModel katika mipangilio ya OmniRoute unaelekezwa kwake.
QDRANT_VECTOR_SIZE	1536	(wasifu wa hiari wa klasta)	Kipimo cha vekta ya upachikaji. Lazima kilingane na modeli unayotumia kupachika (text-embedding-3-small → 1536; ada-002 → 1536; nomic-embed-text → 768).
QDRANT_HNSW_EF_CONSTRUCT	128	(wasifu wa hiari wa klasta)	Usahihi wa faharasa ya HNSW wakati wa uundaji. Thamani ya juu = uundaji wa polepole zaidi, utafutaji wa haraka zaidi.
OMNIROUTE_ROTATION_ENABLED	true	open-sse/services/rotationConfig.ts	Swichi kuu ya mzunguko wa akaunti unaoweza kusanidiwa na mwendeshaji. Ikiwa false, hakuna mojawapo ya aina za OMNIROUTE_ROTATE_* zilizo hapa chini zinazoanzisha urejeaji kwenye akaunti mbadala (hali ya kuzimwa kwa swichi kuu pia huzuia aina za 429/500/502 ambazo zimewezeshwa kwa chaguomsingi). Huruhusu kiolesura cha mbele cha usimamizi (k.m. programu ya eneo-kazi ya VibeProxy) kuakisi kanuni zake za mzunguko kwenye injini ya backend ya kurejea kwenye akaunti mbadala.
OMNIROUTE_ROTATION_RATE_LIMIT_RESET_SECONDS	0	open-sse/services/rotationConfig.ts	Kipindi cha kusubiri (sekunde) kinachotumika kwa akaunti iliyowekewa kikomo cha kasi wakati huduma ya upstream haitoi dokezo dhahiri la muda wa kuweka upya. 0 = tumia kipindi chaguomsingi cha kusubiri cha injini badala ya thamani maalum ya kubatilisha.
OMNIROUTE_ROTATION_DISABLE_TAG_WITHOUT_RESET	true	open-sse/services/rotationConfig.ts	Uakisi wa mapendeleo ya kiolesura cha mbele ya "usiweke lebo ya kuwa imewekewa kikomo cha kasi bila muda wa kuweka upya".
OMNIROUTE_ROTATE_ON_429	true	open-sse/services/rotationConfig.ts	Uwezeshaji wa uhamisho mbadala kwa kila hali kwa hitilafu za 429. Ikiwa false (na OMNIROUTE_ROTATION_ENABLED=true), hitilafu ya 429 haisababishi tena ubadilishaji wa akaunti na badala yake inarejeshwa kwa mteja.
OMNIROUTE_ROTATE_429_THRESHOLD	1	open-sse/services/rotationConfig.ts	Idadi ya hitilafu za 429 ndani ya OMNIROUTE_ROTATE_429_WINDOW_SECONDS inayohitajika kabla ya akaunti kubadilishwa. 1 (chaguo-msingi) hubadilisha mara moja, huku ikihifadhi tabia ya awali.
OMNIROUTE_ROTATE_429_WINDOW_SECONDS	120	open-sse/services/rotationConfig.ts	Kipindi kinachosogea (sekunde) ambacho ndani yake hitilafu za 429 huhesabiwa kuelekea OMNIROUTE_ROTATE_429_THRESHOLD.
OMNIROUTE_ROTATE_ON_500	true	open-sse/services/rotationConfig.ts	Uwezeshaji wa uhamisho mbadala kwa kila hali kwa hitilafu za seva za 5xx (isipokuwa 502, ambayo ina aina yake yenyewe). Ikiwa false, hitilafu hizi hazisababishi tena ubadilishaji wa akaunti.
OMNIROUTE_ROTATE_500_THRESHOLD	1	open-sse/services/rotationConfig.ts	Idadi ya hitilafu za 5xx ndani ya OMNIROUTE_ROTATE_500_WINDOW_SECONDS inayohitajika kabla ya akaunti kubadilishwa. 1 (chaguo-msingi) hubadilisha mara moja.
OMNIROUTE_ROTATE_500_WINDOW_SECONDS	120	open-sse/services/rotationConfig.ts	Kipindi kinachosogea (sekunde) ambacho ndani yake hitilafu za 5xx huhesabiwa kuelekea OMNIROUTE_ROTATE_500_THRESHOLD.
OMNIROUTE_ROTATE_ON_502	true	open-sse/services/rotationConfig.ts	Uwezeshaji wa uhamisho mbadala kwa kila hali kwa hitilafu za 502 (lango batili). Ikiwa false, hitilafu za 502 hazisababishi tena ubadilishaji wa akaunti.
OMNIROUTE_ROTATE_502_THRESHOLD	1	open-sse/services/rotationConfig.ts	Idadi ya hitilafu za 502 ndani ya OMNIROUTE_ROTATE_502_WINDOW_SECONDS inayohitajika kabla ya akaunti kubadilishwa. 1 (chaguo-msingi) hubadilisha mara moja.
OMNIROUTE_ROTATE_502_WINDOW_SECONDS	120	open-sse/services/rotationConfig.ts	Kipindi kinachosogea (sekunde) ambacho ndani yake hitilafu za 502 huhesabiwa kuelekea OMNIROUTE_ROTATE_502_THRESHOLD.
OMNIROUTE_ROTATE_ON_400	false	open-sse/services/rotationConfig.ts	Hiari ya kuwasha (chaguo-msingi IMEZIMWA): ikiwa true, hitilafu ya kawaida ya 400 (ombi batili) pia husababisha ubadilishaji wa akaunti. Hii ni nyongeza tu — haizuii kamwe tabia iliyopo ya injini ambapo hitilafu ya 400 yenye maandishi ya kikomo cha kasi/kiasi bado huhamia kwenye akaunti nyingine bila kujali alama hii.
OMNIROUTE_ROTATE_400_THRESHOLD	1	open-sse/services/rotationConfig.ts	Idadi ya hitilafu za 400 ndani ya OMNIROUTE_ROTATE_400_WINDOW_SECONDS inayohitajika kabla ya akaunti kubadilishwa (huzingatiwa tu wakati OMNIROUTE_ROTATE_ON_400=true).
OMNIROUTE_ROTATE_400_WINDOW_SECONDS	120	open-sse/services/rotationConfig.ts	Dirisha linalosogea (sekunde) ambalo ndani yake hitilafu za 400 huhesabiwa kuelekea OMNIROUTE_ROTATE_400_THRESHOLD.

Kiratibu cha Upashaji Joto cha Claude

Upashaji joto unaoendeshwa na cron kwa miunganisho ya Anthropic OAuth iliyojijumuisha, ili dirisha la kikomo cha kasi la saa 5 lifunguliwe kwa ombi dogo lililoratibiwa badala ya ombi halisi la kwanza (#8848). Kiratibu huwa kimezimwa isipokuwa OMNIROUTE_WARMUP_ENABLED iwe na thamani inayochukuliwa kuwa kweli na muunganisho uwe umewekewa alama katika settings.claudeWarmup.connections; orodha tupu ya miunganisho inamaanisha hakuna kinachopashwa joto hata ikiwa kigeu cha mazingira kimewashwa.

Kigeu	Chaguo-msingi	Faili Chanzo	Maelezo
OMNIROUTE_WARMUP_ENABLED	(hakijawekwa → kimezimwa)	src/lib/warmupScheduler.ts	Swichi kuu ya kiratibu cha upashaji joto. Hukubali 1/true/yes/on (bila kujali ukubwa wa herufi, baada ya nafasi za pembeni kuondolewa). Thamani nyingine yoyote, au kutowekwa, huacha kiratibu kikiwa kimezimwa.
OMNIROUTE_WARMUP_CRON	0 7 * * *	src/lib/warmupScheduler.ts	Usemi wa cron wenye sehemu tano kwa mzunguko wa upashaji joto, unaotathminiwa katika America/Los_Angeles (ukanda wa saa wa uwekaji upya wa Anthropic) bila kujali saa ya seva pangishi.
OMNIROUTE_WARMUP_CONCURRENCY	3	src/lib/warmupScheduler.ts	Idadi ya miunganisho inayopashwa joto kwa sambamba katika kila mzunguko. Huwekwa ndani ya 1-10; thamani isiyo ya nambari hurudi kwa 3.
OMNIROUTE_WARMUP_MODEL	claude-3-5-haiku-20241022	src/lib/warmupScheduler.ts	Modeli inayotumiwa kwa ombi la upashaji joto. Badilisha tu ikiwa chaguo-msingi halipatikani katika mpango wako; chagua modeli ya bei nafuu zaidi ambayo bado hufungua dirisha.

Vipindi vya VNC vya Kuingia kwa Kivinjari na Jina Mbadala la Saraka ya Data

Chromium+VNC iliyo ndani ya kontena inayotumika kunasa vitambulisho vya kuingia kwa kivinjari kwa mwingiliano (/api/vnc-session), pamoja na jina mbadala la zamani la DATA_DIR. Vyote ni vya hiari — chaguo-msingi za VNC hulenga picha iliyojumuishwa ya omniroute-vnc-chromium:local na hubadilishwa tu kwa ajili ya picha maalum ya kontena, milango, au urekebishaji wa mzunguko wa maisha.

Kigezo	Chaguo-msingi	Faili Chanzo	Maelezo
OMNIROUTE_VNC_IMAGE	omniroute-vnc-chromium:local	src/lib/vncSession/manifest.ts	Lebo ya image ya Docker kwa ajili ya kontena la kuingia la Chromium+VNC. Jenga docker/vnc-browser/chromium au elekeza hii kwenye image maalum.
OMNIROUTE_DOCKER_BIN	docker	src/lib/vncSession/manifest.ts	Faili tekelezi ya mazingira ya uendeshaji ya kontena inayotumiwa kuzindua kontena la VNC (kwa mfano, iweke kuwa podman).
OMNIROUTE_VNC_CONTAINER_VNC_PORT	3000	src/lib/vncSession/manifest.ts	Porti ya VNC/noVNC inayofichuliwa ndani ya kontena.
OMNIROUTE_VNC_CONTAINER_CDP_PORT	9223	src/lib/vncSession/manifest.ts	Porti ya Chrome DevTools Protocol ndani ya kontena.
OMNIROUTE_VNC_CONTAINER_PROFILE_DIR	/config	src/lib/vncSession/manifest.ts	Njia ya saraka ya wasifu wa Chromium ndani ya kontena.
OMNIROUTE_VNC_PROFILE_DIR	$HOME/.omniroute/browser-login-profiles	src/lib/vncSession/manifest.ts	Saraka ya hosti inayohifadhi wasifu endelevu wa kuingia katika kivinjari.
OMNIROUTE_VNC_IDLE_MS	600000 (dakika 10)	src/lib/vncSession/manifest.ts	Muda wa kuisha kwa kutotumika (ms) kabla ya kipindi cha VNC kisichotumika kuondolewa.
OMNIROUTE_VNC_MAX_MS	1800000 (dakika 30)	src/lib/vncSession/manifest.ts	Kikomo kisichoweza kuvukwa (ms) cha muda wa matumizi wa kipindi kimoja cha VNC.
OMNIROUTE_VNC_MAX_SESSIONS	4	src/lib/vncSession/manifest.ts	Idadi ya juu zaidi ya vipindi vya VNC vinavyoweza kuendeshwa kwa wakati mmoja.
OMNIROUTE_VNC_READY_MS	45000	src/lib/vncSession/manifest.ts	Muda wa kuisha (ms) wa kusubiri kivinjari kilicho ndani ya kontena kiwe tayari kwa CDP.
OMNIROUTE_VNC_HARVEST_MS	20000	src/lib/vncSession/manifest.ts	Muda wa kuisha (ms) wa kukusanya kipindi/cookies zilizonaswa baada ya kuingia kukamilika.
OMNIROUTE_VNC_CHROMIUM_ARGS	--remote-debugging-port=9222 --no-first-run --no-default-browser-check	src/lib/vncSession/manifest.ts	Bendera za ziada za mstari wa amri zinazopitishwa kwa Chromium iliyo ndani ya kontena.
OMNIROUTE_VNC_NETWORK	omniroute-vnc-browser-login	src/lib/vncSession/manifest.ts	Mtandao maalum wa Docker ambao kontena la kuingia la VNC hujiunga nao (#12571) badala ya bridge chaguo-msingi, ili kontena nyingine zinazolingana zisiweze kufikia porti yake ya bridge ya CDP.
VIBEPROXY_DATA_DIR	(haijawekwa)	open-sse/services/notionThreadSessions.ts	Lakabu ya zamani ya DATA_DIR, inayokaguliwa tu baada ya DATA_DIR na OMNIROUTE_DATA_DIR kutowekwa. Hubainisha mahali pa kache ya kipindi cha web-thread cha Notion (<dir>/notion-web-thread-sessions.json).

---

26. Mfumo wa Majaribio na E2E

Hutumika na scripts/dev/run-next-playwright.mjs, scripts/dev/smoke-electron-packaged.mjs, scripts/dev/run-ecosystem-tests.mjs, na scripts/build/uninstall.mjs. Acha thamani zote zilizo hapa chini bila kuwekwa katika mazingira ya uzalishaji.

Kigezo	Chaguo-msingi	Faili Chanzo	Maelezo
OMNIROUTE_E2E_BOOTSTRAP_MODE	auth	scripts/dev/run-next-playwright.mjs	Hali ya uanzishaji ya E2E (auth, fresh, reuse) kwa kiendesha Playwright.
OMNIROUTE_E2E_PASSWORD	hutumia INITIAL_PASSWORD	scripts/dev/run-next-playwright.mjs	Nenosiri la msimamizi linalowekwa katika mazingira ya Playwright.
OMNIROUTE_DISABLE_LOCAL_HEALTHCHECK	true	scripts/dev/run-next-playwright.mjs	Lemaza ukaguzi wa mara kwa mara wa hali ya mfumo wa ndani wakati wa uendeshaji wa Playwright.
OMNIROUTE_DISABLE_TOKEN_HEALTHCHECK	true	scripts/dev/run-next-playwright.mjs	Lemaza kitanzi cha ukaguzi wa hali ya tokeni ya OAuth wakati wa majaribio.
OMNIROUTE_HEALTHCHECK_SKIP_PROVIDERS	(haijawekwa)	src/lib/tokenHealthCheck.ts	Watoa huduma waliotenganishwa kwa koma ambao hawajumuishwi katika mzunguko wa mapema wa kuonyesha upya tokeni (k.m. codex,openai). Ni mbadala mahsusi wa kulemaza kabisa ukaguzi wa hali—watoa huduma wenye TTL fupi huendelea kuonyesha upya huku watoa huduma wa mfululizo wakibaki kuitikia tu.
OMNIROUTE_HIDE_HEALTHCHECK_LOGS	true	scripts/dev/run-next-playwright.mjs	Nyamazisha ujumbe usiohitajika wa ukaguzi wa hali katika stdout ya Playwright.
OMNIROUTE_PLAYWRIGHT_SKIP_BUILD	0	scripts/dev/run-next-playwright.mjs	Ruka ujengaji wa uzalishaji wa Next.js kabla Playwright haijaanza (uboreshaji wa CI).
OMNIROUTE_SKIP_UNINSTALL_HOOK	0	scripts/build/uninstall.mjs	Ruka hook ya uondoaji wa OmniRoute (hutumiwa na CI kuweka node_modules bila kubadilishwa).
ECOSYSTEM_SERVER_WAIT_MS	180000	scripts/dev/run-ecosystem-tests.mjs	Muda wa kusubiri (ms) hadi seva iwe katika hali nzuri kabla ya kuendesha majaribio ya mfumo-ikolojia/itifaki.
ELECTRON_SMOKE_URL	http://127.0.0.1:20128/login	scripts/dev/smoke-electron-packaged.mjs	URL ambayo mfumo wa majaribio ya msingi ya Electron unatarajia programu iliyofungashwa itumie kutoa huduma.
ELECTRON_SMOKE_TIMEOUT_MS	45000	scripts/dev/smoke-electron-packaged.mjs	Jumla ya muda wa kusubiri (ms) kabla mfumo wa majaribio ya msingi haujakata tamaa.
ELECTRON_SMOKE_SETTLE_MS	2000	scripts/dev/smoke-electron-packaged.mjs	Kipindi cha kutulia (ms) baada ya ukurasa kupakiwa.
ELECTRON_SMOKE_APP_EXECUTABLE	(kiotomatiki)	scripts/dev/smoke-electron-packaged.mjs	Njia kamili iliyobainishwa ya faili tekelezi ya Electron iliyofungashwa.
ELECTRON_SMOKE_DATA_DIR	(tmpdir)	scripts/dev/smoke-electron-packaged.mjs	Saraka ya data ya uendeshaji wa majaribio ya msingi ya Electron.
ELECTRON_SMOKE_KEEP_DATA	0	scripts/dev/smoke-electron-packaged.mjs	Weka 1 ili kuhifadhi saraka ya data ya smoke baada ya utekelezaji.
ELECTRON_SMOKE_STREAM_LOGS	0	scripts/dev/smoke-electron-packaged.mjs	Weka 1 ili kutiririsha kumbukumbu za Electron kwenda stdout wakati wa utekelezaji.
ELECTRON_SMOKE_COLD_RESTART	0	scripts/dev/smoke-electron-packaged.mjs	#7592: zindua upya ukitumia saraka ileile ya data na uthibitishe kuwa uzinduzi wa pili unachagua kiendeshaji asilia cha SQLite.
CLI_DEVIN_BIN	(utafutaji wa PATH)	open-sse/executors/devin-cli.ts	Batilisha njia ya faili tekelezi ya Devin CLI.

Mchakato wa kutafsiri hati

Hutumiwa na scripts/i18n/run-translation.mjs (amri ya npm run i18n:run). Vigeu vyote vitano havijawekwa kwa chaguo-msingi — viweke katika .env kwenye mashine zinazopaswa kuwa na uwezo wa kuendesha kitafsiri cha hati pekee.

Kigeu	Chaguo-msingi	Faili Chanzo	Maelezo
OMNIROUTE_TRANSLATION_API_URL	(hakijawekwa)	scripts/i18n/run-translation.mjs	URL ya msingi inayooana na OpenAI kwa mfumo wa nyuma wa utafsiri.
OMNIROUTE_TRANSLATION_API_KEY	(hakijawekwa)	scripts/i18n/run-translation.mjs	Tokeni ya Bearer kwa mfumo wa nyuma wa utafsiri (haiwekwi kamwe kwenye kumbukumbu).
OMNIROUTE_TRANSLATION_MODEL	(hakijawekwa)	scripts/i18n/run-translation.mjs	Kitambulisho cha modeli, k.m. gpt-4o-mini au cx/gpt-5.4-mini.
OMNIROUTE_TRANSLATION_TIMEOUT_MS	60000	scripts/i18n/run-translation.mjs	Muda wa kuisha kwa kila ombi katika milisekunde.
OMNIROUTE_TRANSLATION_CONCURRENCY	4	scripts/i18n/run-translation.mjs	Maombi sambamba ya utafsiri wakati wa kushughulikia faili / lugha nyingi.

---

27. Mlisho wa Radar (Kujipangishia)

Nyongeza ya hiari inayodhibitiwa na bendera ya kipengele RADAR_ENABLED (imezimwa kwa chaguo-msingi — bendera ya kipengele inayowashwa au kuzimwa kupitia Settings/DB, si kigezo cha mazingira; angalia docs/frameworks/RADAR.md). Vigezo vinne vya kwanza hapa chini ni mabadiliko ya hiari kwa mlisho unaojipangishia au uliogawanywa, pamoja na mitiririko ya ufunguo wa msaidizi. Cha tano, RADAR_ADMIN_URL, ni kiungo tofauti kisicho na thamani chaguo-msingi kinachoelekeza kwenye paneli binafsi ya uendeshaji ya mmiliki. Angalia docs/frameworks/RADAR.md kwa hati kamili ya moduli na mlolongo wake wa uanzishaji wa mwanzo hadi mwisho na usanidi unaoongozwa.

Kisomaji cha kawaida cha matangazo cha Home/Changelog hakisanidiwi kwa kigezo cha mazingira na hakitegemei bendera ya kipengele RADAR_ENABLED. Kinasoma URL ya news.json ya hazina ya umma iliyotangazwa katika src/shared/utils/releaseNotes.ts kwa kutumia GET pekee; vitambulisho vya matangazo yaliyofungwa hubaki katika hifadhi ya ndani ya kivinjari.

Kigezo	Chaguo-msingi	Faili Chanzo	Maelezo
RADAR_FEED_URL	https://radar.omniroute.online	src/lib/radar/{sync,referralsSync,offersSync,intelSync}.ts	URL ya msingi inayoshirikiwa na milisho iliyosainiwa kando ya katalogi, marejeleo, ofa za wafuasi na Intel. Badilisha ili ielekeze kwenye huduma inayojipangishia au iliyogawanywa.
RADAR_FEED_PUBKEY	(ufunguo chaguo-msingi uliobandikwa)	src/lib/radar/pinnedKeys.ts	Ufunguo wa umma wa Ed25519 (base64-DER SPKI au PEM) unaotumika kuthibitisha sahihi za mlisho kutoka kwa mlisho maalum.
RADAR_CONTRIBUTOR_CLAIM_URL	https://radar.omniroute.online/auth/github	src/lib/radar/links.ts	URL inayofunguliwa na kitufe cha dashibodi cha "Mimi ni mchangiaji" (mtiririko wa kudai ufunguo wa msaidizi kupitia GitHub OAuth).
RADAR_SUPPORTER_PLANS_URL	https://radar.omniroute.online/planos	src/lib/radar/links.ts	URL inayofunguliwa na kitufe cha dashibodi cha "Saidia mradi" (ukurasa wa malipo/mipango).
RADAR_ADMIN_URL	(haijawekwa)	src/lib/radar/links.ts	Kiungo cha paneli binafsi ya uendeshaji kinachopatikana kwa mmiliki pekee. HTTPS inahitajika isipokuwa kwa usambazaji wa SSH wa loopback kupitia HTTP; thamani ambazo hazijawekwa au si halali haziundi kipengee cha urambazaji.

---

Ukaguzi: Vigezo Vilivyoondolewa / Visivyotumika

Vigezo vifuatavyo vilionekana katika matoleo ya awali ya .env.example lakini havina marejeleo ya wakati wa utekelezaji katika hazina ya sasa ya msimbo. Vimeondolewa:

Kigezo	Sababu
STORAGE_DRIVER=sqlite	Haisomwi kamwe na faili yoyote ya chanzo. SQLite ndiyo kiendeshi pekee kinachotumika — hakuna haja ya kuchagua.
INSTANCE_NAME=omniroute	Kipo katika nyaraka/violezo vya zamani vya env lakini hakitumiki wakati wa utekelezaji. Huenda kikarejeshwa katika kipengele cha siku zijazo cha mifano mingi.
SQLITE_MAX_SIZE_MB=2048	Hakirejelewi katika msimbo chanzo. Ukubwa wa hifadhidata haujawekewa kikomo bandia.
SQLITE_CLEAN_LEGACY_FILES=true	Hakirejelewi katika msimbo chanzo. Usafishaji wa faili za zamani huenda uliondolewa.
CLI_ROO_BIN	Hakijasajiliwa katika src/shared/services/cliRuntime.ts.
CLI_KIMI_CODING_BIN	Hakijasajiliwa katika src/shared/services/cliRuntime.ts (Kimi Coding hutumia OAuth, si faili tekelezi ya CLI).
IFLOW_OAUTH_CLIENT_ID / IFLOW_OAUTH_CLIENT_SECRET	Havirejelewi popote katika msimbo chanzo.
CEREBRAS_API_KEY / COHERE_API_KEY / FIREWORKS_API_KEY / GROQ_API_KEY / MISTRAL_API_KEY / NEBIUS_API_KEY / PERPLEXITY_API_KEY / TOGETHER_API_KEY / XAI_API_KEY	Viliondolewa katika v3.8.0. Mfumo wa utekelezaji hausomi tena vigezo hivi vya env — vitambulisho hutoka kwenye Dashibodi / data/provider-credentials.json / hifadhidata iliyosimbwa.
CURSOR_PROTOBUF_DEBUG	Kiliondolewa katika v3.8.0. Kitekelezaji cha Cursor hutumia CURSOR_DEBUG / CURSOR_STREAM_DEBUG (angalia §22).
CLI_COMPAT_KIRO	Kiliondolewa katika v3.8.0. Kiro imo katika CLI_COMPAT_OMITTED_PROVIDER_IDS — kitufe chake cha kuwasha/kuzima hakina athari.
QIANFAN_API_KEY	Kiliondolewa pamoja na viwakilishi vingine vya funguo za API za watoa huduma visivyotumika katika v3.8.0.

Masahihisho ya Thamani Chaguomsingi

Kigezo	Thamani ya Zamani ya .env.example	Chaguomsingi Halisi la Msimbo	Marekebisho
APP_LOG_RETENTION_DAYS	90	7	✅ Thamani ya kupotosha iliondolewa; 7 ikaandikwa kama chaguomsingi
CALL_LOG_RETENTION_DAYS	90	7	✅ Thamani ya kupotosha iliondolewa; 7 ikaandikwa kama chaguomsingi

Uundaji upya wa usanidi wa OpenCode (zana za dharura)

Hutumiwa na scripts/ad-hoc/regen-opencode-config.ts kuunda upya opencode.json yenye thamani sahihi za limit.context na limit.output zinazotolewa kutoka kwa mfano wa OmniRoute unaoendelea kutekelezwa. Hakuna mojawapo inayohitajika kwa uendeshaji wa kawaida — hati hii ni zana ya wasanidi programu pekee.

Kigezo	Chaguo-msingi	Faili Chanzo	Maelezo
OMNIROUTE_URL	http://localhost:20128	scripts/ad-hoc/regen-opencode-config.ts	URL ya msingi ya instansi ya OmniRoute inayoulizwa kwa /v1/models.
OMNIROUTE_KEY	(hakijawekwa)	scripts/ad-hoc/regen-opencode-config.ts	Ufunguo wa API wa kuthibitisha utambulisho kwenye endpoint ya OmniRoute /v1/models. Hutumia OPENCODE_API_KEY ikiwa hakijawekwa.
OPENCODE_API_KEY	(hakijawekwa)	scripts/ad-hoc/regen-opencode-config.ts	Ufunguo wa API wa mtindo wa OpenCode (sk-...) unaoandikwa kwenye opencode.json iliyozalishwa upya. Hutumia OMNIROUTE_KEY ikiwa hakijawekwa.

Zana ya tathmini ya nje ya mtandao ya ubanaji (zana maalum)

Inatumiwa na scripts/compression-eval/index.ts, CLI ya tathmini ya ubanaji nje ya mtandao. Haihitajiki kwa uendeshaji wa kawaida — ni zana ya msanidi programu pekee.

Kigezo	Chaguo-msingi	Faili Chanzo	Maelezo
OMNIROUTE_EVAL_CREDENTIALS	{} (tupu)	scripts/compression-eval/index.ts	Vitambulisho vya JSON vinavyotolewa na mwendeshaji kwa mtoa huduma anayejaribiwa na CLI ya tathmini ya ubanaji nje ya mtandao (vinachanganuliwa kwa JSON.parse). Acha bila kuwekwa kwa jaribio kavu.

Vipindi vya Kivinjari vya VNC

Inatumiwa na src/lib/vncSession/manifest.ts kusanidi vipindi vya Chromium isiyo na kiolesura vinavyotegemea Docker kwa watoa huduma wa uendeshaji otomatiki wa kivinjari. Vyote ni vya hiari — chaguo-msingi yameonyeshwa hapa chini.

Kigezo	Chaguo-msingi	Faili Chanzo	Maelezo
OMNIROUTE_DOCKER_BIN	docker	src/lib/vncSession/manifest.ts	Njia ya faili tekelezi ya Docker inayotumiwa kuanzisha kontena za VNC.
OMNIROUTE_VNC_IMAGE	omniroute-vnc-chromium:local	src/lib/vncSession/manifest.ts	Taswira ya Docker kwa kontena ya VNC Chromium.
OMNIROUTE_VNC_CHROMIUM_ARGS	(bendera zilizojengewa ndani)	src/lib/vncSession/manifest.ts	Hoja za ziada za CLI za Chromium zinazopitishwa kwa kivinjari ndani ya kontena.
OMNIROUTE_VNC_CONTAINER_VNC_PORT	3000	src/lib/vncSession/manifest.ts	Porti ya VNC ndani ya kontena.
OMNIROUTE_VNC_CONTAINER_CDP_PORT	9223	src/lib/vncSession/manifest.ts	Porti ya Chrome DevTools Protocol ndani ya kontena.
OMNIROUTE_VNC_CONTAINER_PROFILE_DIR	/config	src/lib/vncSession/manifest.ts	Saraka ya wasifu ndani ya kontena.
OMNIROUTE_VNC_PROFILE_DIR	(hakijawekwa)	src/lib/vncSession/manifest.ts	Saraka ya upande wa hosti kwa wasifu wa kivinjari unaodumu.
OMNIROUTE_VNC_IDLE_MS	600000	src/lib/vncSession/manifest.ts	Muda wa kuisha kwa kutotumika (ms) kabla ya kipindi cha VNC kukusanywa.
OMNIROUTE_VNC_MAX_MS	1800000	src/lib/vncSession/manifest.ts	Muda wa juu zaidi wa kipindi (ms).
OMNIROUTE_VNC_MAX_SESSIONS	4	src/lib/vncSession/manifest.ts	Idadi ya juu zaidi ya vipindi vya VNC vinavyoweza kuendeshwa kwa wakati mmoja.
OMNIROUTE_VNC_READY_MS	45000	src/lib/vncSession/manifest.ts	Muda wa kuisha wa kusubiri kivinjari kiwe tayari (ms).
OMNIROUTE_VNC_HARVEST_MS	20000	src/lib/vncSession/manifest.ts	Muda wa kuisha wa ukusanyaji/usafishaji (ms).
OMNIROUTE_VNC_NETWORK	omniroute-vnc-browser-login	src/lib/vncSession/manifest.ts	Mtandao maalum wa Docker ambao kontena hujiunga nao (#12571), nje ya daraja chaguo-msingi.
VIBEPROXY_DATA_DIR	(hakijawekwa)	open-sse/services/notionThreadSessions.ts	Saraka ya uhifadhi endelevu wa vipindi vya mijadala ya Notion.

Uthibitishaji wa huduma za ndani

Kigezo	Chaguo-msingi	Maelezo
OMNIROUTE_INTERNAL_SERVICE_TOKEN	–	Tokeni iliyo ndani ya kigezo kwa uthibitishaji wa huduma-kwa-huduma wa sehemu ya usimamizi.
OMNIROUTE_INTERNAL_SERVICE_TOKEN_FILE	–	Njia ya faili iliyo na tokeni ya huduma ya ndani (hupendelewa kwenye kontena; hubatilisha kigezo kilicho ndani).

Takwimu za mtoa huduma wa OpenRouter

Kigezo	Chaguo-msingi	Maelezo
OPENROUTER_PROVIDER_STATS_ENABLED	true	Weka kuwa false ili kuruka uletaji wa takwimu za kila mtoa huduma wa OpenRouter kwa ajili ya kuboresha katalogi.
OPENROUTER_PROVIDER_STATS_TTL_MS	3600000	TTL ya akiba (ms) kwa takwimu za watoa huduma wa OpenRouter zilizoletwa.

Uunganishaji wa Redis uliopachikwa

Kigezo	Chaguo-msingi	Maelezo
REDIS_BIND_HOST	127.0.0.1	Anwani ya kuunganisha kwa huduma ya Redis iliyopachikwa.
REDIS_PORT	6379	Mlango wa huduma ya Redis iliyopachikwa.
OMNIROUTE_REDIS_BIND_HOST	–	Ubatilishaji wenye wigo wa OmniRoute kwa anwani ya kuunganisha ya Redis iliyopachikwa.

---

24. Nyongeza za toleo la v3.8.50

Mipangilio hii ilianzishwa baada ya picha ya awali ya mkataba wa mazingira.

Kigezo	Chaguo-msingi	Faili Chanzo	Maelezo
OMNIROUTE_CHAT_ADMISSION_QUEUE_MS	2000	src/shared/middleware/chatBodyAdmission.ts	Muda wa juu zaidi wa kusubiri nafasi ya kupokea gumzo zito kabla ya 503 inayoweza kujaribiwa tena; kusubiri kwa muda mfupi uliowekewa kikomo hupanga mfululizo wa ongezeko la ghafla la maombi ya ajenti badala ya kutoa 503 papo hapo. 0 hurejesha ukataaji wa papo hapo.
OMNIROUTE_CHAT_ADMISSION_MAX_QUEUED_BYTES	4194304 (4 MB)	src/shared/middleware/chatBodyAdmission.ts	Bajeti ya baiti zilizowekwa kwenye foleni kwa ajili ya kusubiri kupokelewa: huweka kikomo cha jumla ya baiti za mwili zilizohifadhiwa kwenye bafa na kusimamishwa katika mchakato mzima ili kusubiri kusiongeze matumizi ya heap (#4380). Maombi ya kusubiri yanayozidi bajeti hupokea 503 inayoweza kujaribiwa tena papo hapo.
OMNIROUTE_CHAT_VIRTUAL_TTL_MS	60000 (60 s)	src/shared/middleware/chatBodyAdmission.ts	Imeacha kutumika na haifanyi chochote tangu #10110: njia za upokeaji kwa kila kipindi ziliondolewa na nafasi yake kuchukuliwa na bajeti moja ya mchakato mzima. Inakubaliwa kwa uoanifu wa usanidi; inapuuzwa.
OMNIROUTE_CHAT_VIRTUAL_MAX_SESSIONS	64	src/shared/middleware/chatBodyAdmission.ts	Imeacha kutumika na haifanyi chochote tangu #10110: njia za upokeaji kwa kila kipindi ziliondolewa na nafasi yake kuchukuliwa na bajeti moja ya mchakato mzima. Inakubaliwa kwa uoanifu wa usanidi; inapuuzwa.
OMNIROUTE_CHAT_VIRTUAL_LANES	0 (imezimwa)	open-sse/services/admission/runtime.ts	Njia pepe za upokeaji za wakati wa utekelezaji zinazojirekebisha (#9654): swichi kuu ya lango linalojirekebisha kwa kila mpangaji (mfumo wa 2). Ni tofauti na vigezo vya njia kwa kila muunganisho vilivyoacha kutumika hapo juu (TTL_MS / MAX_SESSIONS, havifanyi chochote tangu #10110). Alama ya kipengele ya dashibodi yenye jina sawa; kigezo cha mazingira kina kipaumbele kuliko ubatilishaji wa dashibodi; inahitaji kuwashwa upya.
OMNIROUTE_RUNNOW_TIMEOUT_MS	30000	src/app/api/jobs/[id]/run-now/route.ts	Huweka kikomo cha muda ambao mwito wa kutekeleza sasa husubiri kazi inayoendelea kabla ya kuanza utekelezaji uliowekwa kwenye foleni.
ADOBE_FIREFLY_BROWSER_REFRESH	imewezeshwa	open-sse/services/adobeFireflySession.ts	Hudumisha hali ya IMS na hatari ya kivinjari ikiwa mpya kupitia vipindi vya Chrome CDP vya kiwango cha akaunti; weka 0 ili kuzima.
ADOBE_FIREFLY_SESSION_DISK	imewezeshwa	open-sse/services/adobeFireflySession.ts	Huhifadhi vipindi vya Adobe vilivyorekebishwa chini ya DATA_DIR; weka 0 kwa hali ya kumbukumbu pekee.
ADOBE_FIREFLY_MIN_SUBMIT_GAP_MS	12000	open-sse/services/adobeFireflySession.ts	Kipindi cha chini kabisa kati ya uwasilishaji wa maombi ya kuzalisha ya Adobe Firefly.
ADOBE_FIREFLY_BATCH_EXTRA_GAP_MS	15000	open-sse/services/adobeFireflySession.ts	Kipindi cha ziada cha utulivu baada ya kila uwasilishaji wa tatu wa Adobe uliofanikiwa.
ADOBE_FIREFLY_CHROME_HEADLESS	0	open-sse/services/adobeFireflyBrowserLogin.ts	Modi halisi isiyo na kiolesura ya utatuzi pekee; Adobe colligo kwa kawaida hukataa kipindi cha hatari kinachotokana nayo.
CHROME_PATH	utambuzi-otomatiki	open-sse/executors/cloudflare-playground.ts, open-sse/executors/chatgpt-web-codex.ts	Faili tekelezi kamili ya hiari ya Chrome inayotumiwa na vitekelezaji vinavyoendeshwa na kivinjari wakati utambuzi wa kiotomatiki wa mfumo hautoshi.
TELEGRAM_BOT_TOKEN	(haijawekwa)	src/lib/telegram/config.ts	Tokeni ya BotFather inayowezesha webhook inayoingia na kusaini initData ya Mini App.
TELEGRAM_WEBHOOK_SECRET	(haijawekwa)	src/lib/telegram/config.ts	Siri ya pamoja iliyosajiliwa kupitia setWebhook na kuthibitishwa dhidi ya kichwa cha X-Telegram-Bot-Api-Secret-Token katika kila uwasilishaji wa webhook. Inahitajika kwa njia ya webhook; ikiwa haijawekwa, uwasilishaji wa webhook hukataliwa kwa 503.
TELEGRAM_DEFAULT_MODEL	auto/chat	src/lib/telegram/chatProxy.ts	Modeli inayotumiwa kwa majibu ya gumzo la Telegram.
TELEGRAM_BOT_API_BASE	https://api.telegram.org	src/lib/telegram/config.ts	Ubatilishaji wa URL msingi ya Bot API kwa seva mbadala au seva za Bot API zinazojiendesha.
TELEGRAM_WEBHOOK_TIMEOUT_MS	60000	src/lib/telegram/config.ts	Muda wa kuisha kwa milisekunde kwa miito ya Bot API inayotoka.
OMNIROUTE_OPTIONAL_PACK_TAR	1 (imewezeshwa)	scripts/build/optionalPackStaging.mjs	Weka 0 ili kuruka utoaji wa vifurushi vya tar vya .tar.gz wakati wa kuandaa vifurushi vya hiari vya ML/kivinjari kwa ajili ya muundo wa Electron unaojitegemea (saraka za vifurushi na optional-packs.index.json bado huundwa). Hutumiwa na mtiririko wa kazi wa toleo la mezani ili kupunguza ukubwa wa upakiaji wa vizalia.

ChatGPT Web (Codex)

Chaguo-msingi za jumla za kivinjari kisicho na kiolesura na handaki la zana linalotoka. Thamani za Connection zilizowekwa kwenye dashibodi zina kipaumbele.

Kigezo	Chaguomsingi	Faili Chanzo	Maelezo
CHATGPT_WEB_CODEX_CHROME_PATH	(gundua kiotomatiki)	open-sse/executors/chatgpt-web-codex.ts	Njia mahususi ya Chrome/Chromium kwa uendeshaji wa npm, systemd na PM2.
CHROME_PATH	(gundua kiotomatiki)	open-sse/executors/chatgpt-web-codex.ts	Njia mbadala ya pamoja kwa njia mahususi ya Chrome/Chromium.
CHATGPT_WEB_CODEX_CDP_URL	(haijawekwa)	open-sse/executors/chatgpt-web-codex.ts	Endpoint ya ndani ya CDP; Docker hutumia sidecar kwenye porti 9223.
CDP_PROXY_TOKEN	(haijawekwa)	docker/chatgpt-web-codex-browser/cdp-proxy.mjs	Ikiwekwa, kila ombi kwa sidecar ya proksi ya CDP lazima lijumuishe thamani hii kwenye header ya X-Omni-Cdp-Token (#13679). Bila thamani, proksi hupeleka maombi bila uthibitishaji — katika hali hiyo, ni utengaji wa mtandao wa Compose chatgpt-web-codex-net pekee unaolinda. Tengeneza kwa openssl rand -hex 32.
CHATGPT_WEB_CODEX_TUNNEL_ID	(haijawekwa)	open-sse/executors/chatgpt-web-codex.ts	Kitambulisho cha jumla cha tunnel ya OpenAI kwa mizunguko ya ndani ya zana za Codex.
CHATGPT_WEB_CODEX_RUNTIME_KEY	(haijawekwa)	open-sse/executors/chatgpt-web-codex.ts	Runtime key ya jumla ya tunnel; usiwahi kuitoa kwenye kumbukumbu.
CHATGPT_WEB_CODEX_CONNECTOR_NAME	OmniRoute Codex v2	open-sse/executors/chatgpt-web-codex.ts	Jina halisi la ChatGPT Custom Connector iliyoundwa hivi karibuni kwa daraja la MCP.
CODEX_CHATGPT_WEB_HOME	<DATA_DIR>/chatgpt-web-codex	open-sse/vendor/codex-chatgpt-web/config.ts	Saraka maalumu kwa hali ya kivinjari, broker na tunnel.
CODEX_CHATGPT_WEB_BROWSER_DIAGNOSTICS	0	open-sse/vendor/codex-chatgpt-web/adapters/chatgpt-web/browser-worker.ts	Ikiwa ni 1, picha za uchunguzi wa kivinjari hunaswa katika kila checkpoint.
CODEX_CHATGPT_WEB_LAUNCHER	(haijawekwa)	open-sse/vendor/codex-chatgpt-web/config.ts	Njia kamili ya hiari kuelekea binary ya launcher ya kudumu.
CODEX_CHATGPT_WEB_BUN	(gundua kiotomatiki)	open-sse/vendor/codex-chatgpt-web/config.ts	Njia kamili ya hiari kuelekea binary ya Bun runtime.
CODEX_WEB_GPT_BUN	(haijawekwa)	open-sse/vendor/codex-chatgpt-web/config.ts	Njia mbadala ya zamani kwa CODEX_CHATGPT_WEB_BUN; usanidi mpya hutumia jina rasmi.

---

Daraja la OmniConductor

Mtumiaji wa SSE wa muda mrefu anayeakisi majukumu ya kitovu cha OmniConductor kwenye A2A TaskManager ya ndani (src/lib/conductor/). Ni ya hiari — daraja huanza tu wakati CONDUCTOR_HUB_URL imewekwa. Kwa upande wa seva pekee: tokeni ya kitovu haipaswi kamwe kufika kwenye kivinjari.

Kigezo	Chaguo-msingi	Faili Chanzo	Maelezo
CONDUCTOR_HUB_URL	(tupu)	src/lib/conductor/boot.ts	URL ya msingi ya kitovu cha OmniConductor (k.m. http://127.0.0.1:7910). Ikiwa haijawekwa = daraja limezimwa.
CONDUCTOR_HUB_TOKEN	(tupu)	src/lib/conductor/boot.ts	Kitambulisho cha kitovu kwa ajili ya mtiririko wa SSE — toa peer ya aina ya spokesperson kwenye kitovu (POST /v1/peers, msimamizi).
CONDUCTOR_ORCHESTRATOR_TOKEN	(tupu)	src/lib/conductor/hubProxy.ts	Kitambulisho cha kukabidhi majukumu yanayoingia ya A2A→kitovu (POST /v1/tasks); hutumia CONDUCTOR_HUB_TOKEN ikiwa hakijawekwa.
CONDUCTOR_SPOKESPERSON_URL	http://127.0.0.1:7920	src/lib/conductor/faroProxy.ts	URL ya msingi ya huduma ya msemaji (Faro) iliyo nyuma ya proksi ya gumzo la dashibodi (/api/conductor/ask).

Upangaji unaozingatia mgao

Hutumiwa na open-sse/services/combo.ts na src/lib/quota/quotaScheduler.ts kwa ukaguzi wa bajeti ya tokeni kabla ya ombi. Ni ya hiari — tabia chaguo-msingi ya uelekezaji haibadiliki ikiwa haijawekwa.

Kigezo	Chaguo-msingi	Faili Chanzo	Maelezo
OMNIROUTE_QUOTA_AWARE_ROUTING	0	open-sse/services/combo.ts	Ikiwa ni 1, ruka miunganisho ambayo bajeti yake ya tokeni kwa kila kipindi (rateLimitOverrides.tpm, jedwali la provider_quota_state) haitoshi kumudu gharama iliyokadiriwa ya ombi kabla ya kutumwa. Endelea bila kuzuia ikiwa hakuna bajeti iliyosanidiwa.