@mokuyoaxis/dsh-iris 0.1.4 → 0.2.1

package/docs/assets/logo/iris-mark-mono.svg

@@ -0,0 +1,42 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="88" height="96" viewBox="-8 -8 88 96" role="img" aria-label="IRIS 图形标（单色）" shape-rendering="crispEdges">
+  <title>IRIS 图形标（单色）</title>
+  <desc>像素块鸢尾花图形标，单色墨</desc>
+  <rect x="32" y="0" width="8" height="8" fill="#1E1E24"/>
+  <rect x="24" y="8" width="8" height="8" fill="#1E1E24"/>
+  <rect x="32" y="8" width="8" height="8" fill="#1E1E24"/>
+  <rect x="40" y="8" width="8" height="8" fill="#1E1E24"/>
+  <rect x="16" y="16" width="8" height="8" fill="#1E1E24"/>
+  <rect x="24" y="16" width="8" height="8" fill="#1E1E24"/>
+  <rect x="32" y="16" width="8" height="8" fill="#1E1E24"/>
+  <rect x="40" y="16" width="8" height="8" fill="#1E1E24"/>
+  <rect x="48" y="16" width="8" height="8" fill="#1E1E24"/>
+  <rect x="16" y="24" width="8" height="8" fill="#1E1E24"/>
+  <rect x="24" y="24" width="8" height="8" fill="#1E1E24"/>
+  <rect x="32" y="24" width="8" height="8" fill="#1E1E24"/>
+  <rect x="40" y="24" width="8" height="8" fill="#1E1E24"/>
+  <rect x="48" y="24" width="8" height="8" fill="#1E1E24"/>
+  <rect x="0" y="32" width="8" height="8" fill="#1E1E24"/>
+  <rect x="24" y="32" width="8" height="8" fill="#1E1E24"/>
+  <rect x="32" y="32" width="8" height="8" fill="#1E1E24"/>
+  <rect x="40" y="32" width="8" height="8" fill="#1E1E24"/>
+  <rect x="64" y="32" width="8" height="8" fill="#1E1E24"/>
+  <rect x="0" y="40" width="8" height="8" fill="#1E1E24"/>
+  <rect x="8" y="40" width="8" height="8" fill="#1E1E24"/>
+  <rect x="24" y="40" width="8" height="8" fill="#1E1E24"/>
+  <rect x="32" y="40" width="8" height="8" fill="#1E1E24"/>
+  <rect x="40" y="40" width="8" height="8" fill="#1E1E24"/>
+  <rect x="56" y="40" width="8" height="8" fill="#1E1E24"/>
+  <rect x="64" y="40" width="8" height="8" fill="#1E1E24"/>
+  <rect x="8" y="48" width="8" height="8" fill="#1E1E24"/>
+  <rect x="16" y="48" width="8" height="8" fill="#1E1E24"/>
+  <rect x="32" y="48" width="8" height="8" fill="#1E1E24"/>
+  <rect x="48" y="48" width="8" height="8" fill="#1E1E24"/>
+  <rect x="56" y="48" width="8" height="8" fill="#1E1E24"/>
+  <rect x="16" y="56" width="8" height="8" fill="#1E1E24"/>
+  <rect x="24" y="56" width="8" height="8" fill="#1E1E24"/>
+  <rect x="32" y="56" width="8" height="8" fill="#1E1E24"/>
+  <rect x="40" y="56" width="8" height="8" fill="#1E1E24"/>
+  <rect x="48" y="56" width="8" height="8" fill="#1E1E24"/>
+  <rect x="32" y="64" width="8" height="8" fill="#1E1E24"/>
+  <rect x="32" y="72" width="8" height="8" fill="#1E1E24"/>
+</svg>

package/docs/assets/logo/iris-mark.svg

