DAP App & Plugin Docs

v1.7.0 개발 미리보기 · 2026-11-04 확인

공개 안정판은 v1.6.26입니다. v1.7.0은 개발 브랜치에 통합된 체크포인트이며 아직 공개 설치본이 없습니다. 이 페이지의 정식 데스크톱 플러그인 API와 아래 개발 기능을 혼용하지 않습니다.

• 작업창에서 Workspace와 Crew를 전환하며 실행과 입력 초안을 유지하는 흐름을 준비합니다.
• 현재 친구와 연결된 Claude·Codex·Antigravity 구독 모델 선택, 친구의 말투·개인 기억과 프로젝트별 업무 기록을 다룹니다.
• Crew의 프로젝트·최근 목록·worktree·파일/코드·Git·터미널·협업 전달과 기존 Feyn 학습 흐름을 포함합니다.
• Core 연결과 일부 협업은 미리보기입니다. 원격 SSH, 전체 Herdr 기능 동등성, 모든 제공자/OS의 실사용 검증 완료를 의미하지 않습니다.

원본 화면 복구·입력 보호 관련 개발 실험이 모두 공개 설치본에 포함됐다고 해석하지 마세요. 공개 버전·배포 산출물과 검증 범위가 확인되기 전에는 정식 API나 다운로드로 안내하지 않습니다.

플랫폼 지원 변경

새 설치 파일은 Windows와 macOS Apple Silicon을 대상으로 합니다. macOS Intel(x64)의 마지막 릴리스는 v1.6.26이며, v1.7.0부터 Intel 패키지를 제공하지 않습니다. 사이트의 활성 다운로드·최신 체크섬에서도 Intel 항목을 제거했습니다. 이전 릴리스 기록은 보존합니다.

확인 근거: 본체 개발 커밋 9b4d72b941의 패키징 설정과 v1.7.0 릴리스 검증 기록. 개발 상태와 지원 정책에서 정식/개발 범위를 확인하세요.

DAP Workspace · 1.6.25 / 1.6.26

대화·프로젝트 세션·도구·플러그인·자동화와 실행 승인·취소를 한 작업창에서 이어갑니다. 입력창의 작은 에이전트 표시와 기존 DAP 설정에서 Claude/Codex CLI 연결을 관리하며, 기존 인증·대화 저장 위치를 유지합니다.

세션 삭제/복원, 프로젝트 이동, 다른 대화에 세션 참조 첨부를 지원합니다. agent-desktop·REA·Ghidra·Java를 번들로 포함하며, 창을 최소화하거나 닫으면 바탕화면 펫으로 돌아갑니다.

1.6.26은 첫 번들 준비 대기 한도를 3분으로 조정하고, 시작 실패 시 원래 오류와 다시 시작 버튼을 유지합니다. 재시도는 기존 프로세스 종료·재연결을 기다려 중복 실행을 막습니다.

Workspace 시작·플랫폼·재시도 가이드에서 공개 안정판의 기능과 검증 범위를 확인하세요. 이 페이지의 plugin.yaml / ctx.host.*는 기존 데스크톱 플러그인 계약이며, Workspace 내부 도구 API를 임의로 뜻하지 않습니다.

앱 보관함과 App UI System v1

DAP 1.6.15부터 사용자 화면에서는 설치형 플러그인을 앱으로 안내합니다. 기술 계약은 기존 plugin.yaml, activate(ctx), ctx.host.*를 유지합니다. 앱 UI 시스템과 manifest 버전은 별개입니다.

앱 찾기에서 설치하기 · DAP 1.6.17+

1. 펫의 전체 메뉴에서 앱 보관함을 열고, 검색창 옆 가방 아이콘으로 앱 찾기에 들어갑니다.
2. 이름·기능으로 검색하거나 카테고리로 좁힙니다. 이미 설치한 앱에는 설치됨이 표시됩니다.
3. 받기에서 앱 이름·버전·요청 권한을 먼저 확인합니다. 다시 받기를 선택하면 설치하고, 취소하면 설치하지 않습니다.
4. 내 앱에서는 설정·활성화·업데이트를 관리하고, 웹 · 프로그램에서는 사용자 바로가기를 관리합니다.

기본 보관함 단축키는 Windows Ctrl+Alt+M, macOS Cmd+Option+A입니다. 기존 플러그인 단축키와 충돌하면 설정에서 재지정하거나 펫 전체 메뉴를 사용하세요. 앱 보관함의 dock은 최대 6개를 고정하며 드래그·보조 클릭·키보드 조작을 제공합니다.

새 앱의 화면 작성

DAP 1.6.15+에서는 ctx.host.windows.openPalette() 앱 창과 ctx.trayPanel.register() 위젯에 DAP 토큰·공통 foundation을 자동 주입합니다. 기존 CSS는 유지하며 presentation·투명 canvas에는 주입하지 않습니다. 외부 글꼴이나 색상 패키지를 추가할 필요가 없습니다.

