@mokuyoaxis/dsh-iris 0.2.5 → 0.2.7

package/bin/dsh-iris.js

@@ -3,11 +3,12 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { createCommandService } from '../lib/command-service.js';
 import { createCoreRuntime } from '../lib/core-runtime.js';
+import { createApplicationRuntime } from '../lib/application-runtime.js';
 import { recoverCoreWriterLease } from '../lib/core-lease-recovery.js';
 import { doctor, formatDoctorReport } from '../lib/doctor.js';
 import { loadProviderCatalog, providerCatalogSnapshot, catalogCapabilitySnapshot, imageCandidatesFromCatalog, musicCandidatesFromCatalog, providerForTaskFromCatalog, providerTaskBinding, transcribeCandidatesFromCatalog, ttsCandidatesFromCatalog, videoCandidatesFromCatalog } from '../lib/provider-catalog.js';
 import { createConfiguredProviderAdapter } from '../lib/provider-adapters.js';
-import { providerForImageModel } from '../lib/provider-protocol.js';
+import { providerForImageModel, selectMediaProtocol, dashscopeTtsInputIssue } from '../lib/provider-protocol.js';
 import { prepareProviderInput } from '../lib/provider-adapter.js';
 import { createProviderTaskRunner } from '../lib/provider-task-runner.js';
 import { generateMusicTask } from '../lib/music-generation.js';
@@ -15,19 +16,29 @@ import { GenerationInputError, normalizeGenerationInput } from '../lib/generatio
 import { executeVisionCommand, normalizeVisionInput } from '../lib/headless-vision.js';
 import { videoTaskCandidates } from '../lib/video-input.js';
 import { createChromiumBrowser } from '../lib/chromium-browser.js';
-import { executeConfigCommand, recordCatalogRateLimit } from '../lib/provider-config-service.js';
+import { executeConfigCommand, recordCatalogRateLimit, recordCatalogAvailability, refreshCatalogDirectories } from '../lib/provider-config-service.js';
 import { probeVisionModel } from '../lib/vision-model-routing.js';
 import { RED_TEST_IMAGE } from '../lib/vision.js';
 import { parseModelRef, modelRef as qualifiedModelRef } from '../lib/models.js';
 import { coreTaskWaitFinished } from '../lib/task-wait.js';
+import { createLocalReadApi, writeLocalApiTokenFile } from '../lib/local-api.js';
+import { manageCoreSkill } from '../lib/skill-installation.js';
 
 function trackedProviderAdapter(provider, options, task) {
   return createConfiguredProviderAdapter(provider, {
     modelId: parseModelRef(task?.modelRef)?.modelId,
+    onModelAvailability: event => recordCatalogAvailability(options['provider-config'], event),
     onRateLimit: event => recordCatalogRateLimit(options['provider-config'], event)
   });
 }
 
