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

package/plugins/contact-sheet/web/board.mjs

@@ -0,0 +1,93 @@
+const element = (tag, text, className) => { const node = document.createElement(tag); if (text) node.textContent = text; if (className) node.className = className; return node; };
+
+export async function mount({ container, api, session, signal }) {
+  const service = api.pluginOperations, urls = new Set(), timers = new Set();
+  const keyName = 'iris.contact-sheet.' + session.rootId, operationId = 'community.contact-sheet.create';
+  let request, selected = [], catalog, busy = false;
+  const intro = element('div', '', 'intro'); intro.append(element('h2', '让灵感，并排相遇。'), element('p', '选择现有图片，离线排成一张对照板。原图保持不变。', 'muted'));
+  const layout = element('div', '', 'board-layout'), choices = element('div', '', 'image-choices'), editor = element('form', '', 'card');
+  choices.setAttribute('aria-label', '选择来源图片');
+  const columnsLabel = element('label', '每行图片数'), columns = document.createElement('select'); columns.name = 'columns';
+  for (let i = 1; i <= 4; i++) columns.add(new Option(String(i), String(i))); columns.value = '2'; columnsLabel.append(columns);
+  const sizeLabel = element('label', '单张边长'), size = document.createElement('select'); size.name = 'size';
+  for (const i of [128, 256, 512]) size.add(new Option(i + ' px', String(i))); size.value = '256'; sizeLabel.append(size);
+  const count = element('p', '尚未选择图片', 'field-note'), submit = element('button', '制作对照板'); submit.type = 'submit'; submit.disabled = true;
+  const fresh = element('button', '新建一张', 'secondary'); fresh.type = 'button'; fresh.hidden = true;
+  const recover = element('button', '查询原操作', 'secondary'); recover.type = 'button'; recover.hidden = true;
+  const more = element('button', '加载更多图片', 'secondary'); more.type = 'button'; more.hidden = true;
+  editor.append(columnsLabel, sizeLabel, count, submit, recover, fresh, more);
+  const status = element('p', '正在读取现有作品…', 'field-note'); status.setAttribute('role', 'status'); status.dataset.boardStatus = 'true';
+  const output = element('section', '', 'board-result'); output.hidden = true;
+  layout.append(choices, editor); container.append(intro, layout, status, output);
+  function remember(value) {
+    request = value;
+    try { value ? sessionStorage.setItem(keyName, JSON.stringify(value)) : sessionStorage.removeItem(keyName); }
+    catch (_) { status.textContent = '浏览器无法保存恢复标识；请保留本次 Operation ID。'; }
+  }
+  function controls() {
+    const locked = busy || Boolean(request);
+    submit.disabled = locked || !selected.length || !catalog?.operations.some(item => item.id === operationId && item.available);
+    columns.disabled = size.disabled = locked; more.disabled = busy;
+    for (const checkbox of choices.querySelectorAll('input')) checkbox.disabled = locked || !checkbox.checked && selected.length >= 16;
+  }
+  function note(error) { status.textContent = [error.message, error.code, error.requestId].filter(Boolean).join(' · '); }
+  async function present(operation) {
+    signal.throwIfAborted();
+    if (operation.action !== 'plugin.execute' || operation.operationId !== operationId) throw new Error('恢复标识不属于此对照板业务，请核对业务记录');
+    status.textContent = ({ queued: '已接收，正在等待处理', running: '正在排版', succeeded: '对照板已保存', interrupted: '处理已中断，保留原记录；不会自动重做', canceled: '已停止，原记录保留', failed: '处理未完成，请核对插件与授权' })[operation.state]
+      + ' · ' + operation.id;
+    fresh.hidden = ['queued', 'running'].includes(operation.state);
+    recover.hidden = true;
+    if (operation.state === 'succeeded' && operation.result.artifactIds.length) {
+      const id = operation.result.artifactIds[0], blob = await api.artifact({ id, mediaType: 'image/png' }); signal.throwIfAborted();
+      const url = URL.createObjectURL(blob); urls.add(url); const image = element('img'); image.src = url; image.alt = '已保存的多图对照板';
+      const link = element('a', '下载原始 PNG'); link.href = url; link.download = 'iris-contact-sheet-' + id + '.png';
+      output.replaceChildren(image, link); output.hidden = false;
+    } else if (['queued', 'running'].includes(operation.state)) {
+      const timer = setTimeout(() => { timers.delete(timer); void poll(operation.id); }, 450); timers.add(timer);
+    }
+  }
+  async function poll(id) { try { await present((await service.inspect(id)).operation); } catch (error) { if (!signal.aborted) { note(error); recover.hidden = false; } } }
+  editor.addEventListener('submit', async event => {
+    event.preventDefault(); if (busy || request || !selected.length) return;
+    const contribution = catalog.operations.find(item => item.id === operationId && item.available); if (!contribution) return;
+    busy = true; remember({ key: crypto.randomUUID(), operationId, dependency: contribution.dependency,
+      input: { artifactIds: selected, columns: Number(columns.value), cellSize: Number(size.value) } }); controls(); status.textContent = '正在保存本次操作…';
+    try { const result = await service.execute(request); await present(result.operation); }
+    catch (error) { if (!signal.aborted) { note(error); status.textContent += '。请查询原操作，未自动重做。'; recover.hidden = false; } }
+    finally { busy = false; if (!signal.aborted) controls(); }
+  });
+  fresh.addEventListener('click', () => { remember(null); output.hidden = true; output.replaceChildren(); fresh.hidden = recover.hidden = true; status.textContent = '选择图片后可以新建一次操作。'; controls(); });
+  async function lookup() {
+    try { await present((await service.lookup(request.key)).operation); }
+    catch (error) { if (!signal.aborted) { note(error); recover.hidden = false; if (error.status === 404) fresh.hidden = false; } }
+  }
+  recover.addEventListener('click', () => { if (!busy && request) void lookup(); });
+  signal.addEventListener('abort', () => { for (const timer of timers) clearTimeout(timer); for (const url of urls) URL.revokeObjectURL(url); }, { once: true });
+  if (!service) { status.textContent = '此服务未开启插件业务执行。'; return; }
+  catalog = await service.catalog({ limit: '30' }); signal.throwIfAborted();
+  async function appendImages(page) { for (const artifact of page.artifacts) {
+    const label = element('label', '', 'image-choice'), checkbox = document.createElement('input'); checkbox.type = 'checkbox'; checkbox.value = artifact.id;
+    const image = element('img'); image.alt = '来源图片 ' + artifact.id;
+    label.append(checkbox, image, element('span', artifact.id.slice(-8), 'muted')); choices.append(label);
+    const blob = await api.artifact({ id: artifact.id, mediaType: artifact.mediaType }); signal.throwIfAborted();
+    const url = URL.createObjectURL(blob); urls.add(url); image.src = url;
+    checkbox.addEventListener('change', () => { selected = checkbox.checked ? [...selected, artifact.id] : selected.filter(id => id !== artifact.id);
+      count.textContent = '已选择 ' + selected.length + ' 张 · 按选择顺序排版'; controls(); });
+  } more.hidden = page.nextOffset === null || page.nextOffset === undefined; controls(); }
+  more.addEventListener('click', async () => {
+    if (busy || catalog.nextOffset === null) return;
+    busy = true; controls();
+    try { catalog = await service.catalog({ limit: '30', offset: String(catalog.nextOffset) }); signal.throwIfAborted(); await appendImages(catalog); }
+    catch (error) { if (!signal.aborted) note(error); }
+    finally { busy = false; if (!signal.aborted) controls(); }
+  });
+  await appendImages(catalog);
+  if (!catalog.artifacts.length) choices.append(element('p', '当前没有可用图片，请先通过现有创作入口或 CLI 导入。', 'muted'));
+  status.textContent = '最多选择 16 张图片，不调用模型。';
+  try { const saved = sessionStorage.getItem(keyName); if (saved) request = JSON.parse(saved); }
+  catch (_) { status.textContent = '原恢复标识无法读取，请先核对业务记录。'; }
+  if (request) await lookup();
+  controls();
+  return () => { for (const timer of timers) clearTimeout(timer); for (const url of urls) URL.revokeObjectURL(url); container.replaceChildren(); };
+}

