Skip to content

LumosLab-Innovation/3D-lab-skills / plugins/threejs-lab/skills/threejs-studio

threejs-studio

Verified

Create image options, get human approval on localhost, author geometry in Three.js or Blender MCP, then code Three.js motion, contraction and interaction for either model. Use for prompt-to-3D, image-to-model, animated interactive assets or resuming visual approval across coding agents. No paid image-to-3D service.

web/app.js

View on GitHub
const $ = (id) => document.getElementById(id);
const reviewKey = document.querySelector('meta[name="review-key"]').content;
let state, imageId, modelId, shownModel, previewTimeout, target = "model", busy = false, connectionLost = false;
let previewGeneration = 0;
const ready = new Set();
const error = (message = "") => { $("error").textContent = message; $("error").hidden = !message; };
async function post(path, data) {
  const response = await fetch(path, { method: "POST", headers: { "Content-Type": "application/json", "X-Review-Key": reviewKey }, body: JSON.stringify(data) });
  const result = await response.json();
  if (!response.ok) throw new Error(result.error);
  return result;
}
function model() { return state.models.find((m) => m.id === modelId); }
function syncButton() {
  $("approve").disabled = busy || (state.stage === "image_review" ? !imageId : state.stage === "model_review" ? !ready.has(modelId) : true);
}
function selectModel(id) {
  modelId = id;
  const item = model();
  for (const button of $("model-options").children) button.setAttribute("aria-pressed", String(button.dataset.id === id));
  $("viewer").hidden = !item;
  $("waiting").hidden = Boolean(item);
  if (!item) { clearTimeout(previewTimeout); shownModel = undefined; $("viewer").removeAttribute("src"); }
  if (item && shownModel !== id) {
    previewGeneration++;
    error(); clearTimeout(previewTimeout);
    shownModel = id;
    ready.delete(id);
    const params = new URLSearchParams({ entry: "/" + item.entry, kind: item.engine, id: item.id });
    if (item.behavior) params.set("behavior", "/" + item.behavior);
    $("viewer").src = `/viewer.html?${params}`;
    previewTimeout = setTimeout(() => { if (!ready.has(id)) error("Mô hình chưa tải xong. Tải lại trang hoặc yêu cầu sửa."); }, 30000);
  }
  $("downloads").replaceChildren();
  for (const file of item?.files || []) {
    const a = document.createElement("a");
    a.href = "/" + file.file; a.download = file.file.split("/").pop();
    a.textContent = file.file.endsWith(".blend") ? "Tải .blend ↓" : file.file.endsWith(".json") ? "Tải source ↓" : file.file.endsWith(".glb") ? "Tải GLB ↓" : file.file.endsWith("behavior.mjs") ? "Tải tương tác ↓" : "Tải module ↓";
    $("downloads").append(a);
  }
  syncButton();
}
function render() {
  const imageStage = !state.imageApproval;
  const done = state.stage === "accepted";
  $("title").textContent = imageStage ? "Chọn hướng hình ảnh" : done ? "Mô hình đã duyệt" : "Xem & chốt mô hình";
  $("prompt").textContent = state.prompt;
  $("status").textContent = { awaiting_images: "Chờ ảnh", image_review: "Chờ bạn chọn", building: "Đang tạo 3D", model_review: "Chờ bạn duyệt", accepted: "Đã lưu lựa chọn" }[state.stage];
  $("step-image").classList.toggle("active", imageStage);
  $("step-model").classList.toggle("active", !imageStage && !done);
  $("step-done").classList.toggle("active", done);
  $("engine-picker").hidden = !imageStage;
  $("engine").value = state.engine;
  $("workspace").hidden = imageStage;
  $("images").hidden = !imageStage;
  $("approve").hidden = done || state.stage === "building" || state.stage === "awaiting_images";
  $("approve").textContent = imageStage ? "Dùng ảnh này ↗" : "Duyệt mô hình ✓";
  $("revise").hidden = state.stage === "awaiting_images";
  const images = state.images.filter((item) => item.round === state.imageRound);
  $("empty").hidden = !imageStage || images.length > 0;
  if (!images.some((i) => i.id === imageId)) imageId = undefined;
  $("images").replaceChildren();
  for (const item of images) {
    const button = document.createElement("button"); button.type = "button"; button.className = "image-option";
    button.setAttribute("aria-pressed", String(imageId === item.id));
    button.setAttribute("aria-label", item.title);
    const img = document.createElement("img"); img.src = "/" + item.file; img.alt = item.title;
    const caption = document.createElement("span"); caption.className = "caption";
    const name = document.createElement("span"); name.textContent = item.title;
    const check = document.createElement("span"); check.className = "checkmark"; check.textContent = "✓"; check.setAttribute("aria-hidden", "true");
    caption.append(name, check); button.append(img, caption);
    button.onclick = () => { imageId = item.id; for (const child of $("images").children) child.setAttribute("aria-pressed", String(child === button)); syncButton(); };
    $("images").append(button);
  }
  if (!imageStage) {
    const reference = state.images.find((i) => i.id === state.imageApproval.id);
    $("reference-image").src = "/" + reference.file;
    const models = state.models.filter((m) => m.round === state.modelRound && m.reference === reference.sha256);
    if (!models.some((m) => m.id === modelId)) modelId = state.modelApproval?.id || models[0]?.id;
    $("model-options").replaceChildren();
    for (const item of models) {
      const button = document.createElement("button"); button.type = "button"; button.dataset.id = item.id;
      button.textContent = item.title; button.onclick = () => selectModel(item.id); $("model-options").append(button);
    }
    selectModel(modelId);
  } else {
    clearTimeout(previewTimeout); shownModel = undefined; $("viewer").removeAttribute("src");
  }
  syncButton();
}
async function refresh() {
  if (busy) return;
  try {
    const response = await fetch("/api/state");
    if (!response.ok) throw new Error("Không kết nối được studio. Hãy chạy lại lệnh serve.");
    const updated = await response.json();
    if (connectionLost) { error(); connectionLost = false; }
    if (state?.revision !== updated.revision) { state = updated; render(); }
  } catch { connectionLost = true; error("Mất kết nối Studio. Lựa chọn đã lưu vẫn được giữ nguyên."); }
}
$("approve").onclick = async () => {
  const item = state.stage === "image_review" ? state.images.find((i) => i.id === imageId) : model();
  if (!item) return;
  busy = true; syncButton(); error();
  try {
    state = await post("/api/decision", { revision: state.revision, id: item.id, sha256: item.sha256,
      action: state.stage === "image_review" ? "approve-image" : "approve-model", engine: $("engine").value });
    render();
  } catch (e) { error(e.message); } finally { busy = false; syncButton(); }
};
function revise(which) { target = which; $("revision").hidden = false; $("feedback").focus(); }
$("revise").onclick = () => revise(state.imageApproval ? "model" : "image");
$("change-reference").onclick = () => revise("image");
$("cancel-revision").onclick = () => { $("revision").hidden = true; $("feedback").value = ""; };
$("revision").onsubmit = async (event) => {
  event.preventDefault(); busy = true; syncButton(); error();
  try {
    state = await post("/api/decision", { action: "revise", revision: state.revision, target, note: $("feedback").value });
    $("revision").hidden = true; $("feedback").value = ""; render();
  } catch (e) { error(e.message); } finally { busy = false; syncButton(); }
};
window.addEventListener("message", async (event) => {
  if (event.source !== $("viewer").contentWindow || event.origin !== "null" || event.data?.id !== modelId) return;
  if (event.data.type === "model-ready") {
    clearTimeout(previewTimeout); error();
    const item = model();
    const generation = previewGeneration;
    try { await post("/api/viewed", { id: item.id, sha256: item.sha256 }); if (generation === previewGeneration) ready.add(item.id); syncButton(); }
    catch (e) { error(e.message); }
  } else if (event.data.type === "model-error") {
    previewGeneration++;
    clearTimeout(previewTimeout);
    ready.delete(modelId); syncButton(); error("Không mở được mô hình: " + String(event.data.message).slice(0, 240));
  }
});
await refresh();
setInterval(refresh, 1200);
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall