nai-aclab 1.0.7 → 1.0.8

package/README.md

@@ -68,6 +68,8 @@ API 토큰을 아직 넣고 싶지 않다면 `목업 모드 사용`을 켜둔
 
 대부분의 사용자는 `Endpoint`, `Model`, `Sampler`, `Noise Schedule` 같은 값은 기본값 그대로 두면 됩니다.
 
+![API 설정 메뉴](docs/screenshots/07-api-settings.png)
+
 ## 기본 사용 순서
 
 ### 1. 작가 태그 등록
@@ -91,6 +93,8 @@ artist:sample_a
 
 `선택 태그 수`를 비워두면 그 카테고리에 적은 작가 태그를 모두 사용합니다. 일부만 랜덤으로 뽑고 싶을 때만 숫자를 입력하면 됩니다.
 
+![작가 태그 메뉴](docs/screenshots/02-artists.png)
+
 ### 2. 프리셋 만들기
 
 `프리셋` 메뉴에서 자주 쓸 프롬프트를 저장합니다.
@@ -109,6 +113,8 @@ artist:sample_a
 
 NovelAI V4+의 멀티 캐릭터 프롬프트는 캐릭터를 쉼표로 합치지 않고 `|`로 나눕니다.
 
+![프리셋 메뉴](docs/screenshots/03-presets.png)
+
 ### 3. 이미지 생성
 
 `생성` 메뉴에서 사용할 프리셋과 이미지 크기를 고른 뒤 `이미지 생성`을 누릅니다.
@@ -119,6 +125,8 @@ NovelAI V4+의 멀티 캐릭터 프롬프트는 캐릭터를 쉼표로 합치지
 
 고정된 가중치를 해제하고 싶으면 생성 메뉴에서 `고정 해제`를 누르면 됩니다.
 
+![생성 메뉴](docs/screenshots/01-generate.png)
+
 ## 주요 메뉴 설명
 
 ### 생성
@@ -161,12 +169,16 @@ NovelAI V4+의 멀티 캐릭터 프롬프트는 캐릭터를 쉼표로 합치지
 - 히스토리 선택 삭제 또는 전체 삭제
 - 이상형 월드컵 실행
 
+![히스토리 메뉴](docs/screenshots/05-history.png)
+
 ### 가중치 비교
 
 한 히스토리 안에서 생성된 이미지들을 옆으로 훑어보며, 각 이미지에 어떤 작가 가중치가 쓰였는지 비교하는 화면입니다.
 
 여기서도 마음에 드는 이미지의 `가중치 불러오기`를 누를 수 있습니다.
 
+![가중치 비교 메뉴](docs/screenshots/06-weight-compare.png)
+
 ### 이상형 월드컵
 
 히스토리 이미지 중에서 두 장씩 비교하며 가장 마음에 드는 이미지를 고르는 기능입니다.
@@ -193,6 +205,8 @@ NovelAI V4+의 멀티 캐릭터 프롬프트는 캐릭터를 쉼표로 합치지
 
 생성 중 멈추고 싶으면 `생성 중지`를 누르면 됩니다. 현재 처리 중인 이미지가 끝난 뒤 남은 생성을 멈춥니다.
 
+![타율 테스트 메뉴](docs/screenshots/04-batting-test.png)
+
 ## 이미지 크기
 
 생성 메뉴에서 아래 크기 중 하나를 고를 수 있습니다.
@@ -205,9 +219,16 @@ NovelAI V4+의 멀티 캐릭터 프롬프트는 캐릭터를 쉼표로 합치지
 
 앱 설정과 생성 이미지는 내 컴퓨터에 저장됩니다.
 
-- Windows: `%APPDATA%\NAI Artist Combination Lab`
-- macOS: `~/Library/Application Support/NAI Artist Combination Lab`
-- Linux: `~/.local/share/nai-artist-combination-lab`
+기본적으로 운영체제의 사진/그림 폴더 아래에 앱 폴더를 만들고, 그 안에 설정과 생성 이미지를 함께 저장합니다.
+
+- Windows: `Pictures\NAI Artist Combination Lab`
+- macOS: `~/Pictures/NAI Artist Combination Lab`
+- Linux: `XDG_PICTURES_DIR/NAI Artist Combination Lab`
+
+폴더 안의 구조는 아래처럼 나뉩니다.
+
+- `data`: 앱 설정과 API 토큰 secret 파일
+- `outputs`: 생성된 이미지
 
 API 토큰은 일반 설정 파일에 저장하지 않고 별도 secret store에 저장합니다. 앱 화면으로 다시 내려보내지도 않습니다.
 

