devswha/patina

AI 포장지를 벗겨내세요. 의미는 그대로 유지합니다.

patina는 한국어, 영어, 중국어, 일본어에서 AI가 작성한 듯한 패턴을 찾아내어, 주장(claim), 숫자, 극성(polarity), 인과관계(causation)를 변경하지 않고 다시 작성합니다. Claude Code, Codex CLI, Cursor, OpenCode의 스킬로 사용하거나 독립적인 Node.js CLI로 실행할 수 있습니다.

이 도구는 블랙박스 방식의 재작성 도구나 AI 탐지 우회(AI-detector bypass) 도구가 아닙니다. patina는 명확하게 패턴 기반이며 감사 가능(auditable)합니다: 무엇이 바뀌었는지, 왜 바뀌었는지, 그리고 원래의 주장이 보존되었는지를 보여줍니다. codex, claude, 또는 gemini CLI 중 하나에 이미 로그인되어 있다면 별도의 API 키가 필요하지 않습니다.

이전 (AI스러운 말투):

커피는 전 세계적으로 사회적 상호작용을 근본적으로 변화시킨 중추적인 문화적 현상으로 부상했습니다. 이 사랑받는 음료는 공동체 형성을 위한 촉매제 역할을 하며, 의미 있는 연결을 촉진하고, 교차 문화적 대화를 용이하게 합니다.

이후 ( /patina --lang en — 동일한 주장 유지, AI 포장 제거):

커피는 사람들이 만나는 방식을 조용히 변화시켰습니다. 누군가의 맞은편에 충분히 오래 앉아 있다 보면, 매우 다른 문화권의 사람들 사이에서도 실제적인 연결과 같은 것이 형성되는 경향이 있습니다.

MPS = 100· 문화적 변화 ✓ · 공동체 형성 ✓ · 의미 있는 연결 ✓ · 교차 문화적 대화 ✓

추가 데모 사례

입력 유형	AI 포장 제거됨	의미 보존됨
한국어 마케팅	“혁신적인 솔루션”, “새로운 패러다임”	30개의 Notion 템플릿, 워크플로우 적합성, 복사 및 편집 사용
...

실행 확인 (영어):

patina.vibetip.help는 브라우저에서 바로 한국어(KO) / 영어(EN) / 중국어(ZH) / 일본어(JA) 문단의 AI 작성 패턴 점수를 매깁니다.

감사 전용입니다. 플레이그라운드는 브라우저 내부에서 결정론적 문체론(deterministic stylometry)을 실행합니다. 텍스트를 재작성하거나, 외부 LLM을 호출하거나, 서버로 API 키를 전송하지 않습니다. 재작성을 원할 때는 아래의 CLI 또는 스킬을 사용하세요.

로컬에서 전체 재작성(rewrite) 시도하기: 30초 터미널 데모. 더 많은 예시: Before/After 갤러리 (한국어). 브랜드 리소스: 로고, 마크, 아이콘, 소셜 프리뷰, 그리고 Before/After 카드. 사용 가이드라인: BRANDING.md.

160개 패턴 |
40 KO + 40 EN + 40 ZH + 40 JA (각 언어별로 8개의 점수 전용 바이럴 훅 포함) — PATTERNS.md 참조 |
편집 핫스팟 회상 (Editing hotspot recall) |
2026-05-22 최신 모델 재기준 설정 (modern-model rebaseline): GPT-5.5 / Claude Sonnet 4.6 / Gemini 2.5 Pro 전반에 걸쳐 67.3% 전체 포착률 [63.5–71.0%] (n=600, KO+EN) |
벤치마크 보고서 |
재현 가능한 ko/en/zh/ja 의심 구역 (suspect-zone) 벤치마크: 개요 · latest.md · latest.json · 2026 재기준 설정 · 탐지기 비교 |
오탐 (False positives) |
2026-05-22 KO+EN 인간 대조군(human controls)에서 16.0% [11.6–21.7%] (n=200); 경계값은 stylometry.md에 문서화되어 있음 — 보고하기 |
모드 (Modes) |
재작성 (rewrite) · 감사 (audit) · 점수 산정 (score) · 차이점 (diff) · 우로보로스 (ouroboros) |
무료 티어 |
예 — 로그인된 codex, claude, 또는 gemini CLI를 통해 사용 가능 (API 키 불필요) |
결정론 (Determinism) |
점수 산정 공식은 결정론적임; LLM 심각도 할당은 실행당 ±8–10점 차이 발생 (scoring.md §8) |
라이선스 |
MIT |

