@lrplrplrp/dsh-live2d 0.1.0

package/lib/index.js

@@ -0,0 +1,642 @@
+// dsh-live2d — Host (Node) side.
+//
+// 职责：
+//   1. 监听 DSH 会话事件，跟踪当前 Agent 状态（IDLE / THINKING / WORKING / SUCCESS / ERROR）
+//   2. 注册 webserver 路由，供客户端轮询状态、读写配置、加载本地库文件和模型资源
+//
+// 客户端行为（Live2D 渲染、拖动、设置页）全部在 client.js 中。
+
+import { createRequire } from 'node:module'
+import { createReadStream, statSync, existsSync, mkdirSync, writeFileSync, rmSync, readdirSync, readFileSync } from 'node:fs'
+import { join, extname, dirname, resolve, sep } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const require = createRequire(import.meta.url)
+
+// ── 路径解析 ──────────────────────────────────────────────────────────
+// 多种方式尝试解析 __dirname，兼容不同运行环境
+let resolvedDir
+try {
+  resolvedDir = dirname(fileURLToPath(import.meta.url))
+} catch {}
+if (!resolvedDir) {
+  try { resolvedDir = import.meta.dirname } catch {}
+}
+if (!resolvedDir) {
+  try { resolvedDir = dirname(new URL(import.meta.url).pathname) } catch {}
+}
+if (!resolvedDir) {
+  // fallback: 使用 require.resolve 找到 package.json 的位置
+  try {
+    const pkgPath = require.resolve('../package.json')
+    resolvedDir = dirname(pkgPath)
+  } catch {}
+}
+
+const PLUGIN_ROOT = resolvedDir ? join(resolvedDir, '..') : null
+const LIB_DIR = PLUGIN_ROOT ? join(PLUGIN_ROOT, 'lib') : null
+const ASSETS_DIR = PLUGIN_ROOT ? join(PLUGIN_ROOT, 'assets') : null
+
+export const name = 'dsh-live2d'
+
+const STATE_ENDPOINT = '/plugins/dsh-live2d/state'
+const CONFIG_ENDPOINT = '/plugins/dsh-live2d/config'
+
+// ── MIME 类型 ─────────────────────────────────────────────────────────
+const MIME = {
+  '.js': 'application/javascript; charset=utf-8',
+  '.json': 'application/json; charset=utf-8',
+  '.png': 'image/png',
+  '.jpg': 'image/jpeg',
+  '.jpeg': 'image/jpeg',
+  '.gif': 'image/gif',
+  '.webp': 'image/webp',
+  '.moc3': 'application/octet-stream',
+}
+
+function guessMime(filePath) {
+  const ext = extname(filePath).toLowerCase()
+  return MIME[ext] || 'application/octet-stream'
+}
+
+// ── DSH 状态常量 ──────────────────────────────────────────────────────
+const DSHState = Object.freeze({
+  IDLE: 'IDLE',
+  THINKING: 'THINKING',
+  WORKING: 'WORKING',
+  SPEAKING: 'SPEAKING', // 开始输出对话内容
+  SUCCESS: 'SUCCESS',
+  ERROR: 'ERROR',
+})
+
+// ── 当前状态（内存，客户端轮询读取） ──────────────────────────────────
+let currentState = DSHState.IDLE
+let stateUpdatedAt = Date.now()
+
+// ── 工具调用跟踪 ──────────────────────────────────────────────────────
+const openTools = new Map()
+let waitingCallId = undefined
+
+function toolCallIdOf(event, fallback) {
+  const data = event?.data || {}
+  const msg = data.message || {}
+  const content = msg.content
+  const contentCallId = Array.isArray(content)
+    ? content.find((item) => item?.toolCallId)?.toolCallId
+    : undefined
+  return String(
+    data.message?.source?.callId
+    ?? contentCallId
+    ?? msg.toolCallId
+    ?? msg.callId
+    ?? data.callId
+    ?? fallback
+  )
+}
+
+function isUserQuestionTool(name) {
+  const value = String(name || '').toLowerCase()
+  const tokens = value.split(/[^a-z0-9]+/u).filter(Boolean)
+  const asks = new Set(['ask', 'asking', 'request', 'requests', 'prompt', 'needs', 'need', 'get', 'gets'])
+  const filler = new Set(['for', 'from', 'the', 'a', 'an'])
+  const userWords = new Set(['user', 'human', 'me'])
+  const nouns = new Set(['question', 'questions', 'input', 'answer', 'answers', 'decision', 'confirmation', 'approval', 'permission'])
+  const hasAsk = tokens.some((token, index) => {
+    if (!asks.has(token)) return false
+    let cursor = index + 1
+    while (cursor < tokens.length && (filler.has(tokens[cursor]) || userWords.has(tokens[cursor]))) {
+      if (userWords.has(tokens[cursor])) {
+        const next = tokens[cursor + 1]
+        return !next || nouns.has(next)
+      }
+      cursor += 1
+    }
+    return cursor < tokens.length && nouns.has(tokens[cursor])
+  })
+  const submitsPlanForApproval = tokens.some((token, index) =>
+    token === 'exit' && tokens[index + 1] === 'plan' && tokens[index + 2] === 'mode'
+  )
+  return hasAsk || submitsPlanForApproval
+}
+
+function isSubagent(session) {
+  return session?.header?.origin === 'subagent'
+    || Number(session?.header?.delegationDepth ?? 0) > 0
+}
+
+function setState(state) {
+  if (currentState !== state) {
+    currentState = state
+    stateUpdatedAt = Date.now()
+    // 实时推送给所有已连接的 SSE 客户端，避免前端轮询延迟
+    broadcastState(currentState)
+  }
+}
+
+// ── 状态实时推送（SSE） ──────────────────────────────────────────────
+const stateClients = new Set()
+
+function broadcastState(state) {
+  const payload = `data: ${JSON.stringify({ state, updatedAt: stateUpdatedAt })}\n\n`
+  for (const res of stateClients) {
+    try { res.write(payload) } catch {}
+  }
+}
+
+// ── 会话事件处理 ──────────────────────────────────────────────────────
+function handleSessionEvent(session, event) {
+  if (!event || typeof event.type !== 'string') return
+  if (isSubagent(session)) return
+
+  switch (event.type) {
+    case 'turn/start':
+      openTools.clear()
+      waitingCallId = undefined
+      setState(DSHState.THINKING)
+      break
+
+    case 'assistant/chunk':
+    case 'assistant/message':
+      // 没有正在执行的工具调用时，助手消息即"开始输出对话内容"
+      if (openTools.size > 0) break
+      setState(DSHState.SPEAKING)
+      break
+
+    case 'tool/call': {
+      const callId = toolCallIdOf(event, `seq-${event.seq ?? 'unknown'}`)
+      const name = String(event.data?.name ?? event.data?.message?.name ?? 'tool')
+      openTools.set(callId, name)
+      setState(DSHState.WORKING)
+      break
+    }
+
+    case 'tool/result': {
+      const callId = toolCallIdOf(event)
+      if (callId) openTools.delete(callId)
+      if (callId && callId === waitingCallId) waitingCallId = undefined
+      setState(openTools.size > 0 ? DSHState.WORKING : DSHState.THINKING)
+      break
+    }
+
+    case 'user/message':
+      if (waitingCallId) {
+        openTools.delete(waitingCallId)
+        waitingCallId = undefined
+        setState(DSHState.THINKING)
+      }
+      break
+
+    case 'turn/end': {
+      openTools.clear()
+      waitingCallId = undefined
+      const kind = String(event.data?.reason?.kind ?? 'completed')
+      if (kind === 'completed') {
+        setState(DSHState.SUCCESS)
+        setTimeout(() => {
+          if (currentState === DSHState.SUCCESS) setState(DSHState.IDLE)
+        }, 2500)
+      } else if (kind !== 'blocked') {
+        setState(DSHState.ERROR)
+        setTimeout(() => {
+          if (currentState === DSHState.ERROR) setState(DSHState.IDLE)
+        }, 4000)
+      }
+      break
+    }
+  }
+}
+
+// ── 工具函数 ──────────────────────────────────────────────────────────
+function jsonResponse(res, status, body) {
+  const payload = JSON.stringify(body)
+  res.writeHead(status, {
+    'content-type': 'application/json; charset=utf-8',
+    'cache-control': 'no-store',
+    'content-length': Buffer.byteLength(payload),
+  })
+  res.end(payload)
+}
+
+function isLoopback(address) {
+  return address === '127.0.0.1' || address === '::1' || address === '::ffff:127.0.0.1'
+}
+
+async function readPatch(req) {
+  const chunks = []
+  let bytes = 0
+  for await (const chunk of req) {
+    bytes += chunk.length
+    if (bytes > 65536) throw new Error('request body is too large')
+    chunks.push(chunk)
+  }
+  return JSON.parse(Buffer.concat(chunks).toString('utf8'))
+}
+
+/**
+ * 把 URL 子路径解析成 `rootDir` 下的真实文件。
+ * 拒绝任何逃出 rootDir 的路径（`..`、绝对路径、分隔符穿越）。
+ * @returns 绝对路径，或 null（非法）
+ */
+function resolveWithin(rootDir, rel) {
+  if (!rootDir || !rel) return null
+  if (rel.includes('\0')) return null
+  const abs = resolve(rootDir, rel)
+  if (abs !== rootDir && !abs.startsWith(rootDir + sep)) return null
+  return abs
+}
+
+/**
+ * 解析 multipart/form-data 请求体（用于上传整个模型文件夹）。
+ * 支持字段（field）与文件（file，含 filename 与相对路径 webkitRelativePath）。
+ */
+async function parseMultipart(req) {
+  const contentType = req.headers['content-type'] || ''
+  const m = contentType.match(/boundary=(?:"([^"]+)"|([^;]+))/i)
+  if (!m) throw new Error('missing multipart boundary')
+  const boundary = m[1] || m[2]
+  const delimiter = Buffer.from('\r\n--' + boundary)
+  const chunks = []
+  let bytes = 0
+  for await (const chunk of req) {
+    bytes += chunk.length
+    if (bytes > 64 * 1024 * 1024) throw new Error('upload too large (max 64MB)')
+    chunks.push(chunk)
+  }
+  const buf = Buffer.concat(chunks)
+  const parts = []
+  let start = buf.indexOf(delimiter)
+  if (start === -1) return parts
+  start += delimiter.length
+  while (start < buf.length) {
+    if (buf[start] === 0x2d && buf[start + 1] === 0x2d) break // 结束边界 "--"
+    const end = buf.indexOf(delimiter, start)
+    if (end === -1) break
+    const partBuf = buf.subarray(start, end)
+    // partBuf 开头是 \r\n，结尾也是 \r\n
+    let headerEnd = partBuf.indexOf('\r\n\r\n')
+    if (headerEnd === -1) break
+    const headerStr = partBuf.subarray(2, headerEnd).toString('utf8')
+    let content = partBuf.subarray(headerEnd + 4)
+    if (content.endsWith('\r\n')) content = content.subarray(0, content.length - 2)
+    const headers = {}
+    for (const line of headerStr.split('\r\n')) {
+      const idx = line.indexOf(':')
+      if (idx !== -1) headers[line.slice(0, idx).trim().toLowerCase()] = line.slice(idx + 1).trim()
+    }
+    const disp = headers['content-disposition'] || ''
+    const nameM = disp.match(/name="([^"]+)"/i)
+    const fileM = disp.match(/filename="([^"]*)"/i)
+    const relM = disp.match(/filename\*?=[^;]*webkitrelativepath="([^"]*)"/i)
+      || disp.match(/webkitrelativepath="([^"]*)"/i)
+    const entry = {
+      name: nameM ? nameM[1] : null,
+      filename: fileM ? fileM[1] : null,
+      webkitRelativePath: relM ? relM[1] : (fileM ? fileM[1] : ''),
+      data: content,
+    }
+    parts.push(entry)
+    start = end + delimiter.length
+  }
+  return parts
+}
+
+/** 安全地提供本地文件 */
+function serveFile(res, filePath) {
+  try {
+    if (!existsSync(filePath)) {
+      res.writeHead(404)
+      res.end('Not found')
+      return
+    }
+    const stat = statSync(filePath)
+    if (!stat.isFile()) {
+      res.writeHead(404)
+      res.end('Not found')
+      return
+    }
+    const mime = guessMime(filePath)
+    res.writeHead(200, {
+      'content-type': mime,
+      'cache-control': 'public, max-age=3600',
+      'content-length': stat.size,
+    })
+    createReadStream(filePath).pipe(res)
+  } catch {
+    res.writeHead(404)
+    res.end('Not found')
+  }
+}
+
+// ── 插件入口 ──────────────────────────────────────────────────────────
+export function apply(ctx) {
+  const logger = ctx.logger ?? console
+
+  if (!PLUGIN_ROOT || !LIB_DIR || !ASSETS_DIR) {
+    logger.error?.('[dsh-live2d] Could not resolve plugin root directory. File serving disabled.')
+  }
+
+  // 监听会话事件，跟踪 DSH 状态
+  const offEvent = ctx.on('session/event', (session, event) => {
+    try {
+      handleSessionEvent(session, event)
+    } catch (err) {
+      logger.error?.('dsh-live2d: failed to handle session event', err)
+    }
+  }, { global: true })
+
+  // 注册 webserver 路由
+  if (typeof ctx.inject === 'function') {
+    ctx.inject(['webServer'], (httpCtx) => {
+      // GET /plugins/dsh-live2d/state — 返回当前 Agent 状态
+      httpCtx.effect(
+        () => httpCtx.webServer.register({
+          kind: 'exact',
+          path: STATE_ENDPOINT,
+          handler: (req, res) => {
+            if (!isLoopback(req.socket?.remoteAddress)) {
+              jsonResponse(res, 403, { error: 'local access only' })
+              return
+            }
+            jsonResponse(res, 200, { state: currentState, updatedAt: stateUpdatedAt })
+          },
+        }),
+        'dsh-live2d: state endpoint',
+      )
+
+      // GET /plugins/dsh-live2d/state/stream — SSE 实时推送状态变更（替代轮询，消除动画延迟）
+      httpCtx.effect(
+        () => httpCtx.webServer.register({
+          kind: 'prefix',
+          path: STATE_ENDPOINT + '/stream',
+          handler: (req, res) => {
+            if (!isLoopback(req.socket?.remoteAddress)) {
+              res.writeHead(403)
+              res.end('local access only')
+              return
+            }
+            res.writeHead(200, {
+              'Content-Type': 'text/event-stream',
+              'Cache-Control': 'no-cache, no-transform',
+              'Connection': 'keep-alive',
+              'X-Accel-Buffering': 'no',
+            })
+            // 立即发送当前状态，避免新连接错过最新值
+            res.write(`data: ${JSON.stringify({ state: currentState, updatedAt: stateUpdatedAt })}\n\n`)
+            stateClients.add(res)
+            // 保活：每 15s 发一个注释，防止代理/浏览器断开空闲连接
+            const keepAlive = setInterval(() => {
+              try { res.write(': keep-alive\n\n') } catch {}
+            }, 15000)
+            const cleanup = () => {
+              clearInterval(keepAlive)
+              stateClients.delete(res)
+            }
+            req.on('close', cleanup)
+            req.on('error', cleanup)
+          },
+        }),
+        'dsh-live2d: state sse endpoint',
+      )
+
+      // GET/PATCH/POST /plugins/dsh-live2d/config
+      httpCtx.effect(
+        () => httpCtx.webServer.register({
+          kind: 'exact',
+          path: CONFIG_ENDPOINT,
+          handler: async (req, res) => {
+            if (!isLoopback(req.socket?.remoteAddress)) {
+              jsonResponse(res, 403, { error: 'local access only' })
+              return
+            }
+            if (req.method === 'GET') {
+              jsonResponse(res, 200, { ok: true })
+              return
+            }
+            if (req.method === 'PATCH') {
+              try {
+                const patch = await readPatch(req)
+                jsonResponse(res, 200, { ok: true, patch })
+              } catch (err) {
+                jsonResponse(res, 400, { error: err instanceof Error ? err.message : String(err) })
+              }
+              return
+            }
+            if (req.method === 'POST') {
+              // 上传整个模型文件夹：multipart/form-data，字段 dirName + 若干 file（含 webkitRelativePath）
+              try {
+                if (!ASSETS_DIR) {
+                  jsonResponse(res, 500, { error: 'assets dir unavailable' })
+                  return
+                }
+                const ct = req.headers['content-type'] || ''
+                if (!ct.includes('multipart/form-data')) {
+                  jsonResponse(res, 400, { error: 'expected multipart/form-data' })
+                  return
+                }
+                const parts = await parseMultipart(req)
+                const dirField = parts.find((p) => p.name === 'dirName')
+                const dirName = (dirField ? dirField.data.toString('utf8') : '').trim()
+                if (!dirName || dirName.includes('/') || dirName.includes('\\') || dirName.includes('..') || /[^\w.\-]/.test(dirName)) {
+                  jsonResponse(res, 400, { error: 'invalid dirName' })
+                  return
+                }
+                const files = parts.filter((p) => p.filename)
+                if (files.length === 0) {
+                  jsonResponse(res, 400, { error: 'no files' })
+                  return
+                }
+                // 必须包含 model3.json
+                const hasModel3 = files.some((p) => p.filename.toLowerCase().endsWith('.model3.json'))
+                if (!hasModel3) {
+                  jsonResponse(res, 400, { error: 'missing .model3.json in folder' })
+                  return
+                }
+                const targetDir = join(ASSETS_DIR, dirName)
+                const abs = resolve(targetDir)
+                if (abs !== ASSETS_DIR && !abs.startsWith(ASSETS_DIR + sep)) {
+                  jsonResponse(res, 400, { error: 'invalid dirName' })
+                  return
+                }
+                // 覆盖式写入：先清空旧目录
+                try { rmSync(targetDir, { recursive: true, force: true }) } catch {}
+                mkdirSync(targetDir, { recursive: true })
+                let written = 0
+                for (const f of files) {
+                  // 用 webkitRelativePath（去掉首个目录段即 dirName）决定相对位置
+                  let relPath = f.webkitRelativePath || f.filename
+                  // webkitRelativePath 形如 dirName/sub/file —— 去掉开头的 dirName/
+                  const segs = relPath.split('/').filter(Boolean)
+                  if (segs.length > 1 && segs[0] === dirName) segs.shift()
+                  const rel = segs.join('/')
+                  const fpath = resolveWithin(targetDir, rel)
+                  if (!fpath) continue
+                  mkdirSync(dirname(fpath), { recursive: true })
+                  writeFileSync(fpath, f.data)
+                  written += 1
+                }
+                jsonResponse(res, 200, { ok: true, dirName, fileCount: written, modelUrl: `/plugins/dsh-live2d/assets/${dirName}/model.model3.json` })
+              } catch (err) {
+                jsonResponse(res, 400, { error: err instanceof Error ? err.message : String(err) })
+              }
+              return
+            }
+            jsonResponse(res, 405, { error: 'method not allowed' })
+          },
+        }),
+        'dsh-live2d: config endpoint',
+      )
+
+      // ── 模型自动扫描接口 ──────────────────────────────────
+      // GET /plugins/dsh-live2d/models
+      // 扫描 assets 目录下所有含 .model3.json 的子文件夹，自动生成模型列表；
+      // 同时解析每个 model3.json 的 Motions/Expressions 作为动画映射下拉数据源。
+      httpCtx.effect(
+        () => httpCtx.webServer.register({
+          kind: 'exact',
+          path: '/plugins/dsh-live2d/models',
+          handler: (req, res) => {
+            if (req.method !== 'GET' && req.method !== 'HEAD') {
+              jsonResponse(res, 405, { error: 'method not allowed' })
+              return
+            }
+            if (!isLoopback(req.socket?.remoteAddress)) {
+              jsonResponse(res, 403, { error: 'local access only' })
+              return
+            }
+            const result = { assetsDir: ASSETS_DIR || '', models: [] }
+            if (!ASSETS_DIR || !existsSync(ASSETS_DIR)) {
+              jsonResponse(res, 200, result)
+              return
+            }
+            // 读取内置的 model_list.json（若存在），将其动画映射/画布配置合并到扫描结果，
+            // 使插件安装后无需手动配置即可使用默认动画映射。
+            let presetMap = {}
+            try {
+              const presetPath = join(ASSETS_DIR, 'model_list.json')
+              if (existsSync(presetPath)) {
+                const preset = JSON.parse(readFileSync(presetPath, 'utf8'))
+                const list = Array.isArray(preset.models) ? preset.models : []
+                for (const m of list) {
+                  if (m && m.url) {
+                    // 归一化 url 子路径，便于和扫描得到的 url 匹配
+                    const key = m.url.replace(/^\.?\//, '').replace(/^\/plugins\/dsh-live2d\/assets\//, '')
+                    presetMap[key] = m
+                  }
+                }
+              }
+            } catch {}
+            const findModel3 = (dir) => {
+              let entries = []
+              try { entries = readdirSync(dir, { withFileTypes: true }) } catch { return null }
+              for (const e of entries) {
+                if (e.isFile() && e.name.toLowerCase().endsWith('.model3.json')) return join(dir, e.name)
+              }
+              for (const e of entries) {
+                if (e.isDirectory()) {
+                  const found = findModel3(join(dir, e.name))
+                  if (found) return found
+                }
+              }
+              return null
+            }
+            let dirEntries = []
+            try { dirEntries = readdirSync(ASSETS_DIR, { withFileTypes: true }) } catch {}
+            for (const e of dirEntries) {
+              if (!e.isDirectory()) continue
+              const modelPath = findModel3(join(ASSETS_DIR, e.name))
+              if (!modelPath) continue
+              const rel = modelPath.slice(ASSETS_DIR.length).replace(/\\/g, '/').replace(/^\//, '')
+              const url = '/plugins/dsh-live2d/assets/' + rel
+              let groups = []
+              let groupCounts = {}
+              // groupMotions: { groupName: ['idle', 'tap', ...] } 取每个 motion 文件名（去扩展名）作展示
+              let groupMotions = {}
+              let expressions = []
+              try {
+                const model3 = JSON.parse(readFileSync(modelPath, 'utf8'))
+                const fr = model3.FileReferences || {}
+                const motions = fr.Motions || {}
+                groups = Object.keys(motions)
+                for (const g of groups) {
+                  const entries = Array.isArray(motions[g]) ? motions[g] : []
+                  groupCounts[g] = entries.length
+                  groupMotions[g] = entries.map((m) => {
+                    const f = (typeof m === 'string' ? m : (m.File || m.file || ''))
+                    return f.split('/').pop().replace(/\.motion3\.json$/i, '').replace(/\.motion3$/i, '')
+                  })
+                }
+                expressions = (fr.Expressions || []).map((x) =>
+                  typeof x === 'string'
+                    ? x.split('/').pop().replace(/\.exp3\.json$/i, '')
+                    : (x.Name || (x.File || '')).toString())
+              } catch {}
+              // 用 url 子路径匹配内置 model_list.json 中的预设（动画映射/画布配置）
+              const relKey = rel.replace(/^\/+/, '')
+              const preset = presetMap[relKey] || {}
+              result.models.push({
+                name: preset.name || e.name,
+                url,
+                canvasWidth: preset.canvasWidth || 300,
+                canvasHeight: preset.canvasHeight || 400,
+                config: preset.config || { x: 0, y: 0, scaleX: 1, scaleY: 1 },
+                groups,
+                groupCounts,
+                groupMotions,
+                expressions,
+                // 内置动画映射优先；用户后续在设置页的修改仍以 localStorage 为准
+                animations: preset.animations || {},
+              })
+            }
+            jsonResponse(res, 200, result)
+          },
+        }),
+        'dsh-live2d: models scan endpoint',
+      )
+
+      // ── 本地文件路由 ──────────────────────────────────────────
+      // 必须用 `kind: 'prefix'` 的具名路由，绝不能用 registerFallback：
+      // fallback 座位是全局唯一的，spa 静态资源服务（dsh-host-frontend-static）
+      // 已经占用了它。抢占之后 index.html / 所有未命中路由都会落到本插件的
+      // handler 上，而它对这些路径不写任何响应 —— 请求永久挂住，页面打不开。
+      //
+      // webserver 的 prefix 匹配取最长前缀胜出，所以这两条比
+      // dsh-client-modules 注册的 `/plugins` 更具体，会优先命中。
+      const fileRoots = [
+        { routePath: '/plugins/dsh-live2d/lib', dir: LIB_DIR },
+        { routePath: '/plugins/dsh-live2d/assets', dir: ASSETS_DIR },
+      ]
+
+      for (const { routePath, dir } of fileRoots) {
+        if (!dir) continue
+        httpCtx.effect(
+          () => httpCtx.webServer.register({
+            kind: 'prefix',
+            path: routePath,
+            handler: (req, res) => {
+              if (req.method !== 'GET' && req.method !== 'HEAD') {
+                res.writeHead(405)
+                res.end()
+                return
+              }
+              const urlPath = new URL(req.url || '/', 'http://localhost').pathname
+              const rel = decodeURIComponent(urlPath.slice(routePath.length).replace(/^\//u, ''))
+              const filePath = resolveWithin(dir, rel)
+              if (!filePath) {
+                res.writeHead(403)
+                res.end('Forbidden')
+                return
+              }
+              serveFile(res, filePath)
+            },
+          }),
+          `dsh-live2d: ${routePath}`,
+        )
+      }
+    })
+  }
+
+  // 清理
+  ctx.effect(() => () => {
+    offEvent?.()
+  }, 'dsh-live2d: cleanup')
+}