시작하기

설치

설치 프로그램은 GitHub Releases 페이지에 있습니다. 현재 태그된 빌드는 Windows, macOS, Linux용 v1.0.0-rc.7입니다. 이미 toolchain이 갖춰진 환경이라면 소스에서 빌드하는 데도 대략 5분 정도 걸립니다.

사전 요구 사항

Windows에서는 저장소에 포함된 check-setup.ps1가 이 네 가지를 모두 확인하고, 무엇이 빠졌는지 알려 줍니다.

빌드 및 실행

git clone REPO_URL conduit
cd conduit
pnpm install
pnpm dev

pnpm dev는 Vite 개발 서버를 시작한 뒤 데스크톱 셸을 실행합니다. 첫 Rust 빌드는 시간이 좀 걸리지만, 이후 빌드는 점진적으로 빨라집니다.

지원 플랫폼

• Windows 10 / 11 — x86_64, NSIS 설치 프로그램, 관리자 권한 불필요
• macOS 11 Big Sur 이상 — Apple silicon과 Intel용 유니버설 바이너리
• Linux — Ubuntu 20.04+에서 .deb 또는 AppImage 제공, 그 외 배포판은 best-effort

첫 번째 대화

Conduit는 모델에 도달할 방법이 준비되기 전에는 채팅을 시작할 수 없습니다. 첫 실행 시 온보딩에서 제공업체를 고르고 자격 증명을 입력하라는 안내가 나옵니다.

호스팅형 제공업체 사용

1. Settings → Providers & Keys를 엽니다 (⌘,).
2. 원하는 제공업체를 선택하고 API 키를 붙여 넣습니다.
3. Conduit는 해당 제공업체에서 가져온 모델 목록에서 모델을 선택합니다.

키는 Windows Credential Manager, macOS Keychain, Linux Secret Service 같은 운영체제 자격 증명 저장소에 들어갑니다. Settings에는 값이 아닌 참조만 저장됩니다. 키체인이 없는 환경에서는 명시적으로 opt-in하는 암호화 파일 기반 저장소도 사용할 수 있습니다.

키 없이 로컬 모델 사용

Ollama 또는 LM Studio를 설치하고 모델을 받아온 뒤, Settings에서 해당 제공업체를 선택하세요. 자격 증명은 필요 없고 어떤 정보도 컴퓨터 밖으로 나가지 않습니다. 여기에 클라우드 제공업체를 아예 거부하는 로컬 전용 모드를 함께 쓰면 Conduit는 인터넷 요청을 전혀 보내지 않습니다.

모델이 vision을 지원하면 이미지를 첨부할 수 있습니다. 어떤 메시지든 수정해 다시 보낼 수 있습니다. 가장 최근 메시지를 수정하면 그 자리에서 바로 바뀌지만, 그보다 이전 메시지를 수정하면 그 지점부터 새 대화가 포크되고 원본은 그대로 남습니다. 대화는 Markdown 또는 JSON으로 내보낼 수 있습니다.

지원 제공업체

기본 제공되는 제공업체는 17곳입니다. OpenAI 호환 엔드포인트가 그 17번째이며, 별도로 추가되는 것이 아닙니다.

마지막 행은 vLLM, LiteLLM 같은 자체 호스팅 게이트웨이는 물론, 아직 전용 어댑터가 없는 제공업체도 포함합니다. Conduit에 base URL을 주고, 엔드포인트가 요구한다면 키도 함께 제공하면 됩니다.

GPT, Claude, Grok, GLM, Kimi 등 추가하기

Conduit는 2026년 현재 실제로 많이 쓰이는 모델 계열 — GPT, Claude, Gemini, Grok, GLM, DeepSeek, Kimi, Qwen, MiniMax — 과 연결됩니다. 원하는 모델에 따라 다음 세 가지 경로 중 하나를 사용하면 됩니다.

