v0.1 변경 기록과 제한 사항
이 설명서는 PyPI와 npm에 공개된 dtxWiki v0.1.2의 사용 방법을 안내합니다. 같은 버전의 GitHub Release에서 Python wheel과 소스 배포 파일을 제공합니다. 설치 방법과 작업 구성을 선택할 때 아래 기능과 제한 사항을 확인하세요.
이번 릴리스의 변경 사항
- 워크스페이스 설정에서 첫 편집 내용을 유지하고 중첩된 정책 변경을 저장하도록 수정했습니다.
- OAuth 검증은 시계가 뒤로 이동해도 동작하며 서명·발급자·대상·만료·사용 시작 시각 검사는 유지합니다.
- Library 미리 보기 기록의 중복 삭제를 방지하고 PDF의 텍스트 선택 영역을 표시된 페이지와 맞췄습니다.
- DB 리비전 식별자는
bd62193d5cf6→efcbcf724889순서를 사용합니다. 처음 설치하면 자동 준비합니다. 다른 지원 식별자가 기록된 DB를 재사용할 때는 명시적인 스키마 검사·변환이 필요합니다.
브라우저 작업 흐름과 MCP 도구 이름은 이 설명서의 안내와 같습니다.
현재 패치 변경 기록: v0.1.2
- Python 패키지와 같은 버전의 npm 실행기가 공개되어 있습니다. npm 실행기는 Node.js 22+와 uv 또는 pipx가 필요하며, 파일 처리나 대기 중인 계정 메일에는 같은 버전의 작업자를 별도로 실행합니다.
- 지원하는 SQLite 리비전 식별자는
bd62193d5cf6,efcbcf724889입니다. 인식 가능한 별칭 식별자가 기록된 DB를 재사용할 때는 백업과 유지보수의 명시적인 스키마 검사·변환 절차를 따릅니다. 새 설치에는 이 변환이 필요하지 않습니다. - 첫 계정 생성, 별도 서버 관리자 권한, Host 허용 정책, 선택적 SMTP는 설치 안내, 서버 실행과 접속, 선택적 Gmail SMTP에서 자세히 설명합니다.
이 설명서에서 다루는 내용
- 한국어·영어 브라우저 화면과 워크스페이스 탐색·역할.
- Context 페이지, Markdown 편집, 이미지·링크, 초안 저장·게시.
- Library 원본 파일, 추출 작업, 파일 처리 결과 확인.
- 검색, 근거 기반 Ask, 검토, 변경 기록, 활동·Lint.
- Agent 지침 페이지와 규칙에 따른 입력 묶음.
- dtxWiki에서 실행한 AI 도구 작업을 보여주는 Chats.
- 인증된 Streamable HTTP MCP, 개인 액세스 토큰·OAuth.
- 개인 로컬 사용과 자체 운영 팀 서버. 공식 운영 배포는 SQLite를 사용합니다.
설치 전에 알아둘 제한 사항
| 항목 | 현재 안내하는 범위 |
|---|---|
| 데스크톱 설치 파일 | 이번 릴리스에 포함되지 않습니다. 설치된 서버를 브라우저에서 사용합니다. |
| Python 패키지 | 이 설명서와 같은 버전을 사용하려면 dtxwiki==0.1.2를 설치합니다. 설치 안내를 참고하세요. |
| npm 실행기 | Node.js 22+와 uv 또는 pipx로 @dtxsuite/dtxwiki@0.1.2를 사용합니다. 같은 버전의 Python 패키지를 실행하며, 대기 작업에는 별도로 실행한 작업자가 필요합니다. |
| Docker | 체크아웃한 소스로 이미지를 만듭니다. 이번 릴리스의 공식 사전 빌드 컨테이너 이미지는 게시되지 않습니다. |
| 운영 서버 | 설치 스크립트와 운영 검증은 Linux를 대상으로 합니다. Windows 운영 호스팅은 지원하지 않습니다. |
| 데이터베이스와 확장 | 운영 환경은 하나의 물리 데이터베이스에 SQLite를 사용합니다. 운영 PostgreSQL, 워크스페이스별 물리 데이터베이스 분리, 여러 노드의 앱·작업자 배포는 지원하지 않습니다. |
| 조직 로그인 | 외부 인증 제공업체 연동(SSO)과 다단계 인증(MFA)은 포함되지 않습니다. dtxWiki의 MCP OAuth 승인은 별도 기능입니다. |
| AI | 선택 사항입니다. LLM 제공업체가 없으면 Ask는 생성형 답변 대신 참고 자료·근거 모음을 제공합니다. |
| 파일 추출 | 파일 종류와 설치된 어댑터에 따라 처리 범위가 다릅니다. 원본 보관이 텍스트 검색이나 모든 형식의 변환을 보장하지는 않습니다. |
| 원본 갱신 | 백그라운드 원본 자동 동기화는 포함되지 않습니다. 참고 자료의 변경 여부를 확인하고 직접 갱신하세요. |
| AI 도구 호환성 | 연결 설정을 생성할 수 있다는 사실만으로 특정 클라이언트 버전의 PAT·OAuth 실제 연결이 검증된 것은 아닙니다. |
| 공개 페이지 | 공유 규칙에 따라 게시된 자료를 제공합니다. 버전별 설명서 포털 기능은 아닙니다. |
| 그래프 | 구현된 연결 보기와 제한 사항은 그래프 안내를 확인하세요. |
제품 라이선스
v0.1.2 애플리케이션 소스는 선택 가능한 AGPL-3.0-only OR Elastic-2.0 라이선스입니다. dtxSuite의 상용 라이선스도 제공됩니다. integrations/ 디렉터리에는 별도의 Apache-2.0 라이선스가 적용됩니다.
본인의 사용 목적에 맞게 실제 라이선스 조건을 읽어보세요. 설명서 프레임워크의 MIT 라이선스와 dtxWiki 애플리케이션의 라이선스는 별개입니다.
웹 화면에 번들된 제3자 구성요소에는 각자의 라이선스 조건과 고지가 적용됩니다. 실행 중인 dtxWiki 서버에서 /THIRD_PARTY_NOTICES.txt를 열어 번들 고지를 읽을 수 있습니다. dtxWiki와 dtxSuite 이름·로고는 상표이며, 적용되는 조건은 제품 LICENSE를 확인하세요. 상용 라이선스 문의는 dtxwiki.ai@gmail.com으로 보냅니다.
문서 버전 읽는 방법
상단의 v0.1 표시는 설명서의 버전 계열입니다. 현재 안내는 dtxWiki v0.1.2를 기준으로 확인했습니다. 같은 계열에 속해도 모든 패치의 설치·데이터베이스·설정 동작이 같다는 뜻은 아닙니다.
패치가 배포되면 기존 문서와 이 공통 변경 기록을 수정하며, 설명서 전체를 복사하거나 주소를 바꾸지 않습니다. 설치 예제, 소스 근거, 특정 패치에 따라 달라지는 동작에는 정확한 제품 버전을 남깁니다. 문서 수정으로 설치된 애플리케이션의 버전이 바뀌지는 않습니다.
처음 설치할 때 확인할 내용
- 설치 안내에 따라 개인용 v0.1.2 패키지를 설치하거나 공유 서버를 준비합니다.
- 브라우저에서 서버를 열고 로그인한 뒤, 첫 워크스페이스를 따라 참고 자료를 추가하고 페이지를 게시합니다.
- 중요한 자료를 보관하기 전에 백업과 유지보수를 준비합니다. 데이터베이스, 파일, 운영 설정을 복구할 수 있는 형태로 보관하세요.
설치 이후에도 유지보수 전에 백업을 계속 만드세요. 소프트웨어 버전만 되돌려도 변경된 데이터가 함께 복원되는 것은 아닙니다.