@biunow/agent-biuart 0.0.0-stage → 0.1.1

package/lib/host.mjs

@@ -0,0 +1,754 @@
+/**
+ * Minimal HTTP host shared by agent packages.
+ * Env: PANEL_PORT, PANEL_WORKSPACE, PANEL_AGENT_ID, ENGINE_ROOT,
+ *      PANEL_CALLBACK_URL, PANEL_CALLBACK_TOKEN, PANEL_CAN_EXPORT, PANEL_PRODUCT
+ */
+import fs from 'node:fs';
+import http from 'node:http';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { spawn } from 'node:child_process';
+import crypto from 'node:crypto';
+import { optimizePrompt } from '../studio/optimize-prompt.mjs';
+
+export function env() {
+  return {
+    port: Number(process.env.PANEL_PORT || 0),
+    workspace: process.env.PANEL_WORKSPACE || path.join(process.cwd(), 'workspace'),
+    agentId: process.env.PANEL_AGENT_ID || 'agent',
+    version: process.env.PANEL_AGENT_VERSION || '0.0.0',
+    engineRoot: process.env.ENGINE_ROOT || (fs.existsSync(path.join(path.dirname(fileURLToPath(import.meta.url)), '..', 'engine'))
+      ? path.join(path.dirname(fileURLToPath(import.meta.url)), '..', 'engine')
+      : ''),
+    runtime: process.env.PANEL_RUNTIME || '',
+    callbackUrl: process.env.PANEL_CALLBACK_URL || '',
+    callbackToken: process.env.PANEL_CALLBACK_TOKEN || '',
+    canExport: process.env.PANEL_CAN_EXPORT !== '0',
+    member: process.env.PANEL_MEMBER === '1',
+    product: process.env.PANEL_PRODUCT || '',
+  };
+}
+
+export function ensureDir(dir) {
+  fs.mkdirSync(dir, { recursive: true });
+  return dir;
+}
+
+export function readJson(file, fallback = null) {
+  try {
+    return JSON.parse(fs.readFileSync(file, 'utf8'));
+  } catch {
+    return fallback;
+  }
+}
+
+export function writeJson(file, data) {
+  ensureDir(path.dirname(file));
+  fs.writeFileSync(file, JSON.stringify(data, null, 2));
+}
+
+/** 旧任务只存了短标题时，从工程 brief 补回完整需求，方便点选回填。 */
+function fillFromBrief(job) {
+  if (!job || job.prompt || job.brief) return job;
+  const dirs = [];
+  if (job.projectPath) dirs.push(job.projectPath);
+  const artifact = String(job.artifact || '');
+  if (artifact && !artifact.toLowerCase().endsWith('.mp4')) dirs.push(artifact);
+  for (const dir of dirs) {
+    const data = readJson(path.join(dir, 'brief.json'), null);
+    if (!data || typeof data !== 'object') continue;
+    const prompt = String(data.prompt || data.brief || '').trim();
+    if (!prompt) continue;
+    job.prompt = prompt;
+    if (job.look == null && data.look != null) job.look = data.look;
+    if (!job.size && data.size) job.size = data.size;
+    if (job.pace == null && data.pace != null) job.pace = data.pace;
+    if (!job.style && data.style) job.style = data.style;
+    if (!job.styleName && data.styleName) job.styleName = data.styleName;
+    if (job.storyboard == null && typeof data.storyboard === 'boolean') job.storyboard = data.storyboard;
+    if (!('durationSec' in job) && (data.durationSec != null || data.durationMode === 'auto')) {
+      job.durationSec = data.durationSec ?? null;
+    }
+    if (!job.screen && data.screen) job.screen = data.screen;
+    if (!job.styleId && data.styleId) job.styleId = data.styleId;
+    if (!job.urls && Array.isArray(data.urls)) job.urls = data.urls;
+    break;
+  }
+  return job;
+}
+
+export function sendJson(res, status, body) {
+  const data = JSON.stringify(body);
+  res.writeHead(status, {
+    'content-type': 'application/json; charset=utf-8',
+    'content-length': Buffer.byteLength(data),
+    'cache-control': 'no-store',
+    'access-control-allow-origin': '*',
+  });
+  res.end(data);
+}
+
+export async function readBody(req, limit = 32 * 1024 * 1024) {
+  const chunks = [];
+  let size = 0;
+  for await (const chunk of req) {
+    size += chunk.length;
+    if (size > limit) throw Object.assign(new Error('body too large'), { status: 413 });
+    chunks.push(chunk);
+  }
+  return Buffer.concat(chunks);
+}
+
+export async function readJsonBody(req) {
+  // 20MB 原文件 base64 后约 27MB，留余量给文案和字段
+  let buf;
+  try {
+    buf = await readBody(req, 30 * 1024 * 1024);
+  } catch (error) {
+    if (error.status === 413) {
+      throw Object.assign(new Error('附件超过 20MB，请压缩或裁短后再上传'), { status: 413 });
+    }
+    throw error;
+  }
+  if (!buf.length) return {};
+  return JSON.parse(buf.toString('utf8'));
+}
+
+export function mime(file) {
+  if (file.endsWith('.html')) return 'text/html; charset=utf-8';
+  if (file.endsWith('.js')) return 'text/javascript; charset=utf-8';
+  if (file.endsWith('.css')) return 'text/css; charset=utf-8';
+  if (file.endsWith('.json')) return 'application/json; charset=utf-8';
+  if (file.endsWith('.svg')) return 'image/svg+xml';
+  if (file.endsWith('.png')) return 'image/png';
+  if (file.endsWith('.jpg') || file.endsWith('.jpeg')) return 'image/jpeg';
+  if (file.endsWith('.webp')) return 'image/webp';
+  if (file.endsWith('.mp4')) return 'video/mp4';
+  if (file.endsWith('.md')) return 'text/markdown; charset=utf-8';
+  return 'application/octet-stream';
+}
+
+export function serveStatic(res, file) {
+  if (!fs.existsSync(file) || fs.statSync(file).isDirectory()) {
+    res.writeHead(404, { 'content-type': 'text/plain', 'access-control-allow-origin': '*' });
+    res.end('not found');
+    return;
+  }
+  res.writeHead(200, {
+    'content-type': mime(file),
+    'cache-control': 'no-store',
+    'access-control-allow-origin': '*',
+  });
+  fs.createReadStream(file).pipe(res);
+}
+
+/** 把本机成片按 Range 流给浏览器，播放器才能拖动进度。 */
+export function serveLocalFile(req, res, file) {
+  if (!file || !fs.existsSync(file) || !fs.statSync(file).isFile()) {
+    res.writeHead(404, { 'content-type': 'text/plain; charset=utf-8', 'access-control-allow-origin': '*' });
+    res.end('not found');
+    return;
+  }
+  const size = fs.statSync(file).size;
+  const type = mime(file);
+  const common = {
+    'content-type': type,
+    'accept-ranges': 'bytes',
+    'cache-control': 'no-store',
+    'access-control-allow-origin': '*',
+  };
+  const range = String(req.headers.range || '');
+  const match = /^bytes=(\d*)-(\d*)$/.exec(range);
+  if (match) {
+    const hasStart = match[1] !== '';
+    const hasEnd = match[2] !== '';
+    let start = hasStart ? Number(match[1]) : 0;
+    let end = hasEnd ? Number(match[2]) : size - 1;
+    if (!hasStart && hasEnd) {
+      const suffix = Number(match[2]);
+      start = Number.isFinite(suffix) && suffix > 0 ? Math.max(0, size - suffix) : size;
+      end = size - 1;
+    }
+    if (!Number.isFinite(start) || !Number.isFinite(end) || start < 0 || start >= size || end < start) {
+      res.writeHead(416, { ...common, 'content-range': `bytes */${size}` });
+      res.end();
+      return;
+    }
+    end = Math.min(end, size - 1);
+    res.writeHead(206, {
+      ...common,
+      'content-length': end - start + 1,
+      'content-range': `bytes ${start}-${end}/${size}`,
+    });
+    fs.createReadStream(file, { start, end }).pipe(res);
+    return;
+  }
+  res.writeHead(200, { ...common, 'content-length': size });
+  fs.createReadStream(file).pipe(res);
+}
+
+export class JobStore {
+  constructor(workspace) {
+    this.dir = ensureDir(path.join(workspace, 'jobs'));
+    this.file = path.join(this.dir, 'index.json');
+    this.jobs = readJson(this.file, { jobs: [] }).jobs;
+  }
+
+  save() {
+    writeJson(this.file, { jobs: this.jobs });
+  }
+
+  list() {
+    return [...this.jobs].sort((a, b) => (a.createdAt < b.createdAt ? 1 : -1));
+  }
+
+  get(id) {
+    return this.jobs.find((j) => j.id === id) || null;
+  }
+
+  create(partial) {
+    const job = {
+      id: crypto.randomUUID(),
+      status: 'queued',
+      progress: 0,
+      message: 'queued',
+      createdAt: new Date().toISOString(),
+      ...partial,
+    };
+    this.jobs.unshift(job);
+    this.save();
+    return job;
+  }
+
+  update(id, patch) {
+    const job = this.get(id);
+    if (!job) return null;
+    Object.assign(job, patch);
+    this.save();
+    return job;
+  }
+
+  remove(id) {
+    const before = this.jobs.length;
+    this.jobs = this.jobs.filter((j) => j.id !== id);
+    if (this.jobs.length === before) return false;
+    this.save();
+    return true;
+  }
+}
+
+export async function reportProgress(cfg, payload) {
+  if (!cfg.callbackUrl || !cfg.callbackToken) return null;
+  try {
+    const res = await fetch(cfg.callbackUrl, {
+      method: 'POST',
+      headers: { 'content-type': 'application/json', 'x-panel-token': cfg.callbackToken },
+      body: JSON.stringify({ ...payload, agentId: cfg.agentId, token: cfg.callbackToken }),
+    });
+    return await res.json().catch(() => null);
+  } catch {
+    return null;
+  }
+}
+
+/** Ask panel host to open a DSH conversation with this Agent's skill + prompt. */
+export async function requestKickoff(cfg, payload) {
+  if (!cfg.callbackUrl || !cfg.callbackToken) return null;
+  const kickoffUrl = String(cfg.callbackUrl).replace(/\/agents\/progress\/?$/, '/agents/kickoff');
+  try {
+    const res = await fetch(kickoffUrl, {
+      method: 'POST',
+      headers: { 'content-type': 'application/json', 'x-panel-token': cfg.callbackToken },
+      body: JSON.stringify({
+        ...payload,
+        agentId: cfg.agentId,
+        token: cfg.callbackToken,
+      }),
+    });
+    return await res.json().catch(() => null);
+  } catch {
+    return null;
+  }
+}
+
+/** Mint panel Run Permit into projectDir (required before DSH creation). */
+export async function requestRunPermit(cfg, { projectPath, jobId }) {
+  if (!cfg.callbackUrl || !cfg.callbackToken) return null;
+  const url = String(cfg.callbackUrl).replace(/\/agents\/progress\/?$/, '/agents/run-permit');
+  try {
+    const res = await fetch(url, {
+      method: 'POST',
+      headers: { 'content-type': 'application/json', 'x-panel-token': cfg.callbackToken },
+      body: JSON.stringify({
+        agentId: cfg.agentId,
+        token: cfg.callbackToken,
+        projectPath,
+        jobId,
+      }),
+    });
+    return await res.json().catch(() => null);
+  } catch {
+    return null;
+  }
+}
+
+/** Seed packaged skill into project so cwd-local DSH discovery finds it. */
+export function seedSkillIntoProject(projectDir, packageRoot, skillId) {
+  const src = path.join(packageRoot, 'skills', skillId, 'SKILL.md');
+  if (!projectDir || !fs.existsSync(src)) return null;
+  const destDir = ensureDir(path.join(projectDir, '.agents', 'skills', skillId));
+  const dest = path.join(destDir, 'SKILL.md');
+  fs.copyFileSync(src, dest);
+  return dest;
+}
+
+/** 分段和无声中间片不能当成片。成片改名后（ep55.mp4 → ep55-master.mp4）要能从同目录找回。 */
+export function isIntermediateMp4(filePath) {
+  const base = path.basename(String(filePath || '')).toLowerCase();
+  if (base === 'merged.mp4' || /^seg[-_]\d+\.mp4$/.test(base)) return true;
+  if (/^draft([-.]|$)/.test(base)) return true;
+  const parts = String(filePath || '').split(/[/\\]/).map((part) => part.toLowerCase());
+  if (parts.includes('build') || parts.includes('segments')) return true;
+  return base === 'video.mp4' && parts.at(-2) === 'out';
+}
+
+/** 记录里的文件被删掉或改名时，在同一目录找「原名开头」的现片。 */
+export function rescueMissingFilm(filePath) {
+  const file = String(filePath || '');
+  if (!file) return '';
+  if (fs.existsSync(file) && !isIntermediateMp4(file)) return file;
+  const dir = path.dirname(file);
+  if (!fs.existsSync(dir)) return '';
+  const stem = path.basename(file, path.extname(file)).toLowerCase();
+  if (!stem) return '';
+  let best = null;
+  let names = [];
+  try { names = fs.readdirSync(dir); } catch { return ''; }
+  for (const name of names) {
+    if (!name.toLowerCase().endsWith('.mp4')) continue;
+    if (!name.toLowerCase().startsWith(stem)) continue;
+    const full = path.join(dir, name);
+    if (isIntermediateMp4(full)) continue;
+    let st;
+    try { st = fs.statSync(full); } catch { continue; }
+    if (!st.isFile()) continue;
+    if (!best || st.mtimeMs > best.mtimeMs) best = { path: full, mtimeMs: st.mtimeMs, size: st.size };
+  }
+  return best ? best.path : '';
+}
+
+function collectMp4(rootDir, maxDepth) {
+  const found = [];
+  if (!rootDir || !fs.existsSync(rootDir)) return found;
+  const walk = (dir, depth) => {
+    if (depth > maxDepth) return;
+    let entries;
+    try {
+      entries = fs.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const ent of entries) {
+      if (ent.name === 'node_modules' || ent.name === '.git' || ent.name === '.venv') continue;
+      const full = path.join(dir, ent.name);
+      if (ent.isDirectory()) walk(full, depth + 1);
+      else if (ent.isFile() && /\.mp4$/i.test(ent.name)) {
+        try {
+          const st = fs.statSync(full);
+          found.push({ path: full, mtime: st.mtimeMs, size: st.size });
+        } catch {
+          /* skip */
+        }
+      }
+    }
+  };
+  walk(rootDir, 0);
+  return found;
+}
+
+function pickFilm(found) {
+  if (!found.length) return null;
+  found.sort((a, b) => {
+    const ai = isIntermediateMp4(a.path) ? 1 : 0;
+    const bi = isIntermediateMp4(b.path) ? 1 : 0;
+    if (ai !== bi) return ai - bi;
+    return b.mtime - a.mtime;
+  });
+  const best = found[0];
+  if (!best || isIntermediateMp4(best.path)) return null;
+  return best;
+}
+
+/** Newest deliverable MP4. Root-level `<name>.mp4` wins over `out/video.mp4`. */
+export function findLatestMp4(rootDir, { maxDepth = 6, sinceMs = 0 } = {}) {
+  const since = Number(sinceMs) || 0;
+  const found = collectMp4(rootDir, maxDepth).filter((hit) => !since || hit.mtime >= since);
+  return pickFilm(found);
+}
+
+/** roots: directory string, or { dir, sinceMs, maxDepth }. */
+export function locateFilm(roots) {
+  const found = [];
+  for (const root of roots || []) {
+    const dir = typeof root === 'string' ? root : root?.dir;
+    const sinceMs = typeof root === 'string' ? 0 : Number(root?.sinceMs) || 0;
+    const maxDepth = typeof root === 'string' ? 6 : root?.maxDepth || 6;
+    found.push(...collectMp4(dir, maxDepth).filter((hit) => !sinceMs || hit.mtime >= sinceMs));
+  }
+  return pickFilm(found);
+}
+
+export function locateJobFilm(job, cfg) {
+  if (!job) return null;
+  const roots = Array.isArray(job.filmRoots) && job.filmRoots.length
+    ? [...job.filmRoots]
+    : [];
+  const dir = job.projectPath || (job.artifact && !String(job.artifact).toLowerCase().endsWith('.mp4') ? job.artifact : '');
+  if (dir && !roots.some((root) => (typeof root === 'string' ? root : root?.dir) === dir)) {
+    roots.unshift({ dir, sinceMs: 0 });
+  }
+  const sinceMs = Date.parse(job.createdAt);
+  if (cfg?.engineRoot && Number.isFinite(sinceMs)) {
+    const engineFilms = path.join(cfg.engineRoot, 'films');
+    if (!roots.some((root) => (typeof root === 'string' ? root : root?.dir) === engineFilms)) {
+      roots.push({ dir: engineFilms, sinceMs });
+    }
+  }
+  return locateFilm(roots);
+}
+
+/** Poll until an MP4 appears; updates job + panel progress. */
+export function watchForFilm(cfg, jobs, jobId, {
+  projectPath,
+  title,
+  intervalMs = 4000,
+  timeoutMs = 2 * 60 * 60 * 1000,
+} = {}) {
+  const started = Date.now();
+  const tick = async () => {
+    const job = jobs.get(jobId);
+    if (!job || job.status === 'failed' || job.status === 'cancelled') return;
+    const current = String(job.outputMp4 || '');
+    if (current && fs.existsSync(current) && !isIntermediateMp4(current)) return;
+    if (current && !fs.existsSync(current)) {
+      const rescued = rescueMissingFilm(current);
+      if (rescued) {
+        const message = `成片已就绪 · ${path.basename(rescued)}`;
+        const size = fs.statSync(rescued).size;
+        jobs.update(jobId, {
+          status: 'done',
+          progress: 100,
+          phase: 'film',
+          message,
+          outputMp4: rescued,
+          artifact: rescued,
+          filmBytes: size,
+          filmAt: new Date().toISOString(),
+        });
+        await reportProgress(cfg, {
+          taskId: jobs.get(jobId)?.panelTaskId,
+          title: title || jobs.get(jobId)?.title,
+          progress: 100,
+          message,
+          done: true,
+          artifact: rescued,
+        });
+        return;
+      }
+    }
+    const hit = locateJobFilm({ ...job, projectPath: projectPath || job.projectPath, artifact: job.artifact }, cfg);
+    if (hit && !isIntermediateMp4(hit.path)) {
+      const message = `成片已就绪 · ${path.basename(hit.path)}`;
+      jobs.update(jobId, {
+        status: 'done',
+        progress: 100,
+        phase: 'film',
+        message,
+        outputMp4: hit.path,
+        artifact: hit.path,
+        filmBytes: hit.size,
+        filmAt: new Date().toISOString(),
+      });
+      await reportProgress(cfg, {
+        taskId: jobs.get(jobId)?.panelTaskId,
+        title: title || jobs.get(jobId)?.title,
+        progress: 100,
+        message,
+        done: true,
+        artifact: hit.path,
+      });
+      return;
+    }
+    if (Date.now() - started > timeoutMs) {
+      if (hit) {
+        const message = `成片已就绪 · ${path.basename(hit.path)}`;
+        jobs.update(jobId, {
+          status: 'done',
+          progress: 100,
+          phase: 'film',
+          message,
+          outputMp4: hit.path,
+          artifact: hit.path,
+          filmBytes: hit.size,
+          filmAt: new Date().toISOString(),
+        });
+        await reportProgress(cfg, {
+          taskId: jobs.get(jobId)?.panelTaskId,
+          title: title || jobs.get(jobId)?.title,
+          progress: 100,
+          message,
+          done: true,
+          artifact: hit.path,
+        });
+      } else {
+        jobs.update(jobId, {
+          status: 'done',
+          progress: 100,
+          phase: 'stalled',
+          message: '等待成片超时 · 可打开工程目录或 DSH 会话查看',
+        });
+        await reportProgress(cfg, {
+          taskId: jobs.get(jobId)?.panelTaskId,
+          progress: 100,
+          message: '等待成片超时',
+          done: true,
+          artifact: projectPath,
+        });
+      }
+      return;
+    }
+    if (job.status === 'running' || job.phase === 'dsh') {
+      jobs.update(jobId, {
+        phase: 'dsh',
+        message: job.kickoffOk === false
+          ? (job.message || '等待手动开拍 / 成片')
+          : 'DSH 创作中 · 完成后将自动显示成片路径',
+        progress: Math.min(90, Math.max(Number(job.progress) || 50, 50)),
+      });
+      await reportProgress(cfg, {
+        taskId: jobs.get(jobId)?.panelTaskId,
+        progress: jobs.get(jobId)?.progress ?? 55,
+        message: jobs.get(jobId)?.message,
+      });
+    }
+    setTimeout(() => void tick(), intervalMs);
+  };
+  setTimeout(() => void tick(), intervalMs);
+}
+
+export function runCommand(command, args, opts = {}) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(command, args, {
+      cwd: opts.cwd,
+      env: { ...process.env, ...(opts.env || {}) },
+      shell: opts.shell ?? false,
+    });
+    let stdout = '';
+    let stderr = '';
+    child.stdout?.on('data', (d) => {
+      stdout += d.toString();
+      opts.onStdout?.(d.toString());
+    });
+    child.stderr?.on('data', (d) => {
+      stderr += d.toString();
+      opts.onStderr?.(d.toString());
+    });
+    child.on('error', reject);
+    child.on('close', (code) => {
+      if (code === 0) resolve({ code, stdout, stderr });
+      else reject(Object.assign(new Error(stderr || `exit ${code}`), { code, stdout, stderr }));
+    });
+    if (opts.signal) {
+      opts.signal.addEventListener('abort', () => {
+        child.kill('SIGTERM');
+        reject(new Error('aborted'));
+      });
+    }
+  });
+}
+
+export function packageRoot(importMetaUrl) {
+  return path.resolve(path.dirname(fileURLToPath(importMetaUrl)), '..');
+}
+
+export function createAgentServer({ root, studioDir, api }) {
+  const cfg = env();
+  ensureDir(cfg.workspace);
+  const jobs = new JobStore(cfg.workspace);
+  const studio = studioDir || path.join(root, 'studio');
+
+  // 进程重启后：已有成片则收口；否则恢复 watch，避免面板/Studio 任务永远「处理中」
+  for (const j of jobs.list()) {
+    const filmMissing = j.outputMp4 && !fs.existsSync(j.outputMp4);
+    const filmBad = j.outputMp4 && isIntermediateMp4(j.outputMp4);
+    if (filmMissing || filmBad || (j.status === 'done' && !j.outputMp4)) {
+      const rescued = filmMissing ? rescueMissingFilm(j.outputMp4) : '';
+      const late = rescued
+        ? { path: rescued, size: fs.statSync(rescued).size }
+        : locateJobFilm(j, cfg);
+      if (late && late.path && fs.existsSync(late.path) && !isIntermediateMp4(late.path)) {
+        jobs.update(j.id, {
+          status: 'done',
+          progress: 100,
+          phase: 'film',
+          message: `成片已就绪 · ${path.basename(late.path)}`,
+          outputMp4: late.path,
+          artifact: late.path,
+          filmBytes: late.size,
+          filmAt: new Date().toISOString(),
+        });
+        continue;
+      }
+      if (j.status === 'done') continue;
+    }
+    const waiting = j.status === 'running' || (j.outputMp4 && isIntermediateMp4(j.outputMp4));
+    if (!waiting) continue;
+    const projectPath = j.projectPath || (j.artifact && !String(j.artifact).endsWith('.mp4') ? j.artifact : null);
+    const hit = locateJobFilm(j, cfg);
+    if (hit && !isIntermediateMp4(hit.path)) {
+      jobs.update(j.id, {
+        status: 'done',
+        progress: 100,
+        phase: 'film',
+        message: `成片已就绪 · ${path.basename(hit.path)}`,
+        outputMp4: hit.path,
+        artifact: hit.path,
+        filmBytes: hit.size,
+        filmAt: new Date().toISOString(),
+      });
+      void reportProgress(cfg, {
+        taskId: j.panelTaskId,
+        title: j.title,
+        progress: 100,
+        message: `成片已就绪 · ${path.basename(hit.path)}`,
+        done: true,
+        artifact: hit.path,
+      });
+    } else if (projectPath && fs.existsSync(projectPath)) {
+      jobs.update(j.id, {
+        phase: 'dsh',
+        message: '进程已恢复 · 继续等待成片',
+        progress: Math.min(90, Math.max(Number(j.progress) || 50, 50)),
+      });
+      watchForFilm(cfg, jobs, j.id, { projectPath, title: j.title });
+    } else {
+      jobs.update(j.id, {
+        status: 'failed',
+        phase: 'orphaned',
+        message: '进程中断 · 无法恢复监视（工程目录缺失）',
+        progress: Number(j.progress) || 0,
+      });
+      void reportProgress(cfg, {
+        taskId: j.panelTaskId,
+        progress: Number(j.progress) || 0,
+        message: '进程中断 · 任务已标记失败',
+        failed: true,
+        error: 'agent process restarted without project path',
+      });
+    }
+  }
+
+  const server = http.createServer(async (req, res) => {
+    try {
+      if (req.method === 'OPTIONS') {
+        res.writeHead(204, {
+          'access-control-allow-origin': '*',
+          'access-control-allow-methods': 'GET,POST,DELETE,OPTIONS',
+          'access-control-allow-headers': 'content-type,x-panel-token',
+        });
+        return res.end();
+      }
+      const url = new URL(req.url || '/', 'http://local');
+      const pathname = url.pathname;
+
+      if (pathname === '/api/health') {
+        return sendJson(res, 200, {
+          ok: true,
+          agentId: cfg.agentId,
+          version: cfg.version,
+          product: cfg.product,
+          canExport: cfg.canExport,
+          member: cfg.member === true,
+          engineRoot: cfg.engineRoot || null,
+          enginePresent: !!(cfg.engineRoot && fs.existsSync(cfg.engineRoot)),
+          workspace: cfg.workspace,
+        });
+      }
+
+      if (pathname === '/api/jobs' && req.method === 'GET') {
+        return sendJson(res, 200, { jobs: jobs.list().map(fillFromBrief) });
+      }
+      if (req.method === 'GET' && /^\/api\/jobs\/[^/]+\/film$/.test(pathname)) {
+        const id = decodeURIComponent(pathname.slice('/api/jobs/'.length, -'/film'.length));
+        const job = jobs.get(id);
+        let file = job ? String(job.outputMp4 || '') : '';
+        if (job && (!file || !fs.existsSync(file) || isIntermediateMp4(file))) {
+          const rescued = file && !fs.existsSync(file) ? rescueMissingFilm(file) : '';
+          const late = rescued
+            ? { path: rescued, size: fs.statSync(rescued).size }
+            : locateJobFilm(job, cfg);
+          if (late && late.path && fs.existsSync(late.path) && !isIntermediateMp4(late.path)) {
+            jobs.update(job.id, {
+              status: 'done',
+              progress: 100,
+              phase: 'film',
+              message: `成片已就绪 · ${path.basename(late.path)}`,
+              outputMp4: late.path,
+              artifact: late.path,
+              filmBytes: late.size,
+              filmAt: new Date().toISOString(),
+            });
+            file = late.path;
+          }
+        }
+        if (!file || !file.toLowerCase().endsWith('.mp4') || !fs.existsSync(file)) return sendJson(res, 404, { error: '成片还没有' });
+        return serveLocalFile(req, res, file);
+      }
+      if (pathname.startsWith('/api/jobs/') && req.method === 'GET') {
+        const job = jobs.get(pathname.slice('/api/jobs/'.length));
+        if (!job) return sendJson(res, 404, { error: 'job not found' });
+        return sendJson(res, 200, { job: fillFromBrief(job) });
+      }
+      if (pathname.startsWith('/api/jobs/') && req.method === 'DELETE') {
+        const id = pathname.slice('/api/jobs/'.length);
+        if (!id) return sendJson(res, 400, { error: 'job id required' });
+        const ok = jobs.remove(id);
+        if (!ok) return sendJson(res, 404, { error: 'job not found' });
+        return sendJson(res, 200, { ok: true, id });
+      }
+
+      if (pathname === '/api/optimize-prompt' && req.method === 'POST') {
+        if (cfg.member !== true) {
+          sendJson(res, 403, { error: '会员专属，请先开通会员' });
+          return;
+        }
+        try {
+          const body = await readJsonBody(req);
+          sendJson(res, 200, optimizePrompt(body));
+        } catch (error) {
+          const message = error instanceof SyntaxError ? '请求无法读取' : (error.message || '无法优化提示词');
+          sendJson(res, error.status || 400, { error: message });
+        }
+        return;
+      }
+
+      if (api) {
+        const handled = await api({ req, res, url, pathname, cfg, jobs, root, sendJson, readJsonBody, readBody });
+        if (handled) return;
+      }
+
+      let filePath = pathname === '/' ? path.join(studio, 'index.html') : path.join(studio, pathname.replace(/^\//, ''));
+      if (!filePath.startsWith(studio)) return sendJson(res, 403, { error: 'forbidden' });
+      if (fs.existsSync(filePath) && fs.statSync(filePath).isDirectory()) filePath = path.join(filePath, 'index.html');
+      return serveStatic(res, filePath);
+    } catch (error) {
+      sendJson(res, error.status || 500, { error: error.message || String(error) });
+    }
+  });
+
+  if (!cfg.port) throw new Error('PANEL_PORT is required');
+  server.listen(cfg.port, '127.0.0.1', () => {
+    console.log(`[${cfg.agentId}] studio on http://127.0.0.1:${cfg.port}`);
+  });
+  return { server, cfg, jobs };
+}