1 Inngangur & útgáfur

DeepCerebra Coder er umboðsmannastýrður kóðunaraðstoðarmaður. Ólíkt einföldum sjálfvirkum útfyllingaraðstoðarmanni, þá skipuleggur hann, skrifar, endurbætir, keyrir skipanir, kallar á verkfæri og endurtekur yfir allt verkefnið þitt — þar sem þú yfirferð og samþykkir breytingarnar sem hann leggur til.

Þrjár leiðir til að nota það

Þessi handbók leggur áherslu á vefappið á deepcerebra.ai; skjáborðsforritið endurspeglar sömu spjöld og vinnuferla.

2 Að byrja & reikningur

Styðdir vafrar

Notaðu núverandi útgáfu af Chrome, Edge, eða Brave fyrir fulla upplifun — að opna staðbundna möppu byggir á Chromium File System Access API. Firefox og Safari virka fyrir spjall og fyrir Git-tengd verkefni, en geta ekki opnað staðbundna möppu beint.

Búa til reikning

1. Smelltu á Get Started á forsíðunni.
2. Fylltu út valfrjálst birtingarnafn, netfang, land, og fæðingardag (þú verður að vera að minnsta kosti 18 ára).
3. Veldu viðmótsmál og lykilorð sem er að minnsta kosti 12 stafir.
4. Lestu samþykkistilkynninguna og staðfestu. Með því að búa til reikning samþykkir þú þjónustuskilmála, persónuverndaryfirlýsingu, þjónustulýsingu, og Global DPA.
5. Smelltu á Create account, staðfestu síðan netfangið þitt ef beðið er um það, og skráðu þig inn.

Endurstilla lykilorð

1. Á innskráningarsíðunni, smelltu á Forgot password?
2. Sláðu inn netfangið þitt og opnaðu endurstillingartengilinn sem sendur var í pósthólfið þitt.
3. Stilltu nýtt lykilorð (að minnsta kosti 12 stafir).

3 Vinnusvæðið í fljótu bragði

Eftir innskráningu lendir þú í vinnubekknum, sem setur allar ramma á einn skjá:

• Explorer (vinstri) — skráartréð fyrir opna verkefnið, með endurnýjunar- og lokunarhnappi.
• Editor (miðja) — innihald skráa með litun á setningafræði og smámyndayfirliti; innbyggðar diffs birtast hér þegar umboðsmaðurinn leggur til breytingar.
• Terminal (undir ritlinum, kveikja/slökkva) — keyra skipanir og lesa úttak.
• Chat (hægri) — samtal umboðsmannsins; þetta er aðalramminn sem fyllir upp í rýmið.

Dragðu skiptinguna á milli ritilsins og spjallsins til að endurjafna skipulagið, og dragðu lárétta skiptinguna til að breyta stærð flugstöðvarinnar. Vinstri hliðarstikan leiðir einnig til Workspace, Extensions, API Keys, Billing, og Feedback.

4 Opna verkefni

4.1 Opna staðbundna möppu

1. Í Explorer, smelltu á Open project folder.
2. Veldu möppu og veittu vafranum leyfi til að lesa hana.
3. Skrár eru lesnar inn í dulkóðað vinnusvæði í vafra — ekkert er hlaðið upp. Þú munt sjá lifandi fjölda og lokasamantekt (skráafjöldi · stærð, auk allra sleppt eða stytt skráa).

4.2 Opna úr Git (GitHub / GitLab)

1. Smelltu á Open from Git í Explorer.
2. Veldu GitHub eða GitLab flipann og límdu inn persónulegan aðgangslykil. Fyrir GitHub notaðu repo scope (klassískt) eða fínstilltan lykil með Contents + Pull requests; fyrir GitLab notaðu api scope. Lykillinn þinn er geymdur á netþjóninum — aðeins innihald skráa er dregið inn í vafrann.
3. Sláðu inn repository sem owner/name (síaðu listann til að finna þinn), veldu síðan branch.
4. Valfrjálst merktu við Create a new working branch (t.d. dcc/my-feature) til að halda vinnu þinni einangraðri frá sjálfgefna branchinu.
5. Valfrjálst virkjaðu push webhook svo Explorer endurnýjist samstundis þegar liðsfélagar pusha (þarf opinbera gateway URL).
6. Smelltu á Open repository.

4.3 Endurnýja, skipta og loka

• Refresh (↻ í Explorer hausnum) skannar möppuna aftur eða sækir nýjustu útgáfu úr Git.
• Open another mappa eða Open from Git frá hnöppunum undir trénu.
• Close project (ruslatunnumerki) hreinsar vinnusvæðið í vafranum.

4.4 Möppu-bundnar spjalllotur

Spjallferill er tengdur opna verkefninu. Að skipta um möppur ræsir sjálfkrafa nýja lotu og hleður fyrri lotur þeirrar möppu, opnar þá nýjustu svo þú getir haldið áfram þar sem frá var horfið.

4.5 Rekstrarmöppur

Möppur sem DeepCerebra notar innbyrðis — .deepcerebra, .sessions — birtast í trénu en eru sjálfgefið felldar saman svo þær trufla ekki upprunakóðann þinn.

5 Vinna með skrár

• Smelltu á skrá í Explorer til að opna hana í ritlinum; smámyndin hjálpar þér að vafra um langar skrár.
• Dragðu skrá úr Explorer inn í spjallgluggann til að festa hana sem skýrt samhengi fyrir næstu skilaboð þín.
• Þegar umboðsmaðurinn leggur til breytingar, sýnir ritillinn innbyggðan diff fyrir valda skrá.

