플러그인: ai (10.2.0에서 ai_complex 로 통폐합)

이 문서는 2026-09-28에 내용을 교체했습니다. 이 문서가 예전 지목하던 plugin/ai/와 plugin/ai_rearrange/는 10.2.0에서 plugin/ai_complex/(T2Editor complex AI)으로 통폐합되어 10.5.1 배포판에 존재하지 않습니다. 두 플러그인의 기능을 찾으려다 파일을 만들어 넣는 개발자가 많습니다 — 로드되지 않습니다. 실제 AI 기능 설명은 이 문서에 포함되어 있습니다. 슬러그 plugin-ai는 위키에 이미 링크가 있으므로 유지했습니다(삭제·이름변경 제안은 적용하지 않음).

플러그인 개요

T2Editor complex AI는 10.2.0에서 도입된 AI 공통 베이스 시스템으로, plugin/ai_complex/에 있습니다. plugin/ai/와 plugin/ai_rearrange/는 10.2.0에서 이 플러그인으로 통폐합되어 10.5.1 배포판에 존재하지 않습니다.

plugin/ai_complex/ai_complex.js     ← 클라이언트 (5,141줄)
plugin/ai_complex/ai_complex.css
plugin/ai_complex/api.core.php      ← 서버 처리
plugin/ai_complex/api.php           ← 엔드포인트
plugin/ai_complex/button.json       ← 버튼 등록
plugin/ai_complex/hooks.js          ← 제출·복원 훅
plugin/ai_complex/locales/{ko,en,ja,zh}.json

왜 단순 플러그인이 아니게 되었는가

10.2.0 릴리즈 노트 원문(요지): "10.2.0부터 T2Editor AI는 단순한 플러그인이 아닌, T2Editor 위에서 AI가 에디터를 쉽게 조작하고, 환각에 적게 걸릴 수 있도록 제어 및 각종 도구들을 사용할 수 있도록 돕는 공통 베이스 시스템(t2llm.js, t2ai_core.js)으로 진화하였습니다 … llm api 셀프 호스팅이 가능하도록 변경 및 T2Editor AI의 모듈화를 진행하여 쉽게 T2Editor AI를 위한 각자의 Tool(도구)을 추가 및 삭제할 수 있습니다."

코어에도 이 통폐합이 주석으로 남아 있습니다 — editor.core.php의 플러그인 등록 기본값에 다음 한 줄이 실재합니다:

'ai_complex', // v10.2.0: ai + ai_rearrange 통폐합 (T2LLM 연동)

초보자와 웹마스터를 위한 기능 설명

주요 역할: 게시물을 쓰고·고치는 AI 기능입니다. 기존에는 사용자 → AI 단방향 '지시'·'입력'으로만 수정이 가능했고, 10.2.0부터 '채팅'과 '지시'를 통해 작성·수정·개선이 가능해졌습니다. 툴바의 AI 버튼(openAiComplex)으로 엽니다.
사용 시나리오: 글쓰기 화면의 AI 버튼(라벨 AI 글쓰기 · 재구성)을 누릅니다. 10.3.0부터 응답이 실시간 스트리밍으로 표시되며 중단돼도 생성된 내용은 최대한 보존됩니다.
권한 및 설정: 업로드를 수행하는 플러그인은 공용 데이터 디렉터리(data/)에 쓰기 권한이 있어야 합니다(최소 권장 707). collab/ 폴더를 만들지 마십시오 — 협업 데이터는 data/t2editor_db/collab/에 있고 에디터가 자동 생성합니다.

초보자는 플러그인의 코드를 수정할 필요 없이, 제공되는 설정과 기본 동작을 활용해 에디터를 사용할 수 있습니다.

기본 제공 도구 (10.2.0)

에디터 편집 · T2Search(웹 서치) · T2Meme(밈 이미지) · T2ClipURL(단축링크 및 QR 생성) · 오픈 웹 서치(dsclub에 종속되지 않는 웹 서치) · 이미지 삽입 · 날짜 계산 · 문서 통계 · 시간대 확인 · 문서 내보내기 · 실시간 날씨 정보 · draw 플러그인 직접 조작으로 그림 그리기 · 이미지 인식(비전) · 목차 생성 · 장기 기억 · 기억 압축 · 작성 중 콘텐츠 내 검색 · 채팅에서의 시각 자료 표현

시그니처 기능

작업량 설정 · 자체 사고 확대 모드 · 외부 API 연동 개발을 돕는 API 예제 첨부 · Skill(Skill-lite) 지원

등록

button.json에 command: "openAiComplex"·order: 18로 등록돼 있습니다. editor.lib.php를 고쳐 등록하지 마십시오 — 그 파일은 43줄짜리 부트스트랩이고 플러그인 등록 심볼이 없습니다. 등록 규칙은 60-plugin-development-guide.md를 따르십시오.

도구(Tool) 추가·삭제

10.2.0부터 모듈화되어 각자의 도구를 추가·삭제할 수 있습니다. extend/js/t2ai_tool_*.js 형태의 확장 지점을 사용하십시오. [확인 필요] — t2llm.js·t2ai_core.js의 v10.5.1 실물 위치는 확인하지 못했습니다.

사용량

