cozyclay 3.1.2 → 3.1.4

package/src/panels/SculptPanel.jsx

@@ -1,6 +1,6 @@
 import { useEffect, useRef, useState } from "react";
 import Foldout from "./Foldout.jsx";
-import { ko, isKo } from "../locale.js";
+import { ko } from "../locale.js";
 import { effortOptions } from "../workflow/agent-client.js"; import { saveExport } from "../export-workspace.js";
 import "./sculpt.css";
 
@@ -59,7 +59,7 @@ function NowLine({ waiting, now = Date.now() }) {
 			<span className="sculpt-now-time" data-testid="sculpt-now-time">{Math.floor(waited / 1000)}s</span>
 			{expect !== null && (
 				<span className="sculpt-now-expect">
-					{over ? ko("taking longer than usual", "평소보다 오래 걸려요") : isKo ? `보통 ~${Math.round(expect / 1000)}초` : `usually ~${Math.round(expect / 1000)}s`}
+					{over ? ko("taking longer than usual", "평소보다 오래 걸려요") : ko(`usually ~${Math.round(expect / 1000)}s`, `보통 ~${Math.round(expect / 1000)}초`, `通常约 ${Math.round(expect / 1000)} 秒`)}
 				</span>
 			)}
 			{expect !== null && <span className="sculpt-now-bar" aria-hidden="true"><span style={{ "--sculpt-wait": Math.min(1, waited / expect) }} /></span>}
@@ -78,7 +78,7 @@ function IouTrail({ history, target }) {
 	const delta = history.length > 1 ? last - history.at(-2).iou : null;
 	return (
 		<div className="sculpt-trail" data-testid="sculpt-trail">
-			<svg viewBox="0 0 100 34" preserveAspectRatio="none" aria-label={isKo ? `라운드별 IoU: ${values.map((v) => v.toFixed(3)).join(", ")}` : `IoU by round: ${values.map((v) => v.toFixed(3)).join(", ")}`} role="img">
+			<svg viewBox="0 0 100 34" preserveAspectRatio="none" aria-label={ko(`IoU by round: ${values.map((v) => v.toFixed(3)).join(", ")}`, `라운드별 IoU: ${values.map((v) => v.toFixed(3)).join(", ")}`, `各轮 IoU：${values.map((v) => v.toFixed(3)).join(", ")}`)} role="img">
 				{target !== null && <line className="sculpt-trail-target" x1="0" x2="100" y1={y(target)} y2={y(target)} />}
 				{history.length > 1 && <polyline className="sculpt-trail-line" points={history.map((row, index) => `${x(index)},${y(row.iou)}`).join(" ")} />}
 				{history.map((row, index) => <circle key={index} className="sculpt-trail-dot" data-last={index === history.length - 1 ? "true" : undefined} cx={x(index)} cy={y(row.iou)} r="2.2" />)}
@@ -186,7 +186,7 @@ function ModelPicker({ picker, locked }) {
 				{efforts.length > 0 && (
 					<select className="sculpt-select sculpt-effort" data-testid="sculpt-effort-select" aria-label={ko("Effort", "추론 강도")} value={effort ?? ""} disabled={locked}
 						onChange={(event) => onEffort?.(event.target.value || null)}>
-						<option value="">{isKo ? `기본 (${efforts[0]})` : `Default (${efforts[0]})`}</option>
+						<option value="">{ko(`Default (${efforts[0]})`, `기본 (${efforts[0]})`, `默认（${efforts[0]}）`)}</option>
 						{efforts.map((value) => <option key={value} value={value}>{value}</option>)}
 					</select>
 				)}
@@ -293,7 +293,7 @@ export default function SculptPanel({ run, reference, onReference, onStart, onCa
 						onDragOver={(event) => { if (event.dataTransfer?.types?.includes("Files")) event.preventDefault(); }}
 						onDrop={(event) => { event.preventDefault(); take(event.dataTransfer?.files); }}>
 						<div className="sculpt-ref-frame">
-							<img src={reference.dataUrl} alt={isKo ? `참조 이미지: ${reference.name}` : `Reference: ${reference.name}`} />
+							<img src={reference.dataUrl} alt={ko(`Reference: ${reference.name}`, `참조 이미지: ${reference.name}`, `参考图：${reference.name}`)} />
 							<OutlineScan outline={run?.outline} scanning={stage === "measure" && !run?.outline} />
 						</div>
 						<button type="button" className="btn ghost small sculpt-well-replace" data-testid="sculpt-reference-replace"
@@ -351,7 +351,7 @@ export default function SculptPanel({ run, reference, onReference, onStart, onCa
 						{running && <NowLine waiting={run.waiting} />}
 
 						<div className="sculpt-stats">
-							<span data-testid="sculpt-round">{isKo ? `라운드 ${run.round} / ${run.maxRounds}` : `Round ${run.round} / ${run.maxRounds}`}</span>
+							<span data-testid="sculpt-round">{ko(`Round ${run.round} / ${run.maxRounds}`, `라운드 ${run.round} / ${run.maxRounds}`, `第 ${run.round} / ${run.maxRounds} 轮`)}</span>
 							<span data-testid="sculpt-elapsed">{formatElapsed(run.elapsedMs)}</span>
 						</div>
 
@@ -365,7 +365,7 @@ export default function SculptPanel({ run, reference, onReference, onStart, onCa
 								data-reached={iou !== null && target !== null && iou >= target ? "true" : undefined}
 								style={{ "--sculpt-iou": iou ?? 0, "--sculpt-target": target ?? 0 }}>
 								<span className="sculpt-iou-fill" />
-								{target !== null && <span className="sculpt-iou-marker" data-testid="sculpt-iou-target" title={isKo ? `목표 ${formatIou(target)}` : `Target ${formatIou(target)}`} />}
+								{target !== null && <span className="sculpt-iou-marker" data-testid="sculpt-iou-target" title={ko(`Target ${formatIou(target)}`, `목표 ${formatIou(target)}`, `目标 ${formatIou(target)}`)} />}
 							</div>
 							<IouTrail history={run.history} target={target} />
 						</div>
@@ -374,7 +374,7 @@ export default function SculptPanel({ run, reference, onReference, onStart, onCa
 						<ActivityLog activity={run.activity} />
 
 						{run.message && !hasLog && <p className="inspector-hint sculpt-message" role="status">{run.message}</p>}
-						{stage === "done" && <p className="inspector-hint sculpt-done" role="status" data-testid="sculpt-done">{isKo ? `완료 — IoU ${formatIou(iou)}` : `Done — IoU ${formatIou(iou)}`}</p>}
+						{stage === "done" && <p className="inspector-hint sculpt-done" role="status" data-testid="sculpt-done">{ko(`Done — IoU ${formatIou(iou)}`, `완료 — IoU ${formatIou(iou)}`, `完成 — IoU ${formatIou(iou)}`)}</p>}
 						{stage === "cancelled" && <p className="inspector-hint" role="status" data-testid="sculpt-cancelled">{ko("Cancelled.", "취소했어요.")}</p>}
 						{stage === "failed" && <p className="inspector-hint sculpt-error" role="alert" data-testid="sculpt-error">{run.error || ko("The sculpt run failed.", "조형에 실패했어요.")}</p>}
 					</div>
@@ -391,7 +391,7 @@ export default function SculptPanel({ run, reference, onReference, onStart, onCa
 				)}
 
 				<button type="button" className="btn full" data-testid="sculpt-place" disabled={!sculptName || running}
-					aria-label={sculptName ? (isKo ? `${sculptName} 장면에 배치` : `Place ${sculptName} in scene`) : ko("Place in scene", "장면에 배치")}
+					aria-label={sculptName ? ko(`Place ${sculptName} in scene`, `${sculptName} 장면에 배치`, `将 ${sculptName} 放入场景`) : ko("Place in scene", "장면에 배치")}
 					onClick={() => onPlaceInScene?.()}>
 					{ko("Place in scene", "장면에 배치")}
 				</button>

package/src/panels/SubjectBox.jsx

@@ -1,4 +1,4 @@
-import { ko, isKo } from "../locale.js";
+import { ko } from "../locale.js";
 
 export default function SubjectBox({ label, onRemove, onPose, posing, color, onColorChange, onColorEditStart }) {
 	return (
@@ -28,8 +28,8 @@ export default function SubjectBox({ label, onRemove, onPose, posing, color, onC
 						<button
 							type="button"
 							className={"cam-toggle" + (posing ? " active" : "")}
-							aria-label={isKo ? `${label} 포즈 열기` : `Open pose studio for ${label}`}
-							title={isKo ? `${label} 포즈` : `Pose ${label}`}
+							aria-label={ko(`Open pose studio for ${label}`, `${label} 포즈 열기`, `打开 ${label} 的姿势工作室`)}
+							title={ko(`Pose ${label}`, `${label} 포즈`, `${label} 姿势`)}
 							onClick={onPose}
 						>
 							{/* The Pose mode figure, not a keyboard glyph. */}

package/src/panels/SubjectsPanel.jsx

@@ -14,7 +14,7 @@ export default function SubjectsPanel({
 							{characters.map((entry, index) => entry.hidden ? null : (
 								<SubjectBox
 									key={entry.id}
-									label={ko(`Subject ${index + 1}`, `인물 ${index + 1}`)}
+									label={ko(`Subject ${index + 1}`, `인물 ${index + 1}`, `角色 ${index + 1}`)}
 									onPose={() => openStudio(entry.id)}
 									posing={posing === entry.id}
 									onRemove={index > 0 ? () => run('character.remove', { characterId: entry.id }) : undefined}

package/src/posestudio.jsx

@@ -5,9 +5,10 @@ import * as THREE from "three";
 import { POSE_BONES, normalizeBoneName, primeBindPose } from "./poses.js";
 import { poseThumbnail, warmThumbnailModels } from "./pose-thumbs.js";
 import { IK_TRACKS, MID_TRACKS, ikControlIsExposed } from "./motion/ik.js";
+import { pickIkHit } from "./motion/ik-pick.js";
 import { shouldRefreshIkExposure } from "./use-render-activity.js";
 import { POSER_LAYER } from "./dualview.jsx";
-import { ko, isKo } from "./locale.js";
+import { ko } from "./locale.js";
 import { ROTATION_AXES, backFaceFade, bindQuaternionOf, handleColor as sideColor, ringAngle, rotationFromBindDeg, rotationReadout } from "./pose-gizmo.js";
 import "./pose-gizmo.css";
 
@@ -754,7 +755,9 @@ export function IkHandles({ chains, fkJoints, ikState, enabled, focus, onFocus,
 				halo.material.opacity = mesh.material.opacity * (focused ? 0.6 : 0.4);
 			}
 		}
-		const focusExposed = !!focus && visibilityRef.current.get(focus) !== false;
+		// A focused control keeps its gizmo and rings even when the body hides it:
+		// the user picked it, and while focused nothing else can take a press.
+		const focusExposed = !!focus;
 		if (gizmoRef.current) gizmoRef.current.visible = focusExposed;
 		if (ringRef.current) ringRef.current.visible = focusExposed;
 
@@ -938,10 +941,11 @@ const CLICK_PX = 4;
 			if (ev.button !== 0) return;
 			const downXY = [ev.clientX, ev.clientY];
 			const focused = focusIdRef.current;
+			// A hidden unfocused control keeps only its sphere: its gizmo and rings are not drawn.
 			let picks = pickRefs.current.filter((p) =>
 				p.mesh?.visible &&
 				handleRefs.current[p.track.id]?.visible &&
-				handleRefs.current[p.track.id]?.userData.ikExposed !== false
+				(handleRefs.current[p.track.id]?.userData.ikExposed !== false || !p.part || p.track.id === focused)
 			);
 			if (focused && !selectionOnly) picks = picks.filter((p) => p.track.id === focused);
 			else picks = picks.filter((p) => !p.axisDir); // spheres only
@@ -955,13 +959,11 @@ const CLICK_PX = 4;
 				-((ev.clientY - rect.top) / rect.height) * 2 + 1
 			);
 			raycaster.setFromCamera(ndc, camera);
-			const hits = raycaster.intersectObjects(picks.map((p) => p.mesh), false);
-			if (!hits.length) {
+			const pick = pickIkHit(raycaster.intersectObjects(picks.map((p) => p.mesh), false), picks, handleRefs.current);
+			if (!pick) {
 				if (focused) beginDrag("empty", { id: "empty" }, null, null, downXY);
 				return;
 			}
-			const pick = picks.find((p) => p.mesh === hits[0].object);
-			if (!pick) return;
 			if (typeof window !== "undefined") {
 				window.__ikLastPick = { trackId: pick.track.id, kind: pick.kind, part: pick.part };
 			}
@@ -1298,7 +1300,7 @@ export function PoseStudioPanel({ subject, model, poses, selectedId, onSelect, o
 	return (
 		<div className={"pose-studio" + (docked ? " docked" : "") + (closing ? " closing" : "")}>
 			<div className="studio-head">
-				<span>{isKo ? `포즈 스튜디오 · 인물 ${subject}` : `Pose Studio · Subject ${subject}`}</span>
+				<span>{ko(`Pose Studio · Subject ${subject}`, `포즈 스튜디오 · 인물 ${subject}`, `姿势工作室 · 角色 ${subject}`)}</span>
 				<button type="button" className="x" onClick={onClose} aria-label={ko("Close pose studio", "포즈 스튜디오 닫기")}>
 					✕
 				</button>

package/src/project-browser.css

@@ -390,7 +390,7 @@
 }
 
 .v2-start-screen .v2-start-recent-actions button,
-.v2-start-screen .v2-start-file-button,
+.v2-start-screen .v2-start-empty-open,
 .v2-start-screen .v2-start-learn-action {
 	padding: 0;
 	border: 0;
@@ -400,7 +400,7 @@
 }
 
 .v2-start-screen .v2-start-recent-actions button:hover,
-.v2-start-screen .v2-start-file-button:hover,
+.v2-start-screen .v2-start-empty-open:hover,
 .v2-start-screen .v2-start-learn-action:hover {
 	color: var(--text-1, #e4e4e7);
 }
@@ -510,10 +510,11 @@
 	line-height: 1.55;
 }
 
-.v2-start-screen .v2-start-file-actions {
-	margin-top: auto;
-	padding-top: var(--sp-1, 8px);
-}
+/* A toast raised from this screen (a project that would not open) shows above it, not behind it. */
+.app:has(.v2-start-screen) .toast { z-index: calc(var(--start-z-index, 200) + 1); }
+
+/* The open card's art is solid: it names a real file, not a blank slot. */
+.v2-start-screen .v2-start-open-card .v2-start-add-art { border-style: solid; }
 
 /* --------------------------------------------------------------- preview --- */
 

package/src/project-browser.jsx

@@ -294,7 +294,7 @@ export default function ProjectBrowser({ currentName, onOpen, onOpenFile, onNew,
 									<button type="button" onClick={onOpenFile}>{ko("Open project file…", "프로젝트 파일 열기…")}</button>
 								</div>
 							</div>
-							<RecentList entries={recentEntries} currentName={currentName} onOpen={onOpen} onRemove={async (entry) => {
+							<RecentList entries={recentEntries} currentName={currentName} onOpen={onOpen} onOpenFile={onOpenFile} onRemove={async (entry) => {
 								await removeRecentProject(entry.name);
 								setRecents(await loadRecentProjects());
 							}} />
@@ -326,18 +326,18 @@ export default function ProjectBrowser({ currentName, onOpen, onOpenFile, onNew,
 										<span>{ko("Start from an empty stage", "빈 무대에서 시작")}</span>
 									</span>
 								</button>
+								<button type="button" role="listitem" className="v2-start-add-card v2-start-open-card" data-testid="start-open-project-card" onClick={onOpenFile}><span className="v2-start-add-art" aria-hidden="true"><svg viewBox="0 0 20 20" width="20" height="20"><path d="M2.5 6.5V15a1 1 0 0 0 1 1h13a1 1 0 0 0 1-1V8a1 1 0 0 0-1-1H10L8.5 5H3.5a1 1 0 0 0-1 1.5Z" fill="none" stroke="currentColor" strokeWidth="1.5" strokeLinejoin="round" /></svg></span><span className="v2-start-template-copy"><strong>{ko("Open project", "프로젝트 열기")}</strong><span>{ko("A saved .cclayproject file", "저장한 .cclayproject 파일")}</span></span></button>
 							</div>
 
 							<div className="v2-start-recent-block">
 								<div className="v2-start-recent-heading"><span>{ko("Recent", "최근")}</span></div>
-								<RecentList entries={recents.map((entry) => ({ ...entry, key: `recent-${entry.name}`, removable: true, date: entry.openedAt }))} currentName={currentName} onOpen={onOpen} onRemove={async (entry) => {
+								<RecentList entries={recents.map((entry) => ({ ...entry, key: `recent-${entry.name}`, removable: true, date: entry.openedAt }))} currentName={currentName} onOpen={onOpen} onOpenFile={onOpenFile} onRemove={async (entry) => {
 									await removeRecentProject(entry.name);
 									setRecents(await loadRecentProjects());
 								}} compact />
 							</div>
 						</>
 					)}
-					{activeNav !== "recent" && activeNav !== "learn" && <div className="v2-start-file-actions"><button type="button" className="v2-start-file-button" onClick={onOpenFile}>{ko("Open project file…", "프로젝트 파일 열기…")}</button></div>}
 				</main>
 
 				<aside className="v2-start-preview" data-testid="start-project-preview" aria-label={ko("Project preview", "프로젝트 미리보기")}>
@@ -392,9 +392,10 @@ export default function ProjectBrowser({ currentName, onOpen, onOpenFile, onNew,
 	);
 }
 
-function RecentList({ entries, currentName, onOpen, onRemove, compact = false }) {
+// Recents live in this browser's storage for this address, so a project saved elsewhere opens from its file.
+function RecentList({ entries, currentName, onOpen, onOpenFile, onRemove, compact = false }) {
 	return entries.length === 0 ? (
-		<p className={`v2-start-empty${compact ? " compact" : ""}`}>{ko("No recent projects yet.", "아직 최근 프로젝트가 없습니다.")}</p>
+		<p className={`v2-start-empty${compact ? " compact" : ""}`}>{ko("No recent projects in this browser yet. ", "이 브라우저에 최근 프로젝트가 없습니다. ")}<button type="button" className="v2-start-empty-open" onClick={onOpenFile}>{ko("Open a project file…", "프로젝트 파일 열기…")}</button></p>
 	) : (
 		<div className={`v2-start-recent-list${compact ? " compact" : ""}`} role="list">
 			{entries.map((entry) => (
@@ -404,7 +405,7 @@ function RecentList({ entries, currentName, onOpen, onRemove, compact = false })
 						<span>{formatDate(entry.date)}</span>
 						<small>{entry.shots ?? "—"}{ko(" shots", " 샷")}</small>
 					</button>
-					{entry.removable && <button type="button" className="v2-start-recent-remove" aria-label={ko(`Remove ${entry.name} from recent projects`, `최근 프로젝트에서 ${entry.name} 제거`)} title={ko("Remove from list", "목록에서 제거")} onClick={() => onRemove(entry)}>×</button>}
+					{entry.removable && <button type="button" className="v2-start-recent-remove" aria-label={ko(`Remove ${entry.name} from recent projects`, `최근 프로젝트에서 ${entry.name} 제거`, `从最近项目中移除 ${entry.name}`)} title={ko("Remove from list", "목록에서 제거")} onClick={() => onRemove(entry)}>×</button>}
 				</div>
 			))}
 		</div>

package/src/project-open-file.js

@@ -0,0 +1,19 @@
+import { hasFileSystemAccess, openProjectFallback, pickProjectFileForOpen, readProjectFile } from "./project.js";
+
+const PICKER_UNREADABLE_KEY = "cozyclay.open-picker-unreadable";
+
+/** Pick a project file to open: { file, handle } (file null when the author cancels), or { blocked: true }.
+ * Some embedded browsers (the OmO desktop preview is one) hand back a picked handle and then refuse to read it
+ * (NotAllowedError on getFile). After one refusal this browser opens projects through a plain file input,
+ * which reads the file without a handle; when the click's activation is still live that input opens at once. */
+export async function pickProjectToOpen(storage = globalThis.localStorage, activation = globalThis.navigator?.userActivation) {
+	if (!hasFileSystemAccess() || storage?.getItem(PICKER_UNREADABLE_KEY) === "1") return { file: await openProjectFallback(), handle: null };
+	const handle = await pickProjectFileForOpen();
+	try {
+		return { file: await readProjectFile(handle), handle };
+	} catch (error) {
+		if (error?.name !== "NotAllowedError") throw error;
+		try { storage?.setItem(PICKER_UNREADABLE_KEY, "1"); } catch { /* the next open asks the picker again */ }
+		return activation?.isActive ? { file: await openProjectFallback(), handle: null } : { blocked: true };
+	}
+}

package/src/qa-label.js

@@ -14,7 +14,7 @@ export function qaProblems(qa) {
 export function qaLabel(qa) {
 	const n = qaProblems(qa);
 	if (qa?.ok || !n) return ko("QA clean", "QA 통과");
-	return ko(`${n} problem${n === 1 ? "" : "s"}`, `문제 ${n}개`);
+	return ko(`${n} problem${n === 1 ? "" : "s"}`, `문제 ${n}개`, `${n} 个问题`);
 }
 
 /** A receipt's QA phrase: "clean" | "2 problems (321 frame issues)". */

package/src/range-pin-panel.jsx

@@ -5,10 +5,10 @@ import "./range-pin-panel.css";
 export const RANGE_PIN_TRACKS = Object.freeze(["leftHand", "rightHand", "leftFoot", "rightFoot"]);
 
 const PARTS = Object.freeze([
-	{ id: "leftHand", label: "Left Hand", ko: "왼손", color: "var(--range-pin-hand)" },
-	{ id: "rightHand", label: "Right Hand", ko: "오른손", color: "var(--range-pin-hand)" },
-	{ id: "leftFoot", label: "Left Foot", ko: "왼발", color: "var(--range-pin-foot)" },
-	{ id: "rightFoot", label: "Right Foot", ko: "오른발", color: "var(--range-pin-foot)" },
+	{ id: "leftHand", label: "Left Hand", ko: "왼손", zh: "左手", color: "var(--range-pin-hand)" },
+	{ id: "rightHand", label: "Right Hand", ko: "오른손", zh: "右手", color: "var(--range-pin-hand)" },
+	{ id: "leftFoot", label: "Left Foot", ko: "왼발", zh: "左脚", color: "var(--range-pin-foot)" },
+	{ id: "rightFoot", label: "Right Foot", ko: "오른발", zh: "右脚", color: "var(--range-pin-foot)" },
 ]);
 
 const PIN_ID_PREFIX = "pin";
@@ -77,10 +77,10 @@ function residualWarning(residuals) {
 		frames,
 		label: ko(
 			`Can't reach on ${frames.length} frame${frames.length === 1 ? "" : "s"}`,
-			`${frames.length}개 프레임에 닿지 않음`,
+			`${frames.length}개 프레임에 닿지 않음`, `${frames.length} 帧无法触及`,
 		),
-		title: ko(`Residual over 1 cm on frames ${frames.join(", ")}`, `1cm를 넘는 잔여 오차: ${frames.join(", ")}프레임`)
-			+ (feet.length ? ko(`; feet cannot stay planted on frames ${feet.join(", ")}`, `; 발 위치를 유지할 수 없는 프레임: ${feet.join(", ")}`) : ""),
+		title: ko(`Residual over 1 cm on frames ${frames.join(", ")}`, `1cm를 넘는 잔여 오차: ${frames.join(", ")}프레임`, `第 ${frames.join(", ")} 帧的残差超过 1 cm`)
+			+ (feet.length ? ko(`; feet cannot stay planted on frames ${feet.join(", ")}`, `; 발 위치를 유지할 수 없는 프레임: ${feet.join(", ")}`, `；第 ${feet.join(", ")} 帧无法保持双脚踩地`) : ""),
 	};
 }
 
@@ -88,7 +88,7 @@ function validationFor(draft, { motion, frameCount, objects }) {
 	if (!motion) return ko("Load a motion before creating a pin.", "핀을 만들기 전에 모션을 불러오세요.");
 	if (!RANGE_PIN_TRACKS.includes(draft.track)) return ko("Choose a hand or foot.", "손이나 발을 선택하세요.");
 	if (!Number.isInteger(Number(draft.startFrame)) || !Number.isInteger(Number(draft.endFrame))) return ko("In and Out must be whole frames.", "In과 Out은 정수 프레임이어야 해요.");
-	if (draft.startFrame < 0 || draft.endFrame >= frameCount) return ko(`Use frames 0–${Math.max(0, frameCount - 1)}.`, `${Math.max(0, frameCount - 1)}프레임 안에서 선택하세요.`);
+	if (draft.startFrame < 0 || draft.endFrame >= frameCount) return ko(`Use frames 0–${Math.max(0, frameCount - 1)}.`, `${Math.max(0, frameCount - 1)}프레임 안에서 선택하세요.`, `请使用第 0–${Math.max(0, frameCount - 1)} 帧。`);
 	if (draft.endFrame < draft.startFrame) return ko("Out must be on or after In.", "Out은 In 이후여야 해요.");
 	if (draft.targetKind === "object" && !draft.objectId) return ko("Choose a scene object.", "씬 오브젝트를 선택하세요.");
 	if (draft.targetKind === "object" && !objects.some((object) => object.id === draft.objectId)) return ko("That scene object is no longer available.", "씬 오브젝트를 찾을 수 없어요.");
@@ -98,7 +98,7 @@ function validationFor(draft, { motion, frameCount, objects }) {
 
 function targetLabel(pin, objects) {
 	if (pin.target.space === "object") {
-		return ko(`Object · ${objectName(objects.find((object) => object.id === pin.target.objectId))}`, `오브젝트 · ${objectName(objects.find((object) => object.id === pin.target.objectId))}`);
+		return ko(`Object · ${objectName(objects.find((object) => object.id === pin.target.objectId))}`, `오브젝트 · ${objectName(objects.find((object) => object.id === pin.target.objectId))}`, `物体 · ${objectName(objects.find((object) => object.id === pin.target.objectId))}`);
 	}
 	return ko("Hold at In", "In 위치 고정");
 }
@@ -233,7 +233,7 @@ export function RangePinPanel({
 							onClick={() => updateDraft({ track: part.id })}
 						>
 							<span className="range-pin-part-dot" aria-hidden="true" />
-							{ko(part.label, part.ko)}
+							{ko(part.label, part.ko, part.zh)}
 						</button>
 					))}
 				</div>
@@ -300,7 +300,7 @@ export function RangePinPanel({
 			{validation && <p className="range-pin-validation" role="alert">{validation}</p>}
 			{needsReplace && (
 				<div className="range-pin-replace-warning" role="alert">
-					<span>{ko(`Existing IK keys on ${conflictFrames.length} frame${conflictFrames.length === 1 ? "" : "s"}: ${conflictFrames.join(", ")}`, `기존 IK 키가 ${conflictFrames.length}개 프레임에 있어요: ${conflictFrames.join(", ")}`)}</span>
+					<span>{ko(`Existing IK keys on ${conflictFrames.length} frame${conflictFrames.length === 1 ? "" : "s"}: ${conflictFrames.join(", ")}`, `기존 IK 키가 ${conflictFrames.length}개 프레임에 있어요: ${conflictFrames.join(", ")}`, `${conflictFrames.length} 帧上已有 IK 关键帧：${conflictFrames.join(", ")}`)}</span>
 					<button type="button" className="btn ghost small" onClick={() => setReplaceConfirmed((value) => !value)} aria-pressed={replaceConfirmed}>
 						{replaceConfirmed ? ko("Replace confirmed", "교체 확인됨") : ko("Replace existing keys", "기존 키 교체")}
 					</button>
@@ -313,7 +313,7 @@ export function RangePinPanel({
 			</div>
 
 			<div className="range-pin-list-head">
-				<span>{ko("Pins", "고정 목록")}</span>
+				<span>{ko("Pins", "고정 목록", "固定项")}</span>
 				<small>{sortedPins.length}</small>
 			</div>
 			{sortedPins.length === 0 ? (
@@ -327,11 +327,11 @@ export function RangePinPanel({
 						return (
 							<div key={pin.id} className={"range-pin-item" + (selectedPinId === pin.id ? " selected" : "")} style={{ "--range-pin-color": part.color }}>
 								<button type="button" className="range-pin-item-main" onClick={() => editPin(pin)} aria-pressed={selectedPinId === pin.id}>
-									<span className="range-pin-item-top"><span className="range-pin-part-dot" aria-hidden="true" />{ko(part.label, part.ko)} <b>{pin.startFrame}–{pin.endFrame}</b></span>
+									<span className="range-pin-item-top"><span className="range-pin-part-dot" aria-hidden="true" />{ko(part.label, part.ko, part.zh)} <b>{pin.startFrame}–{pin.endFrame}</b></span>
 									<span className="range-pin-item-target">{missingObject ? ko("Missing object target", "오브젝트 대상 없음") : targetLabel(pin, objects)}</span>
 									{(warning || missingObject) && <span className="range-pin-warning" title={missingObject ? ko("The referenced object was deleted.", "참조한 오브젝트가 삭제됐어요.") : warning.title}>{missingObject ? ko("Invalid target", "대상 없음") : warning.label}</span>}
 								</button>
-								<button type="button" className="range-pin-delete" data-testid={`range-pin-delete-${pin.id}`} aria-label={ko(`Delete ${part.label} pin`, `${part.ko} 고정 삭제`)} title={ko("Delete pin", "고정 삭제")} onClick={() => onDelete?.(pin.id)}><span aria-hidden="true">×</span></button>
+								<button type="button" className="range-pin-delete" data-testid={`range-pin-delete-${pin.id}`} aria-label={ko(`Delete ${part.label} pin`, `${part.ko} 고정 삭제`, `删除${part.zh}固定`)} title={ko("Delete pin", "고정 삭제")} onClick={() => onDelete?.(pin.id)}><span aria-hidden="true">×</span></button>
 							</div>
 						);
 					})}

package/src/resource-status.jsx

@@ -106,7 +106,7 @@ export function ResourceStatus({ manifest, compact = false, onSelect }) {
 				<div className="resource-status-total is-missing"><dt>{ko("Missing", "누락")}</dt><dd data-total="missing">{totals.missing}</dd></div>
 				{totals.bytes > 0 ? <div className="resource-status-total is-bytes"><dt>{ko("Size", "용량")}</dt><dd data-total="bytes">{formatMiB(totals.bytes)}</dd></div> : null}
 			</dl>
-			{missing.length ? <p className="resource-status-warning" role="status">{ko(`${missing.length} resource${missing.length === 1 ? "" : "s"} will not travel with this project file.`, `${missing.length}개 자원이 프로젝트 파일에 담기지 않습니다.`)}</p> : null}
+			{missing.length ? <p className="resource-status-warning" role="status">{ko(`${missing.length} resource${missing.length === 1 ? "" : "s"} will not travel with this project file.`, `${missing.length}개 자원이 프로젝트 파일에 담기지 않습니다.`, `${missing.length} 个资源不会随此项目文件一起保存。`)}</p> : null}
 			{!compact && ordered.length ? (
 				<ul className="resource-status-items">
 					{ordered.map((item, index) => <ResourceItem key={itemKey(item, index)} item={item} index={index} onSelect={onSelect} />)}
@@ -127,7 +127,7 @@ function reasonBody(reason) {
 			<>
 				<strong>{ko("The project file would be too large.", "프로젝트 파일이 너무 큽니다.")}</strong>
 				<span className="save-blocked-size" data-bytes={reason.bytes} data-limit={reason.limit}>
-					{ko(`${formatMiB(reason.bytes)} of embedded resources; the limit is ${formatMiB(reason.limit)}.`, `내장 자원 ${formatMiB(reason.bytes)}, 한도 ${formatMiB(reason.limit)}.`)}
+					{ko(`${formatMiB(reason.bytes)} of embedded resources; the limit is ${formatMiB(reason.limit)}.`, `내장 자원 ${formatMiB(reason.bytes)}, 한도 ${formatMiB(reason.limit)}.`, `嵌入资源 ${formatMiB(reason.bytes)}；上限为 ${formatMiB(reason.limit)}。`)}
 				</span>
 			</>
 		);
@@ -136,7 +136,7 @@ function reasonBody(reason) {
 		const items = Array.isArray(reason.items) ? reason.items.filter((item) => item && typeof item === "object") : [];
 		return (
 			<>
-				<strong>{ko(`${items.length} resource${items.length === 1 ? " is" : "s are"} missing.`, `${items.length}개 자원이 누락되었습니다.`)}</strong>
+				<strong>{ko(`${items.length} resource${items.length === 1 ? " is" : "s are"} missing.`, `${items.length}개 자원이 누락되었습니다.`, `缺少 ${items.length} 个资源。`)}</strong>
 				<ul className="save-blocked-missing">
 					{items.map((item, index) => <ResourceItem key={itemKey(item, index)} item={item} index={index} />)}
 				</ul>

package/src/result-modal.jsx

@@ -1,4 +1,4 @@
-import { ko, isKo } from "./locale.js";
+import { ko } from "./locale.js";
 
 export default function ResultModal({ result, copied, recordedVideoName, onClose, onCopy, onDownload, downloadDisabled = false, exportFeedback = null }) {
 	const isVideo = result.mode === "video";
@@ -9,9 +9,9 @@ export default function ResultModal({ result, copied, recordedVideoName, onClose
 	if (isVideo && result.frameB) {
 		nextStep = (
 			<p>
-				{ko(`Paste the prompt into ${modelLabel}, set `, `${modelLabel}에 프롬프트를 붙여 넣고 `)}
+				{ko(`Paste the prompt into ${modelLabel}, set `, `${modelLabel}에 프롬프트를 붙여 넣고 `, `将提示词粘贴到 ${modelLabel}，设置 `)}
 				<code>blocking-frame-A-start.png</code>
-				{ko(" as the start frame, and ", "를 시작 프레임으로, ")}
+				{ko(" as the start frame, and ", "를 시작 프레임으로, ", " 作为起始帧，并将 ")}
 				<code>blocking-frame-B-end.png</code>
 				{ko(" as the end frame.", "를 끝 프레임으로 설정하세요.")}
 			</p>
@@ -19,21 +19,21 @@ export default function ResultModal({ result, copied, recordedVideoName, onClose
 	} else if (isVideo && hasFrame) {
 		nextStep = (
 			<p>
-				{ko(`Paste the prompt into ${modelLabel} and attach `, `${modelLabel}에 프롬프트를 붙여 넣고 `)}
+				{ko(`Paste the prompt into ${modelLabel} and attach `, `${modelLabel}에 프롬프트를 붙여 넣고 `, `将提示词粘贴到 ${modelLabel}，并附加 `)}
 				<code>blocking-frame.png</code>
-				{ko(" as the reference frame.", "를 참고 프레임으로 첨부하세요.")}
+				{ko(" as the reference frame.", "를 참고 프레임으로 첨부하세요.", " 作为参考帧。")}
 			</p>
 		);
 	} else if (hasFrame) {
 		nextStep = (
 			<p>
-				{ko(`Paste the prompt into ${modelLabel} and attach `, `${modelLabel}에 프롬프트를 붙여 넣고 `)}
+				{ko(`Paste the prompt into ${modelLabel} and attach `, `${modelLabel}에 프롬프트를 붙여 넣고 `, `将提示词粘贴到 ${modelLabel}，并附加 `)}
 				<code>blocking-frame.png</code>
-				{ko(" as the reference image.", "를 참고 이미지로 첨부하세요.")}
+				{ko(" as the reference image.", "를 참고 이미지로 첨부하세요.", " 作为参考图像。")}
 			</p>
 		);
 	} else {
-		nextStep = <p>{ko(`Paste the copied prompt into ${modelLabel} to create the scene.`, `복사한 프롬프트를 ${modelLabel}에 붙여 넣어 장면을 만드세요.`)}</p>;
+		nextStep = <p>{ko(`Paste the copied prompt into ${modelLabel} to create the scene.`, `복사한 프롬프트를 ${modelLabel}에 붙여 넣어 장면을 만드세요.`, `将复制的提示词粘贴到 ${modelLabel} 以创建场景。`)}</p>;
 	}
 
 	return (
@@ -61,7 +61,7 @@ export default function ResultModal({ result, copied, recordedVideoName, onClose
 				)}
 				{result.move && (
 					<div className="move-slate result-move-slate">
-						<span>{result.move.displaySlate ?? result.move.slate} · {isKo ? `${result.move.spanS}초` : `${result.move.spanS}s`}</span>
+						<span>{result.move.displaySlate ?? result.move.slate} · {result.move.spanS}{ko("s", "초", "秒")}</span>
 						<small>{ko("Camera move made from timeline keyframes", "타임라인 키프레임으로 만든 카메라 움직임")}</small>
 					</div>
 				)}
@@ -80,7 +80,7 @@ export default function ResultModal({ result, copied, recordedVideoName, onClose
 
 				{exportFeedback}
 				<section className="result-next" aria-labelledby="result-next-title">
-					<span className="result-next-kicker">{ko(`Next · ${modelLabel}`, `다음 · ${modelLabel}`)}</span>
+					<span className="result-next-kicker">{ko(`Next · ${modelLabel}`, `다음 · ${modelLabel}`, `下一步 · ${modelLabel}`)}</span>
 					<h4 id="result-next-title">{ko("Handing off to your AI", "AI에 넣는 순서")}</h4>
 					<div className="result-next-intro">{nextStep}</div>
 					<ol className="result-handoff-steps">

package/src/settings-menu.jsx

@@ -11,6 +11,7 @@ import PreferencesDialog from "./shell/PreferencesDialog.jsx";
 const LANGUAGES = [
 	{ id: "en", label: "English", action: "Switch to English" },
 	{ id: "ko", label: "한국어", action: "한국어로 전환" },
+	{ id: "zh", label: "简体中文", action: "切换到中文" },
 ];
 
 export default function SettingsMenu() {
@@ -25,7 +26,9 @@ export default function SettingsMenu() {
 	// the only visible hint that Korean exists used to be the old locale button.
 	// Until a language is stored, a ko-* browser sees the trigger in Korean.
 	const koreanBrowser = typeof navigator !== "undefined" && (navigator.language ?? "").startsWith("ko");
-	const label = !localeChosen && koreanBrowser ? "한국어" : ko("Settings", "설정");
+	const chineseBrowser = typeof navigator !== "undefined" && (navigator.language ?? "").startsWith("zh");
+	const firstRunCue = koreanBrowser ? "한국어" : chineseBrowser ? "简体中文" : null;
+	const label = !localeChosen && firstRunCue ? firstRunCue : ko("Settings", "설정", "设置");
 
 	return (
 		<div className="settings-menu-wrap">

package/src/shell/BoardSlot.jsx

@@ -103,7 +103,7 @@ export default function BoardSlot({ active = true }) {
 		} catch (error) {
 			attempt.fail(error);
 			console.warn(`[cozyclay] panel ${entry.id} could not be sent to Workflow`, error);
-			setToast(ko(`Could not send the panel to Workflow: ${error?.message || error}`, `패널을 워크플로로 보내지 못했어요: ${error?.message || error}`));
+			setToast(ko(`Could not send the panel to Workflow: ${error?.message || error}`, `패널을 워크플로로 보내지 못했어요: ${error?.message || error}`, `无法将面板发送到工作流：${error?.message || error}`));
 		}
 	}
 
@@ -151,7 +151,7 @@ export default function BoardSlot({ active = true }) {
 	return (
 		<section className="dock-board" aria-label={ko("Board", "보드")} data-testid="dock-board" hidden={!active}>
 			<header className="dock-board-head">
-				<span className="dock-board-count">{ko(`${stills.length} panels`, `패널 ${stills.length}개`)}</span>
+				<span className="dock-board-count">{ko(`${stills.length} panels`, `패널 ${stills.length}개`, `${stills.length} 个面板`)}</span>
 				{/* An empty board offers + Panel once, in its empty state. */}
 				{stills.length > 0 && (
 					<button type="button" className="dock-board-add" data-testid="board-add-panel" title={ko("Add a panel after the last one, framed by the current camera", "현재 카메라 구도로 마지막 패널 뒤에 패널 추가")} onClick={addPanel}>
@@ -245,7 +245,7 @@ function PanelCard({ shot, index, fps, thumb, stylizing, onStylize, onUnstylize,
 			data-stylizing={stylizing || undefined}
 			tabIndex={0}
 			draggable
-			aria-label={ko(`Panel ${index + 1}`, `패널 ${index + 1}`)}
+			aria-label={ko(`Panel ${index + 1}`, `패널 ${index + 1}`, `面板 ${index + 1}`)}
 			aria-current={selected ? "true" : undefined}
 			onClick={onSelect}
 			onKeyDown={(event) => {
@@ -312,7 +312,7 @@ function PanelCard({ shot, index, fps, thumb, stylizing, onStylize, onUnstylize,
 				key={`caption:${shot.caption ?? ""}`}
 				className="dock-board-caption"
 				data-testid="board-card-caption"
-				aria-label={ko(`Panel ${index + 1} caption`, `패널 ${index + 1} 캡션`)}
+				aria-label={ko(`Panel ${index + 1} caption`, `패널 ${index + 1} 캡션`, `面板 ${index + 1} 说明`)}
 				placeholder={ko("Action or dialogue", "동작 또는 대사")}
 				defaultValue={shot.caption ?? ""}
 				maxLength={500}
@@ -330,7 +330,7 @@ function PanelCard({ shot, index, fps, thumb, stylizing, onStylize, onUnstylize,
 					max={STILL_HOLD_MAX / fps}
 					step={0.5}
 					defaultValue={seconds}
-					aria-label={ko(`Panel ${index + 1} hold in seconds`, `패널 ${index + 1} 홀드 (초)`)}
+					aria-label={ko(`Panel ${index + 1} hold in seconds`, `패널 ${index + 1} 홀드 (초)`, `面板 ${index + 1} 停留秒数`)}
 					onBlur={commitHold}
 					onKeyDown={(event) => { if (event.key === "Enter") event.currentTarget.blur(); }}
 				/>

package/src/shell/CompositionGuideButton.jsx

@@ -8,7 +8,7 @@ export default function CompositionGuideButton({ guideMode, onCycle }) {
 			className={"vp-guide-cycle vp-embed-guide" + (guideMode === "off" ? "" : " on")}
 			aria-label={ko("Cycle composition guides", "구도 가이드 전환")}
 			aria-pressed={guideMode !== "off"}
-			title={ko(GUIDE_LABELS[guideMode].en, GUIDE_LABELS[guideMode].ko) + ko(" · click to cycle", " · 클릭으로 전환")}
+			title={ko(GUIDE_LABELS[guideMode].en, GUIDE_LABELS[guideMode].ko, GUIDE_LABELS[guideMode].zh) + ko(" · click to cycle", " · 클릭으로 전환")}
 			onClick={() => onCycle(nextGuideMode(guideMode))}
 		>
 			<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" aria-hidden="true">

package/src/shell/GhostsMenuGroup.jsx

@@ -26,7 +26,7 @@ export default function GhostsMenuGroup() {
 	const set = (patch) => runStudioAction("view.setGhosts", { mode: ghosts.mode, count: ghosts.count, step: ghosts.step, ...patch });
 	const options = [
 		{ value: "off", label: ko("Off", "끔") },
-		{ value: "step", label: ko(`Every ${ghosts.step} frames`, `${ghosts.step}프레임마다`) },
+		{ value: "step", label: ko(`Every ${ghosts.step} frames`, `${ghosts.step}프레임마다`, `每 ${ghosts.step} 帧`) },
 		{ value: "keys", label: ko("Key frames", "키 프레임") },
 	];
 	return (

package/src/shell/StatusBar.jsx

@@ -47,7 +47,7 @@ function ExportStatus({ status, label, recording }) {
 	const detail = [
 		message,
 		retryable && ko("Retry keeps the original shot, camera, range and settings; it does not change your edits.", "다시 시도하면 원래 샷·카메라·범위·설정을 사용하며 편집 내용은 바꾸지 않아요."),
-		handedOff > 0 && ko(`${handedOff} file(s) already handed off. Retry skips those files.`, `파일 ${handedOff}개는 이미 전달했어요. 다시 시도할 때 해당 파일은 건너뛰어요.`),
+		handedOff > 0 && ko(`${handedOff} file(s) already handed off. Retry skips those files.`, `파일 ${handedOff}개는 이미 전달했어요. 다시 시도할 때 해당 파일은 건너뛰어요.`, `已交付 ${handedOff} 个文件。重试时会跳过这些文件。`),
 		busy && stage === "mux" && ko("Finalizing MP4; this stage cannot be interrupted.", "MP4 마무리 중이에요. 이 단계는 중단할 수 없어요."),
 	].filter(Boolean).join(" ");
 	return (
@@ -86,9 +86,9 @@ function ExportStatus({ status, label, recording }) {
 function relativeTime(ms) {
 	const minutes = Math.floor(ms / 60000);
 	if (minutes < 1) return ko("just now", "방금");
-	if (minutes < 60) return ko(`${minutes} min ago`, `${minutes}분 전`);
+	if (minutes < 60) return ko(`${minutes} min ago`, `${minutes}분 전`, `${minutes} 分钟前`);
 	const hours = Math.floor(minutes / 60);
-	return ko(`${hours} h ago`, `${hours}시간 전`);
+	return ko(`${hours} h ago`, `${hours}시간 전`, `${hours} 小时前`);
 }
 
 // "Saved 2 min ago" once a save completes in this session; otherwise the
@@ -109,7 +109,7 @@ export function SaveState({ status }) {
 		return () => clearInterval(timer);
 	}, [savedAt]);
 	const text = savedAt !== null && status.state === "saved" && !status.dirty
-		? ko(`Saved ${relativeTime(now - savedAt)}`, `저장됨 · ${relativeTime(now - savedAt)}`)
+		? ko(`Saved ${relativeTime(now - savedAt)}`, `저장됨 · ${relativeTime(now - savedAt)}`, `已保存 · ${relativeTime(now - savedAt)}`)
 		: status.text;
 	return (
 		<span

package/src/shell/ViewportToolbar.jsx

@@ -177,7 +177,7 @@ export default function ViewportToolbar() {
 			aria-pressed={snapEnabled}
 			title={ko(
 				`Grid snapping ${snapEnabled ? "on" : "off"} (${SNAP_MOVE} · ${SNAP_TURN}) — click to toggle, hold Ctrl during a drag to invert`,
-				`그리드 스냅 ${snapEnabled ? "켜짐" : "꺼짐"} (${SNAP_MOVE} · ${SNAP_TURN}) — 클릭해 전환, 드래그 중 Ctrl을 누르면 반대로 작동`,
+				`그리드 스냅 ${snapEnabled ? "켜짐" : "꺼짐"} (${SNAP_MOVE} · ${SNAP_TURN}) — 클릭해 전환, 드래그 중 Ctrl을 누르면 반대로 작동`, `网格吸附 ${snapEnabled ? "开" : "关"}（${SNAP_MOVE} · ${SNAP_TURN}）— 点击切换，拖动时按住 Ctrl 反向`,
 			)}
 			onClick={() => setSnapEnabled((value) => !value)}
 		>
@@ -524,12 +524,12 @@ export default function ViewportToolbar() {
 									className={"view-menu-item vp-guide-cycle" + (guideMode === "off" ? "" : " active")}
 									aria-checked={guideMode !== "off"}
 									aria-pressed={guideMode !== "off"}
-									title={ko(GUIDE_LABELS[guideMode].en, GUIDE_LABELS[guideMode].ko) + ko(" · click to cycle", " · 클릭으로 전환")}
+									title={ko(GUIDE_LABELS[guideMode].en, GUIDE_LABELS[guideMode].ko, GUIDE_LABELS[guideMode].zh) + ko(" · click to cycle", " · 클릭으로 전환")}
 									onClick={() => runStudioAction("view.setGuideMode", { mode: nextGuideMode(guideMode) })}
 								>
 									<span className="view-menu-mark" aria-hidden="true">{guideMode !== "off" ? "✓" : ""}</span>
 									{ko("Composition guides", "구도 가이드")}
-									<small>{ko(GUIDE_LABELS[guideMode].en, GUIDE_LABELS[guideMode].ko)}</small>
+									<small>{ko(GUIDE_LABELS[guideMode].en, GUIDE_LABELS[guideMode].ko, GUIDE_LABELS[guideMode].zh)}</small>
 								</button>
 								<GhostsMenuGroup />
 								{/* Part colours repaint a BODY, so the section only exists