package/app.py

@@ -23,12 +23,30 @@ except Exception:
 
 
 APP_DIR = Path(__file__).resolve().parent
-USER_DIR = Path(
-    os.environ.get(
-        "NAI_ARTIST_LAB_USER_DIR",
-        str(APP_DIR),
-    )
-)
+
+
+def default_pictures_dir() -> Path:
+    if os.name != "nt":
+        user_dirs = Path.home() / ".config" / "user-dirs.dirs"
+        try:
+            for line in user_dirs.read_text(encoding="utf-8").splitlines():
+                if line.startswith("XDG_PICTURES_DIR="):
+                    value = line.split("=", 1)[1].strip().strip('"')
+                    value = value.replace("$HOME", str(Path.home()))
+                    return Path(value).expanduser()
+        except OSError:
+            pass
+    return Path.home() / "Pictures"
+
+
+def default_user_dir() -> Path:
+    configured = os.environ.get("NAI_ARTIST_LAB_USER_DIR", "").strip()
+    if configured:
+        return Path(configured).expanduser()
+    return default_pictures_dir() / "NAI Artist Combination Lab"
+
+
+USER_DIR = default_user_dir()
 DATA_DIR = USER_DIR / "data"
 OUTPUT_DIR = USER_DIR / "outputs"
 STATE_PATH = DATA_DIR / "app_state.json"
@@ -141,7 +159,8 @@ def output_ref(path_value: str) -> str:
     path = Path(raw)
     try:
         if path.is_absolute():
-            return str(path.resolve().relative_to(OUTPUT_DIR.resolve())).replace("\\", "/")
+            resolved = path.resolve()
+            return str(resolved.relative_to(OUTPUT_DIR.resolve())).replace("\\", "/")
     except (OSError, ValueError):
         return path.name
     return raw.replace("\\", "/")

package/bin/nai-artist-lab.js

@@ -15,16 +15,16 @@ function userDataDir() {
   }
 
   if (process.platform === "win32") {
-    return path.join(process.env.APPDATA || os.homedir(), "NAI Artist Combination Lab");
+    return path.join(os.homedir(), "Pictures", "NAI Artist Combination Lab");
   }
 
   if (process.platform === "darwin") {
-    return path.join(os.homedir(), "Library", "Application Support", "NAI Artist Combination Lab");
+    return path.join(os.homedir(), "Pictures", "NAI Artist Combination Lab");
   }
 
   return path.join(
-    process.env.XDG_DATA_HOME || path.join(os.homedir(), ".local", "share"),
-    "nai-artist-combination-lab"
+    process.env.XDG_PICTURES_DIR || path.join(os.homedir(), "Pictures"),
+    "NAI Artist Combination Lab"
   );
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nai-aclab",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "Local web UI for experimenting with NovelAI artist tag weight combinations.",
   "license": "MIT",
   "type": "commonjs",

package/web/index.html

@@ -18,16 +18,18 @@
         </div>
         <nav class="nav" aria-label="Main">
           <button class="nav-item active" data-tab="generate">⌘ 생성</button>
-          <button class="nav-item" data-tab="batting">▦ 타율 테스트</button>
-          <button class="nav-item" data-tab="artists"># 작가 태그</button>
-          <button class="nav-item" data-tab="presets">▣ 프리셋</button>
-          <button class="nav-item" data-tab="settings">⚙ API 설정</button>
-          <button class="nav-item" data-tab="compare">≋ 가중치 비교</button>
-          <button class="nav-item" data-tab="history">◈ 히스토리</button>
-        </nav>
-        <div class="sidebar-footer">
-          <span id="saveState">준비됨</span>
-        </div>
+          <button class="nav-item" data-tab="batting">▦ 타율 테스트</button>
+          <button class="nav-item" data-tab="artists"># 작가 태그</button>
+          <button class="nav-item" data-tab="presets">▣ 프리셋</button>
+          <button class="nav-item" data-tab="compare">≋ 가중치 비교</button>
+          <button class="nav-item" data-tab="history">◈ 히스토리</button>
+        </nav>
+        <div class="sidebar-tools">
+          <button class="nav-item settings-nav-item" data-tab="settings">⚙ API 설정</button>
+        </div>
+        <div class="sidebar-footer">
+          <span id="saveState">준비됨</span>
+        </div>
       </aside>
 
       <main class="workspace">

package/web/main.js

