에이전트 릴리즈 설명 정리 · 2026-10-12

원인

공개 에이전트 0.2.40의 릴리즈 설명에서 다운로드가 긴 작업 보고 아래에 있었습니다. 검증 결과와 미검증 항목도 반복했습니다. 전체 체크섬을 본문에 붙여 필요한 설치 안내를 찾기 어려웠습니다.

소스의 Markdown을 정리해도 이미 게시한 Gitea 릴리즈 본문은 자동으로 바뀌지 않습니다. 기존 게시 스크립트도 체크섬 전체를 본문에 덧붙이고 있었습니다.

사용자는 공개 릴리즈 페이지의 에이전트 설명을 읽기 쉽게 정리하도록 요청했습니다. 해당 페이지의 에이전트 릴리즈는 0.2.40 한 개입니다.

해결 방법

공개 에이전트 0.2.40 설명을 실제 게시 본문까지 수정했습니다. 공식 원본의 같은 버전도 같은 구성으로 맞췄습니다.

읽기 순서

1. 다운로드: Windows 설치 프로그램과 macOS·Linux의 CPU별 전체 ZIP을 먼저 보여 줍니다.
2. 설치하기: 회사 연결 정보와 인증서 준비를 설명합니다. Windows와 macOS·Linux의 설치 순서를 나눕니다. 공개 프로그램 ZIP과 직원용 등록 ZIP의 차이도 설명합니다.
3. 이번 버전에서 달라진 점: 공개 설치 파일, 회사별 연결 정보와 브랜드 아이콘을 짧게 설명합니다.
4. 확인한 내용: 빌드·패키지·아이콘 검사와 테스트 결과를 정리합니다. 실제 OS 설치 시험과 1,000대 장기 운영이 미완료라는 범위도 남깁니다.
5. 파일 확인과 소스: 긴 체크섬 목록 대신 SHA256SUMS, VERSION과 빌드 소스의 링크를 제공합니다.

공식 릴리즈의 테스트 수 표기도 기존 빌드 기록에 맞췄습니다. 대상은 24개 패키지이며 첫 검사에서는 23개가 통과했습니다. 캐시 시간 검사 실패와 빌드 종료 후 해당 패키지 전체 재검사 성공을 함께 남겼습니다. 이번 문서 편집에서 Go 테스트를 새로 수행한 것은 아닙니다.

다음 릴리즈의 출력 형식

공개·원본 저장소의 agent-go/pack/release.py가 체크섬 전체를 붙이는 대신 다운로드 링크와 빌드 소스 링크를 붙이도록 수정했습니다. 저장소, 태그와 소스 커밋은 실행 시 결정합니다.

이미 게시된 릴리즈를 거부하는 조건과 초안의 동일 바이트 검사, 업로드 후 전체 다운로드 대조는 그대로 유지했습니다. 기존 0.2.40 본문 편집은 사용자의 요청에 따라 Gitea 본문 필드만 수정한 작업입니다. 빌드·게시 스크립트의 보호 기능을 해제하지 않았습니다.

확인한 결과

확인 항목	결과
게시 본문	공개·공식 릴리즈 2개의 본문이 준비한 Markdown과 일치
공개 화면	1440px와 390px 화면에서 다운로드 표 5행, OS별 설치 절차와 문단 표시 확인. 모바일 본문에 수평 넘침 없음
공개 본문 링크	다운로드·문서·소스 링크 10개를 인증 없이 확인. HTTP 200 응답
공식 보조 링크	VERSION·SHA256SUMS 다운로드 확인. 비공개 빌드 소스 커밋은 인증 API로 존재 확인
기존 첨부파일	두 릴리즈의 첨부파일 각 15개에 대해 ID·파일 이름·크기·다운로드 주소 일치 확인
버전·체크섬	두 릴리즈의 VERSION과 SHA256SUMS를 수정 전후 다시 받아 바이트 일치 확인
태그·메타데이터	태그, 소스 커밋, 릴리즈 ID·이름·게시 상태 보존
다른 릴리즈	공개 타워 2개와 공식 저장소의 다른 에이전트 49개에 대해 본문·태그·첨부파일 정보 보존 확인
게시 스크립트	Python 문법, 저장소·버전에 따른 링크 생성, 게시된 릴리즈에 대한 변경 거부 확인. 보호·업로드 검증 코드가 기존과 동일함도 확인
공개 소스	공개 트리 검사 통과. 운영 파일·개인 키·내장 연결 주소 없음

빌드 소스는 기존 b4ac5dcead6525da44d35aa2ce1557d2b553761c를 유지했습니다. 버전이나 바이너리를 바꾸지 않았습니다. 새 빌드, 새 태그, 운영 타워 승격과 직원 PC 업데이트는 수행하지 않았습니다.

제안사항

다음 릴리즈도 다운로드와 설치 순서를 먼저 안내합니다. 기능 변경과 검증 결과는 별도 문단에 쓰고, 전체 체크섬은 파일 링크로 제공합니다.

이번 설명 정리 때문에 추가 빌드나 버전 변경은 필요하지 않습니다. 기존 릴리즈의 실제 OS 설치 확인과 1,000대 운영 검증은 이번 작업 결과와 구분합니다.

원문: 공개 소스 bc7b082. 문서 갱신일 2026-10-12.