처음 쓰는 법

회사 PC(Windows) · 클래식 Outlook 기준입니다. 설치할 것은 없습니다.

어느 컴퓨터에서 실행하나요

회사 Outlook 을 쓰는 그 회사 PC 에서 실행합니다. 클래식 Outlook 이 설치되어 있고 회사 계정으로 로그인되어 있어야 합니다.
수집기는 그 PC 의 Outlook 에게 메일을 물어서 읽습니다. 그래서 Outlook 이 없는 집 PC · 개인 노트북에서는 메일을 읽을 수 없습니다.
메일은 그 PC 밖으로 나가지 않습니다. 보고서 화면(브라우저)도 같은 PC 에서 열립니다.
Outlook 은 평소처럼 켜 두면 됩니다. 수집기는 켜져 있는 Outlook 에 붙어서 읽고, 꺼져 있으면 「Outlook 을 먼저 켜 주세요」라고 알려 줍니다.

처음 한 번 — 무엇을 읽는지만 확인(-ListOnly)

저장하지 않고 어떤 데이터 파일 · 폴더를 읽는지, 이번 주 메일이 폴더마다 몇 통인지만 보여 줍니다.

Outlook 이 켜져 있는지 확인합니다.
압축을 푼 폴더를 탐색기로 엽니다.
탐색기 위쪽 주소창을 누르고 powershell 이라고 치고 Enter — 검은(파란) 창이 그 폴더에서 열립니다.

아래 한 줄을 붙여 넣고 Enter:

powershell -NoProfile -ExecutionPolicy Bypass -File .\collector\Collect-OutlookMail.ps1 -Mode weekly -ListOnly

「1) 이번 주 · 2) 지난 주」를 물으면 번호를 누르고 Enter.
화면에 나온 데이터 파일 이름 · 폴더 목록 · 폴더별 메일 수와 걸린 시간, 오류가 있으면 그 문장을 알려 주세요. 메일 내용은 보내지 마세요.

읽는 범위: 회사 메일 계정(Online)은 받은 편지함 · 보낸 편지함 두 폴더만, .pst(Local 백업)는 모든 폴더를 읽습니다. 받은 편지함 아래 하위 폴더까지 읽으려면 collector\수집설정.txt 의 Online폴더= 를 받은보낸하위 로 바꿔 주세요.

다섯 단계

ZIP 받기 — 전체 파일 ZIP(로그인 필요 없음).
차단 해제 후 압축 풀기 — 받은 data09-27-main.zip 을 오른쪽 클릭 → 「속성」 → 아래쪽 「차단 해제」 체크 → 「확인」. 그다음 「압축 풀기」로 원하는 곳(예: 문서\업무보고)에 풉니다. 차단 해제를 잊었으면 다음 단계에서 「Windows 의 PC 보호」 창이 뜹니다 — 「추가 정보 → 실행」을 누르면 됩니다.
클래식 Outlook 켜 두기 — 평소처럼 켜 두면 됩니다. Online 사서함과 백업 .pst(왼쪽 목록의 데이터 파일)가 보이면 됩니다.
주간보고.bat 더블클릭(월간은 월간보고.bat) — 검은 창에서 「1) 이번 주 · 2) 지난 주」 중 번호를 누르고 Enter. 폴더별 메일 수가 나오며 모읍니다.
보고서 만들기 — 다 모으면 브라우저에 이 도구가 열립니다. 「보고서 만들기」를 누르고, 「06 보고서」에서 「확인 필요」 표시를 살핀 뒤 Word · Excel · 인쇄로 내려받습니다.

팀원 → 파트리더 → 팀장 → 담당 임원

모두 — 「01 보고 설정」에서 작성자 이름 · 보고 단위(예: 디자인팀 A파트)와 보고 단계(팀원 · 파트리더 · 팀장 · 임원)를 한 번 정합니다.
팀원 — 위 다섯 단계로 내 보고서를 만들고, 「06 보고서」에서 「보고서 파일(.json) — 파트리더에게」를 눌러 내려받습니다. 뜨는 안내 창대로 Outlook 새 메일(또는 회신)에 그 파일을 첨부해 보냅니다.
파트리더 — 평소처럼 주간보고.bat 로 메일을 모으면 팀원이 보낸 보고서 파일을 받은 메일 첨부에서 찾아 줍니다. 「08 보고서 취합」에서 「받은 메일에서 찾은 보고서 파일 N개 불러오기」를 누릅니다(공유 폴더로 받은 파일은 직접 골라도 됩니다). 같은 주간보고 양식으로 한 장이 되고, 문장 앞에 [보고자 이름]이 붙습니다. 확인한 뒤 「취합 보고서 파일(.json) — 팀장에게」로 내려받아 메일로 보냅니다.
팀장 — 파트리더들의 취합 파일을 같은 방법으로 불러와 팀 보고서를 만듭니다. 담당 임원에게는 「08」 아래쪽의 「임원 보고용(요약)」(Word)을 씁니다 — 임시 양식이며, 실제 임원 보고 양식을 받으면 그 모양으로 맞춥니다.

보고서 파일을 메일로 보내기

보고서 파일(.json)을 내려받으면 안내 창이 뜹니다. 파일은 브라우저의 「다운로드」 폴더에 있습니다.
Outlook 에서 새 메일을 열거나 보고 요청 메일에 「회신」 → 「파일 첨부」로 그 파일을 고릅니다(메일 창으로 끌어다 놓아도 됩니다).
안내 창의 「제목을 채운 새 메일 열기」는 제목 · 본문만 채웁니다. 메일 링크(mailto)로는 파일을 첨부할 수 없어서 파일은 직접 첨부해 주세요.
받는 사람은 주간보고.bat 로 모으기만 하면 됩니다. 수집기는 첨부 .json 중 이 도구가 만든 보고서 파일만 알아보고, 첨부저장=아니오 로 두어도 이 파일은 남깁니다.

