Жылдам бастау

Notarium — бұл өз дискіңіздегі әдеттегі Markdown-файлдар түрінде құрылған, адам мен ЖИ-агент тең дәрежеде жұмыс істейтін өзіндік хостингтегі білім қоры. Ешқандай бұлт, ешқандай меншікті пішім жоқ: жазбалар қалталарда жатады, ал ақиқат көзі git бола алады.

Бұл бөлім — нөлден бастап жұмыс істеп тұрған данаға дейінгі ең қысқа жол: Notarium-ды бір контейнермен өрістетіңіз, веб-редакторда алғашқы жазбаңызды жасаңыз және агентіңізді MCP арқылы қосыңыз. Бүкіл жолға шамамен бес минут кетеді.

Не қажет болады

Тек Docker (немесе Docker Desktop) және бос порт. Қалғанының бәрі — веб-редактор, қозғалтқыш және агенттерге арналған MCP-эндпоинт — образдың ішінде дайын тұр. Node, дерекқор немесе векторлық индексті бөлек орнатудың қажеті жоқ.

Бұл қалай құрылған

Бір білім қоры бір мезгілде екі оқырманға ашық. Адам веб-редактор арқылы, агент MCP-эндпоинт арқылы жұмыс істейді; екеуі де бір жазбалар графын көреді, ал дискіде бұл жай ғана .md-файлдар ағашы.

flowchart LR
  human([Адам]) -->|веб-редактор| core
  agent([ЖИ-агент]) -->|MCP · start_session| core
  core[Notarium қозғалтқышы] --> files[(Дискідегі<br/>Markdown-файлдар)]
  files -.->|git = ақиқат көзі| git[(Репозиторий)]

Негізгі қағида — file-first: жазба — бұл файл, біреудің бөтен дерекқорындағы жол емес. Экспорттың қажеті жоқ, өйткені сіз ешқашан «ішінде» болмайсыз — деректер әрқашан сіздікі әрі әрқашан дискіде.

Дананы көтеру

Ең жылдам тәсіл — дайын образды іске қосу. Ол өзін-өзі қамтамасыз етеді: қозғалтқышты, веб-интерфейсті және MCP-эндпоинтті бірден көтереді.

# Образды алып, контейнерді көтеру
docker run -d --name notarium \
  -p 3000:3000 \
  -v notarium-data:/data \
  docouno/notarium:latest

Бір /data томы бүкіл күйді ұстайды: қызметтік дерекқорды, индекстерді, жазбаларыңызды және экспорт артефактілерін. Одан басқа баптайтын ешнәрсе жоқ — 3000 порты мен /data деректер жолы образда әлдеқашан белгіленген. 3000-ден сол жақтағы портты кез келген бос портқа ауыстыруға болады.

http://localhost:3000 мекенжайын ашыңыз — сізді алғашқы іске қосудың орнату экраны қарсы алады. Ол дананың иесін (алғашқы аккаунт) және бастапқы (жеке) кеңістікті құрады. Одан кейін сіз редактордасыз.

Порт пен деректер

3000 портын -p <өзіңіздікі>:3000 дегендегі сол жақ бөлікпен ауыстыруға болады. docouno/notarium образы — ашық қолжетімді, бұл орнатудың негізгі жолы (толығырақ және бастапқы кодтан құрастыру — Орнату бетінде). /data томы контейнерді қайта жасағанда сақталады — бірақ томның өзін сақтаңыз: онымен бірге деректер де жоғалады.

Алғашқы іске қосуда ішкі жағында не болады:

қозғалтқыш көтеріліп, көрсетілген портта веб-интерфейсті береді;
/data томының ішінде кеңістіктеріңіздің ағашы инициализацияланады;
орнату экраны иені құрады — данаға осы аккаунт иелік етеді.

Әрі қарай

Дана көтерілді — әрі қарай үш қысқа қадам. Әрқайсысы өз бетінде талданған:

Қадам	Бет	Не аласыз
1	Орнату және іске қосу	`docker` / `make up`, томдар мен орнату экранының талдауы
2	Алғашқы жазба	Файлдар ағашы, веб-редактор, `.md`-ға сақтау
3	Агентті қосу	Токен, `POST /mcp` эндпоинті, `start_session` шақыруы

Алдымен модельді тұтастай түсінгіңіз келе ме — Концепциялар бөліміне қараңыз: кеңістіктер мен жобалар, жазба түрлері, білім графы және адам мен агенттердің қатынау моделі.