사용 설명서

문서.

올리기부터 페이지 DB·검색 노출·CLI 까지, 다보여의 모든 기능.

시작하기

올리기 페이지에 HTML 파일을 끌어다 놓거나 클릭해서 선택해요. 이미지·CSS 가 든 폴더째도 돼요 — 다보여가 하나의 HTML 로 합쳐요 (한 파일 약 3MB 까지).
바로 /v/짧은id 링크가 생겨요. 기본은 비공개라 아직 아무도 못 봐요.
카드의 외부 공유하기를 켜면 링크를 받은 누구나 볼 수 있어요. 링크 줄(/v/…)을 누르면 복사돼요.
이름 변경 · 업데이트(같은 링크에 새 내용) · 삭제는 카드 안에서. 내가 올린 목록은 이 브라우저에만 저장되니 다른 기기에서 관리하려면 id 를 기억해 두세요.

링크 미리보기(OG)

공유 켠 카드의 🔖 링크 미리보기 설정에서 제목·설명·이미지 URL 을 넣거나 📷 올리기로 이미지를 직접 올려요(PNG·JPG·WebP·GIF, 2MB). 카톡·슬랙·X 미리보기가 그 값으로 바뀌고, 원본 HTML 은 손대지 않아요. CLI: daboyeo share <id> --og-title "…" --og-desc "…" --og-image ./cover.png

SEO · GEO 노출

기본값은 검색에 안 잡힘(noindex)이에요. 카드의 🔎 SEO·GEO 최적화 켜기를 누르면:

색인 허용 robots · canonical · <title>(없으면 미리보기 제목→파일명) · lang="ko" · schema.org WebPage JSON-LD 가 <head> 에 붙어요.
사이트맵(/sitemap.xml)과 AI 검색용 /llms.txt 에 등재돼요. robots.txt 는 GPTBot·ClaudeBot·PerplexityBot 등 AI 크롤러를 허용해요.
본문이 실제 텍스트여야 효과가 있어요. 미리보기 제목·설명을 채우면 검색 결과 제목·요약으로 쓰여요.

AI 에게 — 검색 노출용 페이지

검색 노출용 단일 HTML 이야. <title> 과 h1 에 핵심 키워드, 본문은 실제 텍스트로 쓰고(이미지 안에 글자 넣지 마), 섹션마다 h2 를 달아. <meta name="description"> 도 넣어줘. OG 태그·canonical·구조화 데이터는 다보여가 붙여주니 생략해도 돼.

페이지 DB

파일마다 켜는 전용 JSON 저장소예요. 카드에서 🗄 DB 켜기를 누르면 그 페이지의 <head> 맨 앞에 window.daboyeo.db 헬퍼가 자동 주입되고, HTML 안의 스크립트가 바로 쓸 수 있어요. 서버·회원가입 없이 방명록·참석 신청·투표·설문·간단한 설정 저장이 가능해요.

헬퍼 메서드 (모두 Promise)

메서드	설명	쓰임
`daboyeo.db.add(obj)`	문서 추가. 키는 자동(시간순 정렬 가능). 반환: key	방명록·신청·투표 한 건
`daboyeo.db.list({limit, order, prefix})`	문서 목록 [{key,data,createdAt,updatedAt}]. 기본 최신순, limit 최대 1000	목록 화면
`daboyeo.db.get(key)`	한 문서의 data. 없으면 null	설정값·카운터 읽기
`daboyeo.db.set(key, obj)`	키로 저장(덮어쓰기). 반환: data	설정값 저장
`daboyeo.db.update(key, obj)`	얕은 병합(객체만). 반환: 병합된 data	일부 필드만 수정
`daboyeo.db.remove(key)`	문서 삭제
`daboyeo.db.count()`	이 페이지 문서 수
`daboyeo.db.clear()`	이 페이지 문서 전부 삭제	소유자용

예제 — 방명록 한 장

guestbook.html

<!doctype html>
<html lang="ko"><head><meta charset="utf-8"><title>방명록</title></head>
<body>
  <form id="f"><input name="name" placeholder="이름" required>
    <input name="msg" placeholder="한마디" required><button>남기기</button></form>
  <ul id="list"></ul>
  <script>
    const f = document.getElementById('f'), ul = document.getElementById('list');
    async function render() {
      const items = await daboyeo.db.list({ limit: 50 });     // 최신순
      ul.innerHTML = items.map(i => `<li><b>${i.data.name}</b> ${i.data.msg}</li>`).join('');
    }
    f.onsubmit = async (e) => {
      e.preventDefault();
      await daboyeo.db.add({ name: f.name.value, msg: f.msg.value });
      f.reset(); render();
    };
    render();
  </script>
</body></html>

AI 에게 — 페이지 DB 쓰는 HTML