기간이 다른 파일은 빼고 알려 줍니다. 「확인 필요」 표시는 보고한 사람이 붙인 그대로 올라갑니다. 보고서 파일에는 보고 문장과 근거 메일의 날짜 · 제목만 들어 있고, 메일 본문 · 첨부 글은 들어 있지 않습니다. 서버 없이 파일로만 주고받습니다.

AI — 사내 LLM 을 권합니다

회사에 사내 LLM 이 있으면 「01 보고 설정 → AI 연결 설정」에 주소(…/v1)를 적어 주세요. 모델 이름 칸에는 답변받은 qwen3.8 이 미리 들어 있습니다. 주소를 넣고 「모델 목록 불러오기」를 누르면 서버에 올라간 정확한 이름을 확인할 수 있습니다(예: Ollama 는 qwen3:8b 처럼 적음 — 표기만 다르면 서버 이름으로 바꿔 줍니다). 「04 실적 · 계획 · 이슈」에서 버튼 한 번으로 보내고, 메일 내용이 사내망 밖으로 나가지 않습니다. 주소 · 모델 이름은 사내 IT(또는 LLM 담당)에 물어 보면 됩니다. 키가 필요하면 그 칸에만 적습니다(코드 · 파일에 남기지 않음).

Qwen3 는 답 앞에 생각하는 부분(<think>…</think>)을 붙여 보낼 수 있습니다. 도구가 그 부분을 떼고 답만 읽습니다(붙여 넣은 답도 같음). 설정하지 않아도 규칙 분류로 보고서는 만들어집니다. AI 는 다듬기용입니다.

막힐 때

증상	할 일
「이 시스템에서 스크립트를 실행할 수 없으므로…」	.bat 는 이 파일 하나만 허용해 실행합니다. 그래도 막히면 회사 정책으로 잠긴 것이니 IT 담당에 「PowerShell 스크립트 실행 허용」을 문의해 주세요.
「다른 프로그램이 Outlook 의 전자 메일 주소 정보에 액세스하려고 합니다」	Outlook 보안 확인 창입니다. 「허용」에 체크하고 시간(예: 10분)을 골라 「허용」.
「Outlook 이 꺼져 있습니다」	Outlook 을 켜고 메일이 보이면 창을 닫고 다시 실행해 주세요. 수집기는 Outlook 을 새로 띄우지 않습니다.
「Outlook 에 연결하지 못했습니다」	Outlook 오른쪽 위 「새 Outlook」 스위치를 끄고 다시 실행 · .bat 를 관리자 권한으로 실행하지 않기 · Outlook 을 한 번 켜서 메일이 보이는지 확인.
브라우저가 자동으로 안 열려요	수집 폴더(문서\업무보고_수집\…)의 `보고서_열기.html` 을 크롬 · 엣지로 열거나, 도구에서 「수집 폴더 열기」로 그 폴더를 골라 주세요.
.pst 메일이 안 들어와요	Outlook 왼쪽에 그 데이터 파일이 열려 있어야 합니다(평소처럼 열어 두면 됩니다). 아니면 `collector\수집설정.txt` 의 `PST폴더=` 에 .pst 가 있는 폴더를 적어 주세요.
받은 편지함 아래 폴더의 메일이 안 들어와요	회사 메일 계정은 받은 편지함 · 보낸 편지함 두 폴더만 읽는 것이 기본입니다. `collector\수집설정.txt` 의 `Online폴더=받은보낸하위` 로 바꾸면 하위 폴더까지 읽습니다.
「08」에 받은 메일의 보고서 파일이 안 보여요	그 메일이 모은 기간 안에 받은 편지함으로 왔는지 확인해 주세요(지난주에 받았다면 「2) 지난 주」로 모으기). 첨부 이름이 .json 이고 이 도구에서 내려받은 파일이어야 합니다. 안 되면 첨부를 저장해 「보고서 파일 고르기」로 직접 넣어 주세요.
보고서 파일을 넣었는데 빠졌어요	「08 보고서 취합」은 기간(주간 · 월간 · 날짜)이 같은 파일만 합칩니다. 빠진 이유가 화면에 나옵니다. 보낸 사람에게 같은 기간으로 다시 만들어 달라고 해 주세요.
빼고 싶은 폴더가 있어요	`collector\수집설정.txt` 의 `제외폴더=` 에 이름을 쉼표로 더해 주세요. 지운 편지함 · 정크 메일은 늘 뺍니다.

메일은 어디로 가나요

수집기는 Outlook 에서 읽기만 하고(옮기기 · 지우기 · 읽음 표시 · 보내기 없음), 인터넷에 연결하지 않습니다.
모은 메일 · 첨부는 내 PC 의 수집 폴더(기본 문서\업무보고_수집)에만 있습니다. 필요 없으면 그 폴더를 지우면 됩니다.
이 도구는 브라우저 안에서만 읽습니다. 밖으로 나가는 경우는 「01 보고 설정 → AI 연결 설정」에 AI 서버 주소를 직접 넣고 보낼 때뿐입니다(사내 LLM 이면 사내망 안).
보고서 파일(.json)은 내가 직접 메일에 첨부하거나 공유 폴더에 둘 때만 전달됩니다. 이 도구가 보내지 않습니다.