package/skills/iris-core/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: iris-core
-description: "Create, edit, and retrieve persistent Iris images through the standalone CLI without a running DSH host. Use for local image imports, revisions, existing task inspection, and artifact export."
+description: "Create, edit, and retrieve persistent Iris images through the standalone CLI without a running DSH host. Use for API images, configured ComfyUI workflows and LoRA parameters, local imports, revisions, task recovery, and artifact export."
 ---
 
 # Iris Core · 核心图片工作流
@@ -11,13 +11,17 @@ Organize the work around the image the user wants to receive. Reuse existing ass
 
 Use the [standalone CLI reference](references/cli.md) to confirm the installed command, explicit data root, and private provider configuration needed for generation. Reuse information already established in the conversation. Do not scan another application's configuration or assume a personal directory, provider, or model.
 
-A visible skill does not prove that its execution tools are available. Report a missing command, connection, or capability precisely. This edition binds to the existing CLI; future MCP and independent workbench integrations need their own verified invocation instructions.
+A visible skill does not prove that its execution tools are available. Report a missing command, connection, or capability precisely. This skill binds to the CLI. For an explicitly selected MCP connection, use its connection-specific skill and actual authorized tools; do not bypass a missing MCP capability through the CLI.
+
+## Clarify a ComfyUI request · 先确认工作流与要求
+
+For ComfyUI, read the [workflow, parameters, LoRA and recovery reference](references/comfyui.md). Ask a concise, bundled question for missing image requirements, workflow choice and parameter preferences before creating or executing work. Read-only catalog inspection may help the user choose. Reuse answers and authorization already given; a complete request needs no repeated questionnaire. API-only requests follow their established configuration and do not require ComfyUI setup questions.
 
 ## Plan the image work · 按作品组织步骤
 
 - Import a local image when it needs to become a persistent source. Reuse an existing Artifact in the current root without importing it again.
 - Generate for a new image request. For a revision, pass the source Artifact and requested changes to create a related version while retaining the original. Retrieve existing results instead of regenerating them.