1. 내장 어댑터. Anthropic, OpenAI, Gemini, xAI, Z.ai, Moonshot AI, Qwen, DeepSeek, Mistral, Groq, Together AI, Fireworks AI는 각각 전용 제공업체를 갖고 있습니다. 선택하고 키를 붙여 넣은 뒤 모델 목록을 불러오면 됩니다. 이 경로만으로 Claude, GPT, Gemini, Grok, GLM, Kimi, Qwen, DeepSeek를 바로 다룰 수 있습니다. 각각 자체 기본 엔드포인트를 갖고 있어 base URL을 따로 찾을 필요가 없습니다.
2. 게이트웨이. OpenCode Zen이나 OpenRouter는 MiniMax를 포함해 이들 서비스가 현재 제공하는 모든 것을 하나의 키 뒤에서 카탈로그화합니다. Conduit는 고정된 카탈로그가 아니라 실시간 목록을 가져옵니다.
3. 모든 OpenAI 호환 엔드포인트. 전용 어댑터가 없는 제공업체나 vLLM, SGLang 같은 자체 호스팅 프록시라면, OpenAI 호환 제공업체를 해당 엔드포인트의 base URL로 지정하고 필요하다면 키도 제공하세요.

Qwen의 내장 어댑터는 기본적으로 DashScope의 국제 엔드포인트를 사용하고, Moonshot은 기본적으로 api.moonshot.ai를 사용합니다. 다른 지역이 필요하다면 두 값 모두 수정할 수 있습니다.

키보드 단축키

Windows와 Linux에서는 ⌘ 대신 Ctrl을 사용하세요.

명령 팔레트는 모달 방식입니다. 명령은 >, 아티팩트는 @, 모델은 /를 입력하고, 평문을 입력하면 지금까지 보낸 모든 메시지를 검색합니다. Settings에도 자체 검색창이 시트 상단에 있어서, 섹션을 뒤질 필요 없이 이름으로 바로 특정 설정으로 이동할 수 있습니다.

도구와 커넥터

기본 내장 도구

다음 도구들은 별도 설정이 필요 없습니다:

• 웹 검색과 fetch — Auto / 호스팅형 / 로컬 백엔드(기본값은 키가 필요 없는 Exa, Tavily, Brave, SearXNG, DuckDuckGo, 호스팅형 검색은 Anthropic, OpenAI, Gemini, OpenRouter), 도메인 허용·차단 목록, 인라인 번호 인용
• 문서 작성 — HTML, Markdown, 텍스트 아티팩트 생성 및 수정, 내보내기
• 클립보드 — 시스템 클립보드 읽기 및 쓰기
• 유틸리티 — 계산기, 현재 시간, UUID, 난수

도구는 읽기 전용으로 표시되어 있지 않은 한 실행 전에 확인을 요청합니다. 내장 읽기 전용 도구는 자동으로 실행되고, 커넥터의 도구는 서버가 읽기 전용으로 표시한 경우에만 자동으로 실행됩니다. 그 밖의 도구는 실행 전에 확인을 요청합니다. 웹 검색은 기본적으로 꺼져 있으며 처음 사용할 때 동의를 구합니다. 호스팅형 검색은 Anthropic, OpenAI, Gemini의 공식 엔드포인트에서만 동작하며, 제공업체에 커스텀 base URL을 지정하면 위의 로컬 백엔드로 대체됩니다.로컬 검색 백엔드로 보내는 쿼리는 해당 서비스로 전송됩니다. 기본값인 Exa는 자체 약관에 따라 쿼리를 보관할 수 있습니다.

모델의 페이지 가져오기는 공개 https 사이트에만 닿습니다. localhost나 사용자 네트워크 안의 주소에는 닿지 않으며, 모든 리디렉션을 확인합니다. 원본 HTML 대신 페이지의 제목과 읽기 좋은 텍스트를 돌려주고, 최대 20MB의 PDF도 읽습니다. 텍스트가 없는 스캔 PDF는 읽을 내용이 없는 페이지로 취급됩니다.

MCP 커넥터

Conduit는 Model Context Protocol 서버를 감독되는 커넥터로 실행합니다. 커넥터 페이지에서 시작 명령과 인수를 지정해 로컬 프로세스를 추가하거나, streamable HTTP를 사용하는 원격 MCP 엔드포인트를 지정하면 됩니다.

