AI 댓글

아카이브된 포스트에 AI 기반 분석을 추가합니다. 댓글은 컴퓨터의 AI CLI 도구로 로컬에서 실행하거나, 지원되는 작업은 Social Archiver 서버의 Cloud AI로 실행할 수 있습니다.

개요

AI 댓글은 아카이브된 콘텐츠에 대한 지능적인 분석 — 요약, 팩트체크, 감정 분석 등 — 을 생성합니다. 컴퓨터에 설치된 AI CLI 도구로 로컬에서 실행하거나(아무것도 기기를 떠나지 않습니다), 로컬 실행 환경이 없을 때는 Social Archiver 서버의 Cloud AI로 지원되는 작업을 실행할 수 있습니다.

왜 로컬 AI인가요?

1. 프라이버시: 콘텐츠가 기기를 떠나지 않습니다. 모든 AI 처리는 로컬에서 이루어집니다.
2. 추가 API 비용 없음: 기존 AI CLI 구독을 사용합니다 - 분석당 추가 비용이 없습니다.
3. 완전한 제어: 사용할 AI 모델을 선택하고 프롬프트를 커스터마이즈할 수 있습니다.

AI 댓글을 실행하는 두 가지 방법

AI 댓글은 데스크톱 실행 환경(컴퓨터의 AI CLI 도구)을 통해 로컬로 실행하거나, Cloud AI(Social Archiver 서버)로 실행됩니다. 모바일과 웹은 데스크톱 실행 환경이 열려 있지 않아도 Cloud AI로 지원되는 작업을 완료할 수 있습니다. 아래 AI 댓글이 실행되는 위치를 참고하세요.

AI 댓글이 실행되는 위치

모든 AI 댓글은 **실행 환경(executor)**이 생성합니다. 내 컴퓨터의 로컬 실행 환경을 쓰거나, Social Archiver 서버의 Cloud AI를 사용할 수 있습니다.

로컬 실행 환경

로컬 실행 환경은 내 컴퓨터에 설치한 AI CLI 도구(Claude Code, Codex 또는 Gemini CLI)를 실행합니다. 다음 중 어느 것이든 실행 환경이 될 수 있습니다:

• Obsidian 데스크톱 플러그인 — AI 댓글이 활성화된 데스크톱 Obsidian.
• Social Archiver 데스크톱 앱 — 독립 실행형 데스크톱 앱이 로컬 AI CLI로 AI 댓글 작업을 실행할 수 있으며, Obsidian이 필요하지 않습니다.
• 헤드리스 CLI — sa executor --watch가 터미널에서 대기열의 작업을 실행합니다. 명령줄 (CLI)을 참고하세요.

로컬 실행은 콘텐츠를 기기에 유지하고, 기존 CLI 구독을 사용하며, Social Archiver AI 크레딧을 소비하지 않습니다. 모바일이나 웹에서 보낸 요청은 로컬 실행 환경 중 하나가 가져갈 때까지 대기열에 남습니다.

Cloud AI

Cloud AI는 지원되는 작업을 Social Archiver 서버(Cloudflare Workers AI)에서 실행하므로, 로컬 실행 환경이 열려 있지 않아도 완료됩니다 — 모바일 앱이나 웹에서 유용합니다. Cloud AI는 현재 다음 댓글 작업을 지원합니다:

• Summary (요약)
• Glossary (용어집)
• Translation (번역)

또한 AI 태그 제안도 Cloud AI로 동작합니다(태그 참고). 그 외 댓글 유형 — Fact Check, Critique, Sentiment, Connections, Reformat, Custom — 은 로컬 실행 환경에서만 실행됩니다.

Cloud AI가 로컬 실행과 다른 점:

• 콘텐츠가 서버로 전송됩니다. Cloud AI는 해당 작업에 필요한 아카이브 텍스트를 Cloudflare Workers AI로 보내며, 처음 사용할 때 동의를 요청합니다. 아카이브 텍스트가 기기를 떠나는 것을 원치 않으면 아래의 로컬만 사용을 선택하세요.
• 크레딧. Cloud AI 번역은 플랜의 AI 크레딧을 사용하지만, 로컬 AI는 사용하지 않습니다. 프리미엄 플랜에는 매월 Cloud AI 크레딧이 포함됩니다.
• 길이 제한. 매우 긴 아카이브는 Cloud AI 제한을 초과할 수 있습니다 — 콘텐츠를 나누거나 로컬 실행 환경으로 실행하세요.

실행 모드

모바일 앱의 설정 → AI 실행에서 두 경로를 어떻게 조합할지 제어합니다:

모드	동작
로컬 우선	데스크톱 실행 환경이 가능하면 사용하고, 가능한 fallback 작업만 Cloud AI를 사용
클라우드 우선	지원되는 작업은 Cloud AI를 먼저 사용하고, 데스크톱 로컬로 fallback
로컬만 사용	아카이브 텍스트를 Cloud AI로 보내지 않으며, 데스크톱 실행 환경이 필요