+async function generationCatalog(options, capability, modelRef, signal = cliAbortController.signal) {
+  const file = required(options['provider-config'], 'provider-config');
+  const catalog = loadProviderCatalog(file);
+  if (!modelRef) await refreshCatalogDirectories(file, catalog, capability, { signal });
+  return catalog;
+}
+
 class CliUsageError extends Error {
   constructor(message) {
     super(message);
@@ -40,7 +51,13 @@ function usage() {
   return [
     'Usage:',
     '  JSON input: --input <json>, --input-file <path>, or --input - (stdin).',
+    '  dsh-iris skills <install|status|uninstall> --target kimi [--directory <absolute-skills-directory>]',
+    '  dsh-iris skills <install|status|uninstall> --directory <absolute-skills-directory>',
+    '    install/uninstall accept --dry-run. Copy only iris-core; preserve local changes and archive managed updates/removals outside the scan directory. status is read-only and does not verify host discovery.',
     '  dsh-iris doctor [--data-root <absolute-path>] [--json]',
+    '  dsh-iris api init --data-root <empty-existing-flow-root>',
+    '  dsh-iris api serve --data-root <existing-flow-root> --token-file <new-absolute-path-outside-root> [--provider-config <absolute-path>] [--port <0..65535>] [--allow-local-writes]',
+    '    Explicit loopback-only API, read-only by default. Local writes only upload images/create Runs, without generation. The session token is saved privately; stdout contains no token.',
     '  dsh-iris runtime recover --data-root <absolute-path> --confirm-stale-pid <pid>',
     '  dsh-iris providers list --provider-config <absolute-path>',
     '  dsh-iris capabilities list --provider-config <absolute-path>',
@@ -79,12 +96,19 @@ function usage() {
     '  dsh-iris artifact export-many --data-root <absolute-path> --input <json> --output <absolute-directory>',
     '  dsh-iris artifact export <id> --data-root <absolute-path> --output <absolute-path>',
     '  dsh-iris artifact rebuild --data-root <absolute-path>',
+    '  dsh-iris flow init --data-root <new-absolute-path>',
+    '  dsh-iris flow create --data-root <absolute-path> --provider-config <absolute-path> --input <image-edit-json>',
+    '    Import the source image after flow init; use explicit model_ref and n=1. create saves private inputs but never submits.',
+    '  dsh-iris flow <list|inspect> [run-id] --data-root <absolute-path>',
+    '  dsh-iris flow continue <run-id> --data-root <absolute-path> [--provider-config <absolute-path>]',
+    '  dsh-iris flow select <run-id> --data-root <absolute-path> --input <json with artifact_id>',
+    '  dsh-iris flow export <run-id> --data-root <absolute-path> --output <absolute-path>',
     '  dsh-iris core <delete|cleanup> --data-root <absolute-path> [--input <json>] [--confirm-delete]',
     '    Default is a read-only preview. delete selects task_ids/artifact_ids; cleanup executes only explicitly selected preview paths.',
     '  dsh-iris core transactions --data-root <absolute-path>',
     '  dsh-iris core restore <transaction-id> --data-root <absolute-path>',
     '',
-    'Commands never start DSH. run image and the task observe/redeliver/cancel/retry verbs contact a provider only when explicitly requested; credentials come from a private file. observe polls once, redeliver only re-downloads, and cancel is recorded as canceled only when the provider explicitly confirms; none of them ever submits an existing task again. task retry creates a NEW task that may incur duplicate generation billing and requires --confirm-billing; the prompt must be supplied again because Core never persists prompts.'
+    'Commands never start DSH. run image and the task observe/redeliver/cancel/retry verbs contact a provider only when explicitly requested; credentials come from a private file. observe polls once, redeliver only re-downloads, and cancel is recorded as canceled only when the provider explicitly confirms; none of them ever submits an existing task again. task retry creates a NEW task that may incur duplicate generation billing and requires --confirm-billing; the prompt must be supplied again because Task records never persist prompts. Flow inputs do retain the prompt privately. flow continue may perform the first submission or observe/redeliver the original task, but never resubmits a task with an Attempt.'
   ].join('\n');
 }
 
@@ -185,12 +209,105 @@ async function withRuntime(mode, dataRoot, callback, ports = {}) {
   return withRawRuntime(mode, dataRoot, (runtime) => callback(createCommandService(runtime, ports)));
 }
 
+async function withApplication(dataRoot, callback, resolveImageCandidates, resolveTaskAdapter) {
+  const application = createApplicationRuntime({ dataRoot: required(dataRoot, 'data-root'), resolveImageCandidates, resolveTaskAdapter });
+  const unregister = registerRuntime(application);
+  try { return await callback(application); }
+  finally { try { await application.dispose(); } finally { unregister(); } }
+}
+
 async function main(args) {
   if (!args.length || args.includes('--help') || args.includes('-h')) {
     console.log(usage());
     return args.length ? 0 : 2;
   }
 
+  if (args[0] === 'skills') {
+    const rest = args.slice(2), dryRunFlags = rest.filter(value => value === '--dry-run');
+    if (dryRunFlags.length > 1) throw new CliUsageError('参数重复：--dry-run');
+    const options = flags(rest.filter(value => value !== '--dry-run'), ['target', 'directory']);
+    let result;
+    try {
+      result = manageCoreSkill({ action: args[1], target: options.target, directory: options.directory, dryRun: dryRunFlags.length === 1 });
+    } catch (error) {
+      if (error.code === 'IRIS_SKILL_OPTIONS_INVALID') throw new CliUsageError(error.message);
+      throw error;
+    }
+    console.log(JSON.stringify(result, null, 2));
+    return args[1] === 'status' && result.status !== 'current' ? 1 : 0;
+  }
+
+  if (args[0] === 'api') {
+    if (args[1] === 'init') {
+      const options = flags(args.slice(2), ['data-root']);
+      const suppliedRoot = required(options['data-root'], 'data-root');
+      if (!path.isAbsolute(suppliedRoot)) throw new CliUsageError('data-root 必须是已初始化的空 Flow 根绝对路径');
+      let dataRoot;
+      try { dataRoot = fs.realpathSync(suppliedRoot); }
+      catch (_) { throw new CliUsageError('请先在新的专用数据根执行 flow init'); }
+      const initialized = await withApplication(dataRoot, application => application.execute('creation.init', {}, { signal: cliAbortController.signal }));
+      console.log(JSON.stringify(initialized));
+      return 0;
+    }
+    if (args[1] !== 'serve') throw new CliUsageError('不支持的 api 子命令');
+    const rest = args.slice(2), localWriteFlags = rest.filter(value => value === '--allow-local-writes');
+    if (localWriteFlags.length > 1) throw new CliUsageError('参数重复：--allow-local-writes');
+    const allowLocalWrites = localWriteFlags.length === 1;
+    const options = flags(rest.filter(value => value !== '--allow-local-writes'), ['data-root', 'token-file', 'provider-config', 'port']);
+    const suppliedRoot = required(options['data-root'], 'data-root');
+    const tokenFile = required(options['token-file'], 'token-file');
+    if (!path.isAbsolute(suppliedRoot) || !path.isAbsolute(tokenFile)) throw new CliUsageError('data-root 与 token-file 必须是绝对路径');
+    if (options.port !== undefined && (!/^\d+$/.test(options.port) || Number(options.port) > 65535)) throw new CliUsageError('port 必须是 0–65535 的整数');
+    // Pin the physical root for both the server and the outside-root credential check.
+    let dataRoot;
+    try { dataRoot = fs.realpathSync(suppliedRoot); }
+    catch (_) { throw new CliUsageError('data-root 必须是已初始化且可读取的 Flow 根'); }
+    const api = createLocalReadApi({ dataRoot, providerConfigPath: options['provider-config'], allowLocalWrites });
+    const unregister = registerRuntime(api);
+    try {
+      const started = await api.start({ port: options.port === undefined ? 0 : Number(options.port) });
+      writeLocalApiTokenFile(tokenFile, started.accessToken, dataRoot);
+      console.log(JSON.stringify({ contractVersion: 0, readOnly: !allowLocalWrites, origin: started.origin, tokenFile,
+        message: allowLocalWrites ? '本地创建 API 已启动；只上传/创建，不执行生成。会话 Token 在指定私有文件中，退出后失效。'
+          : '只读本地 API 已启动；会话 Token 在指定私有文件中，退出后失效。' }));
+      await api.closed;
+      return 0;
+    } finally { try { await api.dispose(); } finally { unregister(); } }
+  }
+
+  if (args[0] === 'flow') {
+    const verb = args[1];
+    if (!['init', 'create', 'list', 'inspect', 'continue', 'select', 'export'].includes(verb)) throw new CliUsageError('不支持的 flow 子命令');
+    const needsId = ['inspect', 'continue', 'select', 'export'].includes(verb);
+    if (needsId && (!args[2] || args[2].startsWith('--'))) throw new CliUsageError('缺少 Run ID');
+    const allowed = ['data-root', ...(['create', 'continue'].includes(verb) ? ['provider-config'] : []),
+      ...(['create', 'select'].includes(verb) ? ['input'] : []), ...(verb === 'export' ? ['output'] : [])];
+    const options = flags(args.slice(needsId ? 3 : 2), allowed);
+    const input = ['create', 'select'].includes(verb) ? jsonInput(options.input) : {};
+    if (verb === 'select' && Object.keys(input).some(key => key !== 'artifact_id')) throw new CliUsageError('flow select 只接受 artifact_id');
+    if (needsId) input.run_id = args[2];
+    if (verb === 'export') input.output_path = required(options.output, 'output');
+    const resolveImageCandidates = options['provider-config'] ? async ({ modelRef, signal }) => {
+      const catalog = await generationCatalog(options, 'image-gen', modelRef, signal);
+      return imageCandidatesFromCatalog(catalog, modelRef).map(route => ({ adapter: trackedProviderAdapter(route.provider, options),
+        model: route.modelRef, selectionReason: route.selectionReason, providerBinding: providerTaskBinding(route.provider) }));
+    } : undefined;
+    const resolveTaskAdapter = options['provider-config'] ? task => {
+      const catalog = loadProviderCatalog(options['provider-config']);
+      return trackedProviderAdapter(providerForTaskFromCatalog(catalog, task), options, task);
+    } : undefined;
+    let result;
+    try {
+      result = await withApplication(options['data-root'], application =>
+        application.execute('flow.' + verb, input, { signal: cliAbortController.signal }), resolveImageCandidates, resolveTaskAdapter);
+    } catch (error) {
+      if (error instanceof GenerationInputError) throw new CliUsageError(error.message);
+      throw error;
+    }
+    console.log(JSON.stringify(result, null, 2));
+    return 0;
+  }
+
   if (args[0] === 'doctor') {
     const rest = args.slice(1);
     if (rest.filter((arg) => arg === '--json').length > 1) throw new CliUsageError('参数重复：--json');
@@ -258,6 +375,10 @@ async function main(args) {
         if (['video-gen', 'transcribe'].includes(capability) && !options.input) return {
           skipped: true, ok: false, reason: '请用 models test --input 提供与 run video/transcribe 相同的真实素材；未发起请求'
         };
+        if (capability === 'tts' && selectMediaProtocol(provider).mediaProtocol === 'dashscope') {
+          const issue = dashscopeTtsInputIssue(modelId, probeInput.voice || provider.ttsVoice);
+          if (issue) return { skipped: true, ok: false, reason: issue };
+        }
         return withRawRuntime('writer', options['data-root'], async runtime => {
           const mediaCapability = capability === 'image-gen' ? 'image' : capability === 'video-gen' ? 'video' : capability;
           if (mediaCapability === 'image') provider = providerForImageModel(provider, modelId);
@@ -266,7 +387,7 @@ async function main(args) {
             ? { prompt: 'red circle', n: 1, ...(['openai-chat-images', 'openai-responses-images'].includes(adapter.protocol) ? {} : {
               size: adapter.protocol === 'openai-images' ? '256x256' : '512*512'
             }) }
-            : { text: '你好', voice: provider.ttsVoice || 'Cherry' };
+            : { text: '你好', voice: probeInput.voice || provider.ttsVoice || 'Cherry' };
           let candidates = [{ adapter, model: qualifiedModelRef(provider.id, modelId), selectionReason: 'explicit', providerBinding: providerTaskBinding(provider) }];
           if (['video', 'transcribe'].includes(mediaCapability)) {
             const normalized = generationInput(mediaCapability, { ...probeInput, model_ref: qualifiedModelRef(provider.id, modelId) },
@@ -284,7 +405,7 @@ async function main(args) {
             task_id: submitted.task.id, timeout_ms: 60000, poll_interval_ms: 1000 });
           const task = waited.task;
           return { ok: task.outcome === 'succeeded' && task.deliveryState === 'ready', taskId: task.id,
-            category: task.lastError?.category, httpStatus: task.lastError?.httpStatus };
+            category: task.lastError?.category, httpStatus: task.lastError?.httpStatus, providerCode: task.lastError?.providerCode };
         });
       }
     });
@@ -307,9 +428,11 @@ async function main(args) {
         fs.accessSync(path.dirname(file), fs.constants.W_OK);
       } catch (_) { throw new CliUsageError('输出文件已存在或父目录不可写'); }
     }
-    const catalog = loadProviderCatalog(required(options['provider-config'], 'provider-config'));
+    const catalog = await generationCatalog(options, 'vision', options['model-ref'] || input.model_ref);
+    if (input.transcribe && !input.transcribe_model_ref) await refreshCatalogDirectories(options['provider-config'], catalog, 'transcribe', { signal: cliAbortController.signal });
     const execute = runtime => executeVisionCommand({ command, input, catalog, runtime,
       onRateLimit: event => recordCatalogRateLimit(options['provider-config'], event),
+      onModelAvailability: event => recordCatalogAvailability(options['provider-config'], event),
       modelRef: options['model-ref'] || '', signal: cliAbortController.signal,
       ...(options['timeout-ms'] !== undefined ? { timeoutMs: Number(options['timeout-ms']) } : {}) });
     const completed = input.transcribe
@@ -344,8 +467,9 @@ async function main(args) {
     const options = flags(args.slice(2), ['data-root', 'input']);
     const input = jsonInput(options.input);
     const command = args[1] === 'diff' ? 'media.diff' : 'media.frames';
-    const result = await withRuntime('writer', options['data-root'], (commands) =>
-      commands.execute(command, input));
+    const result = args[1] === 'diff'
+      ? await withApplication(options['data-root'], application => application.execute(command, input, { signal: cliAbortController.signal }))
+      : await withRuntime('writer', options['data-root'], commands => commands.execute(command, input));
     console.log(JSON.stringify(result, null, 2));
     return 0;
   }
@@ -361,21 +485,24 @@ async function main(args) {
 
   if (args[0] === 'run' && args[1] === 'image') {
     const options = flags(args.slice(2), ['data-root', 'provider-config', 'input']);
-    const { providerInput, modelRef, sourceArtifactId } = generationInput('image', jsonInput(options.input));
-    const catalog = loadProviderCatalog(required(options['provider-config'], 'provider-config'));
-    const routes = imageCandidatesFromCatalog(catalog, modelRef);
-    await withRawRuntime('writer', options['data-root'], async (runtime) => {
-      const candidates = routes.map((route) => ({
+    const input = jsonInput(options.input);
+    const resolveImageCandidates = async ({ modelRef, signal }) => {
+      const catalog = await generationCatalog(options, 'image-gen', modelRef, signal);
+      return imageCandidatesFromCatalog(catalog, modelRef).map(route => ({
         adapter: trackedProviderAdapter(route.provider, options), model: route.modelRef,
         selectionReason: route.selectionReason,
         providerBinding: providerTaskBinding(route.provider)
       }));
-      const result = await createProviderTaskRunner(runtime).submit({
-        capability: 'image', candidates,
-        providerInput, sourceArtifactId
-      });
-      console.log(JSON.stringify(result, null, 2));
-    });
+    };
+    let result;
+    try {
+      result = await withApplication(options['data-root'], application =>
+        application.generateImage(input, { signal: cliAbortController.signal }), resolveImageCandidates);
+    } catch (error) {
+      if (error instanceof GenerationInputError) throw new CliUsageError(error.message);
+      throw error;
+    }
+    console.log(JSON.stringify(result, null, 2));
     return 0;
   }
 
@@ -384,7 +511,7 @@ async function main(args) {
     const options = flags(args.slice(2), ['data-root', 'provider-config', 'input']);
     const normalized = generationInput('video', jsonInput(options.input), { allowVideoPaths: true });
     const { providerInput, modelRef } = normalized;
-    const catalog = loadProviderCatalog(required(options['provider-config'], 'provider-config'));
+    const catalog = await generationCatalog(options, 'video-gen', modelRef);
     const routes = videoCandidatesFromCatalog(catalog, modelRef);
     await withRawRuntime('writer', options['data-root'], async (runtime) => {
       const candidates = videoTaskCandidates(routes.map((route) => ({
@@ -405,7 +532,7 @@ async function main(args) {
   if (args[0] === 'run' && args[1] === 'music') {
     const options = flags(args.slice(2), ['data-root', 'provider-config', 'input']);
     const normalized = generationInput('music', jsonInput(options.input));
-    const catalog = loadProviderCatalog(required(options['provider-config'], 'provider-config'));
+    const catalog = await generationCatalog(options, 'music-gen', normalized.modelRef);
     const routes = musicCandidatesFromCatalog(catalog, normalized.modelRef);
     let result;
     await withRawRuntime('writer', options['data-root'], async runtime => {
@@ -421,7 +548,7 @@ async function main(args) {
   if (args[0] === 'run' && args[1] === 'tts') {
     const options = flags(args.slice(2), ['data-root', 'provider-config', 'input']);
     const { providerInput, modelRef } = generationInput('tts', jsonInput(options.input));
-    const catalog = loadProviderCatalog(required(options['provider-config'], 'provider-config'));
+    const catalog = await generationCatalog(options, 'tts', modelRef);
     const routes = ttsCandidatesFromCatalog(catalog, modelRef);
     await withRawRuntime('writer', options['data-root'], async (runtime) => {
       const candidates = routes.map((route) => ({
@@ -443,7 +570,7 @@ async function main(args) {
   if (args[0] === 'run' && args[1] === 'transcribe') {
     const options = flags(args.slice(2), ['data-root', 'provider-config', 'input']);
     const normalized = generationInput('transcribe', jsonInput(options.input), { allowAudioPath: true });
-    const catalog = loadProviderCatalog(required(options['provider-config'], 'provider-config'));
+    const catalog = await generationCatalog(options, 'transcribe', normalized.modelRef);
     const routes = transcribeCandidatesFromCatalog(catalog, normalized.modelRef);
     let providerInput = normalized.providerInput;
     if (normalized.audioPath) {
@@ -528,7 +655,9 @@ async function main(args) {
       model_ref: options['model-ref'],
       confirm_billing: confirmBilling
     }), {
-      resolveTaskCandidates: ({ capability, modelRef }) => (capability === 'video'
+      resolveTaskCandidates: async ({ capability, modelRef }) => {
+        const catalog = await generationCatalog(options, { image: 'image-gen', video: 'video-gen', music: 'music-gen' }[capability] || capability, modelRef);
+        return (capability === 'video'
         ? videoCandidatesFromCatalog(catalog, modelRef || undefined)
         : capability === 'tts'
           ? ttsCandidatesFromCatalog(catalog, modelRef || undefined)
@@ -542,7 +671,8 @@ async function main(args) {
         model: route.modelRef,
         selectionReason: route.selectionReason,
         providerBinding: providerTaskBinding(route.provider)
-      }))
+      }));
+      }
     });
     console.log(JSON.stringify(result, null, 2));
     return 0;
@@ -550,8 +680,8 @@ async function main(args) {
 
   if (args[0] === 'task' && args[1] === 'inspect' && args[2]) {
     const options = flags(args.slice(3), ['data-root']);
-    const result = await withRuntime('reader', options['data-root'], (commands) =>
-      commands.execute('task.inspect', { task_id: args[2] }));
+    const result = await withApplication(options['data-root'], application =>
+      application.execute('task.inspect', { task_id: args[2] }, { signal: cliAbortController.signal }));
     console.log(JSON.stringify(result, null, 2));
     return 0;
   }
@@ -567,15 +697,16 @@ async function main(args) {
 
   if (args[0] === 'artifact' && args[1] === 'import') {
     const options = flags(args.slice(2), ['data-root', 'input']);
-    const result = await withRuntime('writer', options['data-root'], commands => commands.execute('artifact.import', jsonInput(options.input)));
+    const result = await withApplication(options['data-root'], application =>
+      application.execute('artifact.import', jsonInput(options.input), { signal: cliAbortController.signal }));
     console.log(JSON.stringify(result, null, 2));
     return 0;
   }
 
   if (args[0] === 'artifact' && args[1] === 'inspect' && args[2]) {
     const options = flags(args.slice(3), ['data-root']);
-    const result = await withRuntime('reader', options['data-root'], (commands) =>
-      commands.execute('artifact.inspect', { artifact_id: args[2] }));
+    const result = await withApplication(options['data-root'], application =>
+      application.execute('artifact.inspect', { artifact_id: args[2] }, { signal: cliAbortController.signal }));
     console.log(JSON.stringify(result, null, 2));
     return 0;
   }
@@ -583,8 +714,8 @@ async function main(args) {
   if (args[0] === 'artifact' && args[1] === 'list') {
     const options = flags(args.slice(2), ['data-root', 'offset', 'limit', 'kind', 'media-type', 'task-id']);
     const input = Object.fromEntries(Object.entries(options).filter(([key]) => key !== 'data-root').map(([key, value]) => [key.replaceAll('-', '_'), ['offset', 'limit'].includes(key) ? Number(value) : value]));
-    const result = await withRuntime('reader', options['data-root'], (commands) =>
-      commands.execute('artifact.list', input));
+    const result = await withApplication(options['data-root'], application =>
+      application.execute('artifact.list', input, { signal: cliAbortController.signal }));
     console.log(JSON.stringify(result, null, 2));
     return 0;
   }
@@ -609,11 +740,11 @@ async function main(args) {
 
   if (args[0] === 'artifact' && args[1] === 'export' && args[2]) {
     const options = flags(args.slice(3), ['data-root', 'output']);
-    const result = await withRuntime('writer', options['data-root'], (commands) =>
-      commands.execute('artifact.export', {
+    const result = await withApplication(options['data-root'], application =>
+      application.execute('artifact.export', {
         artifact_id: args[2],
         output_path: required(options.output, 'output')
-      }));
+      }, { signal: cliAbortController.signal }));
     console.log(JSON.stringify(result, null, 2));
     return 0;
   }

package/docs/AGENT_QUICKSTART.md

@@ -2,17 +2,17 @@
 
 把下面一段交给负责安装或使用 Iris 的 Agent。版本与发布状态以当前 [README](../README.md) 为准；Iris 和 DSH 的版本号独立。
 
-下列npm示例对应Iris0.2.5，支持旧宿主的当前功能，准确范围见 [兼容矩阵](DSH_COMPATIBILITY.md)。执行安装命令前先核对发布状态，再确认所选发行包的实际版本、工具和功能分配。
+下列 npm 示例对应 Iris 0.2.7，准确范围见 [兼容矩阵](DSH_COMPATIBILITY.md)。执行安装命令前确认所选发行包的实际版本、工具和功能策略。
 
 ## 中文
 
 ```text
 请根据本仓库 README，帮我安装并使用 Iris（@mokuyoaxis/dsh-iris）。
 先确认运行环境、目标 DSH profile，并用 dsh --version 核对宿主；Iris 0.2.x 要求 Node.js >=22.0.0（旧 npm 0.1.4 的历史要求为 >=20.10.0）：
-- DSH在docs/DSH_COMPATIBILITY.md列出的12个准确版本中：固定安装 dsh plugin --profile web add @mokuyoaxis/dsh-iris@0.2.5；只下载用 npm pack @mokuyoaxis/dsh-iris@0.2.5。
+- DSH在docs/DSH_COMPATIBILITY.md列出的12个准确版本中：固定安装 dsh plugin --profile web add @mokuyoaxis/dsh-iris@0.2.7；只下载用 npm pack @mokuyoaxis/dsh-iris@0.2.7。
 - 未列入所选Iris版本兼容矩阵的DSH：先报告没有支持声明，不自行升级宿主或跳过版本检查。
-没有DSH、希望用CLI时，按docs/HEADLESS_CLI.md使用npm0.2.5；npm0.1.4不含当前Core媒体CLI。
-先用--help和Doctor核对实际版本与命令。六类模型功能都需明确分配，空名单停止新调用；DSH默认视觉也须明确加入。图片导入用iris_import_image，改图用iris_edit_image；音乐用iris_generate_music并配置Chat Completions（内嵌音频）协议，见docs/MUSIC.md。
+没有DSH、希望用CLI时，按docs/HEADLESS_CLI.md使用npm0.2.7；npm0.1.4不含当前Core媒体CLI。
+先用--help和Doctor核对实际版本与命令。可引用DSH已有API Key连接，再确认模型用途并主动启用自动池，或保留手选名单；旧空配置不自动启用。DSH默认视觉须明确加入或启用。目录新增模型仍需确认用途；不以实测请求探测配置。图片导入用iris_import_image，改图用iris_edit_image；音乐用iris_generate_music并配置Chat Completions（内嵌音频）协议，见docs/MUSIC.md。
 从dsh-market安装也要核对实际包名、版本和兼容范围；缓存的旧版安装信息仍按其历史矩阵判断。
 若使用其他 profile，把示例中的 web 换成已确认的目标。保留完整 scoped 包名，不把 dsh-iris 当作同一 npm 包。
 安装后检查 Doctor 和工具可达性，再执行我指定的媒体任务；不要输出 API Key，重启宿主前说明影响。
@@ -25,10 +25,10 @@
 ```text
 Help me install and use Iris (@mokuyoaxis/dsh-iris) according to this repository's README.
 Check the environment, target DSH profile, and dsh --version first; Iris 0.2.x requires Node.js >=22.0.0 (the published npm 0.1.4 historically requires >=20.10.0):
-- For one of the twelve exact DSH versions in docs/DSH_COMPATIBILITY.md, pin dsh plugin --profile web add @mokuyoaxis/dsh-iris@0.2.5; download only with npm pack @mokuyoaxis/dsh-iris@0.2.5.
+- For one of the twelve exact DSH versions in docs/DSH_COMPATIBILITY.md, pin dsh plugin --profile web add @mokuyoaxis/dsh-iris@0.2.7; download only with npm pack @mokuyoaxis/dsh-iris@0.2.7.
 - DSH versions outside the selected Iris version's matrix: report the missing support claim; do not upgrade the host or bypass its version checks automatically.
-For CLI use without DSH, follow docs/HEADLESS_CLI.md using npm0.2.5; npm0.1.4 lacks the current Core media CLI. Check the README publication status first.
-Check --help, Doctor and the actual installed version. All six model functions require explicit assignments; empty lists stop new calls. Add DSH default vision explicitly when needed. Use iris_import_image for import, iris_edit_image for editing, and iris_generate_music with its configured inline-audio protocol for music.
+For CLI use without DSH, follow docs/HEADLESS_CLI.md using npm0.2.7; npm0.1.4 lacks the current Core media CLI.
+Check --help, Doctor and the actual installed version. Reference a DSH API-key connection when available, confirm model uses, and explicitly enable automatic pools or retain selected-only lists. Existing empty configurations stay inactive. Host vision and new directory models require explicit authorization. Do not probe paid models to check configuration. Use iris_import_image for import, iris_edit_image for editing, and iris_generate_music with its configured inline-audio protocol for music.
 For dsh-market, check the actual package name, version, and compatibility range too. Cached older releases retain their historical compatibility matrices.
 Replace web with the confirmed profile when needed. Keep the scoped package name; unscoped dsh-iris is a different npm package.
 Check Doctor and tool availability after installation, then carry out my requested media task. Do not expose API keys; explain the impact before restarting the host.

package/docs/ARCHITECTURE.md

@@ -1,6 +1,6 @@
 # Iris 架构与边界
 
-状态：本文描述 **Iris0.2.5** 的架构。0.2.0建立实例化Core Runtime、Headless CLI及共享Task/Artifact事实；后续加入共享视觉、图片编辑、音乐和交付恢复。0.2.4补图片导入、原生Qwen改图和统一功能分配；0.2.5按接口能力恢复旧宿主支持。准确版本及历史发行范围见 [兼容矩阵](DSH_COMPATIBILITY.md)。Node.js最低22.0.0；Core内部API尚未冻结为公共SDK。
+状态：本文描述 **Iris 0.2.7** 的架构。0.2.0 建立实例化 Core Runtime、Headless CLI 及共享 Task/Artifact 事实；后续加入共享视觉、图片编辑、音乐和交付恢复。0.2.5 恢复旧宿主支持，0.2.6 增加连接引用、可选功能自动池和目录同步。准确版本及历史发行范围见 [兼容矩阵](DSH_COMPATIBILITY.md)。Node.js 最低 22.0.0；Core 内部 API 尚未冻结为公共 SDK。
 
 ## 当前形态
 
@@ -33,7 +33,9 @@ DSH Host / Cordis                         Headless CLI
                     CLI: explicit absolute data root
 ```
 
-`lib/index.js` 是 DSH 插件装配入口，`lib/dsh-host-adapter.js` 是原始 DSH/Cordis 对象进入 Iris 的服务端边界；`lib/dsh-core-adapter.js` 只负责选择 DSH profile 的 Core 数据根、恢复 Provider 配置和投影 Host DTO。`bin/dsh-iris.js` 不启动 DSH，也不推断 profile。`lib/api.js` 与 `lib/client.js` 是 Host 投影，不是真相来源。
+`lib/index.js` 是 DSH 插件装配入口，`lib/dsh-host-adapter.js` 是原始 DSH/Cordis 对象进入 Iris 的服务端边界；`lib/dsh-core-adapter.js` 负责 DSH 的 Core 实例装配、Provider 连接解析和 Host DTO 投影。`bin/dsh-iris.js` 不启动 DSH，也不推断 profile。`lib/api.js` 与 `lib/client.js` 是 Host 投影，不是真相来源。
+
+0.2.7 增加 `lib/application-runtime.js`，首批 CLI 图片命令和固定改图流程通过它装配 Core；[DSH 实例](DSH_RUNTIME.md)也已接入同一队列机制。写队列、操作取消和关闭归属于应用实例；每次写操作独立取得、释放 Core 租约，DSH 的 Core 观察器由插件实例持有并等待卸载。[固定流程](IMAGE_FLOW.md)使用专用根中的版本化 Run、稳定 Task/比较作品身份及引用保护，私有输入保存提示词，Task 仅保存可选流程绑定。[本地 API](LOCAL_API.md)已提供默认只读与主动启用的 [本地创建](LOCAL_CREATION.md)，执行/取消、通用 Recipe 和真实独立 Web 仍待完成。详见 [应用运行时契约](CORE_RUNTIME_CONTRACT.md#应用运行时装配)。上图表示已发布入口的共同核心。
 
 0.2.1的 S2V 使用 Core Task/Attempt，HTML 使用 `media.html` 与显式 Browser Port；视觉和提示词预览通过共享 Model Ports 执行。纯视觉不创建 Task/Artifact，摘要主动转写仍使用 Core 任务。聊天改图属于媒体生成链，按来源 Artifact ID 创建新 Task 和关联产物。
 
@@ -42,6 +44,8 @@ DSH Host / Cordis                         Headless CLI
 | 模块 | 职责 | DSH 运行时依赖 |
 |---|---|---:|
 | `core-contract.js` / `core-runtime.js` / `core-writer-lease.js`（0.2.2） | 显式数据根、reader/writer 权限、单写者租约、取消与释放 | 无 |
+| `application-runtime.js` | 实例写队列、操作输入快照与 Core 装配；首批由 CLI 消费 | 无 |
+| `flow-store.js` / `image-flow.js` | 专用根、私有 Run 输入、固定步骤绑定、原任务恢复与用户选择 | 无 |
 | `command-service.js` | 本地媒体命令、Task 控制面和 Artifact 查询/导出 | 无 |
 | `generation-input.js` | CLI、DSH 与重试共用的生成参数校验和 Provider 字段转换 | 无 |
 | `model-port-contract.js` / `model-invoker.js` | Text/Vision 内部契约、有限调用预算与取消 | 无 |
@@ -74,7 +78,9 @@ DSH Host / Cordis                         Headless CLI
 
 ## Provider 边界
 
-0.2.4将六类功能统一为严格有序分配名单：不补入全局池，临时指定只绑定名单内单项。DSH默认视觉为显式宿主资源，不作为隐式兜底；手动实测与旧任务恢复保持独立。配置格式、Core受理纪律与生产依赖保持。升级范围见 [功能模型分配](FUNCTION_MODEL_ASSIGNMENTS.md)。下方0.2.2描述保留当时能力声明变更的背景。
+0.2.6 的六类功能可选择自动池、仅用所选模型或停用。自动池只从已确认用途的模型中按稳定顺序选择，不授权目录新条目，也没有跨请求轮转；旧名单和缺失/空分配不自动启用。DSH 默认视觉仍需明确加入允许范围，手动实测与旧任务恢复保持独立。连接引用由 DSH Adapter 在操作期间解析，Core 不接收宿主凭据引用。详见 [功能模型池](FUNCTION_MODEL_POOLS.md)与 [连接复用](DSH_PROVIDER_CONNECTIONS.md)。
+
+0.2.4/0.2.5 的严格有序名单规则见 [功能模型分配](FUNCTION_MODEL_ASSIGNMENTS.md)。下方 0.2.2 描述保留当时能力声明变更的背景。
 
 0.2.2按功能组织有序模型候选池，能力来自明确模型标签、旧能力字段绑定或供应商能力元数据。裸账号不物化默认模型，模型名称不授权进入候选链；明确空池与空标签保持权威。模型与供应商复合身份用于底层执行器，功能入口、分配排序及安全 failover 没有改为模型中心产品或默认轮转。旧 0.2.1 的能力推断行为不再用于裸账号或模型名称赋能。
 

package/docs/CLI_MANAGEMENT.md

@@ -1,11 +1,13 @@
 # CLI 配置与任务管理
 
-本文面向 Iris 0.2.2，沿用 `dsh-iris` 入口，无需启动 DSH，未新增生产依赖。安装 `npm install @mokuyoaxis/dsh-iris@0.2.2` 后运行 `npx dsh-iris ...`；也可从源码或本地 tarball 使用同一入口。视觉命令见 [视觉 CLI](VISION_CLI.md)，基础媒体链路见 [Headless CLI](HEADLESS_CLI.md)。
+本文面向 Iris 0.2.7，沿用 `dsh-iris` 入口，无需启动 DSH。安装 `npm install @mokuyoaxis/dsh-iris@0.2.7` 后运行 `npx dsh-iris ...`；也可从源码或本地 tarball 使用同一入口。发布状态见 [README](../README.md)；视觉命令见 [视觉 CLI](VISION_CLI.md)，基础媒体链路见 [Headless CLI](HEADLESS_CLI.md)。
 
 所有需要 JSON 的命令均支持 `--input '<json>'`、`--input-file /path/input.json` 或 `--input -`（stdin），只能选择一种，输入最多 2 MiB。私有配置必须是普通文件、绝对路径，POSIX 权限为 `0600`。真实请求只由显式执行生成、发现、实测或观察命令触发。
 
 能力配置规则已同步Iris 0.2.2：能力来自明确配置或供应商元数据，裸账号和模型名称不自动赋能。现有功能入口、按功能分配的有序候选池和安全切换规则保持。
 
+0.2.6 的自动池会在新请求前按需读取目录（成功缓存 10 分钟），并跳过当前连接已明确返回模型不存在的候选。`models list`、`capabilities list`、配置检查和旧任务观察保持只读；`models discover --apply true` 显式更新目录并保留原模型，新发现用途仍需确认。手选、停用、显式单模型请求不暗中同步或扩池。`task retry` 先通过计费确认再刷新自动候选，旧任务不变；详见 [功能模型池](FUNCTION_MODEL_POOLS.md)。
+
 ## S2V 数字人视频
 
 ```bash
@@ -36,6 +38,8 @@ dsh-iris media html --data-root /path/core --input-file /path/html-input.json \
 
 0.2.4的六类功能均需明确分配；`assignments clear`停止新调用，已有Task仍按原绑定观察和补交付。临时指定须在名单内。旧自动池升级及DSH宿主资源见 [功能模型分配](FUNCTION_MODEL_ASSIGNMENTS.md)。
 
+0.2.6 支持 [三种功能池策略](FUNCTION_MODEL_POOLS.md)：现有 `assignments set` 的 JSON 可传 `mode`，`models add/caps` 可传 `enableAutomatic:true`。旧参数和已有分配行为保留；省略新字段不会自动改策略。
+
 | 命令 | 行为 |
 | --- | --- |
 | `config init/show/check` | 创建空私有配置（不覆盖）、脱敏查看、检查重复账号和失效分配 |

package/docs/CORE_RUNTIME_CONTRACT.md

@@ -1,6 +1,6 @@
 # Core Runtime v0 内部契约
 
-本文定义 Iris 0.2.2 沿用的 Core Runtime 内部接口，初版在 0.2.0 实现。内部接口在后续版本仍可能调整，npm 包不把它作为公开 API 导出；现有 `config.js`、`tasks.js` 和 `artifacts.js` 也尚未迁移。
+本文定义 Iris 0.2.x 沿用的 Core Runtime 内部接口，初版在 0.2.0 实现。内部接口在后续版本仍可能调整，npm 包不把它作为公开 API 导出；现有 `config.js`、`tasks.js` 和 `artifacts.js` 也尚未迁移。
 
 ## 目标与范围
 
@@ -72,6 +72,37 @@ created --start--> started --dispose--> disposing --finish-dispose--> disposed
 
 错误、Doctor 证据和 Command 输出不得包含 API Key、授权头、私有签名 URL 或不必要的本机绝对路径。Core 的 Artifact 结果使用稳定 ID 和中性元数据；HTTP/media URL、DSH attachment 与会话展示均由 Host Adapter 投影。
 
+## 应用运行时装配
+
+[application-runtime.js](../lib/application-runtime.js)是 0.3 的内部基础，复用上述 Core，不新增公开 export。实例显式接收数据根，以及可选的图片候选和既有任务 Adapter 解析函数；构造、状态查询和空闲期间不创建目录、持有租约或调用 Provider。首批 CLI 图片生成、图片导入、差异分析、作品查询/导出和单项 Task 查询已接入；DSH 的 Core 装配也已接入实例队列，其他 CLI 命令继续沿用原入口。
+
+- 同一应用实例的写操作按 FIFO 执行；每次写操作独立创建、释放 Core writer，普通失败原样返回，后续项继续。实例之间不共享队列或取消状态，跨进程写冲突仍返回 busy。
+- reader 独立于写队列，只读取已提交事实；它不调用配置解析函数或 Provider，不创建缺失数据根。并发写入时，多次读取不构成整个工作区的一致快照。
+- 排队输入保存为本次操作的快照。开始前取消跳过该项，不解析候选、不创建 Task；执行中取消传播到本次 Core。已经保存的结果按真实事实返回，未知受理不重新生成，本地中止不等于远端已取消。
+- `dispose()` 拒绝新操作和未开始项、中止活动操作，并等待业务回调和 Core 释放；重复调用返回同一个过程。租约释放失败时保留错误和现场，停止后续执行，不能报告关闭成功。
+
+首批执行面包括图片生成/改图、`artifact.import/inspect/list/export`、`media.diff`、`task.inspect/list`，以及显式 `task.observe/reobserve/redeliver/cancel`。观察每次至多一次 poll，没有后台轮询定时器；补交付复用原 Task/交付缓存，远端取消只有确认后才算成功。需要 Provider 时由入口注入解析函数，并按原 Task 的供应商、模型和 binding 核对；完整本地交付缓存不解析 Provider。
+
+应用运行时另装配 `flow.init/create/inspect/list/continue/select/export`，首版只提供 [固定改图流程](IMAGE_FLOW.md)。显式新根保存私有 Run 输入、预留 Task/比较 Artifact 身份和引用；Task 增加可选 `flowBinding`，旧记录不批量改写。已有 Attempt 后继续操作只核对原事实、观察或补交付，不重新 submit；完整异步 Flow 结果也先缓存，再按原 Artifact ID 交付。原图和流程作品/Task 同步纳入删除保护。通用 Recipe、API 执行/取消和 DSH Flow 界面仍待完成。
+
+## DSH Adapter 与实例装配的当前边界
+
+[dsh-host-adapter.js](../lib/dsh-host-adapter.js)从宿主公开服务构造附件、Browser、模型、连接和路由等端口；[dsh-core-adapter.js](../lib/dsh-core-adapter.js)选择 `irisHome()/core-v0`，将宿主输入转成共享 Command/Task Runner 调用，再投影为附件字节、媒体路由和任务展示。DSH 直接调用本地 Core，不经过独立 HTTP API。
+
+`apply(ctx)` 现在持有一个 `createDshRuntime({ dataRoot, getHost })`，工具、动作和工作台显式使用该实例；Core 写入共用上述 Application Runtime，连接端口引用、观察器和启动接管归实例所有。内部 `run(reader|writer, callback)` 允许 DSH 复合操作复用既有业务，不作为 HTTP 或公开 SDK。卸载拒绝新调用、取消并等待在途操作与租约释放；失败保留现场，旧观察回调不能影响新实例。详见 [DSH 实例运行时](DSH_RUNTIME.md)。
+
+legacy 配置/任务/作品、上传与 SSE 仍保留原机制，不宣称同进程多 profile 完整隔离。固定 Flow 未接入 DSH 工作台，新增本地请求区不会自动创建或迁移 DSH 日常根。
+
+## 显式本地 HTTP Host
+
+[local-api.js](../lib/local-api.js)由 CLI `api serve` 显式装配，只监听 loopback，默认使用已有 Flow 根与 reader 提供受控读取；构造不做 I/O，默认启动/关闭不持有 writer。默认路径只调用 `flow.list/inspect` 和作品只读入口，没有生成或远端观察 resolver。身份、Host/Origin、媒体限额与受控 DTO 属于该 Host 的边界，不借用 DSH 登录或通用 Command 转发；使用见 [只读本地 API](LOCAL_API.md)。
+
+I4B 在新空专用 Flow 根增加 `creation-requests/v0`，通过显式 `api init` 和 `--allow-local-writes` 开放 [本地上传/Run 创建](LOCAL_CREATION.md)。内部 [local-creation.js](../lib/local-creation.js)复用实例 FIFO，在一个 Core writer 中发布 prepared 意图、以预留身份提交作品/Run、标记 succeeded；已有 Run 允许进度推进，重放不覆盖。请求 store 无 HTTP/DSH/Runtime 依赖；新版 writer 检查未知/损坏格式，维护盘点保护未完成引用。成功结果删除后同 Key 不复活，现有 Task/Artifact/Run schema 保持。
+
+默认只读路径不取得 writer；显式本地写路径按操作取得 writer，只有配置解析 descriptor，没有生成/观察 Adapter。上传和创建都是本地提交，继续/选择/Operation/取消 API 仍待后续。旧 binary 没有请求区检查，新专用根只支持已验收的 request-aware writer；不宣称旧程序看到标记就会拒写，也不承诺断电跨文件事务。
+
+作品存储新增内部 `inspectCoreArtifactMetadata`，用于在读取大文件前验证清单与普通文件大小；该元数据入口不核验完整字节哈希，不能单独据此向外提供媒体。HTTP Host 在限额内继续使用 `readCoreArtifactBytes` 并复核已取字节的摘要，才返回图片。既有作品读取、持久化格式与内容哈希要求保持。
+
 ## 当前接口与后续范围
 
 0.2.3 增加同步完成结果的私有交付缓存：`task.redeliver` 可从原结果恢复，无需虚构远端 ID；完整字节离线交付，缺失字节只取回原 URL，不 submit。完整缓存可补回提交完成事实的中断，预留 Artifact ID 支持逐件重入；缓存与任务隔离/恢复一起管理。详见 [同步交付恢复](SYNC_DELIVERY_RECOVERY.md)。
@@ -80,7 +111,7 @@ created --start--> started --dispose--> disposing --finish-dispose--> disposed
 
 - `normalizeCoreOptions()`：规范化显式数据根和 reader/writer 模式；
 - `createCoreRuntime()`：管理写者租约、状态、`AbortSignal`、在途操作和 cleanup；
-- `createCommandService()`：提供 `crop`、只读 `task.list/task.inspect`、显式单步 `task.observe`/`task.reobserve`（同一份实现，`reobserve` 是人工触发观察的对外命令名）、人工重新交付 `task.redeliver`（只开放 outcome=succeeded / deliveryState=failed，异步使用一次带 redelivery 标志的 re-poll + 下载，同步结果使用原缓存，绝不 submit、绝不重新生成）、人工取消 `task.cancel`（只开放已受理未终态任务，只有 Provider 明确确认才写 canceled，不支持/无法确认保持真实状态）、人工重试为新任务 `task.retry`（只开放终态未成功交付任务；必须显式 confirm_billing 确认重复计费；新 Task 记录单向 retriedFrom 关系，候选链按宿主实况重新解析；Core 不持久化 Prompt，prompt 必须由调用方重新提供），以及 Artifact inspect/list/export/rebuild；Task reader 返回既有安全事实，不读取 Provider 配置，也不创建、修复或迁移记录；需联网的 `observe/reobserve/redeliver/cancel` 只接受宿主注入的 Adapter resolver；完整本地缓存的 redeliver 不解析 Provider，`retry` 只接受宿主注入的候选链 resolver，Core 不读取配置路径；Task capability覆盖image、video、tts、transcribe与music——交付按 `provider-task-runner.js` 的 DELIVERY_PROFILES 冻结（video：`video/mp4` + `generated-video`；tts/music：`audio/mpeg`/`audio/wav` + `generated-audio`，同步 completed 同次调用内交付；transcribe：`text/plain` + `transcript`，正文物化为 UTF-8 Artifact），不共用不准确的图片交付语义；
+- `createCommandService()`：提供 `crop`、只读 `task.list/task.inspect`、显式单步 `task.observe`/`task.reobserve`（同一份实现，`reobserve` 是人工触发观察的对外命令名）、人工重新交付 `task.redeliver`（只开放 outcome=succeeded / deliveryState=failed，已有缓存使用原结果，未缓存的异步任务使用一次带 redelivery 标志的 re-poll + 下载，绝不 submit、绝不重新生成）、人工取消 `task.cancel`（只开放已受理未终态任务，只有 Provider 明确确认才写 canceled，不支持/无法确认保持真实状态）、人工重试为新任务 `task.retry`（只开放终态未成功交付任务；必须显式 confirm_billing 确认重复计费；新 Task 记录单向 retriedFrom 关系，候选链按宿主实况重新解析；Task 不持久化 Prompt，prompt 必须由调用方重新提供），以及 Artifact inspect/list/export/rebuild；Task reader 返回既有安全事实，不读取 Provider 配置，也不创建、修复或迁移记录；需联网的 `observe/reobserve/redeliver/cancel` 只接受宿主注入的 Adapter resolver；完整本地缓存的 redeliver 不解析 Provider，`retry` 只接受宿主注入的候选链 resolver，Core 不读取配置路径；Task capability覆盖image、video、tts、transcribe与music——交付按 `provider-task-runner.js` 的 DELIVERY_PROFILES 冻结（video：`video/mp4` + `generated-video`；tts/music：`audio/mpeg`/`audio/wav` + `generated-audio`，同步 completed 同次调用内交付；transcribe：`text/plain` + `transcript`，正文物化为 UTF-8 Artifact），不共用不准确的图片交付语义；
 - 0.2.1 补齐 `media.diff/frames/html`、S2V 按候选上传、查询/批量管理与 Core 隔离/恢复；视觉和维护入口见 [CLI 管理](CLI_MANAGEMENT.md) 与 [视觉 CLI](VISION_CLI.md)。
 - Artifact Manifest v0：保存受控对象、SHA-256、关系边和可重建 Index，可跨 CLI 进程检查、导出和显式重建；Doctor 只报告孤立/未解析条目，不自动删除或修复。
 
@@ -88,7 +119,7 @@ created --start--> started --dispose--> disposing --finish-dispose--> disposed
 
 ## 非目标
 
-- 当前接口尚未作为 package export 或第三方 SDK 发布。0.2.0 的 F 阶段已正式决定：**不新增 `./core` 公开 export**——Root 插件与 `bin/dsh-iris` CLI 承载全部对外能力，内部模块（core-runtime、core-tasks、command-service、provider-task-runner、core-artifact*、core-user-projection）保持私有，可在 minor 版本间调整；冻结为公开 export 的决策顺延到 M2（0.3.0）的 Recipe/Serve 边界定稿后再审。届时一旦公开即写兼容策略与 semver 边界；
-- 不提供 standalone 服务、账号、多租户或额外监听端口；
-- 不预建缺少实际需求的 Provider 协议；收藏、标签、搜索与 Flow/Recipe 留待后续；
+- 当前接口尚未作为 package export 或第三方 SDK 发布。0.2.0 的 F 阶段已决定**不新增 `./core` 公开 export**：Root 插件与 `bin/dsh-iris` CLI 承载对外能力，内部模块保持私有，可在后续版本调整。按 [现行路线图](ROADMAP.md#03-及以后)，公开 Provider/Host SDK 在 0.4 有真实消费者后再评估；0.3 的 Recipe/API 实现不自动构成公开 SDK 或兼容承诺。
+- Core 本身不启动监听；0.2.7 的 HTTP Host 由用户显式启动，默认只读、本地创建另行启用，不建设账号、多租户或公网 SaaS；
+- 不预建缺少实际需求的 Provider 协议；收藏、标签、搜索与通用 Flow/Recipe 留待后续；
 - 不把 0.1.4 的模块级存储包装成实例存储，也不允许 CLI 与 DSH 无租约并发写同一数据根。