Skip to content

Obsidian

I-connect ang iyong Triggerfish agent sa isa o higit pang Obsidian vaults para makapagbasa, makagawa, at makahanap ng notes. Dina-directly access ng integration ang vaults sa filesystem -- hindi kailangan ng Obsidian app o plugin.

Ano ang Ginagawa Nito

Binibigyan ng Obsidian integration ang iyong agent ng mga tools na ito:

ToolPaglalarawan
obsidian_readBasahin ang content at frontmatter ng note
obsidian_writeGumawa o mag-update ng note
obsidian_listIlista ang notes sa isang folder
obsidian_searchMaghanap sa note contents
obsidian_dailyBasahin o gumawa ng daily note ngayon
obsidian_linksI-resolve ang wikilinks at maghanap ng backlinks
obsidian_deleteMag-delete ng note

Setup

Step 1: I-connect ang Iyong Vault

bash
triggerfish connect obsidian

Nagpo-prompt ito para sa iyong vault path at isinusulat ang config. Maaari mo ring manual na i-configure.

Step 2: I-configure sa triggerfish.yaml

yaml
obsidian:
  vaults:
    main:
      vaultPath: ~/Obsidian/MainVault
      defaultClassification: INTERNAL
      excludeFolders:
        - .obsidian
        - .trash
      folderClassifications:
        "Private/Health": CONFIDENTIAL
        "Private/Finance": RESTRICTED
        "Work": INTERNAL
        "Public": PUBLIC
OptionTypeRequiredPaglalarawan
vaultPathstringOoAbsolute path sa Obsidian vault root
defaultClassificationstringHindiDefault classification para sa notes (default: INTERNAL)
excludeFoldersstring[]HindiMga folders na iignore (default: .obsidian, .trash)
folderClassificationsobjectHindiI-map ang folder paths sa classification levels

Maramihang Vault

Maaari kang mag-connect ng maramihang vaults na may iba't ibang classification levels:

yaml
obsidian:
  vaults:
    personal:
      vaultPath: ~/Obsidian/Personal
      defaultClassification: CONFIDENTIAL
    work:
      vaultPath: ~/Obsidian/Work
      defaultClassification: INTERNAL
    public:
      vaultPath: ~/Obsidian/PublicNotes
      defaultClassification: PUBLIC

Folder-Based Classification

Nag-i-inherit ng classification ang notes mula sa kanilang folder. Ang pinaka-specific na tumutugmang folder ang nananaig:

yaml
folderClassifications:
  "Private": CONFIDENTIAL
  "Private/Health": RESTRICTED
  "Work": INTERNAL

Sa config na ito:

  • Private/todo.md ay CONFIDENTIAL
  • Private/Health/records.md ay RESTRICTED
  • Work/project.md ay INTERNAL
  • notes.md (vault root) ay gumagamit ng defaultClassification

Naa-apply ang classification gating: mababasa lang ng agent ang notes na ang classification level ay dumadaloy sa kasalukuyang session taint. Hindi maaaring mag-access ng CONFIDENTIAL notes ang PUBLIC-tainted session.

Security

Path Confinement

Lahat ng file operations ay nakakulong sa vault root. Gumagamit ang adapter ng Deno.realPath para i-resolve ang symlinks at pigilan ang path traversal attacks. Anumang pagtatangkang basahin ang ../../etc/passwd o katulad ay bina-block bago mahawakan ang filesystem.

Vault Verification

Bine-verify ng adapter na may .obsidian/ directory sa vault root bago tanggapin ang path. Sinisiguro nito na nakaturo ka sa aktwal na Obsidian vault, hindi sa arbitrary directory.

Classification Enforcement

  • Nagdadala ng classification ang notes mula sa kanilang folder mapping
  • Ang pagbasa ng CONFIDENTIAL note ay nag-e-escalate ng session taint sa CONFIDENTIAL
  • Pinipigilan ng no-write-down rule ang pagsulat ng classified content sa lower-classified folders
  • Lahat ng note operations ay dumadaan sa standard policy hooks

Naiintindihan ng adapter ang [[wikilink]] syntax ng Obsidian. Nire-resolve ng obsidian_links tool ang wikilinks sa aktwal na file paths at hinahanap ang lahat ng notes na nagli-link pabalik sa isang partikular na note (backlinks).

Mga Daily Note

Binabasa o ginagawa ng obsidian_daily tool ang daily note ngayon gamit ang daily note folder convention ng iyong vault. Kung wala ang note, gumagawa ito ng isa na may default template.

Frontmatter

Ang notes na may YAML frontmatter ay awtomatikong pina-parse. Available ang frontmatter fields bilang metadata kapag nagbabasa ng notes. Pini-preserve ng adapter ang frontmatter kapag nagsusulat o nag-a-update ng notes.