@mokuyoaxis/dsh-iris 0.2.7 → 0.3.0-alpha.1

package/docs/WEB_PROTOTYPE.md

@@ -1,11 +1,13 @@
 # 独立工作台 Demo（面向 0.3.0，未发布）
 
-这是面向 **0.3.0** 的交互预览，用来展示“选图与填写要求 → 查看状态 → 比较 → 选择与下载”的操作方向。**当前 Demo 保留作为参考，界面、文案和交互细节将在 0.3.0 阶段统一润色，尚未定稿。**
+这是面向 **0.3.0** 的交互预览，包含创作、作品和连接草稿三个页面。首轮布局已围绕大图预览、紧凑参数面板和默认折叠的详情整理，仍用于验证操作方向，尚未定稿。
 
-Demo 可在源码树中独立预览，无需 DSH；使用内存演示与内置样图，不连接模型、不计费，也不写入 Core 数据。真实生成目前使用现有 DSH 工作台或 CLI；npm 0.2.7 不携带源码树的 prototypes/ 和预览脚本。
+Demo 可在源码树中独立预览，无需 DSH；使用内存演示与内置样图，不连接模型、不计费，也不写入 Core 数据。0.3 alpha源码的真实工作台已接入固定图片编辑及[独立文生图](IMAGE_GENERATION.md)；npm 0.2.7 不含该页面，也不携带 prototypes/ 和预览脚本。
 
 ## 启动预览
 
+源码另有 [真实 Core 工作台](LOCAL_WEB.md)，已采用此 Demo 的布局方向，接入明确改图、选择、下载、恢复及真实连接管理，权限由独立开关控制，默认只读。本页仅描述独立 Demo；演示数据和连接草稿不会转为真实记录，不能以演示检查替代真实服务验收。
+
 在 Git 源码树中，使用现有 Node.js ≥22，无须安装新依赖：
 
 ```bash
@@ -18,24 +20,35 @@ node scripts/preview-workbench.mjs
 
 ## 可体验的流程
 
+桌面左侧为导航和最近流程，中间为图片画布，右侧为输入面板；手机上导航保留在顶部，输入和画布纵向排列。
+
 1. 使用内置鸢尾花样图，或选择/拖放本地 PNG、JPEG、WebP；本地文件只生成标签页内的 Blob 预览，不上传。
 2. 选择演示模型、填写修改要求，点击“开始演示”。本次输入随后固定；修改输入需明确新建流程。
 3. 查看原图与示例结果，切换并排/叠图，明确选择原图或结果，再下载。
 4. 展开“运行详情与演示场景”，体验原任务进行中、受理未知、生成成功但交付中断、等待本地比较等状态。场景对新流程生效。
+5. 到“作品”页按全部、已选择或待选择筛选本标签页产生的流程；点击卡片或最近流程可只读切回原记录。首次打开为空，不预填虚构作品。
+
+提示词快捷按钮只填写要求，放大按钮只预览原图；均不会开始生成。“演示说明”介绍样图与记录的保留范围。
 
 **示例结果始终是内置样图，不是对上传图片或提示词的真实修改**。原图和示例结果可能相同；原型不伪造像素差异、模型质量分数、计费价格或进度百分比。下载原图取本地原字节，下载结果取内置样图；“已选择”和“下载请求已交给浏览器”分别显示，不声称文件已保存。
 
-状态名称和白名单 DTO 依据真实 [固定流程](IMAGE_FLOW.md)；投影有实际 Core/受控 Provider 测试。演示传输不读写磁盘 Run，不保证服务重启恢复。新建后可从详情中的流程列表只读切回本标签页旧记录；整页刷新清空演示状态，并且不会自动开始。未将文件、提示词或主题写入 localStorage。
+状态名称和白名单 DTO 依据真实 [固定流程](IMAGE_FLOW.md)；投影有实际 Core/受控 Provider 测试。演示传输不读写磁盘 Run，不保证服务重启恢复。新建后也可从详情中的流程列表只读切回本标签页旧记录；整页刷新清空演示状态，并且不会自动开始。文件、提示词、草稿与主题均不写入 localStorage 或 sessionStorage。
 
 “停止本次等待”只中止当前演示操作，原任务事实保留；真实 API 的远端取消须有独立能力与确认，不能把停止等待写成取消成功。展开详情、重新读取状态、切换历史与比较方式均不驱动生成。
 
+## 连接草稿
+
+“连接”页可自由填写名称，选择图片功能及读取、创建、执行、停止权限，并展开查看相应工具名称。草稿沿用当前 Core 图片流程的工具分组；其他媒体功能灰显，等待逐步接入。关闭图片功能后，只保留连接自检和连接清单工具。
+
+“保存演示草稿”只保存到本标签页内存，重复保存更新同一草稿。此页不连接客户端、不创建真实授权，不生成密钥、MCP 配置或 Skill 安装；整页刷新后草稿清空。需要真实配置时使用 [Core 连接中心](CORE_CONNECTIONS.md)。
+
 ## 实现和下一步
 
-原型位于 `prototypes/workbench/`，使用原生 HTML/CSS/JavaScript，复用现有图标和示例图片，没有新框架或生产依赖。运行详情默认折叠，关闭显示“展开”、打开显示“收起”；提供浅/深色、键盘焦点与 320/390px 布局。
+原型位于 `prototypes/workbench/`，使用原生 HTML/CSS/JavaScript，复用 Iris 图标和示例图片，没有新框架或生产依赖。运行详情和工具预览默认折叠，关闭显示“展开”、打开显示“收起”；提供浅/深色、键盘焦点与 320/390px 布局。
 
-0.2.7 已有 [默认只读 API](LOCAL_API.md)及显式开启的 [本地上传/Run 创建](LOCAL_CREATION.md)，带持久请求意图和身份接回；当前 Demo 保持原样，尚未连接它们。后续补执行/取消、Operation 与恢复边界，再在 0.3.0 阶段结合实际接口统一完善页面。Demo 的当前布局、提示词和样例效果仅用于说明方向，不代表最终界面或模型能力。
+0.2.7 已有 [默认只读 API](LOCAL_API.md)及显式开启的 [本地上传/Run 创建](LOCAL_CREATION.md)，带持久请求意图和身份接回；0.3 alpha源码另有 [Operation 与有限执行服务](CORE_SERVICE.md)、[版本约束选择](LOCAL_SELECTION.md)及真实创作页面。此 Demo 仍独立使用内存样例，其布局、提示词和样例效果用于说明方向，不代表模型能力；真实页面的恢复、故障与发布门禁继续独立验收。
 
-[本地 API 契约](LOCAL_API_CONTRACT.md)区分已实现的只读/本地创建切片与待实现的执行、选择和取消。相同 Run 的 Task 复用与 HTTP 创建幂等分别验证；执行接口安全和中断测试通过后，再替换演示传输并完成无 DSH 的实际端到端验收。
+[本地 API 契约](LOCAL_API_CONTRACT.md)区分已发布的只读/本地创建，以及未发布的有限执行、本地停止和 owner 持久选择。相同 Run 的 Task 复用、HTTP 创建幂等与选择的版本门禁分别验证；替换演示传输时仍须单独验证浏览器写入、原身份恢复与无 DSH 的完整流程。
 
 源码树可运行下面的检查；浏览器检查需显式提供已经安装的 Chromium，不下载或安装浏览器。无沙箱仅在受控测试环境确有需要时显式追加 `--no-sandbox`，不改变生产浏览器策略。
 
@@ -45,3 +58,5 @@ node scripts/verify-workbench-prototype.mjs --browser-executable /absolute/path/
 ```
 
 浏览器检查保存交互结果与桌面/手机截图；这是隔离 Chromium 验收，不是 Android 真机触控或日常 DSH 装载证明。