이 페이지는 다보여(daboyeo.oqoq.ai)에 올릴 단일 HTML 이야. 데이터 저장은 다보여가 <head> 에 자동 주입하는 window.daboyeo.db 를 써 (직접 script 로 불러오지 마).
- daboyeo.db.add(obj) → 새 문서 추가, 키(문자열)를 돌려줌 (시간순 정렬 가능)
- daboyeo.db.list({ limit, order:'asc'|'desc', prefix }) → [{ key, data, createdAt }] (기본 최신순)
- daboyeo.db.get(key) → data 또는 null / set(key,obj) / update(key,obj) 얕은 병합 / remove(key)
- 모두 Promise. 문서 32KB·페이지당 2000개 제한. 링크를 아는 누구나 읽고 쓸 수 있으니 공개 입력 용도로만.
이걸로 이름·메시지를 받는 방명록 폼과 최신순 목록을 만들어줘. 전송 중/실패 상태도 표시해.

HTTP 로 직접

	경로
`GET`	`/api/db/<id>?limit=&order=asc\|desc&prefix=&count=1`	목록 (+count)
`POST`	`/api/db/<id> (JSON body)`	추가 → {key,data,createdAt}
`DELETE`	`/api/db/<id>?all=1`	전부 삭제 → {deleted}
`GET`	`/api/db/<id>/<key>`	한 문서 → {key,data,createdAt,updatedAt}
`PUT`	`/api/db/<id>/<key> (JSON body)`	저장(덮어쓰기)
`PATCH`	`/api/db/<id>/<key> ({...})`	얕은 병합
`DELETE`	`/api/db/<id>/<key>`	삭제

조건: 파일이 공유 중이고 DB 켜짐일 때만 응답해요(아니면 403). 키는 영문·숫자·_ . : - 64자. 문서 32KB, 페이지당 2000개. 소유자는 카드의 데이터 보기(JSON)·비우기로 관리하고, 데이터는 다보여 저장소에서 표처럼 볼 수 있어요.

⚠ 다보여에는 로그인이 없어서, 링크를 아는 사람은 누구나 그 페이지의 데이터를 읽고 쓸 수 있어요. 공개 입력(방명록·RSVP·투표)에 맞고, 개인정보·비밀 데이터엔 쓰지 마세요.

CLI

설치: curl -fsSL https://daboyeo.oqoq.ai/install.sh | sh (Node 18+). 자세한 설치 안내는 /cli.

`daboyeo up <file.html\|폴더> [--share] [--pw 1234] [--list] [--seo] [--db]`	올리기. 폴더면 이미지·CSS·JS 를 HTML 에 합쳐 1개로
`daboyeo put <id> <file\|폴더> [--name 새이름]`	같은 링크 유지하며 내용 교체 (비번·설정 유지)
`daboyeo rename <id> <새 이름>`	파일 이름 변경
`daboyeo share <id> [--off] [--pw 1234] [--list] [--seo\|--seo-off] [--db\|--db-off] [--og-title/--og-desc/--og-image]`	공유 설정. --og-image 는 URL 또는 ./파일
`daboyeo db <id> [--limit 50] [--clear]`	페이지 DB 문서 보기 / 비우기
`daboyeo short <url>`	URL 단축 → /s/짧은id
`daboyeo ls · open <id> · rm <id> · gallery`	목록(조회수) · 브라우저로 열기 · 삭제 · 둘러보기
`daboyeo update · version`	CLI 자체 업데이트 · 버전

Claude Code 에게 — 올리기까지 자동화

완성되면 다보여 CLI 로 올려줘: daboyeo up ./dist --share (DB 가 필요하면 --db, 검색 노출은 --seo 추가). 나온 /v/ 링크를 알려줘. 이후 수정은 daboyeo put <id> ./dist 로 같은 링크에 반영해. CLI 가 없으면 curl -fsSL https://daboyeo.oqoq.ai/install.sh | sh 로 설치.

제한 · 주의

HTML 1개 약 3MB(이미지 포함, 합친 후). 더 크면 이미지를 줄이거나 외부 URL 로.
링크 id 가 곧 권한이에요. id 를 아는 사람은 보기(공유 시)·관리 모두 가능하니 관리 페이지 링크는 공유하지 마세요.
저장·조회는 보통 1초 안팎. 한꺼번에 수백 명이 쓰면 느려질 수 있어요.
삭제한 파일·데이터는 다보여 저장소의 휴지통에서 복구 요청할 수 있어요.

팀 전용 공간

팀이나 프로젝트별로 완전히 분리된 공간(별도 저장소, 별도 갤러리)을 /팀이름/app 형태로 열어 드릴 수 있어요. CLI 는 DABOYEO_BASE=https://daboyeo.oqoq.ai/팀이름 만 지정하면 같은 명령을 그대로 써요. 필요하면 운영자에게 요청하세요.

문서.