加入3D视图

This commit is contained in:
2026-11-11 10:36:54 +08:00
parent 3c13bc38b3
commit 9090d04e08
4 changed files with 161 additions and 1 deletions
+3 -1
View File
@@ -1,6 +1,7 @@
import { useEffect, useRef, useState } from 'react';
import { createPortal } from 'react-dom';
import './codex-pcb.css';
import { DeliveryModel3D } from './DeliveryModel3D.js';
import { Markdown as RichMarkdown } from '@ziroeda/ai/markdown.js';
type Artifact = { name: string; kind: string; label: string; bytes: number; sha256: string };
@@ -56,6 +57,7 @@ export function CodexPcbDock(): JSX.Element {
const cancel = () => action(async () => { setTask(await api<Session>(`/sessions/${active}/cancel`, {})); });
const resume = () => action(async () => { setTask(await api<Session>(`/sessions/${active}/resume`, {})); setTab('activity'); });
const downloadable = (f: Artifact) => `${BASE}/sessions/${active}/files/${encodeURIComponent(f.name)}`;
const step = task?.delivery?.files.find(f => f.kind === 'step' && /\.(step|stp)$/i.test(f.name));
const canReview = task && !task.approval && !task.busy && ['review','needs_input','failed'].includes(task.state);
const interesting = entries.filter(e => ['message','activity','eda.started','eda.error','session.reconnecting','session.failed','production.blocked','delivery.completed','proposal.approved','session.resumed'].includes(e.type));
const view = <div className="cp-root" data-native-text-shortcuts="true">
@@ -69,7 +71,7 @@ export function CodexPcbDock(): JSX.Element {
{task.error && <div className="cp-error">{task.error}</div>}
{tab === 'plan' && <div className="cp-plan"><details><summary>原始需求</summary><p>{task.request}</p></details>{task.proposal ? <Markdown value={task.proposal.markdown}/> : <p className="cp-muted">AI 正在研究需求和制定方案,可以在运行记录中查看进度。</p>}{task.approval && <div className="cp-approved">已确认方案 v{task.approval.revision},设计按此方案执行。</div>}{canReview && <div className="cp-review"><label htmlFor="cp-comment">对方案有修改意见?</label><textarea id="cp-comment" value={comment} onChange={e => setComment(e.target.value)} placeholder="补充要求或指出需要修改的地方…" rows={3}/><div className="cp-actions"><button disabled={busy || comment.trim().length < 5} onClick={send}>提交意见,修改方案</button><button className="cp-primary" disabled={busy || task.state !== 'review' || !!comment.trim()} onClick={approve}>同意此方案,开始运行</button></div>{comment.trim() && <small>请先提交修改意见,待新方案生成后再确认。</small>}</div>}</div>}
{tab === 'activity' && <div className="cp-activity" ref={activity}>{interesting.map(e => <article key={e.seq} className={e.type === 'message' ? `cp-message ${text(e.data.role)}` : 'cp-event'}><time>{new Date(e.at * 1000).toLocaleTimeString()}</time>{e.type === 'message' ? <Markdown value={text(e.data.text)}/> : <><strong>{e.type === 'eda.started' ? '嘉立创 EDA · ' + text(e.data.label) : e.type === 'activity' ? ({ commandExecution: '执行脚本', webSearch: '查阅资料', dynamicToolCall: '调用工具', fileChange: '编辑文件' }[text(e.data.kind)] || text(e.data.kind)) : ({ 'eda.error':'EDA 返回错误,AI 可继续处理', 'session.reconnecting':'正在恢复会话', 'session.failed':'会话失败', 'production.blocked':'遇到阻碍', 'delivery.completed':'交付校验通过', 'proposal.approved':'方案已确认,开始设计', 'session.resumed':'已继续原会话' }[e.type] || e.type)}</strong>{text(e.data.message) && <p>{text(e.data.message)}</p>}{text(e.data.command) && <details><summary>查看执行命令</summary><pre>{text(e.data.command)}</pre></details>}</>}</article>)}{task.busy && <p className="cp-muted">● AI 正在继续处理,请稍候…</p>}<details className="cp-session-info"><summary>会话信息</summary><code>{task.thread_id || '正在创建'}</code><p>模型:GPT-6.1 Sol · 方案与生产共用此会话</p></details></div>}
{tab === 'files' && <div className="cp-files">{!task.delivery ? <p className="cp-muted">完成设计和原生检查后,交付文件会显示在这里。</p> : <><p>{task.delivery.notes}</p>{task.delivery.files.filter(f => ['render','layout','schematic'].includes(f.kind) && /\.(png|jpe?g|svg)$/i.test(f.name)).map(f => <figure key={f.name}><img src={downloadable(f)} alt={f.label}/><figcaption>{f.label}</figcaption></figure>)}{task.delivery.files.map(f => <a className="cp-file" key={f.name} href={downloadable(f)} download><div><strong>{f.label}</strong><small>{f.name} · {(f.bytes / 1024).toFixed(1)} KB</small></div><span>下载 ↓</span></a>)}</>}</div>}
{tab === 'files' && <div className="cp-files">{!task.delivery ? <p className="cp-muted">完成设计和原生检查后,交付文件会显示在这里。</p> : <>{step && <DeliveryModel3D key={`${active}/${step.name}/${step.sha256}`} url={downloadable(step)} sha256={step.sha256} name={step.name}/>}<p>{task.delivery.notes}</p>{task.delivery.files.filter(f => ['render','layout','schematic'].includes(f.kind) && /\.(png|jpe?g|svg)$/i.test(f.name)).map(f => <figure key={f.name}><img src={downloadable(f)} alt={f.label}/><figcaption>{f.label}</figcaption></figure>)}{task.delivery.files.map(f => <a className="cp-file" key={f.name} href={downloadable(f)} download><div><strong>{f.label}</strong><small>{f.name} · {(f.bytes / 1024).toFixed(1)} KB</small></div><span>下载 ↓</span></a>)}</>}</div>}
</>}
</main></div>
</section>}
@@ -0,0 +1,70 @@
// SPDX-License-Identifier: GPL-3.0-or-later
import { useEffect, useRef, useState } from 'react';
/** Preview the delivered STEP itself; the download remains the original artifact. */
export function DeliveryModel3D({ url, sha256, name }: { url: string; sha256: string; name: string }) {
const host = useRef<HTMLDivElement>(null);
const reset = useRef<(() => void) | null>(null);
const [retry, setRetry] = useState(0);
const [status, setStatus] = useState('正在加载 PCB 三维模型…');
const [failed, setFailed] = useState(false);
// biome-ignore lint/correctness/useExhaustiveDependencies: retry explicitly restarts the failed download and preview.
useEffect(() => {
const element = host.current;
if (!element) return;
const controller = new AbortController();
let dispose: (() => void) | undefined;
setStatus('正在加载 PCB 三维模型…');
setFailed(false);
void (async () => {
try {
const response = await fetch(url, { signal: controller.signal, credentials: 'same-origin' });
if (!response.ok) throw new Error('模型文件读取失败,请重试或下载 STEP 文件查看。');
const limit = 128 * 1024 * 1024;
if (Number(response.headers.get('content-length')) > limit) throw new Error('模型较大,请下载 STEP 文件查看。');
const bytes = new Uint8Array(await response.arrayBuffer());
if (bytes.byteLength > limit) throw new Error('模型较大,请下载 STEP 文件查看。');
const hash = Array.from(new Uint8Array(await crypto.subtle.digest('SHA-256', bytes)))
.map(value => value.toString(16).padStart(2, '0')).join('');
if (hash !== sha256) throw new Error('模型文件校验失败,请重新加载。');
if (controller.signal.aborted) return;
setStatus('正在解析装配模型,首次打开可能需要一些时间…');
const { mountDeliveryStep } = await import('./delivery-step-viewer.js');
if (controller.signal.aborted) return;
const viewer = await mountDeliveryStep(element, bytes, controller.signal);
if (!viewer) return;
if (controller.signal.aborted) { viewer.dispose(); return; }
dispose = viewer.dispose;
reset.current = viewer.reset;
setStatus('');
} catch (error) {
if (!controller.signal.aborted) {
dispose?.();
setFailed(true);
setStatus(error instanceof Error ? error.message : '三维模型加载失败,请重试。');
}
}
})();
return () => {
controller.abort();
dispose?.();
reset.current = null;
};
}, [url, sha256, retry]);
return <section className="cp-model" aria-label="PCB 交互式三维模型">
<div className="cp-model-header">
<div><h3>PCB 3D 模型</h3><p>左键拖拽旋转 · 滚轮缩放 · 右键拖拽平移</p></div>
<button disabled={!!status} onClick={() => reset.current?.()}>复位视角</button>
</div>
<div className="cp-model-stage" aria-busy={!!status && !failed}>
<div ref={host} className="cp-model-canvas" aria-label="可旋转和缩放的 PCB 模型" />
{status && <div className="cp-model-message">
<p role="status">{status}</p>
{failed && <button onClick={() => setRetry(value => value + 1)}>重新加载模型</button>}
</div>}
</div>
<div className="cp-model-footer"><span>{name}</span><a href={url} download>下载 STEP 模型 ↓</a></div>
</section>;
}
File diff suppressed because one or more lines are too long
@@ -0,0 +1,86 @@
// SPDX-License-Identifier: GPL-3.0-or-later
import * as THREE from 'three';
import { OrbitControls } from 'three/addons/controls/OrbitControls.js';
import { loadCadModel } from '@ziroeda/3d-viewer/loadmodel.js';
import '../editors/pcb/viewer3d_cache_shim.js';
export async function mountDeliveryStep(host: HTMLElement, bytes: Uint8Array, signal: AbortSignal) {
// Reuse the existing worker-backed STEP parser and content-addressed model cache.
const model = await loadCadModel(bytes, 'step');
if (!model) throw new Error('无法解析这个 STEP 模型,请下载原文件查看。');
let renderer: THREE.WebGLRenderer | undefined;
let controls: OrbitControls | undefined;
let observer: ResizeObserver | undefined;
const dispose = () => {
observer?.disconnect();
controls?.dispose();
const geometries = new Set<THREE.BufferGeometry>();
const materials = new Set<THREE.Material>();
model.traverse(object => {
if (object instanceof THREE.Mesh) {
geometries.add(object.geometry);
for (const material of Array.isArray(object.material) ? object.material : [object.material]) materials.add(material);
}
});
geometries.forEach(geometry => geometry.dispose());
materials.forEach(material => material.dispose());
renderer?.dispose();
renderer?.forceContextLoss();
renderer?.domElement.remove();
};
if (signal.aborted) { dispose(); return null; }
try {
const box = new THREE.Box3().setFromObject(model);
const radius = box.getBoundingSphere(new THREE.Sphere()).radius;
if (!Number.isFinite(radius) || radius <= 0) throw new Error('模型没有可显示的三维几何。');
model.position.sub(box.getCenter(new THREE.Vector3()));
const scene = new THREE.Scene();
const background = getComputedStyle(host).backgroundColor;
scene.background = new THREE.Color(background);
scene.add(model);
scene.add(new THREE.HemisphereLight(0xffffff, 0x72859a, 2));
const key = new THREE.DirectionalLight(0xffffff, 2.5);
key.position.set(radius, -radius, radius * 2);
scene.add(key);
const fill = new THREE.DirectionalLight(0xffffff, 1.5);
fill.position.set(-radius, radius, -radius);
scene.add(fill);
renderer = new THREE.WebGLRenderer({ antialias: true });
renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
renderer.outputColorSpace = THREE.SRGBColorSpace;
host.appendChild(renderer.domElement);
const camera = new THREE.PerspectiveCamera(38, 1, radius / 1000, radius * 200);
camera.up.set(0, 0, 1);
controls = new OrbitControls(camera, renderer.domElement);
controls.mouseButtons = { LEFT: THREE.MOUSE.ROTATE, MIDDLE: THREE.MOUSE.DOLLY, RIGHT: THREE.MOUSE.PAN };
controls.screenSpacePanning = true;
controls.minDistance = radius * 0.05;
controls.maxDistance = radius * 40;
const render = () => renderer!.render(scene, camera);
const resize = () => {
const width = Math.max(1, host.clientWidth), height = Math.max(1, host.clientHeight);
renderer!.setSize(width, height);
camera.aspect = width / height;
camera.updateProjectionMatrix();
render();
};
const reset = () => {
const halfFov = THREE.MathUtils.degToRad(camera.fov / 2);
const limitingFov = Math.min(halfFov, Math.atan(Math.tan(halfFov) * camera.aspect));
const distance = radius / Math.sin(limitingFov) * 1.15;
camera.position.copy(new THREE.Vector3(0.7, -1, 1.25).normalize().multiplyScalar(distance));
controls!.target.set(0, 0, 0);
controls!.update();
render();
};
controls.addEventListener('change', render);
observer = new ResizeObserver(resize);
observer.observe(host);
resize();
reset();
return { reset, dispose };
} catch (error) {
dispose();
throw error;
}
}