Skip to content

Architecture

Jump to bottom
ruibaojian edited this page Jul 16, 2026 · 1 revision

Architecture

StarBridge 将“任务路由”“结构化工具调用”“本地软件通道”和“证据回传”分层，默认先走只读探针或 dry-run。

flowchart LR
  A["Codex / AI client"] --> B["Codex Skill"]
  B --> C["StarBridge MCP stdio"]
  C --> D["Tools / Resources / Prompts"]
  D --> E["Safety layer"]
  E --> F["ComfyUI / CAD / Blender probes"]
  E --> G["Node Proxy / Adobe UXP"]
  G --> H["Photoshop / Illustrator"]
  D --> I["EvidenceManifest / JobStatus"]
Loading

分层职责

Codex Skill

Skill 负责识别任务类型、选择正确工作流、提示所需前置条件，并安排验证顺序。Skill 不保存客户素材，也不应把未验证的桌面能力描述成生产级能力。

StarBridge MCP

MCP 通过 stdio 暴露结构化的 tools、resources 和 prompts。它统一返回状态、探针、dry-run、证据摘要和任务状态，便于 Codex、Cursor、Claude Code 等客户端调用。

核心公共能力包括：

  • 工具注册与 safe_only 过滤。
  • 状态探针、路径脱敏和安全根目录。
  • operation context、EvidenceManifest 和 JobStatus。
  • ComfyUI 工作流、队列、进度和任务快照。
  • CAD / DXF plan 校验与 dry-run。

Safety layer

安全层负责默认只读、dry-run、显式确认、输出目录限制、路径脱敏和软退出。探针失败或本机缺少软件时，优先返回结构化不可用状态，而不是猜测成功。

Node Proxy / Adobe UXP

Node Proxy 与 Adobe UXP 只在需要桌面插件通道时进入流程。它们使用 typed handler、受控参数和明确的操作信封，不作为任意脚本执行器。

专业软件

Photoshop、Illustrator、AutoCAD、Blender、ComfyUI 和 CapCut / 剪映仍然是本地生产软件。仓库中的接口、协议和 probe 不能替代本机授权，也不自动证明真实桌面写入已经完成。

典型调用链

  1. Skill 判断任务与能力边界。
  2. MCP 读取工具注册表并执行 safe probe。
  3. 需要时生成 plan、preview 或 dry-run。
  4. 用户明确确认后，才进入受控本地写入。
  5. 返回脱敏的证据摘要、输出引用和最终状态。

相关文档：Skill / MCP / UXP 定位、操作上下文。

返回 Home。

Clone this wiki locally