LumosLab-Innovation/3D-lab-skills / plugins/threejs-lab/skills/threejs-studio
threejs-studio
VerifiedCreate 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.
| File | Kind | Size |
|---|---|---|
| .npmignore | other | 51 B |
| SKILL.md | skill md | 5.9 KB |
| agents/openai.yaml | config | 269 B |
| assets/examples/blender-pulse.py | script | 2.2 KB |
| assets/examples/pulse-behavior.mjs | script | 1.6 KB |
| assets/examples/pulse-model.mjs | script | 1012 B |
| package-lock.json | manifest | 14.0 KB |
| package.json | manifest | 235 B |
| references/blender-setup.md | markdown | 1.1 KB |
| references/blender.md | markdown | 3.0 KB |
| references/hard-surface.md | markdown | 4.3 KB |
| references/image-options.md | markdown | 1.5 KB |
| references/licenses/img2threejs.txt | markdown | 11.1 KB |
| references/licenses/vibe3d.txt | markdown | 1.1 KB |
| references/motion-interaction.md | markdown | 3.9 KB |
| references/reconstruction.md | markdown | 2.3 KB |
| references/threejs.md | markdown | 2.8 KB |
| scripts/blender_export.py | script | 2.2 KB |
| scripts/cli.mjs | script | 6.2 KB |
| scripts/server.mjs | script | 7.7 KB |
| scripts/state.mjs | script | 9.8 KB |
| web/app.js | script | 7.8 KB |
| web/index.html | other | 3.7 KB |
| web/motion.js | script | 2.1 KB |
| web/style.css | other | 8.2 KB |
| web/viewer.html | other | 3.8 KB |
| web/viewer.js | script | 11.6 KB |
web/app.js
View on GitHubconst $ = (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);
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 472k | Updated | Claude CodeCodex | Verified | Install |
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |