Zaryn で作業を共有する

コミットは **push** するまで自分のパソコンにあります。push すると Zaryn に送られ、他の人が見たり、プロジェクトを clone したり、自分の作業を送り返したりできます。**pull** は他の人の新しいコミットを取り込みます。 ## ログイン(パソコンごとに一度) **Zaryn が初めてなら**、zev のプロジェクトフォルダーの中でアカウントを作ります: ```bash zev login zaryn.xyz --register your-username --email you@example.com ``` zev が6桁のコードをメールで送るので、求められたら入力します。コードが届く前にターミナルを閉じた場合は、後でこう完了できます: ```bash zev login zaryn.xyz --register your-username --code 123456 ``` **すでにアカウントがある**(ウェブサイトで作った)場合は、ブラウザーでログインします: ```bash zev login zaryn.xyz --device ``` ログイン中のアカウントの確認とログアウト: ```bash zev whoami zev logout ``` ログイン情報は `~/.config/zev/credentials` に保存され、あなただけが読めます。すべての zev コマンドがこれを使うので、トークンを貼り付ける必要はありません。 ## プロジェクトを Zaryn に置く プロジェクトのフォルダーで: ```bash zev new zev push ``` `zev new` は Zaryn にリポジトリを作り、そのアドレスを `origin` という名前の**リモート**として保存します。`zev push` は、何も指定しなければ今いるブランチを `origin` に送ります。プロジェクトは `https://zaryn.xyz/your-username/notes` で見られます。 ## プロジェクトのコピーを取る(clone) ```bash zev clone someone/their-project cd their-project ``` `zev clone` はプロジェクト名のフォルダーを作り、履歴をすべてダウンロードし、ファイルを配置し、`origin` を取得元に設定します。別のフォルダー名や `--branch` も指定できます: ```bash zev clone someone/their-project my-copy --branch dev ``` Zaryn の各リポジトリのページに、コピーできる clone コマンドが表示されています。 clone と pull はまとめて取得します。少ないリクエストで履歴全体が届き(大きなリポジトリでは 4 つ同時)、各ファイルは保存前にハッシュで検証されます。大きなファイルはチャンク単位で届き、次の pull では変更されたチャンクだけを取得します。 ## 最新に保つ(pull) ```bash zev pull ``` `zev pull` は `origin` からブランチの新しいコミットをダウンロードし、ファイルを更新します。 zev はコミットしていない作業を決して上書きしません。変更したファイルが置き換わってしまう場合、`zev pull` はファイルを変更せず、どのファイルが邪魔をしているかを伝えます。新しいコミットは保存されるので何も失われません。変更をコミットするか stash してから、`zev checkout <branch>` を実行してください。 ## チームでの手順 ```bash zev pull # 1. 全員の最新の作業を取り込む # ...ファイルを編集... zev add . zev commit -m "やったこと" # 2. 自分の作業を保存する zev pull # 3. 1 以降の新しいものを取り込む zev push # 4. 共有する ``` 大きな変更は [ブランチ](/docs/ja/branches) で行い、`zev pr` でプルリクエストを開いて、`main` に入る前にレビューしてもらいましょう。 ## リモート *リモート*はリポジトリの別のコピーの、名前付きのアドレスです。 ```bash zev remote zev remote add upstream team/project zev remote show upstream zev remote remove upstream zev push upstream feature-x zev pull upstream main ``` | アドレス | 意味 | |---|---| | `owner/repo` | Zaryn 上のリポジトリ | | `owner/repo@dev` | ... その `dev` ブランチ | | `https://zaryn.xyz/owner/repo` | ブラウザのリンク。リポジトリのどのページでもよく、`?branch=` も引き継がれます | | `example.com/owner/repo` | 別の zev サーバー上のリポジトリ(サイト名で指定) | | `localhost:8090/owner/repo` | 自分の zev サーバー(ポート指定は通常の HTTP) | | `file:///home/me/backup` | このパソコンの別のフォルダー | | `ipfs://<cid>` | IPFS に公開されたスナップショット | SSH のアドレスはまだ使えません。 ## サーバー、CI、AI エージェント 人が操作しないマシンはメールのコードを入力できません。ブラウザーで承認する device 方式を使い、必要な権限だけを与えます: ```bash zev login zaryn.xyz --device --client "build server" ``` または、トークンを環境変数 `ZEV_TOKEN` に(サーバーは `ZEV_SERVER` に)設定します。