커넥터의 도구는 서버가 읽기 전용으로 표시한 경우(표준 readOnlyHint 또는 Conduit 자체 필드인 permissionLevel)에만 묻지 않고 실행됩니다. 그 밖의 도구는 먼저 묻고, 승인은 한 채팅 동안 또는 항상 기억하도록 할 수 있습니다. 1.0.0-rc.6 이전에는 대부분의 서드파티 서버에서 도구가 묻지 않고 실행되었으므로, 이미 쓰고 있는 커넥터가 전에는 조용히 실행되던 도구에 대해 이제 확인을 요청할 수 있습니다.

런타임은 비정상 종료된 로컬 서버를 백오프와 함께 재시작하며, 5분 안에 최대 세 번까지로 제한합니다. 동시성도 제한하고 개별 호출은 30초에서 타임아웃됩니다. 도구 출력은 모델에 전달되기 전에 크기가 제한되고 민감한 내용은 가려지며, 구조적 가드가 이 출력이 지시문처럼 재사용되지 않도록 막습니다 — 도구 결과를 거치는 표준적인 prompt injection 경로입니다.

composer는 커넥터의 도구뿐 아니라 prompt와 resource도 끌어올 수 있습니다. prompt 선택기는 prompt가 선언한 인수를 채운 뒤 composer에 넣어 편집할 수 있게 하고, resource 선택기는 다음 메시지에만 콘텐츠를 첨부합니다. 동의는 커넥터마다 한 번 요청되며, 지시를 몰래 끼워 넣으려는 resource는 조용히 따르는 대신 거부되고 이름이 표시됩니다.

내 컴퓨터에서 서버를 연결하는 것은 문서의 문제입니다. 그 서버를 고객 앞에 놓는 것은 — JSON 설정 없이, Claude Desktop 안에 나타나지 않으면서 — 다른 문제입니다. MCP 서버를 고객에게 시연하는 방법에서는 호스팅형 챗, 설정 파일을 쓰는 Claude Desktop, 그리고 데스크톱 클라이언트 배포를 비교합니다.

에이전트 루프

모델이 도구를 호출하면, Conduit는 이를 실행하고 같은 턴 안에서 다음 라운드를 위해 결과를 다시 모델에 전달합니다. Settings → Agent에서 한계를 조정할 수 있습니다. 최대 단계 수는 1~50, wall-clock 예산은 30초~30분입니다. 채팅 UI는 단순한 스피너 대신, 여러 라운드에 걸쳐 사고·도구 호출·텍스트가 실제로 일어난 순서대로 배치된 실시간 진행 타임라인을 경과 시간과 함께 보여주고, 라운드가 멈춰 있으면 그 사실도 알려줍니다.

아티팩트

문서, 스크립트, 작은 웹페이지 같은 긴 출력은 메시지 스크롤을 채우는 대신 대화 옆 패널에서 열립니다. Conduit는 텍스트, 구문 강조가 적용된 코드, 접을 수 있는 JSON 트리, Markdown(Mermaid 다이어그램과 KaTeX 수식 포함), 인터랙티브 HTML을 렌더링합니다.

인터랙티브 HTML은 스크립트만 허용하는 샌드박스 프레임에서 실행됩니다. same-origin 접근, 팝업, 최상위 탐색은 허용되지 않습니다. 폼은 여전히 동작합니다 — Conduit가 페이지에 submit 이벤트를 전달할 뿐, 제출한다고 해서 어디로도 전송되지는 않습니다. 주입되는 콘텐츠 정책은 connect-src 'none'을 설정하므로, 페이지가 스스로 fetch를 하거나 소켓을 열 수 없으며, Conduit는 페이지를 자체 샌드박스 주소에서 제공합니다. 페이지는 애플리케이션 자체의 명령을 호출할 수 없습니다. 한 가지 예외가 있는데, macOS의 알려진 문제입니다. macOS에서는 페이지의 스크립트가 여전히 WebRTC 연결을 열 수 있으며, 콘텐츠 정책은 이를 막지 못합니다. Windows와 Linux는 웹뷰에서 이를 차단합니다. 특정 호스트의 이미지나 폰트를 로드해야 한다면 Settings → Privacy & data의 Artifact Security에서 직접 범위를 넓힐 수 있습니다.

