Bekerja dengan Merge dalam Git

Dalam blog minggu ini, saya ingin berkongsi pemikiran dan pengalaman saya selepas menamatkan makmal saya iaitu tentang bekerja dengan git merge.

Strategi Gabungan Git

Selepas melengkapkan makmal baru-baru ini yang memfokuskan untuk bekerja dengan Git, saya mendapat pemahaman yang lebih mendalam tentang dua strategi gabungan utama yang digunakan Git: Cantuman rekursif (rekursif-ort) ke hadapan pantas dan 3 hala.

• Gabungan ke hadapan pantas: Ini berlaku apabila cawangan utama tidak mempunyai komitmen baharu sejak cawangan ciri dicipta. Dalam senario ini, Git hanya mengalihkan penuding cawangan utama ke hadapan kepada komit terkini daripada cawangan ciri. Jenis cantuman ini tidak mewujudkan komit cantuman yang berasingan, menjadikannya mudah dan linear.

• Gabungan rekursif 3 hala: Pendekatan ini digunakan apabila kedua-dua cawangan utama dan cawangan ciri mempunyai komit mencapah. Git mengira nenek moyang yang sama dan cuba menggabungkan perubahan dari kedua-dua cabang. Konflik mungkin timbul jika perubahan telah dibuat pada baris atau fail yang sama di kedua-dua cawangan, memerlukan penyelesaian manual. Pada mulanya, saya mendapat tanggapan bahawa konflik akan sentiasa berlaku apabila mengubah suai fail yang sama merentas cawangan yang berbeza. Walau bagaimanapun, konflik hanya berlaku apabila baris kod yang sama ditukar dalam kedua-dua cawangan.

Pelaksanaan Makmal: Gabungan Cawangan Ciri

Untuk makmal ini, saya berusaha menambah dua ciri pada repositori saya, VShell, yang melibatkan penciptaan cawangan berasingan untuk setiap ciri. Ciri-ciri ini direka bentuk untuk meningkatkan kefungsian alat dengan menyokong berbilang fail input/folder dan output penstriman.

Ciri 1: Sokong Berbilang Fail dan Folder - isu-15:

Ciri pertama melibatkan membolehkan alat memproses berbilang fail dan laluan folder secara serentak. Sebelum ini, alat ini hanya mengendalikan input fail individu, tetapi dengan peningkatan ini, pengguna kini boleh menghantar berbilang fail atau direktori sebagai hujah. Semua fail dalam direktori diproses.

Untuk melaksanakan ini, saya melanjutkan logik sedia ada untuk mengulangi kandungan folder, menukar laluan fail kepada laluan mutlak dan menyimpan semua fail yang berkaitan dalam tatasusunan. Coretan yang berkaitan:

files.forEach((file) => {
    // convert a file path to an absolute path
const filePath = path.resolve(file);
...
const directoryFiles = fs
          .readdirSync(filePath)
          .map((f) => path.join(filePath, f));
allFiles = allFiles.concat(directoryFiles);
...
const results = allFiles.map((file) => {
    process.stderr.write(`Debug: Processing file: ${file}. \n`);
    return fs.readFileSync(file, "utf-8");
});
return results.join("\n");
}

Kod ini memastikan bahawa kedua-dua fail individu dan semua fail dalam direktori diproses dengan sewajarnya.

Ciri 2: Menstrim Respons ke Stdout - issue-16:

Ciri kedua menambahkan sokongan penstriman pada alat, membolehkan output masa nyata respons kepada stdout menggunakan bendera -s/--stream. Ini merupakan peningkatan yang ketara berbanding pelaksanaan sebelumnya, dengan respons hanya ditulis pada fail output atau dipaparkan sepenuhnya setelah pemprosesan selesai.

Untuk mencapai matlamat ini, saya memperkenalkan lelaran tak segerak menggunakan gelung for wait...of untuk mengendalikan ketulan data semasa ia distrim. Selain itu, saya menjejaki penggunaan token dalam masa nyata, kerana maklumat token hanya tersedia dalam bahagian respons akhir. Inilah logik terasnya:

if (options.stream) {
// Handle streaming response
const { response, tokenInfo } = await readStream(chatCompletion);
return { response, tokenInfo };
}

async function readStream(stream) {
  let response = "";
  let tokenInfo;
  for await (const chunk of stream) {
    const content = chunk.choices[0]?.delta?.content;
    if (content) {
      process.stdout.write(content);
      response += content;
    }
    // The last chunk will contain the usage information
    if (chunk?.x_groq?.usage) {
      // Retrieve Token Usage from Response
      const usage = chunk?.x_groq?.usage;
      const promptToken = usage?.prompt_tokens || 0;
      const completionToken = usage?.completion_tokens || 0;
      const totalToken = usage?.total_tokens || 0;
      tokenInfo = { promptToken, completionToken, totalToken };
    }
  }
  return { response, tokenInfo };
}

Nota:

Pendekatan penstriman masa nyata memerlukan pelarasan dalam penjejakan token, berbanding kaedah yang lebih mudah digunakan untuk respons tidak distrim, di mana data penggunaan boleh diakses terus.

Untuk penstriman, objek penggunaan token hanya boleh diakses selepas memproses bahagian terakhir dalam gelung.

// The last chunk will contain the usage information
if (chunk?.x_groq?.usage) {
  // Retrieve Token Usage from Response
  const usage = chunk?.x_groq?.usage;
  ...
}

Secara lalai, apabila menggunakan bendera -s/--stream tanpa menyatakan fail output melalui -o/--output, respons akan distrim dan dipaparkan dalam konsol dalam masa nyata. Walau bagaimanapun, jika pengguna ingin mengeksport respons kepada fail, mereka boleh menentukan fail output menggunakan bendera -o/--output.

Proses Gabung dan Strategi Gabungan Git

Selepas melengkapkan kedua-dua ciri, saya memulakan proses cantuman, bermula dengan menggabungkan Ciri 1 ke dalam cawangan utama, diikuti dengan Ciri 2. Memandangkan ciri dibangunkan dalam fail berasingan, tiada konflik berlaku semasa proses cantum. Walau bagaimanapun, Git menggunakan strategi gabungan ORT (Ostensibly Recursive's Twin), yang merupakan lalai bermula dari Git 2.34. Strategi ORT ialah penulisan semula strategi gabungan rekursif klasik, menawarkan prestasi dan ketepatan yang lebih baik dalam mengendalikan senario gabungan yang kompleks.

Cincangan komit gabungan terakhir saya ialah: 286e23c

Atas ialah kandungan terperinci Bekerja dengan Merge dalam Git. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!