6 Spjalla við umboðsmanninn

Skrifa beiðni

Lýstu því sem þú vilt á einföldu máli — spurðu spurningar, óskaðu eftir eiginleika, eða bentu á villu. Vertu nákvæmur um skrár, rammaverk og takmarkanir til að fá besta árangurinn. Hengdu viðeigandi skrár með því að draga þær inn í gluggann.

Lesa svör, Cursor-stíl

Svör eru skipulögð eins og Cursor: rökstuðningur umboðsmannsins er aðskilinn frá afhendanlegu. Hver svarsblokk hefur afritunarmerki í efra hægra horninu svo þú getur afritað fullunna skýrslu, skjal, eða skipun sem þú átt að keyra.

Stýra eða stöðva keyrslu

• Notaðu Stop til að stöðva keyrslu sem er á rangri leið, og betrumbættu síðan beiðni þína.
• Gefðu vísbendingar (t.d. "notaðu lxml í stað html.parser") til að brjóta umboðsmanninn út úr lykkju.

7 Fjórir spjallhamir

Veldu ham úr hamvalinu við hliðina á glugganum. Hver stillir hversu mikið umboðsmaðurinn skipuleggur og hversu frjálslega hann breytir:

8 Yfirfara & beita breytingum

Þegar umboðsmaðurinn leggur til skráabreytingar, birtist Proposed Changes spjaldið fyrir ofan spjallinnsláttinn, sem listar hverja snerta skrá með bættum (+) og fjarlægðum (−) línufjölda.

• Smelltu á skráarlínu til að opna innbyggða diff hennar í ritlinum.
• Apply eða Reject eina skrá, eða notaðu Apply all / Reject all.
• Beittar breytingar eru merktar applied (og · disk þegar þær eru skrifaðar í raunverulega möppu).
• Ef engin skrifanleg mappa er til staðar, gefur workspace only merki til kynna að breytingar eigi við um vinnusvæðið í vafranum.

9 Innbyggð flugstöð

Kveiktu á flugstöðinni undir ritlinum til að keyra byggingar, prófanir og skriftir. Með leyfi þínu getur umboðsmaðurinn framkvæmt skipanir og lesið úttak þeirra til að staðfesta vinnu sína; langvarandi skipanir streyma úttaki svo þú getur fylgst með framvindu. Lokaðu flugstöðinni úr hausnum þegar þú þarft ekki á henni að halda.

10 Plan hamur & framkvæmd

Fyrir stærri markmið, notaðu Plan ham (eða biddu umboðsmanninn að skipuleggja fyrst). Skipuleggjandinn skannar verkefnið þitt, brýtur markmiðið niður í verkefni sem taka mið af ósjálfstæði, og úthlutar hverju til rétts sérfræðings (arkitekt, kóðara, prófara, skjöl).

• Yfirfara & breyta áætluninni — bæta við, fjarlægja eða breyta verkefnum fyrir framkvæmd.
• Framkvæma lag fyrir lag — óháð verkefni keyra saman; skipuleggjandinn getur endurskipulagt ef verkefni mistekst.
• Gera hlé, halda áfram eða hætta við framkvæmd hvenær sem er.

11 Velja líkön & Auto

Opnaðu model picker við hliðina á glugganum. Valkostir eru flokkaðir sem:

• Auto — láttu DeepCerebra velja besta tiltæka líkanið (mælt með).
• Local (your GPU) — líkön sem þjónað er frá þinni eigin vél (sjá §13).
• Platform gateways — hýst líkön, flokkuð eftir gateway og síðan eftir söluaðila (t.d. Anthropic, OpenAI, Google).

Hvernig Auto val virkar

Á Auto notar DeepCerebra stigskipta, aðlögunarhæfa leiðarstýringu: einföld verkefni fara til hraðvirks, hagkvæms líkans, á meðan flókin eða skipulagsþung vinna (til dæmis Plan hamur) er beint til sterkara líkans. Þetta jafnar kostnað og gæði sjálfkrafa, svo þú þarft sjaldan að velja handvirkt.

12 Bring Your Own Key (BYOK)

Þú getur beint beiðnum í gegnum þinn eigin þjónustuaðila reikning í stað þess að nota mælda vettvangsnotkun.

1. Opnaðu API Keys úr hliðarstikunni.
2. Undir Bring Your Own Key, veldu þjónustuaðila (t.d. ANTHROPIC_API_KEY, GOOGLE_API_KEY, OPENAI_API_KEY).
3. Límdu inn lykilgildið og smelltu á Save. Lyklar eru dulkóðaðir í hvíld og aldrei skilað til vafrans — aðeins grímuklædd forskoðun er sýnd.

Platform (DeepCerebra) líkön þurfa engan lykil. Fjarlægðu lykil hvenær sem er með Remove.

13 Staðbundin vél: GPU líkön & Console (DCC Bridge)

DCC Bridge tengir þína eigin tölvu við vefappið í gegnum lítinn dcc-bridge tengi, sem opnar tvo möguleika í einu:

• Local GPU models — líkön sem þjónað er af Ollama eða LM Studio á vélinni þinni birtast í líkanavalinu undir Local (your GPU).
• Console / terminal on your machine — vefstöðin og umboðsmaðurinn geta keyrt raunverulegar skipanir á tölvunni þinni, þar á meðal CLI verkfæri sem þú hefur þegar stillt (Railway, AWS CLI, OVH CLI, gh, docker, kubectl, WSL, …) með núverandi skilríkjum þeirra.

