Lewati ke konten utama
Kembali ke Catatan Lapangan
Migrasi Data•8 menit baca

Memindahkan WizNote ke Obsidian Tanpa Kehilangan Data: Membangun Ulang WikiLinks dan Memulihkan Lampiran

Membebaskan catatan yang terkunci dari ekspor satu per satu yang melelahkan dan tautan yang rusak. Bagaimana Shadow Shift mengekspor arsip WizNote secara batch, membangun ulang WikiLinks dua tahap, dan memperbaiki lampiran media untuk Obsidian.

#WizNote ke Obsidian#Ekspor Markdown Batch#Perbaikan WikiLinks#Pemulihan Lampiran#Migrasi Vault#CLI Local-First

Apa yang Terjadi Ketika Satu Dekade Modal Digital Terkunci dalam Silo?

WizNote menjadi platform catatan kesayangan bagi para profesional teknis yang mengumpulkan ribuan artikel selama 5, 8, atau 10 tahun.

Dengan meningkatnya ekosistem graf tautan dua arah yang local-first seperti Obsidian, para pembangun semakin menuntut kedaulatan data yang utuh:

  • Bebas dari keterkuncian vendor: Terbebas dari perubahan harga yang sewenang-wenang, API sinkronisasi yang usang, atau layanan yang dihentikan;
  • Kepemilikan sistem berkas penuh: Setiap dokumen adalah berkas .md teks biasa yang dipasangkan dengan aset lokal asli, mudah dicadangkan atau disinkronkan dengan Git;
  • Graf pengetahuan berdimensi tinggi: Ide-ide yang saling terhubung secara dinamis melalui WikiLinks asli [[Note Title]].

Namun melakukan transisi itu secara historis selalu menghadirkan dinding gesekan manual yang brutal.

Mimpi Buruk Ekspor Default: Penyimpanan Satu Catatan secara Manual yang Menguras Tenaga

Mencoba bermigrasi menggunakan klien resmi WizNote langsung menghadapi rintangan:

  1. Tidak Ada Ekspor Batch yang Sesungguhnya, Hanya Penyimpanan Satu Catatan secara Manual: Antarmuka desktop resmi tidak memiliki pengekspor batch yang nyata untuk struktur direktori kustom. Pengguna lanjutan dengan 3.000 hingga 10.000+ catatan menghadapi prospek suram untuk klik kanan dan menyimpan berkas satu per satu—pekerjaan manual yang menguras jiwa selama berminggu-minggu;
  2. Dokumen Hilang dan Arsip Tidak Lengkap: Ekspor manual rutin melewatkan subfolder atau membeku ketika folder berukuran besar;
  3. Keterkuncian Format: Banyak format catatan (klip web, draf kaya teks) tidak dapat disimpan sebagai markdown standar melalui dialog GUI;
  4. Referensi Antar-Catatan yang Rusak: Tautan internal runtuh menjadi protokol GUID wiz:// milik pihak lain yang sudah mati;
  5. Hilangnya Aset Media: Tangkapan layar, diagram, dan lampiran PDF yang tertanam rusak karena struktur kompresi milik pihak lain.

Solusinya: Pipeline Batch Tanpa Kehilangan Data dari Shadow Shift

Untuk membebaskan brankas pengetahuan pribadi tanpa kerja manual, kami membuat Shadow Shift, sebuah utilitas CLI open source. Terobosan utamanya adalah pemrosesan batch vault penuh secara otomatis:

1. Ekspor Batch Vault Penuh Otomatis (Terobosan Inti)

Melewati keterbatasan UI sisi klien, Shadow Shift berinteraksi langsung dengan basis data SQLite WizNote lokal dan berkas kontainernya:

  • Pemrosesan Batch dengan Satu Perintah: Secara rekursif mengekstrak dan mengonversi ribuan catatan sekaligus dalam hitungan menit;
  • Ekstraksi Format Universal: Kecuali catatan yang secara khusus dikunci dengan kata sandi buatan pengguna (yang memerlukan dekripsi standar di dalam WizNote terlebih dahulu demi keamanan), hampir semua catatan lainnya—teks kaya, Markdown, peta pikiran, dan klip web—diurai dan diekstrak tanpa kehilangan.

2. Invarian Baca-Saja Tanpa Mutasi

Shadow Shift mengakses basis data WizNote lokal dalam mode baca-saja yang ketat. Ia tidak pernah mengubah, memperbarui, atau menghapus data sumber. Semua hasil konversi dikeluarkan ke folder target yang terisolasi (wiznote_obsidian/).

3. Rekonstruksi WikiLinks Dua Tahap

  • Tahap Pertama (Pengindeksan Topologi Graf): Memindai semua GUID dokumen, judul kanonik, dan jalur relatif di dalam memori untuk membangun peta referensi yang komprehensif.
  • Tahap Kedua (Penulisan Ulang Tautan): Menulis ulang tag internal dan referensi relatif yang usang menjadi WikiLinks [[Document Title]] standar Obsidian.

4. Pemulihan Aset Media dan Pipeline “5+2”

Shadow Shift menstandarisasi kebersihan vault melalui pipeline yang deterministik:

  • Mode Standar 5 Langkah: Verifikasi sintaks → Normalisasi format & spasi → Konversi WikiLinks → Perbaikan jalur gambar relatif → Laporan audit migrasi;
  • Mode Lengkap 7 Langkah (`--all`): Memperluas pipeline dengan konsolidasi lampiran terpusat dan penautan ulang aset yang cerdas ke folder khusus attachments/, menjamin tidak ada kehilangan media.

Panduan Cepat

bash
# 1. Clone repository and install dependencies
git clone https://github.com/WardLu/shadow-shift.git
cd shadow-shift
pip3 install -r requirements.txt

# 2. Download and extract local database
python3 tools/wiznote_downloader.py

# 3. Format and rebuild links (all 7 steps)
python3 tools/obsidian_formatter.py --all

# 4. Open the generated wiznote_obsidian folder in Obsidian!

Merasakan Kedaulatan Data yang Sesungguhnya

Menjalankan satu perintah merekonsiliasi puluhan ribu catatan dan aset yang kompleks dalam hitungan menit.

Membuka vault Obsidian baru Anda dan menekan Cmd + G untuk melihat satu dekade ide menyala menjadi konstelasi node yang terhubung adalah perasaan kebebasan digital yang sesungguhnya. Jelajahi kodenya di GitHub!

Catatan Lapangan Lainnya

Semua Catatan Lapangan →