기본 제공 API를 쓰면 IP·서버 도메인별 한도가 있고 화면에 남은 양과 한도가 표시됩니다(10.3.0). 한도 값은 서버 응답값이라 문서에 수치를 적지 않습니다. 10.2.0부터 LLM API를 직접 셀프 호스팅해 이 한도를 쓰지 않을 수 있습니다.

전문 개발자를 위한 구조 분석

내부 메서드

plugin/ai_complex/ai_complex.js는 5,141줄 규모입니다. 이 규모에서 메서드 목록을 나열한 문서는 실용성이 없습니다(무엇을 보면 되는지 알려주지 않기 때문). 대신 아래 순서로 읽으십시오.

button.json에서 진입 커맨드를 확인합니다(openAiComplex).
editor.core.php:118의 'ai_complex' => 3에서 로딩 순서를 확인합니다.
hooks.js에서 제출·복원 훅을 확인합니다.
ai_complex.js에서 ensureT2LLM(LLM 연결 초기화)·loadLimits(한도 조회)·applyRateLimitPayload·appendResultActions(결과 액션)·buildPromptHintsHTML(프롬프트 힌트)·estimateTokensFromChars(예상 토큰)·splitIntoSentences(문장 분할) 계열을 먼저 확인합니다.
api.php/api.core.php에서 서버 처리와 인증 헤더(X-T2Editor-License·X-DSCLUB-SIGN·X-T2Editor-Verify)를 확인합니다.

이전 문서가 열거한 getRateLimitBadgeHTML·updateRateLimitDisplay·showAiInfoPopup은 10.5.1에 존재하지 않습니다. 한도 표시와 팝업은 loadLimits·applyRateLimitPayload가 담당합니다. 문서를 수정할 때 메서드명을 옮기지 말고 실물에서 확인하십시오.

초기화 및 이벤트 흐름

플러그인은 에디터 초기화 과정에서 button.json과 core.js의 우선순위 로딩을 통해 등록됩니다. editor.lib.php의 $plugin_priority 배열은 10.5.1에 존재하지 않습니다.

UI 요소와 스타일

ai_complex.css가 이 플러그인의 UI 컴포넌트 스타일을 정의합니다. 스타일을 수정할 때에는 core.css 및 dark.css와의 충돌을 방지하고, 스킨을 사용하는 경우 스킨에서 재정의할 수 있는 구조를 따라야 합니다.

확장 포인트 및 안전한 수정 방법

새로운 기능을 추가하려면 플러그인의 JS 클래스에 메서드를 추가하고, 버튼과 커맨드를 button.json에 연결해야 합니다.
기존 기능을 수정할 때에는 입력 값과 상태 변화를 면밀히 추적하고, 다른 플러그인에 미치는 영향을 검토해야 합니다.
플러그인의 CSS 수정 시, 클래스 명은 가능한 한 고유하게 유지하고 core 스타일을 오버라이드하지 않도록 주의하세요.

테스트 포인트

플러그인 설치 후 브라우저 콘솔에 오류 메시지가 없는지 확인합니다.
다양한 브라우저와 기기에서 UI가 깨지지 않는지 점검합니다.
플러그인 기능이 다른 플러그인과 충돌하지 않고 제대로 작동하는지 테스트합니다.

AI agent 작업 규칙

AI agent는 플러그인 코드를 수정할 때 반드시 이 문서와 관련된 코어 파일 문서를 먼저 읽어야 합니다.
Stable Anchor로 표시된 구조를 기반으로 수정하면 버전 간 안정성을 높일 수 있습니다.
Version-Bound로 표시된 부분은 버전 업데이트 시 변경될 수 있으므로, 수정 전 최신 문서를 확인하세요.

참고 / 인용 / 비교 자료

이 문서는 10.2.0에서 신설된 ai_complex를 설명합니다. plugin/ai·plugin/ai_rearrange는 같은 판본에서 통폐합되어 존재하지 않습니다.
기능 목록과 버전 히스토리: DSclub T2Editor 서비스 페이지
설치 및 오류 대처법: DSclub T2Editor 서비스 페이지 - 설치·오류 안내
라이선스 조항: DSclub T2Editor 서비스 페이지 - 라이선스 안내
플러그인 개발 절차: 60-plugin-development-guide.md
오류 대처: 71-error-handling-guide.md

내가 틀릴 수 있는 것 3가지

t2llm.js·t2ai_core.js의 v10.5.1 실물 위치를 확인하지 못했습니다. 릴리즈 노트는 10.2.0 기준 서술이고 js/에는 두 파일이 없습니다. [확인 필요]로 남겼습니다.
related_functions의 9개 이름을 전수 grep으로 확인한 것이 아니라, 문안관이 실측했다고 보고한 목록을 그대로 옮겼습니다. closeModal·escapeHtml 외 7개는 "10.5.1에 실재한다"는 전제이며, 제가 재확인하지 않았습니다.
plugin-ai_complex 라는 별도 위키 문서를 만들지 않았습니다. 방장 확정 레지스트리에 없는 슬러그를 발명하지 않기 위해 AI 설명을 이 문서 안에 포함했습니다. 분리 문서를 원하시면 방장 결정이 필요합니다(详见 final/_DELETE-OR-REVIEW.md).