Tengillinn hringir út yfir auðkennda WebSocket — engar innkomandi portar þarf, og hann virkar á bak við NAT og eldveggi. Hann keyrir á Windows, macOS og Linux (Python 3.10+).

13.1 Paraðu tölvuna þína

1. Smelltu á fartölvumerkið í vinstri virknistikunni — Local Machine (GPU + Console). (Sama spjaldið opnast úr líkanavalinu neðst í gegnum Manage local GPU….)
2. Gakktu úr skugga um að Local execution rofinn sé virkur, nefndu tækið og smelltu á Add this computer. Afritaðu einnota pairing token (dcc_brg_…) og tilbúna tengiskipun — lykillinn er sýndur nákvæmlega einu sinni.

13.2 Setja upp & keyra tengilinn

pip install git+https://github.com/mohammadkhair7/DeepCerebra-connector

# then run the command copied from the pairing card, e.g.:
python -m dcc_bridge --gateway wss://deepcerebra.ai --token dcc_brg_xxxxx

• Notaðu sama lén og þú notar í vafranum sem gateway (wss://deepcerebra.ai eða wss://deepcerebra.io) — pörunarkortið fyllir út rétta. Vefsíðurnar tvær eru aðskildar dreifingar með aðskildum reikningum og lyklum.
• Fyrir GPU líkön, haltu Ollama í gangi, eða virkjaðu staðbundinn netþjón LM Studio (sjálfgefið port 1234) með líkani hlaðnu.
• Pöruð tæki sýna online/offline stöðu, líkanfjölda og framkvæmdarsvið; þú getur Revoke tæki hvenær sem er.

13.3 Notaðu console þinn úr vefappinu

Sjálfgefið eru skipanir takmarkaðar við sérstaka vinnusvæðismöppu (~/DeepCerebra). Til að vinna í raunverulegum verkefnamöppum þínum með fyrirfram stilltum CLIs, veittu þeim skýrt leyfi þegar tengillinn er ræstur:

# grant one or more real folders (repeatable)
python -m dcc_bridge --gateway wss://deepcerebra.ai --token dcc_brg_xxxxx --host-dir "F:\MyProjects"

# or the whole machine (prints a warning; prefer --host-dir)
python -m dcc_bridge ... --allow-any-dir

Opnaðu síðan Terminal spjaldið, smelltu á Execution target sprettigluggann (fartölvumerki), veldu My computer, og veldu vinnuskráasafn. Bæði skipanir sem þú slærð inn og byggingar-/prófunarskipunir umboðsmannsins eru síðan framkvæmdar á vélinni þinni.

14 Git samvinnuferli

Með Git-tengdu verkefni opnu, birtist branch bar í Explorer sem sýnir núverandi branch þinn og tvær aðgerðir:

• Check in (commit) — yfirfarðu fjölda breyttra skráa, skrifaðu commit skilaboð og commitðu á vinnubranch þinn.
• Integrate — opnaðu pull request frá vinnubranch þínum inn í sjálfgefna branchinn (t.d. main). Þú verður að vera á vinnubranch, ekki sjálfgefna branchinum.

Ef push webhook er virkur, endurnýjast Explorer sjálfkrafa þegar liðsfélagar pusha, og heldur öllum í samstillingu — grundvöllur samvinnuþróunar í gegnum DeepCerebra.

15 MCP Servers

Útvíkkaðu umboðsmanninn með ytri verkfærum og gögnum í gegnum Model Context Protocol. Stilltu netþjóna í .deepcerebra/mcp.json skrá, til dæmis:

{
  "mcpServers": {
    "my-tools": {
      "url": "https://example.com/mcp",
      "disabled": false,
      "allowlist": ["search_issues", "get_pr"],
      "autoApprove": ["create_issue"],
      "auth": { "type": "bearer", "tokenEnv": "MY_TOKEN" }
    }
  }
}

Virkjuð MCP verkfæri verða sjálfkrafa aðgengileg umboðsmanninum þegar þau eru viðeigandi fyrir beiðni þína. Staðbundnir (stdio) og fjarlægir (http/sse) netþjónar eru báðir studdir.

Innbyggt öryggi

• Deny-by-default — þegar netþjónn listar allowlist, geta aðeins þessi verkfæri keyrt.
• Approval for high-risk tools — verkfæri sem breyta (skrifa/eyða/dreifa/…) krefjast samþykkis nema þú samþykkir þau fyrirfram í autoApprove.
• Rate limiting, argument and output sanitation, and an audit log eiga við um hvert kall.

Resources & prompts

Ef netþjónn sýnir MCP resources eða prompt templates, fær umboðsmaðurinn sjálfkrafa verkfæri til að nota þau (mcp_list_resources, mcp_read_resource, mcp_list_prompts, mcp_get_prompt).

Auðkenning fyrir fjarlæga netþjóna

Bættu við auth blokk við fjarlægan netþjón. Leyndarmál styðja ${ENV_VAR} innskot:

// Static bearer token (literal or from env)
"auth": { "type": "bearer", "token": "${GITHUB_TOKEN}" }
"auth": { "type": "bearer", "tokenEnv": "GITHUB_TOKEN" }

// Custom header (e.g. API key)
"auth": { "type": "header", "header": "x-api-key", "value": "${MY_KEY}" }

// OAuth 2.0 client-credentials
"auth": {
  "type": "oauth", "grant": "client_credentials",
  "tokenUrl": "https://auth.example.com/oauth/token",
  "clientId": "${MCP_CLIENT_ID}", "clientSecret": "${MCP_CLIENT_SECRET}",
  "scope": "mcp.read mcp.write"
}

16 Sérsníða umboðsmanninn: Reglur, færni, krókar, undirumboðsmenn & viðbætur

Þú getur mótað hvernig umboðsmaðurinn hugsar og bregst við með einni, skráarmiðaðri hefð — .deepcerebra/ möppunni — sem virkar eins í skjáborðsforritinu, vefappinu, og API. Í vefappinu, stjórnaðu öllu þessu undir Agent sýninni; á skjáborði og í gegnum API eru þetta einfaldar skrár sem þú commitar með verkefninu þínu.

Scopes & precedence

Stillingar finnast í nokkrum scopes; þegar sami hlutur er til í fleiri en einu, vinnur sá sem hefur hærri forgang:

team/org  <  global (~/.deepcerebra)  <  workspace (<repo>/.deepcerebra)
(lægstur)                                              (hæstur)

• Workspace — <repo>/.deepcerebra/…, commitð með verkefninu.
• Global — ~/.deepcerebra/…, persónulegar sjálfgefna stillingar þínar yfir verkefni.
• Team / org — sameiginleg grunnlína (lægsti forgangur) svo notandi eða verkefni getur alltaf hnekkt henni. Í vefappinu, stilltu Scope reglu á Team.

Reglur (steering)

Reglur eru varanlegar leiðbeiningar — kóðunarstaðlar, arkitektúrhefðir, lénssamhengi — sem sprautað er inn í kerfisglugga umboðsmannsins. Þær eru til sem Markdown skrár undir .deepcerebra/steering/, auk alltaf-virkrar AGENTS.md staðalsins. Frontmatter stýrir hvenær regla hleðst:

---
inclusion: fileMatch          # always | fileMatch | auto | manual
globs: "src/**/*.ts"          # or fileMatchPattern
name: api-design
description: REST conventions
---
# API design
- Use REST resource nouns, plural.

• always — í hverri umferð (sjálfgefið).
• fileMatch — aðeins þegar skrá í samhengi passar við globs.
• auto — þegar beiðni þín passar við name/description reglunnar.
• manual — aðeins þegar þú vísar í hana sem #name eða /name.

Rót AGENTS.md á við um allt repo; innbyggð AGENTS.md (t.d. services/api/AGENTS.md) á aðeins við um skrár undir þeirri möppu. Í vefappinu, Agent → Steering sýnin gefur hverri reglu Scope val ( Global / Project / Team).

Skills

Skills eru endurnýtanlegar handbækur sem umboðsmaðurinn hleður eftir þörfum. Hver skill er mappa með SKILL.md undir .deepcerebra/skills/:

---
name: deploy-release
description: How to cut and publish a versioned release.
disable-model-invocation: false   # true => manual-only (/skill)
---
# Deploy a release
1. Bump the version, build, and test.
2. Tag and publish.

Umboðsmaðurinn sér léttvægan vörulista (nafn + lýsing) og dregur inn allan textann með load_skill verkfærinu þegar það er viðeigandi. Þú getur einnig kallað á eitt skýrt með /skill <name>. Stilltu disable-model-invocation: true til að gera skill aðeins handvirkt.

Hooks

Hooks keyra sjálfvirkni á lífsferilsatburðum. Skilgreindu þá sem .deepcerebra/hooks/*.hook.json:

{
  "title": "Format on save",
  "event": "fileSave",
  "filePattern": ["**/*.ts"],
  "action": { "type": "shell", "command": "npm run lint:fix -- $FILE" },
  "enabled": true
}

