cozyclay 3.1.1 → 3.1.3

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>
 				)}
@@ -73,14 +73,14 @@ export default function ResultModal({ result, copied, recordedVideoName, onClose
 					</button>
 					{result.frame && (
 						<button type="button" className="btn" onClick={onDownload} disabled={downloadDisabled}>
-							{result.downloaded ? ko("Download requested", "다운로드 요청됨") : result.frameB ? ko("Download start and end frames", "시작·끝 프레임 다운로드") : ko("Download frame", "프레임 다운로드")}
+							{result.downloaded ? ko("Exported", "내보냄") : result.frameB ? ko("Export start and end frames", "시작·끝 프레임 내보내기") : ko("Export frame", "프레임 내보내기")}
 						</button>
 					)}
 				</div>
 
 				{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">
@@ -89,8 +89,8 @@ export default function ResultModal({ result, copied, recordedVideoName, onClose
 							<span>{copied ? ko("Copied. Paste it into your AI service's prompt box.", "복사됐어요. AI 서비스의 입력창에 붙여 넣으세요.") : ko("Press “Copy prompt” above, then paste it into your AI service.", "위의 ‘프롬프트 복사’를 누른 뒤 AI 서비스 입력창에 붙여 넣으세요.")}</span>
 						</li>
 						<li>
-							<strong>{ko("Download the frame", "프레임 다운로드")}</strong>
-							<span>{result.frameB ? ko("Press “Download start and end frames” to save both PNGs.", "‘시작·끝 프레임 다운로드’를 눌러 두 PNG를 저장하세요.") : hasFrame ? ko("Press “Download frame” to save the PNG.", "‘프레임 다운로드’를 눌러 PNG를 저장하세요.") : ko("This result has no frame to download.", "이 결과에는 내려받을 프레임이 없어요.")}</span>
+							<strong>{ko("Export the frame", "프레임 내보내기")}</strong>
+							<span>{result.frameB ? ko("Press “Export start and end frames” to save both PNGs.", "‘시작·끝 프레임 내보내기’를 눌러 두 PNG를 저장하세요.") : hasFrame ? ko("Press “Export frame” to save the PNG.", "‘프레임 내보내기’를 눌러 PNG를 저장하세요.") : ko("This result has no frame to export.", "이 결과에는 내보낼 프레임이 없어요.")}</span>
 						</li>
 						<li>
 							<strong>{ko("Attach the image to your AI", "AI에 이미지 첨부")}</strong>

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/ExportFolderPreference.jsx

@@ -0,0 +1,103 @@
+import { useEffect, useState } from "react";
+import { ko } from "../locale.js";
+import {
+	canChooseExportWorkspace,
+	chooseExportWorkspace,
+	clearExportWorkspace,
+	loadExportWorkspace,
+	requestExportWorkspacePermission,
+} from "../export-workspace.js";
+import { PreferenceRow } from "./preference-controls.jsx";
+
+const SUPPORTED_DESCRIPTION = ko(
+	"When set, exports are written here instead of your browser's Downloads folder.",
+	"설정하면 내보낸 파일이 브라우저 다운로드 폴더 대신 이 폴더에 저장됩니다.",
+);
+
+function statusCopy(permission) {
+	if (permission === "prompt") return ko("Folder access needs to be re-allowed.", "폴더 접근을 다시 허용해야 해요.");
+	if (permission === "denied") return ko("Folder access was denied. Choose another folder or use Downloads.", "폴더 접근이 거부되었어요. 다른 폴더를 선택하거나 다운로드를 사용하세요.");
+	return null;
+}
+
+export default function ExportFolderPreference() {
+	const supported = canChooseExportWorkspace();
+	const [workspace, setWorkspace] = useState(null);
+	const [busy, setBusy] = useState(false);
+	const [error, setError] = useState(null);
+
+	useEffect(() => {
+		let active = true;
+		loadExportWorkspace().then((value) => {
+			if (active) setWorkspace(value);
+		});
+		return () => { active = false; };
+	}, []);
+
+	const choose = async () => {
+		setBusy(true);
+		setError(null);
+		try {
+			const handle = await chooseExportWorkspace();
+			setWorkspace({ handle, permission: "granted" });
+		} catch (cause) {
+			if (cause?.name !== "AbortError") setError(ko("Could not choose the export folder.", "내보내기 폴더를 선택하지 못했어요."));
+		} finally {
+			setBusy(false);
+		}
+	};
+
+	const allow = async () => {
+		if (!workspace?.handle) return;
+		setBusy(true);
+		setError(null);
+		try {
+			const permission = await requestExportWorkspacePermission(workspace.handle);
+			setWorkspace({ ...workspace, permission });
+		} finally {
+			setBusy(false);
+		}
+	};
+
+	const clear = async () => {
+		setBusy(true);
+		setError(null);
+		try {
+			const cleared = await clearExportWorkspace();
+			if (cleared) setWorkspace(null);
+			else setError(ko("Could not clear the export folder.", "내보내기 폴더를 해제하지 못했어요."));
+		} finally {
+			setBusy(false);
+		}
+	};
+
+	const status = workspace ? statusCopy(workspace.permission) : null;
+	const folderName = workspace?.handle?.name ?? ko("Browser downloads", "브라우저 다운로드");
+	const description = supported ? SUPPORTED_DESCRIPTION : ko("This browser cannot choose an export folder; exports continue to Downloads.", "이 브라우저에서는 내보내기 폴더를 선택할 수 없어요. 내보내기는 다운로드 폴더로 이어집니다.");
+
+	return (
+		<PreferenceRow title={ko("Export folder", "내보내기 폴더")} description={description} testid="preferences-export-folder" full>
+			<div className="v2-preferences__export-folder">
+				<span className="v2-preferences__export-folder-name" data-testid="preferences-export-folder-name">{folderName}</span>
+				{status && <span className="v2-preferences__export-folder-status" role="status">{status}</span>}
+				{error && <span className="v2-preferences__export-folder-status" role="alert">{error}</span>}
+				<div className="v2-preferences__language-controls" role="group" aria-label={ko("Export folder actions", "내보내기 폴더 작업")}>
+					{workspace && workspace.permission !== "granted" && (
+						<button type="button" className="v2-preferences__language" data-testid="settings-export-folder-allow" disabled={busy} onClick={allow}>
+							{ko("Allow", "허용")}
+						</button>
+					)}
+					<button type="button" className="v2-preferences__language" data-testid="settings-export-folder-choose" disabled={!supported || busy} onClick={choose}>
+						{busy ? ko("Choosing…", "선택 중…") : ko("Choose folder…", "폴더 선택…")}
+					</button>
+					{workspace && (
+						<button type="button" className="v2-preferences__language" data-testid="settings-export-folder-clear" disabled={busy} onClick={clear}>
+							{ko("Use Downloads", "다운로드 사용")}
+						</button>
+					)}
+				</div>
+			</div>
+			<span className="v2-preferences__export-folder-note">{ko("Existing files are never overwritten; numbered names are used.", "같은 이름의 파일이 있으면 번호가 붙고 덮어쓰지 않아요.")}</span>
+		</PreferenceRow>
+	);
+}

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 (