Perangkat lunak yang tenang: mematikan sakelar yang berkedip dan mengajari obrolan menyebut mode yang sedang dipakainya

Tidak setiap rilis adalah kisah perang. Ada yang hanya berupa daftar hal-hal kecil, nyaris tak terlihat, yang diam-diam salah — jenis hal yang tidak membuat apa pun mogok tetapi membuat sebuah aplikasi terasa sedikit tak bisa dipercaya, sedikit gugup, sedikit bukan-milikmu. GeekBye v2.0.3 dan v2.0.5 adalah dua di antaranya. Tanpa fitur baru. Hanya ketenangan.

"Perangkat lunak yang tenang" terdengar seperti suasana hati. Sebenarnya itu tumpukan keputusan yang konkret. Berikut tiga di antaranya.

Sakelar yang tak bisa menentukan pilihan

Ada sebuah sakelar pengaturan — yang mengendalikan pemulihan audio — yang berkedip saat kamu klik. Ketuk untuk menyalakan, dan selama sepersekian detik ia menampilkan nyala, lalu tersentak kembali ke mati, lalu menetap. Gangguan visual mungil, tetapi matamu menangkapnya, dan itu terbaca sebagai aplikasi tidak yakin apa yang sedang dilakukannya.

Penyebabnya adalah balapan antarmuka klasik yang disebut pembaruan optimistis. Saat kamu mengklik sakelar, aplikasi punya dua pilihan: menunggu pengaturan benar-benar tersimpan lalu memperbarui sakelar (benar, tetapi terasa lambat), atau langsung membalik sakelar dan menyimpan di latar belakang (terasa seketika). GeekBye melakukan yang kedua — langsung membalik — tetapi ia juga membaca ulang nilai yang tersimpan saat nilai itu kembali. Jadi urutannya: kamu klik, sakelar menyala secara optimistis, nilai tersimpan yang asli tiba sesaat kemudian, dan selama satu bingkai keduanya bertentangan sehingga sakelar memantul secara kasat mata.

Solusinya adalah membuat nilai optimistis dan nilai terkonfirmasi selaras dengan rapi — sakelar berkomitmen pada keadaan yang kamu pilih dan berhenti meragukan dirinya sendiri saat penyimpanan terkonfirmasi. Bersamaan dengan itu, v2.0.3 melakukan penyuntingan teks yang tidak mentereng: deskripsi pemulihan audio dipangkas agar sejajar dengan baris-baris sekerabatnya, dan kata-kata pengaturan dibuat lebih manusiawi. Tidak satu pun dari ini adalah fitur. Semuanya adalah perbedaan antara panel pengaturan yang terasa dirakit dan yang terasa diperhatikan dengan saksama.

Tur yang tak mau pergi

Tur pengguna baru berguna tepat satu kali. Masalahnya justru pada ke-satu-kali-annya: setelah kamu melihatnya, lapisan orientasi yang tak bisa kamu tutup menjadi kekacauan yang menandakan aplikasi ini masih menganggapmu baru. v2.0.3 memperbaiki kedua ujungnya — tur produk kini bisa disembunyikan, dan jika kamu memang ingin memunculkannya lagi, ada tombol Putar Ulang Tur. Tampilkan saat membantu, menyingkirlah saat tidak, dan biarkan pengguna memanggilnya sesuai kehendaknya. Menghormati bahwa pengguna tidak lagi baru adalah bentuk ketenangannya sendiri yang kecil.

Asisten yang tak mau menyebut cara berpikirnya

Inilah yang benar-benar penting, dan ia terhubung dengan masalah yang lebih dalam yang sedang kami kejar.

Asisten GeekBye menjawab berbeda tergantung konteks. Dalam sebuah rapat, "menurutmu bagaimana soal ini?" seharusnya mendapat jawaban yang bersifat percakapan dan sadar-rapat. Dalam sesi koding, kata-kata yang sama seharusnya mendapat jawaban teknis. Jadi backend menjalankan pertanyaan itu melalui bingkai yang tepat — sebut saja mode rapat atau mode koding — dan pembingkaian itu sungguh-sungguh mengubah jawaban yang kamu terima.

