osFoundry / Platform
Catatan — Diagram
Diagram Mermaid hidup di samping sumbernya. Edit di satu sisi, render di sisi lain.
Apa itu
Notes (Diagram) adalah bidang penulisan Mermaid di dalam Notes osFoundry. Diagram Mermaid didefinisikan dalam teks biasa (flowchart, diagram sekuens, diagram kelas, mesin status, diagram ER, diagram Gantt), dan fitur ini menyimpan teks tersebut beserta gambar hasil rendernya dalam satu catatan yang sama. Anda mengedit kode di satu sisi dan diagram dirender di sisi lain, sehingga definisi dan hasilnya tidak pernah menyimpang.
Karena diagram disimpan sebagai kode sumbernya, bukan sebagai gambar yang diekspor, diagram tetap menjadi bagian dari teks catatan. Anda bisa mem-diff-nya, menyalinnya, menyerahkannya ke agen, atau menempelkannya ke catatan lain tanpa kehilangan kemampuan untuk mengedit. Tidak ada yang diratakan menjadi tangkapan layar yang harus digambar ulang untuk diubah. Ubah satu panah di kode dan hasil render langsung mencerminkannya, dan itulah yang membuat iterasi pada diagram menjadi cepat, bukan pekerjaan yang merepotkan.
Semua ini berada di dalam osFoundry, workspace desktop bring-your-own-key tempat chat, agen, aplikasi, kode, dan pengetahuan berbagi satu tempat. Notes bersifat local-first, jadi diagram yang Anda sketsakan (sebuah arsitektur, sebuah proses, sebuah model data) tetap berada di perangkat Anda kecuali Anda memilih sebaliknya. Dan karena osFoundry menjalankan model apa pun yang Anda bawa kuncinya sendiri, agen di dalam workspace dapat menyusun atau merevisi kode Mermaid langsung di catatan, dan Anda melihatnya dirender pada saat itu juga.
Kemampuan utama
- Tulis diagram Mermaid di sebuah catatan dan lihat hasilnya dirender berdampingan: kode di satu sisi, gambar di sisi lain
- Perubahan pada kode diagram merender ulang gambar saat Anda mengetik, sehingga iterasi pada sebuah alur atau sekuens berlangsung seketika
- Diagram disimpan sebagai teks sumbernya, bukan gambar yang dibakukan, sehingga tetap bisa diedit, di-diff, dan disalin
- Mendukung tipe yang dicakup Mermaid: flowchart, sekuens, kelas, status, ER, dan Gantt
- Notes yang local-first menyimpan kode sumber diagram Anda di perangkat Anda; agen yang Anda jalankan dengan kunci Anda sendiri dapat menyusun atau merevisi Mermaid secara langsung
Kasus penggunaan
- Engineer: mendokumentasikan alur permintaan sebuah layanan sebagai diagram sekuens Mermaid di catatan dan menyesuaikan kode seiring perubahan desain
- Penulis teknis: menjaga flowchart arsitektur tetap sejalan dengan dokumen yang menjelaskannya, dengan mengedit kode alih-alih mengekspor ulang gambar
- Team lead: membuat sketsa lini masa proyek sebagai diagram Gantt dan meminta agen workspace memperbarui kode Mermaid saat tanggal bergeser
Pertanyaan yang sering diajukan
Tipe diagram Mermaid apa saja yang bisa saya render?
Set standar Mermaid: flowchart, diagram sekuens, diagram kelas, diagram status, diagram entity-relationship, dan diagram Gantt. Anda menulisnya dalam sintaks teks Mermaid dan catatan merendernya secara langsung.
Apakah diagram disimpan sebagai gambar atau sebagai teks yang bisa diedit?
Sebagai teks. Kode sumber Mermaid berada di dalam catatan, dan hasil render dihasilkan dari kode itu. Artinya Anda selalu bisa kembali mengedit definisinya alih-alih menggambar ulang gambar statis, dan kode ikut berpindah bersama catatan saat Anda menyalinnya.
Bisakah agen AI menuliskan diagram untuk saya?
Bisa. osFoundry adalah workspace bring-your-own-key, jadi agen yang berjalan pada model yang Anda hubungkan dapat menghasilkan atau merevisi kode Mermaid di dalam catatan. Karena diagram berupa teks sumber, apa pun yang ditulis agen akan dirender sama seperti hasil editan Anda sendiri.