실시간 데이터 — 환율, 날씨 같은 것 — 이 필요한 페이지는 여전히 요청할 수 있습니다. 페이지의 fetch() 호출은 Conduit로 전달되며, 처음 보는 사이트에 대한 요청은 Conduit가 붙잡아 두고 그 사이트 이름을 담은 배너를 보여줍니다. 그 사이트를 한 번만 허용하거나, 이 페이지에서 항상 허용하거나, 아예 허용하지 않거나, 페이지가 어떤 공개 사이트에든 접근하도록 허용할 수 있습니다. 그 뒤 요청은 Conduit가 직접 보냅니다 — https만 허용되고, 쿠키나 자격 증명은 포함되지 않으며, 로컬이나 사설 주소는 제외되고, 타임아웃은 20초, 응답 크기는 5MB, 페이지당 분당 120회로 제한됩니다. 페이지의 지구본 버튼을 누르면 그 페이지가 요청한 모든 사이트와 실제로 보낸 모든 요청이 표시됩니다. 권한은 그 페이지 하나에만 속하며, 페이지를 삭제하면 함께 사라집니다. 로컬 전용 모드는 이 전부를 거부하며, 같은 Artifact Security 설정에 있는 페이지의 인터넷 연결 허용을 끄면 직접 막을 수도 있습니다.

대화에 코드 펜스로 감싼 블록을 붙여 넣으면 Conduit는 이를 아티팩트로 승격할지 제안합니다. 아티팩트는 선택형 메타데이터 sidecar와 함께 디스크로 내보낼 수 있습니다.

각 아티팩트는 현재 페이로드 하나만 보관합니다. 버전 기록은 없으므로, 복사본을 남기고 싶은 내용은 편집 전에 내보내는 것이 좋습니다.

문서

사이드바의 Documents에서 컬렉션을 만들고 파일을 추가하세요. 일반 텍스트, Markdown, CSV, Word(.docx), PDF를 지원합니다. 창의 어디에든 파일을 드롭해서 추가하거나, composer에서 컬렉션 전체를 단일 대화에 첨부할 수도 있습니다. 답변은 근거로 삼은 파일을 클릭 가능한 칩으로 보여주며, 클릭하면 정확한 구절을 확인할 수 있습니다.

각 컬렉션은 OpenAI, Gemini, OpenRouter, Ollama 중 하나의 제공업체로 임베딩됩니다 (Anthropic은 임베딩할 수 없습니다). 색인 작업은 문서 전체 텍스트를 해당 제공업체로 보내므로, Conduit는 처음 사용할 때 동의를 구하고 제공업체별로 그 답을 기억하며, 나중에 문서 페이지에서 철회할 수 있습니다. Ollama를 선택하면 아무것도 기기 밖으로 나가지 않습니다 — 로컬 전용 모드에서는 이 선택이 강제됩니다. 검색 자체는 하이브리드 방식으로, 같은 로컬 SQLite 데이터베이스에서 벡터 유사도 검색과 키워드 검색을 결합하며, 검색된 구절은 여전히 대화에 응답하는 제공업체로도 전달됩니다.

파싱은 기기에서 이루어지며 OCR 단계가 없어서, 텍스트 레이어가 없는 스캔 PDF는 아무것도 만들어내지 못합니다 — 그런 경우 Conduit는 빈 문서를 가져오는 대신 그 사실을 알려줍니다.

이미지 생성

OpenAI, Gemini, OpenRouter는 대화 안에서 바로 이미지를 생성할 수 있습니다. 각 이미지는 제공업체가 과금하므로 Conduit는 첫 이미지를 만들기 전에 한 번 동의를 구합니다. 이미지 생성에 대해 이야기하는 것만으로는 이 확인이 발생하지 않습니다. 결과물은 제공업체에서 링크되는 대신 아티팩트로 로컬에 저장되어 만료되지 않습니다.

개인 앱

