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

package/CHANGELOG.md

@@ -4,6 +4,67 @@
 
 ## [Unreleased]
 
+## [0.3.0-beta.1] - 2026-11-05
+
+- 最低Node提高到22.1.0，并对齐包声明、Doctor及CI；隔离复现22.0.0原生fetch正文取消不关闭连接的问题，避免调度名额遗留。Windows Provider模板验收采用受控IPC递送正常关闭事件，保留真实CLI清理和原任务重启检查。
+
+首个0.3 beta：在alpha.1工作台、MCP与插件基础上，新增网络出口池与Doctor、有界并发调度、固定文生视频、环境凭据引用和独立插件模板，并收口主要流程及最小插件契约。使用npm `beta`通道，稳定`latest`保留0.2.7；旧根不自动迁移。见[发行说明](docs/releases/0.3.0-beta.1.md)。
+
+- 修复DSH连接引用可叠加媒体地址的问题，解析出的凭据只发送到宿主提供的端点；引用供应商不再显示媒体地址编辑器。无效来源组合读取时报错并保留文件，null等非法地址/密钥编辑在写入前拒绝。工作流报告同时脱敏属性名和字符串值；目录中包含完整Key的模型ID整份拒绝，不改写为虚构模型，短测试Key重合也适用。
+- 视频候选统一区分已知t2v/i2v/s2v/r2v输入家族，固定文生视频流程拒绝已知非t2v模型，未知兼容ID保留既有路径。修复来源转写Task重试误要求改图输入；明确提供新音频URL和费用确认后创建新Task，旧Flow和来源保持。
+- 索引重建/刷新失败保留dirty状态；新提交对已索引legacy作品复用已有摘要，不再读取其媒体，缺少摘要时要求显式重建。DSH快照复用元数据目录，单个坏作品不再清空正常作品。坏Task时调度观测返回计数不可用，提交准入继续严格检查，通知等待者的读错误不升级为无关写者释放失败。
+- 修正DSH浏览器入口的类型声明：`/client`提供工厂形状的`DshClientPlugin`类型，运行时继续通过宿主ModuleLoader注册，不声明不存在的Node默认导出。总览分别显示音频/视频工作区限制，补旧根、v3/v4及只读/执行状态的浏览器检查。
+
+- DSH HTML截图在保存前确认本次页面已由Iris渲染路由返回，未挂载、错误服务或仅HEAD不再凭PNG记成功；不增加探测请求或浏览器接口。进度区与泡泡共享Core活动快照，区分运行/观察暂停/待处理并遵守提醒处置；早期Core作品单列兼容提示，不自动迁移或哈希整库。旧视觉SSE兼容入口补齐累计2 MiB及取消/超时失败，保留主业务Model Port的严格完成语义。
+
+- MCP HTTP增加实例级4条消息的共享预算，覆盖正文读取到媒体响应排空；兼容路径的批量请求逐条计数，单批最多4条。繁忙返回429与Retry-After，不排队或自动重提；单正文9 MiB、既有媒体限额和Core原任务恢复保持。见[MCP HTTP](docs/MCP.md#http填写-url-和认证)。
+
+- 修复网络配置/代理凭据轮换后旧客户端一直保留到服务关闭的问题：后续解析替换旧缓存，停止旧客户端接收新操作，等完整正文和后续请求结束再释放连接池；实例关闭同时排空正在退役的客户端，清理失败仍报错。
+
+- 修复固定视频流程整读后才检查32 MiB，以及内联/缓存交付绕过媒体限额的问题；超限保留生成成功事实，不重新提交。DSH媒体GET改用流式发送，HEAD保留分块哈希校验且不整读。作品提交不再重哈希整个图库，索引失败/中断明确提示重建，原Task/Artifact和既有持久格式保持。
+
+- 补齐持久供应商的内联/env/DSH来源互斥，非法混存拒绝读取和保存，DSH合法内存解析副本保持可用。工作流检查在JSON编码前递归脱敏，覆盖转义凭据、嵌套选项与检查期间环境轮换。Retry-After及毫秒冷却提示有界处理，避免极端值掩盖原429；不迁移旧配置或任务。
+
+- 修复独立Flow CLI缺少音视频首次候选装配：创建不生成，继续沿原Run/Task执行或观察。转写本地音频在取得写权、保存原Attempt后按实际账号上传，上传取消停止候选链；根忙零上传。视频重试要求明确`video_mode`并重新提供对应媒体，DSH简化入口仅显式创建文生视频，防止旧图生/数字人输入丢失后静默降级；不迁移Task或扩大固定视频Flow范围。
+
+- 修复DSH启动接管旧任务时遗漏连接引用解析：保留原协议和远端ID，连接暂不可用不再把v1任务误判失败；关闭时排空解析，凭据不落盘。Core恢复同时补齐已明确未受理、最终失败尚未落盘的中断状态，沿原Attempt收口，不继续候选或重复生成。
+
+- 修复已接收Operation的写入排队超时/满员会拖垮整个执行服务的问题：单项失败持久保存、其他工作继续，短终态写入安全排空；真实存储/清理故障仍保留租约。内置媒体提交禁止自动跟随重定向，保持原受理未知且不切换候选重发；正常媒体下载继续可用。
+
+- Core原生改图/转写创建统一检查来源作品授权，HTTP/MCP及原Key接回不再借创建绕过来源读取限制；保留已授权的共享图片及无绑定导入规则，创建不上传、不生成。
+
+- 修复显式直连/代理传输中的原生 `FormData` 与 `Request` 互操作：上传保留 multipart 字段、文件和长度，Request 保留覆盖参数、正文、重定向与取消；不修改全局 fetch 或重放失败请求。补充真实本地 CONNECT 与调度回归。
+
+- 修复百炼文生视频尺寸分隔符：Core/工作台常用的 `832x480` 在DashScope传输时转换为厂商要求的 `832*480`，保留原Run输入与身份；已失败的远端任务不自动重提。
+
+- 修复真实百炼TTS暴露的WAV字节被记录为MP3的问题：新音频交付按有限文件头确认MIME和后缀，保留原字节，生成结果可直接作为转写来源；无效响应仅标记交付失败，不重新合成，不改写已有作品。供应商工厂的已知配置错误返回安全400，保留关联诊断；更新网络端口迁移后过期的lint守卫。
+
+- 整理[beta支持范围与兼容约定](docs/BETA_SCOPE.md)，明确最小插件面、主要用户入口、数据门禁和平台/真实账号证据的区别；发行按beta渠道，平台矩阵按同一提交核销。旧万相视频模型的官方参考指向legacy协议页。
+
+- 新增独立[万相 Provider 模板](templates/provider-starter/README.md)与[最小契约审查](docs/PROVIDER_PLUGIN_CONTRACT.md)：统一工厂接收 v1 只读上下文、当次解析的凭据及 Core 借出的 fetch；Core 管理完整正文/多跳、调度和关闭，旧窄扩展用法保留。模板实现公开异步协议，显式确认目录/模型池，经普通媒体 MCP 使用并恢复原任务；已完成受控接口验收及百炼北京 wan2.6-t2i 单账号真实交付，不代表全部账号或已发布 alpha.1 支持。
+
+- 新增显式[有界媒体调度](docs/MEDIA_SCHEDULING.md)：`api/web serve --scheduler-config` 保留单根单写者，媒体网络等待可并行，短写入串行接回；HTTP正文并发、滚动派发RPS与远端未结束Task分控，供应商/模型可进一步限制。模型冷却先等候，逐项取消、原Task恢复与未知受理不重提；Operation短接收不再等待整次网络，Web显示临时等待原因。缺省仍串行，未知插件业务保持独占，无新依赖、自动迁移或日常重启。
+
+- Core新增[网络出口页与Doctor](docs/NETWORK_WORKBENCH.md)：独立owner开关、节点/池/供应商绑定、候选排序、编辑取消与引用保护，沿用私有文件和CAS，不自动迁移旧配置。供应商/功能池显示配置出口，原任务显示已记录路线；静态检查来自实际Core进程，明确点击后才进行一次有界、无Provider Key的GET和可选IP观察，支持取消、区分上游状态与未知TUN。普通MCP不获得资源/环境或检测权限，未修改日常代理、依赖或核心存储格式。
+
+- 新增[供应商出口绑定与HTTP/HTTPS代理](docs/NETWORK_ROUTING.md)：显式新v2网络文件与Provider目录包装、固定/有序出口、未绑定继承环境；实例使用Undici7.30.1，不改全局代理或系统路由。只在业务发送前的连接预检选择备选，收到POST后断线保持受理未知、不换出口/模型重发；Task3与Flow从首次保存记录网络要求和派发路线，Core存储失败停止出站。受控真实代理、原任务跨Node进程换允许出口恢复、CLI/API和实际包验证通过；旧文件/任务不自动迁移，公开网络SDK继续后续。
+
+- 新增[出口节点与池资源管理](docs/NETWORK_RESOURCES.md)：独立显式私有文件及本地owner CLI，HTTP/HTTPS地址、认证环境引用、固定/有序候选与空池草稿、启停/引用删除保护、版本与字节修订门禁、写前备份和原子替换。资源命令不联网、不启用路由；供应商绑定、实际路由和上述Doctor单独显式启用。
+
+- 增加[Provider实例级出站网络基础](docs/PROVIDER_NETWORK.md)：内置媒体适配器、模型目录及共享候选/原Task装配可注入独立客户端，跟踪完整正文、多跳上传和下载后再关闭，保留同步错误映射。未配置保持原联网行为，显式请求失败不隐式回退；上传和转写错误响应释放正文，下载在出站前准备本地目录，避免存储失败留下未读响应。基础端口不切换全局代理，资源与实际路由由上述独立增量提供。
+
+- 修复凭据引用复查发现的摘要脱敏与目录导入遗漏：长 Key 在展示字段中先脱敏再截断；CLI/注册协议/旧目录刷新拒绝把上游直接回显的认证值导入为模型 ID，保持原配置/完整缓存，并按实际请求捕获值处理失败消息。HTTP/CLI提供明确的安全错误码。
+
+- 新增可选[供应商环境凭据引用](docs/PROVIDER_CREDENTIALS.md)：Web/CLI 显式保存 `apiKeyEnv` 名称，区分未就绪/已就绪/值无效，调用内存解析与精确脱敏；保留原内联 Key、owner 管理权限和旧 Task 绑定，轮换后查询原任务，不增加环境读取 MCP 工具、不自动读取 `.env` 或迁移配置。已发布 alpha.1 尚不包含此功能。
+
+- 新增[独立插件模板与开发说明](docs/PLUGIN_DEVELOPMENT.md)：独立身份/版本的真实图片业务复用公开对照板实现，贡献 Web 页面和 PNG 预览器；新目录初始化、明确启用/授权、原 UUID 恢复及包外自检，不新增 Core 接口或生产依赖。模板随beta.1分发，旧alpha.1不包含该目录。
+
+- Core Web/MCP 新增[固定文生视频流程](docs/VIDEO_FLOWS.md)：显式新 v4 根、实际模型候选和尺寸/时长、原 Run/Task/Operation 恢复、本地停止、视频作品分类及 MP4/WebM（≤32 MiB）播放下载；MCP 由用户选择 video-generate，标准资源引用/读取逐次校验授权，连接 Skill 同步生成指导。旧根/旧授权不迁移扩权；受控回归之外，另完成百炼北京 wan2.2-t2v-plus（832×480、5秒）真实单例的原任务重启接回、MCP及Web播放下载验收，不代表其他上游或客户端均已验证。此功能随beta.1分发。
+
+- Core 客户端页串起选择/授权、配置导出和接入核对，增加授权摘要、同/异机提示及草稿保护。配置生成、Iris 端只读配置检查、客户端握手/可选声明分开记录；检查不建立桥或调用模型，工具范围来自实际目录与 scopes，历史和自检不冒充 Agent 接入。切页/退出取消读取并清除私有预览，迟到复制不覆盖新页面；未增加 API、权限或持久格式。见 [MCP 连续接入](docs/MCP.md#工作台连续接入当前源码)。
+
+- 默认 Core 工作台新增只读“插件”页，集中展示加载身份/版本、Core 兼容范围、五类贡献、实际业务与页面启用、准确客户端授权和握手记录；区分缺失版本、权限缩减、未选择调用工具和撤销。目录或授权读取失败分别显示，详情默认折叠；查看和重新读取不执行业务、测试模型或自动授权。启用继续使用[明确启动配置](docs/PLUGIN_STARTUP.md#查看插件状态当前源码)。
+
 ## [0.3.0-alpha.1] - 2026-10-30
 
 0.3 首个预发布：独立 Core 工作台、通用 MCP 和显式插件贡献与原 DSH/CLI 共用持久执行和作品。通过 `alpha` 通道获取，稳定 `latest` 保留 0.2.7；现有数据根不自动迁移。范围、入口与限制见 [发布说明](docs/releases/0.3.0-alpha.1.md)。
@@ -460,7 +521,8 @@ Iris 0.2.0 要求 Node.js ≥ 22.0.0，DSH 插件仅支持 `0.2.0-rc.2`；旧宿
 - 上传采用流式限额、临时 `.part` 文件和原子落盘，失败时会清理未完成文件。
 - 修改状态的路由拒绝明确的跨站请求，媒体文件继续使用随机能力令牌访问。
 
-[Unreleased]: https://github.com/mokuyoaxis/dsh-iris/compare/v0.3.0-alpha.1...HEAD
+[Unreleased]: https://github.com/mokuyoaxis/dsh-iris/compare/v0.3.0-beta.1...HEAD
+[0.3.0-beta.1]: https://github.com/mokuyoaxis/dsh-iris/compare/v0.3.0-alpha.1...v0.3.0-beta.1
 [0.3.0-alpha.1]: https://github.com/mokuyoaxis/dsh-iris/compare/v0.2.7...v0.3.0-alpha.1
 [0.2.7]: https://github.com/mokuyoaxis/dsh-iris/compare/v0.2.6...v0.2.7
 [0.2.6]: https://github.com/mokuyoaxis/dsh-iris/compare/v0.2.5...v0.2.6

package/README.en.md

@@ -12,21 +12,21 @@
 
 <p align="center">
   <a href="https://www.npmjs.com/package/@mokuyoaxis/dsh-iris"><img alt="npm version" src="https://img.shields.io/npm/v/%40mokuyoaxis%2Fdsh-iris.svg?style=flat-square"></a>
-  <a href="https://nodejs.org/"><img alt="Node.js 22 or newer" src="https://img.shields.io/badge/Node.js-%3E%3D22-339933.svg?style=flat-square&amp;logo=nodedotjs&amp;logoColor=white"></a>
+  <a href="https://nodejs.org/"><img alt="Node.js 22.1.0 or newer" src="https://img.shields.io/badge/Node.js-%3E%3D22.1.0-339933.svg?style=flat-square&amp;logo=nodedotjs&amp;logoColor=white"></a>
   <a href="https://github.com/mokuyoaxis/dsh-iris/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/mokuyoaxis/dsh-iris/actions/workflows/ci.yml/badge.svg"></a>
   <a href="LICENSE"><img alt="MIT License" src="https://img.shields.io/badge/license-MIT-1689FF.svg?style=flat-square"></a>
 </p>
 
-Iris connects media services and keeps creative work, tasks and outputs together. Agents can generate, edit, inspect and reuse media through a standalone CLI, a native DSH plugin, or the 0.3 alpha Core workbench and generic MCP. Core owns execution and storage; users choose what each client can access.
+Iris connects media services and keeps creative work, tasks and outputs together. Agents can generate, edit, inspect and reuse media through a standalone CLI, a native DSH plugin, or the 0.3 beta Core workbench and generic MCP. Core owns execution and storage; users choose what each client can access.
 
-**Release channels: `0.3.0-alpha.1` is the first 0.3 prerelease, available through npm `alpha`; stable `latest` remains `0.2.7`.** The standalone Web workbench, production MCP, ComfyUI and Core plugins require the alpha package. Stable 0.2.7 does not include these new entry points. Alpha contracts can change; see the [release notes](docs/releases/0.3.0-alpha.1.md) for scope.
+**Release channels: `0.3.0-beta.1` uses npm `beta`; stable `latest` remains `0.2.7`.** Building on alpha.1's standalone Web, generic MCP, ComfyUI and Core plugins, this release adds explicit network pools, bounded scheduling, text-to-video, environment credential references and independent plugin starters. See the [beta scope](docs/BETA_SCOPE.md) and [release notes](docs/releases/0.3.0-beta.1.md).
 
 | What you need | Entry | Availability |
 |---|---|---|
 | Media tools and prompt refinement inside DSH | [DSH plugin](#dsh-plugin-027) | Published 0.2.7 |
 | Media generation, task inspection and export in a terminal | [Standalone CLI](#standalone-cli-027) | Published 0.2.7; no DSH required |
-| A dedicated UI for models, creation and works | [Core quickstart](docs/CORE_QUICKSTART.md) | 0.3.0-alpha.1 / current source |
-| Other Agents sharing the same media workspace | [MCP](docs/MCP.md) · [Agent guide](docs/AGENT_CORE_QUICKSTART.md) | 0.3.0-alpha.1 / current source |
+| A dedicated UI for models, creation and works | [Core quickstart](docs/CORE_QUICKSTART.md) | 0.3.0-beta.1 |
+| Other Agents sharing the same media workspace | [MCP](docs/MCP.md) · [Agent guide](docs/AGENT_CORE_QUICKSTART.md) | 0.3.0-beta.1 |
 
 ## Workbench preview
 
@@ -50,13 +50,18 @@ A white interface with subtle iris colors, light/dark themes, local backgrounds
 - **User-selected Agent access:** MCP grants select media, operation scopes and tools. stdio and Streamable HTTP share Core, with generic configuration and explicit client templates.
 - **Optional plugins:** Providers, business operations, pages, settings forms and artifact previews can be contributed by plugins. Core validates and assembles them; users grant access. The bundled contact sheet demonstrates a complete persistent business.
 
+Developers can start with the [independent plugin projects](docs/PLUGIN_DEVELOPMENT.md) included in beta.1. The business/page/PNG template uses the public SDK; the [Wan Provider template](templates/provider-starter/README.md) uses factory context v1 and reuses Core credentials, networking, scheduling and durable tasks. Plugins retain their own identities, contribution versions and explicit grants.
+
+Existing roots are not migrated automatically. Video requires a new v4 root, and network bindings have a separate format gate. Platform tests, controlled services and real-account evidence are distinct; they do not certify every provider, GPU or client.
+
 ### Current entry-point coverage
 
-| Capability | DSH / standalone CLI (alpha) | Core Web / MCP (alpha) |
+| Capability | DSH / standalone CLI (beta) | Core Web / MCP (beta) |
 |---|---|---|
 | Image generation, import and editing | Available | Available; text-to-image requires a new generation-capable root |
-| Speech and transcription | Available | Available in a new v3 root |
-| Video, music and vision | Available, depending on service and local dependencies | Configurable uses; creation entries still pending |
+| Speech and transcription | Available | Available in new v3/v4 roots |
+| Text-to-video | Available | [Available in new v4 roots](docs/VIDEO_FLOWS.md) |
+| Image-to-video, S2V, music and vision | Available, depending on service and local dependencies | Configurable uses; creation entries still pending |
 | ComfyUI workflows and exposed parameters | Added in alpha; absent from stable 0.2.7 | Implemented; live GPU inference remains unverified |
 | Contact-sheet plugin | Outside 0.2.7 | Available when explicitly enabled |
 
@@ -64,12 +69,12 @@ A white interface with subtle iris colors, light/dark themes, local backgrounds
 
 ## Quickstart
 
-### Core workbench (0.3 alpha)
+### Core workbench (0.3 beta)
 
 Pin the prerelease in your own project, then choose a **new private location**. Existing workspaces are not migrated:
 
 ```bash
-npm install @mokuyoaxis/dsh-iris@0.3.0-alpha.1
+npm install @mokuyoaxis/dsh-iris@0.3.0-beta.1
 
 IRIS_PREVIEW="$HOME/.iris/preview"
 mkdir -p "$IRIS_PREVIEW"
@@ -85,7 +90,7 @@ npx dsh-iris web serve \
   --allow-connection-management --allow-mcp --port 3182
 ```
 
-For a source checkout, install locked dependencies with `npm ci` and replace `npx dsh-iris` with `node bin/dsh-iris.js`. Use `@mokuyoaxis/dsh-iris@alpha` to follow prereleases, or keep the exact version for a reproducible setup.
+For a source checkout, install locked dependencies with `npm ci` and replace `npx dsh-iris` with `node bin/dsh-iris.js`. Use `@mokuyoaxis/dsh-iris@beta` to follow betas, or keep the exact version for a reproducible setup.
 
 Open the printed **`loginUrl` once to set an access password**, then use the ordinary address. Remembered devices survive refreshes and normal restarts; sign back in with the same password after logout. Mobile browsers do not need access to Termux files.
 
@@ -106,7 +111,7 @@ dsh web
 
 Under Settings → Iris Workbench, reference an existing DSH API-key connection or add a service. Choose its protocol, approve model uses and select pool policies. Native DSH mode uses host routes, attachments and lifecycle without a separate Core Web service; it provides 17 Agent tools and the 🫧 prompt-refinement entry.
 
-These commands retain the stable version. To use additions such as the alpha ComfyUI UI, explicitly install `dsh plugin --profile web add @mokuyoaxis/dsh-iris@0.3.0-alpha.1`. The exact supported host versions do not expand.
+These commands retain the stable version. To use additions such as the beta ComfyUI UI, explicitly install `dsh plugin --profile web add @mokuyoaxis/dsh-iris@0.3.0-beta.1`. The exact supported host versions do not expand.
 
 After configuration, a minimal request is:
 
@@ -133,10 +138,12 @@ Keep the full scoped package name **`@mokuyoaxis/dsh-iris`** when installing or
 ## Configuration and data
 
 - Iris does not scan other projects or clients by default. DSH can [reference host API-key connections](docs/DSH_PROVIDER_CONNECTIONS.md); the Core workbench manages its media services. A chat subscription or OAuth login is not media API authentication.
+- Beta.1 optionally supports [environment credential references](docs/PROVIDER_CREDENTIALS.md): configuration stores a variable name and Core resolves its value at runtime. Inline keys remain supported.
 - Existing lists and missing/empty assignments are not silently enabled on upgrade. New directory models need explicit use approval; an empty manual pool stays empty. See [function pools](docs/FUNCTION_MODEL_POOLS.md).
 - `IRIS_IMPORT_WORKBENCH_CONFIG` explicitly selects an old ai-paint configuration for [one-time import](user_guide.md#从旧工作台显式导入). It does not modify or continuously synchronize the source, or migrate a Core data root.
 - DSH data lives under `$DSH_HOME/iris/v1/`, with media Core data in `core-v0`. Standalone CLI/Web use the selected root. The new workbench does not automatically import works from other roots.
 - Each root has one writer and an instance execution queue; read-only inspection may coexist. The gallery is not a backup. There is no automatic disk quota or garbage collection; deletion, recovery and dependencies require explicit operations.
+- Beta.1 offers explicit [bounded media scheduling](docs/MEDIA_SCHEDULING.md) for the Core service: one writer, separate HTTP concurrency, dispatch rate and outstanding remote-task limits. The default stays serial; ambiguous submissions are never replayed automatically.
 - Credentials live in private storage: typically `0600` files and `0700` directories on POSIX. Windows still relies on accounts and ACLs. Keep secrets and authenticated URLs out of public configuration and captures. Workspace passwords, MCP credentials and provider keys are managed separately.
 
 Node.js ≥22 and a loadable `sharp` installation are required. Video extraction needs `ffmpeg`/`ffprobe`. HTML capture needs the chosen browser backend; DSH host services and standalone Chromium have different requirements. On Termux/PRoot, keep data on a private Linux filesystem supporting permissions and hard links.
@@ -170,7 +177,7 @@ Historical device captures from an Android browser connected to DSH in Termux/PR
 | Workbench and connections | [Login](docs/WORKBENCH_LOGIN.md) · [Web](docs/LOCAL_WEB.md) · [MCP](docs/MCP.md) · [Skills](docs/CORE_SKILLS.md) |
 | Models and flows | [Providers, pools and spectrum](docs/PROVIDER_SETTINGS.md) · [Images / ComfyUI](docs/IMAGE_GENERATION.md) · [Speech / transcription](docs/AUDIO_FLOWS.md) · [Task semantics](docs/TASK_SEMANTICS.md) |
 | Extensions | [Plugin contract](docs/PLUGINS.md) · [Startup](docs/PLUGIN_STARTUP.md) · [Panel](docs/PANEL_EXTENSIONS.md) · [Contact sheet](docs/CONTACT_SHEET.md) |
-| Releases and direction | [0.3 alpha release notes](docs/releases/0.3.0-alpha.1.md) · [0.2.7 stable](docs/releases/0.2.7.md) · [CHANGELOG](CHANGELOG.md) · [ROADMAP](docs/ROADMAP.md) · [Architecture](docs/ARCHITECTURE.md) |
+| Releases and direction | [0.3 beta release notes](docs/releases/0.3.0-beta.1.md) · [0.2.7 stable](docs/releases/0.2.7.md) · [CHANGELOG](CHANGELOG.md) · [ROADMAP](docs/ROADMAP.md) · [Architecture](docs/ARCHITECTURE.md) |
 
 The DSH package retains [`iris-use`](.dsh/skills/iris-use/SKILL.md), [`iris-compose-media`](.dsh/skills/iris-compose-media/SKILL.md) and [`iris-verify-ui`](.dsh/skills/iris-verify-ui/SKILL.md). Core and connection Skills do not replace them.
 

package/README.md

@@ -12,21 +12,21 @@
 
 <p align="center">
   <a href="https://www.npmjs.com/package/@mokuyoaxis/dsh-iris"><img alt="npm version" src="https://img.shields.io/npm/v/%40mokuyoaxis%2Fdsh-iris.svg?style=flat-square"></a>
-  <a href="https://nodejs.org/"><img alt="Node.js 22 or newer" src="https://img.shields.io/badge/Node.js-%3E%3D22-339933.svg?style=flat-square&amp;logo=nodedotjs&amp;logoColor=white"></a>
+  <a href="https://nodejs.org/"><img alt="Node.js 22.1.0 or newer" src="https://img.shields.io/badge/Node.js-%3E%3D22.1.0-339933.svg?style=flat-square&amp;logo=nodedotjs&amp;logoColor=white"></a>
   <a href="https://github.com/mokuyoaxis/dsh-iris/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/mokuyoaxis/dsh-iris/actions/workflows/ci.yml/badge.svg"></a>
   <a href="LICENSE"><img alt="MIT License" src="https://img.shields.io/badge/license-MIT-1689FF.svg?style=flat-square"></a>
 </p>
 
-Iris 连接媒体服务、保存创作过程与作品，让 Agent 可以生成、修改、查看和继续使用媒体。它提供独立 CLI、DSH 原生插件，以及 0.3 alpha 的 Web 工作台与通用 MCP：供应商、任务和产物由 Core 管理，客户端按用户选择获得能力。
+Iris 连接媒体服务、保存创作过程与作品，让 Agent 可以生成、修改、查看和继续使用媒体。它提供独立 CLI、DSH 原生插件，以及 0.3 beta 的 Web 工作台与通用 MCP：供应商、任务和产物由 Core 管理，客户端按用户选择获得能力。
 
-**版本通道：`0.3.0-alpha.1` 是 0.3 首个预发布，通过 npm `alpha` 通道获取；稳定 `latest` 保留 `0.2.7`。** 独立 Web、正式 MCP、ComfyUI 和 Core 插件需要 alpha 包；稳定 0.2.7 不包含这些新增入口。alpha 契约仍可能调整，完整范围见[发布说明](docs/releases/0.3.0-alpha.1.md)。
+**版本通道：`0.3.0-beta.1` 通过 npm `beta` 通道获取；稳定 `latest` 保留 `0.2.7`。** 本次在 alpha.1 的独立 Web、通用 MCP、ComfyUI 和 Core 插件之上，新增网络出口池、有界调度、文生视频、环境凭据引用及独立插件模板。最小契约与主要流程按 [beta 范围](docs/BETA_SCOPE.md)收口，完整变化见[发布说明](docs/releases/0.3.0-beta.1.md)。
 
 | 你想做什么 | 使用入口 | 范围 |
 |---|---|---|
 | 在 DSH 对话中使用媒体工具与提示词优化 | [DSH 插件](#dsh-插件027) | 已发布 0.2.7 |
 | 在终端生成媒体、查任务、导出作品 | [独立 CLI](#独立-cli027) | 已发布 0.2.7，无需 DSH |
-| 在独立页面配置模型、创作和管理作品 | [Core 工作台快速开始](docs/CORE_QUICKSTART.md) | 0.3.0-alpha.1 / 当前源码 |
-| 让其他 Agent 使用同一个媒体工作区 | [MCP 接入](docs/MCP.md) · [Agent 指导](docs/AGENT_CORE_QUICKSTART.md) | 0.3.0-alpha.1 / 当前源码 |
+| 在独立页面配置模型、创作和管理作品 | [Core 工作台快速开始](docs/CORE_QUICKSTART.md) | 0.3.0-beta.1 |
+| 让其他 Agent 使用同一个媒体工作区 | [MCP 接入](docs/MCP.md) · [Agent 指导](docs/AGENT_CORE_QUICKSTART.md) | 0.3.0-beta.1 |
 
 ## 工作台预览
 
@@ -50,13 +50,18 @@ Iris 连接媒体服务、保存创作过程与作品，让 Agent 可以生成
 - **Agent 自选能力**：MCP 连接按媒体、操作权限和工具选择；stdio 与 Streamable HTTP 共用 Core，支持通用入口及显式客户端模板。
 - **可选插件**：Provider、新业务操作、页面、设置表单和作品预览可由插件贡献，Core 校验和装配，用户决定授权。随包多图对照板展示一次完整的持久业务。
 
+开发者可从随 beta.1 分发的[独立插件模板](docs/PLUGIN_DEVELOPMENT.md)开始：业务/页面/PNG 预览模板复用公开 SDK；[万相 Provider 模板](templates/provider-starter/README.md)使用工厂上下文 v1，复用 Core 凭据、网络、调度及持久任务。插件身份、贡献版本和授权均独立管理。
+
+旧数据根不自动迁移；新增视频需要显式创建 v4 根，网络绑定也有独立版本门禁。平台测试、受控服务和真实账号验证分别说明，不据此承诺所有供应商、GPU 或客户端均已验收。
+
 ### 当前入口覆盖
 
-| 能力 | DSH / 独立 CLI（alpha） | Core Web / MCP（alpha） |
+| 能力 | DSH / 独立 CLI（beta） | Core Web / MCP（beta） |
 |---|---|---|
 | 图片生成、导入与编辑 | 可用 | 可用；新根支持文生图 |
-| 语音合成、音频转写 | 可用 | 新 v3 根可用 |
-| 视频、音乐、视觉理解 | 可用，取决于服务与本地依赖 | 模型服务可配置；创作入口待接入 |
+| 语音合成、音频转写 | 可用 | 新 v3/v4 根可用 |
+| 文生视频 | 可用 | [新 v4 根可用](docs/VIDEO_FLOWS.md) |
+| 图生视频、S2V、音乐、视觉理解 | 可用，取决于服务与本地依赖 | 模型服务可配置；创作入口待接入 |
 | ComfyUI 工作流与开放参数 | alpha 新增；稳定 0.2.7 不含 | 已实现；真实 GPU 推理待验收 |
 | 多图对照板插件 | 不属于 0.2.7 | 显式启用后可用 |
 
@@ -64,12 +69,12 @@ Iris 连接媒体服务、保存创作过程与作品，让 Agent 可以生成
 
 ## 快速开始
 
-### Core 工作台（0.3 alpha）
+### Core 工作台（0.3 beta）
 
 在自己的项目中固定安装预发布包，再选择**新的私有位置**。现有工作区不自动迁移：
 
 ```bash
-npm install @mokuyoaxis/dsh-iris@0.3.0-alpha.1
+npm install @mokuyoaxis/dsh-iris@0.3.0-beta.1
 
 IRIS_PREVIEW="$HOME/.iris/preview"
 mkdir -p "$IRIS_PREVIEW"
@@ -85,7 +90,7 @@ npx dsh-iris web serve \
   --allow-connection-management --allow-mcp --port 3182
 ```
 
-在源码目录使用 `npm ci` 安装锁定依赖，并把 `npx dsh-iris` 换成 `node bin/dsh-iris.js`。跟随预发布通道可安装 `@mokuyoaxis/dsh-iris@alpha`；需要可复现配置时保留准确版本。
+在源码目录使用 `npm ci` 安装锁定依赖，并把 `npx dsh-iris` 换成 `node bin/dsh-iris.js`。跟随 beta 通道可安装 `@mokuyoaxis/dsh-iris@beta`；需要可复现配置时保留准确版本。
 
 首次打开输出的 **`loginUrl` 设置访问口令**，以后用普通地址。默认记住设备，刷新及正常重启后可继续；退出后输入原口令即可。手机无需读取 Termux 私有文件。
 
@@ -106,7 +111,7 @@ dsh web
 
 在“设置 → Iris 工作台”引用 DSH 已有 API Key 连接或添加服务，选择协议、确认模型用途与功能池。原生 DSH 模式使用宿主路由、附件和生命周期，不要求另起 Core Web 服务；提供 17 个 Agent 工具和对话框 🫧 提示词优化。
 
-以上命令保留稳定版。需要 alpha 新增的 ComfyUI 等功能时，明确改用 `dsh plugin --profile web add @mokuyoaxis/dsh-iris@0.3.0-alpha.1`；宿主准确版本范围不扩大。
+以上命令保留稳定版。需要 beta 的 ComfyUI 等功能时，明确改用 `dsh plugin --profile web add @mokuyoaxis/dsh-iris@0.3.0-beta.1`；宿主准确版本范围不扩大。
 
 配置后的最小指令：
 
@@ -133,10 +138,12 @@ npx dsh-iris --help
 ## 配置与数据
 
 - Iris 不默认扫描其他项目或客户端。DSH 可[引用宿主 API Key 连接](docs/DSH_PROVIDER_CONNECTIONS.md)，Core 工作台管理自己的媒体服务；聊天订阅/OAuth 不等于媒体 API 认证。
+- beta.1 可选[环境凭据引用](docs/PROVIDER_CREDENTIALS.md)，只保存变量名、由 Core 进程解析值；原内联 Key 继续可用。
 - 旧名单、缺失/空分配不会因升级静默启用。新增目录模型须确认用途；手动空池不回落到自动。详见[功能模型池](docs/FUNCTION_MODEL_POOLS.md)。
 - 旧 ai-paint 配置可用 `IRIS_IMPORT_WORKBENCH_CONFIG` 显式指定来源，操作见[一次性导入](user_guide.md#从旧工作台显式导入)；它不修改来源或持续同步，也不迁移 Core 数据根。
 - DSH 数据位于 `$DSH_HOME/iris/v1/`，媒体 Core 根为其中的 `core-v0`；独立 CLI/Web 使用明确选择的根。新工作台不会自动汇入其他根的作品。
 - 同一数据根只有一个写者，实例内按队列执行；只读检查可共存。作品库不是备份，没有自动磁盘配额或 GC。删除、恢复与旧任务依赖需按对应命令明确操作。
+- beta.1 可在 Core 服务显式启用[有界媒体调度](docs/MEDIA_SCHEDULING.md)：保持单写者，分别限制 HTTP 并发、发送速率和远端未结束任务；缺省仍串行，未知受理不重提。
 - 密钥与认证文件保存在私有目录，POSIX 文件通常为 `0600`、目录为 `0700`；Windows 仍依赖账户与 ACL。公开配置/截图不应含认证链接或密钥。工作台口令、MCP 连接密钥和供应商 Key 分别管理。
 
 Node.js ≥22 和可加载的 `sharp` 是基础要求。视频抽帧需 `ffmpeg`/`ffprobe`；HTML 截图需所选浏览器后端，DSH 宿主服务与独立 Chromium 的要求不同。Termux/PRoot 的数据应放在支持所需权限与 hard link 的私有 Linux 文件系统。
@@ -170,7 +177,7 @@ Node.js ≥22 和可加载的 `sharp` 是基础要求。视频抽帧需 `ffmpeg`
 | 工作台与接入 | [登录](docs/WORKBENCH_LOGIN.md) · [Web](docs/LOCAL_WEB.md) · [MCP](docs/MCP.md) · [Skills](docs/CORE_SKILLS.md) |
 | 模型与流程 | [供应商/模型池/光谱](docs/PROVIDER_SETTINGS.md) · [图片与 ComfyUI](docs/IMAGE_GENERATION.md) · [语音/转写](docs/AUDIO_FLOWS.md) · [任务语义](docs/TASK_SEMANTICS.md) |
 | 扩展 | [插件契约](docs/PLUGINS.md) · [启动选择](docs/PLUGIN_STARTUP.md) · [Panel](docs/PANEL_EXTENSIONS.md) · [多图对照板](docs/CONTACT_SHEET.md) |
-| 版本与方向 | [0.3 alpha 发布说明](docs/releases/0.3.0-alpha.1.md) · [0.2.7 稳定版](docs/releases/0.2.7.md) · [CHANGELOG](CHANGELOG.md) · [ROADMAP](docs/ROADMAP.md) · [架构](docs/ARCHITECTURE.md) |
+| 版本与方向 | [0.3 beta 发布说明](docs/releases/0.3.0-beta.1.md) · [0.2.7 稳定版](docs/releases/0.2.7.md) · [CHANGELOG](CHANGELOG.md) · [ROADMAP](docs/ROADMAP.md) · [架构](docs/ARCHITECTURE.md) |
 
 DSH 随包保留 [`iris-use`](.dsh/skills/iris-use/SKILL.md)、[`iris-compose-media`](.dsh/skills/iris-compose-media/SKILL.md) 和 [`iris-verify-ui`](.dsh/skills/iris-verify-ui/SKILL.md)。独立 Core 与连接 Skill 不替换它们。