<main class="dap-app">
  <header class="dap-app-header">
    <div class="dap-app-title"><h1>내 앱</h1></div>
  </header>
  <section class="dap-app-content dap-stack">
    <div class="dap-card">콘텐츠</div>
    <p role="status" aria-live="polite">준비됨</p>
  </section>
</main>

App UI System v1 전체 가이드에서 셸·버튼·폼·탭·상태 클래스, 의미 토큰과 제작 검사 명령을 확인하세요. 최소 320px, 키보드, light/dark, 빈 데이터·로딩·실패 상태를 확인합니다. 호스트 bridge와 보안 규칙은 기존 palette/tray 계약을 따릅니다.

Overview

DAP 플러그인은 plugin.yaml과 자기완결 ESM .mjs 진입 파일로 구성됩니다. manifest에는 메타데이터와 권한만 선언하고, 기능 등록은 activate(ctx)에서 수행합니다.

Quickstart

1. 폴더 만들기

my-plugin/
  plugin.yaml
  dap_my_plugin/
    plugin.mjs
  README.md

2. manifest 작성

id: com.example.my_plugin
name: My Plugin
version: 1.0.0
manifest_version: 2
entry: dap_my_plugin.plugin:activate
description: DAP에서 실행되는 첫 플러그인
author: Your Name
min_app_version: "1.4.1"
surface: user
permissions: []
execution_modes:
  - user

3. 액션 등록

// dap_my_plugin/plugin.mjs
export function activate(ctx) {
  ctx.actions.registerAction({
    id: "hello",
    callback: () => {
      ctx.host.bubble.speak("Hello from plugin");
      return "Hello from plugin";
    },
  });

  ctx.radialMenu.addItem({
    itemId: "hello",
    label: "Hello",
    actionId: "hello",
    priority: 50,
  });
}

4. 로컬 설치

Windows:
%APPDATA%\dap\plugins\com.example.my_plugin\

macOS:
~/Library/Application Support/dap/plugins/com.example.my_plugin/

진입 파일은 bare import가 없는 자기완결 .mjs여야 합니다. 로컬 폴더를 설치 경로에 둔 뒤 DAP을 재시작하거나 설정의 플러그인 토글을 다시 켜서 로드합니다.

Core concepts

Guides

명령 등록하기

채팅 또는 스팟라이트 입력을 자연어로 라우팅해야 할 때 ctx.commands를 사용합니다.

ctx.commands.addCommand({
  id: "weather",
  title: "날씨",
  matchers: [
    { type: "keyword", patterns: ["날씨", "weather"], priority: 40 },
  ],
  backend: { type: "builtin", handler: "dap.weather.current" },
});

설정 섹션 추가하기

ctx.settings.registerSettingsSection({
  sectionId: "general",
  title: "My Plugin",
  spec: {
    fields: [
      { key: "compact", label: "간단히 보기", type: "toggle", default: false },
      { key: "mode", label: "모드", type: "select", default: "fast",
        options: [
          { value: "fast", label: "빠르게" },
          { value: "careful", label: "정교하게" },
        ] },
      { key: "note", label: "메모", type: "text" },
    ],
  },
});

const values = ctx.host.settings.values("general");
ctx.host.settings.set("general", "compact", true);

트레이 허브 패널 등록하기

surface_slots: [tray_panel]과 window.palette 권한을 manifest에 선언한 뒤 등록합니다. 패널은 샌드박스 iframe이며 최대 64KB의 JSON형 메시지만 주고받습니다.

# plugin.yaml
permissions:
  - window.palette
surface_slots:
  - tray_panel

const panel = ctx.trayPanel.register({
  id: "status",
  page: "tray/index.html",
  height: 210,
  priority: 10,
});

panel.onMessage((message) => {
  if (message?.type === "refresh") refresh();
});
panel.postMessage({ type: "status", items });

컴팩트 패널 권장 높이는 120–240px입니다. 상세 화면은 ctx.host.windows.openPalette()로 분리하고, 일반 트레이 액션은 ctx.trayMenu.addItem({ showInContextMenu: true })로 명시합니다.

팔레트 UI 열기

팔레트는 플러그인 전용 HTML UI입니다. 페이지는 권한 API를 직접 받지 않고 window.dapPalette 메시지 브리지만 사용합니다.

export function activate(ctx) {
  let palette = null;

  const open = () => {
    if (palette && !palette.isDestroyed()) {
      palette.toggle();
      return;
    }

    palette = ctx.host.windows.openPalette({
      page: "palette/index.html",
      width: 360,
      height: 520,
      frame: false,
    });

    palette.onMessage((msg) => {
      if (msg.type === "ready") {
        palette.postMessage({ type: "items", items: ["A", "B"] });
      }
    });

    palette.show();
  };

  ctx.actions.registerAction({ id: "openPalette", callback: open });
  ctx.radialMenu.addItem({ itemId: "palette", label: "Palette", actionId: "openPalette" });

  return () => palette?.close();
}