-- Omit the model override unless the user specifies one, allowing the configured capability policy to select candidates. An explicit model must be allowed for that capability. Names, catalog entries, and past success do not establish present availability.
+- For ordinary API work, use the configured capability policy when it matches the user's choice. If the pool mixes API and ComfyUI, choose an actual allowed API reference explicitly to keep an API-only request on that path. ComfyUI always uses a specific workflow confirmed from the current catalog; never guess from a model family name. Names, catalog entries, and past success do not establish present availability.
 - Add only steps needed for the requested result. An explicit edit can proceed directly; a generation request does not require extra paid vision checks or another generation.
 - Wait for actual delivery before starting a dependent operation. When content verification is required, use an image-reading capability available in the current host. Metadata and file existence alone do not establish visual correctness.
 
@@ -37,4 +41,4 @@ Preserve the original Task after interruption or unknown acceptance; do not prob
 
 Return the actual image file or a host-accessible asset, with the Task/Artifact IDs needed to continue. Distinguish availability, export, display in the conversation, and visual verification. Report partial results and unmet conditions accurately.
 
-This edition covers images and their tasks. It does not imply support for video, speech, UI operations, or a production MCP service in this entry point. Existing DSH skills continue to guide DSH-native tools and workbench workflows.
+This skill covers images and their tasks. The ComfyUI path requires 0.3.0-alpha.1 or compatible source; stable npm 0.2.7 does not include it. Check the actual installed version. Existing DSH skills continue to guide DSH-native tools and workbench workflows.

package/skills/iris-core/references/cli.md

@@ -2,7 +2,7 @@
 
 The current executable binding is `dsh-iris`, which uses shared Application/Core operations without a running DSH host. Check the installed command with `dsh-iris --help`. In a confirmed source checkout, `node /absolute/path/to/iris/bin/dsh-iris.js` is also available. A missing command does not authorize installing software or changing package versions.
 
