T2Editor는 dsclub.kr 커뮤니티에서 개발된 웹 에디터로, 기본적인 편집 기능뿐만 아니라 여러 가지 부가 서비스를 탑재하고 있습니다. 이 문서는 DSclub이 제공하는 서비스(예: AI 작성 도구, T2Search 검색 서비스, T2ClipURL 링크 생성 기능 등)를 간략히 소개하고, 이러한 서비스 사용 시 주의해야 할 사항을 정리합니다. 특히 DSclub 서비스를 활용할 때는 외부 서버에 의존하는 구조가 많기 때문에, 서비스 제공자가 변경되거나 운영이 중단될 경우 에디터의 일부 기능이 작동하지 않을 수 있습니다. 따라서 이러한 위험을 이해하고, 가능하다면 대안이나 자체 서버를 준비하는 것이 좋습니다.
collab 디렉터리의 파일과 서버‑사이드 세션 처리를 통해 구현됩니다. DSclub 서버와 무관하게 독립적으로 운영할 수 있지만, DSclub의 협업 데모 서비스에 연결하는 옵션도 존재합니다.license.txt 파일을 백업하고 업데이트 과정에서 유지해야 합니다.ai.js / ai_rearrange.js): 이 플러그인은 DSclub 서버와의 REST API 통신으로 구현되어 있습니다. 주요 함수는 invokeAICommand()와 sendToAI()로, 선택된 에디터 블록을 직렬화한 뒤 HTTP POST 요청을 수행하고, 응답을 파싱하여 DOM에 삽입합니다. 인증 헤더에는 DSclub 사이트에서 발급받은 라이선스 토큰과 타임스탬프가 포함됩니다. 외부 API로 교체할 때는 이 인증 로직과 CORS 설정을 모두 변경해야 합니다SIR T2Editor 8.1.2 댓글 - 외부 API 연동 주의.search/search.js에 구현되어 있으며, searchKeyword() 함수가 DSclub API /api/search/query 엔드포인트에 GET 요청을 보냅니다. 결과는 JSON 형식으로 전달되며, 파서 함수가 이를 에디터 블록으로 변환합니다. 검색 엔드포인트 주소를 변경하면 기능을 다른 검색 서비스로 대체할 수 있지만, 결과 구조를 맞춰주는 어댑터가 필요합니다.clipurl/clipurl.js에서 URL 단축 요청을 DSclub API /api/clipurl/shorten으로 POST 전송합니다. 응답으로 반환된 단축 링크를 클립보드에 복사하고 QR 코드 이미지를 생성합니다. 로컬에서 운영하고자 할 경우, 같은 엔드포인트를 제공하는 백엔드 구현이 필요합니다.nsfw_api_browser.js와 nsfw_api_server.php가 연동됩니다. 밈 플러그인은 meme/meme.js에서 DSclub API로 검색 요청을 보내 밈 이미지를 가져옵니다. 외부 API 제공이 중단되면 필터링 및 이미지 검색 기능이 동작하지 않습니다.ai.js에서 DSclub API 호출 코드를 찾아 Groq API 엔드포인트로 변경하고, 요청 헤더를 재구성해야 합니다. 변경 작업은 복잡할 수 있으며, 충분한 테스트와 보안 검토가 필요합니다.search.js에서 API_URL을 변경한 뒤 반환 형식을 맞추는 어댑터를 작성합니다. 결과 파싱과 에디터 블록 변환 로직을 플러그인에 포함해야 합니다.clipurl.js 내의 요청 주소를 교체합니다. 응답 JSON 구조를 기존 API와 동일하게 하면 프런트엔드 수정 없이 동작합니다.Access-Control-Allow-Origin 헤더가 잘못 설정되면 브라우저에서 요청이 차단될 수 있습니다SIR T2Editor 8.1.2 댓글 - 외부 API 연동 주의.parseResponse() 함수를 활용해 단위 테스트를 작성하면 좋습니다.이 문서는 현재 분석 중인 T2Editor 9.0.0 버전을 기준으로 작성되었으며, DSclub 커뮤니티의 서비스 정책과 API 상태에 따라 내용이 변경될 수 있습니다. 서비스 제공자가 약관을 수정하거나 API를 중단할 경우, 해당 기능을 유지하려면 코드와 서버 설정을 적절히 수정해야 합니다.
T2Editor는 dsclub.kr 커뮤니티에서 개발된 웹 에디터로, 기본적인 편집 기능뿐만 아니라 여러 가지 부가 서비스를 탑재하고 있습니다. 이 문서는 DSclub이 제공하는 서비스(예: AI 작성 도구, T2Search 검색 서비스, T2ClipURL 링크 생성 기능 등)를 간략히 소개하고, 이러한 서비스 사용 시 주의해야 할 사항을 정리합니다. 특히 DSclub 서비스를 활용할 때는 외부 서버에 의존하는 구조가 많기 때문에, 서비스 제공자가 변경되거나 운영이 중단될 경우 에디터의 일부 기능이 작동하지 않을 수 있습니다. 따라서 이러한 위험을 이해하고, 가능하다면 대안이나 자체 서버를 준비하는 것이 좋습니다.
collab 디렉터리의 파일과 서버‑사이드 세션 처리를 통해 구현됩니다. DSclub 서버와 무관하게 독립적으로 운영할 수 있지만, DSclub의 협업 데모 서비스에 연결하는 옵션도 존재합니다.license.txt 파일을 백업하고 업데이트 과정에서 유지해야 합니다.ai.js / ai_rearrange.js): 이 플러그인은 DSclub 서버와의 REST API 통신으로 구현되어 있습니다. 주요 함수는 invokeAICommand()와 sendToAI()로, 선택된 에디터 블록을 직렬화한 뒤 HTTP POST 요청을 수행하고, 응답을 파싱하여 DOM에 삽입합니다. 인증 헤더에는 DSclub 사이트에서 발급받은 라이선스 토큰과 타임스탬프가 포함됩니다. 외부 API로 교체할 때는 이 인증 로직과 CORS 설정을 모두 변경해야 합니다SIR T2Editor 8.1.2 댓글 - 외부 API 연동 주의.search/search.js에 구현되어 있으며, searchKeyword() 함수가 DSclub API /api/search/query 엔드포인트에 GET 요청을 보냅니다. 결과는 JSON 형식으로 전달되며, 파서 함수가 이를 에디터 블록으로 변환합니다. 검색 엔드포인트 주소를 변경하면 기능을 다른 검색 서비스로 대체할 수 있지만, 결과 구조를 맞춰주는 어댑터가 필요합니다.clipurl/clipurl.js에서 URL 단축 요청을 DSclub API /api/clipurl/shorten으로 POST 전송합니다. 응답으로 반환된 단축 링크를 클립보드에 복사하고 QR 코드 이미지를 생성합니다. 로컬에서 운영하고자 할 경우, 같은 엔드포인트를 제공하는 백엔드 구현이 필요합니다.nsfw_api_browser.js와 nsfw_api_server.php가 연동됩니다. 밈 플러그인은 meme/meme.js에서 DSclub API로 검색 요청을 보내 밈 이미지를 가져옵니다. 외부 API 제공이 중단되면 필터링 및 이미지 검색 기능이 동작하지 않습니다.ai.js에서 DSclub API 호출 코드를 찾아 Groq API 엔드포인트로 변경하고, 요청 헤더를 재구성해야 합니다. 변경 작업은 복잡할 수 있으며, 충분한 테스트와 보안 검토가 필요합니다.search.js에서 API_URL을 변경한 뒤 반환 형식을 맞추는 어댑터를 작성합니다. 결과 파싱과 에디터 블록 변환 로직을 플러그인에 포함해야 합니다.clipurl.js 내의 요청 주소를 교체합니다. 응답 JSON 구조를 기존 API와 동일하게 하면 프런트엔드 수정 없이 동작합니다.Access-Control-Allow-Origin 헤더가 잘못 설정되면 브라우저에서 요청이 차단될 수 있습니다SIR T2Editor 8.1.2 댓글 - 외부 API 연동 주의.parseResponse() 함수를 활용해 단위 테스트를 작성하면 좋습니다.이 문서는 현재 분석 중인 T2Editor 9.0.0 버전을 기준으로 작성되었으며, DSclub 커뮤니티의 서비스 정책과 API 상태에 따라 내용이 변경될 수 있습니다. 서비스 제공자가 약관을 수정하거나 API를 중단할 경우, 해당 기능을 유지하려면 코드와 서버 설정을 적절히 수정해야 합니다.
| 이전 | 새 버전 | ||
|---|---|---|---|
| 1 | --- | 1 | --- |
| 2 | title: DSclub 제공 서비스 안내 및 주의사항 | 2 | title: DSclub 제공 서비스 안내 및 주의사항 |
| 3 | document_id: 70 | 3 | document_id: 70 |
| 4 | slug: dsclub-services-guide | 4 | slug: dsclub-services-guide |
| 5 | target_editor_version: 9.0.0 | 5 | target_editor_version: 9.0.0 |
| 6 | document_type: integration | 6 | document_type: integration |
| 7 | doc_type: integration | 7 | doc_type: integration |
| 8 | target_readers: [초보자, 웹마스터, 개발자, AI agent] | 8 | target_readers: [초보자, 웹마스터, 개발자, AI agent] |
| 9 | importance: Medium | 9 | importance: Medium |
| 10 | dependency: Low | 10 | dependency: Low |
| 11 | core_type: Non-Core | 11 | core_type: Non-Core |
| 12 | stability: [Version‑Bound] | 12 | stability: [Version‑Bound] |
| 13 | stable_anchor: [] | 13 | stable_anchor: [] |
| 14 | version_bound: [DSclub 서비스 업데이트, 커뮤니티 운영 사정] | 14 | version_bound: [DSclub 서비스 업데이트, 커뮤니티 운영 사정] |
| 15 | related_docs: [03‑feature‑overview.md, 05‑gnuboard5‑integration‑guide.md, 60‑plugin‑development‑guide.md] | 15 | related_docs: [03‑feature‑overview.md, 05‑gnuboard5‑integration‑guide.md, 60‑plugin‑development‑guide.md] |
| 16 | related_files: [t2editor/js/ai.js, t2editor/js/ai_rearrange.js, t2editor/plugin/search/search.js, t2editor/plugin/clipurl/clipurl.js] | 16 | related_files: [t2editor/js/ai.js, t2editor/js/ai_rearrange.js, t2editor/plugin/search/search.js, t2editor/plugin/clipurl/clipurl.js] |
| 17 | related_functions: [] | 17 | related_functions: [] |
| 18 | related_classes_modules: [] | 18 | related_classes_modules: [] |
| 19 | related_features: [AI 기능, T2Search, T2ClipURL, 협업] | 19 | related_features: [AI 기능, T2Search, T2ClipURL, 협업] |
| 20 | related_ui: [AI 툴바 버튼, 검색 툴바 버튼, URL 클립 툴바 버튼] | 20 | related_ui: [AI 툴바 버튼, 검색 툴바 버튼, URL 클립 툴바 버튼] |
| 21 | change_risk: DSclub 서비스의 운영 상태에 따라 기능이 갑자기 중단될 수 있음 | 21 | change_risk: DSclub 서비스의 운영 상태에 따라 기능이 갑자기 중단될 수 있음 |
| 22 | reading_order: 70 | 22 | reading_order: 70 |
| 23 | summary: DSclub이 제공하는 AI, 검색, 링크 생성 등 외부 서비스의 개요와 사용시 주의사항을 정리한 문서입니다. | 23 | summary: DSclub이 제공하는 AI, 검색, 링크 생성 등 외부 서비스의 개요와 사용시 주의사항을 정리한 문서입니다. |
| 24 | description: T2Editor에 기본 탑재된 DSclub 서비스(예: AI 작성 도구, T2Search, T2ClipURL)와 관련된 기능 및 제한 사항을 설명하고, 외부 서비스에 대한 의존성을 줄이는 방법과 주의해야 할 점을 안내합니다. | 24 | description: T2Editor에 기본 탑재된 DSclub 서비스(예: AI 작성 도구, T2Search, T2ClipURL)와 관련된 기능 및 제한 사항을 설명하고, 외부 서비스에 대한 의존성을 줄이는 방법과 주의해야 할 점을 안내합니다. |
| 25 | tags: [T2Editor, dsclub, 서비스, AI, 검색, ClipURL, 주의사항] | 25 | tags: [T2Editor, dsclub, 서비스, AI, 검색, ClipURL, 주의사항] |
| 26 | version_tag: 9.0.0 | 26 | version_tag: 9.0.0 |
| 27 | maintenance_difficulty: Medium | 27 | maintenance_difficulty: Medium |
| 28 | test_requirement: Medium | 28 | test_requirement: Medium |
| 29 | ai_agent_risk: Low | 29 | ai_agent_risk: Low |
| 30 | source_basis: [현재 코드 분석 기반, 웹 참고 자료 기반] | 30 | source_basis: [현재 코드 분석 기반, 웹 참고 자료 기반] |
| 31 | beginner_section_included: true | 31 | beginner_section_included: true |
| 32 | webmaster_section_included: true | 32 | webmaster_section_included: true |
| 33 | developer_section_included: true | 33 | developer_section_included: true |
| 34 | --- | 34 | --- |
| 35 | 35 | ||
| 36 | # DSclub 제공 서비스 안내 및 주의사항 | 36 | # DSclub 제공 서비스 안내 및 주의사항 |
| 37 | 37 | ||
| 38 | T2Editor는 **dsclub.kr** 커뮤니티에서 개발된 웹 에디터로, 기본적인 편집 기능뿐만 아니라 여러 가지 부가 서비스를 탑재하고 있습니다. 이 문서는 DSclub이 제공하는 서비스(예: AI 작성 도구, T2Search 검색 서비스, T2ClipURL 링크 생성 기능 등)를 간략히 소개하고, 이러한 서비스 사용 시 주의해야 할 사항을 정리합니다. 특히 DSclub 서비스를 활용할 때는 외부 서버에 의존하는 구조가 많기 때문에, 서비스 제공자가 변경되거나 운영이 중단될 경우 에디터의 일부 기능이 작동하지 않을 수 있습니다. 따라서 이러한 위험을 이해하고, 가능하다면 대안이나 자체 서버를 준비하는 것이 좋습니다. | 38 | T2Editor는 **dsclub.kr** 커뮤니티에서 개발된 웹 에디터로, 기본적인 편집 기능뿐만 아니라 여러 가지 부가 서비스를 탑재하고 있습니다. 이 문서는 DSclub이 제공하는 서비스(예: AI 작성 도구, T2Search 검색 서비스, T2ClipURL 링크 생성 기능 등)를 간략히 소개하고, 이러한 서비스 사용 시 주의해야 할 사항을 정리합니다. 특히 DSclub 서비스를 활용할 때는 외부 서버에 의존하는 구조가 많기 때문에, 서비스 제공자가 변경되거나 운영이 중단될 경우 에디터의 일부 기능이 작동하지 않을 수 있습니다. 따라서 이러한 위험을 이해하고, 가능하다면 대안이나 자체 서버를 준비하는 것이 좋습니다. |
| 39 | 39 | ||
| 40 | ## 빠른 요약 | 40 | ## 빠른 요약 |
| 41 | 41 | ||
| 42 | * **AI 플러그인** – LL M 모델을 이용해 문서 작성 및 편집을 도와주는 플러그인입니다. 사용량은 IP 기준 하루 25회, 도메인 기준 하루 50~100회로 제한됩니다[SIR T2Editor 8.1.2 AI·검색 기능 설명](https://sir.kr/boards/g5_plugin/15016). 외부 API 서버(dsclub.kr 또는 Groq API)로 요청을 전송하며, 커뮤니티 운영 상황에 따라 서비스가 중단될 수 있습니다[SIR T2Editor 8.1.2 후속 공지 및 서비스 주의사항](https://sir.kr/boards/g5_plugin/15016). | 42 | * **AI 플러그인** – LL M 모델을 이용해 문서 작성 및 편집을 도와주는 플러그인입니다. 사용량은 IP 기준 하루 25회, 도메인 기준 하루 50~100회로 제한됩니다[SIR T2Editor 8.1.2 AI·검색 기능 설명](https://sir.kr/boards/g5_plugin/15016). 외부 API 서버(dsclub.kr 또는 Groq API)로 요청을 전송하며, 커뮤니티 운영 상황에 따라 서비스가 중단될 수 있습니다[SIR T2Editor 8.1.2 후속 공지 및 서비스 주의사항](https://sir.kr/boards/g5_plugin/15016). |
| 43 | * **T2Search** – 에디터 내부에서 외부 웹 페이지를 검색하고 결과를 인용할 수 있는 검색 서비스입니다[SIR T2Editor 8.1.2 AI·검색 기능 설명](https://sir.kr/boards/g5_plugin/15016). 검색 API는 dsclub.kr에 의존하며, 서버 장애나 서비스 종료 시 기능이 비활성화될 수 있습니다[SIR T2Editor 8.1.2 후속 공지 및 서비스 주의사항](https://sir.kr/boards/g5_plugin/15016). | 43 | * **T2Search** – 에디터 내부에서 외부 웹 페이지를 검색하고 결과를 인용할 수 있는 검색 서비스입니다[SIR T2Editor 8.1.2 AI·검색 기능 설명](https://sir.kr/boards/g5_plugin/15016). 검색 API는 dsclub.kr에 의존하며, 서버 장애나 서비스 종료 시 기능이 비활성화될 수 있습니다[SIR T2Editor 8.1.2 후속 공지 및 서비스 주의사항](https://sir.kr/boards/g5_plugin/15016). |
| 44 | * **T2ClipURL** – 입력한 URL을 단축 링크로 변환하고 QR 코드를 생성해주는 기능입니다[SIR T2Editor 8.1.2 AI·검색 기능 설명](https://sir.kr/boards/g5_plugin/15016). 이 서비스도 DSclub 커뮤니티 서버에 요청을 보내기 때문에, 운영 중단 시 사용할 수 없게 됩니다[SIR T2Editor 8.1.2 후속 공지 및 서비스 주의사항](https://sir.kr/boards/g5_plugin/15016). | 44 | * **T2ClipURL** – 입력한 URL을 단축 링크로 변환하고 QR 코드를 생성해주는 기능입니다[SIR T2Editor 8.1.2 AI·검색 기능 설명](https://sir.kr/boards/g5_plugin/15016). 이 서비스도 DSclub 커뮤니티 서버에 요청을 보내기 때문에, 운영 중단 시 사용할 수 없게 됩니다[SIR T2Editor 8.1.2 후속 공지 및 서비스 주의사항](https://sir.kr/boards/g5_plugin/15016). |
| 45 | * **기타 DSclub 서비스** – NSFW 필터, T2Meme 밈 플러그인, 협업 기능, AI 재정렬 도구 등이 포함됩니다. 대부분은 외부 API 호출을 통해 동작하며, DSclub 서버의 정책이나 라이선스 변화에 영향을 받습니다. | 45 | * **기타 DSclub 서비스** – NSFW 필터, T2Meme 밈 플러그인, 협업 기능, AI 재정렬 도구 등이 포함됩니다. 대부분은 외부 API 호출을 통해 동작하며, DSclub 서버의 정책이나 라이선스 변화에 영향을 받습니다. |
| 46 | 46 | ||
| 47 | ## 초보자와 웹마스터를 위한 이해 | 47 | ## 초보자와 웹마스터를 위한 이해 |
| 48 | 48 | ||
| 49 | ### DSclub 서비스의 개요 | 49 | ### DSclub 서비스의 개요 |
| 50 | 50 | ||
| 51 | 1. **AI 작성 도구**: AI 플러그인은 대규모 언어 모델을 활용해 글을 자동으로 생성하거나, 선택한 문단을 고쳐주는 기능을 제공합니다. 에디터 상단의 AI 버튼을 통해 사용하며, **IP당 25회/일, 도메인당 50~100회/일**로 호출 횟수가 제한됩니다[SIR T2Editor 8.1.2 AI·검색 기능 설명](https://sir.kr/boards/g5_plugin/15016). DSclub 서버의 API를 사용하므로, 서버 접속이 차단되거나 서비스가 종료되면 기능이 동작하지 않습니다[SIR T2Editor 8.1.2 후속 공지 및 서비스 주의사항](https://sir.kr/boards/g5_plugin/15016). | 51 | 1. **AI 작성 도구**: AI 플러그인은 대규모 언어 모델을 활용해 글을 자동으로 생성하거나, 선택한 문단을 고쳐주는 기능을 제공합니다. 에디터 상단의 AI 버튼을 통해 사용하며, **IP당 25회/일, 도메인당 50~100회/일**로 호출 횟수가 제한됩니다[SIR T2Editor 8.1.2 AI·검색 기능 설명](https://sir.kr/boards/g5_plugin/15016). DSclub 서버의 API를 사용하므로, 서버 접속이 차단되거나 서비스가 종료되면 기능이 동작하지 않습니다[SIR T2Editor 8.1.2 후속 공지 및 서비스 주의사항](https://sir.kr/boards/g5_plugin/15016). |
| 52 | 52 | ||
| 53 | 2. **T2Search**: 에디터 내에서 키워드를 검색해 외부 웹 사이트의 내용을 인용할 수 있는 기능입니다. 예를 들어, 뉴스나 블로그 글의 일부를 선택하여 에디터로 바로 삽입할 수 있습니다[SIR T2Editor 8.1.2 AI·검색 기능 설명](https://sir.kr/boards/g5_plugin/15016). 검색 서비스는 DSclub 서버가 제공하는 API에 의존하므로, 서버 장애 시 검색 결과를 가져올 수 없습니다[SIR T2Editor 8.1.2 후속 공지 및 서비스 주의사항](https://sir.kr/boards/g5_plugin/15016). | 53 | 2. **T2Search**: 에디터 내에서 키워드를 검색해 외부 웹 사이트의 내용을 인용할 수 있는 기능입니다. 예를 들어, 뉴스나 블로그 글의 일부를 선택하여 에디터로 바로 삽입할 수 있습니다[SIR T2Editor 8.1.2 AI·검색 기능 설명](https://sir.kr/boards/g5_plugin/15016). 검색 서비스는 DSclub 서버가 제공하는 API에 의존하므로, 서버 장애 시 검색 결과를 가져올 수 없습니다[SIR T2Editor 8.1.2 후속 공지 및 서비스 주의사항](https://sir.kr/boards/g5_plugin/15016). |
| 54 | 54 | ||
| 55 | 3. **T2ClipURL 및 QR 생성기**: 긴 주소를 짧게 변환하거나 QR 코드로 만들어주는 도구입니다. 블로그나 뉴스 링크를 공유할 때 편리하며, 기본적으로 DSclub 서버의 단축 URL API를 사용합니다[SIR T2Editor 8.1.2 AI·검색 기능 설명](https://sir.kr/boards/g5_plugin/15016). 서비스 제공이 중단될 경우 링크 단축 기능이 비활성화될 수 있습니다[SIR T2Editor 8.1.2 후속 공지 및 서비스 주의사항](https://sir.kr/boards/g5_plugin/15016). | 55 | 3. **T2ClipURL 및 QR 생성기**: 긴 주소를 짧게 변환하거나 QR 코드로 만들어주는 도구입니다. 블로그나 뉴스 링크를 공유할 때 편리하며, 기본적으로 DSclub 서버의 단축 URL API를 사용합니다[SIR T2Editor 8.1.2 AI·검색 기능 설명](https://sir.kr/boards/g5_plugin/15016). 서비스 제공이 중단될 경우 링크 단축 기능이 비활성화될 수 있습니다[SIR T2Editor 8.1.2 후속 공지 및 서비스 주의사항](https://sir.kr/boards/g5_plugin/15016). |
| 56 | 56 | ||
| 57 | 4. **NSFW 필터와 밈(Meme) 플러그인**: NSFW 필터는 이미지나 텍스트에 부적절한 내용이 포함됐는지 자동으로 탐지해 경고를 표시합니다. 밈 플러그인은 재미있는 이미지를 검색하고 삽입할 수 있는 기능입니다. 이 역시 DSclub의 API와 연동되어 있으며, 서버 상태나 정책에 영향을 받습니다. | 57 | 4. **NSFW 필터와 밈(Meme) 플러그인**: NSFW 필터는 이미지나 텍스트에 부적절한 내용이 포함됐는지 자동으로 탐지해 경고를 표시합니다. 밈 플러그인은 재미있는 이미지를 검색하고 삽입할 수 있는 기능입니다. 이 역시 DSclub의 API와 연동되어 있으며, 서버 상태나 정책에 영향을 받습니다. |
| 58 | 58 | ||
| 59 | 5. **협업(Collab) 기능**: 여러 사용자가 동시에 한 문서를 편집할 수 있는 협업 기능이 제공됩니다. 이 기능은 `collab` 디렉터리의 파일과 서버‑사이드 세션 처리를 통해 구현됩니다. DSclub 서버와 무관하게 독립적으로 운영할 수 있지만, DSclub의 협업 데모 서비스에 연결하는 옵션도 존재합니다. | 59 | 5. **협업(Collab) 기능**: 여러 사용자가 동시에 한 문서를 편집할 수 있는 협업 기능이 제공됩니다. 이 기능은 `collab` 디렉터리의 파일과 서버‑사이드 세션 처리를 통해 구현됩니다. DSclub 서버와 무관하게 독립적으로 운영할 수 있지만, DSclub의 협업 데모 서비스에 연결하는 옵션도 존재합니다. |
| 60 | 60 | ||
| 61 | ### 서비스 의존성에 대한 주의사항 | 61 | ### 서비스 의존성에 대한 주의사항 |
| 62 | 62 | ||
| 63 | * **서비스 중단 가능성**: DSclub 커뮤니티 운영에 따라 **AI, T2Search, T2ClipURL**과 같은 기능은 공지 없이 지원이 종료될 수 있습니다[SIR T2Editor 8.1.2 후속 공지 및 서비스 주의사항](https://sir.kr/boards/g5_plugin/15016). T2Editor를 장기간 사용하려면 자체 API 백엔드를 마련하거나, 대체 서비스를 준비하는 것이 좋습니다. | 63 | * **서비스 중단 가능성**: DSclub 커뮤니티 운영에 따라 **AI, T2Search, T2ClipURL**과 같은 기능은 공지 없이 지원이 종료될 수 있습니다[SIR T2Editor 8.1.2 후속 공지 및 서비스 주의사항](https://sir.kr/boards/g5_plugin/15016). T2Editor를 장기간 사용하려면 자체 API 백엔드를 마련하거나, 대체 서비스를 준비하는 것이 좋습니다. |
| 64 | 64 | ||
| 65 | * **API 호출 제한**: AI 플러그인 호출 횟수는 IP·도메인 기준으로 제한되며, 다량의 요청 시 거부될 수 있습니다[SIR T2Editor 8.1.2 AI·검색 기능 설명](https://sir.kr/boards/g5_plugin/15016). 작성 도구를 무제한으로 사용하려면 Groq와 같은 별도의 API 키를 발급받아 플러그인을 수정해야 합니다[SIR T2Editor 8.1.2 후속 공지 및 서비스 주의사항](https://sir.kr/boards/g5_plugin/15016). | 65 | * **API 호출 제한**: AI 플러그인 호출 횟수는 IP·도메인 기준으로 제한되며, 다량의 요청 시 거부될 수 있습니다[SIR T2Editor 8.1.2 AI·검색 기능 설명](https://sir.kr/boards/g5_plugin/15016). 작성 도구를 무제한으로 사용하려면 Groq와 같은 별도의 API 키를 발급받아 플러그인을 수정해야 합니다[SIR T2Editor 8.1.2 후속 공지 및 서비스 주의사항](https://sir.kr/boards/g5_plugin/15016). |
| 66 | 66 | ||
| 67 | * **API 키와 라이선스**: DSclub API를 통해 작동하는 서비스에는 라이선스 키가 필요할 수 있습니다. 라이선스 파일이 유실되면 서비스가 동작하지 않으므로, 설치 시 `license.txt` 파일을 백업하고 업데이트 과정에서 유지해야 합니다. | 67 | * **API 키와 라이선스**: DSclub API를 통해 작동하는 서비스에는 라이선스 키가 필요할 수 있습니다. 라이선스 파일이 유실되면 서비스가 동작하지 않으므로, 설치 시 `license.txt` 파일을 백업하고 업데이트 과정에서 유지해야 합니다. |
| 68 | 68 | ||
| 69 | * **보안상의 위험**: AI 플러그인을 수정하여 DSclub 외의 API(예: Groq API)로 직접 연결할 수 있지만, **보안 문제가 발생할 수 있고 수정 범위가 크다**는 점을 명심해야 합니다[SIR T2Editor 8.1.2 댓글 - 외부 API 연동 주의](https://sir.kr/boards/g5_plugin/15016). 무차별적으로 API 주소를 변경하면 인증 토큰이 노출되거나, 브라우저의 CORS 정책에 의해 요청이 차단될 수 있습니다. 수정 전에는 관련 문서와 코드 구조를 충분히 이해하세요. | 69 | * **보안상의 위험**: AI 플러그인을 수정하여 DSclub 외의 API(예: Groq API)로 직접 연결할 수 있지만, **보안 문제가 발생할 수 있고 수정 범위가 크다**는 점을 명심해야 합니다[SIR T2Editor 8.1.2 댓글 - 외부 API 연동 주의](https://sir.kr/boards/g5_plugin/15016). 무차별적으로 API 주소를 변경하면 인증 토큰이 노출되거나, 브라우저의 CORS 정책에 의해 요청이 차단될 수 있습니다. 수정 전에는 관련 문서와 코드 구조를 충분히 이해하세요. |
| 70 | 70 | ||
| 71 | * **네트워크 접근성**: 회사나 학교 네트워크처럼 외부 트래픽이 제한된 환경에서는 DSclub 서비스에 접근하지 못할 수 있습니다. 이 경우 검색, AI, 단축 URL 등 서비스가 일부 혹은 모두 작동하지 않으니 운영 정책을 확인하십시오. | 71 | * **네트워크 접근성**: 회사나 학교 네트워크처럼 외부 트래픽이 제한된 환경에서는 DSclub 서비스에 접근하지 못할 수 있습니다. 이 경우 검색, AI, 단축 URL 등 서비스가 일부 혹은 모두 작동하지 않으니 운영 정책을 확인하십시오. |
| 72 | 72 | ||
| 73 | * **전송되는 데이터 주의**: AI 플러그인과 검색 플러그인은 사용자의 작성 데이터를 외부 서버로 전송합니다. 개인정보나 민감한 내용을 포함한 문서를 작성할 때는 외부 전송 여부를 확인하고, 필요한 경우 플러그인을 비활성화하세요. | 73 | * **전송되는 데이터 주의**: AI 플러그인과 검색 플러그인은 사용자의 작성 데이터를 외부 서버로 전송합니다. 개인정보나 민감한 내용을 포함한 문서를 작성할 때는 외부 전송 여부를 확인하고, 필요한 경우 플러그인을 비활성화하세요. |
| 74 | 74 | ||
| 75 | ## 전문 개발자를 위한 구조 분석 | 75 | ## 전문 개발자를 위한 구조 분석 |
| 76 | 76 | ||
| 77 | ### 플러그인 레이어에서의 통합 방식 | 77 | ### 플러그인 레이어에서의 통합 방식 |
| 78 | 78 | ||
| 79 | 1. **AI 플러그인(`ai.js` / `ai_rearrange.js`)**: 이 플러그인은 DSclub 서버와의 REST API 통신으로 구현되어 있습니다. 주요 함수는 `invokeAICommand()`와 `sendToAI()`로, 선택된 에디터 블록을 직렬화한 뒤 HTTP POST 요청을 수행하고, 응답을 파싱하여 DOM에 삽입합니다. 인증 헤더에는 DSclub 사이트에서 발급받은 라이선스 토큰과 타임스탬프가 포함됩니다. 외부 API로 교체할 때는 이 인증 로직과 CORS 설정을 모두 변경해야 합니다[SIR T2Editor 8.1.2 댓글 - 외부 API 연동 주의](https://sir.kr/boards/g5_plugin/15016). | 79 | 1. **AI 플러그인(`ai.js` / `ai_rearrange.js`)**: 이 플러그인은 DSclub 서버와의 REST API 통신으로 구현되어 있습니다. 주요 함수는 `invokeAICommand()`와 `sendToAI()`로, 선택된 에디터 블록을 직렬화한 뒤 HTTP POST 요청을 수행하고, 응답을 파싱하여 DOM에 삽입합니다. 인증 헤더에는 DSclub 사이트에서 발급받은 라이선스 토큰과 타임스탬프가 포함됩니다. 외부 API로 교체할 때는 이 인증 로직과 CORS 설정을 모두 변경해야 합니다[SIR T2Editor 8.1.2 댓글 - 외부 API 연동 주의](https://sir.kr/boards/g5_plugin/15016). |
| 80 | 80 | ||
| 81 | 2. **T2Search 플러그인**: 검색 플러그인은 `search/search.js`에 구현되어 있으며, `searchKeyword()` 함수가 DSclub API `/api/search/query` 엔드포인트에 GET 요청을 보냅니다. 결과는 JSON 형식으로 전달되며, 파서 함수가 이를 에디터 블록으로 변환합니다. 검색 엔드포인트 주소를 변경하면 기능을 다른 검색 서비스로 대체할 수 있지만, 결과 구조를 맞춰주는 어댑터가 필요합니다. | 81 | 2. **T2Search 플러그인**: 검색 플러그인은 `search/search.js`에 구현되어 있으며, `searchKeyword()` 함수가 DSclub API `/api/search/query` 엔드포인트에 GET 요청을 보냅니다. 결과는 JSON 형식으로 전달되며, 파서 함수가 이를 에디터 블록으로 변환합니다. 검색 엔드포인트 주소를 변경하면 기능을 다른 검색 서비스로 대체할 수 있지만, 결과 구조를 맞춰주는 어댑터가 필요합니다. |
| 82 | 82 | ||
| 83 | 3. **ClipURL 플러그인**: 이 플러그인은 `clipurl/clipurl.js`에서 URL 단축 요청을 DSclub API `/api/clipurl/shorten`으로 POST 전송합니다. 응답으로 반환된 단축 링크를 클립보드에 복사하고 QR 코드 이미지를 생성합니다. 로컬에서 운영하고자 할 경우, 같은 엔드포인트를 제공하는 백엔드 구현이 필요합니다. | 83 | 3. **ClipURL 플러그인**: 이 플러그인은 `clipurl/clipurl.js`에서 URL 단축 요청을 DSclub API `/api/clipurl/shorten`으로 POST 전송합니다. 응답으로 반환된 단축 링크를 클립보드에 복사하고 QR 코드 이미지를 생성합니다. 로컬에서 운영하고자 할 경우, 같은 엔드포인트를 제공하는 백엔드 구현이 필요합니다. |
| 84 | 84 | ||
| 85 | 4. **NSFW 및 Meme 플러그인**: NSFW 필터는 이미지 업로드 시 자동으로 호출되어 부적절한 이미지를 걸러냅니다. 내부적으로는 DSclub 서버의 인공지능 API를 사용하며, JavaScript 코드에서는 `nsfw_api_browser.js`와 `nsfw_api_server.php`가 연동됩니다. 밈 플러그인은 `meme/meme.js`에서 DSclub API로 검색 요청을 보내 밈 이미지를 가져옵니다. 외부 API 제공이 중단되면 필터링 및 이미지 검색 기능이 동작하지 않습니다. | 85 | 4. **NSFW 및 Meme 플러그인**: NSFW 필터는 이미지 업로드 시 자동으로 호출되어 부적절한 이미지를 걸러냅니다. 내부적으로는 DSclub 서버의 인공지능 API를 사용하며, JavaScript 코드에서는 `nsfw_api_browser.js`와 `nsfw_api_server.php`가 연동됩니다. 밈 플러그인은 `meme/meme.js`에서 DSclub API로 검색 요청을 보내 밈 이미지를 가져옵니다. 외부 API 제공이 중단되면 필터링 및 이미지 검색 기능이 동작하지 않습니다. |
| 86 | 86 | ||
| 87 | ### 대체 API를 사용한 확장 전략 | 87 | ### 대체 API를 사용한 확장 전략 |
| 88 | 88 | ||
| 89 | 1. **GROQ API 사용**: DSclub 커뮤니티에서는 사용량 한도를 늘리기 위해 Groq API 키를 발급받아 플러그인의 서버 주소를 교체하는 방법을 제안합니다[SIR T2Editor 8.1.2 후속 공지 및 서비스 주의사항](https://sir.kr/boards/g5_plugin/15016). `ai.js`에서 DSclub API 호출 코드를 찾아 Groq API 엔드포인트로 변경하고, 요청 헤더를 재구성해야 합니다. 변경 작업은 복잡할 수 있으며, 충분한 테스트와 보안 검토가 필요합니다. | 89 | 1. **GROQ API 사용**: DSclub 커뮤니티에서는 사용량 한도를 늘리기 위해 Groq API 키를 발급받아 플러그인의 서버 주소를 교체하는 방법을 제안합니다[SIR T2Editor 8.1.2 후속 공지 및 서비스 주의사항](https://sir.kr/boards/g5_plugin/15016). `ai.js`에서 DSclub API 호출 코드를 찾아 Groq API 엔드포인트로 변경하고, 요청 헤더를 재구성해야 합니다. 변경 작업은 복잡할 수 있으며, 충분한 테스트와 보안 검토가 필요합니다. |
| 90 | 90 | ||
| 91 | 2. **자체 검색 서비스 구축**: T2Search가 중단될 경우, 별도의 검색 엔진(예: ElasticSearch 또는 외부 API)을 구축하고, `search.js`에서 `API_URL`을 변경한 뒤 반환 형식을 맞추는 어댑터를 작성합니다. 결과 파싱과 에디터 블록 변환 로직을 플러그인에 포함해야 합니다. | 91 | 2. **자체 검색 서비스 구축**: T2Search가 중단될 경우, 별도의 검색 엔진(예: ElasticSearch 또는 외부 API)을 구축하고, `search.js`에서 `API_URL`을 변경한 뒤 반환 형식을 맞추는 어댑터를 작성합니다. 결과 파싱과 에디터 블록 변환 로직을 플러그인에 포함해야 합니다. |
| 92 | 92 | ||
| 93 | 3. **단축 URL 서버 구현**: ClipURL 서비스에 의존하지 않고 자체 단축 URL 서버를 구축하려면, 단축 URL 생성 알고리즘과 데이터베이스를 준비한 뒤 `clipurl.js` 내의 요청 주소를 교체합니다. 응답 JSON 구조를 기존 API와 동일하게 하면 프런트엔드 수정 없이 동작합니다. | 93 | 3. **단축 URL 서버 구현**: ClipURL 서비스에 의존하지 않고 자체 단축 URL 서버를 구축하려면, 단축 URL 생성 알고리즘과 데이터베이스를 준비한 뒤 `clipurl.js` 내의 요청 주소를 교체합니다. 응답 JSON 구조를 기존 API와 동일하게 하면 프런트엔드 수정 없이 동작합니다. |
| 94 | 94 | ||
| 95 | ### 위험 요소 및 테스트 포인트 | 95 | ### 위험 요소 및 테스트 포인트 |
| 96 | 96 | ||
| 97 | * 외부 API 호출 부분을 수정할 때는 **CORS 설정**, **인증 헤더**, **Rate Limit** 정책을 모두 고려해야 합니다. 특히 `Access-Control-Allow-Origin` 헤더가 잘못 설정되면 브라우저에서 요청이 차단될 수 있습니다[SIR T2Editor 8.1.2 댓글 - 외부 API 연동 주의](https://sir.kr/boards/g5_plugin/15016). | 97 | * 외부 API 호출 부분을 수정할 때는 **CORS 설정**, **인증 헤더**, **Rate Limit** 정책을 모두 고려해야 합니다. 특히 `Access-Control-Allow-Origin` 헤더가 잘못 설정되면 브라우저에서 요청이 차단될 수 있습니다[SIR T2Editor 8.1.2 댓글 - 외부 API 연동 주의](https://sir.kr/boards/g5_plugin/15016). |
| 98 | * DSclub API는 내부적으로 일부 매개변수의 길이와 형식을 제한합니다. 대체 API로 이동하면 이런 검증 로직도 재구성해야 합니다. | 98 | * DSclub API는 내부적으로 일부 매개변수의 길이와 형식을 제한합니다. 대체 API로 이동하면 이런 검증 로직도 재구성해야 합니다. |
| 99 | * 대체 서버 구축 후에는 기존 DSclub 서버와 동일한 입력에 대해 동일한 응답을 반환하는지 비교 테스트를 수행해야 합니다. 플러그인의 `parseResponse()` 함수를 활용해 단위 테스트를 작성하면 좋습니다. | 99 | * 대체 서버 구축 후에는 기존 DSclub 서버와 동일한 입력에 대해 동일한 응답을 반환하는지 비교 테스트를 수행해야 합니다. 플러그인의 `parseResponse()` 함수를 활용해 단위 테스트를 작성하면 좋습니다. |
| 100 | 100 | ||
| 101 | ## 유지보수 및 운영 팁 | 101 | ## 유지보수 및 운영 팁 |
| 102 | 102 | ||
| 103 | 1. **라이선스 관리**: DSclub에서 제공하는 서비스는 라이선스 파일을 통해 인증됩니다. 업데이트나 서버 이전 시 라이선스 파일이 손상되면 서비스가 중단될 수 있으므로, 항상 백업을 유지하세요. | 103 | 1. **라이선스 관리**: DSclub에서 제공하는 서비스는 라이선스 파일을 통해 인증됩니다. 업데이트나 서버 이전 시 라이선스 파일이 손상되면 서비스가 중단될 수 있으므로, 항상 백업을 유지하세요. |
| 104 | 2. **비상 계획**: DSclub 커뮤니티의 운영 상황이 불안정한 경우, 핵심 기능(검색, AI 등)을 자체 서버로 이전해 두는 것이 좋습니다. 최소한 API 주소를 변경할 수 있는 설정 항목을 남겨 두어야 합니다. | 104 | 2. **비상 계획**: DSclub 커뮤니티의 운영 상황이 불안정한 경우, 핵심 기능(검색, AI 등)을 자체 서버로 이전해 두는 것이 좋습니다. 최소한 API 주소를 변경할 수 있는 설정 항목을 남겨 두어야 합니다. |
| 105 | 3. **보안 점검**: 외부 서비스와 데이터를 주고받을 때는 HTTPS를 사용하고, 토큰과 API 키를 노출하지 않도록 주의합니다. 코드 레벨에서 무단 요청을 차단하는 검증 로직을 추가하세요. | 105 | 3. **보안 점검**: 외부 서비스와 데이터를 주고받을 때는 HTTPS를 사용하고, 토큰과 API 키를 노출하지 않도록 주의합니다. 코드 레벨에서 무단 요청을 차단하는 검증 로직을 추가하세요. |
| 106 | 4. **정기 업데이트 확인**: DSclub 서비스는 새로운 버전이 출시될 때 기능이 변경되거나 서비스가 추가/삭제될 수 있습니다. 공식 공지 사항을 주기적으로 확인하고, 필요 시 플러그인 코드와 설정을 업데이트하세요. | 106 | 4. **정기 업데이트 확인**: DSclub 서비스는 새로운 버전이 출시될 때 기능이 변경되거나 서비스가 추가/삭제될 수 있습니다. 공식 공지 사항을 주기적으로 확인하고, 필요 시 플러그인 코드와 설정을 업데이트하세요. |
| 107 | 107 | ||
| 108 | ## 참고 / 인용 / 비교 자료 | 108 | ## 참고 / 인용 / 비교 자료 |
| 109 | 109 | ||
| 110 | * DSclub 서비스에 대한 운영 공지와 기능 요약: SIR 게시글에서 T2Editor 소식(2026.03.26) 문단에 DSclub 의존 서비스의 중단 가능성이 명시되어 있습니다[SIR T2Editor 8.1.2 후속 공지 및 서비스 주의사항](https://sir.kr/boards/g5_plugin/15016). | 110 | * DSclub 서비스에 대한 운영 공지와 기능 요약: SIR 게시글에서 T2Editor 소식(2026.03.26) 문단에 DSclub 의존 서비스의 중단 가능성이 명시되어 있습니다[SIR T2Editor 8.1.2 후속 공지 및 서비스 주의사항](https://sir.kr/boards/g5_plugin/15016). |
| 111 | * DSclub AI 플러그인과 검색, ClipURL 기능의 기본 제공 내용 및 호출 제한 안내[SIR T2Editor 8.1.2 AI·검색 기능 설명](https://sir.kr/boards/g5_plugin/15016). | 111 | * DSclub AI 플러그인과 검색, ClipURL 기능의 기본 제공 내용 및 호출 제한 안내[SIR T2Editor 8.1.2 AI·검색 기능 설명](https://sir.kr/boards/g5_plugin/15016). |
| 112 | * AI 플러그인을 외부 API로 대체할 때 보안 문제와 수정 범위를 설명한 댓글 토론[SIR T2Editor 8.1.2 댓글 - 외부 API 연동 주의](https://sir.kr/boards/g5_plugin/15016). | 112 | * AI 플러그인을 외부 API로 대체할 때 보안 문제와 수정 범위를 설명한 댓글 토론[SIR T2Editor 8.1.2 댓글 - 외부 API 연동 주의](https://sir.kr/boards/g5_plugin/15016). |
| 113 | 113 | ||
| 114 | 이 문서는 현재 분석 중인 T2Editor 9.0.0 버전을 기준으로 작성되었으며, DSclub 커뮤니티의 서비스 정책과 API 상태에 따라 내용이 변경될 수 있습니다. 서비스 제공자가 약관을 수정하거나 API를 중단할 경우, 해당 기능을 유지하려면 코드와 서버 설정을 적절히 수정해야 합니다. | 114 | 이 문서는 현재 분석 중인 T2Editor 9.0.0 버전을 기준으로 작성되었으며, DSclub 커뮤니티의 서비스 정책과 API 상태에 따라 내용이 변경될 수 있습니다. 서비스 제공자가 약관을 수정하거나 API를 중단할 경우, 해당 기능을 유지하려면 코드와 서버 설정을 적절히 수정해야 합니다. |