curl -fsSL https://raw.githubusercontent.com/devswha/patina/main/install.sh | bash

설치 프로그램은 patina를 Claude Code, Codex CLI, Cursor, 그리고 OpenCode에 연결합니다. 체크아웃하기 전에 저장소의 HEAD를 구체적인 커밋으로 해결합니다. 완전히 고정된(pinned) 설치가 필요한 경우 PATINA_REF=<태그-또는-전체-SHA>를 설정하세요. 그 다음:

/patina --lang en
[여기에 텍스트를 붙여넣으세요]

특정 어조(tone)로 재작성:

/patina --tone narrative
[여기에 에세이 초안을 붙여넣으세요]

최적의 어조를 자동 감지 및 적용:

/patina --tone auto --lang en
[여기에 텍스트를 붙여넣으세요]

Node.js ≥ 18이 필요합니다. npm 패키지는 공개되어 있으므로 직접 실행할 수 있습니다:

npx patina-cli init --defaults
npx patina-cli doctor
npx patina-cli --lang en input.txt

저장소를 직접 수정(hack)하고 싶을 때:

git clone https://github.com/devswha/patina.git
cd patina && npm install && npm link
patina --lang en input.txt

또는 링크(linking) 후 표준 입력(stdin)을 시도해 보세요:

printf '%s\n' 'Coffee has emerged as a pivotal cultural phenomenon that has fundamentally transformed social interactions across the globe.' \
| patina --lang en --backend codex-cli

🆓

codex, claude, 또는 gemini CLI 중 하나에 로그인되어 있다면 API 키가 필요하지 않습니다. --backend codex-cli | claude-cli | gemini-cli를 사용하여 하나를 선택하거나, --backend claude-cli,codex-cli와 같이 명시적인 폴백 체인 (fallback chain)을 선언하거나, 모델 휴리스틱 (heuristic)에 따라 자동으로 경로를 지정하도록 할 수 있습니다 (--model claude-* → claude-cli 등). 전체 백엔드 (backend) 목록은 AUTHENTICATION.md를 참조하세요.

Patina는 또한 산문 검토 (prose review)를 위한 키가 필요 없는 결정론적 (deterministic) CI 체크 기능을 제공합니다:

# .github/workflows/patina.yml
name: Patina prose score
on:
...

Docker 이미지 게시 (publishing)는 npm 릴리스 경로와 별도로 관리됩니다. GHCR 이미지가 게시될 때까지 컨테이너가 필요한 경우 로컬 이미지를 빌드하여 사용하세요:

docker build -t patina:local .
printf '%s\n' 'Coffee has emerged as a pivotal cultural phenomenon.' \
| docker run --rm -i -e PATINA_API_KEY patina:local --lang en --provider openai

Pre-commit, Husky, Lefthook, Docker 및 릴리스 워크플로 (workflow) 관련 노트는 docs/integrations/에 있습니다.

