화면과 메뉴 익히기
작업하기 전에 상단의 워크스페이스 이름부터 확인하세요. 하나의 계정으로 여러 워크스페이스에 가입할 수 있으며, 공간을 전환하면 작업하는 자료도 바뀝니다.
목적에 맞는 메뉴 선택
왼쪽 메뉴는 지식(대시보드, 라이브러리, 컨텍스트, 채팅), 작업(리뷰 큐, 린트 큐, 활동, 검색), 워크스페이스(수신함, 설정) 그룹으로 나뉩니다. 어떤 메뉴가 보이는지는 선택한 워크스페이스에서의 역할과 내 실험실 설정에 따라 달라집니다.
| 하고 싶은 일 | 메뉴 | 볼 수 있는 내용 |
|---|---|---|
| 게시 문서 연결 탐색 | 지식 지도 | 개인 실험실과 소유자 활성화가 필요한 지도. 안내 참고 |
| 공간의 현황 확인 | 대시보드 | 항목 수, 최근 활동, 처음 시작하는 순서 |
| 참고 파일 보관 | 라이브러리 / Library | 원본 파일, 추출된 보기, 처리 정보와 버전 |
| 팀의 설명 작성 | 컨텍스트 / Context | 페이지, 폴더, 링크, 게시 상태와 히스토리 |
| AI에 반복 사용할 지침 전달 | 에이전트 / Agent | 지침 페이지, 초안, 활성 버전과 번들 기록. 실험 중인 메뉴로, 실험실에서 Agent 메뉴 표시를 켜면 나타남 |
| 외부 AI 도구의 작업 확인 | 채팅 / Chats | MCP 도구 활동과 연결된 항목. 편집자와 소유자에게 표시됨 |
| 자료를 바탕으로 질문 | 질문 / Ask | 앱 내부 질문 세션, 답변과 인용 근거. 실험 중인 메뉴로, 실험실에서 Ask 메뉴 표시를 켜면 나타남 |
| 제안된 변경 확인 | 리뷰 큐 | 검토 대기 항목과 변경 요청. 미리보기 표시가 붙음 |
| 문서 형식 문제 확인 | 린트 큐 | 구조·링크·인용·서식·지식 품질 검사 결과. 미리보기 표시가 붙음 |
| 변경 흐름 따라가기 | 활동 | 변경, 리뷰, 도구 호출과 작업 상태 |
| 기존 자료 찾기 | 검색 | 접근 가능한 워크스페이스 자료의 검색 결과 |
| 나에게 온 알림 확인 | 수신함 | 워크스페이스 검토 알림. 계정 범위로 전환하면 가입·액세스 키 알림 |
| 공간과 연결 설정 관리 | 설정 | 내 역할에서 사용할 수 있는 설정과 실험실 같은 개인 설정 |
Library는 참고 자료이고, Context는 설명입니다. Product Launch 연습에서는 출시 브리프를 Library에 올리고 팀의 현재 계획을 Context에 씁니다. 참고 파일을 바꿨다고 승인된 Context 페이지가 자동으로 다시 작성되지는 않습니다.
실험 중인 메뉴 표시 (실험실)
지식 지도·Ask·Agent는 이 브라우저의 내 계정에서 켜기 전까지 숨겨집니다. Chats는 역할을 따르고 검토·Lint의 미리보기 표시는 실험실 설정과 별개입니다.
- 내 계정의 설정 → 실험실을 엽니다.
- 지식 지도·Ask·Agent 메뉴 표시 중 원하는 것을 켭니다.
- 저장 없이 즉시 적용됩니다. 다른 계정·브라우저·기기는 각각 선택하며 브라우저 저장소가 차단되면 새로고침까지만 유지됩니다.
지식 지도는 소유자의 설정 → 워크스페이스 → 지식 그래프 활성화도 필요합니다. 숨긴 지식 지도·Ask 링크는 접근 불가 화면을 표시합니다. Agent 문서 직접 링크는 열 수 있지만 Agent 메뉴를 숨기면 브라우저 검색 결과와 Agent 범위를 제외합니다. 실험실은 REST·MCP 권한을 바꾸지 않습니다. 지식 지도, 검색을 참고하세요.
워크스페이스가 명시된 주소
화면은 /workspaces/<workspace_id>/…, Context 문서는 /workspaces/<workspace_id>/context/pages/<page_id>, 인증된 공유 링크는 /p/<workspace_id>/<page_id>를 사용합니다. UUID를 제목·슬러그로 바꾸지 말고 현재 링크를 복사하세요. 다른 워크스페이스를 열어도 멤버십을 얻지는 않습니다. 초기 비공개 공간도 일반 소유권 규칙을 따르며 삭제 후 다시 만들지 않습니다.
상단 Inbox는 워크스페이스 알림을 열고 /inbox는 계정 범위입니다. 수신함를 참고하세요.
화면의 영역 이해하기
자료를 보는 화면은 보통 다음 영역으로 구성됩니다.
- 탐색기 또는 목록: 폴더와 항목을 선택합니다.
- 본문 보기: 선택한 내용을 읽고 보기, 히스토리 등의 탭을 사용합니다.
- 세부 정보: 속성, 버전, 인용과 연결을 확인합니다.
각 영역의 버튼으로 패널을 숨기거나 다시 열 수 있습니다. 좁은 화면에서는 메뉴와 세부 정보가 별도 서랍처럼 열릴 수 있습니다. Preview / 미리보기 표시가 있는 메뉴나 기능은 아직 다듬는 중입니다. 사용할 수 없다는 탭은 주 본문이나 목록으로 돌아가 작업하세요.
휴대전화나 태블릿에서는 상단의 내비게이션 열기 버튼으로 메뉴 서랍을 열고, 내비게이션 닫기나 Esc 키로 닫습니다. 데스크톱에서 사이드바를 접었더라도 메뉴 이름과 워크스페이스 이름이 표시됩니다. 데스크톱 검색창이 숨겨진 화면에서는 상단의 검색 열기 아이콘으로 검색을 엽니다.
상단 검색창(워크스페이스 검색 또는 이동, Ctrl+K 또는 ⌘K)에서는 워크스페이스를 검색하고, 이동할 수 있는 메뉴도 고를 수 있습니다. 편집자와 소유자에게는 생성 메뉴도 보이며, 새 컨텍스트 페이지, 새 폴더, Setup 열기를 제공합니다. Setup 열기는 워크스페이스에 라이브러리 자료와 지식 페이지가 준비되었는지 보여 주는 화면을 엽니다. 에이전트 메뉴를 표시했다면 AI 규칙도 함께 확인합니다. 이 화면의 한국어 제목은 서버 설치로 표시됩니다. 버튼이 보이지 않는 이유가 현재 역할일 수 있습니다.
탐색기 표시 읽기
컨텍스트, 라이브러리, 에이전트 탐색기의 페이지·항목 행에는 제목 앞에 해당 영역 색상의 작은 표시가 붙습니다. 폴더에는 표시가 없습니다.
| 표시 | 상태 | 의미 |
|---|---|---|
| 속이 빈 원 | 일반 | 최근 72시간 동안 의미 있는 내용 변경이 없습니다. |
| 채워진 점 | 최근 변경 | 최근 72시간 안에 내용이 바뀌었습니다. 예를 들어 페이지를 처음 게시했거나 본문이 바뀐 버전을 게시한 경우, Agent 페이지를 바뀐 내용으로 활성화한 경우, Library 항목에 새 파일 버전이 들어온 경우입니다. |
| 시계 바늘이 그려진 채워진 점 | 리뷰 대기 또는 수정 요청 | 항목의 현재 초안에 진행 중인 리뷰가 있습니다. 편집자와 소유자에게만, 컨텍스트 페이지와 Agent 페이지에만 표시됩니다. |
이 표시는 개인별 읽음 표시가 아닙니다. 항목을 열어도 사라지지 않으며, 채워진 점은 변경 후 정확히 72시간이 지나면 빈 원으로 돌아갑니다. 초안 저장이나 자동 저장, 검토 제출, 행 이름 변경이나 이동, 제목·태그만 바꾸는 편집은 내용 변경으로 보지 않습니다.
행의 상태와 작업 확인하기
- 마우스를 행 위에 올리거나 키보드로 행에 초점을 옮기면 탐색기 옆에 더 긴 제목과 상태 줄이 담긴 도움말이 나타납니다. 예: 최근 변경 · 3시간 전, 일반 · 마지막 내용 변경 5일 전. 제목은 최대 네 줄까지 보이며 공간이 부족하면 말줄임표로 줄어들 수 있습니다. 전체 제목은 항목을 열어 확인하세요. Esc 키로 숨길 수 있으며, 터치 화면에서는 이 도움말이 나타나지 않습니다.
- 행의 ⋯ 버튼(… 작업 열기)을 누르거나, 행을 마우스 오른쪽 버튼으로 클릭하거나, 행에 초점이 있을 때 Shift+F10을 누르거나, 터치 화면에서 행을 길게 누르면 작업 메뉴가 열립니다. 메뉴 맨 위에는 제목과 상태 줄이 다시 표시됩니다. 사용할 수 있는 작업은 역할과 항목에 따라 다릅니다.
내 즐겨찾기 표시하기
항목을 읽을 수 있는 멤버라면 뷰어도 자신만 보는 별을 붙일 수 있습니다.
- 컨텍스트 페이지, 라이브러리 항목, Agent 페이지 행의 작업 메뉴를 엽니다.
- 내 즐겨찾기에 추가를 선택합니다.
예상 결과: 그 항목이 보이는 모든 탐색기에서 아이콘에 노란 별이 붙고, 도움말과 메뉴에 내 즐겨찾기가 추가됩니다. 별을 없애려면 내 즐겨찾기에서 해제를 선택합니다.
즐겨찾기는 현재 워크스페이스의 내 계정에만 저장되며, 소유자를 포함한 다른 멤버에게는 보이지 않습니다. 항목의 이름을 바꾸거나 옮겨도 유지됩니다. 폴더에는 붙일 수 없고, 즐겨찾기만 모아 보는 목록이나 필터는 없습니다. 선택한 직후 별이 사라지면 변경이 저장되지 않은 것이므로 페이지를 새로 고친 뒤 다시 시도하세요.
링크와 버전 구분
- 내부 워크스페이스 링크를 열려면 로그인과 해당 공간의 접근 권한이 필요합니다.
- 공개 페이지 링크는 별도의 읽기 전용 게시 페이지를 엽니다.
- 히스토리의
v3같은 번호는 해당 페이지의 개정 번호입니다. dtxWiki 소프트웨어 버전0.2.1과 다릅니다. - 채팅은 외부 도구의 활동 기록이고, 질문은 앱 안에서 질문하는 기능입니다. 채팅은 편집자와 소유자에게 기본으로 보이는 메뉴이고, 질문은 실험실에서 켜야 나타납니다.
자주 겪는 문제
“링크를 열었는데 페이지를 못 찾겠어요.” 계정과 워크스페이스를 확인하세요. 가입하지 않은 공간이라면 소유자에게 접근을 요청합니다. 링크 자체가 가입 권한을 주지는 않습니다.
“업데이트 뒤 오래 열어 둔 탭이 동작하지 않아요.” 최신 버전 불러오기를 사용하거나 새로 고칩니다. 편집 중이라면 화면에 남은 미저장 텍스트를 먼저 별도로 보관하세요.
“채팅 메뉴나 생성 버튼이 없어요.” 채팅과 생성 메뉴는 선택한 워크스페이스의 편집자와 소유자에게만 보이며, 다른 작업도 역할에 따라 달라집니다. 소유자에게 필요한 역할을 확인하세요.
“질문이나 에이전트 메뉴가 없어요.” 두 메뉴는 설정 → 실험실에서 켜기 전에는 숨겨져 있습니다. 선택은 브라우저마다 계정별로 저장되므로 다른 브라우저에서나 사이트 데이터를 삭제한 뒤에는 다시 켜야 합니다. 질문 메뉴를 켜기 전에는 질문 링크에 해당 페이지를 찾을 수 없습니다가 표시됩니다.
구현 근거: 메뉴 번역과 접근 안내, 메뉴 구성, 실험실 설정 저장, 탐색기, 탐색기 도움말, 탐색기 번역, 탐색기 표시, 웹 UI 진입점.