+
+布局参考了 [Invoke 的画布分区](https://v7.invoke.ai/users-guide/canvas/canvas-guide/)、[ComfyUI 的导航与工作区域](https://support.comfy.org/articles/7675456845-the-comfyui-interface)和 [Linear 的界面层级整理](https://linear.app/now/behind-the-latest-design-refresh)，保留 Iris 自有标识、配色与素材。

package/docs/WEB_RECOVERY.md

@@ -0,0 +1,46 @@
+# 工作台请求核对与刷新恢复（0.3 alpha）
+
+本页描述源码中的 W1b 恢复及 W1c 页面接入。npm 0.2.7 不含这些新增接口与浏览器客户端；[真实工作台](LOCAL_WEB.md)已接入明确创作、选择和本地停止，“操作核对”默认折叠，自动恢复始终只读。
+
+## 按原请求读取
+
+owner 的 `GET /api/v0/session` 提供 `rootId`：使用现有创建请求区的稳定 UUID，服务重启、Token 轮换不改变它；没有请求区时为 `null`，读取不会初始化数据。`instanceId` 继续表示本次服务。连接客户端不获得此字段或新查询权限，MCP 工具和 scope 保持。
+
+有现成请求区时，owner 的 `operations` 包含 `creation.lookup`，默认只读服务也可调用：
+
+```text
+GET /api/v0/creation-requests?kind=image-import&key=<original-lowercase-UUIDv4>
+GET /api/v0/creation-requests?kind=flow-create&key=<original-lowercase-UUIDv4>
+
+{contractVersion:0, kind, state:"prepared"|"succeeded", result}
+```
+
+创建类型另包括 `generation-create`；新 v3 音频工作区增加 `audio-import`、`speech-create`、`transcription-create`，返回同样的有限身份，不返回音频或朗读正文。音频恢复与大小边界见[音频流程](AUDIO_FLOWS.md)。
+
+`result` 为 `{artifactId}`、`{runId}` 或 `null`。查询会核对原意图与已有结果；prepared 尚无目标时返回 null，已有目标核验通过后才返回引用。它不补写完成回执、不重建目标、不观察 Task 或调用 Provider。已推进或选择的 Run 不退回初始状态。没有原请求为 404；原结果不可用或证据损坏为 409，并保留原记录。
+
+查询仍要求 Bearer、可信 Host/Origin，不接受其他 kind、路径或重复参数。不返回原始 Key、Prompt、供应商绑定或磁盘记录。Key 是动作身份，不能替代认证。
+
+## 浏览器动作协调
+
+内部客户端提供命名的上传、创建、继续、停止与选择方法，没有任意媒体 POST/Command 执行入口。上传、创建、continue 各自使用一个 Key；同一活动动作的重复调用共享同一次请求，输入不同则明确繁忙。请求失败不自动重试。
+
+结果未知时先读取原 Key/Operation/Run。显式重试保留原 Key；上传需重新提供原图片或音频字节，创建需原输入。服务器继续核对输入摘要，不用新 Key 绕过冲突。查到创建成功只恢复已有 Run，不自动首次执行；读 Operation 也不调用 continue。
+
+选择没有持久 Key：回包丢失后读取 Run，展示“当前选择”，不声称能证明这次请求完成。陈旧 revision 不能覆盖新选择。停止复用原 Operation ID，只停止本地等待，不代表远端取消或退款。
+
+读取总并发仍为二；轻量 JSON 优先于排队中的媒体，不能抢占已开始的读取。写请求和停止直接发送，不进入图片读取队列。会话断开会取消客户端等待，服务已接收的事实仍保留。
+
+## 标签页恢复表
+
+使用 `sessionStorage` 的单个 `iris.workbench.recovery.v0` 键，最多八条待核对动作。只存 origin、稳定 rootId、动作类型与标识、原 Key、已知 Artifact/Run/Operation ID 和预期 revision；不存 Token、Prompt、图片或供应商配置，不使用 localStorage。
+
+上传/创建确认后移除记录；活动 Operation 保留到读到终态。prepared、404、冲突、网络错误或当前服务未开放查询时，保留待核对身份，不自动生成。表满先核对或明确处理已有动作，不悄悄丢弃未知请求。存储不可用时退为内存并提示刷新恢复受限；损坏表保留，暂停新动作，不把损坏当空表。
+
+刷新后先使用标签页保存的登录重新验证，再核对 session/rootId 和原请求，全程 GET；Token 失效时清除并要求重新连接，见 [会话边界](LOCAL_WEB.md#会话与图片边界)。登录缓存与本页的操作恢复表分开，恢复表仍不含 Token。换到不同 origin/根时只丢弃旧浏览器标识，Core 数据保持；迟到响应不能写回新根的表。无请求区时只有内存记录，不能承诺刷新定位未知上传/创建。
+
+面板支持只读的“重新核对”和“查看流程”。prepared/未找到的上传、创建或继续可明确“准备按原 Key 接回”，重新提供原图片/模型/要求/参数后再次确认；接回创建不会自动首次执行。损坏或无法继续处理的本地标识，可在说明影响并二次确认后清除；只移除浏览器核对标识，不删 Core、不停止原任务。关闭标签页后不保证保留 sessionStorage；恢复表也不是作品或请求记录的备份。
+
+## 验证
+
+`tests/local-creation-lookup.mjs`、`tests/web-recovery.mjs`、`tests/web-media-api.mjs`覆盖只读查询、原 Key、回包丢失、重启、换根、版本冲突、存储异常及有限动作。真实 Chromium 验证可在[工作台验证命令](LOCAL_WEB.md#验证与下一阶段)后增加 `--recovery`：使用独立根和受控 Provider，由测试明确提交本地写入，再检查生产页面只读恢复。它不进行真实付费生成，也不替代 Android 真机验收。

package/docs/WORKBENCH_LOGIN.md

@@ -0,0 +1,63 @@
+# 工作台访问口令（0.3 alpha）
+
+普通 `web serve` 使用一个访问口令，不要求账号、邮箱或读取 Token 文件。**稳定 npm 0.2.7 没有 `web serve`；下文针对0.3.0-alpha.1。** 源码树可把 `dsh-iris` 替换为 `node bin/dsh-iris.js`。
+
+## 首次设置与日常使用
+
+使用已有的专用 Flow 根；不要转换已有业务数据：
+
+```bash
+dsh-iris web serve --data-root /absolute/iris/core --port 3182
+```
+
+首次打开输出的 `loginUrl`，在网页中设置 8–128 个字符的访问口令。没有 10 分钟倒计时；设置成功后该设置入口失效。设置尚未完成时，服务重启会生成新的设置入口。初次链接允许设置访问口令，应私下保管。
+
+之后收藏普通地址，例如 `http://127.0.0.1:3182`。默认勾选“记住此设备”30天，刷新、新标签页和服务正常重启后继续使用；不勾选时仅当前标签页保存，服务端会话最长12小时。保持相同数据根、认证目录和端口。浏览器清除站点数据、隐私模式或禁止存储时，可能需要重新输入口令；页面会说明存储限制。
+
+默认 Panel 在首屏绘制前读取已保存的明暗主题；恢复登录期间显示同色的简洁过渡页，验证成功直接进入工作区，不先展示登录卡片。没有可用登录或验证失败时再显示表单与说明；入口资源加载失败提供重新加载。背景图继续在浏览器内异步读取，不上传到 Core。
+
+“退出”经服务确认后撤销当前浏览器会话并清除本机保存的登录。退出后在同一地址输入原口令即可，无需找文件或向 Agent 取新链接。若退出请求尚未确认，页面保留状态并提示重试。已经接收的业务操作不因退出而取消。
+
+## 忘记地址或口令
+
+只需记住启动时的 Core 数据根，不需要查找凭据文件。在另一个本机终端执行：
+
+```bash
+dsh-iris web login --data-root /absolute/iris/core
+dsh-iris web password reset --data-root /absolute/iris/core
+```
+
+`web login` 在已设置时返回普通登录地址；尚未设置时返回当前设置入口，不绕过已设置口令。`web password reset` 撤销全部工作台会话并返回新的设置入口；服务运行时无需重启，不修改作品、任务、供应商配置或 MCP 连接密钥/授权。服务正常停止后也可重置，下一次启动再打开输出的设置入口。不要把口令写在命令参数或聊天里。
+
+认证目录默认是 `$IRIS_HOME/web-auth/<物理数据根的SHA-256>`，`IRIS_HOME` 默认 `~/.iris`。用户不需要打开该目录。可在启动、取地址及重置命令中一致指定 `--auth-store /absolute/private-auth`。它必须与 Core 根相互独立，使用私有真实目录，POSIX目录0700、文件0600；Android共享存储通常不适合保存此目录。
+
+认证状态有独立写者租约。异常强杀后先核对原进程，再对 `<认证目录>/ownership` 使用现有 `doctor` 和明确的 `runtime recover` 流程；不会自动清锁或抢占实例。Core 执行根与连接目录的租约仍按各自契约处理。损坏、未知版本或属于其他根的认证状态明确报错，不自动覆盖。
+
+## 凭据边界
+
+口令只在同源登录请求中发送，服务端使用内置异步 scrypt、独立随机盐保存派生值，不保存明文。每次登录生成独立浏览器凭据，服务端只保存摘要和期限，最多32个有效会话。口令错误受有限速控制。
+
+“记住此设备”将浏览器凭据保存在当前 origin 的 localStorage，普通模式使用 sessionStorage；不保存口令、owner 控制令牌或 MCP 密钥。继续使用 Bearer 而非共享本机端口的 Cookie，保留精确 Host/Origin、无 CORS 和现有 CSP。可信同源插件仍有页面脚本权限，只加载经过审查的模块；这不是不可信代码沙箱。
+
+owner 控制记录仅在私有认证目录供本机 CLI 使用，浏览器会话和 MCP 连接均不能调用口令重置接口。MCP 使用连接中心导出的独立授权，浏览器登录不代替 MCP 配置。服务仍只绑定 `127.0.0.1`，没有新增公网监听、远程账户、SSO 或自动服务管理。
+
+## 旧 Token 模式
+
+显式提供 `--token-file` 或 `--token-dir` 时，`web serve` 保留旧的一次性链接和备用 Token 登录，服务重启后需新链接；与 `--auth-store` 互斥。`api serve` 继续要求 Token 参数，不默认开放口令登录。旧模式仍可使用 `web login --origin <实际地址> --token-file <本次文件>`。新默认方式不迁移或删除这些旧文件。
+
+## 接口与装配
+
+以下路径均位于 `/api/v0/workbench` 下，不接受查询参数；POST仅接受最多1024字节的 JSON。所有入口保留 Host/Origin 检查，不开放 CORS。
+
+| 路径 | 方法与输入 | 身份与输出 |
+|---|---|---|
+| `/auth` | GET/HEAD，无正文 | 有限公开状态：`contractVersion:0, mode:'password', configured, authId, rememberDays, minPasswordLength, maxPasswordLength`；不返回私有路径或哈希 |
+| `/setup` | POST `{ticket,password,remember}` | 严格同源，验证首次设置票据；返回独立会话 |
+| `/password-login` | POST `{password,remember}` | 严格同源，验证访问口令；返回独立会话 |
+| `/logout` | POST `{}` | 严格同源及当前浏览器 Bearer，幂等撤销；返回 `signedOut:true` |
+| `/setup-link` | POST `{}` | 仅本机 owner 控制令牌；尚未设置时返回 `setupUrl` |
+| `/password-reset` | POST `{}` | 仅本机 owner 控制令牌；重置后返回 `setupUrl` |
+
+会话响应为 `{contractVersion:0, authId, accessToken, expiresAt, remember}`；`accessToken` 是浏览器会话，不能用于 MCP 或口令重置。未知字段、跨源请求、错误口令、过期会话或版本冲突明确返回对应错误，不自动降级到其他认证方式。正常退出只撤销提供的会话；已撤销会话可重复退出，便于丢失响应后重试。
+
+Node 宿主用公开 `createCorePluginWorkbench` 时，显式传入 `workbenchAuth: { directory: '/absolute/private-auth' }` 才启用口令模式；未传时保持旧 SDK 行为。生命周期、媒体写权限和插件选择见[工作台](LOCAL_WEB.md)与[稳定启动](PLUGIN_STARTUP.md)。

package/docs/releases/0.3.0-alpha.1.md

@@ -0,0 +1,51 @@
+# Iris 0.3.0-alpha.1: a shared media workspace for Agents
+
+This first 0.3 alpha adds an independent Core workbench, generic MCP access and explicitly selected plugin contributions to the existing DSH plugin and standalone CLI. Core owns execution, storage and recovery; users choose what each client can access.
+
+The package remains `@mokuyoaxis/dsh-iris`, with Node.js 22.0.0 or later required. Install the exact prerelease or follow npm `alpha`; stable `latest` remains 0.2.7. Existing DSH host-version declarations are unchanged. New Core and plugin contracts are experimental and may change before stable 0.3.
+
+```bash
+npm install @mokuyoaxis/dsh-iris@0.3.0-alpha.1
+npx dsh-iris --help
+```
+
+Follow the [Core quickstart](https://github.com/mokuyoaxis/dsh-iris/blob/v0.3.0-alpha.1/docs/CORE_QUICKSTART.md) for a new workspace and the [Agent guide](https://github.com/mokuyoaxis/dsh-iris/blob/v0.3.0-alpha.1/docs/AGENT_CORE_QUICKSTART.md) for setup instructions. Both have English text with Chinese headings. The detailed product guides are primarily in Chinese.
+
+## An independent workbench
+
+- A real creation UI, works library, client connections and model services share the same Core records. The default Panel supports light/dark themes, local backgrounds and mobile layouts. Distributed screenshots use built-in themes, without a personal background.
+- Local password login and remembered devices survive normal restarts. Logout permits signing back in with the same password; it does not require a mobile browser to read a private Termux token file.
+- Model services expose providers, per-function automatic/manual/disabled pools and a health spectrum. Providers support connection checks, opt-in service-lifetime keepalive, disable/restore and protected deletion. Configuration or connectivity is separate from a successful media test.
+
+## Durable media and ComfyUI
+
+- Image generation/editing and speech/transcription persist Runs, original Tasks and finite Operations. Stable request keys reconnect lost responses; refresh never silently submits media again. Execution, local stop and image selection remain explicit permissions.
+- ComfyUI workflows expose declared scalar parameters, including LoRA model/CLIP weights and schema-driven choices. Both Core and DSH have dedicated controls. Iris talks to an existing ComfyUI service; it does not install ComfyUI or guess workflow/model identifiers.
+- Core Skills add independent ComfyUI guidance: clarify the workflow and requested result, read actual descriptors, keep original task identities and distinguish an API model from a ComfyUI workflow. Skill installation remains explicit and protects local modifications.
+
+## Generic MCP and selected plugins
+
+- Official SDK stdio and Streamable HTTP transports share Core. Users select media groups, scopes and individual tools; client presets and exports do not scan disks, install clients or grant additional access. Keep the Core service running when using either transport.
+- Trusted plugins can contribute Provider adapters, durable business operations, pages, settings forms and artifact renderers. Core checks identity, compatibility, lifecycle and persistent task dependencies; loading does not authorize execution.
+- The optional contact-sheet plugin demonstrates public SDK access, durable execution, a real Web page and generic MCP calls. Image-input businesses share eligible PNG/JPEG/WebP sources up to 8 MiB within one data root. Other businesses' execution, history and stop controls remain separately authorized; a handler reads only its bound sources.
+- Exact dependency pins, original request keys and stored output identities survive interruption. A missing plugin does not remove saved history or outputs; restarting or upgrading does not automatically replay business work.
+
+## Reliability fixes
+
+This release fixes provider-health edit conflicts, bounded JSON/media responses, interrupted writer-lease preparation, adapter cleanup and delayed metadata, delivery error categories, transient maintenance-reader errors and stale DSH refresh responses. Startup test waits use a monotonic clock; timeout evidence retains the original budgets and failures.
+
+Windows short-path aliases now use the same authentication record identity and credential-directory boundary checks as Core's physical root, while retaining the existing default authentication directory mapping. Downloads wait for the output file to close before publication or partial-file cleanup. Windows lifecycle tests explicitly deliver the CLI's shutdown event; they do not claim that Windows `child.kill('SIGTERM')` is graceful. Use terminal Ctrl+C for normal shutdown and inspect leases after forced termination.
+
+Validation includes controlled local HTTP services, persistent Core storage, public SDK consumers, official MCP clients over both transports, Chromium business flows and actual process-interruption recovery. These tests do not establish compatibility with every paid model, GPU deployment or client attachment renderer.
+
+## Alpha boundaries and upgrades
+
+- Existing roots are not automatically migrated. Initialize new execution/audio roots explicitly; one data root has one writer. The shared-root model is not tenant isolation.
+- Native DSH keeps its own UI and host services. The alpha does not require stable DSH users to move their existing workspace into Core Web.
+- Video, music and visual understanding retain their existing DSH/CLI entry points. Their new Core Web/MCP creation entries are not all implemented. Real ComfyUI GPU inference remains unverified here.
+- This is not a stable plugin SDK, community marketplace or hostile-code sandbox. Provider URLs, redirects and HTTP endpoints remain an explicit trust/deployment boundary.
+- Historical timing anomalies, linear history-validation cost and a specific DSH/Firefox download observation remain recorded. Later successful tests do not establish the cause of an earlier timeout.
+
+## 中文摘要
+
+0.3.0-alpha.1 提供独立 Core 工作台、通用 MCP、显式插件贡献、功能模型池与健康光谱，以及 ComfyUI参数和持久媒体恢复。使用 npm `alpha` 或准确版本安装，稳定 `latest` 保留0.2.7；DSH原生入口及准确宿主范围保持。安装不授权，刷新不自动重做，旧数据根不自动迁移。当前为实验性alpha，尚未完成所有媒体新入口、真实GPU和全部部署场景验收。

package/docs/screenshots.md

@@ -1,4 +1,44 @@
-# Iris Android 真机截图 / Android screenshots
+# Iris 界面与生成来源 / Screenshots and provenance
+
+## Core 工作台开发预览 / Core workbench development preview
+
+2026-10-29 重拍，使用当前未发布源码、独立演示数据根及 Chrome for Testing 153.0.8010.12（Linux ARM64）。全新浏览器 profile 只使用内置明亮/暗色主题；流程与作品是此前从零使用演练已完成记录的独立副本，没有读取用户背景、真实供应商凭据或日常浏览器会话。
+
+Recaptured on 2026-10-29 from the current unreleased source in Chrome for Testing 153.0.8010.12 on Linux ARM64. A fresh browser profile uses only the built-in light/dark themes. The separate demo data root contains copies of completed records from the earlier first-use walkthrough. No personal background, real provider credentials or daily browser session is used.
+
+| 创作与下载 / Studio and download | 完整六类总览 / All six capabilities |
+|---|---|
+| ![Core 创作、选择与下载](assets/screenshots/core-studio-preview.webp) | ![Core 能力总览](assets/screenshots/core-overview-preview.webp) |
+
+| 功能模型池 / Function pools | 能力光谱 / Health spectrum |
+|---|---|
+| ![功能模型池的自动、手动与停用策略](assets/screenshots/core-model-pools-preview.webp) | ![Core 六类能力光谱与连接检查](assets/screenshots/core-spectrum-preview.webp) |
+
+![客户端选择图片生成能力和操作权限](assets/screenshots/core-connections-preview.webp)
+
+客户端图展示实际保存的示例授权，状态为“尚未使用”；未导出或展示连接密钥，不据此声称已连接真实客户端。模型池与光谱中的候选、近期成功来自演示配置与受控任务记录，连接检查和保活均未启用。
+
+The client capture shows an actually saved demo grant marked unused. Its credential is not exported or shown, and the image does not claim a real client handshake. Pool candidates and recent-success facts come from demo configuration and controlled task records; no connection check or keepalive is enabled.
+
+### 窄屏与暗色 / Mobile layout and dark mode
+
+窄屏图使用桌面 Chromium 的390像素视口，展示布局适配；不是 Android 实机截图。创作设置按现有逻辑收起，完整展示图片、选择状态与下载按钮。
+
+The mobile layout uses a 390-pixel viewport in desktop Chromium, rather than a physical Android device. Existing responsive behavior collapses creation settings and keeps the image, selection and download visible.
+
+<p align="center"><img src="assets/screenshots/core-studio-mobile-preview.webp" width="390" alt="Core 390像素窄屏创作与下载"></p>
+
+![Core 内置暗色主题](assets/screenshots/core-studio-dark-preview.webp)
+
+**媒体与截图边界 / Media and capture scope:** 图中的768×768作品来自此前本地受控 OpenAI Images 回放下方历史鸢尾花图片。本轮重拍只读取已有结果及配置，未新增生成、Task或Operation，也不代表真实付费图片、语音或ComfyUI GPU验收。画面未经DOM/CSS改写或拼接，仅通过正常登录、导航和主题操作拍摄。
+
+The 768×768 work comes from the earlier controlled local OpenAI Images replay of the historical iris image below. This capture session reads existing works and configuration without adding a generation, Task or Operation. It does not validate paid image/speech services or a ComfyUI GPU. Captures use normal login, navigation and theme controls, without DOM/CSS rewriting or compositing.
+
+公开版本采用无损WebP以保留界面文字，未保留EXIF/XMP/IPTC。界面当前以中文显示，独立Core功能尚未包含在npm0.2.7中。使用方法见[Core快速开始](CORE_QUICKSTART.md)。
+
+Public copies use lossless WebP to preserve UI text, without EXIF/XMP/IPTC. The current interface is in Chinese; these standalone Core features are outside npm 0.2.7. See the [Core quickstart](CORE_QUICKSTART.md).
+
+## DSH Android 历史真机截图 / Historical DSH Android captures
 
 这些画面来自 Android 16 浏览器，访问运行在 Termux/PRoot Debian ARM64 中的 DSH；界面使用 DSH 默认皮肤。截图与生成图均为 2026-09-06 的真实操作结果，公开副本已重新编码并移除 EXIF、XMP 与 IPTC 元数据。
 

package/lib/actions.js

@@ -40,10 +40,13 @@ import { videoTaskCandidates } from './video-input.js';
 import { normalizeDshProvider, withDshProviderConfig } from './dsh-provider-config.js';
 import { modelDirectorySummary, modelUnavailableReason } from './model-directory.js';
 import { ModelPortError } from './model-port-contract.js';
+import { compileComfyWorkflow, projectComfyWorkflow } from './comfyui-workflow.js';
+import { createComfyUiClient } from './comfyui-client.js';
+import { inspectComfyWorkflow } from './comfyui-inspection.js';
 
 const PROVIDER_ACTIONS = new Set(['image', 'image_edit', 'video', 'music', 'tts', 'transcribe', 'look', 'relook',
   'locate', 'ocr', 'media_summarize', 'task_reobserve', 'task_redeliver', 'task_manual_retry',
-  'providers_discover', 'providers_sync_directory', 'providers_test_vision', 'providers_test_model']);
+  'providers_discover', 'providers_sync_directory', 'providers_test_vision', 'providers_test_model', 'providers_check_comfy_workflow']);
 const AUTO_DIRECTORY_ACTIONS = new Set(['image', 'image_edit', 'video', 'music', 'tts', 'transcribe', 'look', 'relook',
   'locate', 'ocr', 'media_summarize']);
 const VISION_ACTIONS = new Set(['look', 'relook', 'locate', 'ocr', 'media_summarize']);
@@ -64,6 +67,12 @@ function imageRoutingForModel(provider, modelId) {
   return { ...routing, editSupported: supportsImageEdit(routing.mediaProtocol, modelId) };
 }
 
+function comfySummaryForModel(provider, modelId) {
+  const route = providerForImageModel(provider, modelId);
+  return route.mediaProtocol === 'comfyui' && route.comfyWorkflow !== undefined
+    ? { comfyWorkflow: projectComfyWorkflow(route.comfyWorkflow) } : {};
+}
+
 const EMPTY_ACTION_HOST = defineHostAdapter({
   id: 'iris-hostless',
   ports: {},
@@ -512,11 +521,22 @@ async function imageAction(host, args, { signal, core }, editing = false) {
   if (editing && !args.source_artifact_id) throw new Error('iris: 改图必须提供 source_artifact_id');
   const { providerInput, sourceArtifactId } = normalizeGenerationInput('image', {
     prompt: args.prompt, size: optionalActionText(args.size), n: args.n,
+    ...(args.workflow_parameters !== undefined ? { model_ref: args.model, workflow_parameters: args.workflow_parameters } : {}),
     ...(editing ? { source_artifact_id: args.source_artifact_id } : {})
   });
 
   const imageProviders = selectProviders(cap.CAPABILITIES.IMAGE, '图像', args.model);
   const routes = imageProviders.map((provider) => imageRoute(provider, args));
+  if (args.workflow_sha !== undefined && (typeof args.workflow_sha !== 'string' || routes.length !== 1
+      || projectComfyWorkflow(routes[0].provider.comfyWorkflow)?.sha256 !== args.workflow_sha)) {
+    throw Object.assign(new Error('工作流已变化，请重新选择并核对参数'), { code: 'IRIS_CONFIG_CHANGED' });
+  }
+  if (providerInput.workflow_parameters !== undefined) {
+    if (!models.parseModelRef(args.model) || routes.length !== 1 || routes[0].protocol !== 'comfyui') {
+      throw new TypeError('工作流参数需要明确选择一个 ComfyUI 工作流');
+    }
+    compileComfyWorkflow(routes[0].provider.comfyWorkflow, providerInput);
+  }
   const submitted = await submitCoreImage(core, routes, providerInput, signal, sourceArtifactId);
   const firstArtifactId = submitted.task.artifactIds[0];
   const ready = submitted.task.outcome === 'succeeded'
@@ -1091,6 +1111,7 @@ register('providers_list', async (host, args) => {
         ...(m.directoryOnly ? { directoryOnly: true } : {}),
         ...(m.catalogStatus ? { catalogStatus: m.catalogStatus } : {}),
         ...(m.imageProtocol !== undefined ? { imageProtocol: m.imageProtocol } : {}),
+        ...comfySummaryForModel(p, m.id),
         ...(m.musicProtocol !== undefined ? { musicProtocol: m.musicProtocol } : {}),
         ...(m.visionInput !== undefined ? { visionInput: m.visionInput } : {}),
         ...(m.capabilities.includes(cap.CAPABILITIES.VISION) ? { visionInputEffective: visionInputLimits(p, m.id) } : {}),
@@ -1112,6 +1133,34 @@ register('providers_host_connections', async host => {
   return { ok: true, connections: await host.ports.providerConnections.list() };
 });
 
+/** Explicit template save; no provider request or model execution. */
+register('providers_save_comfy_workflow', async (_host, args) => {
+  if (Object.keys(args).some(key => !['id', 'model_id', 'workflow', 'expectedSha', 'enableAutomatic'].includes(key))) throw new TypeError('工作流保存包含不支持的字段');
+  const entry = store.setComfyWorkflow(args.id, args.model_id, args.workflow, {
+    expectedSha: args.expectedSha, enableAutomatic: args.enableAutomatic
+  });
+  return { ok: true, modelId: entry.id, comfyWorkflow: projectComfyWorkflow(entry.comfyWorkflow),
+    text: '工作流已保存；未执行生成' + (args.enableAutomatic ? '，图片功能已使用自动池' : '，功能池设置保持') };
+});
+
+/** Uses only an already saved connection. /object_info never enqueues a prompt. */
+register('providers_check_comfy_workflow', async (_host, args, { signal }) => {
+  if (Object.keys(args).some(key => !['id', 'model_id', 'workflow', 'workflow_parameters'].includes(key))
+      || (args.workflow !== undefined) === (args.model_id !== undefined)) throw new TypeError('请选择已保存工作流或导入一份草稿进行检查');
+  const provider = store.providerById(args.id);
+  if (!provider) throw new TypeError('请先保存并启用 ComfyUI 连接');
+  const route = args.workflow !== undefined ? provider : providerForImageModel(provider, args.model_id);
+  if (route.mediaProtocol !== 'comfyui') throw new TypeError('此检查仅用于 ComfyUI 连接');
+  const file = path.join(store.irisHome(), 'providers.json'), before = fs.readFileSync(file);
+  const workflow = compileComfyWorkflow(args.workflow !== undefined ? args.workflow : route.comfyWorkflow,
+    { workflow_parameters: args.workflow_parameters });
+  const report = await inspectComfyWorkflow(createComfyUiClient(route), workflow, { signal });
+  signal?.throwIfAborted();
+  if (!fs.readFileSync(file).equals(before)) throw Object.assign(new Error('检查期间配置已变化，请重新检查'), { code: 'IRIS_CONFIG_CHANGED' });
+  const key = route.apiKey;
+  return { ok: true, report: key ? JSON.parse(JSON.stringify(report).split(key).join('[redacted]')) : report };
+});
+
 /** 新增/更新供应商 */
 register('providers_upsert', async (host, args) => {
   const id = args.id || undefined;
@@ -1121,6 +1170,7 @@ register('providers_upsert', async (host, args) => {
   for (const key of allowed) {
     if (Object.prototype.hasOwnProperty.call(args, key)) patch[key] = args[key];
   }
+  if (Object.hasOwn(patch, 'auth') && !['none', 'bearer'].includes(patch.auth)) throw new TypeError('认证方式必须为 bearer 或 none');
   if (Object.hasOwn(args, 'dshProvider')) {
     patch.dshProvider = normalizeDshProvider(args.dshProvider);
     const source = requireHostPort(host, 'providerConnections', '复用 DSH 供应商连接');
@@ -1235,6 +1285,7 @@ async function probeModel(host, p, modelId, capability, signal) {
   }
   if (capability === cap.CAPABILITIES.IMAGE) {
     p = providerForImageModel(p, modelId);
+    if (p.mediaProtocol === 'comfyui') return { skipped: true, ok: false, note: 'ComfyUI 请在画图表单选择工作流验证，以持久 Task 保留受理与结果；只读工作流检查不生成图片' };
     const providerAdapter = createConfiguredProviderAdapter(p, { allowRateLimited: true, modelId });
     const submitted = await invokeProviderOperation(providerAdapter, 'submit', {
       capability: 'image', model: modelId,
@@ -1407,7 +1458,7 @@ register('assignments_get', async (host, args) => {
           ? (c === cap.CAPABILITIES.TTS && selectMediaProtocol(provider).mediaProtocol === 'dashscope'
             && dashscopeTtsProtocolIssue(m.id)) || '当前接口协议不支持此功能'
           : modelUnavailable ? modelUnavailableReason() : m.rateLimited ? '限流冷却或额度不可用，请稍后或检查账号' : m.source === 'discovered' ? '已发现，待确认模型用途' : '',
-        ...(c === cap.CAPABILITIES.IMAGE && provider ? { imageRouting: imageRoutingForModel(provider, m.id) } : {}) });
+        ...(c === cap.CAPABILITIES.IMAGE && provider ? { imageRouting: imageRoutingForModel(provider, m.id), ...comfySummaryForModel(provider, m.id) } : {}) });
     }
   }
   // order：归一化的有序分配列表（GUI 直接渲染 failover 顺序，无需处理单字符串旧格式）

package/lib/adapters.js

@@ -15,6 +15,7 @@ import { dashscopeApiBase, imageSizeViolation, isDashScopeBaseUrl, normalizeImag
 import { chmodPrivateFile, ensurePrivateDir, privateSibling } from './private-storage.js';
 import { isFreeQuotaExhausted, retryAfterDelay } from './provider-health.js';
 import { ProviderContractError } from './provider-contract.js';
+import { boundedProviderBody, readProviderText, PROVIDER_RESPONSE_LIMITS } from './provider-response.js';
 export { generateMusic } from './music-transport.js';
 
 /**
@@ -42,8 +43,8 @@ function authHeaders(key) {
   };
 }
 
-async function readJson(res) {
-  const text = await res.text();
+async function readJson(res, maxBytes = PROVIDER_RESPONSE_LIMITS.json) {
+  const text = await readProviderText(res, { maxBytes });
   try {
     return text ? JSON.parse(text) : null;
   } catch (_) {
@@ -149,8 +150,9 @@ async function fetchImageJson(url, options) {
   let response;
   try {
     response = await fetch(url, options);
-    return { res: response, body: await readJson(response) };
+    return { res: response, body: await readJson(response, response.ok ? PROVIDER_RESPONSE_LIMITS.mediaJson : PROVIDER_RESPONSE_LIMITS.json) };
   } catch (err) {
+    if (err instanceof ProviderContractError) throw err;
     throw transportFetchError(err, response);
   }
 }
@@ -287,7 +289,11 @@ export async function submitVideo({ key, baseUrl, model, prompt, imgDataUrl, siz
  * 返回 oss:// 形式 URL；调用模型时请求头须带 X-DashScope-OssResourceResolve: enable
  * （submitVideo 的 s2v 分支已自动处理）。
  */
-export async function uploadTempFile({ key, baseUrl, model, filePath, timeoutMs = T_UPLOAD, signal }) {
+export async function uploadTempFile({ key, baseUrl, model, filePath, bytes, filename, timeoutMs = T_UPLOAD, signal }) {
+  if ((filePath === undefined) === (bytes === undefined)) throw new TypeError('上传须且只能提供本地路径或明确字节');
+  const name = filePath !== undefined ? path.basename(filePath) : filename;
+  if (typeof name !== 'string' || !name || name.length > 128 || /[\/\\\0]/.test(name)
+      || bytes !== undefined && (!(bytes instanceof Uint8Array) || !bytes.length)) throw new TypeError('上传字节或文件名无效');
   const apiBase = dashscopeApiBase(baseUrl);
   const u = new URL(`${apiBase}/uploads`);
   u.searchParams.set('action', 'getPolicy');
@@ -296,7 +302,6 @@ export async function uploadTempFile({ key, baseUrl, model, filePath, timeoutMs
   const pbody = await readJson(pres);
   if (!pres.ok || !pbody || !pbody.data) throw providerError(pres.status, pbody, '获取上传凭证失败', pres.headers);
   const pol = pbody.data;
-  const name = path.basename(filePath);
   const keyPath = `${pol.upload_dir}/${Date.now()}-${name}`;
   const fd = new FormData();
   fd.append('OSSAccessKeyId', pol.oss_access_key_id);
@@ -306,7 +311,7 @@ export async function uploadTempFile({ key, baseUrl, model, filePath, timeoutMs
   fd.append('x-oss-forbid-overwrite', pol.x_oss_forbid_overwrite);
   fd.append('key', keyPath);
   fd.append('success_action_status', '200');
-  fd.append('file', new Blob([fs.readFileSync(filePath)]), name);
+  fd.append('file', new Blob([bytes ?? fs.readFileSync(filePath)]), name);
   const up = await fetch(pol.upload_host, { method: 'POST', body: fd, signal: timeoutSignal(timeoutMs, signal) });
   if (up.status !== 200) throw new Error(`临时上传失败：HTTP ${up.status}`);
   return 'oss://' + keyPath;
@@ -366,7 +371,7 @@ export async function synthesizeTts({ key, baseUrl, model = 'qwen-tts-latest', t
     signal: timeoutSignal(timeoutMs, signal),
     body: JSON.stringify({ model, input: { text, voice } })
   });
-  const body = await readJson(res);
+  const body = await readJson(res, res.ok ? PROVIDER_RESPONSE_LIMITS.mediaJson : PROVIDER_RESPONSE_LIMITS.json);
   if (!res.ok) {
     const error = providerError(res.status, body, '合成失败', res.headers);
     if (res.status === 404 && (/NotFound\.Model|model_not_found/i.test(error.providerCode)
@@ -614,7 +619,7 @@ export async function visionStream({ key, baseUrl, model = 'qwen-vl-plus', promp
     throw networkError(err); // 网络层失败归类为 network
   }
   if (!res.ok) {
-    const text = await res.text().catch(() => '');
+    const text = await readProviderText(res, { maxBytes: PROVIDER_RESPONSE_LIMITS.json, stage: 'response', acceptance: 'unknown' });
     let body = null;
     try { body = JSON.parse(text); } catch (_) { /* keep null */ }
     throw providerError(res.status, body, '视觉理解失败', res.headers);
@@ -655,15 +660,19 @@ export function extFromUrl(url, fallback = 'bin') {
   return fallback;
 }
 
-export async function downloadTo(url, filePath, { timeoutMs = T_DOWNLOAD, signal } = {}) {
+export async function downloadTo(url, filePath, { timeoutMs = T_DOWNLOAD, signal, maxBytes = PROVIDER_RESPONSE_LIMITS.video } = {}) {
   const res = await fetch(url, { signal: timeoutSignal(timeoutMs, signal) });
-  if (!res.ok) throw new Error(`下载结果失败：HTTP ${res.status}`);
+  if (!res.ok) {
+    await res.body?.cancel();
+    throw Object.assign(new Error(`下载结果失败：HTTP ${res.status}`), { stage: 'download', category: 'provider', httpStatus: res.status, acceptance: 'accepted' });
+  }
   if (!res.body) throw new Error('下载结果失败：响应没有内容');
   ensurePrivateDir(path.dirname(filePath));
   const tmp = privateSibling(filePath, 'download');
   try {
     const output = fs.createWriteStream(tmp, { flags: 'wx', mode: 0o600 });
-    await pipeline(Readable.fromWeb(res.body), output);
+    const closed = new Promise(resolve => output.once('close', resolve));
+    await pipeline(Readable.from(boundedProviderBody(res, { maxBytes, stage: 'download', acceptance: 'accepted' })), output).finally(() => closed);
     const bytes = fs.statSync(tmp).size;
     fs.renameSync(tmp, filePath);
     chmodPrivateFile(filePath);

package/lib/application-runtime.js

@@ -1,12 +1,15 @@
 'use strict';
 
 import { normalizeCoreOptions } from './core-contract.js';
-import { createCoreRuntime } from './core-runtime.js';
+import { createCoreRuntime, inspectCoreWriterLease } from './core-runtime.js';
 import { createCommandService } from './command-service.js';
 import { normalizeGenerationInput } from './generation-input.js';
 import { createProviderTaskRunner } from './provider-task-runner.js';
 import { createImageFlowService } from './image-flow.js';
 import { createLocalCreationService } from './local-creation.js';
+import { createLocalOperationService } from './local-operations.js';
+import { reservePluginOperation } from './plugin-operations.js';
+import { invokeReservedPlugin } from './plugin-execution.js';
 
 // Internal first-slice execution surface, not a public API or an HTTP allowlist.
 const COMMAND_MODES = Object.freeze({
@@ -15,7 +18,11 @@ const COMMAND_MODES = Object.freeze({
   'artifact.inspect': 'reader', 'artifact.list': 'reader', 'task.inspect': 'reader', 'task.list': 'reader',
   'flow.init': 'writer', 'flow.create': 'writer', 'flow.continue': 'writer', 'flow.select': 'writer', 'flow.export': 'writer',
   'flow.inspect': 'reader', 'flow.list': 'reader',
-  'creation.init': 'writer', 'creation.image': 'writer', 'creation.flow': 'writer'
+  'creation.init': 'writer', 'creation.image': 'writer', 'creation.flow': 'writer', 'creation.generate': 'writer',
+  'creation.audio': 'writer', 'creation.speech': 'writer', 'creation.transcribe': 'writer',
+  'creation.root': 'reader', 'creation.lookup': 'reader',
+  'execution.init': 'writer', 'operation.accept': 'writer', 'operation.transition': 'writer',
+  'operation.inspect': 'reader', 'operation.lookup': 'reader', 'operation.list': 'reader'
 });
 
 export class ApplicationRuntimeError extends Error {
@@ -31,7 +38,7 @@ function closed() {
 }
 
 /** Instance-owned FIFO and operation-scoped Core leases. No I/O until an explicit operation. */
-export function createApplicationRuntime({ dataRoot, resolveImageCandidates, resolveTaskAdapter } = {}) {
+export function createApplicationRuntime({ dataRoot, resolveImageCandidates, resolveAudioCandidates, resolveTaskAdapter } = {}) {
   const root = normalizeCoreOptions({ dataRoot }).dataRoot;
   if (resolveImageCandidates !== undefined && typeof resolveImageCandidates !== 'function') {
     throw new TypeError('resolveImageCandidates 必须是显式候选解析函数');
@@ -39,6 +46,7 @@ export function createApplicationRuntime({ dataRoot, resolveImageCandidates, res
   if (resolveTaskAdapter !== undefined && typeof resolveTaskAdapter !== 'function') {
     throw new TypeError('resolveTaskAdapter 必须是显式 Task Provider 解析函数');
   }
+  if (resolveAudioCandidates !== undefined && typeof resolveAudioCandidates !== 'function') throw new TypeError('音频候选解析须为函数');
   let state = 'open';
   const queue = [];
   const active = new Set();
@@ -80,7 +88,16 @@ export function createApplicationRuntime({ dataRoot, resolveImageCandidates, res
     try {
       runtime.start();
       result = await job.action(runtime);
-    } catch (error) { failed = true; operationError = error; }
+    } catch (error) {
+      failed = true; operationError = error;
+      if (job.mode === 'reader' && error?.code === 'IRIS_ARTIFACT_INDEX_INVALID' && error.missingFile === true) {
+        const lease = inspectCoreWriterLease(root);
+        if (lease.status === 'present' && lease.ownerStatus === 'alive') {
+          operationError = new ApplicationRuntimeError('IRIS_CORE_DATA_ROOT_BUSY', '作品读取遇到活动写入，请在写入结束后显式重试');
+          Object.defineProperty(operationError, 'cause', { value: error });
+        }
+      }
+    }
     try { await (job.disposal || runtime.dispose()); }
     catch (error) {
       cleanupFailure ||= error;
@@ -150,9 +167,10 @@ export function createApplicationRuntime({ dataRoot, resolveImageCandidates, res
         if (runtime.signal.aborted) throw aborted();
         return adapter;
       } } : {};
-      if (name.startsWith('creation.')) return createLocalCreationService(runtime, { resolveImageCandidates,
+      if (name === 'execution.init' || name.startsWith('operation.')) return createLocalOperationService(runtime).execute(name, ownedInput);
+      if (name.startsWith('creation.')) return createLocalCreationService(runtime, { resolveImageCandidates, resolveAudioCandidates,
         onPrepared: options?.onPrepared }).execute(name, ownedInput);
-      if (name.startsWith('flow.')) return createImageFlowService(runtime, { ...ports, resolveImageCandidates }).execute(name, ownedInput);
+      if (name.startsWith('flow.')) return createImageFlowService(runtime, { ...ports, resolveImageCandidates, resolveAudioCandidates }).execute(name, ownedInput);
       return createCommandService(runtime, ports).execute(name, ownedInput);
     }, options);
   }
@@ -170,6 +188,15 @@ export function createApplicationRuntime({ dataRoot, resolveImageCandidates, res
     }, options);
   }
 
+  /** Explicit trusted assembly only. No HTTP/MCP route or persistent Operation action is added. */
+  async function executePluginOperation(registry, id, input, { allowedOperations = [], dependency, signal } = {}) {
+    const reserved = reservePluginOperation(registry, id, input, allowedOperations, dependency);
+    try {
+      return await schedule(reserved.mode, runtime => runtime.run(reserved.mode === 'reader' ? 'inspect' : 'execute',
+        () => invokeReservedPlugin(runtime, reserved)), { signal });
+    } finally { reserved.release(); }
+  }
+
   function dispose() {
     if (disposePromise) return disposePromise;
     state = 'closing';
@@ -182,5 +209,5 @@ export function createApplicationRuntime({ dataRoot, resolveImageCandidates, res
     return disposePromise;
   }
 
-  return Object.freeze({ execute, generateImage, run, dispose, snapshot });
+  return Object.freeze({ execute, generateImage, executePluginOperation, run, dispose, snapshot });
 }