用途:当需要编译 Articraft 记录、浏览生成对象、检查关节结构、启动查看器,或开发 viewer/api、viewer/web 代码时使用本技能。
主要能力:编译单条记录;启动已构建的查看器;以开发模式同时运行 API 与 Vite 前端;仅启动 API;执行前端开发、类型检查、lint 与构建;对资产做可视化质量检查。
使用方式:编译单条记录运行 uv run articraft compile <record_id>。启动已构建查看器运行 just viewer;开发模式运行 just viewer-dev;仅 API 运行 uv run uvicorn viewer.api.app:app --reload --host 127.0.0.1 --port 8765。前端命令包括 npm --prefix viewer/web run dev、typecheck、lint、build。
可视化检查要点:确认所有主要部件可见且相连;关节能带动预期部件;无明显意外重叠或悬浮几何体;链接名称与控制项语义清晰;材质与颜色符合对象提示;分叉记录保留历史/谱系。
限制:若查看器或前端代码有改动,应运行 npm --prefix viewer/web run typecheck 与 npm --prefix viewer/web run lint;若 API 行为有改动,应运行 uv run --group dev pytest -q tests/viewer。其他安装、平台与收费信息暂未提供。