Troubleshooting

PowerShell 找不到 npm

如果出现脚本执行策略或 npm.ps1 被拦截，改用：

npm.cmd test
npm.cmd run preflight

Photoshop、Illustrator、AutoCAD、Blender 或 CapCut 不在本机安装、未授权或未启动时，先运行对应 probe。预期结果是 unavailable、warning 或 soft-exit；这不代表 MCP 核心失败，也不应通过读取私有目录来“补齐”状态。

ComfyUI 默认使用本机 loopback 地址：

$env:STARBRIDGE_COMFYUI_URL="http://127.0.0.1:8188"

确认本地服务已启动后，再运行 system probe、workflow validate 或 queue snapshot。离线验证时使用 workflow validate，不要把网络连接错误解释为任务已提交。

矢量化结果默认写入：

examples/output/vectorization/<reference-id>/<mode>/

这些目录被 Git 忽略，便于保存本地预览和报告而不上传客户资产。请在本机输出目录查看 vector.svg、preview.png 和报告文件。

使用 --redact-paths 或 safe-only 入口，检查报告是否只包含脱敏路径、hash 和仓库相对引用。不要把原始绝对路径、token、Cookie、PSD / AI / DWG 文件名写入 issue、PR 或 Wiki。

精确重建在像素数、矩形路径数或 SVG verifier 上限超出时会停止并返回结果。先缩小输入或调整公开参数；它不会自动退回 Illustrator Image Trace，也不会绕过安全上限。

先确认选择的模式符合目标：Logo / 图标优先轻量，普通插画优先智能，要求像素一致性时使用精确，需要人工设计感时使用匠心。匠心路线应优先使用稳定的 intent 选择器和 edit_ref，不要重新上传原图或把完整结构塞回对话。

返回 Home。