Worktree
초안 격리, 기준 리비전, OT 병합과 AI SDK의 Agent·사용자 검토 연결 원리를 설명합니다.
Worktree는 사람들과 대리인이 아직도 함께 편집할 수 있는 사무실 내용의 고립된 초안을 제공합니다. 대리인은 예산을 개정할 수 있고, 자료를 재구성하거나, 간선이라고 칭하는 사람들 동안 간선을 편집하는 동안 간략한 간결을 재쓰기할 수 있습니다. 초안은 그것의 변화가 간선에 도달하기 전에 검증되고 검토됩니다.
isolation은 문서 내용과 그 변경에 적용되며 Git 작업 디렉토리에 아닙니다. 단일 작업은 여러 단위 단위를 경작 할 수 있습니다. 예를 들어 워크북, 문서 및 프레젠테이션.
격리 원리: 같은 기준에서 독립적으로 진행
Worktree는 기존 단위를 위해 생성될 때, 서비스 기록은 기본 정보로 단위의 현재 간선 개정을 기록합니다. 초안은 그 개정에서 시작하고 그것의 자신의 스냅샷, 변경, 개정, 존재 및 협력 방이 있습니다. 초안에서 한 편집은 간선에 영향을 미치지 않습니다.
| 개념 | 역할 |
|---|---|
| Baseline | 초안 버전은 비교 및 수은에 사용되어 시작되었습니다. |
| Draft head | 새로운 확인 된 초안 개정. 초안 제출은 앞으로 이동. |
| Ready head | 검토하고 합병되는 것을 정의하는 냉동 초안 개정. |
트렁크와 초안은 독립적으로 발전합니다. 각 측면에 대한 개정은 별도의 제출 순서로, 그래서 더 높은 수는 내용이 더 새로운 것을 나타내지 않습니다. 초안을 동기화하는 것은 초안의 자신의 변경을. 새로운 트렁크 편집은 자신의 검토 아래 버전을 입력하지 않습니다; 병합 미리보기와 병합 자체는 두 가지를 재구성합니다.
AI SDK가 같은 초안을 연결하는 방식
AI SDK의 Collaboration Runtime는 1개의 단위의 스냅샷, 변경 집합 및 개정을 처리합니다. Server SDK 측에, Worktree 서비스는 창조, 수명주기 및 merging를 소유합니다. 런타임은 Worktrees와 일하기 위하여 두번째 편집 엔진을 요구하지 않습니다.
이 응용 프로그램은 worktreeID + unitID를 초안의 스냅 샷, 제출, WebSocket 및 세션 티켓 URL로 수정하여 Runtime에 전달합니다. 동일한 검사 및 편집 도구는 트렁크 또는 초안을 대상으로 할 수 있습니다.
하나의 단위 ID는 트렁크에 존재하고 한 번에 여러 워크 트리에서. 대상은 Worktree를 포함해야, 이는 생명, 검사, 실행, 스크린 샷 및 웹 미리보기는 모두 같은 대상을 사용해야합니다. 그렇지 않으면 도구는 초안에서 읽고 트렁크로 쓸 수 있습니다. 웹 클라이언트는 그것을 일치시키는 협업 구성과 동일한 초안을로드합니다.
| 구성 요소 | 역할 |
|---|---|
| Web SDK | 공유 콘텐츠 엔진, 헤드리스 에이전트 작업 및 브라우저에서 편집을위한. |
| Server SDK | 초안 격리, 변경·버전 저장, 상태, OT 병합. |
| AI SDK | 구성 가능한 실행 시간, 검사, API 조회, Facade 실행 및 시각 검사. |
| 앱 | 모델 선택, 대상 매핑, 정체성, 권한 부여, 작업 및 검토 UI. |
Agent 편집에서 전달까지
이 응용 프로그램은 각 에이전트 자신의 Worktree를 제공 하 여 병렬에서 작업을 실행할 수 있습니다. 각 에이전트는 그 초안을 편집 하 고 결과를 표시 하 고 준비를 표시 합니다. 한 사람이 한 번에 초안을 검토 하 고 더 많은 작업을 필요로 하는 초안을 다시 열고, 허용 된 초안을 현재의 트렁크에 병합.
- Worktree를 만들고로드하십시오. 작업 덮개가 있는 단위를 선택하고 Worktree 표적을 연결하고 최신 콘텐츠를 끌어냅니다.
- 검사와 구조 검사를 검사하고, API를 필요에 따라 파악하고, Facades를 통해 변화를 만듭니다.
- 초안에 제출하면 데이터와 계산 결과를 다시 읽고 필요한 경우 스크린 샷을 캡처 할 수 있습니다. 슬라이드는 Layout Lint를 실행할 수 있습니다. 체크가 문제를 보고하면 다시 초안을 편집합니다.
- Mark Ready. 이 각 단위의 초안 개정을 동결하고, 검토가 완료 될 때까지 편집 중지합니다.
- 검토. 받아 들여진 초안을 병합합니다. 한 사람 또는 에이전트가 다시 편집하기 전에 초안을 다시 엽니다. 필요한 초안을 버리십시오.
| 작업 | 효과 |
|---|---|
runtime.commit() | 초안에 제출하고, 초안 개정을 진행합니다. |
markReady() | 트렁크에 아무것도 merging없이 검토 버전을 동결합니다. |
reopenWorktree() | 준비된 뒤에서 초안으로 가져가서 편집이 계속될 수 있습니다. |
mergeWorktree() | 얼어붙은 변화는 트렁크로, 단위로 단위로 변화합니다. |
Commit, Ready 및 Merge는 세 가지 별도의 작업입니다. 초안이 준비되면 사람이거나 에이전트가 다시 열릴 때까지 편집 할 수 없습니다. Runtime과 CLI 사이의 관계를 위해 AI SDK 워크플로우를 참조하십시오.
최신 원본에 변경을 병합하는 원리
트렁크에서 온 단위를 위해, 서비스는 준비된 머리에 baseline에서 초안 변경을 읽고, 그들의 mutations를 수집하고, 간선 협업 서비스를 통해 제출합니다. 트렁크가 기본으로 발전 한 경우 ₢ 킹는 서비스 전에 나중에 트렁크 편집에 대한 그 mutations을 새로운 개정을 확인합니다.
따라서 합병은 편집을 적용합니다; 이전 스냅 샷으로 최신 문서를 대체하지 않습니다. 변환 할 수있는 동시 변경은 재구성됩니다. 변환 할 수없는 변경, 또는 더 이상 적용되지 않는 변경은 처리 할 응용 프로그램에 대한 충돌로 반환됩니다. OT는 모든 사업 불분명에 침입하지 않습니다.
Worktree 내부에 생성 된 단위는 트렁크 기반이 없습니다. 합병은 전체 초안 변경 기록을 복사하지 않고 트렁크에서 만듭니다.
수정 내용과 병합 결과 검토
- 변경된 내용을 보려면 더 보기를 사용하여 준비된 초안 상태와 비교하십시오.
- 메르세데스가 주어진 순간에 무슨 일이 할지 확인하려면, 준비 후
evaluateUnitMerge()로 전화하십시오. 트렁크가 고급 때, 격리 된 런타임은 현재 트렁크에 OT 전환 후보를 적용하고 읽기 전용 미리보기를 생성합니다. 그것은 변경 사항을 제출하고 트렁크와 초안을 수정하지 않습니다.
미리 보기가 요청된 순간에 국가를 설명합니다. 트렁크는 나중에 변경할 수 있고, 실제적인 Merge는 그것이 실행될 때 발견합니다. 몇몇 단위를 합병하는 것은 1개의 원자 거래가 아닙니다, 그래서 1개의 단위가 실패한 경우에, 이미 합병한 단위는 병합됩니다. 각 단위를 위한 결과를 표시하고 개별적으로 취급 실패를 취급하십시오.
통합과 범위
Worktree 클라이언트, 서비스, 엔드포인트 및 데이터베이스 어댑터를 공동 작업 코어와 결합합니다. 별도의 저장을 유지하고, 트렁크와 함께 한 세션 티켓 저장소를 공유하십시오. 응용 프로그램은 초안 액세스 및 트렁크를 별도로 작성합니다. 고립은 자체로 액세스 권한을 부여하지 않습니다.
시트, 도크, 슬라이드, 캔버스 및 관계 테이블이 지원됩니다. PDF는 포함되어 있지 않습니다. 이름 *, 확장 모듈 및 에이전트 통합 가이드는 시작점을 제공합니다.
이 가이드는 어떠셨나요?