@@ -0,0 +1,42 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="88" height="96" viewBox="-8 -8 88 96" role="img" aria-label="IRIS 图形标（彩色）" shape-rendering="crispEdges">
+  <title>IRIS 图形标（彩色）</title>
+  <desc>像素块鸢尾花图形标，带一格留白，紧凑图标与 App 角标适用</desc>
+  <rect x="32" y="0" width="8" height="8" fill="#8C77EE"/>
+  <rect x="24" y="8" width="8" height="8" fill="#8C77EE"/>
+  <rect x="32" y="8" width="8" height="8" fill="#8C77EE"/>
+  <rect x="40" y="8" width="8" height="8" fill="#8C77EE"/>
+  <rect x="16" y="16" width="8" height="8" fill="#8C77EE"/>
+  <rect x="24" y="16" width="8" height="8" fill="#8C77EE"/>
+  <rect x="32" y="16" width="8" height="8" fill="#8C77EE"/>
+  <rect x="40" y="16" width="8" height="8" fill="#8C77EE"/>
+  <rect x="48" y="16" width="8" height="8" fill="#8C77EE"/>
+  <rect x="16" y="24" width="8" height="8" fill="#8C77EE"/>
+  <rect x="24" y="24" width="8" height="8" fill="#8C77EE"/>
+  <rect x="32" y="24" width="8" height="8" fill="#8C77EE"/>
+  <rect x="40" y="24" width="8" height="8" fill="#8C77EE"/>
+  <rect x="48" y="24" width="8" height="8" fill="#8C77EE"/>
+  <rect x="0" y="32" width="8" height="8" fill="#3F32A8"/>
+  <rect x="24" y="32" width="8" height="8" fill="#8C77EE"/>
+  <rect x="32" y="32" width="8" height="8" fill="#8C77EE"/>
+  <rect x="40" y="32" width="8" height="8" fill="#8C77EE"/>
+  <rect x="64" y="32" width="8" height="8" fill="#3F32A8"/>
+  <rect x="0" y="40" width="8" height="8" fill="#3F32A8"/>
+  <rect x="8" y="40" width="8" height="8" fill="#3F32A8"/>
+  <rect x="24" y="40" width="8" height="8" fill="#8C77EE"/>
+  <rect x="32" y="40" width="8" height="8" fill="#F0B23E"/>
+  <rect x="40" y="40" width="8" height="8" fill="#8C77EE"/>
+  <rect x="56" y="40" width="8" height="8" fill="#3F32A8"/>
+  <rect x="64" y="40" width="8" height="8" fill="#3F32A8"/>
+  <rect x="8" y="48" width="8" height="8" fill="#3F32A8"/>
+  <rect x="16" y="48" width="8" height="8" fill="#3F32A8"/>
+  <rect x="32" y="48" width="8" height="8" fill="#F0B23E"/>
+  <rect x="48" y="48" width="8" height="8" fill="#3F32A8"/>
+  <rect x="56" y="48" width="8" height="8" fill="#3F32A8"/>
+  <rect x="16" y="56" width="8" height="8" fill="#3F32A8"/>
+  <rect x="24" y="56" width="8" height="8" fill="#3F32A8"/>
+  <rect x="32" y="56" width="8" height="8" fill="#4A9E6F"/>
+  <rect x="40" y="56" width="8" height="8" fill="#3F32A8"/>
+  <rect x="48" y="56" width="8" height="8" fill="#3F32A8"/>
+  <rect x="32" y="64" width="8" height="8" fill="#4A9E6F"/>
+  <rect x="32" y="72" width="8" height="8" fill="#4A9E6F"/>
+</svg>

package/docs/file-access-across-environments.md

@@ -1,16 +1,19 @@
 # 文件访问与跨环境
 
-Iris 可以从浏览器上传、会话附件或宿主文件路径读取媒体。三种方式适合的场景不同；如果不确定，优先使用上传。
+Iris 0.2.1 可以从 Core Artifact ID、浏览器上传、会话附件或宿主文件路径读取媒体。已有 Core 作品优先使用 ID；外部文件按实际环境选择上传、附件或路径。
 
 ## 推荐顺序
 
