Agendi tööruum

Tööruum on agendi kodu. See on ainus töökataloog, mida kasutatakse faili tööriistade ja tööruumi konteksti jaoks. Hoia seda privaatsena ja käsitle seda mäluna.

See on eraldi ~/.mayros/ kataloogist, mis salvestab konfiguratsiooni, krediite ja sessioone.

Oluline: tööruum on vaikimisi cwd, mitte kõva liivakast. Tööriistad lahendavad suhtelisi teid tööruumi suhtes, kuid absoluutsed teed saavad endiselt jõuda mujale hostis, välja arvatud juhul, kui liivakast on lubatud. Kui vajad isoleerimist, kasuta agents.defaults.sandbox (ja/või agendi kohta liivakasti konfiguratsiooni). Kui liivakast on lubatud ja workspaceAccess ei ole "rw", töötavad tööriistad liivakasti tööruumi sees ~/.mayros/sandboxes all, mitte sinu hosti tööruumis.

Vaikimisi asukoht

• Vaikimisi: ~/.mayros/workspace
• Kui MAYROS_PROFILE on määratud ja ei ole "default", muutub vaikimisi ~/.mayros/workspace-<profile>.
• Alista ~/.mayros/mayros.json failis:

json5Copy
{
  agent: {
    workspace: "~/.mayros/workspace",
  },
}

mayros onboard, mayros configure või mayros setup loob tööruumi ja seemneb bootstrap faile kui need puuduvad.

Kui sa juba hallatakse tööruumi faile ise, saad keelata bootstrap failide loomise:

json5Copy
{ agent: { skipBootstrap: true } }

Lisatöötööruum kaustad

Vanemad paigaldused võisid luua ~/mayros. Mitme tööruumi kataloogide hoidmine võib põhjustada segadust auth või oleku triiviga, sest ainult üks tööruum on korraga aktiivne.

Soovitus: hoia üks aktiivne tööruum. Kui sa enam ei kasuta lisandkaustu, arhiveeri või teisalda need prügikasti (näiteks trash ~/mayros). Kui hoiad tahtlikult mitut tööruumi, veendu agents.defaults.workspace osutab aktiivsele.

mayros doctor hoiatab kui tuvastab lisandtööruumi katalooge.

Tööruumi faili kaart (mida iga fail tähendab)

Need on standardsed failid, mida Mayros ootab tööruumi sees:

• AGENTS.md

  • Agendi tööjuhised ja kuidas see peaks mälu kasutama.
  • Laaditud iga sessiooni alguses.
  • Hea koht reeglite, prioriteetide ja "kuidas käituda" üksikasjade jaoks.

• MAYROS.md

  • Persoona, toon ja piirid.
  • Laaditud igal sessioonil.

• USER.md

  • Kes kasutaja on ja kuidas teda kõnetada.
  • Laaditud igal sessioonil.

• IDENTITY.md

  • Agendi nimi, vibe ja emoji.
  • Loodud/uuendatud bootstrap rituaali ajal.

• TOOLS.md

  • Märkused sinu kohalike tööriistade ja konventsioonide kohta.
  • Ei kontrolli tööriista saadavust; see on ainult juhis.

• HEARTBEAT.md

  • Valikuline väike kontrollnimekiri südamelöökide käitamisteks.
  • Hoia see lühike, et vältida tokeni põlemist.

• BOOT.md

  • Valikuline käivituskontrollnimekiri, mis täidetakse gateway taaskäivitusel kui sisemised konksud on lubatud.
  • Hoia see lühike; kasuta sõnumivahetuse tööriista väljaminevate saatmiste jaoks.

• BOOTSTRAP.md

  • Ühekordne esmakordne rituaal.
  • Luuakse ainult täiesti uue tööruumi jaoks.
  • Kustuta see pärast rituaali lõpetamist.

• memory/YYYY-MM-DD.md

  • Igapäevane mälu logi (üks fail päevas).
  • Soovitatav lugeda täna + eile sessiooni alguses.

• MEMORY.md (valikuline)

  • Kureeritud pikaajaline mälu.
  • Laadi ainult peamises, privaatses sessioonis (mitte jagatud/grupi kontekstides).

Vaata Mälu töövoo ja automaatse mälu loputamise jaoks.

• skills/ (valikuline)

  • Tööruumipõhised oskused.
  • Alistab hallatud/kaasasolevad oskused kui nimed kokkupõrkevad.