API reference

Manifest fields

추가 필드는 거절됩니다. manifest에는 명령·matcher·backend를 넣지 말고 activate(ctx)에서 등록하세요.

ctx namespaces

Host services

Permissions

요청 동작에 꼭 필요한 토큰만 선언하세요. 설치 화면은 선언 권한을 고지하며, 미선언 권한 서비스는 플러그인 컨텍스트에 제공하지 않습니다.

현재 entry module은 신뢰된 in-process 코드입니다. 권한 브로커는 Host API 노출을 제한하지만 악성 플러그인을 프로세스 수준에서 격리하지는 않습니다.

Examples

Daily briefing and OAuth

// plugin.yaml: surface_slots: [briefing.daily]
ctx.briefing.contribute({
  id: "today",
  provider: () => "오늘 일정 2개 · 마감 할 일 1개",
});

// plugin.yaml: permissions: [oauth.connect]
const status = await ctx.host.oauth.status("google-calendar");
if (!status.connected) {
  await ctx.host.oauth.connect({
    connectionId: "google-calendar",
    provider: "google",
    scopes: ["https://www.googleapis.com/auth/calendar.readonly"],
  });
}

OAuth 브라우저 흐름과 refresh token 보관은 DAP Host가 맡습니다. 플러그인은 refresh token을 직접 받거나 저장하지 않습니다. connectors.read를 선언한 플러그인은 현재 ctx.host.connectors.status("gmail")로 { state, via, hint }를 받습니다. state는 connected, unavailable, unknown 중 하나이며, 판별 자체가 실패한 unknown에서는 기능을 차단하지 말고 명시적인 unavailable에서만 Host의 hint를 안내하세요.

캐릭터 스킨·이름·말투

DAP 1.6.0 이상에서 pet.skin 권한을 선언하고 ctx.host.petSkins.apiVersion === 2를 확인하세요. 등록 후 apply({ usePersona: true })로 외형·성격·말투를 함께 적용합니다. 1.6.1 이상에서는 persona.displayName을 대화창 이름과 AI 자기소개·자기 지칭에도 적용합니다. false면 외형만 적용하며 reset()과 플러그인 해제는 기존 외형·이름·말투를 복원합니다. 사용자 이름·사용자에 대한 호칭·기억은 유지됩니다. 1.6.4 이상에서는 채팅창 프로필 이미지도 활성 스킨의 첫 대기 프레임으로 바뀝니다. 말투 옵션과 관계없이 적용한 외형을 따르며, 스킨을 해제하면 기본/미니 이미지로 복원됩니다.

PNG 상대 경로·크기·프레임 시간과 등록 소유권을 검증합니다. 16방향 시선은 팔레트 미리보기 전용입니다. 데이터 형식·제한·모션 대응·수명 계약을 확인하세요.

DAP 1.6.2부터 춤·먹기·그루밍·휴식도 기존 스킨 모션에 대응합니다. 전용 프레임이 없으면 점프·작업·대기 모션을 재사용하며, 이동 속도·배회 빈도는 바꾸지 않습니다. 1.6.3부터는 스킨도 설정된 펫 크기를 유지하며, 화면 크기·이동 물리·마우스 감지 영역에 동일하게 반영합니다.

Storage

await ctx.host.storage.setJson("pins", ["a", "b"]);
const pins = await ctx.host.storage.getJson("pins");
await ctx.host.storage.delete("pins");

LLM

const answer = await ctx.host.llm.generate(
  "다음 문장을 더 자연스럽게 다듬어줘: " + text,
  30
);

Meeting capability gate

const capability = ctx.host.meeting.capabilities();
if (!capability.available) {
  ctx.host.bubble.speak(capability.reason ?? "회의 캡처를 사용할 수 없어요.");
  return;
}

const offTranscript = ctx.host.meeting.onTranscript((event) => {
  palette.postMessage({ type: "meeting.transcript", event });
});
await ctx.host.meeting.start({ source: "both", sourceLanguage: "en", targetLanguage: "ko" });
// cleanup에서 await ctx.host.meeting.stop(); offTranscript();

Image generation

const image = await ctx.host.imageGen.generate("고양이 밈");
const blobId = await ctx.host.storage.putBlob(image.bytes, {
  mime: image.mime,
  name: image.name,
});

Palette page

