Прескачане към съдържанието

КАК ДА

Review changes and commit

Промени е подходът на Panolayer към diff-овете. Вместо да четете хиляди редове от diff, бързо разберете какво се е променило и вижте кои файлове изискват вниманието ви, оценени от най-висок към най-нисък риск.

Последна актуализация

Прочети като Markdown

Вижте какво изисква преглед

Вижте worktree-овете на агентите си и промените им, които не са комитнати, на едно място. Прегледайте рисковите промени, проучете всичко, което се нуждае от поправка, и направете commit на кода си от страницата Промени.

Това ръководство използва примера на Panolayer с Twitter, twitter-starter. Ако сте следвали Поправете първия си бъг с Panolayer, използвайте тези стъпки, за да прегледате поправката на изтриването.

Екранните снимки и кратките видеа показват няколко промени в същото Twitter приложение, включително промени по форматирането, търсенето, експортирането и запазените публикации. Списъкът ви с файлове, оценките за риск и commit ID-тата ще зависят от работата, която преглеждате. Щракнете върху екранна снимка, за да я разгледате в пълен размер.

Отворете Промени в страничната лента. От дясната страна можете да видите различните worktree-ове и некомитнатия код от агентите си. Изберете worktree, за да видите какво е променил този агент, като файловете са оценени от най-висок към най-нисък риск.

Преминавайте между worktree-овете на агентите си, преглеждайте промените им и правете commit на код от тази страница. Оценките за риск позволяват бързо да видите кои файлове изискват вниманието ви и може да се нуждаят от поправка.

Можете също да изберете съществуващ commit в История, за да прегледате какво е било записано. Ако вече сте обединили поправката на изтриването, намерете я там; обединяването ѝ вече е записало промяната локално.

Прегледайте промените от най-висок към най-нисък риск

Разделът Промени оценява файловете от рискови до без риск и обяснява какво се е променило. Започнете с файловете с най-висок риск, за да разберете какво трябва да се прегледа и евентуално коригира, преди да направите commit.

Превключвайте между Спектър на риска, Ленти на риска и Припокриване, за да разгледате същите промени в три визуални изгледа.

Спектър на риска

Вижте променените файлове, подредени по хоризонтален спектър — от висок риск отляво към нисък риск отдясно.

Спектърът на риска дава визуален преглед на риска в промяна в приложението Twitter.

Ленти на риска

Сравнете файловете като ленти, подредени по риск. Изгледът върви от много рискови към без риск, което улеснява виждането къде промените изискват внимание.

Лентите на риска показват същата промяна в Twitter като поредица от ленти, класирани от най-висок към най-нисък риск.

Припокриване

Вижте къде се припокриват промени в UI, промени в логиката и рискови промени. Групираните файлове показват как тези части от промяната се свързват една с друга.

Припокриването показва кои файлове попадат в групите UI, Логика и Рискови в приложението Twitter.

Прегледайте промяна, която изисква внимание

Обобщението на риска показва къде да насочите прегледа си. Отворете файл, когато искате да разберете конкретна промяна по-подробно.

  1. Изберете файл в графиката или в списъка с променени файлове.
  2. Прочетете пътя му, обобщението на промяната и обяснението на риска.
  3. Изберете Разделен, за да сравните едно до друго, или Вграден, за да четете промените в един изглед.
  4. Проследете промяната през съответната функция и нейните извикващи. Проверете също свързаните тестове, конфигурация и файлове за зависимости.
Тази снимка преглежда промяна в търсенето в app/api/search/route.ts. Diff показва как се е променила SQL заявката.

За поправката на изтриването отворете components/Post.tsx и прегледайте handleDelete(). Проверете как промяната адресира отчетеното условие canDelete и дали потвърждението от потребителя, заявката за изтриване и обработката на успешен отговор все още имат смисъл заедно.

Прегледайте анализа и задайте въпроси относно опасенията

Задълбоченият анализ от Panolayer Agent винаги е достъпен в раздела Промени. Отворете панела Panolayer Agent – Deep Analysis, за да прочетете оценката, опасенията и препратките към изходния код. Проследете дадено опасение до съответния файл, за да разберете какво изисква внимание.

Гледайте: Преглед на анализа на промяна в експорт от Twitter

Съществуващият клип с анализ показва промяна в експортирането в приложението Twitter, като опасенията са свързани със засегнатите файлове.

Използвайте Чат, за да продължите прегледа с Panolayer Agent. Задайте въпрос, свързан с поведението, което проверявате, например:

„Как тази промяна коригира проблема с изтриването и кои тестове покриват очакваното поведение?“

Използвайте отговора, за да разгледате промяната и да проучите всичко неясно.

Четете резултатите от проверката заедно с прегледа

Промените могат да показват резултати от проверката за засегнатите функции. Четете неуспешните правила и всички проверки, които все още са в изчакване или недостъпни, след което проследете обясненията им в кода.

Прегледът на риска ви помага да изберете къде да гледате. Задълбоченият анализ ви дава проблеми за разследване. Проверката отчита проверки спрямо очакванията за поведението на кода. Четете ги заедно с разликите и съответните тестове.

За примера с изтриването проверете, че избраният неуспех е отстранен, и прегледайте новите неуспехи отделно от съществуващите проблеми. Вижте Разбиране на резултат от проверка за полетата на обобщението и статусите.

Стартирайте приложението, когато промяната изисква проверка по време на изпълнение. За тази поправка опитайте да изтриете публикация и проверете дали потвърждаването или отказът се държат както се очаква.

Merge the agent’s work when you’re satisfied

When the agent requests a merge, review the verification summary and confirm the target branch. Choose Not now to keep reviewing, or Merge into main to bring the work into the sample’s main branch.

This is the deletion fix’s verification summary. You decide whether the reviewed work reaches your branch.

The Merged into main confirmation shows the commit ID. This workflow records the agent’s change in local Git history; you do not need to commit that same change again.

Commit any uncommitted edits

Use this step for your own edits or other uncommitted work in the current workspace. If the agent’s merge already saved the change and you have no further edits, continue to History.

  1. Check the full changed-file list.
  2. Review the suggested commit message. Use Edit message if it needs to describe the change more clearly.
  3. Choose Commit to save the changes to the local branch. Choose Commit & Push if you also want to send the commit to a configured remote.
The existing toolbar capture shows a search fix awaiting a commit. The same controls apply to uncommitted changes in your active workspace.

A Panolayer commit includes every changed file in the workspace. Use Git directly if you need to stage only part of the change. Read any reported check failures before deciding to commit; a commit can still be created when checks fail.

Confirm the result in History

Open History and find the new commit using its message, author, and commit ID. Select it to inspect the recorded change, then return to Working tree to check for remaining uncommitted edits.

Watch: Confirm a Twitter saved-post change in merge confirmation and History

This existing clip follows a saved-post change in the Twitter app. Use the commit ID from your own merge confirmation to find your change.

For the deletion fix, you should be able to find its recorded change and inspect the files that landed. Check that no unexpected uncommitted edits remain.

Push when you’re ready to share the commit

A merge or commit saves work locally. To send an existing local commit to your Git remote, open Git and choose Push.

Pushing requires a configured remote and permission to write to it. If the sample has no remote, the local commit completes this walkthrough. If a push reports an error, read it and resolve the remote or sign-in problem before trying again.

Use your Git host for pull requests and team review.