cozyclay 3.1.2 → 3.1.3

package/src/domains/motion.js

@@ -31,7 +31,7 @@ import * as THREE from "three";
 import { StudioProtocolError } from "../studio-agent-protocol.js";
 import { applyTakeFrame } from "../motion3/playback.js";
 import { advancePlayback, installPlaybackApplier } from "./playback.js";
-import { isKo, ko } from "../locale.js";
+import { ko } from "../locale.js";
 import { isProxyFigure } from "../scenes.js";
 import { refuseRigOnly } from "../character-kind.js";
 import { DEFAULT_POSE, restoreBindPositions, applyPose, applyHipsOffset } from "../poses.js";
@@ -439,9 +439,9 @@ export function useMotion(appContext) {
 		ikPreDragRef.current = null;
 		if (pending.rig) appContext.shared.poseMemberAtFrame(pending.rig, motion, pending.state, appContext.shared.tlFrame, IK_CORRECTION_BLEND_FRAMES);
 		setIkTick((value) => value + 1);
-		appContext.notify(isKo
-			? `IK 보정을 ${pending.startFrame}–${pending.endFrame}프레임에 적용했어요`
-			: `Applied IK correction across frames ${pending.startFrame}–${pending.endFrame}`);
+		appContext.notify(ko(`Applied IK correction across frames ${pending.startFrame}–${pending.endFrame}`,
+			`IK 보정을 ${pending.startFrame}–${pending.endFrame}프레임에 적용했어요`,
+			`已在第 ${pending.startFrame}–${pending.endFrame} 帧应用 IK 修正`));
 		return true;
 	}
 