Masalahnya: aplikasi tidak pernah memberi tahu mode mana yang menjawab. Jadi ketika asisten memberimu jawaban bernuansa kode untuk pertanyaan percakapan — atau menjawab pertanyaan kode seolah kamu sedang mengobrol — tampaknya seperti si AI hanya salah. Ia tidak salah; ia sedang dalam mode yang lain, dan kamu tak punya cara untuk melihatnya. Sebuah keadaan tersembunyi membuat perilaku yang benar tampak rusak. (Logika mode itu sendiri adalah pekerjaan yang lebih besar — orkestrator yang memutuskan cara menjawab pertanyaan non-kode selama sesi koding — tetapi semua itu tak ada gunanya bagimu jika kamu tak bisa melihat keputusan yang telah dibuatnya.)

v2.0.5 menambahkan lencana mode baca-saja ke obrolan: label kecil yang menampilkan apakah asisten menjawab dalam mode rapat atau mode koding. Sifatnya yang baca-saja itulah seluruh intinya — ia bukan kendali yang kamu atur, melainkan jendela ke keputusan yang sudah dibuat sistem. Kamu berhenti menebak-nebak mengapa sebuah jawaban terasa janggal; kamu bisa melihat bingkai asalnya.

Detail yang membuat lencana itu jujur

Inilah keputusan rekayasa yang layak diteruskan, karena inilah jenis hal yang membedakan indikator yang sekadar ditempelkan dari yang tepercaya.

Informasi mode datang dari backend sebagai bagian dari respons yang dialirkan — sebuah bingkai mode kecil dalam aliran peristiwa yang dikirim server. Tetapi klien lama yang lebih tua dari fitur ini tak akan tahu apa itu bingkai mode; paling baik ia mengabaikannya, paling buruk ia merender sesuatu yang kacau. Maka klien mengumumkan kemampuannya: ia mengirim header permintaan yang berkata saya tahu cara menampilkan lencana mode, dan backend hanya memancarkan bingkai mode ke klien yang mengirimnya. Klien lama tak pernah menerima sinyal yang tak bisa ditanganinya; klien baru mendapat persis bingkai yang mereka minta.

Ini adalah jabat tangan satu header, dan inilah perbedaan antara "kami menambahkan fitur" dan "kami menambahkan fitur tanpa merusak siapa pun yang belum memperbarui." Penyuntingan tinjauan yang sama memperketat sisa perilakunya: lencana membersihkan dirinya sendiri saat reset dan saat konteks percakapan berubah (label mode yang usang adalah kebohongan kecilnya sendiri), dan ia hanya muncul di tampilan obrolan tempatnya semestinya.

Yang diajarkan dua rilis "tanpa fitur" kepada kami

1. Kegugupan adalah sinyal kepercayaan. Sakelar yang berkedip, tombol yang memantul, label yang bertahan satu bingkai terlalu lama — tak satu pun adalah bug dalam arti mogok, tetapi masing-masing berbisik aplikasi ini tak sepenuhnya terkendali. Ketenangan adalah ketiadaan bisikan-bisikan itu, dan kamu meraihnya satu kondisi balapan demi satu kondisi balapan.
2. Mode tersembunyi membuat perilaku yang benar tampak seperti bug. Asisten melakukan hal yang benar dan malah disalahkan, murni karena pengguna tak bisa melihat bingkainya. Ketika sistemmu membuat keputusan tak kasat mata yang mengubah keluaran, tampilkan keputusan itu — lencana baca-saja sering kali adalah keseluruhan solusinya.
3. Fitur baru seharusnya tak kasat mata bagi klien yang tak bisa memakainya. Jabat tangan header kemampuan berarti sinyal mode hanya menjangkau klien yang bisa merendernya. Kompatibilitas mundur bukanlah pemeriksaan versi yang ditempelkan belakangan; ia adalah klien yang menyatakan apa yang dipahaminya dan server yang menghormati jawaban itu.

Inilah rilis yang tak ditulis siapa pun sebagai tajuk changelog, dan mereka adalah bagian besar dari mengapa GeekBye v2 terasa seperti sekarang. Untuk rilis yang menjadi fondasi ketenangan ini, lihat apa biaya sebenarnya dari sebuah versi 2 (v2.0.0). Untuk kerja keandalan di sampingnya, hari ketika aplikasi kami men-DDoS dirinya sendiri (v2.0.1) dan mengapa pencatat notula AI-mu berhenti merekam di tengah rapat (v2.0.9).