diff

Pratinjau perubahan konfigurasi yang tertunda untuk satu harness.

RingkasanCopy Anchor Link

apothem diff --harness NAME [--profile PATH] [--project PATH]
             [--quiet|-q] [--verbose|-v]
             [--format plain|json] [--json] [--no-color]

diff adalah perintah inspeksi hanya-baca. Perintah ini menjalankan materialisasi yang sama dengan yang akan dijalankan perintah install, tetapi dalam mode dry-run — tidak ada yang ditulis ke disk. Untuk setiap target yang tertunda, perintah ini merender sebuah aksi dalam bahasa sederhana (misalnya Write file, Merge directory, Install skills, atau Prune stale files), jalur target, status pratinjau (would create, would update, would remove, atau no change), dan — untuk jangkar milik operator yang akan digabungkan — diff terpadu dari perubahan tersebut. Status dihitung dengan membandingkan sumber dengan target yang saat ini ada di disk, sehingga target yang sudah cocok terbaca no change dan disembunyikan dari tampilan default. Perintah ini menjawab pertanyaan "apa yang akan dilakukan apothem install terhadap harness ini sekarang?" tanpa membuat perubahan tersebut.

Rencana ini mencakup setiap jalur yang ditulis oleh pemasangan: entri manifest, berkas konfigurasi milik harness itu sendiri (misalnya opencode.json atau config.yaml), jangkar instruksi atau dokumen profil tempat profil bersama diproyeksikan (seperti CLAUDE.md), dan penyimpanan data bersama di bawah .apothem/. Tepat setelah pemasangan, diff tidak melaporkan perubahan tertunda apa pun; pemasangan ulang setelah itu tidak menulis apa pun dan tidak membuat cadangan baru. install --dry-run menampilkan rencana yang sama.

Untuk adapter yang menulis skill ke direktori home Anda, rencana mencantumkan folder tersebut beserta jalur home-nya, sebelum berkas proyek, dan folder skill yang tidak ditulis oleh Apothem muncul sebagai peringatan skill_conflict.

Untuk target milik operator — berkas yang membawa konten Anda sendiri sekaligus blok yang dikelola Apothem — diff menampilkan baris persis yang akan berubah. Untuk target lainnya, aksi yang direncanakan dan status pratinjaunya diringkas.

Tampilan default hanya mencantumkan perubahan yang tertunda. Berikan --verbose untuk melihat rencana lengkap, termasuk target yang tidak berubah, yang dianotasi dengan jenis dan hasil operasi internal mentah. Amplop --json tidak terpengaruh oleh lapisan tampilan: amplop ini selalu membawa bidang operation dan outcome mentah untuk konsumen mesin.

diff beroperasi pada satu harness. Tidak seperti install atau verify, perintah ini tidak menerima all; berikan satu nama harness.

OpsiCopy Anchor Link

Keluaran JSONCopy Anchor Link

Amplop --json mencerminkan amplop pemasangan dry-run. status bernilai dry_run, files_written selalu kosong, dan blok materialization beserta daftar results membawa detail lengkap target yang direncanakan. Bidang detail.diff pada setiap baris hasil milik operator membawa string diff terpadu.

{
  "schema_version": 1,
  "status": "dry_run",
  "command": "diff",
  "action": "dry_run",
  "harness": "claude-code",
  "files_written": [],
  "results": [
    {
      "harness": "claude-code",
      "outcome": "updated",
      "operation": "sentinel_merge",
      "path": "C:\\Users\\Example\\.claude\\CLAUDE.md",
      "message": "dry run: no filesystem changes made",
      "detail": {
        "ownership_class": "operator-owned",
        "diff": "--- a/CLAUDE.md\n+++ b/CLAUDE.md\n@@ ..."
      }
    }
  ],
  "warnings": [],
  "error": null,
  "materialization": { "...": "..." }
}

ContohCopy Anchor Link

apothem diff --harness claude-code
apothem diff --harness cursor --project .
apothem diff --harness claude-code --json

Kode keluarCopy Anchor Link

Lihat jugaCopy Anchor Link

• apothem status — melaporkan status pemasangan/verifikasi/penyimpangan di setiap harness
• apothem verify — memverifikasi pemasangan adapter harness
• apothem install — menerapkan perubahan yang dipratinjau