Skip to content
ruibaojian edited this page Jul 16, 2026 · 1 revision

StarBridge

Windows-first、local-first 的本地创意软件接入层:Codex Skill + StarBridge MCP + Adobe UXP / Node Proxy。

StarBridge 面向 Codex、Cursor、Claude Code 等 AI coding agents,提供可审计、默认安全的本地创意软件工作流。项目不绕过授权,不上传私有资产,也不把未验证的桌面控制能力描述成生产级能力。

项目简介

StarBridge 将任务路由、结构化 MCP 工具和桌面软件通道组合起来,连接 ComfyUI、Photoshop、Illustrator、CAD / AutoCAD、Blender 与 CapCut / 剪映等本地工具。

当前主推方向是四模式图片转矢量:智能矢量、轻量矢量、精确重建和匠心矢量。所有模式都输出经过验证的无位图 SVG;普通图片转矢量不会自动调用 Illustrator Image Trace。

四种矢量模式

模式 适用场景 核心能力
匠心矢量 艺术稿、品牌图形、人工设计感交付 少锚点、贝塞尔曲线、中心线描边、交叉点续接、几何意图分级、质量门控和安全回退
智能矢量 普通插画、海报和设计再编辑 颜色与轮廓平衡、透明度分级、区域清理和节点简化
轻量矢量 Logo、图标、纹样和流畅编辑 减少颜色、碎片和节点,控制文件大小
精确重建 技术验证和像素网格存档 按原始 RGBA 像素重建矩形复合路径,并执行像素一致性验证

匠心矢量 Iteration 5 已增加 flow-contour、ornament、detail、micro-detail 四类几何意图、稳定 intent 选择器、矢量采样预览、紧凑编辑索引和四级质量回退。该分类只使用曲线长度、闭合性和转折密度等几何特征,不声称识别人脸、文字或具体题材。

MCP 与软件桥

  • MCP stdio:tools、resources、prompts、状态探针、safe roots、operation context、EvidenceManifest 与 JobStatus。
  • ComfyUI:工作流校验、队列快照、进度监控、任务快照和工作流生命周期摘要。
  • Photoshop:session / state / preview、sandbox demo、recipe 计划和受控 UXP 执行协议。
  • Illustrator:脱敏 preflight、精确 SVG 路线、可选的 SVG 到 AI 桌面交付,以及兼容性矢量协议。
  • CAD / AutoCAD:CAD plan、DXF validate、dry-run 和受控 sandbox 写入。
  • Blender、CapCut / 剪映:环境探针、公开结构计划和只读摘要。

安全边界

  • 默认只读或 dry-run;真实写入必须显式确认。
  • 写入限制在安全 sandbox / output 目录,输出会进行路径脱敏。
  • 不递归扫描私有目录,不读取未明确传入的 PSD、AI、DWG、BLEND、剪映草稿或客户素材。
  • 不保存或上传 token、Cookie、OAuth 缓存、账号状态、模型文件、源图和生成结果。
  • 桌面软件需要本机已安装、已授权,并以本地运行证据为准。

快速开始

环境要求:Windows 优先,Python 3.10+;运行 UXP、本地代理或前端示例时需要 Node.js。

python -m pip install --upgrade pip
pip install -e ".[dev]"

安全检查:

python examples\bridge_status.py --json --redact-paths --soft-exit
python -m starbridge_mcp.server tools --json --safe-only
python scripts\security_check.py
python -m unittest discover -s tests

运行匠心矢量:

python -m starbridge_mcp.vectorization.cli --input "<input.png>" --mode artisan --reference-id "artisan-sample" --compact

当前状态

  • stable:MCP 核心能力、ComfyUI 状态与工作流校验、AutoCAD / DXF headless 能力。
  • primary:四模式图片转 SVG,匠心矢量 Iteration 5 为高级主推路线。
  • experimental:Photoshop / Illustrator 桌面协议、受控写入和兼容性矢量协议。
  • prototype:Blender 与 CapCut / 剪映公开探针和结构计划。
  • planned:事务式 AI 发布、修复闭环、Adobe 桌面端到端验收、Blender 确认渲染和 CapCut 草稿骨架。

相关文档

最后更新:2026-07-16

Clone this wiki locally