Atburðir innihalda promptSubmit, preToolUse, postToolUse, fileCreate, fileSave, fileDelete, preTask, postTask, sessionStart, preCompact, og agentStop (Cursor/Claude stafsetningar eru einnig samþykktar). Aðgerð er annaðhvort shell (keyra skipun) eða agentPrompt (spyrja umboðsmanninn). preToolUse hook getur allow, deny, eða ask fyrir verkfærakallið sem það stöðvar.

Subagents

Subagents eru sérfræðingumboðsmenn sem þú skilgreinir og framselur til. Hver er Markdown skrá undir .deepcerebra/agents/ með frontmatter auk meginmáls (kerfisgluggi hennar):

---
name: security-reviewer
description: Audits a diff for security issues; read-only.
model: gpt-5
readonly: true
tools: [read_file, grep_files, list_directory]
background: false
---
You are a meticulous security reviewer…

Aðalumboðsmaðurinn framselur með task (blokkar), task_async + task_status / task_result (bakgrunnur), eða task_parallel (fan-out).

Plugins

Viðbót pakkar saman reglur, færni, króka, undirumboðsmenn og MCP netþjóna í einn uppsetningarhæfan pakka undir .deepcerebra/plugins/<name>/, lýst með plugin.json skrá:

{
  "name": "Acme Standards",
  "version": "1.2.0",
  "description": "Acme rules + skills + review agents.",
  "enabled": true
}

Innihald viðbótar er sameinað með lægsta forgangi, svo þínar eigin reglur og færni hnekkja alltaf viðbótar. Slökktu á viðbót með "enabled": false eða .disabled merkjaskrá.

17 Agentic Workflow Studio & atburðastýrðir umboðsmenn

Workflow Studio er sjónrænn hönnuður fyrir sjálfvirkni margra umboðsmanna. Þú setur saman stig — hvert umboðsmaður, sérfræðiskref eða stjórnunarfrumgerð — í graf, tengir þau með ósjálfstæði, og keyrir alla samhæfinguna á vélinni með lifandi framvindu á hverju stigi, fjárhagsáætlunum og mannlegum samþykkisgáttum. Vinnuferlar eru vistaðir sem flytjanleg YAML/JSON skilgreining sem þú getur flutt út, flutt inn, útgáfustýrt í Git, og keyrt úr API eða CLI.