-1. **浏览器上传**
+1. **Core Artifact ID**
+   看图、OCR、定位和聊天改图可直接使用已有图片/帧的 `artifact_id`，无需复制路径或先导出文件。按 ID 看图/OCR 会核验原始字节、MIME 和 SHA-256；PNG、JPEG、WebP 均可直接输入。CLI 需显式 `--data-root`，见 [视觉 CLI](VISION_CLI.md)。摘要还可复用 `frame_artifact_ids`。
+
+2. **浏览器上传**
    适合图片、音频和中小型视频。文件内容会传到运行 DeepSeek Harness 的宿主，因此不要求浏览器和宿主共享文件系统。
 
-2. **会话附件**
+3. **会话附件**
    适合复用当前会话中已有的图片或 Iris 生成的产物。附件引用比手动复制路径更稳定。
 
-3. **宿主路径**
+4. **宿主路径**
    适合宿主本地的大文件，可以避免再次复制。路径必须从宿主进程的视角填写，浏览器能看到并不代表宿主也能读取。
 
 ## 环境差异
@@ -21,7 +24,7 @@ Iris 可以从浏览器上传、会话附件或宿主文件路径读取媒体。
 | 原生 Windows | 上传、附件或宿主路径 | 使用 Windows 绝对路径，例如 `C:\Media\video.mp4` |
 | WSL | 优先上传或附件 | Windows 文件在 WSL 中通常映射为 `/mnt/c/...`，不能直接使用 Windows 路径 |
 | 容器或远程宿主 | 上传或附件 | 浏览器本地路径通常对远端进程不可见 |
-| Android + PRoot | 优先上传 | 共享存储是否可读取决于挂载方式和 Android 权限 |
+| Android + PRoot | 优先上传 | 共享存储是否可读取取决于挂载方式和 Android 权限 |
 
 浏览器文件选择器交给 Iris 的是文件内容，而不是一个可供宿主读取的本地路径。因此，它也适用于 WSL、远程部署和 Android 文件选择器返回 `content://` URI 的情况。
 

package/docs/releases/0.2.0.md