Obsidian Shell Execution 경고

Obsidian 보안 스캔에서 Social Archiver에 Shell Execution 경고가 표시될 수 있습니다. AI 댓글 기능에서는 데스크톱 Obsidian이 선택한 AI CLI를 로컬 프로세스로 실행하므로 정상적인 경고입니다. 명령은 AI 댓글을 켜고 생성을 요청했을 때만 실행되며, 컴퓨터에 이미 설치되어 로그인된 CLI 세션을 사용합니다. 모바일 요청은 작업을 대기열에 넣을 수 있지만, 모바일 Obsidian이 셸 명령을 실행하지는 않습니다. 실제 실행은 연결된 데스크톱 실행 환경에서 이루어집니다.

설정 체크리스트

모바일 앱에서 AI 댓글 설정이 필요하다고 표시되면 아래 항목을 확인하세요:

1. Social Archiver Obsidian 플러그인을 설치하고 모바일 앱과 같은 계정으로 로그인합니다.
2. 데스크톱에 지원되는 AI CLI 중 하나 이상을 설치하고 로그인합니다: Claude Code, Codex, Gemini CLI.
3. 데스크톱 Obsidian에서 설정 → Social Archiver → AI Comments를 열고 Enable AI Comments를 켭니다.
4. 요청을 바로 실행하려면 데스크톱 Obsidian을 열어 둡니다. 오프라인이면 모바일 요청은 데스크톱 플러그인이 다시 연결될 때까지 대기열에 남습니다.

지원되는 AI CLI 도구

다음 CLI 도구 중 최소 하나가 설치되어 있어야 합니다:

도구	제공업체	최적 용도
Claude Code	Anthropic	일반 분석, 웹 검색
Gemini CLI	Google	빠른 응답
Codex	OpenAI	코드 관련 콘텐츠

권장 사항

대부분의 사용자에게 Claude Code를 권장합니다. 가장 쉬운 설정과 팩트체크 및 용어집 기능을 위한 웹 검색 기능이 포함되어 있습니다.

→ AI CLI 설치 가이드에서 자세한 설치 방법을 확인하세요

AI 댓글이 나타나는 조건

AI 댓글은 다음 조건이 모두 충족될 때 사용할 수 있습니다:

1. 데스크톱 실행 환경: macOS, Windows 또는 Linux의 Obsidian에서 AI 댓글이 활성화됨
2. 포스트 아카이브 완료: 콘텐츠가 있는 포스트가 성공적으로 아카이브됨
3. CLI 감지됨: 최소 하나의 AI CLI 도구가 설치 및 인증됨
4. 플랫폼 활성화됨: 설정에서 해당 플랫폼이 제외되지 않음

이 조건들이 충족되면 타임라인 뷰에서 아카이브된 포스트 아래에 "AI 댓글 추가" 배너가 표시됩니다.

로컬 실행 환경이 없어도 Cloud AI는 Summary, Glossary, Translation을 실행할 수 있습니다 — 위의 AI 댓글이 실행되는 위치를 참고하세요.

댓글 유형

Summary (요약)

콘텐츠의 간결한 2-3문장 개요를 생성합니다. 긴 포스트를 빠르게 이해하는 데 좋습니다.

Fact Check (팩트체크)

웹 검색을 사용하여 콘텐츠의 주장을 검증합니다. 주요 주장에 대한 판정과 출처를 반환합니다. Claude Code와 함께 사용할 때 가장 좋습니다 (내장 웹 검색 기능).

Critique (비평)

다음을 포함하는 균형 잡힌 비판적 분석을 얻습니다:

• 주장의 주요 강점
• 잠재적 편향이나 한계
• 고려할 대안적 관점

Sentiment (감정 분석)

콘텐츠의 감정적 톤을 분석합니다:

• 전반적인 감정 (긍정/부정/중립)
• 감정적 지표
• 톤 설명

Glossary (용어집)

콘텐츠의 기술적 또는 전문 용어를 식별하고 설명합니다. 웹 검색을 사용하여 출처와 함께 정확한 정의를 찾습니다. 다음에 적합합니다:

• 기술 기사
• 의학 콘텐츠
• 산업별 전문 용어
• 학술 논문

Connections (연결)

Obsidian vault에서 관련 노트를 찾습니다. AI가 vault를 스캔하고 제안합니다:

• 콘텐츠와 관련된 기존 노트
• 생성할 잠재적인 새 노트
• 추가할 수 있는 위키링크

Vault 통합

Connections는 vault의 메타데이터를 사용하여 관련 노트를 찾습니다. 최상의 결과를 위해 설정에서 "Vault Context"를 활성화하세요.

Reformat (재포맷)

실제 텍스트를 변경하지 않고 아카이브된 콘텐츠의 마크다운 서식을 개선합니다. 다음 경우에 유용합니다:

• 포스트 콘텐츠의 줄바꿈이나 간격이 깨진 경우
• 콘텐츠에 섹션 헤더가 필요한 경우
• 인라인 목록을 적절한 글머리 기호 형식으로 변환해야 하는 경우
• 시각적 계층 구조 개선이 필요한 경우

AI는 원본 텍스트, 링크, 미디어 임베드, 댓글 섹션을 유지하면서 서식(헤더, 목록, 강조)만 수정합니다.

변경 사항 적용

Reformat 댓글을 생성한 후, 적용 버튼(체크 아이콘)을 클릭하여 포스트 본문을 재포맷된 버전으로 교체할 수 있습니다. 원본 콘텐츠는 AI 댓글 기록에 보존됩니다.

Custom (사용자 정의)

전문화된 분석을 위한 자체 프롬프트를 사용합니다. 유형 드롭다운에서 "Custom"을 선택하면 입력 필드가 나타나며, 여기에 콘텐츠에 대한 구체적인 요청이나 질문을 입력할 수 있습니다.

작동 방식

1. "AI 댓글 추가" 클릭: 아카이브된 포스트에 배너 표시
2. 유형 선택: 드롭다운에서 분석 유형 선택
3. 처리 중: AI CLI가 로컬에서 실행 (진행 상황 표시)
4. 결과 저장: 마크다운 파일에 댓글 추가

AI 댓글은 노트의 ## AI Comments 섹션에 저장됩니다:

## AI Comments

### 🤖 Claude · Summary · Dec 16, 2024

이 포스트는 AI가 창작 산업에 미치는 영향에 대해 논의하며,
기회와 도전 모두를 강조합니다...

---

플러그인 설정

설정 → Social Archiver → AI Comments에서 AI 댓글을 구성합니다:

설정	설명
Enable AI Comments	기능 켜기/끄기
Default CLI	여러 개가 설치된 경우 선호하는 AI 도구
Default Type	새 댓글의 기본 분석 유형
Output Language	AI 응답 언어 (Auto, English, Korean 등)
Platform Visibility	AI 댓글 배너를 표시할 플랫폼
Vault Context	Connections 기능을 위한 vault 스캔 활성화

플랫폼 가시성

AI 댓글 배너를 표시할 플랫폼을 제어합니다:

• 소셜 미디어: Facebook, Instagram, X, Threads, TikTok 등
• 블로그/뉴스: Substack, Medium, Tumblr 등
• 비디오/오디오: YouTube, Podcasts
• 특정 플랫폼 제외: 선택한 플랫폼에서 배너 숨기기

웹 공유

AI 댓글은 포스트를 웹에 공유할 때 포함됩니다:

• 댓글은 social-archive.org에서 포스트 콘텐츠 아래에 표시됩니다
• 각 댓글은 AI 도구, 유형, 생성 날짜를 표시합니다
• 긴 댓글은 더 나은 가독성을 위해 접을 수 있습니다

문제 해결

AI 댓글 배너가 나타나지 않음

가능한 원인:

• 모바일 Obsidian 사용 중 (데스크톱 전용)
• AI CLI 도구가 설치되지 않음
• CLI가 인증되지 않음
• 설정에서 플랫폼이 제외됨

해결 방법:

1. claude --version (또는 해당 명령어)으로 CLI 설치 확인
2. 인증 상태 확인
3. CLI 도구 설치 후 Obsidian 재시작
4. 플랫폼 가시성 설정 확인

생성 실패 또는 시간 초과

가능한 원인:

• CLI가 제대로 인증되지 않음
• 네트워크 문제 (웹 검색 기능용)
• 매우 긴 콘텐츠

해결 방법:

• CLI 도구 재인증
• 인터넷 연결 확인
• 더 간단한 분석 유형 시도 (Fact Check 대신 Summary)

결과 품질 저하

해결 방법:

• 다른 AI 도구 시도
• 더 구체적인 프롬프트로 Custom 유형 사용
• 설정에서 출력 언어 지정

프라이버시 및 보안

로컬 처리

AI 댓글을 로컬로 실행하면 모든 AI 처리는 CLI 도구를 사용하여 기기에서 이루어집니다. 콘텐츠는 AI 모델에 의해 처리되지만 API 호출에 필요한 것 이상으로 외부 서버에 저장되지 않습니다.

Cloud AI를 사용하면 해당 작업에 필요한 아카이브 텍스트가 Social Archiver 서버의 Cloudflare Workers AI로 전송됩니다. Cloud AI는 지원되는 작업에 대해서만, 그리고 동의한 경우에만 실행됩니다. 아카이브 텍스트를 기기에 유지하려면 설정 → AI 실행에서 로컬만 사용을 선택하세요.

각 AI 도구에는 자체 개인정보 처리방침이 있습니다:

• Claude Code: Anthropic 개인정보 처리방침
• Gemini CLI: Google 개인정보 처리방침
• Codex: OpenAI 개인정보 처리방침