간직할 만한 페이지는 개인 앱으로 저장할 수 있습니다. 페이지의 ⋯ 메뉴에서 앱으로 저장을 고르면 복사본이 만들어지고, 이를 탐색 모음의 앱이나 새 채팅 화면의 내 앱에서 열 수 있습니다. 복사본은 채팅을 삭제해도 계속 동작합니다. 저장할 때는 페이지의 사이트 권한 중 무엇을 유지할지 하나씩 묻고, 체크하지 않은 권한은 유지하지 않습니다. 나중에 채팅의 페이지가 바뀌면 앱에 업데이트가 표시됩니다. 기본 내장 스타터 앱이 8개 있으며, 앱 페이지에서 추가하거나 앱이 딸린 아이디어에서 앱 열기를 누르면 됩니다.

페이지(앱이든 채팅 속 페이지든)는 Conduit가 각각 확인하는 세 가지를 더 선언할 수 있습니다. 실행 사이에 데이터를 보관할 수 있습니다 — 페이지당 최대 5 MB이며, 나머지 데이터와 함께 저장되고 저장 시 암호화가 켜져 있으면 암호화됩니다. 데이터 지우기로 삭제할 수 있습니다. 도시 같은 몇 가지 설정을 받을 수 있으며, Conduit가 자체 폼으로 값을 묻고 페이지를 다시 로드하지 않은 채 실행 중인 페이지에 전달합니다. 그리고 해당 페이지에 허용한 뒤에는 AI 모델에 질문할 수 있습니다. 프롬프트에 제공업체 이름이 표시되고 텍스트가 기기 밖으로 나갈 때 알려 주며, 페이지는 텍스트를 보내고 텍스트를 받을 뿐 도구, 채팅 기록, 메모리, 문서에는 접근하지 못합니다.

각 개인 앱에는 자체 설정 페이지가 있습니다(앱 헤더의 톱니바퀴 또는 ⋯ → 설정). 어떤 모델이 답하는지, 하루 토큰 수와 클라우드 모델의 하루 한도(기본 100,000, 내 컴퓨터의 모델은 제한 없음), 저장된 데이터(키별로 보기, 내보내기와 지우기), 사용할 수 있는 사이트와 제공업체, 그리고 한 주 분량의 한 줄짜리 활동 기록을 볼 수 있습니다. 프롬프트, 응답, 저장된 값은 기록되지 않습니다.

슬라이드

이야기를 설명하거나 아무 채팅에서나 프레젠테이션을 요청하면, Conduit가 승인할 수 있는 스토리라인을 작성한 뒤 하나의 라이브 덱을 만듭니다. 모든 변경은 새 복사본을 만드는 대신 그 덱을 직접 수정합니다. 덱은 가운데에 큰 슬라이드, 옆에 채팅이 있는 스튜디오에서 열립니다. 변경을 요청하면 어시스턴트가 슬라이드 한 장을 수정하거나, 덱 전체에서 단어 하나를 바꿉니다.

스크립트는 덱의 모든 글자를 하나의 문서로 보여 줍니다. 여기에서 입력하거나 슬라이드의 텍스트를 더블 클릭해 고칠 수 있습니다. 직접 쓴 텍스트는 어시스턴트가 슬라이드를 다시 써도, 그 텍스트를 바꿔 달라고 요청하지 않는 한 그대로 유지됩니다. 기록은 모든 변경마다 요청 내용으로 이름 붙인 버전을 남겨 언제든 복원할 수 있습니다. 테마는 두 가지가 기본 제공되며, 어시스턴트가 직접 디자인해 주는 테마도 쓸 수 있습니다.

발표는 덱을 전체 화면으로 열고, 별도의 발표자 보기(현재·다음 슬라이드, 발표자 노트, 타이머)는 슬라이드를 공유하는 동안에도 나만 볼 수 있습니다. 내보내기는 어떤 브라우저에서든 스스로 발표되는 단일 HTML 파일, 또는 PDF(Windows에서만)로 저장합니다. 슬라이드는 로컬 데이터베이스에 항목을 추가하므로, 슬라이드 이전 릴리스로 되돌아가면 빈 데이터베이스로 시작합니다(기존 파일은 백업으로 남습니다).

리서치

