geekjourneyx/obsidian-md2wechat

MD2WeChat Publisher – 무엇입니까

MD2WeChat Publisher 는 Obsidian에서 markdown 기사를 작성한 후, AI 기능을 갖춘 에이전트 (예: Claude, Codex, WorkBuddy) 에게 WeChat에 맞게 포맷을 요청하고, 결과를 옆에 있는 패널에서 실시간으로 미리 보여주며, 이후 외부 md2wechat CLI를 통해 WeChat 공식 계정의 초안을 생성할 수 있게 해주는 Obsidian 데스크톱 플러그인입니다.

중요한 작업 — markdown → WeChat HTML 변환, 이미지 업로드, 초안 생성 — 는 별도의 md2wechat CLI 도구( npm을 통해 전역 설치)가 수행합니다. 플러그인 자체는 Obsidian 내부의 UI와 에이전트 및 md2wechat 스킬과 통신하는 연결 코드만 제공합니다.

---

핵심 기능

기능	작동 방식
작성 및 미리보기 동시 수행	노트 옆에 "공중호환 배치" 패널을 엽니다. 에이전트가 포맷을 완료하면, 미리보기에는 실제로 WeChat으로 전송될 레이아웃이 정확히 표시됩니다.
에이전트 독립적	플러그인은 자체 AI 서비스를 제공하지 않습니다. 표준 obsidian-md2wechat 스킬을 지원하는 로컬 에이전트(예: Claude Code, Codex, WorkBuddy, ZCode 등)라면 어떤 것이든 사용 가능합니다.
게시 전 확인	대상 공식 계정, 썸네일 이미지, 제목, 저자, 요약을 선택합니다. 초안 생성을 클릭한 후에야 플러그인이 md2wechat를 호출하여 실제로 WeChat에 초안을 생성합니다.
버전 인식 초안	어떤 기사, 계정, 버전이 이미 전송되었는지 기록하므로, 과거 초안을 확인하고 중복 제출을 방지할 수 있습니다.
실시간 새로 고침	소스 markdown을 편집한 후 레이아웃 새로 고침을 클릭하면, 동일한 테마/폰트 설정으로 에이전트를 다시 실행하여 새로운 초안을 만들지 않고 미리보기를 업데이트합니다.

---

설치 흐름 (README에 설명됨)

1. md2wechat CLI 설치

   npm install -g @geekjourneyx/md2wechat
   md2wechat version --json
   md2wechat config init --json   # 마법사 실행
   md2wechat config validate --json
   

   CLI는 최소 3.5.0 버전 이상이 필요합니다.
2. Obsidian 플러그인 추가
   • 최신 GitHub 릴리스에서 zip 파일을 다운로드 (소스 아카이브가 아님).
   • 압축 해제 후 md2wechat-publisher 폴더를 <vault>/.obsidian/plugins/에 복사.
   • Obsidian을 재시작하고, 설정 → 제3자 플러그인에서 MD2WeChat Publisher를 활성화.
3. 에이전트 연결
   • Obsidian 공식 명령줄 기능을 활성화.
   • 플러그인 패키지에서 skills/obsidian-md2wechat 디렉터리를 에이전트의 스킬 폴더로 복사.
   • 에이전트가 md2wechat 스킬을 실행할 수 있도록 확인 (내부적으로 CLI를 호출합니다).

---

일반적인 워크플로우

1. 게시할 markdown 노트를 엽니다.
2. 공중호환 배치 사이드 패널을 엽니다.
3. 에이전트에게 말하거나 입력: "Obsidian 현재 기사 포맷하고, 완료되면 보여줘." — 에이전트가 md2wechat 스킬을 실행하여 markdown을 변환하고, 이미지를 업로드한 후 미리보기를 반환합니다.
4. 패널의 더 보기 메뉴에서 테마나 폰트 크기를 조정하거나, 필요 시 포맷된 HTML을 복사합니다.
5. 만족하면 초안 생성을 클릭하고 WeChat 계정과 썸네일 이미지를 선택, 메타데이터를 확인한 후 플러그인이 md2wechat를 호출하여 WeChat 백엔드에 초안을 생성합니다.
6. 패널에는 초안 기록(계정, 타임스탬프, 버전)이 표시됩니다. 나중에 중복 생성 없이 다시 리프레시하거나 재포맷할 수 있습니다.

---

호환성 및 제한 사항

• 지원되는 OS – macOS에서 테스트 완료; Windows/Linux는 아직 검증되지 않음.
• Obsidian 버전 – 데스크톱 1.12.7 이상 필요; 모바일 클라이언트는 지원되지 않음.
• 에이전트 요구 사항 – 로컬 명령 실행과 obsidian-md2wechat 스킬을 지원해야 함. 플러그인은 특정 에이전트를 포함하지 않음.
• 플러그인 내 API 키 없음 – 모든 자격 증명은 md2wechat CLI 설정에서 관리됨.

---

개발 및 기여

• npm ci로 빌드, npm run check로 린트, npm run package로 패키징 (로컬에 md2wechat CLI 필요).
• 릴리스는 자동화됨: 태그(예: v2.0.0)를 푸시하면 GitHub Actions가 작동하여 zip 파일을 생성하고 릴리스 페이지에 업로드.
• 기여는 프로젝트의 AGPL-3.0-Only 라이선스와 dev.md, RELEASE.md, AGENTS.md에 기재된 가이드라인을 따릅니다.

---

TL;DR

MD2WeChat Publisher 는 Obsidian, AI 에이전트, WeChat 공식 계정 게시 파이프라인을 연결하는 다리입니다. markdown으로 작성하고, 로컬 에이전트가 포맷을 처리하며, Obsidian 내에서 미리보기하고, 수동 확인 후 WeChat 초안으로 전송 — 플러그인 내부에 API 키를 노출하지 않고도 가능합니다.