Hubungkan ke layanan ruang kerja yang telah dikonfigurasi

Gunakan Altifigence CLI 0.1.9 di Linux untuk bekerja dengan layanan ruang kerja Digital Design Studio yang sudah ada. Operator Anda menyediakan origin layanan, akses ruang kerja, dan fitur yang diaktifkan. Permintaan ditujukan ke berkas ruang kerja dan eksperimen pada layanan tersebut.

Pastikan status keluar bernilai 0 sebelum membaca hasil yang disimpan. Simpan keluaran kesalahan standar secara terpisah dan periksa bidang hasil yang dijelaskan di bawah ini.

Konfigurasikan koneksi

Atur ALTI_STUDIO_ENDPOINT ke origin yang diberikan operator. Layanan jarak jauh menggunakan HTTPS; layanan IP loopback dapat menggunakan HTTP. Berikan origin dengan jalur kosong dan konfigurasikan ALTI_STUDIO_SERVICE_SECRET yang diberikan operator ketika autentikasi diaktifkan. CLI mengirimkan nilai ini sebagai x-service-secret. Setiap perintah juga dapat memilih origin-nya dengan --endpoint.

Periksa eksperimen dan berkas yang disimpan

Setelah koneksi dikonfigurasi, tampilkan hingga lima eksperimen. Ruang kerja kosong mengembalikan rekaman hasil ilustratif di bawah ini; HTTP 200 keluar dengan kode 0.

alti --json ide service evolve list --limit 5

{"schema":"altifigence.dds.service-receipt.v1","operation":"evolve.list","ok":true,"httpStatus":200,"body":{"runs":[]}}

Untuk hasil yang disimpan, gunakan jalur persisnya di ruang kerja layanan. Ganti jalur contoh ini dengan berkas yang ada di ruang kerja yang boleh Anda akses. Isi respons mempertahankan bidang berkas milik pemiliknya, termasuk content.

alti --json ide service evolve read-file evolve/adder/results/report.md

Cari dan ganti satu berkas yang telah ditinjau

Pencarian teks ruang kerja memerlukan layanan Linux. Lakukan pencarian pada layanan yang sama dengan yang akan Anda gunakan untuk penggantian, lalu tinjau berkas yang cocok, lokasi, dan metadata cakupan. Setiap kecocokan menyertakan contentHash. CLI mempertahankan truncated dan replaceScopeComplete agar Anda dapat menilai cakupan yang dikembalikan.

alti --json ide service workspace search --query old_signal --match-case --whole-word

Simpan berikut ini sebagai replace.json, dengan mengganti hash ilustratif sepanjang 64 karakter dengan contentHash aktual dari kecocokan rtl/top.sv yang dipilih. Pertahankan kueri dan opsi yang sesuai dengan tinjauan Anda. Permintaan ini menargetkan satu berkas; menghilangkan match menerapkan penggantian ke semua kemunculan yang cocok dalam berkas tersebut. Hash yang diharapkan mengikat pembaruan ke versi berkas yang telah Anda tinjau.

{
  "query": "old_signal",
  "replacement": "new_signal",
  "options": {
    "matchCase": true,
    "wholeWord": true
  },
  "paths": [
    "rtl/top.sv"
  ],
  "expectedHashes": {
    "rtl/top.sv": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  }
}

alti --json ide service workspace replace --request replace.json

Pulihkan konflik dan kesalahan konfigurasi

Jika berkas telah berubah, contoh rekaman konflik ditampilkan di bawah ini. HTTP 409 keluar dengan kode 1. Jalankan kembali pencarian pada layanan yang sama, tinjau kecocokan dan versi berkas saat ini, lalu perbarui expectedHashes dengan contentHash terbaru sebelum mengirimkan penggantian baru.

{"schema":"altifigence.dds.service-receipt.v1","operation":"workspace.replace","ok":false,"httpStatus":409,"body":{"ok":false,"code":"search_replace_conflict","conflicts":[{"path":"rtl/top.sv","expectedHash":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","actualHash":"bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"}],"replacements":0,"files":[]}}

STUDIO_ENDPOINT_REQUIRED dengan httpStatus: null keluar dengan kode 2: konfigurasikan origin operator dan jalankan kembali. Untuk HTTP 401, dapatkan rahasia layanan yang sesuai dari operator. Jika terjadi batas waktu setelah penggantian, periksa berkas saat ini dan lakukan pencarian kembali sebelum memutuskan pembaruan lain.