Codian
English | 简体中文
Release
License
Obsidian Version
Codian preview
Codian은 Obsidian을 위한 다중 공급자 AI 에이전트 작업 공간입니다. 볼트를 일회성 컨텍스트로 취급하는 대신, 노트, 폴더, 대화, Skills, 로컬 도구들이 동일한 문제를 중심으로 작동하도록 유지합니다. 사이드바 채팅이나 인라인 편집에서 설치된 에이전트를 사용하면서 각 공급자의 네이티브 인증(authentication), 세션(session), 권한 경계(permission boundaries)를 보존할 수 있으며, 추론(reasoning), 실행(execution), 결과는 모두 볼트에 저장됩니다.
✨ 주요 기능 하이라이트 (Feature Highlights)
-
💬 연속 대화 워크플로우 (Continuous Conversation Workflow): 다중 탭 인터페이스, 저장된 대화 기록, 빠른 세션 검색, 재개(resume), 포크(fork), 되감기(rewind) 및 공급자 네이티브 히스토리 재생. 대화점 탐색 미리보기와 각 프롬프트로의 점프가 가능합니다.
-
✏️ 인라인 편집 (Inline Editing): 활성 에디터에서 실시간 단어 단위 diff 미리보기를 통해 인라인 프롬프트 실행이 가능합니다.
-
📝 실시간 마크다운 컴포저 (Live Markdown Composer): CodeMirror 6의 라이브 미리보기 기능을 기반으로 하며, @note 및 @folder 언급 자동 완성, 드래그 앤 드롭 볼트 항목, 이미지 첨부, 그리고 File Explorer
-
✨ 집중형 진입 경험 (Focused Entry Experience): 빈 채팅방에서는 움직임에 민감한(reduced-motion-aware) 생각 구체 애니메이션이 표시되며, 선호할 경우 기존 탐색 버튼으로 전환할 수 있습니다.
-
🛡️ 개인 정보 보호 및 안전성 (Privacy & Safety): 로컬 제공업체 CLI와 직접 작동합니다. 제3자 원격 측정 서비스(telemetry services)를 사용하지 않습니다.
📦 요구 사항 및 전제 조건 (Requirements & Prerequisites)
- Obsidian: macOS, Linux 또는 Windows용 버전 1.11.4 이상.
- 제공업체 CLI (Provider CLIs): 시스템
$PATH에서 사용할 수 있는 하나 이상의 설치된 제공업체 CLI:
- Node.js: Node.js 24 (소스에서 빌드할 때만 필요).
🚀 설치 (Installation)
옵션 1: Obsidian 커뮤니티 플러그인 (권장)
- Obsidian 설정(Settings) -> **커뮤니티 플러그인(Community plugins)**으로 이동합니다.
- Codian을 검색합니다 (플러그인 ID:
codianz).
- **설치(Install)**를 클릭한 다음, **활성화(Enable)**합니다.
옵션 2: 수동 설치 (릴리스 빌드)
- 최신 GitHub 릴리스에서
main.js, manifest.json, 및 styles.css를 다운로드합니다.
- 볼트의 플러그인 디렉터리:
<vault>/.obsidian/plugins/codianz/을 엽니다 (폴더가 없으면 codianz 폴더를 생성합니다).
- 다운로드한 3개 파일을 해당 폴더에 복사합니다.
- Obsidian을 새로고침하거나 커뮤니티 플러그인 설정에서 Codian을 토글하여 활성화합니다.
옵션 3: 소스에서 빌드 (개발자)
git clone https://github.com/BCS1037/codian.git
cd codian
npm ci
...
생성된 main.js, manifest.json, 및 styles.css를 볼트의 .obsidian/plugins/codianz/ 디렉터리로 복사합니다.
⚙️ 구성 및 제3자 엔드포인트 (Configuration & Third-Party Endpoints)
Codian은 Obsidian 설정 내에서 제공업체에 구애받지 않는(provider-neutral) 구성 컨트롤을 포함하고 있습니다:
- 제3자 Claude 프로필: Anthropic 호환 엔드포인트(예: Alibaba Bailian, Volcengine Ark, China Science & Technology Cloud)를 Claude Provider 탭에 직접 구성할 수 있습니다.
- SecretStorage: API 키 및 인증 토큰은 일반 텍스트 파일로 저장되는 대신 Obsidian의 네이티브 SecretStorage API를 사용하여 안전하게 저장됩니다.
- Provider 연결 설정: 설정 -> Provider -> **연결(Connection)**에서 절대 CLI 실행 파일 경로 또는 제공업체별 매개변수를 구성합니다.
❓ 자주 묻는 질문 및 문제 해결 (Frequently Asked Questions & Troubleshooting)
1. Codian이 "CLI가 감지되지 않았습니다(CLI not detected)"라고 보고하는 이유는 무엇인가요?
macOS GUI 애플리케이션(Finder 또는 Dock을 통해 실행됨)은 셸 설정 파일(예: ~/.zshrc 또는 ~/.bash_profile)에 정의된 환경 변수를 자동으로 상속받지 못합니다.
- 해결 방법: Codian의 설정 -> Provider로 이동하여 대상 Provider를 선택한 후 연결(Connection) 탭에서 **CLI 경로(CLI Path)**에 절대 파일 경로를 입력해야 합니다 (예:
/usr/local/bin/claude 또는 /opt/homebrew/bin/codex).
2. Kimi Code CLI는 어떻게 설정하나요?
Kimi Code CLI는 Codian이 ACP 세션을 시작하기 전에 초기 로그인이 필요합니다.
- 해결 방법: 터미널을 열고
kimi를 실행한 다음, 대화형 인증 프로세스를 완료하십시오. 구성이 완료되면 Codian은 모델을 감지하고 성공적으로 연결할 수 있습니다.
3. 플러그인 ID codianz와 표시 이름 Codian의 차이점은 무엇인가요?
codianz는 Obsidian 커뮤니티 플러그인 레지스트리에 등록된 고유한 내부 플러그인 식별자이며, Codian은 사용자에게 보이는 표시 이름입니다. 항상 볼트의 플러그인 디렉터리 이름이 codianz인지 확인하십시오.
🛠️ 개발 및 검증 (Development & Verification)
Pull Request를 제출하기 전에 CONTRIBUTING.md를 검토해 주십시오. 보안 취약점은 SECURITY.md에 따라 비공개로 보고해 주십시오.
Codian이 유용하다고 느끼셨고, 지속적인 유지보수와 새로운 기능 개발을 지원하고 싶으시다면, Afdian (爱发电)에서 후원해 주셔도 좋습니다.
지원에 감사드립니다! 🙏
🙏 감사의 글 (Acknowledgments)
Codian은 Yishen Tu가 만든 Claudian의 기반 위에 구축되었습니다. Obsidian에 AI 코딩 에이전트를 도입한 선구적인 작업에 대해 Yishen Tu와 Claudian 기여자분들께 깊은 감사를 표합니다.
또한 Codian을 가능하게 만든 모든 오픈 소스 의존성 및 도구의 저자들과 유지보수자들에게도 감사드립니다.
📄 라이선스 (License)
Codian 수정본 및 파생된 소스 코드는 AGPL-3.0 하에 라이선스가 부여됩니다.
상위(Upstream) Claudian 소스 코드는 MIT License를 유지합니다.
Claudian 상위 출처 표시는 NOTICE에서, 타사 구성 요소 공지는 THIRD_PARTY_NOTICES.md에서 확인하십시오.
📢 피드백 및 팔로우 (Feedback & Follow)
피드백은 Issue를 열어 주시거나, WeChat 공식 계정 **「维客笔记」**를 팔로우해 주세요. 문제 해결을 위한 미니멀리스트적인 방법을 탐구하는 데 전념하고 있습니다!