Table of Contents
문제 제보와 기여
설치하거나 사용하는 중에 불편한 점이 있다면 알려 주세요. 문제를 제보하거나 문서를 고치는 일도 프로젝트에 도움이 됩니다.
문제를 알려 주세요
저장소의 이슈에 다음 내용을 적어 주시면 문제를 확인하기 쉽습니다.
- 사용한 프로그램과 버전: 타워인지 에이전트인지 알려 주세요.
- PC 환경: 운영체제와 CPU 종류를 적어 주세요.
- 실행 순서: 문제가 생기기 전까지 어떤 작업을 했는지 설명해 주세요.
- 기대한 결과와 실제 결과: 오류 문구가 있다면 함께 적어 주세요.
직원 이름, 파일 원문, 등록 키, 암호화 키, DB와 원본 운영 로그는 올리지 말아 주세요. 보안 문제는 보안 제보 안내를 먼저 확인해 주세요.
문서를 개선하고 싶다면
처음 읽는 사람이 어디에서 무엇을 누르는지, 어떤 결과가 나오면 성공인지 알 수 있도록 작성해 주세요.
한 문단에는 하나의 주제를 담고, 문단 사이에는 빈 줄을 넣습니다. 절차는 번호 목록으로 정리합니다. 짧고 자연스러운 문장을 사용하고, 필요한 전문 용어는 용어 설명에 풀어 씁니다.
소스 공개, 파일 다운로드, 실제 PC 검증, 앞으로의 목표는 서로 구분해 주세요. 과거 보고서를 다듬을 때도 당시 날짜와 시험 결과는 유지합니다.
코드를 개선하고 싶다면
- 작업 브랜치를 만듭니다.
- 필요한 부분을 수정합니다.
- 개발 안내에 따라 변경 범위에 맞는 검사를 실행합니다.
- 한국어 커밋 메시지로 변경을 기록합니다.
- 변경 내용과 검사 결과를 함께 제안합니다.
탐지 결과와 실패·처리 기록은 보존해야 합니다. 검증 실패를 성공으로 표시하거나 AI의 판단을 사람의 최종 판정으로 기록하는 변경은 허용하지 않습니다. 발췌와 추가 문맥의 길이는 기존 sample_context_chars 정책을 사용합니다.
배포 파일을 만들 때
모든 에이전트 빌드에 승인된 브랜드 아이콘을 포함합니다. Windows에서는 실행 파일·설치기·제거기의 실제 아이콘을 검사합니다. macOS와 Linux에서는 패키지 리소스를 검사합니다.
설치기나 아이콘을 바꾸면 해당 OS에서 창, 트레이, 바로가기와 제거 동작을 직접 확인해야 합니다.
에이전트 버전이 올라가면 새 태그와 릴리즈를 게시합니다. Windows 설치 파일, 지원 OS·CPU의 전체 패키지, VERSION, 최종 SHA256SUMS를 포함해 주세요. 이미 공개한 바이너리나 태그는 덮어쓰지 않습니다.
릴리즈 도구는 agent-go/pack/verify-release.py와 release.py입니다. 기본 게시 대상은 이 공개 저장소입니다. 인증 토큰은 비밀 환경변수로 전달합니다. 현재 모든 릴리즈를 자동으로 게시하는 CI는 구성하지 않았습니다.
원문: 공개 소스 cedbd06. 문서 갱신일 2026-10-12.