작가가 AI를 사용하여 초안을 작성하는 것이 허용되면서, 결과물을 편집하고, 무엇이 바뀌었는지 이해하며, 문체를 더 자연스럽게 만들고 싶을 때 Patina를 사용하세요. Patina는 텍스트가 "원래 인간이 작성했음"을 인증하지 않으며, 학술적 명예 규정 (honor-code) 회피, 출판사 공시 우회, 표절 세탁 또는 탐지기 우회 (detector-bypass) 주장 용도로 사용해서는 안 됩니다. 점수는 편집 신호 (editing signals)로서 위양성 (false positives) 및 위음성 (false negatives)이 존재할 수 있으며, 저자성 증명 (authorship proof)이 아닙니다. ETHICS.md를 참조하세요.

patina --lang <ko|en|zh|ja> [mode] [--profile <name>] input.txt

플래그 (Flag)	기능
(기본값)	Rewrite (재작성)
--audit	AI 패턴만 감지
--score	카테고리별 상세 분석을 포함한 0–100 사이의 AI 유사도 점수 산출
--score --exit-on <n>	CI를 엄격하게 유지: overall > n일 때 종료 코드 3 반환 (--gate는 별칭으로 유지됨)
--diff	패턴별 변경 사항 표시
--ouroboros	점수가 수렴할 때까지 재작성 반복 (MPS 롤백 포함)
`--lang <ko	en
--profile <name>	톤 프리셋 (Tone preset): blog, academic, technical, formal, social, email, legal, medical, marketing, narrative, instructional, casual-conversation, code-comment, commit-message, release-notes, namuwiki
--tone <name>	톤 카테고리 (Tone category): casual, professional, academic, narrative, marketing, instructional, auto
--batch	위치 인자(positional args)를 파일 목록으로 처리 (예: --batch docs/*.md)
`--format json	text
--quiet	stderr에 상태, 경고 및 진행 로그 표시를 억제
--json-logs	stderr 로그를 level, event, model, latency_ms 필드를 포함한 NDJSON 형식으로 출력
`--prompt-mode strict	minimal
--variants <1-5>	동일한 사실과 의미 앵커(meaning anchors)를 가진 여러 재작성 변체 생성
--card <path>	AI 점수와 MPS가 포함된 1200×630 SVG 전/후 비교 카드 작성

patina --help를 입력하면 전체 플래그 목록을 확인할 수 있습니다. patina doctor --json은 LLM 호출 없이 Node/백엔드/tmux/API 키 준비 상태를 점검하며, patina init은 프로젝트의 .patina.yaml 파일을 작성합니다.

Markdown 중심의 엔지니어링 워크플로우를 위해 개발자 친화적인 프로필 단축키를 사용할 수 있습니다: code-comment는 인라인 주석/docstring을 다듬고, commit-message는 의도와 검증을 중심으로 Git 히스토리 텍스트를 재작성하며, release-notes는 릴리스 노트를 작성합니다.

변경 로그(changelog)의 불렛 포인트를 마이그레이션 위험이 가시화된 사용자 영향 노트(user-impact notes)로 변환합니다. namuwiki는

한국어 전용이며 라이선스 문제가 없는 위키 스타일의 프로필로, 오직 독자적인 가이드라인만을 사용하며 NamuWiki 문서 텍스트를 복제하지 않습니다.

--score 및 --audit는 --rewrite가 수행하는 것보다 약간 더 넓은 범위의 신호 세트를 측정합니다.

바이럴 훅(viral-hook) 팩(ko/en/zh/ja-viral-hook, 각 8개 패턴: 충격적인 숫자 훅, 클릭베이트형 맺음말, 출처를 건너뛰는 권위 주장, 호흡에 최적화된 짧은 문장 쌓기, 과장된 참여 유도 어휘, 가짜 통계 인용, 나열된 자격 증명, 미래의 자아/준사회적 약속)은 **탐지 전용(detection-only)**입니다.

이들은 score 및 audit 출력에 나타나므로, 벤치마크가 4개 언어 전체에 걸쳐 SNS 스타일의 마케팅 카피에 대한 인간의 직관과 일치하도록 합니다. --rewrite / --diff / --ouroboros는 이러한 신호들이 종종 의도적인 수사(rhetoric)이기 때문에 이를 건너뜁니다. 실제 데모: examples/viral-hook/.

--prompt-mode strict|minimal|auto를 사용하면 전체 패턴 팩(약 34KB의 구조화된 프롬프트)과 압축된 캐주얼 지침(약 3KB) 사이에서 절충할 수 있습니다. auto는 백엔드별로 선택합니다. Gemini는 minimal 모드에서 더 나은 성능을 보이며(긴 구조화된 프롬프트에 의해 과도하게 제약됨), 반면 Claude는 전체 팩을 활용하며, Codex는 대략적으로 민감하지 않습니다. 단독 CLI MAX 재작성 워커(rewrite workers)는 --prompt-mode나 설정에서 재정의하지 않는 한 기본적으로 minimal로 설정되므로, 기본적으로 멀티 후보 실행(multi-candidate runs)이 가볍게 유지됩니다. MAX에서 auto는 후보별로 별도로 결정하는 대신, 배포 전 한 번 결정합니다. case-05에서 A/B 테스트 결과를 문서화했습니다.

--variants <1-5>는 한 번의 호출로 여러 톤 변체(예: V1 캐주얼, V2 직설적, V3 절제된)를 요청합니다. 사실, 숫자, 인과관계는 변체 전반에 걸쳐 동일하게 유지됩니다. 각 결과는 ## Variant N으로 반환되므로 원하는 목소리를 선택할 수 있습니다.

입력이 200자 이하 또는 3문단 이하인 경우, 등록 민감 카테고리(language, style, viral-hook

)은 1.5배의 심각도 승수 (severity multiplier)를 적용받아, 단일 문단에서의 어조 변화가 점수에 드러나게 됩니다. case-04에서는 이러한 변화들이 긴 텍스트 공식 (long-text formula)에 의해 과소 집계된다는 사실을 발견했습니다.

재작성 모드 (rewrite mode)에서 모델은 [BODY] 블록 (또는 --variants > 1일 때 [VARIANT n] 블록)을 감싸는 [SELF_AUDIT] / [/SELF_AUDIT] 태그 내에 자체 감사 노트 (self-audit notes)를 출력합니다. patina는 사용자에게 보여주기 전에 이 감사 내용을 제거하므로, 가공되지 않은 출력 (raw output)은 깔끔합니다. 이전 버전에서는

. 캐시 키 (Cache keys)에는 프롬프트 (prompt), 모델 (model), 온도 (temperature), API 호스트 (API host)가 포함됩니다. --cache-ttl <sec>는 만료 시간을 제어하며, --no-cache는 새로운 실행을 위해 캐시를 우회합니다. Patina는 캐시된 실행이 끝날 때 hit/miss/write 통계를 출력합니다.

--voice-sample <path>를 사용하거나 설정 파일에서 voice-sample: <path>를 사용하여, 사용자가 작성한 1~3개 문단에 재작성 (rewrites)의 기준을 고정할 수 있습니다. 프로필 (profile)과 톤 (tone)은 여전히 요청된 격식 (register)을 설정하며, 샘플은 리듬 (cadence), 구체성 (specificity), 관점 (POV), 문장 질감 (sentence texture)만을 학습시킵니다. 또한 프롬프트는 샘플의 사실 관계를 가져오는 것을 명시적으로 금지합니다.

첫 번째 성공적인 대화형 CLI 실행 시, patina는 stderr로 짧은 GitHub star 요청 메시지를 한 번 출력할 수 있습니다. 이는 절대 stdout으로 출력되지 않으며, CI 또는 non-TTY 스크립트 실행 시에는 건너뛰어집니다. 또한 PATINA_NO_NUDGE=1로 비활성화할 수 있습니다.

--tone은 패턴 재작성 (pattern rewriting) 위에 적용되는 이름이 지정된 보이스 축 (voice axis)을 선택합니다. 우선순위 순서: --tone CLI > tone: 설정 > profile: 설정.