AURORAVIEW / WEB 界面与 AGENT 契约

Web 界面,
原生创作工具。

用熟悉的前端技术和 AI 编程助手开发 DCC 工具,把好用的人机界面与显式注册的 Agent 能力连接起来。

概念插画:材质工具内嵌于 DCC 工作区,同时提供人机界面与显式 Agent 入口。这是目标体验,不是运行截图。
概念示意 · 不是运行截图。展示目标 DCC 体验,图中动作仅作概念说明。
熟悉的 Web 技术HTML、CSS、React、Vue 与编程助手
显式能力契约声明调用、事件、参数和结果
面向 DCC遵循宿主场景 API、UI 线程与生命周期

从熟悉的开发方式出发,
连接人、Agent 与创作软件。

AuroraView 将现代 Web 开发带入创作软件。从已有的前端技能出发,用编程 Agent 打磨界面,再把明确声明的工具能力连接到原生宿主。项目目标是完善 DCC 配套生态,让人与 Agent 围绕同一套工具能力协作。

概念插画:左侧是重复的界面碎片,右侧是通过独立原生适配桥连接不同宿主的共享 Web 界面。
概念示意,不是应用运行截图。
  1. 让 Agent 有明确入口

    为工具声明发现与调用契约,写清参数、结果、错误和宿主范围。DCC-MCP 注册的是已声明能力,界面不会自动变成 Agent 工具。

  2. 沿用熟悉的开发技能

    用 HTML、CSS、React 或 Vue 开发,再学习一套清楚的宿主调用与事件契约。可运行示例让开发者和编程 Agent 都有具体起点。

  3. 按工作流灵活扩展

    围绕界面组合浏览器式 API、扩展、插件和打包分发。每个目标的可用能力与原生集成都明确维护。

  4. 完善重点 DCC 生态

    把原生界面入口、宿主适配、Agent 契约、安装和示例配套起来。宿主矩阵分别记录场景回读、资源清理和实际验证,逐步扩展完整生态。

已有的基础能力,都能从源码查证。

主项目已有原生核心、Python 包、前端 SDK、CLI 和 Gallery 演示应用,也包含浏览器 API、扩展兼容层和打包工具。公开发布提供 wheel、命令行工具和 Gallery 构建产物。

当前源码结构,
共享契约与宿主边界。

人通过 Web 界面操作工具,Agent 通过显式配置的 DCC-MCP 适配器进入。两条入口都遵循声明的通信契约;原生宿主始终拥有自己的生命周期和场景 API。

  1. 人和 Web 界面

    HTML / CSS / React / Vue

    工具的显示,以及人直接操作的交互入口。

  2. 声明的通信入口

    TypeScript SDK / 可选的 DCC-MCP 注册

    页面调用与事件,以及显式配置的 Agent 工具和会话标识。

  3. AuroraView 核心与 API

    Rust · IPC · Python / PyO3 · WebView 后端

    共享通信、窗口集成和后端抽象。

  4. 可选的浏览器能力与扩展

    Browser APIs · extension host · plugins

    可选能力与场景语义、宿主生命周期分开维护。

  5. 原生宿主适配器

    Python + Qt / 引擎原生集成

    宿主 API、停靠、UI 线程调度、焦点和关闭流程。

同一个工具,服务于人,
也为 Agent 提供明确入口。

项目希望让工具既有好用的界面,也有主动声明的 Agent 调用入口。当前 DCC-MCP 集成提供了一组较小、可检查的基础契约。

人通过界面操作

按工作流设计控件和反馈。SDK 把页面连接到已经声明的宿主方法与事件。

auroraview.api.*
auroraview.on(...)

Agent 调用已注册能力

安装可选依赖 dcc-mcp-core,配置 AuroraViewAdapter,再启动服务。FileRegistry 注册让这个运行中的会话可以被发现。

AuroraViewAdapter(view)
start_server(adapter).start()