간단한 검색으로는 부족한 질문이라면 composer의 + 메뉴에서 리서치를 켜고(또는 홈에서 선택하고) 질문하세요. 웹 검색이 켜져 있어야 하며, 로컬 전용 모드에서는 쓸 수 없습니다. 리서치는 로컬 검색 백엔드(Exa, Tavily, Brave, 직접 운영하는 SearXNG, DuckDuckGo)를 사용하고 호스팅형 검색은 쓰지 않습니다. 검색 쿼리는 해당 서비스로, 페이지 텍스트는 선택한 채팅 제공업체로 전송됩니다.

개요. 무엇이든 실행하기 전에 리서치는 개요를 제안합니다. 답할 하위 질문 1~6개, 선택 사항인 범위, 그리고 깊이입니다. 이를 수정한 뒤 승인합니다. 깊이마다 어디까지 진행할 수 있는지가 정해집니다.

• 빠르게 — 최대 검색 8회, 페이지 15개, 10분
• 표준 — 최대 검색 20회, 페이지 40개, 20분
• 심층 — 최대 검색 50회, 페이지 100개, 40분

읽는 것. 페이지를 전체 내용으로, 한 번에 세 개씩 읽습니다. 웹 페이지와 최대 20MB의 PDF가 대상이며, 분석은 사용자 기기에서 이루어집니다. 스캔한 PDF에는 텍스트가 없어 읽을 내용이 없는 페이지로 취급됩니다. 긴 페이지나 PDF에서는 모델이 전체가 아니라 앞부분과 질문에 해당하는 부분을 봅니다.

인용 확인. 모델은 주장을 추려 내고, 각 주장에 페이지에서 뒷받침하는 정확한 문구를 붙입니다. 주장이 인정되려면 그 인용(20자 이상)이 저장된 해당 페이지 텍스트에 실제로 있어야 하며, 이 확인은 모델이 아니라 앱이 합니다. 그런 다음 아직 답이 없는 부분을 다시 검색하고, 작성기가 확인된 주장으로 보고서를 만듭니다. 번호가 붙은 인용과 출처 목록도 모델이 아니라 앱이 만듭니다.

보고서. 결과는 채팅 문서에 저장되는 Markdown 문서입니다. 요약, 하위 질문별 발견, 남은 질문, 번호가 붙은 출처가 들어 있고 모든 발견에 인용이 달립니다. 채팅의 카드에는 요약과 인용·읽은 출처 수가 표시되고 보고서 열기 버튼이 있습니다. 중지하면 실행이 끝나고 그때까지 찾은 내용은 남습니다.

페이지는 명령할 수 없습니다. 페이지 텍스트는 도구가 없는 모델 호출에만 전달되므로, 지시를 끼워 넣으려는 페이지가 있어도 검색, 가져오기, 저장을 하게 만들 수 없습니다. 리서치의 모델 호출은 자체 숨겨진 대화에서 실행됩니다.

워크플로

워크플로 페이지는 반복 작업을 대신 실행합니다. 페이지 가져오기, 웹 검색, 모델의 요약, 질문하기, 결과를 문서로 저장하기를 할 수 있습니다. 준비된 워크플로(아침 브리핑, 페이지 요약, 주제 모니터링)로 시작하거나 단계 편집기에서 직접 만들어 지금 실행하거나 일정에 따라(매일, 평일 정해진 시각, 몇 시간마다) 실행할 수 있습니다. 실행을 열면 각 단계가 무엇을 했는지 볼 수 있고, 단계를 고쳤다면 그 단계부터 다시 실행할 수 있으며 앞선 단계는 다시 실행되지 않습니다.

일정을 켜면 먼저 워크플로가 스스로 해도 되는 모든 일(읽는 사이트, 웹 검색, 사용하는 모델, 문서 저장)이 나열되어 승인을 요청합니다. 수정 이후 등 예약된 실행이 더 많은 권한을 필요로 하면 일시 중지하고 묻습니다. 한 번 허용, 항상 허용, 허용 안 함 중에서 고를 수 있습니다. 각 실행에는 시간과 토큰 한도가 있으며, 진행 중인 실행은 중지할 수 있습니다. Conduit가 닫혀 있는 동안 놓친 실행은 열 때 한 번 실행됩니다.