17.1 Að byggja vinnuferli

• Palette (vinstri) — dragðu stigategundir, tilbúnar umboðsmannategundir (rannsóknir, kóðamyndun, QA, skjalaskrifari, lækningatæki, einkaleyfaráðgjafi, og þínar eigin sérsniðnu tegundir), færni úr Skill Library, og verkfæri á strigann.
• Canvas (miðja) — raðaðu stigum og teiknaðu brúnir; brún þýðir "þetta stig er háð því" og fæðir sjálfkrafa úttak frá uppstreymi inn í glugga niðurstreymis.
• Inspector (hægri, breytanlegur) — stilltu valið stig: glugga þess, færni, verkfæri, líkanahnekkingu á hverju stigi, úttaksgrip, gátt, atburði, og tegundarsértæka breytur.
• Templates — byrjaðu á innbyggðri teikningu (Ship-It Pipeline, SaaS Starter, Data Pipeline with Evals, Customer Comms Hub, Design → Verified App) og sérsníddu hana.
• Generate — lýstu appinu eða ferlinu á einföldu máli og Agent Builder býr til heildstætt, staðfest vinnuferlisgraf sem þú getur yfirfarið, stillt og keyrt.

17.2 Stigabókasafnið

17.3 Atburðastýrðir umboðsmenn (umboðsmannanetið)

Hvert stig — óháð tegund — getur birt og áskrifað að tegundarmiðuðum atburðum á atburðarvagninum á vinnusvæðinu, svo umboðsmenn samræma sig eins og þjónustur á skilaboðavef frekar en aðeins í gegnum DAG:

• Event classes — hver atburður ber flokk: lifecycle, agent, business, data, system, schedule, chat, external, eða alert — síanleg í áskriftum og endurspilun.
• Subscribe modes — trigger (stigið keyrir þegar samsvarandi atburður berst; keyrsla með stöðvuðum stigum helst íbúð sem hlustandi), gate (vélgátt samþykkt af atburði í stað mannlegs smells), og data (gagnamagnið er sameinað í samhengi stigsins).
• Kickoff by event — hvaða umboðsmaður sem er getur verið ræstur af stjórnanda eða öðrum umboðsmanni með því að birta á heimilisfang hans agent.<stage-id>.request.
• Run triggers — triggers: blokk vinnuferlis vopnar það til að byrja á innkomnum webhooks, cron schedules, events, eða spjalli — jafnvel þótt Studio sé lokað.
• Live runs — keyrsluspjaldið streymir lífsferilsatburðum yfir SSE: stig byrja/ljúka, gáttir, viðvaranir og forskoðanir birtast samstundis.
• Durable log & replay — atburðir varðveitast á hvert vinnusvæði og hægt er að endurspila þá eftir efnisþema og flokki fyrir endurskoðun og villuleit.

17.3.1 Biðraðir atburða fyrir umboðsmenn

Umboðsmenn sem bregðast við atburðum geta skilgreint varanlega nafngreinda biðröð svo samsvarandi atburðir glatist aldrei meðan umboðsmaðurinn er upptekinn eða áður en keyrsla hlustar. Við áskrift að kveikju, stilltu queue: <name> — vélin tengir það efni við FIFO biðröð á atburðarútu vinnusvæðisins (varanlega geymt undir .deepcerebra/workflows/events/queues/). Sérhver samsvarandi atburður sem birtur er frá þeim tímapunkti er fangaður í biðröðina; þegar stigið verður keyranlegt, tekur vélin atburði úr biðröðinni í elsta-fyrst röð og neytir þeirra einn í einu.

• Ekkert glatast — atburðir sem birtast á meðan vinnuferlið er lokað, á meðan annað stig er í gangi, eða á meðan keyrslan bíður enn eftir háðum þáttum eru settir í biðröð í stað þess að falla niður.
• count á hverja áskrift — krefst N atburða í biðröð (eða afhentra) áður en áskriftin er uppfyllt (gagnlegt þegar nokkrir starfsmenn þurfa að skila skýrslu).
• Studio — í atburðarspjaldi Inspector, stilltu queue reitinn á kveikjuáskrift; virkjaðu kveikjur eða ræstu keyrslu til að búa til tenginguna sjálfkrafa.
• API & verkfæri — GET /api/workflow/queues sýnir dýpt og tengingar; GET /api/workflow/queues/{name} sýnir biðandi atburði; spjallumboðsmenn geta kallað á event_queue_status og pop_queued_event.

events:
  subscribe:
    - topic: ticket.created
      mode: trigger
      queue: triage-inbox        # durable FIFO — events wait here for this agent
      map:
        payload.ticket_id: ticket_id

17.3.2 Stýring á umferðarmerkjum (verndun sameiginlegra auðlinda)

Umferðarmerki takmarkar hversu mörg verkefni mega samtímis vinna með sameiginlega (varða) auðlind: gagnagrunn sem verið er að skrifa í, geymslu fyrir alþjóðlegar breytur, skrá, eða ytri umboðsmann með takmarkaðan hraða. Tengdu eitt við hvaða stig sem er með semaphore: — áður en vinna stigsins hefst, fær vélin eitt leyfi af nafngreindu umferðarmerki vinnusvæðisins; leyfið er alltaf gefið laust eftir á, jafnvel þótt stigið mistakist. permits: 1 gerir það að mutex: aðeins eitt verkefni í einu (yfir allar samhliða keyrslur á vinnusvæðinu) framkvæmir mikilvæga skrefið; öll önnur verkefni bíða þar til handhafinn lýkur.