当前适配器提供的工具

eval_jsscreenshotload_urlload_html

当前会话上下文包含窗口标题、URL、PID、CDP 端口和检测到的宿主。具体场景工具与上下文需要额外的宿主或 Skill 注册,不会从界面自动推导。

这里描述源码已经实现的契约;它与某个具体宿主内的 Agent 交互验收分别记录。

查看 DCC-MCP 集成源码 ↗

计划 / 共享运行时

同一套宿主能力,
页面与 Agent 都能使用。

整合方向让 AuroraView 专注现代 Web 界面、渲染、前端事件和原生区域展示。薄集成层复用 DCC-MCP Core 已有的服务、工具与 Skill 注册、执行桥和生命周期。这个整合目前尚未交付。

  1. AuroraView

    WebView · HTML 与资源 · 前端桥接 · 原生停靠

    负责界面与渲染。浏览器能力、扩展与构建时打包继续保留自己的边界。

  2. 薄集成层 / 计划

    显式调用与事件 · 运行时附着 · 资源所有权

    将页面调用映射到已声明工具,并连接事件。页面与 Agent 应复用同一套宿主业务能力。

  3. DCC-MCP Core / 已有基础设施

    Server / MCP · 工具与 Skill · 执行桥 · 生命周期

    通过公共契约复用已有宿主服务和调度。这是 AuroraView 的整合方向,不代表新的 API 已经交付。

  4. 原生宿主适配器

    主线程调度 · 场景 API · 原生窗口 · 事件循环

    明确应用相关操作和宿主所有权。页面与 Agent 操作同一个宿主实例,并实际回读结果。

能力不止一个内嵌面板。

浏览器式 API

SDK 提供标签页、窗口、存储、运行时消息等浏览器相关接口。实际行为取决于后端和启用的功能。

packages/auroraview-sdk/src ↗
扩展与插件

独立 crate 管理扩展生命周期、manifest、消息和浏览器 API 兼容。兼容性应逐项检查,不能理解为任何 Chrome 扩展都可原样运行。

crates/auroraview-extensions ↗
打包与分发

打包层组织前端资源、Python 服务和原生应用启动。根据目标环境选择分发方式,并验证最终产物。

crates/auroraview-pack ↗

围绕实际宿主组织项目。

选择宿主,逐项查看原生界面、DCC-MCP 适配、声明能力、安装、场景回读、资源清理与实际验证。将这些配套在整个生态中完善,是项目持续推进的目标。

重点宿主集成

展开宿主,查看七项职责的实际记录。

Autodesk Maya限定范围已观察2026-10-09 部分验收凭据:f1231286 记录真实 UI/MCP/场景/Undo 及面板清理;434822e3 仅覆盖 CSS 定位;96c98546 有受控测试/源码 CI 证据,未运行新的 GUI 会话。持久 owner 重开、CSS 后的重命名提交、完整停靠、DPI 与剩余输入仍待验收。

AuroraView 宿主源码 ↗

AuroraView 原生界面 / 停靠
预览 / 验收中

Outliner 的 f1231286 部分 GUI 凭据记录了 Maya 2026 原生右侧停靠区中的 Vue 像素。浮动/重新停靠、窗口调整大小、原生关闭、DPI 与剩余输入矩阵仍待验收。

DCC-MCP 宿主适配器
目录收录

dcc-mcp-maya。已收录于注明日期的 DCC-MCP 快照;目录列出安装入口。这不代表 AuroraView 已支持该宿主。

源码 / 安装参考 ↗
共用能力 / Agent 契约
限定范围已观察

在 f1231286 上,Outliner UI 与真实 MCP 调用使用公开 facade 0.1.0 和 Core 0.20.41 共用显式场景工具,MCP 重命名事件显示在 Vue 中;后续生命周期候选仍需单独 GUI 验收。

可运行示例 / 安装
预览 / 验收中