<!doctype html>
<meta charset="utf-8" />
<button id="close">close</button>
<ul id="list"></ul>
<script>
  const list = document.getElementById("list");

  window.dapPalette.onMessage((msg) => {
    if (msg.type !== "items") return;
    list.innerHTML = "";
    for (const item of msg.items) {
      const li = document.createElement("li");
      li.textContent = item;
      list.append(li);
    }
  });

  window.dapPalette.postMessage({ type: "ready" });
  document.getElementById("close").onclick = () => window.dapPalette.close();
</script>

Distribution

Catalog entry

플러그인은 공개 GitHub 저장소에 두고, Project-Undonghae/dap-plugins의 plugin_catalog.json에 PR을 보냅니다.

{
  "plugins": [
    {
      "id": "com.example.my_plugin",
      "name": "My Plugin",
      "description": "한 줄 설명",
      "category": "productivity",
      "icon": "assets/icon.svg",
      "repo": "https://github.com/example/dap-my-plugin.git",
      "ref": "v1.0.0"
    }
  ]
}

• category는 선택 필드이며 DAP 1.6.17 앱 찾기의 분류와 검색에 사용합니다. utility, productivity, communication, creativity를 각각 도구·생산성·소통·창작으로 표시하고, 알 수 없는 값도 검색 대상에 남깁니다.
• repo는 owner/name 또는 GitHub HTTPS URL을 사용합니다. 저장소는 public이어야 합니다.
• icon은 선택 필드입니다. 저장소 안 상대 경로의 PNG/JPG/WebP/SVG/ICO(512KB 이하 권장)를 앱 찾기 썸네일로 표시하며, 없거나 읽을 수 없으면 앱 이름 첫 글자로 표시합니다. 퀵 메뉴 항목 아이콘과는 별도입니다.
• ref는 브랜치·태그·SHA이며 재현 가능한 설치를 위해 버전 태그를 권장합니다.
• plugin.yaml의 id와 카탈로그 id가 다르면 설치를 거절합니다.
• DAP은 GitHub tree/raw API로 파일을 받아 설치합니다. 사용자 PC에서 git, zip 해제, npm install, 빌드를 실행하지 않습니다.
• 설치는 명시적인 신뢰 동작이며 새 플러그인은 즉시 활성화됩니다. 이전에 비활성화한 id는 그 상태를 유지합니다.
• 최대 200파일·20MB이며 node_modules, .git, .github는 제외됩니다.
• 업데이트마다 plugin.yaml의 version을 올리고 카탈로그 ref를 새 태그로 갱신하세요. 권한이 추가되면 사용자가 다시 동의합니다.

Versioning

DAP 앱 릴리스 버전, Plugin Platform 버전, manifest 버전, 개별 플러그인 버전은 서로 다른 책임을 가집니다. 플러그인 개발자에게 영향을 주는 변경은 개발문서와 docs/plugin-platform 아래의 관리 파일을 함께 갱신합니다.

• docs/plugin-platform/version.json은 Plugin Platform의 현재 버전과 호환성 기준입니다.
• docs/plugin-platform/changelog.md는 앱 릴리스 노트와 별도로 플러그인 개발자용 변경사항을 기록합니다.
• manifest_version은 manifest 해석 방식이 호환되지 않을 때만 올립니다.

Troubleshooting

2026-11-04: 공개 DAP Workspace 1.6.25/1.6.26의 세션·도구·CLI 연결과 시작/재시도 안내를 추가했습니다. 카탈로그 icon 필드와 Chiikawa Friends 2.8.0의 외부 자산 없는 모션 구성을 반영했습니다. 데스크톱 Plugin Platform 0.4 / manifest v2는 유지합니다.

2026-10-21: DAP 1.6.17의 앱 찾기·검색·카테고리·설치 전 권한 확인과 1.6.15의 App UI System v1·앱 보관함을 반영했습니다. 공통 앱 UI 가이드를 추가했으며 Plugin Platform 0.4 / manifest v2는 유지합니다.

Changelog

2026-10-17: Plugin Platform 0.4.0. pet.skin/ctx.host.petSkins API v2 추가. 최소 DAP 1.6.0, manifest v2 유지.

2026-08-05: Plugin Platform 0.3.0. briefing.daily, ctx.briefing, oauth.connect/ctx.host.oauth, connectors.read/ctx.host.connectors를 추가했습니다. 최소 앱은 DAP 1.4.1이며 manifest v2는 그대로 호환됩니다.

2026-07-29: Plugin Platform 0.2.0. tray_panel, 동적 tray submenu, ctx.aiContext, 설정 쓰기, presentation/meeting/AI accounts/image generation Host API와 최신 설치·업데이트 계약을 반영했습니다. manifest v2는 그대로 호환됩니다.

2026-07-05: Plugin Platform 0.1.0 기준 문서 구조를 정리했습니다. Electron/TypeScript Host API, manifest v2, palette, distribution, versioning 구조를 반영했습니다.