• Raðgreining yfir keyrslur — umferðarmerki eru bundin við vinnusvæði og varanleg, svo tvær samtímis keyrslur vinnuferla geta ekki spillt sömu varðu auðlindinni.
• Bið, ekki stöðnun — verkefni stöðvast í allt að timeout_s eftir leyfi; ef auðlindin helst fullnýtt, mistekst stigið sýnilega í stað þess að hanga að eilífu.
• Hrunöryggi — hvert leyfi hefur ttl_s; ef handhafi hrynur án þess að gefa laust, rennur leyfið sjálfkrafa út svo auðlindin festist aldrei.
• Sýnileiki — rutan gefur frá sér semaphore.<name>.waiting, .acquired, og .released kerfisatburði; GET /api/workflow/semaphores sýnir getu, handhafa og tiltæk leyfi.
• Spjallumboðsmenn — acquire_semaphore, release_semaphore, og semaphore_status verkfæri samræma tímabundna mikilvæga hluta utan vinnuferlis.

semaphore:
  name: emr-db-writer
  permits: 1          # mutex — one writer at a time
  timeout_s: 300      # fail if still waiting after 5 minutes
  ttl_s: 900          # auto-release crashed holders after 15 minutes

17.3.3 Stýring á samkomu (bíða eftir öllum skilyrðum)

Samkoma bíður þar til mörg atburðarskilyrði eru öll uppfyllt áður en næsta skref heldur áfram — hið gagnstæða við „fyrsti atburður vinnur“. Stilltu join: all á events: blokk stigsins: sérhver kveikjuáskrift verður að vera uppfyllt áður en stigið keyrir. Sameinaðu með count: N á hverja áskrift þegar nokkrir umboðsmenn (eða nokkrar skýrslur frá einum umboðsmanni) verða allir að skrá sig inn — til dæmis, samþykki hönnunar, lok prófana og öryggisviðurkenning áður en útgáfustig er framkvæmt.

• join: any (sjálfgefið) — stigið keyrir þegar fyrsta kveikjuáskriftin er uppfyllt.
• join: all — samkoma: sérhver kveikjuáskrift (hver með sínu eigin efni, flokkasíu og valfrjálsu count) verður að vera uppfyllt; aðeins þá verður stigið keyranlegt.
• Hleðslur — allir neyttir atburðir eru skráðir á stigið sem trigger_events og gerðir aðgengilegir sniðmátum sem inputs.events (listi af atburðarhlutum með hleðslum).
• Studio — þegar stig hefur tvær eða fleiri kveikjuáskriftir, sýnir Inspector Join val: any — fyrsti atburður vinnur eða all — samkoma (bíða eftir öllum); striginn sýnir samrunamerki á samkomustigum.

events:
  join: all                    # rendezvous — wait for EVERY subscription below
  subscribe:
    - topic: design.approved
      mode: trigger
    - topic: tests.passed
      mode: trigger
    - topic: security.cleared
      mode: trigger
      count: 1

17.4 Verkfærasafn umboðsmannsins

Stig velja verkfæri úr sama skrásetningu og spjallumboðsmaðurinn notar:

• Core — skrár, git, shell, kóðaframkvæmd, kóðaleit, sjálfvirkni vafra, vefleit, sjón/miðlar, myndamyndun.
• Databases — SQLite, PostgreSQL, MySQL, MongoDB, og Redis fyrirspurnir auk create_database, apply_migrations, og dump_schema fyrir eigin gagnagrunnslög.
• Communications — símtöl og SMS (Twilio) og tölvupóstur (SendGrid), með uppgerðarham sem skráir í úthólf þegar skilríki vantar — kynningar senda aldrei raunveruleg skilaboð fyrir slysni.
• DevOps — docker_build / docker_push, compose up/down, SSH og ský-CLI dreifingar (Fly, Render, Railway, Vercel), einnig öruggar í uppgerð.
• Verification — staflagreining, framkvæmd prófunarsvíta með greindum árangurshlutfalli, ósjálfstæðisendurskoðun, og leyndarmálaskönnun.
• SciCompute Engines — hundruð vísinda- og verkfræðiaðferða (nefndar Class.method) í stærðfræði, merkjavinnslu, stýringum, tölfræði og fleira.
• Expert Agency & MCP — jarðbundnar lénsrannsóknir auk allra ytri MCP netþjóna sem þú tengir.

17.5 Keyrsla, gáttir og úttak

• Validate athugar grafið (einstök auðkenni, óhringlaga ósjálfstæði, tegundarbreytur) áður en þú keyrir.
• Human gates gera hlé á keyrslunni eftir að stigið framleiðir drög sín, svo þú samþykkir raunverulega vinnu; event gates láta annað kerfi samþykkja sjálfkrafa.
• Budgets takmarka útgjöld á hverja keyrslu og á hvert stig.
• Save outputs to project afritar alla gripi sem keyrsla bjó til inn í opna verkefnið þitt.
• Export App breytir vinnuferlinu í sjálfstæða FastAPI þjónustu; opinbera /v1 API sýnir keyrslur, atburði, kveikjur, sniðmát og myndun fyrir CI og samþættingar.

18 Fyrirsjáanleg flipaútfylling

Fyrirsjáanleg flipaútfylling býður upp á innbyggðar kóðatillögur í miðju texta þegar þú slærð inn í ritlinum — samþykktu tillögu með Tab. Hún er valfrjáls bæði á vélinni og vefritlinum.

Virkja hana