已合并的 Outliner bc934e7e 消费公开共享预览包。Draft PR #53 的 49aa3ae8 说明 OutlinerRuntime:只挂接一次,面板更换时复用 owner,宿主最终卸载时再关闭。GUI 重开仍待验收。

源码 / 安装参考 ↗
场景回读
限定范围已观察

f1231286 GUI 会话验证了 UI/MCP 重命名、原生场景回读和前台 Undo。仅修改 CSS 的 434822e3 后续检查验证了行定位,未验收该版本的重命名提交。

资源清理与所有权
限定范围已观察

在 f1231286 上,面板关闭后旧 UI 调用失效,全部 10 个回调及 view 被移除,借用的 ToolSet/服务保持运行。持久 owner 的 GUI 重开仍待验收;Core 目录残留阻止最终关闭后用同名新 owner 替换。

实际验证
限定范围已观察

2026-10-09 部分验收凭据:f1231286 记录真实 UI/MCP/场景/Undo 及面板清理;434822e3 仅覆盖 CSS 定位;96c98546 有受控测试/源码 CI 证据,未运行新的 GUI 会话。持久 owner 重开、CSS 后的重命名提交、完整停靠、DPI 与剩余输入仍待验收。

源码 / 安装参考 ↗
Blender限定范围已观察2026-10-09:Windows Blender 5.1.1 / Python 3.13.9 上,两组夹具均为 36/36 通过,测试源码树与已合并版本 1401b6fe 一致。键盘、中文输入法、焦点、多窗口、前台正常 Stop 与用户验收仍待完成。

AuroraView 宿主源码 ↗

AuroraView 原生界面 / 停靠
预览 / 验收中

2026-10-09,Windows Blender 5.1.1 / Python 3.13.9 通过 36 项原生 HTML/GPU 生命周期检查;完整键盘、中文输入法、焦点与多窗口仍待验收。

DCC-MCP 宿主适配器
目录收录

dcc-mcp-blender。已收录于注明日期的 DCC-MCP 快照;目录列出安装入口。这不代表 AuroraView 已支持该宿主。

源码 / 安装参考 ↗
共用能力 / Agent 契约
限定范围已观察

公开的共享 Python 预览包在 Blender 5.1.1 上通过 36 项 ToolSession → SDK → bpy 检查;该结果覆盖记录中的契约路径,完整交互验收仍待完成。

可运行示例 / 安装
预览 / 验收中

PR #5 已合并至 1401b6fe,main CI 通过。注明版本的 native-web 指南提供安装步骤与限制;尚无公开的 Blender 发布包记录。

源码 / 安装参考 ↗
场景回读
限定范围已观察

Blender 5.1.1 的共享 ToolSession → SDK → bpy 夹具通过 36 项场景契约检查;更广的交互场景仍需单独回读验证。

资源清理与所有权
限定范围已观察

原生 HTML/GPU 生命周期夹具通过 36 项检查;前台正常 Stop、多窗口行为与用户验收仍待完成。

实际验证
限定范围已观察

2026-10-09:Windows Blender 5.1.1 / Python 3.13.9 上,两组夹具均为 36/36 通过,测试源码树与已合并版本 1401b6fe 一致。键盘、中文输入法、焦点、多窗口、前台正常 Stop 与用户验收仍待完成。

源码 / 安装参考 ↗
Unreal Engine预览 / 验收中2026-10-09 快照:7f962b43 通过 Editor 共享工具探针和 UE 5.7 Game Runtime CI。独立刷新候选 draft PR #8 a6d2e80 已通过源码 CI;这里尚未建立其原生刷新和交互验收证据。共享工具场景修改/Undo、停靠、像素显示与输入仍待验收。

AuroraView 宿主源码 ↗

AuroraView 原生界面 / 停靠
待验收

截至 2026-10-09,原生停靠、像素显示、输入与窗口生命周期仍待验收。main 版本 03815487 与尚未合并的 PR #7 候选分别跟踪。