• canvas/ (valikuline)

  • Canvas UI failid sõlme kuvamisteks (näiteks canvas/index.html).

Kui mõni bootstrap fail puudub, süstib Mayros "puuduva faili" märgi sessiooni ja jätkab. Suured bootstrap failid lühendatakse süstimisel; kohanda piiranguid agents.defaults.bootstrapMaxChars (vaikimisi: 20000) ja agents.defaults.bootstrapTotalMaxChars (vaikimisi: 150000) abil. mayros setup saab puuduvaid vaikeväärtusi taastada ilma olemasolevaid faile üle kirjutamata.

Mis EI OLE tööruumis

Need asuvad ~/.mayros/ all ja EI peaks tööruumi repo'sse panema:

• ~/.mayros/mayros.json (konfiguratsioon)
• ~/.mayros/credentials/ (OAuth tokenid, API võtmed)
• ~/.mayros/agents/<agentId>/sessions/ (sessiooni transkriptid + metaandmed)
• ~/.mayros/skills/ (hallatud oskused)

Kui pead sessioone või konfiguratsiooni migreerima, kopeeri need eraldi ja hoia neid versioonikontrollist väljas.

Git varundamine (soovitatav, privaatne)

Käsitle tööruumi privaatse mäluna. Pane see privaatsesse git repo'sse, et see oleks varundatud ja taastatav.

Käivita need sammud masinas, kus Gateway töötab (seal asub tööruum).

1) Initsialiseeri repo

Kui git on paigaldatud, initsialiseeritakse täiesti uued tööruumid automaatselt. Kui see tööruum ei ole juba repo, käivita:

bashCopy
cd ~/.mayros/workspace
git init
git add AGENTS.md MAYROS.md TOOLS.md IDENTITY.md USER.md HEARTBEAT.md memory/
git commit -m "Add agent workspace"

2) Lisa privaatne remote (algaja sõbralikud valikud)

Valik A: GitHub veeb UI

1. Loo uus privaatne repositoorium GitHubis.
2. Ära initsialiseeri README-ga (väldib ühendamise konflikte).
3. Kopeeri HTTPS remote URL.
4. Lisa remote ja push:

bashCopy
git branch -M main
git remote add origin <https-url>
git push -u origin main

Valik B: GitHub CLI (gh)

bashCopy
gh auth login
gh repo create mayros-workspace --private --source . --remote origin --push

Valik C: GitLab veeb UI

1. Loo uus privaatne repositoorium GitLabis.
2. Ära initsialiseeri README-ga (väldib ühendamise konflikte).
3. Kopeeri HTTPS remote URL.
4. Lisa remote ja push:

bashCopy
git branch -M main
git remote add origin <https-url>
git push -u origin main

3) Jätkuvad uuendused

bashCopy
git status
git add .
git commit -m "Update memory"
git push

Ära pane saladusi

Isegi privaatses repos väldi saladuste salvestamist tööruumis:

• API võtmed, OAuth tokenid, paroolid või privaatsed krediidid.
• Midagi ~/.mayros/ alt.
• Vestluste või tundlike manuste toored dumpid.

Kui pead salvestama tundlikke viiteid, kasuta kohatäitjaid ja hoia päris saladus mujal (paroolihaldur, keskkonnamuutujad või ~/.mayros/).

Soovitatud .gitignore starter:

gitignoreCopy
.DS_Store
.env
**/*.key
**/*.pem
**/secrets*

Tööruumi teisaldamine uude masinasse

1. Klooni repo soovitud teed (vaikimisi ~/.mayros/workspace).
2. Määra agents.defaults.workspace sellele teele ~/.mayros/mayros.json failis.
3. Käivita mayros setup --workspace <path>, et seemnata puuduvaid faile.
4. Kui vajad sessioone, kopeeri ~/.mayros/agents/<agentId>/sessions/ vanast masinast eraldi.

Täpsemad märkused

• Mitmikagendi marsruutimine saab kasutada erinevaid tööruume agendi kohta. Vaata Kanali marsruutimine marsruutimise konfiguratsiooni jaoks.
• Kui agents.defaults.sandbox on lubatud, saavad mitte-peamised sessioonid kasutada sessiooni kohta liivakasti tööruume agents.defaults.sandbox.workspaceRoot all.