@@ -655,15 +655,30 @@ function renderHistory() {
   const history = state.history[historyIndex];
   const detail = $("#historyDetail");
   detail.innerHTML = "";
-  if (!history) {
-    detail.innerHTML = `<p>아직 생성 히스토리가 없습니다.</p>`;
-    return;
-  }
-  const modalItems = (history.items || [])
-    .map((item, index) => enrichedImageItem(item, { history, label: `#${index + 1}` }))
-    .filter((item) => item.image_url);
-  (history.items || []).forEach((item, index) => {
-    detail.appendChild(renderImageCard(item, { history, label: `#${index + 1}`, modalItems }));
+  if (!history) {
+    detail.innerHTML = `<p>아직 생성 히스토리가 없습니다.</p>`;
+    return;
+  }
+  const actions = document.createElement("div");
+  actions.className = "history-detail-actions";
+  const info = document.createElement("div");
+  const title = document.createElement("strong");
+  title.textContent = `${history.base_preset || ""} + ${history.character_preset || ""}`;
+  const meta = document.createElement("span");
+  meta.textContent = `${history.created_at || ""} · ${(history.items || []).length}장`;
+  info.append(title, meta);
+  const openButton = document.createElement("button");
+  openButton.className = "ghost-button";
+  openButton.type = "button";
+  openButton.textContent = "저장 폴더 열기";
+  openButton.onclick = () => openHistoryFolder(history);
+  actions.append(info, openButton);
+  detail.appendChild(actions);
+  const modalItems = (history.items || [])
+    .map((item, index) => enrichedImageItem(item, { history, label: `#${index + 1}` }))
+    .filter((item) => item.image_url);
+  (history.items || []).forEach((item, index) => {
+    detail.appendChild(renderImageCard(item, { history, label: `#${index + 1}`, modalItems }));
   });
 }
 
@@ -1171,7 +1186,7 @@ async function deleteSelectedHistory() {
   setSaveState("히스토리 삭제됨");
 }
 
-async function clearHistory() {
+async function clearHistory() {
   if (!state.history.length) return;
   const deleteFiles = $("#deleteFilesToggle").checked;
   const ok = window.confirm(`전체 히스토리 ${state.history.length}개를 삭제할까요?${deleteFiles ? " 출력 파일도 함께 삭제됩니다." : ""}`);
@@ -1186,9 +1201,22 @@ async function clearHistory() {
   renderHistory();
   renderCompare();
   setSaveState("히스토리 전체 삭제됨");
-}
-
-function selectAllHistory() {
+}
+
+async function openHistoryFolder(history) {
+  if (!history?.id) return;
+  try {
+    await request("/api/history/open", {
+      method: "POST",
+      body: JSON.stringify({ id: history.id }),
+    });
+    setSaveState("저장 폴더를 열었습니다");
+  } catch {
+    setSaveState("저장 폴더를 찾을 수 없습니다");
+  }
+}
+
+function selectAllHistory() {
   const allSelected = state.history.length > 0 && state.history.every((item) => selectedHistoryIds.has(item.id));
   selectedHistoryIds = allSelected ? new Set() : new Set(state.history.map((item) => item.id));
   renderHistory();

package/web/styles.css

@@ -111,14 +111,44 @@ button {
   border-color: var(--line);
 }
 
-.sidebar-footer {
+.sidebar-tools {
   margin-top: auto;
-  color: var(--muted);
+  display: grid;
+  gap: 8px;
+}
+
+.settings-nav-item {
+  border-color: rgba(94, 224, 184, 0.22);
+  background: rgba(94, 224, 184, 0.06);
+}
+
+.sidebar-footer {
+  color: #dce8e4;
   font-size: 12px;
-  padding: 12px;
-  border: 1px solid var(--line-soft);
+  font-weight: 650;
+  padding: 12px 12px 12px 14px;
+  border: 1px solid rgba(94, 224, 184, 0.24);
+  border-left: 3px solid var(--accent);
   border-radius: 8px;
-  background: rgba(255, 255, 255, 0.025);
+  background:
+    linear-gradient(135deg, rgba(94, 224, 184, 0.14), rgba(140, 182, 255, 0.08)),
+    rgba(20, 24, 28, 0.82);
+  box-shadow: 0 10px 30px rgba(0, 0, 0, 0.24);
+}
+
+#saveState {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+
+#saveState::before {
+  content: "";
+  width: 7px;
+  height: 7px;
+  border-radius: 999px;
+  background: var(--accent);
+  box-shadow: 0 0 14px rgba(94, 224, 184, 0.72);
 }
 
 .workspace {
@@ -690,6 +720,29 @@ pre {
   gap: 12px;
 }
 
+.history-detail-actions {
+  grid-column: 1 / -1;
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  gap: 14px;
+  padding: 14px;
+  border: 1px solid var(--line-soft);
+  border-radius: 8px;
+  background: rgba(255, 255, 255, 0.025);
+}
+
+.history-detail-actions strong,
+.history-detail-actions span {
+  display: block;
+}
+
+.history-detail-actions span {
+  margin-top: 4px;
+  color: var(--muted);
+  font-size: 12px;
+}
+
 .live-gallery {
   display: grid;
   grid-template-columns: repeat(auto-fill, minmax(190px, 1fr));

package/web_app.py

@@ -2,9 +2,11 @@ from __future__ import annotations
 
 import json
 import mimetypes
+import os
 import random
 import secrets
 import shutil
+import subprocess
 import sys
 import threading
 import time
@@ -80,17 +82,35 @@ def state_from_dict(data: dict) -> AppState:
 
 
 def media_url(path: str) -> str:
+    resolved = resolve_output_path(path)
+    if not resolved:
+        return ""
     try:
-        raw = str(path or "")
-        candidate = Path(raw)
-        root = OUTPUT_DIR.resolve()
-        resolved = candidate.resolve() if candidate.is_absolute() else (root / candidate).resolve()
-        rel = resolved.relative_to(root)
+        rel = resolved.relative_to(OUTPUT_DIR.resolve())
     except (ValueError, OSError):
         return ""
     return "/media/" + urllib.parse.quote(str(rel).replace("\\", "/"))
 
 
+def resolve_output_path(path: str, expect_dir: bool = False) -> Path | None:
+    raw = str(path or "").strip()
+    if not raw:
+        return None
+    candidate = Path(raw)
+    try:
+        if candidate.is_absolute():
+            resolved = candidate.resolve()
+            resolved.relative_to(OUTPUT_DIR.resolve())
+            return resolved
+        resolved = (OUTPUT_DIR / candidate).resolve()
+        resolved.relative_to(OUTPUT_DIR.resolve())
+        if resolved.exists() or not expect_dir:
+            return resolved
+    except (ValueError, OSError):
+        return None
+    return None
+
+
 def safe_child_path(root: Path, rel: str) -> Path | None:
     try:
         root_resolved = root.resolve()
@@ -101,6 +121,15 @@ def safe_child_path(root: Path, rel: str) -> Path | None:
         return None
 
 
+def open_in_file_manager(path: Path) -> None:
+    if os.name == "nt":
+        os.startfile(path)  # type: ignore[attr-defined]
+    elif sys.platform == "darwin":
+        subprocess.Popen(["open", str(path)], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+    else:
+        subprocess.Popen(["xdg-open", str(path)], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+
+
 def state_payload(state: AppState) -> dict:
     data = asdict(state)
     data.setdefault("api", {})["token"] = ""
@@ -236,10 +265,8 @@ def delete_history_entries(ids: list[str], delete_files: bool) -> AppState:
             raw_dir = history.get("output_dir", "")
             if not raw_dir:
                 continue
-            try:
-                raw_path = Path(raw_dir)
-                target = raw_path.resolve() if raw_path.is_absolute() else (OUTPUT_DIR / raw_path).resolve()
-            except OSError:
+            target = resolve_output_path(raw_dir, expect_dir=True)
+            if not target:
                 continue
             if target == output_root or output_root not in target.parents:
                 continue
@@ -248,6 +275,11 @@ def delete_history_entries(ids: list[str], delete_files: bool) -> AppState:
     return load_state()
 
 
+def history_by_id(history_id: str) -> dict | None:
+    state = load_state()
+    return next((item for item in state.history if item.get("id") == history_id), None)
+
+
 def clear_history(delete_files: bool) -> AppState:
     with STATE_LOCK:
         state = load_state()
@@ -561,6 +593,14 @@ class Handler(BaseHTTPRequestHandler):
         elif route == "/api/history/clear":
             state = clear_history(bool(data.get("delete_files", False)))
             self.send_json({"state": state_payload(state)})
+        elif route == "/api/history/open":
+            history = history_by_id(str(data.get("id", "")))
+            target = resolve_output_path((history or {}).get("output_dir", ""), expect_dir=True)
+            if not history or not target or not target.exists() or not target.is_dir():
+                self.send_json({"error": "저장 폴더를 찾을 수 없습니다."}, status=404)
+                return
+            open_in_file_manager(target)
+            self.send_json({"ok": True})
         else:
             self.send_error(404)