DCC-MCP 宿主适配器
目录收录

dcc-mcp-unreal。已收录于注明日期的 DCC-MCP 快照;目录列出安装入口。这不代表 AuroraView 已支持该宿主。

源码 / 安装参考 ↗
共用能力 / Agent 契约
预览 / 验收中

PR #7 候选 7f962b43 通过真实 UE 5.7.4 Editor 的共享 ToolSet/SDK/Python/事件探针。反向调用成功,原样返回 false 和 0。凭据记录共享版本 0.1.0;公开 wheel 来源及 Core 使用尚未核实。

源码 / 安装参考 ↗
可运行示例 / 安装
预览 / 验收中

main 仍为 03815487。尚未合并的 PR #7 候选 7f962b43 通过 UE 5.7 原生构建、Cook/打包与 Game Runtime CI,离线演示保存在 CI 产物中。这与正式发行和 Editor 交互验收分别记录。

源码 / 安装参考 ↗
场景回读
待验收

已记录的 Editor 探针未修改场景。经共享工具完成场景修改、状态回读与 Undo 仍待验收。

资源清理与所有权
预览 / 验收中

PR #7 候选通过 Editor 客户端清理探针;原生窗口生命周期与重复关闭重开仍待验收。

实际验证
预览 / 验收中

2026-10-09 快照:7f962b43 通过 Editor 共享工具探针和 UE 5.7 Game Runtime CI。独立刷新候选 draft PR #8 a6d2e80 已通过源码 CI;这里尚未建立其原生刷新和交互验收证据。共享工具场景修改/Undo、停靠、像素显示与输入仍待验收。

源码 / 安装参考 ↗
Unity Editor限定范围已观察2026-10-09:公开预览 12210315 通过发布回读及真实 Editor MCP 场景/回读、Undo 和 Stop 检查。独立 Core 消费者源码为 ea25683a;Core HTTP/管道准备检查使用受控夹具。真实 Editor Core 与 GUI 为 not_run;浏览器往返、停靠、输入与 DPI 仍待验收。

AuroraView 宿主源码 ↗

AuroraView 原生界面 / 停靠
预览 / 验收中

Windows x64 EditorWindow / 子 HWND WebView2 源码已公开。原生 WebView smoke 通过;非 batch Editor GUI、停靠、输入与高 DPI 仍待验收。

DCC-MCP 宿主适配器
目录收录

dcc-mcp-unity。已收录于注明日期的 DCC-MCP 快照;目录列出安装入口。这不代表 AuroraView 已支持该宿主。

源码 / 安装参考 ↗
共用能力 / Agent 契约
限定范围已观察

公开预览通过真实 MCP stdio 初始化、三个注册工具及当前用户管道到 Editor 的调用。Draft PR #1 的 ea25683a 增加外部 Python Core 0.20.41 / 共享 wheel 0.1.0 消费者;真实 Editor Core 与 GUI 验收为 not_run。

源码 / 安装参考 ↗
可运行示例 / 安装
预览 / 验收中

源码 12210315 对应的公开 v0.1.0-preview.1 提供 Windows Editor 预览 ZIP。main/tag/release CI 与公开 ZIP/SHA 回读通过。

源码 / 安装参考 ↗
场景回读
限定范围已观察

Unity 2022.3 的 7 项 Editor 测试通过。真实 MCP 调用完成对象创建与选择、Editor 状态回读及 Undo 验证;浏览器到场景的回路仍待验收。

资源清理与所有权
限定范围已观察

原生 STA 关闭、当前用户管道权限、独占所有权及端点关闭重开检查通过;真实 MCP 运行验证了端点 Stop。交互式停靠与生命周期验收仍待完成。

实际验证
限定范围已观察