-These image, artifact, and task commands exist in 0.2.6. This skill is a new, unreleased package resource. Development-only Flow commands, local HTTP writes, and a future UI are not prerequisites.
+These image, artifact, and task commands exist in 0.2.6; the Core skill is bundled from 0.2.7. The development [ComfyUI reference](comfyui.md) has its own version and parameter requirements. Flow commands and a workbench are not prerequisites for the standalone API image path below.
 
 ## Establish the context · 明确本次上下文
 
@@ -50,7 +50,7 @@ Write the user's original or authorized revised request into the input file, for
 dsh-iris run image --data-root "$IRIS_DATA_ROOT" --provider-config "$IRIS_PROVIDER_FILE" --input-file "$IRIS_INPUT_FILE"
 ```
 
-Set `n` to the requested count (1–4); do not increase it for testing. Supply `size` only when requested and supported. Omit `model_ref` unless a model was specified; use an allowed `providerId::modelId` for an explicit choice. An explicit choice has no candidate fallback. Default candidate switching requires evidence of non-acceptance.
+Set `n` to the requested count (1–4); do not increase it for testing. Supply `size` only when requested and supported. Use the configured API policy when it matches the request; explicitly select an actual allowed API model when a mixed pool could choose ComfyUI. ComfyUI always requires the confirmed workflow and `n:1`; follow its separate reference. An explicit choice has no candidate fallback. Default candidate switching requires evidence of non-acceptance.
 
 ## Edit an existing image · 编辑已有图片
 

package/skills/iris-core/references/comfyui.md

@@ -0,0 +1,69 @@
+# ComfyUI workflows · 工作流、参数与 API 搭配
+
+This reference describes the **unreleased 0.3-target implementation**, not npm 0.2.7. Confirm the installed command and returned catalog before using it; missing support does not authorize installing or upgrading software. Keep the explicit roots and private provider file from the [CLI reference](cli.md).
+
+## Ask before creating · 提问确认需求
+
+ComfyUI selects an executable workflow with its own exposed controls. Before creating or executing a request, establish:
+
+- The desired subject, style, changes and output. Ask whether a source image must be preserved when the request suggests editing.
+- The configured workflow to use, or whether the user prefers API generation or wants a recommendation from the available workflows.
+- Any required LoRA and separate model/CLIP weights; size, seed or reproducibility requirements. Offer to keep the workflow defaults for unspecified settings; do not require the user to understand every sampler control.
+
+Ask only for missing information, preferably in one compact question. For example: “What should the image contain and look like? Which of these configured workflows should I use? Do you need a particular LoRA, size or seed, or should I keep that workflow's defaults?” Use the user's language and real catalog choices. If the user delegates selection, choose a suitable actual workflow and state the choice and assumptions. Reuse established answers and authorization; do not ask again before each already authorized stage.
+
+Read-only directory inspection may precede the question. While essential choices remain unanswered, do not generate a sample, create a trial Run/Task, change a provider, or install a workflow/model. A missing workflow is a configuration gap to explain, not permission to fabricate a template or silently substitute an API model.
+
+## Read the actual directory · 使用真实目录
+
+```bash
+dsh-iris models list --provider-config "$IRIS_PROVIDER_FILE"
+```
+
+Choose the returned model `ref`. A `comfyWorkflow` summary identifies the configured template; read its `parameters` for actual IDs, labels, types, defaults, ranges and declared choices. Use `imageRouting` and edit support to distinguish API models from workflows, rather than guessing from names such as SDXL or Flux. A configured entry is not proof that the service, nodes or GPU are usable.
+
+LoRA names belong to **existing workflow slots**. Read current available choices through an explicit read-only workflow check when needed and authorized. The check queries node definitions without generating or changing configuration; it cannot establish real inference success. If options are truncated, do not claim an unseen name was verified. Ask for the intended installed name or retain the confirmed default.
+
+Only override declared parameter IDs and supported scalar values. Keep model and CLIP weights separate, including zero/negative values when allowed; do not set them equal without the user's intent. Multiple LoRAs require existing slots in the workflow. A fixed v0 template exposes no runtime parameters. Do not invent a node, a LoRA filename, an arbitrary graph patch or an undeclared negative-prompt field. Integer seeds must fit the JavaScript safe range; keep sampler defaults unless a change is requested or delegated.
+
+## Execute the selected path · 执行明确入口
+
+For CLI image generation, write the approved input to a new private JSON file: actual `model_ref`, `prompt`, `n:1`, optional supported `size`, and optional `workflow_parameters` containing only requested overrides. Omit an empty parameter map. Omit size when the workflow has no size binding. Then use the existing image entry:
+
+```bash
+dsh-iris run image --data-root "$IRIS_DATA_ROOT" --provider-config "$IRIS_PROVIDER_FILE" --input-file "$IRIS_INPUT_FILE"
+```
+
+An optional static check uses a **separate** input file containing just `workflow_parameters` with the same approved overrides; omit `--input` if there are none:
+
+```bash
+dsh-iris models workflow-check "$IRIS_MODEL_REF" --provider-config "$IRIS_PROVIDER_FILE" --input "$(cat "$IRIS_CHECK_FILE")"
+```
+
+The file contains data, not executable shell text. Never substitute prompt text directly into shell code. Read the check's `ok`, issues and limits; exit code 0 alone is not a passing inspection. Checking and generating are separate actions.
+
+For persistent Flow creation, the input also uses `model_ref` and `workflow_parameters`. Text-to-image requires an explicitly initialized new v2 execution root; do not migrate an existing root. Create once, keep the returned Run, and explicitly continue it. A Flow retains private request input, while a standalone Task does not retain the prompt. Follow the invocation supported by the installed version rather than switching formats mid-task.
+
+For an authorized MCP connection, follow its generated skill and actual tool schemas: the directory returns `modelRef`, creation uses `workflowParameters`, and creation saves a Run without generating. A missing directory or execution tool is a capability gap; do not call an unavailable tool or switch to shell commands to bypass it. Owner workflow checks are not automatically available through media MCP tools.
+
+## Combine API and ComfyUI · 选择与串联
+
+| User goal | Supported approach |
+|---|---|
+| A quick API image | Use the configured API policy or an explicit allowed API model; skip the ComfyUI questionnaire unless the request needs it |
+| An existing workflow, LoRA or controlled seed | Confirm the actual ComfyUI workflow and exposed parameters before generation |
+| ComfyUI base image, followed by API revision | Generate once, wait for the original Artifact, then pass that same-root Artifact to an explicitly chosen API model that supports editing |
+| API image refined by ComfyUI | Explain that the current Iris ComfyUI adapter has no source-image upload/binding; do not claim a reverse image-edit chain works |
+| Compare API and ComfyUI | Only when requested, plan two independent generations and their additional work/cost; keep distinct task identities, then show actual results |
+
+For the supported ComfyUI → API chain, use the existing image-edit input: `source_artifact_id` for CLI or `sourceArtifactId` for MCP. Do not carry `workflow_parameters`/`workflowParameters` into the API edit. Both stages need their actual permissions and user intent; authorization for the whole stated chain need not be requested again per step. Keep the original image and the second stage's lineage. If stage two fails, recover stage two instead of regenerating stage one.
+
+Do not silently switch backends as recovery. An API substitute may lose LoRA, workflow or seed semantics. If a substitute is already authorized, establish the original request's acceptance and what tradeoffs that authorization covers; unknown acceptance still requires preserving the original task and any possible duplicate work/billing. Never rebind an old Task/Run to a different model or new template.
+
+## Recover original facts · 恢复原任务
+
+- Standalone CLI: inspect the returned Task in its original root, then use [task recovery](tasks.md) to observe, wait or redeliver that same Task. Preserve it when acceptance is unknown; do not test by submitting again.
+- Persistent Flow/MCP: retain Run/Operation/Task/Artifact IDs, current Run revision and original request UUIDs. Read the original records after interruption. An Operation completing does not prove the remote image completed; explicitly continue the original Run only when authorized and supported by its state. Do not apply standalone Task retry to work around a Flow binding.
+- A lost creation reply does not justify a new key. Recover the original creation identity when the selected entry supports it; otherwise read the original records and report any remaining uncertainty before further work.
+- Query the original remote job rather than rechecking node catalogs as a substitute for task observation. A changed template can block old-task rebinding; preserve the old record and explain the mismatch.
+- Stopping local waiting is not confirmed remote cancellation. The current ComfyUI adapter does not send `/interrupt`. Retrieve and present the actual delivered image; visual quality requires viewing it, not just reading metadata.

package/skills/iris-core/references/tasks.md

@@ -2,6 +2,8 @@
 
 Inspect the Task in its original data root first. Tasks do not persist prompts; do not reconstruct the user's input from a task summary. Inspection has no provider side effects. Observe or recover only as needed for the current request.
 
+For ComfyUI and mixed API work, see [workflow and recovery details](comfyui.md). Keep each stage's original Task. A persistent Flow uses its original Run/Operation and binding; do not use a standalone retry to change that Flow's model or template.
+
 | Recorded fact | Action |
 |---|---|
 | Accepted and still queued/running | Observe or wait for the original Task; do not create another generation |

package/user_guide.md

@@ -64,6 +64,10 @@ DSH 已配好同一媒体服务时，可在第 1 步选择连接来源，明确
 
 保存供应商和修改能力分配都会立即生效，不需要重启 DSH。
 
+## ComfyUI 工作台（未发布源码）
+
+npm 0.2.7 尚不含此界面。当前源码可在“+ 添加供应商”选择“ComfyUI · 已有服务”，保存地址/认证后导入 API 图或 Iris 参数模板，明确节点和公开参数；检查、保存不生成图片。画图时选择具体工作流，可调整 LoRA 双权重、种子等声明参数，并从只读检查取得可用选项。Iris 不安装 ComfyUI 或模型，静态检查不等于真实 GPU 验收。完整操作与限制见 [DSH ComfyUI 入口](docs/IMAGE_GENERATION.md#dsh-工作台入口03-alpha)。
+
 ## 供应商与协议
 
 Iris 当前支持两类调用路径：
@@ -220,7 +224,7 @@ $DSH_HOME/iris/v1/providers.json
 
 `mediaBaseUrl` 可以省略或留空，此时媒体调用沿用 `baseUrl`。`assignments` 可以省略，但从 0.2.4 起缺失分配不发起对应功能的新调用；0.2.6 也不会将其静默改为自动池。包含特殊字符的 provider 或模型引用会经过 URL 编码，复杂引用建议在工作台中生成，不要手写。
 
-可为明确不需要认证的本地端点设置 `"auth": "none"` 并省略 `apiKey`；缺省或 `"auth": "bearer"` 仍要求 Key，保持旧配置行为。无认证模式不会发送 Authorization 头，已有的旧 Key 也不会被带入该模式的媒体请求。工作台尚无专门的无认证开关，需要按上述停机原则编辑私有配置；不要对需要认证的公网端点使用 `auth:none`。
+可为明确不需要认证的本地端点设置 `"auth": "none"` 并省略 `apiKey`；缺省或 `"auth": "bearer"` 仍要求 Key，保持旧配置行为。无认证模式不会发送 Authorization 头，已有的旧 Key 也不会被带入该模式的媒体请求。0.2.7 工作台尚无专门的无认证开关，需按上述停机原则编辑私有配置；未发布源码已在添加供应商与认证设置中提供选择。不要对需要认证的公网端点使用 `auth:none`。
 
 API Key 以明文保存在宿主侧的 `providers.json` 中。POSIX 上 Iris 目录为 `0700`、文件为 `0600`，0.1.1 首次启动会收紧既有 Iris 树但不修改内容或跟随符号链接；Windows 的 mode 不能替代 ACL。状态接口和界面只返回掩码，不会显示完整 Key。不要把这个文件提交到版本库或发给他人。