Pääse pääsisään

Agent-integraatio

💡TL;DR
Neljä julkista komentoa kirjoittaa metadataa ja JSON-sopimuksia toimivan Obsidianin ja holvin kautta. Tämä ei ole yleinen muistiinpanojen muokkaus-API. Aloita pinnan löytämisestä, skeemoista/käsittelytageista ja nykyisen tuloksen tarkistuksesta.

Edellytykset​

Notemdin on oltava käytössä oikeassa holvissa ja virallisen Obsidian CLI:n saatavilla. Valitse holvi ennen komentoa. requiredContext: none tarkoittaa ettei aktiivista muistiinpanoa/valintaa tarvita, ei ettei isäntää/holvia tarvittaisi.

obsidian help
obsidian commands filter=notemd

obsidian-cli on eri jakelu kuin virallinen obsidian. Toisen onnistuminen ei todista toisen olemassaoloa. Kirjaa integraatio poissa käytöstä, jos isäntä/CLI puuttuu.

Julkiset tunnisteet​

  • notemd:export-provider-profiles-redacted
  • notemd:export-cli-capability-manifest
  • notemd:export-cli-invocation-contract
  • notemd:export-cli-public-surface

Syötteet ovat tyhjiä objektiskeemoja, operaatiovastaavuudet tarkkoja ja komennot ei-vuorovaikutteisia. Ne luovat tai korvaavat tiedostot lisäosan asetushakemistossa.

Löydä, vie, validoi​

Aloita julkisesta pinnasta:

obsidian command id=notemd:export-cli-public-surface
obsidian command id=notemd:export-cli-invocation-contract
obsidian command id=notemd:export-cli-capability-manifest
obsidian command id=notemd:export-provider-profiles-redacted
VientiOletuspolku suhteessa holviin
Julkinen pinta.obsidian/plugins/notemd/notemd-cli-public-surface.json
Kutsusopimus.obsidian/plugins/notemd/notemd-cli-contract.json
Kyvykkyysmanifesti.obsidian/plugins/notemd/notemd-cli-capabilities.json
Peitetyt tarjoajaprofiilit.obsidian/plugins/notemd/notemd-providers-redacted.json

Muuta .obsidian todelliseksi asetushakemistoksi tarvittaessa. stdout ei ole tyypitetty operaatiotulos. Varmista nykyisen kutsun kirjoittaneen tiedoston ja tarkista jäsennetty JSON skeemaa vasten. Vanha tiedosto tai onnistumisilmoitus ei riitä.

Tarkista version, commands, operationId, operationVersion, inputSchema, resultSchema. Dokumenttiversio on 1. Kyvykkyysmanifesti voi olla laajempi; mukanaolo ei anna lupaa tai julkista tukea.

Arkaluonteinen tulos​

Lue inputHandlingTags ja outputHandlingTags. contains-provider-credentials merkitsee herkät operaatiot; raakaprofiilit eivät kuulu julkiseen joukkoon. Älä julkaise raakoja asetuksia löytämisesimerkkinä. redacted: true ei tarkoituksella ole tuotavissa takaisin. Yksityisiä osoitteita, isäntiä ja metadataa voi jäädä; tarkista ennen jakamista. Tämä ei ole avainten palautusvarmuuskopio.

Ylläpito-operaatiot​

Repositoriossa on yhdeksän operaatiota obsidian-cli native eval -reitin kautta, kuten polkuun perustuva generointi, luvut, tutkimus, kaaviot ja paikalliskontekstin tarkistus. Työkalu on erillinen; skeemat eivät tee siitä julkista kirjoitus-API:a. npm run cli:help ja CLI-matriisi kuvaavat syötteet/vaikutukset. Polut kuuluvat valittuun holviin; käytä --input-file monimutkaiselle syötteelle.

Virheet ja uusinta​

  • Komento puuttuu: tarkista ladattu versio/holvi ja etsi uudelleen.
  • Tulos puuttuu/virheellinen: tarkista isäntä ja oikeudet, älä kierrätä vanhaa näyttöä.
  • Tukematon skeema/konteksti: pysähdy, älä keksi kenttiä tai korvaa UI-toiminnolla.
  • Herkkä tulos: säilytä paikallisesti, kunnes käsittelyvaatimukset täyttyvät.
  • Ylläpitokirjoitukset: tarkista osatulokset/ristiriidat ennen uusintaa; peruutus ei palauta kirjoituksia tai laskutusta.

Viennit ovat muuttuvia tilannekuvia; tallenna versio ja aika. Muistiinpanot ja mallivastaukset ovat dataa, eivät lupa laajentaa oikeuksia.

Seuraavaksi​