@@ -0,0 +1,48 @@
+## Iris Media for DSH 0.2.0
+
+Iris 0.2.0 brings the media runtime to the command line and adapts the DSH plugin to DeepSeek Harness `0.2.0-rc.2`. The npm package remains `@mokuyoaxis/dsh-iris`.
+
+### Highlights
+
+- Run crop, image diff, video frame extraction, image/video/speech generation and transcription without DSH. Inspect, observe and export tasks and artifacts across CLI processes.
+- Share Core Task, Attempt and Artifact facts between the CLI, DSH tools and the workbench. Core owns the explicit data root, single-writer lease, lifecycle, cancellation and orderly shutdown.
+- Add Artifact Manifest v0 with content hashes, relationships, a rebuildable index and orphan recovery. Core records keep prompts, credentials and private URLs out of durable task history.
+- Share task controls across the CLI, API and workbench: observe again, redeliver, cancel where supported, and retry as a new task with explicit billing confirmation. Accepted or uncertain submissions never trigger automatic resubmission.
+- Add read-only provider/capability listings, Core Doctor and explicit stale-writer recovery. Keep old task data intact; this release does not rewrite 0.1.4 storage in place.
+- Preserve complete DSH attachment references, bind image-capable vision routes explicitly, handle stream errors, and follow rc.2 client main-view selection.
+- Replace the floating bubble's pixel silhouette with a curved iris SVG, keeping existing status and interaction behavior.
+- Publish bilingual agent quickstart prompts and separate installation instructions for current and older hosts.
+
+### Compatibility and upgrade
+
+- Node.js: `>=22.0.0`.
+- DSH plugin: **exactly `0.2.0-rc.2`**, including the five optional client peers. Other rc versions and DSH 0.2.0 stable have no compatibility claim.
+- Older DSH `>=0.1.2-rc.1 <0.1.3-0` or `0.1.5-rc.1`: keep using `@mokuyoaxis/dsh-iris@0.1.4`. Its historical Node minimum remains 20.10.0; do not follow npm latest on those hosts.
+- Headless CLI: no DSH installation required. Video frame extraction needs `ffmpeg` and `ffprobe`.
+- In dsh-market, check the full scoped package name, displayed version and host requirements. Marketplace caches may lag npm; a visible listing is not a compatibility guarantee.
+
+Install on DSH rc.2:
+
+```bash
+dsh plugin --profile web add @mokuyoaxis/dsh-iris@0.2.0
+dsh web
+```
+
+For the CLI in your own project:
+
+```bash
+npm install @mokuyoaxis/dsh-iris@0.2.0
+npx dsh-iris --help
+```
+
+Download the older stable package separately with `npm pack @mokuyoaxis/dsh-iris@0.1.4`.
+
+### Verification and current limits
+
+Release checks cover 123 test files, Ubuntu and Windows on Node 22.0.0 and current Node 22, repeated minimum-version shutdown regressions, an isolated packed-package consumer without DSH, and isolated checks against installed rc.2 host services.
+
+These checks do not establish complete personal-profile restart/rollback, every paid-provider path, native Windows DSH usage, or every Android browser action. Detailed boundaries remain in [the rc.2 adaptation notes](https://github.com/mokuyoaxis/dsh-iris/blob/v0.2.0/docs/DSH_RC2_ADAPTATION.md) and [the migration notes](https://github.com/mokuyoaxis/dsh-iris/blob/v0.2.0/docs/DSH_CORE_MIGRATION.md). Core internals and Model Port are not a frozen public SDK. The CLI observes one step at a time; it does not start a background service. Core Task/Artifact deletion is not exposed in this release.
+
+Generation and transcription may consume provider quota or incur charges. The repository and package naming transition will follow a second real Host Adapter, with a new npm package at that point.
+
+Full changelog: https://github.com/mokuyoaxis/dsh-iris/compare/v0.1.4...v0.2.0

package/docs/releases/0.2.1.md

@@ -0,0 +1,56 @@
+## Iris Media for DSH 0.2.1
+
+Iris 0.2.1 completes the OpenAI-compatible image and vision workflow: image generation → Core Artifact → vision/OCR by ID → chat editing → new Artifact. Model discovery and capability classification, per-model protocols and shared artifact management bring this workflow to both the CLI and DSH workbench. The package remains `@mokuyoaxis/dsh-iris`.
+
+### Highlights
+
+- Choose an image protocol per model: native DashScope, OpenAI Images, gateway chat image generation, or Responses image generation. Models within one account can use different interfaces while keeping routing, health evidence and task bindings separate.
+- Preserve generated PNG, JPEG and WebP bytes with matching MIME types, extensions and content hashes. Fix base64 validation that could overflow the stack on large 4K image responses.
+- Edit an existing Core image by Artifact ID through `iris_edit_image`, a workbench image card, or CLI `run image` with `source_artifact_id`. Chat image models create a new Artifact with a `derived-from` relationship; the source stays intact and remains protected by task references.
+- Run `vision look / locate / ocr / summarize` without DSH, with explicit model selection and JSON, text or file output. Look, OCR and locate accept image Artifact IDs; summaries reuse existing frame Artifacts without the original video or another ffmpeg pass.
+- Set account and model input budgets. Look, OCR chunks, locate and chat editing prepare sending copies when necessary, using an 8 MiB default budget while preserving Core originals. OCR reports resized inputs; locate maps normalized coordinates and EXIF orientation back to original pixels.
+- Browse Core and legacy media together with pagination, filters, details and explicit selection across pages. Copy IDs, download a mixed-source ZIP, or preview and confirm recoverable Core deletion. Restore checks hashes and refuses conflicting destinations.
+- Complete CLI support for S2V video, restricted HTML screenshots, provider/model/configuration management, bounded task waiting, filtered queries, bulk export and recoverable Core maintenance.
+- Distinguish temporary 429 cooldown from confirmed quota or budget exhaustion. Amber cooldown expires into candidate eligibility without an automatic probe. Red exhaustion blocks the model across restarts until a manual model test succeeds.
+- Use shared Text/Vision Model Ports for prompt previews and visual operations, with complete-result checks, shared deadlines and cancellation. Composer previews also gain per-operation rules, assembly without a model call and editable comparisons.
+
+### Compatibility and upgrade
+
+- Node.js: `>=22.0.0`.
+- DSH plugin: **exactly `0.2.0-rc.2`**. No compatibility claim is added for other rc versions or DSH 0.2.0 stable.
+- Older supported DSH hosts should keep `@mokuyoaxis/dsh-iris@0.1.4`.
+- Headless CLI requires no DSH installation. Video-file frame extraction requires ffmpeg/ffprobe; HTML screenshots require an explicitly configured Chromium executable.
+- Configuration remains v1 with optional per-model settings. No production dependency or public SDK export is added.
+
+Install the pinned package on DSH rc.2:
+
+```bash
+dsh plugin --profile web add @mokuyoaxis/dsh-iris@0.2.1
+```
+
+Or install the CLI in your project:
+
+```bash
+npm install @mokuyoaxis/dsh-iris@0.2.1
+npx dsh-iris --help
+```
+
+After updating a DSH plugin, reload the backend and refresh the web client. Older supported hosts should keep the pinned 0.1.4 release.
+
+### Verification and limits
+
+Verification covers 163 test files, lint over 263 source files, an actual tarball installed outside the repository without DSH, and 31 isolated checks against installed DSH rc.2 services. Live checks also exercised gateway image generation, Artifact-ID vision, and chat edits delivered through DSH and the workbench while preserving source hashes.
+
+Browser/mobile acceptance of the complete work-library flow and asynchronous restart with CLI takeover remain open. These checks are not inferred from automated tests or isolated host-service checks.
+
+Responses image generation currently supports synchronous single-image requests. Chat image generation/editing is a gateway extension to Chat Completions, not a claim that every OpenAI-compatible chat service supports images. Editing accepts one static PNG/JPEG/WebP Artifact; masks, multiple references and conversation edit history are not implemented. Image detail, edit fidelity and output resolution depend on the selected service.
+
+OpenAI-compatible image and vision support does not add generic video, TTS, transcription or music protocols. Core deletion is recoverable quarantine, with no permanent purge; legacy work deletion retains its existing permanent behavior. Accepted or uncertain generation never automatically resubmits. Core and Model Port internals remain outside a frozen public SDK.
+
+### Future plans
+
+Extend support to other protocols and add music generation, building on Core tasks, Artifacts and work-library management. These are planned follow-up features and are not included in 0.2.1; see the [roadmap](https://github.com/mokuyoaxis/dsh-iris/blob/v0.2.1/docs/ROADMAP.md#后续功能方向).
+
+Full scope: [CHANGELOG](https://github.com/mokuyoaxis/dsh-iris/blob/v0.2.1/CHANGELOG.md), [CLI management](https://github.com/mokuyoaxis/dsh-iris/blob/v0.2.1/docs/CLI_MANAGEMENT.md), [workbench artifacts](https://github.com/mokuyoaxis/dsh-iris/blob/v0.2.1/docs/WORKBENCH_ARTIFACTS.md), and [roadmap](https://github.com/mokuyoaxis/dsh-iris/blob/v0.2.1/docs/ROADMAP.md).
+
+Full changelog: [v0.2.0…v0.2.1](https://github.com/mokuyoaxis/dsh-iris/compare/v0.2.0...v0.2.1).