• Engine — stilltu umhverfisflaggann DCC_TAB_COMPLETE=1. Ritillinn kallar á POST /api/complete endapunkt vélarinnar, sem skilar aðeins textanum til að setja inn við bendilinn.
• Web editor — virkjaðu við byggingartíma með VITE_TAB_COMPLETE=1, eða við keyrslutíma með localStorage.setItem('dcc.tabComplete', '1') (endurhlaða síðan).

Hvernig hún hegðar sér

• Tillögur birtast sem draugatexti; ýttu á Tab til að samþykkja, eða haltu áfram að slá inn til að hætta við.
• Beiðnir eru debounced og hægt að hætta við þær, svo innsláttur er aldrei lokaður.
• Þegar flaggið er slökkt er eiginleikinn alveg óvirkur og engar útfyllingarbeiðnir eru gerðar.

19 Notkun, inneign & reikningsfærsla

Opnaðu Billing úr hliðarstikunni til að stjórna áætlun þinni og notkun. Gervigreindarnotkun er mæld í U.S.-dollara inneignum byggt á tokens sem undirliggjandi líkön neyta.

• Cycle spend & prepaid credit — fylgstu með notkun í þessari lotu og allri fyrirframgreiddri inneign.
• Add overage credit — heimilaðu viðbótarupphæð (USD) til að halda áfram að nota gervigreind eftir að innifalin heimild er uppurin; ef fjárhagsáætlun þín er uppurin muntu sjá borða sem hvetur þig til að bæta við inneign.
• Upgrade / change plan — skiptu um stig hvenær sem er.
• Payment method — bættu við eða uppfærðu kort á skrá (unnið af Stripe).
• Cancel — veldu cancel at period end (halda aðgangi þar til tímabilinu lýkur) eða cancel now (endurgreiða endurgreiðanlega afganginn). Sjá Hættunar- og endurgreiðslustefnu.

20 Að fá Gateway API lykilinn þinn

Gateway API lykill (persónulegur aðgangslykill) gerir þér kleift að nota DeepCerebra opinbera API og CLI forritunarfræðilega.

1. Skráðu þig inn og opnaðu API Keys úr hliðarstikunni.
2. Skrunaðu að DeepCerebra API Keys.
3. Sláðu inn label (t.d. "CI pipeline" eða "laptop CLI").
4. Veldu scopes — read, chat, code, agent — og valfrjálsan expiry í dögum (autt = aldrei).
5. Smelltu á Generate. Fullur lykill er sýndur aðeins einu sinni — smelltu á Copy og geymdu hann örugglega.

Notaðu hann með CLI eða API á deepcerebra.ai:

dcc config set endpoint https://deepcerebra.ai
dcc config set api-key <your-key>

# or as a Bearer token
curl -H "Authorization: Bearer <your-key>" https://deepcerebra.ai/v1/...

Þú getur rename eða delete (revoke) lykil hvenær sem er; hver lykill sýnir forskeyti sitt, scopes, búinn til/rennur út, og síðasta notkunardagsetningu.

21 Öryggi & persónuvernd

• Trúnaðarleg geymsla í vafra — verkefnaskrár þínar haldast í dulkóðuðu vinnusvæði vafrans; aðeins lágmarks samhengi sem þarf fyrir hverja beiðni er sent til netþjónsins.
• Zero Data Retention (ZDR) — gluggar og kóði sem beint er til líkana er ekki varðveittur lengur en beiðnin og er aldrei notaður til að þjálfa grunnlíkön.
• Lyklar haldast á netþjónshlið — BYOK og SCM lyklar eru dulkóðaðir í hvíld; aðeins grímuklæddar forskoðanir eru sýndar.
• Dulkóðun — TLS í flutningi; reikningsgögn dulkóðuð í hvíld; lykilorð óafturkræft hašuð.
• Kóðinn þinn er þinn — þú átt efnið þitt og myndað úttak. Sjá Persónuverndaryfirlýsingu.

22 Úrræðaleit

"Folder loading needs a Chromium browser"

Skiptu yfir í Chrome, Edge, eða Brave, eða notaðu Open from Git í staðinn.

Umboðsmaðurinn fer í lykkju á sömu villunni

Smelltu á Stop, endurorðaðu síðan með áþreifanlegri vísbendingu eða takmörkun.

Líkan eða beiðnivillur / "budget exhausted"

• Athugaðu tenginguna þína og að allir BYOK lyklar séu gildar.
• Skiptu yfir í Auto svo DeepCerebra beini til tiltæks líkans.
• Ef notkunarfjárhagsáætlun þín er uppurin, opnaðu Billing og add overage credit eða uppfærðu áætlun þína.

Staðbundin líkön birtast ekki

• Staðfestu að dcc-bridge tengillinn sé í gangi og tækið sýni online.
• Gakktu úr skugga um að Ollama sé í gangi, eða að staðbundinn netþjón LM Studio sé virkur (sjálfgefið port 1234) með líkani hlaðnu.

Tengill: "server rejected WebSocket connection: HTTP 401"