창을 닫아도 일정이 계속 돌아가게 하려면 Conduit를 트레이에 두고 로그인할 때 트레이에서 시작하게 할 수 있습니다. 둘 다 기본값은 꺼짐이며, 트레이 옵션은 처음 일정을 켤 때 한 번 제안됩니다.

홈

Conduit는 탐색 모음 맨 위의 홈에서 열립니다. 입력 상자 하나로 무엇이든 시작할 수 있습니다. 프레젠테이션을 요청하면 스토리라인과 함께 슬라이드가 열리고, 그 외에는 채팅이 시작됩니다. 그 아래 확인 필요에는 내 확인을 기다리는 워크플로 승인과 질문, 기억 제안이 나열되며(아무것도 없으면 숨겨집니다), 하던 작업 이어가기에는 최근 채팅, 덱, 앱이 표시됩니다. 앱의 각 영역은 실시간 개수가 표시된 타일로 놓여 있고, 비어 있는 영역에는 시도해 볼 예시가 나옵니다.

Ctrl+1부터 Ctrl+9까지(macOS에서는 ⌘)는 홈, 채팅, 앱, 슬라이드, 문서, 라이브러리, 워크플로, 커넥터, 기억을 엽니다. 명령 팔레트에도 각각에 대한 '이동' 항목이 있습니다.

모양과 언어

Conduit는 두 가지 모드를 가진 하나의 디자인입니다. 설정 → 모양에서 어둡게, 밝게, 또는 시스템 설정 따르기를 고르고, 버튼, 선택 영역, 활성 항목에 쓰이는 강조색인 메인 색상을 모드마다 따로 정할 수 있습니다. 읽기 어려운 색은 거부됩니다. 같은 페이지에서 인터페이스 글꼴 크기, 밀도, 다이어그램 크기도 설정합니다.

같은 Settings 화면에서 Conduit가 제공하는 8개 언어 전체에 대해 인터페이스 언어를 설정합니다. 메뉴, 버튼, 날짜, 숫자 표기는 바뀌지만, 어시스턴트가 답변하는 언어는 바뀌지 않습니다.

데이터가 저장되는 위치

Conduit는 모든 것을 플랫폼의 애플리케이션 데이터 디렉터리에 저장합니다. 대화, 메시지, 프롬프트, 사용량은 SQLite 데이터베이스에 들어가고, 첨부 파일과 아티팩트는 해시로 중복 제거되는 content-addressed blob 저장소에 들어갑니다.

메시지는 append-only 이벤트 로그로 기록되고, 그 위에 materialised view가 유지됩니다. 덕분에 응답 도중 앱이 종료되어도 대화가 살아남고, 시작 시 Conduit는 둘을 다시 맞춥니다.

저장 시 선택형 AES-256-GCM 암호화는 Settings → Privacy & data에서 켤 수 있으며, 마스터 키는 OS 키체인으로 래핑됩니다. 기본값은 꺼져 있고 아직 메시지 본문까지는 포함하지 않습니다. 현재 범위는 개인정보 페이지를 참고하세요.

문제 해결

Windows에서 빌드가 실패합니다

대부분은 C++ toolchain 누락입니다. Visual Studio 2022 Build Tools에서 "Desktop development with C++" 워크로드를 설치한 뒤 check-setup.ps1로 확인하세요.

제공업체 키가 저장되지 않습니다

Conduit는 동작하는 OS 자격 증명 저장소가 필요합니다. 헤드리스 또는 최소 구성의 Linux 시스템에서는 Secret Service가 실행 중이 아닐 수 있습니다. 키링 데몬을 시작하거나, 환경 변수를 통해 키를 제공해야 하는 암호화 파일 기반 자격 증명 저장소를 활성화하세요.

Ollama 모델이 나타나지 않습니다

Ollama가 실행 중이고 최소 하나 이상의 모델이 pull되어 있는지, 그리고 Conduit에 설정한 base URL이 Ollama가 실제로 수신 중인 포트와 일치하는지 확인하세요.

그 외 다른 문제가 있습니다

Settings → Diagnostics에서 진단 번들을 내보내 이슈에 첨부하세요. 설계상 비밀 정보, base URL, 허용 목록, 대화 내용은 제외되며, 생성 전에 포함 내용을 확인하도록 요구합니다.

소스 읽기