@@ -496,8 +496,8 @@ export function useMotion(appContext) {
 			setRangePinSelection(resolved.pin.id);
 			setRangePinPreview({ draft: { ...draft, id: resolved.pin.id }, track: resolved.pin.track, target: resolved.targetWorld.toArray(), conflictFrames: [], overlapError: "" });
 			appContext.shared.setTlPlaying(false);
-			appContext.notify(isKo ? `${resolved.pin.track} 고정을 적용했어요 · ${resolved.pin.startFrame}–${resolved.pin.endFrame}프레임` : `Applied ${resolved.pin.track} pin · frames ${resolved.pin.startFrame}–${resolved.pin.endFrame}`);
-		} catch (error) { appContext.notify(ko(`Could not apply pin — ${error.message}`, `고정을 적용하지 못했어요 — ${error.message}`)); }
+			appContext.notify(ko(`Applied ${resolved.pin.track} pin · frames ${resolved.pin.startFrame}–${resolved.pin.endFrame}`, `${resolved.pin.track} 고정을 적용했어요 · ${resolved.pin.startFrame}–${resolved.pin.endFrame}프레임`, `已应用 ${resolved.pin.track} 固定 · 第 ${resolved.pin.startFrame}–${resolved.pin.endFrame} 帧`));
+		} catch (error) { appContext.notify(ko(`Could not apply pin — ${error.message}`, `고정을 적용하지 못했어요 — ${error.message}`, `无法应用固定 — ${error.message}`)); }
 	}
 	function deleteRangePin(pinId) {
 		const state = ensureRangePinState(appContext.shared.ikStateRef.current), pin = state.pins.get(pinId);
@@ -512,7 +512,7 @@ export function useMotion(appContext) {
 		liveState.pinResiduals.delete(pinId);
 		liveState.tracked = new Set([...liveState.keys.values()].flatMap((entry) => [...entry.keys()]));
 		setRangePinSelection(null); setRangePinPreview(null); setIkTick((value) => value + 1);
-		appContext.notify(isKo ? `${pin.track} 고정을 삭제했어요` : `Deleted ${pin.track} pin`);
+		appContext.notify(ko(`Deleted ${pin.track} pin`, `${pin.track} 고정을 삭제했어요`, `已删除 ${pin.track} 固定`));
 	}
 
 	/** Deep copy of an IK state's key map: frame → Map(trackId → {q,p}), with
@@ -881,7 +881,7 @@ export function useMotion(appContext) {
 	function ikAddKeyframe() {
 		if (!ikChains) return;
 		if (!keyIkPoseAtPlayhead()) return;
-		appContext.notify(isKo ? `${appContext.shared.tlFrame}프레임에 전신 IK 키를 추가했어요` : `Full-body IK key at frame ${appContext.shared.tlFrame}`);
+		appContext.notify(ko(`Full-body IK key at frame ${appContext.shared.tlFrame}`, `${appContext.shared.tlFrame}프레임에 전신 IK 키를 추가했어요`, `已在第 ${appContext.shared.tlFrame} 帧添加全身 IK 关键帧`));
 	}
 
 	function ikDeleteKeyframe(frame) {
@@ -918,9 +918,9 @@ export function useMotion(appContext) {
 		// Handles re-seat on the posed effectors, ready to drag into a refinement.
 		ikSeedTargets(ikChains, appContext.shared.ikStateRef.current);
 		setIkTick((n) => n + 1);
-		appContext.notify(isKo
-			? `${appContext.shared.tlFrame}프레임에 포즈를 전신 IK 보정 키로 추가했어요 — 모션은 그대로예요`
-			: `Pose keyed as a full-body IK correction at frame ${appContext.shared.tlFrame} — the take stays`);
+		appContext.notify(ko(`Pose keyed as a full-body IK correction at frame ${appContext.shared.tlFrame} — the take stays`,
+			`${appContext.shared.tlFrame}프레임에 포즈를 전신 IK 보정 키로 추가했어요 — 모션은 그대로예요`,
+			`已在第 ${appContext.shared.tlFrame} 帧将姿势记录为全身 IK 修正关键帧 — 动作保持不变`));
 		return true;
 	}
 

package/src/domains/objects.js

@@ -31,7 +31,7 @@ import {
 	tidyAngle,
 } from "../scene-objects.js";
 
-import { ko, isKo } from "../locale.js";
+import { ko } from "../locale.js";
 import {
 	sceneObjectNameDisplayKo,
 	attachWorldMatrix,
@@ -264,7 +264,7 @@ export function useObjects(appContext) {
 			return;
 		}
 		changeSceneObject(object.id, patch);
-		appContext.notify(isKo ? `${sceneObjectNameDisplayKo(object.name)}을 표면 위에 내려놓았어요` : `${object.name} dropped to surface`);
+		appContext.notify(ko(`${sceneObjectNameDisplayKo(object.name)} dropped to surface`, `${sceneObjectNameDisplayKo(object.name)}을 표면 위에 내려놓았어요`, `${sceneObjectNameDisplayKo(object.name)}已放到表面`));
 	}
 
 	// How much of the wall counts as the wall, and how wide the brush that
@@ -314,7 +314,7 @@ export function useObjects(appContext) {
 		// swallows the very next W/E/R. Renaming stays on F2/Return and the row's
 		// context menu. (docs/unity-reference.md §9.7)
 		setGizmoMode("move");
-		appContext.notify(isKo ? `${sceneObjectNameDisplayKo(object.name)} 추가됨 — W 이동, E 회전, R 크기` : `${object.name} added — W move, E rotate, R scale`);
+		appContext.notify(ko(`${sceneObjectNameDisplayKo(object.name)} added — W move, E rotate, R scale`, `${sceneObjectNameDisplayKo(object.name)} 추가됨 — W 이동, E 회전, R 크기`, `${sceneObjectNameDisplayKo(object.name)}已添加 — W 移动，E 旋转，R 缩放`));
 	}
 
 	/** "Sofa 2.png" reads as a set piece; "sofa-2.png" does not. The extension
@@ -345,11 +345,9 @@ export function useObjects(appContext) {
 				placement,
 			);
 			const imported = publishImported(object, commandContext);
-			appContext.notify(
-				isKo
-					? `${object.name} 추가됨 — 실제 높이(m)를 입력하면 크기가 맞습니다`
-					: `${object.name} added — type its real height in metres to set the scale`,
-			);
+			appContext.notify(ko(`${object.name} added — type its real height in metres to set the scale`,
+				`${object.name} 추가됨 — 실제 높이(m)를 입력하면 크기가 맞습니다`,
+				`${object.name} 已添加 — 输入实际高度（米）即可匹配尺寸`));
 			return imported;
 		} catch (error) {
 			throw new StudioProtocolError(error.code ?? "INVALID_ARGUMENT", `Could not import that image: ${error.message}`);
@@ -379,11 +377,9 @@ export function useObjects(appContext) {
 			placement,
 		);
 		const imported = publishImported(object, commandContext);
-		appContext.notify(
-			isKo
-				? `${object.name} 추가됨 — 실제 높이(m)를 입력하면 크기가 맞습니다`
-				: `${object.name} added — type its real height in metres to set the scale`,
-		);
+		appContext.notify(ko(`${object.name} added — type its real height in metres to set the scale`,
+			`${object.name} 추가됨 — 실제 높이(m)를 입력하면 크기가 맞습니다`,
+			`${object.name} 已添加 — 输入实际高度（米）即可匹配尺寸`));
 		return imported;
 	}
 
@@ -479,11 +475,9 @@ export function useObjects(appContext) {
 				placementInFrontOfShot(),
 			);
 			const imported = publishImported(object, commandContext);
-			appContext.notify(
-				isKo
-					? `${object.name} 추가됨 — 실제 높이(m)를 입력하면 크기가 맞습니다`
-					: `${object.name} added — type its real height in metres to set the scale`,
-			);
+			appContext.notify(ko(`${object.name} added — type its real height in metres to set the scale`,
+				`${object.name} 추가됨 — 실제 높이(m)를 입력하면 크기가 맞습니다`,
+				`${object.name} 已添加 — 输入实际高度（米）即可匹配尺寸`));
 			return imported;
 		} catch (error) {
 			throw new StudioProtocolError(error.code ?? "INVALID_ARGUMENT", `Could not import that model: ${error.message}`);
@@ -520,11 +514,9 @@ export function useObjects(appContext) {
 			placement,
 		);
 		const imported = publishImported(object, commandContext);
-		appContext.notify(
-			isKo
-				? `${object.name} 추가됨 — 실제 높이(m)를 입력하면 크기가 맞습니다`
-				: `${object.name} added — type its real height in metres to set the scale`,
-		);
+		appContext.notify(ko(`${object.name} added — type its real height in metres to set the scale`,
+			`${object.name} 추가됨 — 실제 높이(m)를 입력하면 크기가 맞습니다`,
+			`${object.name} 已添加 — 输入实际高度（米）即可匹配尺寸`));
 		return imported;
 	}
 
@@ -569,11 +561,9 @@ export function useObjects(appContext) {
 				aspect: cut.asset.width / cut.asset.height,
 				height: fullFrameHeight * cut.heightScale,
 			})));
-			appContext.notify(
-				isKo
-					? `${object.name} 배경 제거 — ${Math.round(cut.removed * 100)}% 지움. 원본과 칠한 영역은 그대로 남습니다`
-					: `${object.name} — ${Math.round(cut.removed * 100)}% removed. The original and your selection are kept`,
-			);
+			appContext.notify(ko(`${object.name} — ${Math.round(cut.removed * 100)}% removed. The original and your selection are kept`,
+				`${object.name} 배경 제거 — ${Math.round(cut.removed * 100)}% 지움. 원본과 칠한 영역은 그대로 남습니다`,
+				`${object.name} 背景已移除 — 清除 ${Math.round(cut.removed * 100)}%。原图和选区仍保留`));
 			return { objectId: object.id };
 		} catch (error) {
 			throw new StudioProtocolError(error.code ?? "TARGET_NOT_READY", `Could not remove the background: ${error.message}`);
@@ -606,7 +596,7 @@ export function useObjects(appContext) {
 		const placed = { ...object, id: copy.id, name: copy.name, x: object.x + 0.5 };
 		domain.write((objects) => [...objects, placed]);
 		appContext.shared.setSelectedHierarchyId(`object:${placed.id}`);
-		appContext.notify((isKo, ko) => isKo ? `${sceneObjectNameDisplayKo(placed.name)} 복제됨` : `${placed.name} duplicated`);
+		appContext.notify((isKo, ko) => ko(`${placed.name} duplicated`, `${sceneObjectNameDisplayKo(placed.name)} 복제됨`, `${sceneObjectNameDisplayKo(placed.name)}已复制`));
 	}
 
 	function frameSelection(id = selectedSceneObjectId) {
@@ -676,7 +666,7 @@ export function useObjects(appContext) {
 				? ko("Character 1", "인물 1")
 				: index === 1
 					? ko("Character 2", "인물 2")
-					: isKo ? `인물 ${index + 1}` : `Character ${index + 1}`;
+					: ko(`Character ${index + 1}`, `인물 ${index + 1}`, `角色 ${index + 1}`);
 		const bone = attach.bone
 			? HIERARCHY_INSPECTOR_TITLES[`rig.${attach.bone}`] ?? attach.bone
 			: ko("Root", "루트");

package/src/domains/scenes.js

@@ -30,9 +30,7 @@ import {
 	PROJECT_EXTENSION,
 	normalizeWorkflowGraph,
 	storeWorkflowGraph,
-	pickProjectFileForOpen,
 	readProjectFile,
-	openProjectFallback,
 	readProjectDocument,
 	requestHandlePermission,
 	createWorkflowGraph,
@@ -42,11 +40,12 @@ import {
 	buildAnimationProjectFromStoryboard,
 } from "../project.js";
 import { playgroundSceneUrl, fetchSceneProject } from "../playground.js";
+import { pickProjectToOpen } from "../project-open-file.js";
 import { openAssetDb, referencedAssetIds, getAsset, putAsset } from "../scene-assets.js";
 import { internWorkflowOutputs, workflowOutputRefs, resolveWorkflowOutputs } from "../workflow/workflow-resources.js";
 
 import { resourceManifest } from "../project-resources.js";
-import { isKo, ko } from "../locale.js";
+import { ko } from "../locale.js";
 import { track, bucketCount, bucketProjectAge, startExportAttempt } from "../analytics.js";
 import { mergeProjectCustomPoses } from "../project-poses.js";
 import { DEFAULT_WORKSPACE_LAYOUT, DEFAULT_DURATION_S, TIMELINE_FPS } from "../app-stage.jsx";
@@ -270,9 +269,9 @@ export function useScenes(appContext) {
 	function projectProblemsNotice(problems) {
 		if (!Array.isArray(problems) || !problems.length) return "";
 		const codes = [...new Set(problems.map((problem) => problem?.code).filter(Boolean))].join(", ");
-		return isKo
-			? ` · 포함된 자원 ${problems.length}개를 건너뛰었어요${codes ? ` (${codes})` : ""}`
-			: ` · skipped ${problems.length} embedded resource${problems.length === 1 ? "" : "s"}${codes ? ` (${codes})` : ""}`;
+		return ko(` · skipped ${problems.length} embedded resource${problems.length === 1 ? "" : "s"}${codes ? ` (${codes})` : ""}`,
+			` · 포함된 자원 ${problems.length}개를 건너뛰었어요${codes ? ` (${codes})` : ""}`,
+			` · 已跳过 ${problems.length} 个嵌入资源${codes ? `（${codes}）` : ""}`);
 	}
 
 	async function rehydrateProjectAssets(project, warnings = []) {
@@ -344,7 +343,7 @@ export function useScenes(appContext) {
 				object_count_bucket: bucketCount(appContext.shared.projectStateRef.current.sceneObjects?.length ?? 0),
 				shot_count_bucket: bucketCount(appContext.shared.shots.length),
 			});
-			appContext.notify((isKo, ko) => isKo ? `프로젝트 저장됨: ${name}${PROJECT_EXTENSION}` : `Project saved: ${name}${PROJECT_EXTENSION}`);
+			appContext.notify((isKo, ko) => ko(`Project saved: ${name}${PROJECT_EXTENSION}`, `프로젝트 저장됨: ${name}${PROJECT_EXTENSION}`, `项目已保存：${name}${PROJECT_EXTENSION}`));
 			return { saved: true, name, fileName: downloaded ? `${name}${PROJECT_EXTENSION}` : appContext.shared.projectHandleRef.current?.name ?? `${name}${PROJECT_EXTENSION}`, downloaded };
 		} catch (err) {
 			if (err?.name === "AbortError") {
@@ -444,18 +443,12 @@ export function useScenes(appContext) {
 	async function openProject(context = null) {
 		if (!context) return runProject("project.open");
 		try {
-			let file = null;
-			let handle = null;
-			if (hasFileSystemAccess()) {
-				handle = await pickProjectFileForOpen();
-				file = await readProjectFile(handle);
-			} else {
-				file = await openProjectFallback();
-			}
+			const { file, handle = null, blocked } = await pickProjectToOpen();
+			if (blocked) throw new StudioProtocolError("TARGET_NOT_READY", ko("This browser would not read that file. Open it once more.", "이 브라우저가 그 파일을 읽지 못했어요. 한 번 더 열어 주세요."));
 			if (!file) return false;
 			const result = readProjectDocument(file.text);
 			if (!result.ok) {
-				appContext.notify(isKo ? `프로젝트를 열 수 없어요: ${result.reason}` : `Cannot open project: ${result.reason}`);
+				appContext.notify(ko(`Cannot open project: ${result.reason}`, `프로젝트를 열 수 없어요: ${result.reason}`, `无法打开项目：${result.reason}`));
 				return false;
 			}
 			result.project.savedAt = result.project.savedAt ?? file.savedAt ?? null;
@@ -465,7 +458,7 @@ export function useScenes(appContext) {
 			context.check();
 			applyProject(result.project, true);
 			setProjectStartupOpen(false);
-			appContext.notify(`${isKo ? `프로젝트 열림: ${result.project.name}` : `Project opened: ${result.project.name}`}${projectProblemsNotice(result.problems)}`);
+			appContext.notify(`${ko(`Project opened: ${result.project.name}`, `프로젝트 열림: ${result.project.name}`, `项目已打开：${result.project.name}`)}${projectProblemsNotice(result.problems)}`);
 			return true;
 		} catch (err) {
 			if (err?.name === "AbortError") return false;
@@ -490,7 +483,7 @@ export function useScenes(appContext) {
 			const file = await readProjectFile(handle);
 			const result = readProjectDocument(file.text);
 			if (!result.ok) {
-				appContext.notify(isKo ? `프로젝트를 열 수 없어요: ${result.reason}` : `Cannot open project: ${result.reason}`);
+				appContext.notify(ko(`Cannot open project: ${result.reason}`, `프로젝트를 열 수 없어요: ${result.reason}`, `无法打开项目：${result.reason}`));
 				return false;
 			}
 			result.project.savedAt = result.project.savedAt ?? file.savedAt ?? null;
@@ -501,7 +494,7 @@ export function useScenes(appContext) {
 			applyProject(result.project, true);
 			setProjectBrowserOpen(false);
 			setProjectStartupOpen(false);
-			appContext.notify(`${isKo ? `프로젝트 열림: ${result.project.name}` : `Project opened: ${result.project.name}`}${projectProblemsNotice(result.problems)}`);
+			appContext.notify(`${ko(`Project opened: ${result.project.name}`, `프로젝트 열림: ${result.project.name}`, `项目已打开：${result.project.name}`)}${projectProblemsNotice(result.problems)}`);
 			return true;
 		} catch (err) {
 			if (err?.code) throw err;
@@ -543,7 +536,7 @@ export function useScenes(appContext) {
 		setProjectStartupOpen(false);
 		appContext.shared.setFirstSuccessGuideOpen(true);
 		domain.pendingCheckpoint = { clock: appContext.undoClock, name };
-		appContext.notify(ko(`New project: ${name}`, `새 프로젝트: ${name}`));
+		appContext.notify(ko(`New project: ${name}`, `새 프로젝트: ${name}`, `新项目：${name}`));
 		return true;
 	}
 
@@ -560,7 +553,7 @@ export function useScenes(appContext) {
 			await rehydrateProjectAssets(result.project, result.warnings);
 			context.check();
 			applyProject(result.project, true);
-			appContext.notify(`${isKo ? `프로젝트 복원됨: ${result.project.name}` : `Project restored: ${result.project.name}`}${projectProblemsNotice(result.problems)}`);
+			appContext.notify(`${ko(`Project restored: ${result.project.name}`, `프로젝트 복원됨: ${result.project.name}`, `项目已恢复：${result.project.name}`)}${projectProblemsNotice(result.problems)}`);
 			return true;
 		} catch (error) {
 			if (error?.code) throw error;

package/src/domains/shots.js

@@ -16,7 +16,7 @@ import { followFramingFromCamera, craneHeightAt, buildRail, simplifyStroke } fro
 import { defaultRailRange, clampRailRange } from '../camera-rail-schedule.js';
 import { timelineSpan, timelineContentExtent } from '../timeline-extent.js';
 import { trackFeature } from '../analytics.js';
-import { ko, isKo } from '../locale.js';
+import { ko } from '../locale.js';
 
 const same = (a, b) => JSON.stringify(a) === JSON.stringify(b);
 function normalizeState(value) {
@@ -367,9 +367,9 @@ export function useShots(appContext) {
       // In the landing playground a drawn rail opens the player
       // on the shot camera, but leave playback to the visitor.
       appContext.shared.enterPreview(); appContext.shared.setTlPlaying(false); setTlFrame(activeShot.startFrame);
-      appContext.notify(isKo ? '레일 완성 — 샷 카메라 시점으로 전환했습니다. ▶ 로 재생, Esc 로 복귀' : 'Rail drawn — you are looking through the shot camera. Press ▶ to ride it; Esc goes back to flying.'); return;
+      appContext.notify(ko('Rail drawn — you are looking through the shot camera. Press ▶ to ride it; Esc goes back to flying.', '레일 완성 — 샷 카메라 시점으로 전환했습니다. ▶ 로 재생, Esc 로 복귀', '轨道已完成 — 已切换到镜头摄影机视角。按 ▶ 播放，按 Esc 返回自由视角。')); return;
     }
-    appContext.notify(isKo ? `카메라 레일 완성 — ${curve ? curve.length.toFixed(1) : '?'} m, 제어점 ${simplified.length}개` : `Camera rail drawn — ${curve ? curve.length.toFixed(1) : '?'} m, ${simplified.length} control points`);
+    appContext.notify(ko(`Camera rail drawn — ${curve ? curve.length.toFixed(1) : '?'} m, ${simplified.length} control points`, `카메라 레일 완성 — ${curve ? curve.length.toFixed(1) : '?'} m, 제어점 ${simplified.length}개`, `摄影机轨道已完成 — ${curve ? curve.length.toFixed(1) : '?'} m，${simplified.length} 个控制点`));
   }
   function publishStudioShots(value) { return appContext.storeDomain('shot').publish(value); }
   function commitStudioShots(draft) { return appContext.storeDomain('shot').commitDraft(draft); }

package/src/first-success-guide.jsx

@@ -5,26 +5,34 @@ const ANIMATION_STEPS = [
 	{
 		en: "Select a character in the Outliner.",
 		ko: "아웃라이너에서 캐릭터를 선택하세요.",
+		zh: "在大纲视图中选择一个角色。",
 		hintEn: "Click Character 1 (or its row) to make it active.",
 		hintKo: "캐릭터 1(또는 캐릭터 행)을 클릭하면 활성화됩니다.",
+		hintZh: "点击角色 1（或其所在行）使其成为当前角色。",
 	},
 	{
 		en: "Move it in the Scene view.",
 		ko: "장면 보기에서 캐릭터를 움직이세요.",
+		zh: "在场景视图中移动它。",
 		hintEn: "Drag the character marker on the floor to place it.",
 		hintKo: "바닥의 캐릭터 마커를 드래그해 배치하세요.",
+		hintZh: "拖动地面上的角色标记来摆放位置。",
 	},
 	{
 		en: "Ask the Agent for a motion.",
 		ko: "에이전트에게 동작을 요청하세요.",
+		zh: "让智能体生成一个动作。",
 		hintEn: "Open it with Cmd/Ctrl+B and say what the character does; the take lands on the Body lane.",
 		hintKo: "Cmd/Ctrl+B로 열고 캐릭터가 할 동작을 말하면 테이크가 바디 레인에 올라갑니다.",
+		hintZh: "按 Cmd/Ctrl+B 打开，说出角色要做的动作；动作片段会落在身体轨道上。",
 	},
 	{
 		en: "Scrub the timeline or press Space to play.",
 		ko: "타임라인을 문지르거나 Space를 눌러 재생하세요.",
+		zh: "拖动时间线或按空格播放。",
 		hintEn: "Seeing the playhead move is your first visible result.",
 		hintKo: "재생 헤드가 움직이면 첫 결과를 확인한 것입니다.",
+		hintZh: "看到播放头移动，就是你的第一个可见结果。",
 	},
 ];
 
@@ -32,26 +40,34 @@ const STORYBOARD_STEPS = [
 	{
 		en: "Open the Agent panel (Cmd/Ctrl+B).",
 		ko: "에이전트 패널을 여세요 (Cmd/Ctrl+B).",
+		zh: "打开智能体面板（Cmd/Ctrl+B）。",
 		hintEn: "The Agent panel is where you describe each panel.",
 		hintKo: "에이전트 패널에서 각 패널을 설명합니다.",
+		hintZh: "在智能体面板中逐个描述每个面板。",
 	},
 	{
 		en: "Describe one scene in a sentence.",
 		ko: "장면 하나를 한 문장으로 설명하세요.",
+		zh: "用一句话描述一个场景。",
 		hintEn: "One sentence per turn is enough for one panel.",
 		hintKo: "패널 하나에는 한 문장이면 충분합니다.",
+		hintZh: "每个面板一轮只说一句话就够了。",
 	},
 	{
 		en: "Your panel appears on the Board.",
 		ko: "패널이 보드에 나타납니다.",
+		zh: "你的面板会出现在看板上。",
 		hintEn: "Open the Board tab to see the new panel card.",
 		hintKo: "보드 탭에서 새 패널 카드를 확인하세요.",
+		hintZh: "打开看板标签页查看新的面板卡片。",
 	},
 	{
 		en: "Stylize it, or export the panel pack.",
 		ko: "스타일을 입히거나 패널 팩으로 내보내세요.",
+		zh: "对它进行风格化，或导出面板包。",
 		hintEn: "Use Stylize on the card, or export the panel pack.",
 		hintKo: "카드에서 스타일을 입히거나 패널 팩으로 내보내세요.",
+		hintZh: "在卡片上使用风格化，或导出面板包。",
 	},
 ];
 
@@ -73,7 +89,7 @@ export default function FirstSuccessGuide({ open, onDismiss, previsMode = "anima
 			<div className="v2-first-success-guide-head first-success-guide-head">
 				<div>
 					<strong id="first-success-guide-title">{ko("Your first 60 seconds", "첫 60초")}</strong>
-					<span>{complete ? ko("Core loop complete", "핵심 흐름 완료") : ko(`Step ${step + 1} of ${STEPS.length}`, `${step + 1} / ${STEPS.length} 단계`)}</span>
+					<span>{complete ? ko("Core loop complete", "핵심 흐름 완료", "核心流程完成") : ko(`Step ${step + 1} of ${STEPS.length}`, `${step + 1} / ${STEPS.length} 단계`, `第 ${step + 1} / ${STEPS.length} 步`)}</span>
 				</div>
 				<button type="button" className="v2-first-success-guide-close first-success-guide-close" onClick={onDismiss} aria-label={ko("Dismiss guide", "가이드 닫기")}>×</button>
 			</div>
@@ -91,12 +107,12 @@ export default function FirstSuccessGuide({ open, onDismiss, previsMode = "anima
 						{STEPS.map((item, index) => (
 							<li key={item.en} className={index < step ? "done" : index === step ? "current" : ""}>
 								<span className="v2-first-success-guide-step-mark first-success-guide-step-mark">{index < step ? "✓" : index + 1}</span>
-								<div><strong>{ko(item.en, item.ko)}</strong>{index === step && <span>{ko(item.hintEn, item.hintKo)}</span>}</div>
+								<div><strong>{ko(item.en, item.ko, item.zh)}</strong>{index === step && <span>{ko(item.hintEn, item.hintKo, item.hintZh)}</span>}</div>
 							</li>
 						))}
 					</ol>
 					<button type="button" className="v2-first-success-guide-next first-success-guide-next btn primary" onClick={() => setStep((value) => value + 1)}>
-						{ko(step === STEPS.length - 1 ? "Mark complete" : "I did this", step === STEPS.length - 1 ? "완료로 표시" : "했어요")}
+						{ko(step === STEPS.length - 1 ? "Mark complete" : "I did this", step === STEPS.length - 1 ? "완료로 표시" : "했어요", step === STEPS.length - 1 ? "标记完成" : "我做了这一步")}
 					</button>
 				</>
 			)}

package/src/hierarchy-panel.jsx

@@ -1,6 +1,6 @@
 import { useEffect, useMemo, useRef, useState } from "react";
 import { createPortal } from "react-dom";
-import { ko, isKo } from "./locale.js";
+import { ko } from "./locale.js";
 import { buildHierarchyNodes } from "./hierarchy-model.js";
 import { sceneObjectIdFromHierarchy } from "./scene-objects.js";
 import { CatalogueEntries, displayObjectLabel } from "./object-catalog.jsx";
@@ -62,9 +62,8 @@ export const HIERARCHY_DRAG_MIME = "application/x-cclay-hierarchy";
 const carriesHierarchyRow = (event) => !!event.dataTransfer?.types?.includes?.(HIERARCHY_DRAG_MIME);
 
 function displaySceneName(name) {
-	if (!isKo) return name;
 	const generatedName = /^SCENE\s+(\d+)$/i.exec(name);
-	return generatedName ? ko(`Scene ${generatedName[1]}`, `장면 ${generatedName[1]}`) : name;
+	return generatedName ? ko(name, `장면 ${generatedName[1]}`, `场景 ${generatedName[1]}`) : name;
 }
 
 /**
@@ -112,7 +111,7 @@ function ScenePill({ scenes, activeSceneId, onSceneSelect, onSceneCreate, onRena
 function displayHierarchyLabel(node) {
 	if (node.kind === "object") return displayObjectLabel(node.label);
 	if (node.kind === "scene") return displaySceneName(node.label);
-	return isKo ? (HIERARCHY_LABELS_KO[node.label] ?? node.label) : node.label;
+	return HIERARCHY_LABELS_KO[node.label] ? ko(node.label, HIERARCHY_LABELS_KO[node.label]) : node.label;
 }
 
 const OUTLINER_TYPES = {
@@ -466,7 +465,7 @@ function TreeRow({
 				<button
 					type="button"
 					className="hierarchy-toggle"
-					aria-label={isKo ? `${label} ${expanded ? "접기" : "펼치기"}` : `${expanded ? "Collapse" : "Expand"} ${label}`}
+					aria-label={ko(`${expanded ? "Collapse" : "Expand"} ${label}`, `${label} ${expanded ? "접기" : "펼치기"}`, `${expanded ? "折叠" : "展开"} ${label}`)}
 					onClick={() => onToggle(node.id)}
 				>
 					{expanded ? "▾" : "▸"}
@@ -486,7 +485,7 @@ function TreeRow({
 						ref={inputRef}
 						className="hierarchy-rename-input"
 						defaultValue={node.label}
-						aria-label={isKo ? `${label} 이름 바꾸기` : `Rename ${label}`}
+						aria-label={ko(`Rename ${label}`, `${label} 이름 바꾸기`, `重命名 ${label}`)}
 						autoFocus
 						onFocus={(event) => event.currentTarget.select()}
 						onKeyDown={(event) => {
@@ -523,7 +522,7 @@ function TreeRow({
 					className="hierarchy-eye"
 					data-hidden={node.hidden ? "true" : undefined}
 					aria-pressed={node.hidden === true}
-					aria-label={node.hidden ? (isKo ? `${label} 표시` : `Show ${label}`) : (isKo ? `${label} 숨기기` : `Hide ${label}`)}
+					aria-label={node.hidden ? ko(`Show ${label}`, `${label} 표시`, `显示 ${label}`) : ko(`Hide ${label}`, `${label} 숨기기`, `隐藏 ${label}`)}
 					onClick={(event) => {
 						event.preventDefault();
 						event.stopPropagation();

package/src/locale-zh/app.js

@@ -0,0 +1,124 @@
+// Chinese UI copy for App-level toasts, export status, error boundary and first-run guide.
+export const ZH_APP = {
+	"Load a character to pose it — Pose mode edits its rig with IK": "加载角色后才能摆姿势 — 姿势模式用 IK 编辑其骨骼",
+	"That picture format is not supported — use PNG, JPG, WebP or GIF": "不支持该图片格式 — 请使用 PNG、JPG、WebP 或 GIF",
+	"A newer edit comes after this deletion. Use Undo history instead.": "此删除之后还有更新的编辑。请改用撤销历史。",
+	"Double-click the line to add a dot": "双击线条添加一个点",
+	"That image is no longer in storage": "该图片已不在存储中",
+	"This image's usage changed, so it was not deleted. Please review it again.": "该图片的使用情况已变化，因此未删除。请重新检查。",
+	"This image's scene references changed, so it was not deleted. Please review it again.": "该图片的场景引用已变化，因此未删除。请重新检查。",
+	"That image is used by a scene and was not deleted": "该图片正被场景使用，未删除",
+	"That image is now used by a scene and was not deleted": "该图片现在正被场景使用，未删除",
+	"The scene changed while deleting, so the image was kept. Please review storage again.": "删除期间场景发生变化，图片已保留。请重新检查存储。",
+	"The live editor is disconnected. Reconnect before sending.": "实时编辑器已断开。请重新连接后再发送。",
+	"MP4 encoding is unavailable. Use a current browser with H.264 WebCodecs support (such as Chrome or Edge), enable hardware acceleration, then retry.": "MP4 编码不可用。请使用支持 H.264 WebCodecs 的最新浏览器（如 Chrome 或 Edge），开启硬件加速后重试。",
+	"Video encoding failed. Retry the same request. If resources are tight, shorten the shot range or lower output resolution before starting a new export.": "视频编码失败。请重试相同请求。若资源紧张，请缩短镜头范围或降低输出分辨率后重新导出。",
+	"Frame rendering failed. Let the scene finish loading, then retry. If it repeats, shorten the range or reduce output resolution for a new export.": "帧渲染失败。请等场景加载完成后再试。若反复出现，请缩短范围或降低输出分辨率后重新导出。",
+	"Export cancelled. No further files will be handed off.": "导出已取消。不会再交付其他文件。",
+	"Export could not finish. Retry the same request. For memory or resource problems, close other heavy tabs or use a shorter range / lower output resolution in a new export.": "导出未能完成。请重试相同请求。若为内存或资源问题，请关闭其他占用较大的标签页，或在新的导出中使用更短的范围/更低的分辨率。",
+	"An export is already running": "已有导出正在进行",
+	"Export completed. Check your export folder or browser downloads; the OS save is not confirmed.": "导出已完成。请查看导出文件夹或浏览器下载；系统保存未确认。",
+	"Export pipeline completed. The requesting tool handles the file handoff.": "导出流程已完成。文件交付由发起请求的工具处理。",
+	"Cancelling at the current work boundary…": "正在当前工作边界处取消…",
+	"Preparing": "准备中",
+	"Encoding": "编码中",
+	"Finalizing": "收尾中",
+	"Completed": "已完成",
+	"Failed": "失败",
+	"Cancelled": "已取消",
+	"Depth range sampled": "已采样深度范围",
+	"Frames submitted to encoder": "已提交给编码器的帧",
+	"Finalizing MP4. Progress is indeterminate; this stage cannot be interrupted.": "正在完成 MP4。进度不确定；此阶段无法中断。",
+	"Finishing encoder output. Progress is indeterminate.": "正在完成编码器输出。进度不确定。",
+	"Handing off existing PNGs. The file handoff cannot be cancelled.": "正在交付现有 PNG。文件交付无法取消。",
+	"Building the ZIP. Cancel takes effect after the current work unit, before the file handoff.": "正在构建 ZIP。取消将在当前工作单元结束后、文件交付前生效。",
+	"Cancel stops at the next frame boundary, before the file handoff.": "取消将在下一个帧边界停止，届时尚未交付文件。",
+	"Preparing the renderer and checking MP4 support…": "正在准备渲染器并检查 MP4 支持…",
+	"Encoding the requested frames, not yet a completed file.": "正在编码所请求的帧，尚未生成完整文件。",
+	"Retry keeps the original shot, camera, range and settings; it does not change your edits.": "重试会沿用原镜头、摄影机、范围与设置，不会改变你的编辑。",
+	"Cancel export": "取消导出",
+	"Retry same export": "重试相同导出",
+	"Add at least one Shot before exporting OTIO": "导出 OTIO 前请至少添加一个镜头",
+	"The shot renderer is not ready": "镜头渲染器尚未就绪",
+	"Add at least one Shot before exporting a keyframe pack": "导出关键帧包前请至少添加一个镜头",
+	"Depth and normal passes exported": "深度和法线通道已导出",
+	"Add at least one Shot before exporting a storyboard": "导出故事板前请至少添加一个镜头",
+	"Composing the storyboard…": "正在编排故事板…",
+	"Add a panel first — storyboard exports describe panels": "请先添加面板 — 故事板导出需要面板",
+	"ROOT PATH": "根路径",
+	"Prompt copied to clipboard": "提示词已复制到剪贴板",
+	"Frame export finished. Check your export folder or browser downloads.": "帧导出完成。请查看导出文件夹或浏览器下载。",
+	"Redone": "已重做",
+	"Undone": "已撤销",
+	"Saving…": "保存中…",
+	"Save failed": "保存失败",
+	"Not saved": "未保存",
+	"Unsaved changes": "未保存的更改",
+	"Saved": "已保存",
+	"Sign in with ChatGPT in the Agent panel to generate a blueprint.": "请在智能体面板中登录 ChatGPT 以生成蓝图。",
+	"Sign in to the Agent (⌘B) to sculpt from an image.": "请登录智能体（⌘B）以从图像雕塑。",
+	"The live editor is disconnected — reconnect to sculpt.": "实时编辑器已断开 — 请重新连接后再雕塑。",
+	"No model is available — add a provider key in the Agent panel.": "没有可用模型 — 请在智能体面板中添加服务商密钥。",
+	"New sculpt": "新建雕塑",
+	"Add a reference image in the Sculpt panel and press Start — or select a sculpt and press 5.": "在雕塑面板中添加参考图并按开始 — 或选中雕塑并按 5。",
+	"The graphics context was lost — restoring the stage. If it stays black, reload the page; your work is autosaved.": "图形上下文已丢失 — 正在恢复舞台。若持续黑屏，请刷新页面；你的工作已自动保存。",
+	"Graphics restored.": "图形已恢复。",
+	"Dot added — drag it to bend the route": "已添加点 — 拖动它使路径弯曲",
+	"3D graphics (WebGL) is turned off in this browser": "此浏览器的 3D 图形（WebGL）已关闭",
+	"Quit the browser completely (Cmd+Q) and reopen it, or turn on \"Use graphics acceleration when available\" in its settings. chrome://gpu shows the WebGL status.": "请完全退出浏览器（Cmd+Q）后重新打开，或在设置中开启“尽可能使用图形加速”。chrome://gpu 可查看 WebGL 状态。",
+	"The 3D view lost its graphics context": "3D 视图丢失了图形上下文",
+	"Waiting for the browser to restore it. If this stays, reload the studio — scenes autosave.": "正在等待浏览器恢复。若持续如此，请刷新工作室 — 场景会自动保存。",
+	"Reload": "刷新",
+	"Click or ▸ to expand · drag to move": "点击或 ▸ 展开 · 拖动移动",
+	"Click or ▾ to fold · drag to move": "点击或 ▾ 折叠 · 拖动移动",
+	"Expand inset view": "展开小窗视图",
+	"Collapse inset view": "折叠小窗视图",
+	"Shot view": "镜头视图",
+	"Top-View": "顶视图",
+	"Resize inset view": "调整小窗大小",
+	"Shot": "镜头",
+	"Look through the shot camera": "通过镜头摄影机观察",
+	"Look through the shot camera — right-drag, WASD and orbit set the recording lens (Esc returns)": "通过镜头摄影机观察 — 右键拖动、WASD 和环绕设置录制镜头（Esc 返回）",
+	"Look through": "镜头视角",
+	"Return to the editor view (Esc)": "返回编辑器视图 (Esc)",
+	"Shot camera": "镜头摄影机",
+	"Esc · exit": "Esc · 退出",
+	"SUBJECT OUT OF FRAME": "角色不在画面内",
+	"A new version of CozyClay is ready.": "CozyClay 新版本已就绪。",
+	"Reload to update": "刷新以更新",
+	"Later": "稍后",
+	"Object deleted.": "物体已删除。",
+	"Undo object deletion": "撤销物体删除",
+	"Undo": "撤销",
+	"Project access was not granted.": "未获得项目访问权限。",
+	"Restore": "恢复",
+	"Dismiss": "关闭",
+	"Image deleted. This session can undo it.": "图片已删除。本次会话内可撤销。",
+	"This account cannot generate images.": "此账号无法生成图像。",
+	"Sign in with ChatGPT in the Agent panel first.": "请先在智能体面板中登录 ChatGPT。",
+	"unknown error": "未知错误",
+	"The image route did not return a PNG.": "图像接口未返回 PNG。",
+	"Draft": "草稿",
+	"The studio hit a render error": "工作室遇到渲染错误",
+	"Scenes autosave as you work, so reloading resumes from the last saved state.": "场景会随工作自动保存，刷新后会从上次保存的状态继续。",
+	"Reload the studio": "刷新工作室",
+	"Your first 60 seconds": "你的最初 60 秒",
+	"Core loop complete": "核心流程完成",
+	"Dismiss guide": "关闭指南",
+	"You made your first panel.": "你做出了第一个面板。",
+	"You made your first shot.": "你做出了第一个镜头。",
+	"Describe, review on the Board, then stylize or export. You can close this guide and keep adding panels.": "描述、在看板上检查，然后风格化或导出。你可以关闭本指南并继续添加面板。",
+	"Select, move, ask, and play are the core CozyClay loop. You can close this guide and keep blocking.": "选择、移动、提问和播放是 CozyClay 的核心流程。你可以关闭本指南并继续摆位。",
+	"Continue editing": "继续编辑",
+	"Follow these four actions to see a result quickly.": "跟随这四个步骤，快速看到结果。",
+	"Skip guide": "跳过指南",
+	"QA clean": "QA 通过",
+	"Settings": "设置",
+	"Language and analytics": "语言与统计",
+	"Medium": "中景",
+	"Wide": "广角",
+	"Close-Up": "特写",
+	"Low Angle": "低角度",
+	"High Angle": "高角度",
+	"Saved scenes were written by a newer CozyClay — they have been left untouched and this session will not save": "已保存的场景由更新版本的 CozyClay 创建 — 已保持原样，本次会话也不会保存",
+};