• Notaðu sama lén og þú notar í vafranum sem --gateway (wss://deepcerebra.ai eða wss://deepcerebra.io) — vefsíðurnar tvær eru aðskildar dreifingar, og lykill frá annarri virkar aldrei á hinni.
• Afritaðu nákvæma skipun af pörunarkortinu á Local Machine síðunni.

Breytingar mínar tóku ekki gildi

• Gakktu úr skugga um að þú hafir smellt á Apply (ekki bara forskoðað diff) í Proposed Changes.
• Notaðu Explorer refresh til að skanna möppuna aftur.

Git: "You are on the default branch"

Opnaðu eða búðu til working branch áður en þú notar Integrate til að opna pull request.

Enn fastur? Hafðu samband við support@deepcerebra.ai.

23 DeepCerebra Discovery — Spyrðu gögnin þín & skjölin

Discovery er rannsóknarspjallmenni fyrir gagnagrunna og skjöl. Í stað þess að svara með einni fyrirspurn vinnur það eins og sérfræðingur: það setur fram tilgátur, keyrir röð varinna kannana (SQL, graf, skjalaleit, skemaathuganir, staðfesting á vefnum), snyrtir burt þær skýringar sem gögnin hrekja og setur saman rökstutt svar — með gröfum og gagnsærri kostnaðarkvittun. Opnaðu það með áttavitartákninu í aðgerðastikunni (/app/discovery).

23.1 Rými — þitt afmarkaða verksvið

Rými safnar saman öllu sem ein spurningalína þarfnast: gagnagrunnstengingum, skjalasöfnum, leiðbeiningum fyrir sérfræðinginn og fjárhagsáætlunum. Búðu til nýtt með + Nýtt rými, notaðu síðan uppsetningarborðið hægra megin til að:

• Tengja gagnagrunna — SQLite, PostgreSQL, MySQL, SQL Server eða Snowflake. Sláðu inn nafn og DSN, smelltu á Prófa til að staðfesta tengingu (biðtími og útgáfa netþjóns eru sýnd), eða fluttu inn fyrirliggjandi tengistillingar sem JSON. Tengingar eru skrifvarðar sjálfgefið.
• Bæta við skjölum — dragðu & slepptu skrám (PDF, DOCX, PPTX, Markdown, texti) beint í spjallið, límdu inn vefslóð eða vísaðu á möppuslóð á vélarhýslinum. Skjöl eru bútuð niður, felld inn og vísuð fyrir blendingsleit með vigrum og þekkingargrafi.
• Flytja inn töflur — límdu inn eða hladdu upp CSV/JSON til að senda fyrirspurnir strax án nokkurs gagnagrunns.
• Kenna sérfræðingnum — bættu við skilgreiningum á mælikvörðum, viðskiptareglum og fyrirvörum, traustum fyrirspurnum sem sýningarstjóri hefur samþykkt og dæmapörum af spurningum→fyrirspurnum svo svörin noti þínar skilgreiningar.

23.2 Að spyrja spurningar

Skrifaðu spurningu eins og þú myndir spyrja samstarfsfélaga — til dæmis „Af hverju dróst magn segulómskoðana saman í mars?“. Rannsóknarborðið streymir öllu ferlinu í beinni:

• Tilgátur — mögulegar skýringar sem eru í rannsókn, hver þeirra merkt studd, hrakin eða óyggjandi eftir því sem gögn berast.
• Kannanir — hver fyrirspurn sem sérfræðingurinn keyrir, ásamt stöðu hennar; myndaður SQL/Cypher kóði er sýndur til að tryggja fullt gagnsæi og hver skipun stenst skrifvarðar verndarreglur fyrir keyrslu.
• Gögn — niðurstöðutöflur og útdrættir úr skjölum, vitnað í með númeri í lokasvarinu.
• Svar + gröf — rökstudd niðurstaða sem nefnir einnig þær skýringar sem var hafnað, auk nútímalegra grafa í neon-þema sem eru sett saman úr gögnunum.
• Kvittun — tókar, kostnaður á hverja könnun og umferðir, gjaldfært á AI Credits inneignina þína eins og hver önnur keyrsla á gervigreindarfulltrúa.

Framhaldsspurningar halda áfram í sama þræði, svo sérfræðingurinn heldur samhenginu.

23.3 Gröf, skýrslur & útflutningur

Gröf birtast innfelld á rannsóknarborðinu. Notaðu Flytja út til að hlaða niður allri fyrirspurninni — svarinu, tilgátunum, gögnunum og gröfunum — sem sjálfstæðri HTML-skýrslu eða prenthæfri PDF-skrá, stíluð með neon-hönnunarkerfinu.

23.4 Fjárhagsáætlanir & kostnaðarstýring

Hvert rými hefur fjárhagsáætlanir fyrir hverja fyrirspurn: hámarksfjölda kannana, rannsóknarumferða, sekúndna og USD. Vélin stöðvast snyrtilega við hámarkið og skilar því sem hún hefur fundið fram að því. Kostnaður hverrar könnunar er sundurliðaður á kvittuninni, svo þú veist alltaf í hvað eyðslan fór.

23.5 Sjálfvirkni: API, SDK, Workflow Studio & MCP

• REST API — allt sem notendaviðmótið gerir er aðgengilegt undir /v1/discovery/* með PAT sem hefur discovery aðgangsheimild (búðu það til undir Reikningur → API-lyklar). Fyrirspurnir í streymi nota SSE. Ytri keyrsluaðilar geta fengið aðeins rannsóknarskipulagninguna lánaða í gegnum Thinking API (/v1/think/*, aðgangsheimild think).
• Python SDK — pip install deepcerebra-discovery, síðan DiscoveryClient(base_url, token).ask(space_id, question).
• Workflow Studio — dragðu Discovery Ask þrepið (discovery.ask) inn í hvaða verkflæði sem er til að keyra rannsókn sem skref í ferli; svarið, gröfin og kvittunin flæða til síðari þrepa.
• MCP — vélin gerir discovery_ask og discovery_list_spaces aðgengileg sem MCP-verkfæri, svo ytri MCP-biðlarar geta einnig keyrt rannsóknir.