启用后，Quicker Bridge 会在 Blender 内启动本地 HTTP 服务，让 Quicker 等本机可信工具可以发送 Python 指令来控制 Blender，并支持通过快捷键直接运行剪贴板里的 Python 代码。插件也可以返回当前 Blender 上下文，方便外部工具根据场景执行不同动作。
默认地址：
http://127.0.0.1:18765
默认锁定为本机地址。锁定时只监听 127.0.0.1:18765，端口不可用时不会自动切换到其他端口。
- 通过 HTTP 在 Blender 主线程执行 Python。
- 通过快捷键运行剪贴板里的 Python 代码。
- 返回当前 Blender 上下文状态，方便 Quicker 做动作分发。
- 支持物体、编辑模式、灯光类型、大纲视图、节点编辑器、UV、偏好设置等主要场景识别。
| 接口 | 作用 |
|---|---|
GET /context |
返回当前上下文，例如 {"status":"OBJECT_MESH"}。 |
GET /health |
检查本机服务是否存活，正常返回 {"ok":true}。 |
POST /run |
同步执行 Python，等待 Blender 执行完成后返回结果。 |
GET /debug/context |
调试上下文识别，包含鼠标、窗口、area、错误摘要。 |
POST 可以直接发送 Python 文本，也可以发送 JSON：
{
"code": "import bpy\nbpy.ops.object.select_all(action='SELECT')",
"timeout": 5.0,
"task_name": "select_all"
}可选请求头：
X-Mouse: 1234,567规则：
- 有
X-Mouse：使用外部传入的屏幕坐标。 - 没有
X-Mouse：使用插件在 Blender 内缓存的最近鼠标位置。 - 坐标缺失：返回
MISSING_COORD。
status 使用大写标签，_ 用来分隔匹配层级。
| 场景 | 返回示例 |
|---|---|
| 物体模式_未选 | OBJECT_NONE |
| 物体模式_单个网格 | OBJECT_MESH |
| 物体模式_多个物体 | OBJECT_MULTI |
| 物体模式_点光 | OBJECT_LIGHT_POINT |
| 物体模式_太阳光 | OBJECT_LIGHT_SUN |
| 物体模式_相机 | OBJECT_CAMERA |
| 物体模式_正交视图 | OBJECT_ORTHO |
| 编辑模式_点 | EDIT_VERT |
| 编辑模式_边 | EDIT_EDGE |
| 编辑模式_面 | EDIT_FACE |
| 编辑模式_未选 | EDIT_VERT_NONE |
| 雕刻模式 | SCULPT |
| 顶点绘制 | PAINT_VERTEX |
| 权重绘制 | PAINT_WEIGHT |
| 纹理绘制 | PAINT_TEXTURE |
| 大纲视图_视图层 | OUTLINER_VIEWLAYER_NONE |
| 大纲视图_场景 | OUTLINER_SCENES_NONE |
| 大纲视图_Blender 文件 | OUTLINER_LIBRARIES_NONE |
| 大纲视图_数据 API | OUTLINER_DATAAPI_NONE |
| 大纲视图_孤立数据 | OUTLINER_ORPHANDATA_NONE |
| 节点_着色器_物体 | NODE_SHADERNODETREE_OBJECT |
| 节点_着色器_世界 | NODE_SHADERNODETREE_WORLD |
| 节点_几何节点 | NODE_GEOMETRYNODETREE |
| 节点_合成节点 | NODE_COMPOSITORNODETREE |
| UV_点 | IMAGEEDITOR_UV_VERTEX |
| UV_边 | IMAGEEDITOR_UV_EDGE |
| UV_面 | IMAGEEDITOR_UV_FACE |
| 图像编辑器 | IMAGEEDITOR |
| 文件浏览器 | FILEBROWSER |
| 资源浏览器 | ASSETS |
| 偏好设置 | PREFERENCES |
| 顶部栏 | TOPBAR |
| 状态栏 | STATUSBAR |
| 无可靠坐标 | MISSING_COORD |
实际返回会根据选择数量、活动对象类型、视图状态继续追加标签，例如 OBJECT_MULTI_MESH_ORTHO。
POST /run 会在 Blender 内执行 Python，只建议本机可信自动化使用。默认锁定本机地址，不建议在不可信网络中监听局域网或公网地址。