2026-10-09:公开预览 12210315 通过发布回读及真实 Editor MCP 场景/回读、Undo 和 Stop 检查。独立 Core 消费者源码为 ea25683a;Core HTTP/管道准备检查使用受控夹具。真实 Editor Core 与 GUI 为 not_run;浏览器往返、停靠、输入与 DPI 仍待验收。

源码 / 安装参考 ↗
SideFX Houdini已有源码已有适配器源码;本轮尚未评估真实宿主交互与资源清理。

AuroraView 宿主源码 ↗

AuroraView 原生界面 / 停靠
已有源码

已有 Houdini 宿主适配源码;原生界面与停靠需对应版本验收。

DCC-MCP 宿主适配器
目录收录

dcc-mcp-houdini。已收录于注明日期的 DCC-MCP 快照;目录列出安装入口。这不代表 AuroraView 已支持该宿主。

源码 / 安装参考 ↗
共用能力 / Agent 契约
生态建设目标

对应宿主的页面调用、事件与显式 Agent 工具仍需配套集成。

可运行示例 / 安装
已有源码

按适配器仓库查看安装和宿主前置要求;这里尚未记录可运行宿主结果。

场景回读
生态建设目标

这里尚未记录 AuroraView 的场景状态回读。

资源清理与所有权
生态建设目标

自有与借用资源的清理需要逐宿主验收。

实际验证
已有源码

已有适配器源码;本轮尚未评估真实宿主交互与资源清理。

Foundry Nuke已有源码已有适配器源码;本轮尚未评估场景回读与生命周期验收。

AuroraView 宿主源码 ↗

AuroraView 原生界面 / 停靠
已有源码

已有 Nuke 宿主适配与调度器源码;原生界面验收需对应具体版本。

DCC-MCP 宿主适配器
目录收录

dcc-mcp-nuke。已收录于注明日期的 DCC-MCP 快照;目录列出安装入口。这不代表 AuroraView 已支持该宿主。

源码 / 安装参考 ↗
共用能力 / Agent 契约
生态建设目标

对应宿主的页面调用、事件与显式 Agent 工具仍需配套集成。

可运行示例 / 安装
已有源码

按适配器仓库查看安装与调度要求;这里尚未验证当前真实宿主示例。

场景回读
生态建设目标

这里尚未记录 AuroraView 的场景状态回读。

资源清理与所有权
生态建设目标

自有与借用资源的清理需要逐宿主验收。

实际验证
已有源码

已有适配器源码;本轮尚未评估场景回读与生命周期验收。

共享基础与教学源码

围绕实际宿主组织项目。
项目职责当前证据
auroraview 核心、Python API、SDK、CLI 与 Gallery已有源码和公开发布产物
auroraview-maya-outliner 独立的 Maya 场景树教学项目教程更新已合并;场景检查通过;界面待验收

先在独立窗口中开发,
再把工具带进宿主。

先让前端在独立窗口中运行,再选择宿主适配器。把宿主操作放在明确的 API 后面,并在目标软件里验证完整生命周期。

1 / 安装 Python 包
pip install auroraview

使用目标宿主对应的 Python 环境。Windows 需要 WebView2 Runtime,Linux 需要 WebKitGTK 系统依赖。Qt 集成还需满足对应宿主要求。

查看安装与平台要求 ↗
2 / 加载本地前端
from auroraview import run_desktop

run_desktop(
    title="My pipeline tool",
    url="http://localhost:3000",
    width=1024,
    height=768,
)

从真实工具学习。

教学项目与宿主适配器分开维护。每个示例应写清前置环境、启动命令、预期行为和验证范围,方便以后增加其他宿主的教程。

Maya Outliner

独立维护的 Maya 场景树案例。刷新后的教程已合并,源码包与 Maya 2026 场景检查通过;交互式 WebView 仍待验收。

查看教学项目 ↗

正在开发宿主集成?

让共享协议保持简洁。把宿主生命周期和打包放在适配器里,并提供可运行示例和明确的验证记录。

在 GitHub 参与开发 ↗